feat(integration): add support for podium (NangoHQ#2601)

## Describe your changes

- Add support for podium

## Issue ticket number and link

[EXT-119](https://linear.app/nango/issue/EXT-119/add-support-for-podium-api)

docs-v2/integrations/all/podium.mdx

@@ -0,0 +1,32 @@
+---
+title: Podium
+sidebarTitle: Podium
+---
+
+API configuration: [`podium`](https://nango.dev/providers.yaml)
+
+## Features
+
+| Features | Status |
+| - | - |
+| [Auth (OAuth)](/integrate/guides/authorize-an-api) | ✅ |
+| [Sync data](/integrate/guides/sync-data-from-an-api) | ✅ |
+| [Perform workflows](/integrate/guides/perform-workflows-with-an-api) | ✅ |
+| [Proxy requests](/integrate/guides/proxy-requests-to-an-api) | ✅ |
+| [Receive webhooks](/integrate/guides/receive-webhooks-from-an-api) | 🚫 (time to contribute: <48h) |
+
+<Tip>We can implement missing features in &lt;48h, just ask for it in the [community](https://nango.dev/slack).</Tip>
+
+## Getting started
+
+-   [How to Register an Application](https://docs.podium.com/docs/oauth#create-your-app)
+-   [OAuth related docs](https://docs.podium.com/docs/oauth)
+-   [List of OAuth Scopes](https://docs.podium.com/docs/oauth-scopes)
+-   [Podium API docs](https://docs.podium.com/reference)
+
+<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>
+
+## API gotchas
+-   When creating a new connection in Nango, you will also have to provide your `apiVersion` for compatibility. For more details, please check [Podium API versioning](https://docs.podium.com/docs/api-version)
+-   Podium enforces a rate limit of 300 requests per minute on most of its routes, with some exceptions.
+<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/podium.mdx)</Note>

docs-v2/integrations/communication.mdx

@@ -23,6 +23,7 @@ sidebarTitle: Communication
     <Card title="Instantly" href="/integrations/all/instantly" color="#68a063" />
     <Card title="Mailgun" href="/integrations/all/mailgun" color="#68a063" />
     <Card title="Microsoft Teams" href="/integrations/all/microsoft-teams" color="#68a063" />
+    <Card title="Podium" href="/integrations/all/podium" color="#68a063" />
     <Card title="Outlook" href="/integrations/all/outlook" color="#68a063" />
     <Card title="RingCentral" href="/integrations/all/ring-central" color="#68a063" />
     <Card title="Sendgrid" href="/integrations/all/sendgrid" color="#68a063" />

docs-v2/integrations/marketing.mdx

@@ -26,6 +26,7 @@ sidebarTitle: Marketing
     <Card title="Salesloft" href="/integrations/all/salesloft" color="#68a063" />
     <Card title="Apollo" href="/integrations/all/apollo" color="#68a063" />
     <Card title="Pinterest" href="/integrations/all/pinterest" color="#68a063" />
+    <Card title="Podium" href="/integrations/all/podium" color="#68a063" />
     <Card title="Sendgrid" href="/integrations/all/sendgrid" color="#68a063" />
     <Card title="Segment" href="/integrations/all/segment" color="#68a063" />
     <Card title="Sendgrid" href="/integrations/all/sendgrid" color="#68a063" />

docs-v2/mint.json

@@ -454,6 +454,7 @@
                 "integrations/all/pipedrive",
                 "integrations/all/pivotaltracker",
                 "integrations/all/productboard",
+                "integrations/all/podium",
                 "integrations/all/posthog",
                 "integrations/all/qualtrics",
                 "integrations/all/quickbooks",

packages/shared/lib/services/connection.service.ts

@@ -868,6 +868,8 @@ class ConnectionService {
                     expiresAt = parseTokenExpirationDate(rawCreds['expires_at']);
                 } else if (rawCreds['expires_in']) {
                     expiresAt = new Date(Date.now() + Number.parseInt(rawCreds['expires_in'], 10) * 1000);
+                } else if (template?.expires_in_ms) {
+                    expiresAt = new Date(Date.now() + template.expires_in_ms);
                 }
 
                 const oauth2Creds: OAuth2Credentials = {

packages/shared/providers.yaml

@@ -2200,6 +2200,30 @@ pivotaltracker:
             method: GET
             endpoint: /accounts
     docs: https://docs.nango.dev/integrations/all/pivotaltracker
+podium:
+    categories:
+        - communication
+        - marketing
+    auth_mode: OAUTH2
+    authorization_url: https://api.podium.com/oauth/authorize
+    token_url: https://api.podium.com/oauth/token
+    scope_separator: ' '
+    body_format: json
+    authorization_params:
+        response_type: code
+    token_params:
+        grant_type: authorization_code
+    refresh_params:
+        grant_type: refresh_token
+    expires_in_ms: 36000000
+    proxy:
+        headers:
+            Podium-Version: ${connectionConfig.apiVersion}
+            Content-Type: application/json
+        base_url: https://api.podium.com
+        retry:
+            after: 'x-ratelimit-reset'
+    docs: https://docs.nango.dev/integrations/all/podium
 posthog:
     categories:
         - dev-tools

packages/types/lib/integration/template.ts

@@ -68,6 +68,7 @@ export interface TemplateOAuth2 extends Template {
 
     refresh_url?: string;
     expires_in_unit?: 'milliseconds';
+    expires_in_ms?: number; //in ms
 
     token_request_auth_method?: 'basic' | 'custom';
 }

scripts/validation/providers/schema.json

@@ -262,6 +262,9 @@
                     "type": "string",
                     "enum": ["milliseconds"]
                 },
+                "expires_in_ms": {
+                    "type": "number"
+                },
                 "token_response_metadata": {
                     "type": "array",
                     "items": {