@nangohq/types 0.69.48 → 0.69.50

package/dist/account/api.d.ts

@@ -130,6 +130,29 @@ export type PostManagedSignup = Endpoint<{
         };
     };
 }>;
+export type GetManagedEmailVerification = Endpoint<{
+    Method: 'GET';
+    Path: '/api/v1/account/managed/verification';
+    Error: ApiError<'not_found'>;
+    Success: {
+        data: {
+            email: string;
+        };
+    };
+}>;
+export type PostManagedEmailVerification = Endpoint<{
+    Method: 'POST';
+    Path: '/api/v1/account/managed/verification';
+    Body: {
+        code: string;
+    };
+    Error: ApiError<'invalid_verification_code'> | ApiError<'not_found'>;
+    Success: {
+        data: {
+            url: string;
+        };
+    };
+}>;
 export type GetManagedCallback = Endpoint<{
     Method: 'GET';
     Path: '/api/v1/login/callback';

package/dist/action/api.d.ts

@@ -26,6 +26,21 @@ export type PostPublicTriggerAction = Endpoint<{
     };
     Success: any;
 }>;
+export type PostInternalTriggerFunction = Endpoint<{
+    Method: 'POST';
+    Path: '/api/v1/trigger/function';
+    Body: {
+        type: 'action' | 'sync';
+        function_name: string;
+        provider_config_key: string;
+        connection_id: string;
+        input?: unknown;
+    };
+    Querystring: {
+        env: string;
+    };
+    Success: any;
+}>;
 /** @deprecated Use POST /action/trigger to trigger actions and GET /records to fetch sync records instead. */
 export type GetPublicV1 = Endpoint<{
     Method: 'GET';

package/dist/api.endpoints.d.ts

@@ -1,5 +1,5 @@
-import type { GetEmailByExpiredToken, GetEmailByUuid, GetManagedCallback, PostForgotPassword, PostLogout, PostManagedSignup, PostSignin, PostSignup, PutResetPassword } from './account/api.js';
-import type { GetAsyncActionResult, GetPublicV1, PostPublicTriggerAction } from './action/api.js';
+import type { GetEmailByExpiredToken, GetEmailByUuid, GetManagedCallback, GetManagedEmailVerification, PostForgotPassword, PostLogout, PostManagedEmailVerification, PostManagedSignup, PostSignin, PostSignup, PutResetPassword } from './account/api.js';
+import type { GetAsyncActionResult, GetPublicV1, PostInternalTriggerFunction, PostPublicTriggerAction } from './action/api.js';
 import type { PostImpersonate } from './admin/http.api.js';
 import type { EndpointMethod } from './api.js';
 import type { PostPublicApiKeyAuthorization, PostPublicAppStoreAuthorization, PostPublicBasicAuthorization, PostPublicBillAuthorization, PostPublicJwtAuthorization, PostPublicOauthOutboundAuthorization, PostPublicSignatureAuthorization, PostPublicTbaAuthorization, PostPublicTwoStepAuthorization, PostPublicUnauthenticatedAuthorization } from './auth/http.api.js';
@@ -17,7 +17,7 @@ import type { DeleteIntegration, DeletePublicIntegration, GetIntegration, GetInt
 import type { DeleteInvite, GetInvite, PostInvite } from './invitations/api.js';
 import type { GetOperation, PostInsights, SearchFilters, SearchMessages, SearchOperations } from './logs/api.js';
 import type { GetMeta } from './meta/api.js';
-import type { PostPlanChange, PostPlanExtendTrial } from './plans/http.api.js';
+import type { PostPlanChange, PostPlanExtendTrial, PutBillingInvoicingDetails } from './plans/http.api.js';
 import type { GetProvider, GetProviders, GetPublicProvider, GetPublicProviders } from './providers/api.js';
 import type { AllPublicProxy } from './proxy/http.api.js';
 import type { GetPublicRecords, PatchPublicPruneRecords } from './record/api.js';
@@ -28,7 +28,7 @@ import type { DeleteTeamUser, GetTeam, PatchTeamUser, PutTeam } from './team/api
 import type { GetUser, PatchUser } from './user/api.js';
 import type { PostPublicWebhook } from './webhooks/http.api.js';
 export type PublicApiEndpoints = SetMetadata | UpdateMetadata | PostDeploy | PostDeployConfirmation | PostPublicTrigger | PostPublicTbaAuthorization | PostPublicJwtAuthorization | PostPublicUnauthenticatedAuthorization | PostPublicApiKeyAuthorization | PostPublicBasicAuthorization | PostPublicAppStoreAuthorization | GetPublicProviders | GetPublicProvider | GetPublicListIntegrations | GetPublicIntegration | DeletePublicIntegration | PostConnectSessions | PostPublicConnectSessionsReconnect | GetPublicConnections | GetPublicConnection | GetConnectSession | DeleteConnectSession | PostDeployInternal | PostPublicBillAuthorization | DeletePublicConnection | PostPublicSignatureAuthorization | PostPublicTwoStepAuthorization | PostPublicWebhook | GetPublicRecords | PatchPublicPruneRecords | GetPublicScriptsConfig | PostPublicConnectTelemetry | PutPublicSyncConnectionFrequency | PostPublicIntegration | PatchPublicIntegration | GetAsyncActionResult | PostPublicOauthOutboundAuthorization | PostPublicConnection | PatchPublicConnection | PostPublicSyncStart | PostPublicSyncPause | GetPublicSyncStatus | GetPublicV1 | PostPublicTriggerAction | AllPublicProxy;
-export type PrivateApiEndpoints = PostSignup | PostSignin | PostLogout | GetTeam | PutTeam | PostPlanExtendTrial | PostPlanChange | GetUser | PatchUser | PostInvite | DeleteInvite | DeleteTeamUser | PatchTeamUser | PostInsights | PostForgotPassword | PutResetPassword | SearchOperations | GetOperation | SearchMessages | SearchFilters | PostInternalConnectSessions | GetIntegrationFlows | DeleteIntegration | PatchIntegration | GetIntegration | PostIntegration | GetConnections | GetConnectionsCount | GetConnection | GetInvite | GetMeta | GetEmailByExpiredToken | GetEmailByUuid | GetManagedCallback | PatchFlowDisable | PatchFlowEnable | PatchFlowFrequency | PutUpgradePreBuiltFlow | PostConnectionRefresh | PostManagedSignup | PostPreBuiltDeploy | PostEnvironment | PatchEnvironment | DeleteEnvironment | GetEnvironments | GetEnvironment | PatchWebhook | PostEnvironmentVariables | PostImpersonate | GetSharedCredentialsProviders | GetSharedCredentialsProvider | PostSharedCredentialsProvider | PatchSharedCredentialsProvider | GetGettingStarted | PatchGettingStarted | GetConnectUISettings | PutConnectUISettings | GetProviders | GetProvider;
+export type PrivateApiEndpoints = PostSignup | PostSignin | PostLogout | GetTeam | PutTeam | PostPlanExtendTrial | PostPlanChange | PutBillingInvoicingDetails | GetUser | PatchUser | PostInvite | DeleteInvite | DeleteTeamUser | PatchTeamUser | PostInsights | PostForgotPassword | PutResetPassword | SearchOperations | GetOperation | SearchMessages | SearchFilters | PostInternalConnectSessions | GetIntegrationFlows | DeleteIntegration | PatchIntegration | GetIntegration | PostIntegration | GetConnections | GetConnectionsCount | GetConnection | GetInvite | GetMeta | GetEmailByExpiredToken | GetEmailByUuid | GetManagedCallback | GetManagedEmailVerification | PatchFlowDisable | PatchFlowEnable | PatchFlowFrequency | PutUpgradePreBuiltFlow | PostConnectionRefresh | PostManagedEmailVerification | PostManagedSignup | PostPreBuiltDeploy | PostEnvironment | PatchEnvironment | DeleteEnvironment | GetEnvironments | GetEnvironment | PatchWebhook | PostEnvironmentVariables | PostImpersonate | GetSharedCredentialsProviders | GetSharedCredentialsProvider | PostSharedCredentialsProvider | PatchSharedCredentialsProvider | GetGettingStarted | PatchGettingStarted | GetConnectUISettings | PutConnectUISettings | GetProviders | GetProvider | PostInternalTriggerFunction;
 export type APIEndpoints = PrivateApiEndpoints | PublicApiEndpoints;
 /**
  * Automatically narrow endpoints type with Method + Path

package/dist/billing/types.d.ts

@@ -1,13 +1,12 @@
 import type { Result } from '../result.js';
 import type { DBTeam } from '../team/db.js';
 import type { UsageMetric } from '../usage/index.js';
-import type { DBUser } from '../user/db.js';
 export interface BillingClient {
     ingest: (events: BillingEvent[]) => Promise<Result<void>>;
-    upsertCustomer: (team: DBTeam, user: DBUser) => Promise<Result<BillingCustomer>>;
-    updateCustomer: (customerId: string, name: string) => Promise<Result<void>>;
     linkStripeToCustomer(teamId: number, customerId: string): Promise<Result<void>>;
+    getOrCreateCustomer: (accountId: number, defaultTo: Pick<BillingInvoicingDetails, 'legalEntityName' | 'email'>) => Promise<Result<BillingCustomer>>;
     getCustomer: (accountId: number) => Promise<Result<BillingCustomer>>;
+    putCustomer: (accountId: number, invoicingDetails: BillingInvoicingDetails) => Promise<Result<BillingCustomer>>;
     getSubscription: (accountId: number) => Promise<Result<BillingSubscription | null>>;
     createSubscription: (team: DBTeam, planExternalId: string) => Promise<Result<BillingSubscription>>;
     getUsage: (subscriptionId: string, opts?: GetBillingUsageOpts) => Promise<Result<BillingUsageMetrics>>;
@@ -37,8 +36,28 @@ export interface BillingClient {
 }
 export interface BillingCustomer {
     id: string;
+    invoicingDetails: BillingInvoicingDetails;
     portalUrl: string | null;
 }
+export interface BillingInvoicingDetails {
+    legalEntityName: string;
+    email: string;
+    address: BillingAddress | null;
+    taxId: BillingTaxId | null;
+}
+export interface BillingAddress {
+    line1: string | null;
+    line2: string | null;
+    city: string | null;
+    state: string | null;
+    postalCode: string | null;
+    country: string | null;
+}
+export interface BillingTaxId {
+    country: string;
+    type: string;
+    value: string;
+}
 export interface BillingSubscription {
     id: string;
     pendingChangeId?: string | undefined;

package/dist/index.d.ts

@@ -86,3 +86,4 @@ export type * from './checkpoint/db.js';
 export type * from './mcp/api.js';
 export type * from './lambda/index.js';
 export type * from './authz/types.js';
+export type * from './pubsub/events.js';

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

@@ -1,4 +1,4 @@
-import type { ApiBillingUsageMetrics, BillingCustomer } from '../billing/types.js';
+import type { ApiBillingUsageMetrics, BillingCustomer, BillingInvoicingDetails } from '../billing/types.js';
 import type { MetricUsageSummary, UsageMetric } from '../usage/index.js';
 import type { ReplaceInObject } from '../utils.js';
 import type { DBPlan } from './db.js';
@@ -76,6 +76,17 @@ export type GetBillingUsage = Endpoint<{
         };
     };
 }>;
+export type PutBillingInvoicingDetails = Endpoint<{
+    Method: 'PUT';
+    Path: '/api/v1/plans/billing/invoicing';
+    Querystring: {
+        env: string;
+    };
+    Body: BillingInvoicingDetails;
+    Success: {
+        data: BillingCustomer;
+    };
+}>;
 export type PostPlanChange = Endpoint<{
     Method: 'POST';
     Path: '/api/v1/plans/change';

package/dist/providers/api.d.ts

@@ -33,6 +33,7 @@ export interface ApiProviderListItem {
     name: string;
     displayName: string;
     defaultScopes?: string[] | undefined;
+    availableScopes?: string[] | undefined;
     authMode: AuthModeType;
     categories?: string[] | undefined;
     docs: string;

package/dist/providers/provider.d.ts

@@ -90,6 +90,7 @@ export interface BaseProvider {
     body_format?: OAuthBodyFormatType;
     require_client_certificate?: boolean;
     token_request_auth_method?: 'basic' | 'custom' | 'private_key_jwt';
+    available_scopes?: string[];
 }
 export interface ProviderOAuth2 extends BaseProvider {
     auth_mode: 'OAUTH2';

package/dist/proxy/api.d.ts

@@ -27,6 +27,11 @@ export interface BaseProxyConfiguration {
     retryHeader?: RetryHeaderConfig;
     retryOn?: number[] | null;
     forwardHeadersOnRedirect?: boolean;
+    /**
+     * If set, called with the absolute URL of each HTTP redirect before Axios follows it.
+     * Implementations may throw (e.g. shared `ProxyError`) to abort the redirect.
+     */
+    validateProxyRedirectUrl?: (absoluteRedirectUrl: string) => void;
 }
 export interface UserProvidedProxyConfiguration extends BaseProxyConfiguration {
     decompress?: boolean | string;

package/dist/pubsub/events.d.ts

@@ -0,0 +1,91 @@
+import type { FunctionRuntime } from '../runner/sdk.js';
+import type { DBTeam } from '../team/db.js';
+import type { DBUser } from '../user/db.js';
+type Serializable = string | number | boolean | Date | null | undefined | Serializable[] | {
+    [key: string]: Serializable;
+};
+interface EventBase<TSubject extends string, TType extends string, TPayload extends Serializable> {
+    idempotencyKey: string;
+    subject: TSubject;
+    type: TType;
+    payload: TPayload;
+    source?: string | undefined;
+    createdAt: Date;
+}
+type EnforceEventBase<T extends EventBase<any, any, any>> = T;
+export type Event = EnforceEventBase<UserCreatedEvent | UsageEvent | TeamUpdatedEvent>;
+export type UserCreatedEvent = EventBase<'user', 'user.created', {
+    userId: DBUser['id'];
+    teamId: DBTeam['id'];
+}>;
+export type TeamUpdatedEvent = EventBase<'team', 'team.updated', {
+    id: DBTeam['id'];
+}>;
+interface UsageEventBase<TType extends string, TPayload extends Serializable> extends EventBase<'usage', TType, TPayload> {
+    subject: 'usage';
+    type: TType;
+    payload: TPayload & {
+        value: number;
+        properties: {
+            accountId: number;
+            environmentId: number;
+            environmentName: string;
+            integrationId: string;
+            connectionId: string;
+        };
+    };
+}
+export type UsageRecordsEvent = UsageEventBase<'usage.records', {
+    value: number;
+    properties: {
+        syncId: string;
+        model: string;
+    };
+}>;
+export type UsageMarEvent = UsageEventBase<'usage.monthly_active_records', {
+    value: number;
+    properties: {
+        syncId: string;
+        model: string;
+    };
+}>;
+export type UsageActionsEvent = UsageEventBase<'usage.actions', {
+    value: number;
+    properties: {
+        actionName: string;
+    };
+}>;
+export type UsageConnectionsEvent = UsageEventBase<'usage.connections', {
+    value: number;
+}>;
+export type UsageFunctionExecutionsEvent = UsageEventBase<'usage.function_executions', {
+    value: number;
+    properties: {
+        type: 'sync' | 'action' | 'webhook' | 'on-event';
+        success: boolean;
+        functionName: string;
+        runtime: FunctionRuntime | undefined;
+        telemetryBag: {
+            durationMs: number;
+            memoryGb: number;
+            customLogs: number;
+            proxyCalls: number;
+        } | undefined;
+        frequencyMs?: number | undefined;
+    };
+}>;
+export type UsageProxyEvent = UsageEventBase<'usage.proxy', {
+    value: number;
+    properties: {
+        success: boolean;
+    };
+}>;
+export type UsageWebhookForwardEvent = UsageEventBase<'usage.webhook_forward', {
+    value: number;
+    properties: {
+        success: boolean;
+    };
+}>;
+type EnforceUsageEventBase<T extends UsageEventBase<any, any>> = T;
+export type UsageEvent = EnforceUsageEventBase<UsageMarEvent | UsageRecordsEvent | UsageActionsEvent | UsageConnectionsEvent | UsageFunctionExecutionsEvent | UsageProxyEvent | UsageWebhookForwardEvent>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nangohq/types",
-    "version": "0.69.48",
+    "version": "0.69.50",
     "description": "Types used in Nango applications",
     "type": "module",
     "typings": "dist/index.d.ts",
@@ -12,7 +12,7 @@
         "directory": "packages/utils"
     },
     "dependencies": {
-        "axios": "1.13.5",
+        "axios": "1.15.0",
         "json-schema": "0.4.0",
         "type-fest": "4.41.0"
     },