@nangohq/types 0.69.49 → 0.70.0

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, GetManagedEmailVerification, PostForgotPassword, PostLogout, PostManagedEmailVerification, PostManagedSignup, PostSignin, PostSignup, PutResetPassword } from './account/api.js';
-import type { GetAsyncActionResult, GetPublicV1, PostPublicTriggerAction } from './action/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';
@@ -12,12 +12,13 @@ import type { DeleteEnvironment, GetEnvironment, GetEnvironments, PatchEnvironme
 import type { PatchWebhook } from './environment/api/webhook.js';
 import type { PostEnvironmentVariables } from './environment/variable/api.js';
 import type { PatchFlowDisable, PatchFlowEnable, PatchFlowFrequency, PostPreBuiltDeploy, PutUpgradePreBuiltFlow } from './flow/http.api.js';
+import type { PostRemoteFunctionCompile, PostRemoteFunctionDeploy, PostRemoteFunctionDryrun } from './functions/api.js';
 import type { GetGettingStarted, PatchGettingStarted } from './gettingStarted/api.js';
 import type { DeleteIntegration, DeletePublicIntegration, GetIntegration, GetIntegrationFlows, GetPublicIntegration, GetPublicListIntegrations, PatchIntegration, PatchPublicIntegration, PostIntegration, PostPublicIntegration } from './integration/api.js';
 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';
@@ -27,8 +28,8 @@ import type { GetPublicSyncStatus, PostPublicSyncPause, PostPublicSyncStart, Pos
 import type { DeleteTeamUser, GetTeam, PatchTeamUser, PutTeam } from './team/api.js';
 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 | 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;
+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 | PostRemoteFunctionCompile | PostRemoteFunctionDryrun | PostRemoteFunctionDeploy | AllPublicProxy;
+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/functions/api.d.ts

@@ -0,0 +1,75 @@
+import type { ApiError, Endpoint } from '../api.js';
+export type FunctionType = 'action' | 'sync';
+export type FunctionErrorCode = 'invalid_request' | 'integration_not_found' | 'compilation_error' | 'dryrun_error' | 'deployment_error' | 'connection_not_found' | 'function_disabled' | 'timeout' | 'validation_error';
+export interface ProxyCall {
+    method: string;
+    endpoint: string;
+    status: number;
+    request: {
+        params?: Record<string, unknown>;
+        headers?: Record<string, unknown>;
+        data?: unknown;
+    };
+    response: unknown;
+    headers: Record<string, unknown>;
+}
+export type PostRemoteFunctionCompile = Endpoint<{
+    Method: 'POST';
+    Path: '/remote-function/compile';
+    Body: {
+        integration_id: string;
+        function_name: string;
+        function_type: FunctionType;
+        code: string;
+    };
+    Error: ApiError<FunctionErrorCode>;
+    Success: {
+        integration_id: string;
+        function_name: string;
+        function_type: FunctionType;
+        bundle_size_bytes: number;
+        bundled_js: string;
+        compiled_at: string;
+    };
+}>;
+export type PostRemoteFunctionDryrun = Endpoint<{
+    Method: 'POST';
+    Path: '/remote-function/dryrun';
+    Body: {
+        integration_id: string;
+        function_name: string;
+        function_type: FunctionType;
+        code: string;
+        connection_id: string;
+        input?: unknown;
+        metadata?: Record<string, unknown> | undefined;
+        checkpoint?: Record<string, unknown> | undefined;
+        last_sync_date?: string | undefined;
+    };
+    Error: ApiError<FunctionErrorCode>;
+    Success: {
+        integration_id: string;
+        function_name: string;
+        function_type: FunctionType;
+        execution_timeout_at: string;
+        duration_ms: number;
+        output: string;
+    };
+}>;
+export type PostRemoteFunctionDeploy = Endpoint<{
+    Method: 'POST';
+    Path: '/remote-function/deploy';
+    Body: {
+        integration_id: string;
+        function_name: string;
+        function_type: FunctionType;
+        code: string;
+    };
+    Error: ApiError<FunctionErrorCode>;
+    Success: {
+        integration_id: string;
+        function_name: string;
+        function_type: FunctionType;
+        output: string;
+    };
+}>;

package/dist/index.d.ts

@@ -84,6 +84,7 @@ export type * from './jobs/api.js';
 export type * from './checkpoint/types.js';
 export type * from './checkpoint/db.js';
 export type * from './mcp/api.js';
+export type * from './functions/api.js';
 export type * from './lambda/index.js';
 export type * from './authz/types.js';
 export type * from './pubsub/events.js';

package/dist/plans/db.d.ts

@@ -100,6 +100,12 @@ export interface DBPlan extends Timestamps {
      * @default false
      */
     has_webhooks_forward: boolean;
+    /**
+     * Enable role-based access control (non-administrator roles)
+     * When false, all users/invites must be 'administrator'
+     * @default false
+     */
+    has_rbac: boolean;
     /**
      * Enable or disable the ability to override the docs connect url from the connect session
      * @default false
@@ -115,11 +121,21 @@ export interface DBPlan extends Timestamps {
      * @default false
      */
     can_disable_connect_ui_watermark: boolean;
+    /**
+     * Enable or disable remote function compile, dry-run, and deploy endpoints
+     * @default false
+     */
+    remote_functions: boolean;
     /**
      * Sync Function Runtime
      * @default "runner"
      */
     sync_function_runtime: FunctionRuntime;
+    /**
+     * When true, syncs routed to the Lambda fleet require the checkpoints feature or they run on the runner fleet.
+     * @default true
+     */
+    sync_lambda_checkpoint_required: boolean;
     /**
      * Action Function Runtime
      * @default "runner"

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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nangohq/types",
-    "version": "0.69.49",
+    "version": "0.70.0",
     "description": "Types used in Nango applications",
     "type": "module",
     "typings": "dist/index.d.ts",