@nangohq/types 0.58.6 → 0.59.0

package/dist/action/api.d.ts

@@ -0,0 +1,13 @@
+import type { Endpoint } from '../api';
+export interface AsyncActionResponse {
+    id: string;
+    statusUrl: string;
+}
+export type GetAsyncActionResult = Endpoint<{
+    Method: 'GET';
+    Path: `/action/:id`;
+    Params: {
+        id: string;
+    };
+    Success: Record<string, any>;
+}>;

package/dist/api.endpoints.d.ts

@@ -1,4 +1,5 @@
 import type { GetEmailByExpiredToken, GetEmailByUuid, GetManagedCallback, PostForgotPassword, PostLogout, PostManagedSignup, PostSignin, PostSignup, PutResetPassword } from './account/api';
+import type { GetAsyncActionResult } from './action/api';
 import type { EndpointMethod } from './api';
 import type { PostPublicApiKeyAuthorization, PostPublicAppStoreAuthorization, PostPublicBasicAuthorization, PostPublicBillAuthorization, PostPublicJwtAuthorization, PostPublicSignatureAuthorization, PostPublicTableauAuthorization, PostPublicTbaAuthorization, PostPublicTwoStepAuthorization, PostPublicUnauthenticatedAuthorization } from './auth/http.api';
 import type { DeleteConnectSession, GetConnectSession, PostConnectSessions, PostInternalConnectSessions, PostPublicConnectSessionsReconnect, PostPublicConnectTelemetry } from './connect/api';
@@ -9,7 +10,7 @@ import type { DeleteEnvironment, PatchEnvironment, PostEnvironment } from './env
 import type { PatchWebhook } from './environment/api/webhook';
 import type { PostEnvironmentVariables } from './environment/variable/api';
 import type { PatchFlowDisable, PatchFlowEnable, PatchFlowFrequency, PostPreBuiltDeploy, PutUpgradePreBuiltFlow } from './flow/http.api';
-import type { DeleteIntegration, DeletePublicIntegration, GetIntegration, GetIntegrationFlows, GetPublicIntegration, GetPublicListIntegrations, GetPublicListIntegrationsLegacy, PatchIntegration, PostIntegration } from './integration/api';
+import type { DeleteIntegration, DeletePublicIntegration, GetIntegration, GetIntegrationFlows, GetPublicIntegration, GetPublicListIntegrations, GetPublicListIntegrationsLegacy, PatchIntegration, PatchPublicIntegration, PostIntegration, PostPublicIntegration } from './integration/api';
 import type { DeleteInvite, GetInvite, PostInvite } from './invitations/api';
 import type { GetOperation, PostInsights, SearchFilters, SearchMessages, SearchOperations } from './logs/api';
 import type { GetMeta } from './meta/api';
@@ -22,7 +23,7 @@ import type { PostPublicTrigger, PutPublicSyncConnectionFrequency } from './sync
 import type { DeleteTeamUser, GetTeam, PutTeam } from './team/api';
 import type { GetUser, PatchUser } from './user/api';
 import type { PostPublicWebhook } from './webhooks/http.api';
-export type PublicApiEndpoints = SetMetadata | UpdateMetadata | PostDeploy | PostDeployConfirmation | PostPublicTrigger | PostPublicTbaAuthorization | PostPublicTableauAuthorization | PostPublicJwtAuthorization | PostPublicUnauthenticatedAuthorization | PostPublicApiKeyAuthorization | PostPublicBasicAuthorization | PostPublicAppStoreAuthorization | GetPublicProviders | GetPublicProvider | GetPublicListIntegrationsLegacy | GetPublicListIntegrations | GetPublicIntegration | DeletePublicIntegration | PostConnectSessions | PostPublicConnectSessionsReconnect | GetPublicConnections | GetPublicConnection | GetConnectSession | DeleteConnectSession | PostDeployInternal | PostPublicBillAuthorization | DeletePublicConnection | PostPublicSignatureAuthorization | PostPublicTwoStepAuthorization | PostPublicWebhook | GetPublicRecords | GetPublicScriptsConfig | PostPublicConnectTelemetry | PutPublicSyncConnectionFrequency;
+export type PublicApiEndpoints = SetMetadata | UpdateMetadata | PostDeploy | PostDeployConfirmation | PostPublicTrigger | PostPublicTbaAuthorization | PostPublicTableauAuthorization | PostPublicJwtAuthorization | PostPublicUnauthenticatedAuthorization | PostPublicApiKeyAuthorization | PostPublicBasicAuthorization | PostPublicAppStoreAuthorization | GetPublicProviders | GetPublicProvider | GetPublicListIntegrationsLegacy | GetPublicListIntegrations | GetPublicIntegration | DeletePublicIntegration | PostConnectSessions | PostPublicConnectSessionsReconnect | GetPublicConnections | GetPublicConnection | GetConnectSession | DeleteConnectSession | PostDeployInternal | PostPublicBillAuthorization | DeletePublicConnection | PostPublicSignatureAuthorization | PostPublicTwoStepAuthorization | PostPublicWebhook | GetPublicRecords | GetPublicScriptsConfig | PostPublicConnectTelemetry | PutPublicSyncConnectionFrequency | PostPublicIntegration | PatchPublicIntegration | GetAsyncActionResult;
 export type PrivateApiEndpoints = PostSignup | PostSignin | PostLogout | GetTeam | PutTeam | PostPlanExtendTrial | GetUser | PatchUser | PostInvite | DeleteInvite | DeleteTeamUser | PostInsights | PostForgotPassword | PutResetPassword | SearchOperations | GetOperation | SearchMessages | SearchFilters | PatchOnboarding | PostInternalConnectSessions | GetIntegrationFlows | DeleteIntegration | PatchIntegration | GetIntegration | PostIntegration | GetConnections | GetConnectionsCount | GetConnection | GetInvite | GetMeta | GetEmailByExpiredToken | GetEmailByUuid | GetManagedCallback | PatchFlowDisable | PatchFlowEnable | PatchFlowFrequency | PutUpgradePreBuiltFlow | PostConnectionRefresh | PostManagedSignup | PostPreBuiltDeploy | PostEnvironment | PatchEnvironment | DeleteEnvironment | PatchWebhook | PostEnvironmentVariables;
 export type APIEndpoints = PrivateApiEndpoints | PublicApiEndpoints;
 /**

package/dist/billing/types.d.ts

@@ -0,0 +1,35 @@
+import type { Result } from '../result';
+export interface BillingClient {
+    ingest: (events: BillingIngestEvent[]) => Promise<void>;
+    getCustomer: (accountId: number) => Promise<Result<BillingCustomer>>;
+    getSubscription: (accountId: number) => Promise<Result<BillingSubscription | null>>;
+    getUsage: (subscriptionId: string, period?: 'previous') => Promise<Result<BillingUsageMetric[]>>;
+}
+export interface BillingCustomer {
+    id: string;
+    portalUrl: string | null;
+}
+export interface BillingSubscription {
+    id: string;
+}
+export interface BillingUsageMetric {
+    id: string;
+    name: string;
+    quantity: number;
+}
+export interface BillingIngestEvent {
+    type: 'monthly_active_records' | 'billable_connections' | 'billable_actions';
+    idempotencyKey: string;
+    accountId: number;
+    timestamp: Date;
+    properties: Record<string, string | number>;
+}
+export interface BillingMetric {
+    type: BillingIngestEvent['type'];
+    value: number;
+    properties: {
+        accountId: number;
+        timestamp?: Date | undefined;
+        idempotencyKey?: string | undefined;
+    };
+}

package/dist/environment/api/webhook.d.ts

@@ -12,6 +12,7 @@ export type PatchWebhook = Endpoint<{
         on_auth_creation?: boolean | undefined;
         on_auth_refresh_error?: boolean | undefined;
         on_sync_error?: boolean | undefined;
+        on_async_action_completion?: boolean | undefined;
     };
     Success: {
         success: boolean;

package/dist/environment/db.d.ts

@@ -54,4 +54,5 @@ export interface DBExternalWebhook extends Timestamps {
     on_auth_creation: boolean;
     on_auth_refresh_error: boolean;
     on_sync_error: boolean;
+    on_async_action_completion: boolean;
 }

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export type * from './record/api.js';
 export type * from './logs/api.js';
 export type * from './logs/messages.js';
 export type * from './keystore/index.js';
+export type * from './action/api.js';
 export type * from './account/api.js';
 export type * from './user/api.js';
 export type * from './user/db.js';
@@ -19,8 +20,10 @@ export type * from './syncConfigs/db.js';
 export type * from './syncConfigs/api.js';
 export type * from './team/api.js';
 export type * from './team/db.js';
+export type * from './billing/types.js';
 export type * from './providers/api.js';
 export type * from './proxy/api.js';
+export type * from './result.js';
 export type * from './scripts/on-events/db.js';
 export type * from './scripts/on-events/api.js';
 export type * from './scripts/syncs/api.js';
@@ -63,3 +66,4 @@ export type * from './fleet/api.js';
 export type * from './fleet/index.js';
 export type * from './persist/api.js';
 export type * from './jobs/api.js';
+export type * from './mcp/api.js';

package/dist/integration/api.d.ts

@@ -38,6 +38,19 @@ export type GetPublicListIntegrations = Endpoint<{
         data: ApiPublicIntegration[];
     };
 }>;
+export type PostPublicIntegration = Endpoint<{
+    Method: 'POST';
+    Path: '/integrations';
+    Body: {
+        provider: string;
+        unique_key: string;
+        display_name?: string | undefined;
+        credentials?: ApiPublicIntegrationCredentials | undefined;
+    };
+    Success: {
+        data: ApiPublicIntegration;
+    };
+}>;
 export type GetPublicIntegration = Endpoint<{
     Method: 'GET';
     Path: '/integrations/:uniqueKey';
@@ -51,7 +64,32 @@ export type GetPublicIntegration = Endpoint<{
         data: ApiPublicIntegration;
     };
 }>;
+export type PatchPublicIntegration = Endpoint<{
+    Method: 'PATCH';
+    Path: '/integrations/:uniqueKey';
+    Params: {
+        uniqueKey: string;
+    };
+    Body: {
+        unique_key?: string | undefined;
+        display_name?: string | undefined;
+        credentials?: ApiPublicIntegrationCredentials | undefined;
+    };
+    Success: {
+        data: ApiPublicIntegration;
+    };
+}>;
 export type DeletePublicIntegration = Endpoint<{
+    Method: 'DELETE';
+    Path: '/integrations/:uniqueKey';
+    Params: {
+        uniqueKey: string;
+    };
+    Success: {
+        success: true;
+    };
+}>;
+export type DeletePublicIntegrationDeprecated = Endpoint<{
     Method: 'DELETE';
     Path: '/config/:providerConfigKey';
     Params: {
@@ -182,3 +220,21 @@ export type GetIntegrationFlows = Endpoint<{
         };
     };
 }>;
+export type ApiPublicIntegrationCredentials = {
+    type: Extract<AuthModeType, 'OAUTH1' | 'OAUTH2' | 'TBA'>;
+    client_id: string;
+    client_secret: string;
+    scopes?: string | undefined;
+} | {
+    type: Extract<AuthModeType, 'APP'>;
+    app_id: string;
+    app_link: string;
+    private_key: string;
+} | {
+    type: Extract<AuthModeType, 'CUSTOM'>;
+    client_id: string;
+    client_secret: string;
+    app_id: string;
+    app_link: string;
+    private_key: string;
+};

package/dist/integration/db.d.ts

@@ -1,6 +1,6 @@
 import type { TimestampsAndDeleted } from '../db.js';
 import type { NullablePartial } from '../utils.js';
-import type { SetOptional } from 'type-fest';
+import type { SetOptional, Tagged } from 'type-fest';
 export interface IntegrationConfig extends TimestampsAndDeleted {
     id?: number | undefined;
     unique_key: string;
@@ -16,4 +16,5 @@ export interface IntegrationConfig extends TimestampsAndDeleted {
     missing_fields: string[];
     display_name: string | null;
 }
+export type DBIntegrationCrypted = Tagged<IntegrationConfig, 'IntegrationCrypted'>;
 export type DBCreateIntegration = SetOptional<NullablePartial<Omit<IntegrationConfig, 'created_at' | 'updated_at'>>, 'missing_fields'>;

package/dist/logs/api.d.ts

@@ -13,13 +13,14 @@ export type SearchOperations = Endpoint<{
         env: string;
     };
     Body: {
+        search?: string | undefined;
         limit?: number;
         states?: SearchOperationsState[];
         types?: SearchOperationsType[];
         integrations?: SearchOperationsIntegration[] | undefined;
         connections?: SearchOperationsConnection[] | undefined;
         syncs?: SearchOperationsSync[] | undefined;
-        period?: SearchOperationsPeriod | undefined;
+        period?: SearchPeriod | undefined;
         cursor?: string | null | undefined;
     };
     Success: {
@@ -35,7 +36,7 @@ export type SearchOperationsType = 'all' | ConcatOperationListWithGroup;
 export type SearchOperationsIntegration = 'all' | string;
 export type SearchOperationsConnection = 'all' | string;
 export type SearchOperationsSync = 'all' | string;
-export interface SearchOperationsPeriod {
+export interface SearchPeriod {
     from: string;
     to: string;
 }
@@ -66,6 +67,7 @@ export type SearchMessages = Endpoint<{
         search?: string | undefined;
         cursorBefore?: string | null | undefined;
         cursorAfter?: string | null | undefined;
+        period?: SearchPeriod | undefined;
     };
     Success: {
         data: MessageRow[];

package/dist/mcp/api.d.ts

@@ -0,0 +1,17 @@
+import type { ApiError, Endpoint } from '../api.js';
+export type PostMcp = Endpoint<{
+    Method: 'POST';
+    Path: '/mcp';
+    Body: Record<string, unknown>;
+    Headers: {
+        'connection-id': string;
+        'provider-config-key': string;
+    };
+    Success: Record<string, unknown>;
+    Error: ApiError<'missing_connection_id' | 'unknown_connection'>;
+}>;
+export type GetMcp = Endpoint<{
+    Method: 'GET';
+    Path: '/mcp';
+    Success: Record<string, unknown>;
+}>;

package/dist/plans/http.api.d.ts

@@ -1,3 +1,4 @@
+import type { BillingCustomer, BillingUsageMetric } from '../billing/types';
 import type { ReplaceInObject } from '../utils';
 import type { DBPlan } from './db.js';
 import type { Endpoint } from '../api';
@@ -34,3 +35,17 @@ export type GetPlans = Endpoint<{
         data: PlanDefinition[];
     };
 }>;
+export type GetUsage = Endpoint<{
+    Method: 'GET';
+    Path: '/api/v1/plans/usage';
+    Querystring: {
+        env: string;
+    };
+    Success: {
+        data: {
+            customer: BillingCustomer;
+            current: BillingUsageMetric[];
+            previous: BillingUsageMetric[];
+        };
+    };
+}>;

package/dist/providers/provider.d.ts

@@ -84,7 +84,7 @@ export interface BaseProvider {
     body_format?: OAuthBodyFormatType;
 }
 export interface ProviderOAuth2 extends BaseProvider {
-    auth_mode: 'OAUTH2' | 'CUSTOM';
+    auth_mode: 'OAUTH2';
     disable_pkce?: boolean;
     token_params?: {
         grant_type?: 'authorization_code' | 'client_credentials';
@@ -93,6 +93,7 @@ export interface ProviderOAuth2 extends BaseProvider {
         grant_type: 'refresh_token';
     };
     authorization_method?: OAuthAuthorizationMethodType;
+    alternate_access_token_response_path?: string;
     refresh_url?: string;
     expires_in_unit?: 'milliseconds';
     token_request_auth_method?: 'basic' | 'custom';
@@ -105,6 +106,13 @@ export interface ProviderOAuth1 extends BaseProvider {
     token_http_method?: 'GET' | 'PUT' | 'POST';
     signature_method: 'HMAC-SHA1' | 'RSA-SHA1' | 'PLAINTEXT';
 }
+export interface ProviderCustom extends Omit<ProviderOAuth2, 'auth_mode'> {
+    auth_mode: 'CUSTOM';
+    token_url: {
+        OAUTH2: string;
+        APP: string;
+    };
+}
 export interface ProviderJwt extends BaseProvider {
     auth_mode: 'JWT';
     signature: {
@@ -170,6 +178,6 @@ export interface ProviderSignature extends BaseProvider {
 export interface ProviderApiKey extends BaseProvider {
     auth_mode: 'API_KEY';
 }
-export type Provider = BaseProvider | ProviderOAuth1 | ProviderOAuth2 | ProviderJwt | ProviderTwoStep | ProviderSignature | ProviderApiKey | ProviderTableau | ProviderBill | ProviderGithubApp | ProviderAppleAppStore;
+export type Provider = BaseProvider | ProviderOAuth1 | ProviderOAuth2 | ProviderJwt | ProviderTwoStep | ProviderSignature | ProviderApiKey | ProviderTableau | ProviderBill | ProviderGithubApp | ProviderAppleAppStore | ProviderCustom;
 export type RefreshableProvider = ProviderTwoStep | ProviderJwt | ProviderSignature | ProviderOAuth2;
 export type TestableProvider = ProviderApiKey;

package/dist/result.d.ts

@@ -0,0 +1,17 @@
+export interface Left<T, E extends Error> {
+    error: E;
+    isErr(this: Result<T, E>): this is Left<T, E>;
+    isOk(this: Result<T, E>): this is Right<T, E>;
+    unwrap(): T;
+    map<U>(fn: (value: T) => U): Result<T, E>;
+    mapError<U extends Error>(fn: (error: E) => U): Result<T, U>;
+}
+export interface Right<T, E extends Error> {
+    value: T;
+    isErr(this: Result<T, E>): this is Left<T, E>;
+    isOk(this: Result<T, E>): this is Right<T, E>;
+    unwrap(): T;
+    map<U>(fn: (value: T) => U): Result<U, E>;
+    mapError<U extends Error>(fn: (error: E) => U): Result<T, U>;
+}
+export type Result<T, E extends Error = Error> = Left<T, E> | Right<T, E>;

package/dist/syncConfigs/db.d.ts

@@ -1,7 +1,7 @@
-import type { JSONSchema7 } from 'json-schema';
 import type { TimestampsAndDeleted } from '../db';
 import type { LegacySyncModelSchema, NangoConfigMetadata } from '../deploy/incomingFlow';
 import type { NangoModel, ScriptTypeLiteral, SyncTypeLiteral } from '../nangoYaml';
+import type { JSONSchema7 } from 'json-schema';
 export interface DBSyncConfig extends TimestampsAndDeleted {
     id: number;
     sync_name: string;

package/dist/webhooks/api.d.ts

@@ -1,7 +1,8 @@
 import type { AuthOperationType, AuthModeType } from '../auth/api.js';
 import type { SyncResult } from '../scripts/syncs/api.js';
 import type { ErrorPayload } from '../api.js';
-export type WebhookTypes = 'sync' | 'auth' | 'forward';
+import type { AsyncActionResponse } from '../action/api.js';
+export type WebhookTypes = 'sync' | 'auth' | 'forward' | 'async_action';
 export interface NangoWebhookBase {
     from: string;
     type: WebhookTypes;
@@ -64,3 +65,9 @@ export interface NangoForwardWebhookBody extends NangoWebhookBase {
     providerConfigKey: string;
     payload: unknown;
 }
+export interface NangoAsyncActionWebhookBody extends NangoWebhookBase {
+    type: 'async_action';
+    connectionId: string;
+    providerConfigKey: string;
+    payload: AsyncActionResponse;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nangohq/types",
-    "version": "0.58.6",
+    "version": "0.59.0",
     "description": "Types used in Nango applications",
     "type": "module",
     "typings": "dist/index.d.ts",
@@ -12,9 +12,9 @@
         "directory": "packages/utils"
     },
     "dependencies": {
-        "axios": "^1.8.4",
+        "axios": "1.9.0",
         "json-schema": "0.4.0",
-        "type-fest": "4.32.0"
+        "type-fest": "4.40.0"
     },
     "devDependencies": {
         "@types/json-schema": "7.0.15"