@nangohq/types 0.70.5 → 0.70.7

package/dist/api-keys/scopes.d.ts

@@ -1,3 +1,3 @@
-export declare const API_KEY_SCOPES: readonly ["environment:*", "environment:integrations:list", "environment:integrations:list_credentials", "environment:integrations:list_functions", "environment:integrations:read", "environment:integrations:read_credentials", "environment:integrations:create", "environment:integrations:update", "environment:integrations:delete", "environment:integrations:*", "environment:connections:list", "environment:connections:list_credentials", "environment:connections:read", "environment:connections:read_credentials", "environment:connections:create", "environment:connections:update", "environment:connections:delete", "environment:connections:*", "environment:connect_sessions:write", "environment:syncs:read", "environment:syncs:execute", "environment:syncs:update", "environment:syncs:variant:create", "environment:syncs:variant:delete", "environment:syncs:*", "environment:deploy", "environment:dryrun", "environment:records:read", "environment:records:write", "environment:records:*", "environment:actions:execute", "environment:actions:*", "environment:proxy", "environment:variables:read", "environment:mcp"];
+export declare const API_KEY_SCOPES: readonly ["environment:*", "environment:integrations:list", "environment:integrations:list_credentials", "environment:integrations:list_functions", "environment:integrations:read", "environment:integrations:read_credentials", "environment:integrations:create", "environment:integrations:update", "environment:integrations:delete", "environment:integrations:*", "environment:connections:list", "environment:connections:list_credentials", "environment:connections:read", "environment:connections:read_credentials", "environment:connections:create", "environment:connections:update", "environment:connections:delete", "environment:connections:*", "environment:connect_sessions:write", "environment:syncs:read", "environment:syncs:execute", "environment:syncs:update", "environment:syncs:variant:create", "environment:syncs:variant:delete", "environment:syncs:*", "environment:functions:list", "environment:functions:read", "environment:functions:delete", "environment:functions:compile", "environment:functions:dryrun", "environment:functions:*", "environment:deploy", "environment:records:read", "environment:records:write", "environment:records:*", "environment:actions:execute", "environment:actions:*", "environment:proxy", "environment:variables:read", "environment:mcp"];
 export type ApiKeyScope = (typeof API_KEY_SCOPES)[number];
 export declare const ALL_SCOPES: string[];

package/dist/api.endpoints.d.ts

@@ -2,7 +2,7 @@ import type { GetEmailByExpiredToken, GetEmailByUuid, GetManagedCallback, GetMan
 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';
+import type { PostPublicApiKeyAuthorization, PostPublicAppStoreAuthorization, PostPublicAwsSigV4Authorization, PostPublicBasicAuthorization, PostPublicBillAuthorization, PostPublicJwtAuthorization, PostPublicOauthOutboundAuthorization, PostPublicSignatureAuthorization, PostPublicTbaAuthorization, PostPublicTwoStepAuthorization, PostPublicUnauthenticatedAuthorization } from './auth/http.api.js';
 import type { DeleteConnectSession, GetConnectSession, PostConnectSessions, PostInternalConnectSessions, PostPublicConnectSessionsReconnect, PostPublicConnectTelemetry } from './connect/api.js';
 import type { GetConnectUISettings, PutConnectUISettings } from './connectUISettings/api.js';
 import type { DeletePublicConnection, GetConnection, GetConnections, GetConnectionsCount, GetPublicConnection, GetPublicConnections, PatchPublicConnection, PostConnectionRefresh, PostPublicConnection } from './connection/api/get.js';
@@ -12,13 +12,13 @@ import type { CreateApiKey, DeleteApiKey, DeleteEnvironment, GetEnvironment, Get
 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 { GetIntegrationFunction, GetIntegrationFunctions, GetIntegrationTemplates, GetProviderTemplates, PostRemoteFunctionCompile, PostRemoteFunctionDeploy, PostRemoteFunctionDryrun } from './functions/api.js';
+import type { DeleteIntegrationFunction, DeletePublicIntegrationFunction, GetFunctionDeployment, GetFunctionDryrun, GetIntegrationFunction, GetIntegrationFunctions, GetIntegrationTemplates, GetProviderTemplates, GetPublicIntegrationFunction, GetPublicIntegrationFunctions, GetPublicProviderTemplates, PostFunctionCompile, PostFunctionDeployment, PostFunctionDeploymentResult, PostFunctionDryrun, PostFunctionDryrunResult } from './functions/api.js';
 import type { GetGettingStarted, PatchGettingStarted } from './gettingStarted/api.js';
 import type { DeleteIntegration, DeletePublicIntegration, GetIntegration, GetIntegrationFlows, GetPublicFunctionCode, GetPublicIntegration, GetPublicListIntegrations, PatchIntegration, PatchPublicIntegration, PostIntegration, PostPublicIntegration, PostPublicQuickstartIntegration } 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, PutBillingInvoicingDetails } from './plans/http.api.js';
+import type { GetBillingUsage, GetBillingUsageTopDimensionValues, 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';
@@ -26,10 +26,10 @@ import type { GetPublicScriptsConfig } from './scripts/http.api.js';
 import type { GetSharedCredentialsProvider, GetSharedCredentialsProviders, PatchSharedCredentialsProvider, PostSharedCredentialsProvider } from './sharedCredentials/api.js';
 import type { GetPublicSyncStatus, PostPublicSyncPause, PostPublicSyncStart, PostPublicTrigger, PutPublicSyncConnectionFrequency } from './sync/api.js';
 import type { DeleteTeamUser, GetTeam, PatchTeamUser, PutTeam } from './team/api.js';
-import type { GetUser, PatchUser } from './user/api.js';
+import type { GetUser, PatchUser, PutUserPassword } 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 | PostPublicQuickstartIntegration | PatchPublicIntegration | GetAsyncActionResult | PostPublicOauthOutboundAuthorization | PostPublicConnection | PatchPublicConnection | PostPublicSyncStart | PostPublicSyncPause | GetPublicSyncStatus | GetPublicV1 | PostPublicTriggerAction | PostRemoteFunctionCompile | PostRemoteFunctionDryrun | PostRemoteFunctionDeploy | GetPublicFunctionCode | 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 | GetIntegrationFunction | GetIntegrationFunctions | GetIntegrationTemplates | GetProviderTemplates | 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 | ListApiKeys | CreateApiKey | DeleteApiKey | PatchApiKey | PatchWebhook | PostEnvironmentVariables | PostImpersonate | GetSharedCredentialsProviders | GetSharedCredentialsProvider | PostSharedCredentialsProvider | PatchSharedCredentialsProvider | GetGettingStarted | PatchGettingStarted | GetConnectUISettings | PutConnectUISettings | GetProviders | GetProvider | PostInternalTriggerFunction;
+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 | PostPublicQuickstartIntegration | PatchPublicIntegration | GetAsyncActionResult | PostPublicOauthOutboundAuthorization | PostPublicAwsSigV4Authorization | PostPublicConnection | PatchPublicConnection | PostPublicSyncStart | PostPublicSyncPause | GetPublicSyncStatus | GetPublicV1 | PostPublicTriggerAction | PostFunctionCompile | PostFunctionDryrun | GetFunctionDryrun | PostFunctionDryrunResult | PostFunctionDeployment | GetFunctionDeployment | PostFunctionDeploymentResult | GetPublicFunctionCode | GetPublicIntegrationFunctions | GetPublicIntegrationFunction | DeletePublicIntegrationFunction | GetPublicProviderTemplates | AllPublicProxy;
+export type PrivateApiEndpoints = PostSignup | PostSignin | PostLogout | GetTeam | PutTeam | PostPlanExtendTrial | PostPlanChange | PutBillingInvoicingDetails | GetBillingUsage | GetBillingUsageTopDimensionValues | GetUser | PatchUser | PutUserPassword | PostInvite | DeleteInvite | DeleteTeamUser | PatchTeamUser | PostInsights | PostForgotPassword | PutResetPassword | SearchOperations | GetOperation | SearchMessages | SearchFilters | PostInternalConnectSessions | GetIntegrationFlows | GetIntegrationFunction | GetIntegrationFunctions | DeleteIntegrationFunction | GetIntegrationTemplates | GetProviderTemplates | 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 | ListApiKeys | CreateApiKey | DeleteApiKey | PatchApiKey | 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/auth/api.d.ts

@@ -17,6 +17,7 @@ export interface AuthModes {
     MCP_OAUTH2: 'MCP_OAUTH2';
     MCP_OAUTH2_GENERIC: 'MCP_OAUTH2_GENERIC';
     InstallPlugin: 'INSTALL_PLUGIN';
+    AwsSigV4: 'AWS_SIGV4';
 }
 export type AuthModeType = AuthModes[keyof AuthModes];
 export type AuthOperationType = 'creation' | 'override' | 'refresh' | 'unknown';
@@ -146,6 +147,17 @@ export interface InstallPluginCredentials {
     type: AuthModes['Basic'];
     [key: string]: any;
 }
+export interface AwsSigV4Credentials extends CredentialsCommon {
+    type: AuthModes['AwsSigV4'];
+    role_arn: string;
+    region: string;
+    service: string;
+    access_key_id: string;
+    secret_access_key: string;
+    session_token: string;
+    expires_at?: Date | undefined;
+    external_id?: string | undefined;
+}
 export interface CombinedOauth2AppCredentials extends CredentialsCommon {
     type: AuthModes['Custom'];
     app: AppCredentials;
@@ -157,5 +169,5 @@ export interface AuthorizationTokenResponse extends Omit<OAuth2Credentials, 'typ
     expires_in?: number;
 }
 export type TestableCredentials = ApiKeyCredentials | BasicApiCredentials | TbaCredentials | JwtCredentials | SignatureCredentials;
-export type RefreshableCredentials = OAuth2Credentials | AppCredentials | AppStoreCredentials | OAuth2ClientCredentials | JwtCredentials | TwoStepCredentials | BillCredentials | SignatureCredentials;
-export type AllAuthCredentials = OAuth1Credentials | OAuth2Credentials | OAuth2ClientCredentials | BasicApiCredentials | ApiKeyCredentials | AppCredentials | AppStoreCredentials | UnauthCredentials | CustomCredentials | TbaCredentials | JwtCredentials | BillCredentials | TwoStepCredentials | CombinedOauth2AppCredentials | SignatureCredentials | InstallPluginCredentials;
+export type RefreshableCredentials = OAuth2Credentials | AppCredentials | AppStoreCredentials | OAuth2ClientCredentials | JwtCredentials | TwoStepCredentials | BillCredentials | SignatureCredentials | AwsSigV4Credentials;
+export type AllAuthCredentials = OAuth1Credentials | OAuth2Credentials | OAuth2ClientCredentials | BasicApiCredentials | ApiKeyCredentials | AppCredentials | AppStoreCredentials | UnauthCredentials | CustomCredentials | TbaCredentials | JwtCredentials | BillCredentials | TwoStepCredentials | CombinedOauth2AppCredentials | SignatureCredentials | InstallPluginCredentials | AwsSigV4Credentials;

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

@@ -156,6 +156,21 @@ export type PostPublicSignatureAuthorization = Endpoint<{
     Error: AuthErrors;
     Success: ConnectionResponseSuccess;
 }>;
+type AwsSigV4AuthErrors = AuthErrors | ApiError<'invalid_aws_sigv4_config'> | ApiError<'missing_aws_sigv4_service'> | ApiError<'missing_aws_sigv4_sts_endpoint'> | ApiError<'missing_aws_sigv4_builtin_credentials'> | ApiError<'missing_aws_sigv4_region'> | ApiError<'aws_sigv4_sts_request_failed'>;
+export type PostPublicAwsSigV4Authorization = Endpoint<{
+    Method: 'POST';
+    Body: {
+        role_arn: string;
+        region?: string | undefined;
+    };
+    Querystring: ConnectionQueryString;
+    Params: {
+        providerConfigKey: string;
+    };
+    Path: '/auth/aws-sigv4/:providerConfigKey';
+    Error: AwsSigV4AuthErrors;
+    Success: ConnectionResponseSuccess;
+}>;
 export type PostPublicOauthOutboundAuthorization = Endpoint<{
     Method: 'POST';
     Body: {

package/dist/billing/types.d.ts

@@ -70,6 +70,18 @@ export interface BillingSubscription {
     pendingChangeId?: string | undefined;
     planExternalId: string;
 }
+export type CounterUsageMetric = Exclude<UsageMetric, 'records' | 'connections'>;
+export type AvgUsageMetric = Extract<UsageMetric, 'records' | 'connections'>;
+export interface BreakdownDimensions {
+    proxy: 'environment_id' | 'integration_id' | 'connection_id' | 'success';
+    function_executions: 'environment_id' | 'integration_id' | 'connection_id' | 'function_name' | 'function_type' | 'success';
+    function_logs: 'environment_id' | 'integration_id' | 'connection_id' | 'function_name' | 'function_type' | 'success';
+    function_compute_gbms: 'environment_id' | 'integration_id' | 'connection_id' | 'function_name' | 'function_type' | 'success';
+    webhook_forwards: 'environment_id' | 'integration_id' | 'connection_id' | 'success';
+    records: 'environment_id' | 'integration_id' | 'connection_id' | 'model';
+    connections: 'environment_id' | 'integration_id';
+}
+export type DimensionFor<M extends UsageMetric> = 'none' | BreakdownDimensions[M];
 export interface GetBillingUsageOpts {
     timeframe?: {
         start: Date;
@@ -80,6 +92,44 @@ export interface GetBillingUsageOpts {
         id: string;
         group_by?: 'environmentId' | 'environmentName' | 'integrationId' | 'type' | 'functionName' | 'model';
     };
+    /**
+     * Per-request override of the dashboard backend source. Honoured only
+     * when `FLAG_ALLOW_OVERRIDE_GETUSAGE_SERVICE` is enabled (dev gate); ignored
+     * everywhere else, so the default stays Orb. Only used by
+     * `UsageTracker.getBillingUsage`; the Orb client itself ignores it.
+     */
+    source?: 'clickhouse' | 'orb';
+    /**
+     * Per-metric dimension breakdown spec. Honoured only on the CH path
+     * (records / connections via `getDailySumAndBatches`, counters via
+     * `getDailyCounter`); the Orb client ignores it. Each metric's
+     * `BillingUsageMetric` gains a `breakdown` array of up to `top + 1`
+     * series (top-N dimension values + a single 'rest' aggregating the
+     * long tail). Top defaults to 10 and is clamped server-side to
+     * the CH cap.
+     */
+    breakdown?: {
+        [M in UsageMetric]?: BreakdownDimensions[M] | undefined;
+    };
+    top?: number;
+    /**
+     * Subset of metrics to populate in the response. When set, only those
+     * metrics are fanned out (CH path) and returned. Omitted → all 7.
+     * Ignored on the Orb path.
+     */
+    metrics?: UsageMetric[];
+    /**
+     * Per-metric row-level filter: scopes that metric's response to rows
+     * where the given dimension equals the given value. Mutually exclusive
+     * with `breakdown[<metric>]` on the same metric — controllers reject
+     * the combination. CH path only; the Orb client ignores it.
+     */
+    filter?: {
+        [M in UsageMetric]?: {
+            dimension: BreakdownDimensions[M];
+            value: string;
+        } | undefined;
+    };
 }
 export interface BillingUsageMetric {
     externalId: string;
@@ -87,6 +137,15 @@ export interface BillingUsageMetric {
         key: string;
         value: string;
     };
+    /**
+     * The top-N + 'rest' breakdown collapses every dim value outside the top
+     * into a single rollup bucket. Marked with `isRest: true` so the dashboard
+     * can distinguish it from a real dim value that happens to literally be
+     * the string 'rest' (e.g. a `connection_id` or `model` named 'rest').
+     * `group.value` is set to the display string 'rest' as a default; the
+     * flag is the authoritative signal.
+     */
+    isRest?: true;
     total: number;
     usage: {
         timeframeStart: Date;
@@ -94,6 +153,19 @@ export interface BillingUsageMetric {
         quantity: number;
     }[];
     view_mode: 'cumulative' | 'periodic';
+    /**
+     * Populated only when the request included a `breakdown` spec for this
+     * metric AND the CH path served the request. Each entry is a per-
+     * dimension-value series (carrying its own `group: {key, value}`), with
+     * one 'rest' entry aggregating the long tail.
+     *
+     * Mutually exclusive with the top-level `usage`/`total`: when breakdown
+     * is requested the top-level is empty (`usage: []`, `total: 0`) and only
+     * `breakdown` carries data — callers asking for a breakdown opt into the
+     * per-dim view. When breakdown is NOT requested, the top-level is the
+     * no-dim global and this field is absent.
+     */
+    breakdown?: BillingUsageMetric[];
 }
 export type BillingUsageMetrics = Partial<Record<UsageMetric, BillingUsageMetric | undefined>>;
 export interface ApiBillingUsageMetric extends BillingUsageMetric {

package/dist/functions/api.d.ts

@@ -1,6 +1,7 @@
 import type { ApiError, Endpoint } from '../api.js';
 import type { DeployedNangoFunction, FunctionType, NangoActionFunction, NangoFunctionTemplate, NangoSyncFunction } from './domain.js';
-export type FunctionErrorCode = 'invalid_request' | 'integration_not_found' | 'compilation_error' | 'dryrun_error' | 'deployment_error' | 'connection_not_found' | 'function_disabled' | 'timeout' | 'validation_error';
+export type RunnableFunctionType = Extract<FunctionType, 'action' | 'sync'>;
+export type FunctionErrorCode = 'invalid_request' | 'server_error' | 'integration_not_found' | 'compilation_error' | 'dryrun_error' | 'deployment_error' | 'connection_not_found' | 'dryrun_not_found' | 'deployment_not_found' | 'function_disabled' | 'execution_environment_unavailable' | 'timeout' | 'validation_error';
 export interface ProxyCall {
     method: string;
     endpoint: string;
@@ -13,92 +14,205 @@ export interface ProxyCall {
     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;
+export interface FunctionCompileBody {
+    code: string;
+}
+export interface FunctionCompileSuccess {
+    bundle_size_bytes: number;
+    bundled_js: string;
+    compiled_at: string;
+}
+export interface FunctionDryrunBody {
+    integration_id: string;
+    function_type: RunnableFunctionType;
+    code: string;
+    connection_id: string;
+    input?: unknown;
+    metadata?: Record<string, unknown> | undefined;
+    checkpoint?: Record<string, unknown> | undefined;
+    last_sync_date?: string | undefined;
+}
+export type FunctionAsyncJobStatus = 'waiting' | 'running' | 'success' | 'failed';
+export type FunctionDryrunStatus = FunctionAsyncJobStatus;
+export type FunctionDeploymentStatus = FunctionAsyncJobStatus;
+export interface FunctionDryrunCreateSuccess {
+    id: string;
+    status: Extract<FunctionDryrunStatus, 'waiting' | 'running'>;
+    created_at: string;
+}
+export interface FunctionDryrunResultSuccess {
+    id: string;
+    status: FunctionDryrunStatus;
+    integration_id: string;
+    function_type: RunnableFunctionType;
+    created_at: string;
+    updated_at: string;
+    started_at?: string | undefined;
+    completed_at?: string | undefined;
+    duration_ms?: number | undefined;
+    output?: string | undefined;
+    result?: unknown;
+    error?: ApiError<FunctionErrorCode>['error'] | undefined;
+}
+export type FunctionDryrunResultBody = {
+    status: 'success';
+    output: string;
+    duration_ms?: number | undefined;
+} | {
+    status: 'failed';
+    output?: string | undefined;
+    duration_ms?: number | undefined;
+    error: {
+        code?: string | undefined;
+        message: string;
+        payload?: unknown;
+    };
+};
+export interface FunctionDeploymentBody {
+    type: 'function';
+    integration_id: string;
+    function_name: string;
+    function_type: RunnableFunctionType;
+    code: string;
+    version?: string | undefined;
+    allow_destructive?: boolean | undefined;
+}
+export interface FunctionDeploymentCreateSuccess {
+    id: string;
+    status: Extract<FunctionDeploymentStatus, 'waiting' | 'running'>;
+    created_at: string;
+}
+export interface FunctionDeploymentResultSuccess {
+    id: string;
+    status: FunctionDeploymentStatus;
+    integration_id: string;
+    function_name: string;
+    function_type: RunnableFunctionType;
+    created_at: string;
+    updated_at: string;
+    started_at?: string | undefined;
+    completed_at?: string | undefined;
+    duration_ms?: number | undefined;
+    deployed?: boolean | undefined;
+    deployed_functions?: {
+        name: string;
+        version: string;
+    }[] | undefined;
+    output?: string | undefined;
+    error?: ApiError<FunctionErrorCode>['error'] | undefined;
+}
+export type FunctionDeploymentResultBody = {
+    status: 'success';
+    output: string;
+    duration_ms?: number | undefined;
+} | {
+    status: 'failed';
+    output?: string | undefined;
+    duration_ms?: number | undefined;
+    error: {
+        code?: string | undefined;
+        message: string;
+        payload?: unknown;
     };
+};
+export type PostFunctionCompile = Endpoint<{
+    Method: 'POST';
+    Path: '/functions/compile';
+    Body: FunctionCompileBody;
     Error: ApiError<FunctionErrorCode>;
-    Success: {
-        integration_id: string;
-        function_name: string;
-        function_type: FunctionType;
-        bundle_size_bytes: number;
-        bundled_js: string;
-        compiled_at: string;
+    Success: FunctionCompileSuccess;
+}>;
+export type PostFunctionDryrun = Endpoint<{
+    Method: 'POST';
+    Path: '/functions/dryruns';
+    Body: FunctionDryrunBody;
+    Error: ApiError<FunctionErrorCode>;
+    Success: FunctionDryrunCreateSuccess;
+}>;
+export type GetFunctionDryrun = Endpoint<{
+    Method: 'GET';
+    Path: '/functions/dryruns/:id';
+    Params: {
+        id: string;
     };
+    Error: ApiError<FunctionErrorCode>;
+    Success: FunctionDryrunResultSuccess;
 }>;
-export type PostRemoteFunctionDryrun = Endpoint<{
+export type PostFunctionDryrunResult = 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;
+    Path: '/functions/dryruns/:id/result';
+    Params: {
+        id: string;
     };
+    Body: FunctionDryrunResultBody;
     Error: ApiError<FunctionErrorCode>;
     Success: {
-        integration_id: string;
-        function_name: string;
-        function_type: FunctionType;
-        execution_timeout_at: string;
-        duration_ms: number;
-        result?: unknown;
+        ok: true;
     };
 }>;
-export type PostRemoteFunctionDeploy = Endpoint<{
+export type PostFunctionDeployment = Endpoint<{
     Method: 'POST';
-    Path: '/remote-function/deploy';
-    Body: {
-        integration_id: string;
-        function_name: string;
-        function_type: FunctionType;
-        code: string;
+    Path: '/functions/deployments';
+    Body: FunctionDeploymentBody;
+    Error: ApiError<FunctionErrorCode>;
+    Success: FunctionDeploymentCreateSuccess;
+}>;
+export type GetFunctionDeployment = Endpoint<{
+    Method: 'GET';
+    Path: '/functions/deployments/:id';
+    Params: {
+        id: string;
     };
     Error: ApiError<FunctionErrorCode>;
+    Success: FunctionDeploymentResultSuccess;
+}>;
+export type PostFunctionDeploymentResult = Endpoint<{
+    Method: 'POST';
+    Path: '/functions/deployments/:id/result';
+    Params: {
+        id: string;
+    };
+    Body: FunctionDeploymentResultBody;
+    Error: ApiError<FunctionErrorCode>;
     Success: {
-        integration_id: string;
-        function_name: string;
-        function_type: FunctionType;
-        deployed: boolean;
-        deployed_functions: {
-            name: string;
-            version: string;
-        }[];
-        output: string;
+        ok: true;
     };
 }>;
+export interface FunctionListFilters {
+    type?: FunctionType;
+    search?: string;
+    page?: number;
+    limit?: number;
+}
+export interface FunctionListSuccess {
+    data: DeployedNangoFunction[];
+    pagination: {
+        total: number;
+        page: number;
+        limit: number;
+    };
+}
+export interface DeployedFunctionSuccess {
+    data: DeployedNangoFunction;
+}
+export interface FunctionDeletionSuccess {
+    data: {
+        success: boolean;
+    };
+}
+export interface ProviderTemplatesSuccess {
+    data: (NangoSyncFunction | NangoActionFunction)[];
+}
 export type GetIntegrationFunctions = Endpoint<{
     Method: 'GET';
     Path: '/api/v1/integrations/:providerConfigKey/functions';
     Querystring: {
         env: string;
-        type?: FunctionType;
-        search?: string;
-        page?: number;
-        limit?: number;
-    };
+    } & FunctionListFilters;
     Params: {
         providerConfigKey: string;
     };
-    Success: {
-        data: DeployedNangoFunction[];
-        pagination: {
-            total: number;
-            page: number;
-            limit: number;
-        };
-    };
+    Success: FunctionListSuccess;
 }>;
 export type GetIntegrationFunction = Endpoint<{
     Method: 'GET';
@@ -111,9 +225,22 @@ export type GetIntegrationFunction = Endpoint<{
         providerConfigKey: string;
         functionName: string;
     };
-    Success: {
-        data: DeployedNangoFunction;
+    Success: DeployedFunctionSuccess;
+}>;
+export type DeleteIntegrationFunction = Endpoint<{
+    Method: 'DELETE';
+    Path: '/api/v1/integrations/:providerConfigKey/functions/:functionName';
+    /** TODO: support deleting on-event functions */
+    Querystring: {
+        env: string;
+        type: RunnableFunctionType;
+    };
+    Params: {
+        providerConfigKey: string;
+        functionName: string;
     };
+    Error: ApiError<'function_managed_by_deploy'>;
+    Success: FunctionDeletionSuccess;
 }>;
 export type GetProviderTemplates = Endpoint<{
     Method: 'GET';
@@ -124,9 +251,50 @@ export type GetProviderTemplates = Endpoint<{
     Params: {
         providerConfigKey: string;
     };
-    Success: {
-        data: (NangoSyncFunction | NangoActionFunction)[];
+    Success: ProviderTemplatesSuccess;
+}>;
+export type GetPublicIntegrationFunctions = Endpoint<{
+    Method: 'GET';
+    Path: '/integrations/:uniqueKey/functions';
+    Querystring: FunctionListFilters;
+    Params: {
+        uniqueKey: string;
+    };
+    Success: FunctionListSuccess;
+}>;
+export type GetPublicIntegrationFunction = Endpoint<{
+    Method: 'GET';
+    Path: '/integrations/:uniqueKey/functions/:name';
+    Querystring: {
+        type?: FunctionType;
+    };
+    Params: {
+        uniqueKey: string;
+        name: string;
+    };
+    Success: DeployedFunctionSuccess;
+}>;
+export type DeletePublicIntegrationFunction = Endpoint<{
+    Method: 'DELETE';
+    Path: '/integrations/:uniqueKey/functions/:name';
+    /** TODO: support deleting on-event functions */
+    Querystring: {
+        type: RunnableFunctionType;
+    };
+    Params: {
+        uniqueKey: string;
+        name: string;
+    };
+    Error: ApiError<'function_managed_by_deploy'>;
+    Success: FunctionDeletionSuccess;
+}>;
+export type GetPublicProviderTemplates = Endpoint<{
+    Method: 'GET';
+    Path: '/providers/:provider/templates';
+    Params: {
+        provider: string;
     };
+    Success: ProviderTemplatesSuccess;
 }>;
 export type GetIntegrationTemplates = Endpoint<{
     Method: 'GET';

package/dist/integration/api.d.ts

@@ -10,6 +10,7 @@ export type ApiPublicIntegration = Merge<Pick<IntegrationConfig, 'created_at' |
 } & ApiPublicIntegrationInclude;
 export interface ApiPublicIntegrationInclude {
     webhook_url?: string | null;
+    credentials_label?: Record<string, string> | undefined;
     credentials?: {
         type: AuthModes['OAuth2'] | AuthModes['OAuth1'] | AuthModes['TBA'];
         client_id: string | null;
@@ -49,6 +50,7 @@ export type PostPublicIntegration = Endpoint<{
         display_name?: string | undefined;
         credentials?: ApiPublicIntegrationCredentials | undefined;
         forward_webhooks?: boolean | undefined;
+        integration_config?: Record<string, string> | undefined;
     };
     Success: {
         data: ApiPublicIntegration;
@@ -91,6 +93,8 @@ export type PatchPublicIntegration = Endpoint<{
         display_name?: string | undefined;
         credentials?: ApiPublicIntegrationCredentials | undefined;
         forward_webhooks?: boolean | undefined;
+        integration_config?: Record<string, string> | undefined;
+        custom?: Record<string, string> | undefined;
     };
     Success: {
         data: ApiPublicIntegration;
@@ -208,6 +212,7 @@ export type PostIntegration = Endpoint<{
         displayName?: string | undefined;
         forward_webhooks?: boolean | undefined;
         auth?: IntegrationAuthBody | undefined;
+        integrationConfig?: Record<string, string> | undefined;
     };
     Success: {
         data: ApiIntegration;
@@ -248,6 +253,7 @@ export type PatchIntegration = Endpoint<{
         webhookSecret?: string | undefined;
         displayName?: string | undefined;
         forward_webhooks?: boolean | undefined;
+        integrationConfig?: Record<string, string> | undefined;
     } | IntegrationAuthBody;
     Success: {
         data: {

package/dist/meta/api.d.ts

@@ -14,6 +14,7 @@ export type GetMeta = Endpoint<{
             baseUrl: string;
             debugMode: boolean;
             gettingStartedClosed: boolean;
+            billingUsageSource: 'clickhouse' | 'orb';
         };
     };
 }>;

package/dist/persist/api.d.ts

@@ -16,6 +16,30 @@ export type PostLog = Endpoint<{
     Error: ApiError<'post_log_failed'>;
     Success: never;
 }>;
+type WithTags<T> = T & {
+    integrationId: string;
+    connectionId: string;
+    syncId?: string | undefined;
+};
+export type RunnerDataTransferTelemetry = WithTags<{
+    type: 'data_transfer';
+    callsite: 'proxy' | 'uncontrolled_fetch' | 'persist_records' | 'persist_logs';
+    bytesSent: number;
+    bytesReceived: number;
+}>;
+export type RunnerTelemetry = RunnerDataTransferTelemetry;
+export type PostRunnerTelemetry = Endpoint<{
+    Method: 'POST';
+    Path: '/environment/:environmentId/runner/telemetry';
+    Params: {
+        environmentId: number;
+    };
+    Body: {
+        events: RunnerTelemetry[];
+    };
+    Error: ApiError<'post_runner_telemetry_failed'>;
+    Success: never;
+}>;
 export interface PostRecordsSuccess {
     nextMerging: MergingStrategy;
 }

package/dist/plans/db.d.ts

@@ -80,6 +80,11 @@ export interface DBPlan extends Timestamps {
      * @default false
      */
     has_otel: boolean;
+    /**
+     * Enable runner telemetry export to persist
+     * @default false
+     */
+    export_runner_telemetry: boolean;
     /**
      * Change the applied rate limit for the public API
      * @default "m"
@@ -121,11 +126,6 @@ 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"
@@ -156,6 +156,11 @@ export interface DBPlan extends Timestamps {
      * @default true
      */
     has_records_autopruning: boolean;
+    /**
+     * Records store key for this account
+     * @default 'default'
+     */
+    records_store: 'default' | 'records2';
     /**
      * Limit the number of variants per sync
      * @default 100

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

@@ -1,8 +1,8 @@
-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';
 import type { Endpoint } from '../api.js';
+import type { ApiBillingUsageMetrics, BillingCustomer, BillingInvoicingDetails, BreakdownDimensions } from '../billing/types.js';
+import type { MetricUsageSummary, UsageMetric } from '../usage/index.js';
+import type { ReplaceInObject } from '../utils.js';
 export type ApiPlan = ReplaceInObject<DBPlan, Date, string>;
 export type PostPlanExtendTrial = Endpoint<{
     Method: 'POST';
@@ -61,6 +61,28 @@ export type GetUsage = Endpoint<{
         data: Record<UsageMetric, MetricUsageSummary>;
     };
 }>;
+export type GetBillingUsageTopDimensionValues = Endpoint<{
+    Method: 'GET';
+    Path: '/api/v1/plans/billing-usage/top-dimension-values';
+    Querystring: {
+        [M in UsageMetric]: {
+            env: string;
+            metric: M;
+            dimension: BreakdownDimensions[M];
+            from: string;
+            to: string;
+            limit?: string | undefined;
+        };
+    }[UsageMetric];
+    Success: {
+        data: {
+            values: {
+                id: string;
+                label: string;
+            }[];
+        };
+    };
+}>;
 export type GetBillingUsage = Endpoint<{
     Method: 'GET';
     Path: '/api/v1/plans/billing-usage';
@@ -68,6 +90,13 @@ export type GetBillingUsage = Endpoint<{
         env: string;
         from?: string | undefined;
         to?: string | undefined;
+        source?: 'clickhouse' | 'orb' | undefined;
+        metrics?: UsageMetric[] | undefined;
+        breakdown?: {
+            [M in UsageMetric]?: BreakdownDimensions[M] | undefined;
+        } | undefined;
+        top?: string | undefined;
+        filter?: Partial<Record<UsageMetric, string | undefined>> | undefined;
     };
     Success: {
         data: {

package/dist/providers/api.d.ts

@@ -1,5 +1,5 @@
 import type { Endpoint } from '../api.js';
-import type { Provider } from './provider.js';
+import type { Provider, SimplifiedJSONSchema } from './provider.js';
 import type { AuthModeType } from '../auth/api.js';
 export type GetPublicProviders = Endpoint<{
     Method: 'GET';
@@ -41,6 +41,7 @@ export interface ApiProviderListItem {
     preConfigured: boolean;
     preConfiguredScopes: string[];
     clientRegistration?: 'dynamic' | 'static' | 'metadata';
+    integration_config?: Record<string, SimplifiedJSONSchema> | undefined;
 }
 export type GetProviders = Endpoint<{
     Method: 'GET';

package/dist/providers/provider.d.ts

@@ -34,6 +34,12 @@ export interface SimplifiedJSONSchema {
     doc_section?: string;
     secret?: string;
     automated: boolean;
+    enum?: string[];
+    warnings?: Record<string, string>;
+    visible_when?: {
+        field: string;
+        equals: string;
+    };
 }
 export interface BaseProvider {
     display_name: string;
@@ -44,6 +50,7 @@ export interface BaseProvider {
         headers?: Record<string, string>;
         connection_config?: Record<string, string>;
         query?: Record<string, string>;
+        body?: Record<string, string>;
         retry?: RetryHeaderConfig;
         decompress?: boolean;
         forward_headers_on_redirect?: boolean;
@@ -85,6 +92,7 @@ export interface BaseProvider {
     connection_configuration?: string[];
     connection_config?: Record<string, SimplifiedJSONSchema>;
     credentials?: Record<string, SimplifiedJSONSchema>;
+    integration_config?: Record<string, SimplifiedJSONSchema>;
     assertion_option?: Record<string, SimplifiedJSONSchema>;
     authorization_url_fragment?: string;
     body_format?: OAuthBodyFormatType;
@@ -126,6 +134,7 @@ export interface ProviderMcpOAUTH2 extends Omit<BaseProvider, 'body_format'> {
     auth_mode: 'MCP_OAUTH2';
     registration_url?: string;
     client_registration: McpOAuth2ClientRegistration;
+    registration_params?: Record<string, string | string[]>;
 }
 export interface ProviderMcpOAuth2Generic extends Omit<BaseProvider, 'body_format'> {
     auth_mode: 'MCP_OAUTH2_GENERIC';
@@ -191,6 +200,7 @@ export interface ProviderTwoStep extends Omit<BaseProvider, 'body_format'> {
         token_expiration_strategy?: 'expireAt' | 'expireIn';
         refresh_token?: string;
     };
+    token_response_headers?: string[];
     additional_steps?: {
         body_format?: 'json' | 'form';
         token_params?: Record<string, string>;
@@ -224,6 +234,9 @@ export interface ProviderSignature extends BaseProvider {
         expires_in_ms: number;
     };
 }
+export interface ProviderAwsSigV4 extends BaseProvider {
+    auth_mode: 'AWS_SIGV4';
+}
 export interface ProviderApiKey extends BaseProvider {
     auth_mode: 'API_KEY';
 }
@@ -231,6 +244,6 @@ export interface ProviderInstallPlugin extends BaseProvider {
     auth_mode: 'INSTALL_PLUGIN';
     auth_type: 'BASIC';
 }
-export type Provider = BaseProvider | ProviderOAuth1 | ProviderOAuth2 | ProviderJwt | ProviderTwoStep | ProviderSignature | ProviderApiKey | ProviderBill | ProviderGithubApp | ProviderAppleAppStore | ProviderCustom | ProviderMcpOAUTH2 | ProviderMcpOAuth2Generic | ProviderInstallPlugin;
-export type RefreshableProvider = ProviderTwoStep | ProviderJwt | ProviderSignature | ProviderOAuth2 | ProviderMcpOAuth2Generic;
+export type Provider = BaseProvider | ProviderOAuth1 | ProviderOAuth2 | ProviderJwt | ProviderTwoStep | ProviderSignature | ProviderAwsSigV4 | ProviderApiKey | ProviderBill | ProviderGithubApp | ProviderAppleAppStore | ProviderCustom | ProviderMcpOAUTH2 | ProviderMcpOAuth2Generic | ProviderInstallPlugin;
+export type RefreshableProvider = ProviderTwoStep | ProviderJwt | ProviderSignature | ProviderOAuth2 | ProviderMcpOAuth2Generic | ProviderAwsSigV4;
 export type TestableProvider = ProviderApiKey;

package/dist/proxy/api.d.ts

@@ -27,6 +27,16 @@ export interface BaseProxyConfiguration {
     retryHeader?: RetryHeaderConfig;
     retryOn?: number[] | null;
     forwardHeadersOnRedirect?: boolean;
+    /**
+     * If set, called with the resolved outbound URL before the proxy request is sent.
+     * Implementations may throw (e.g. shared `ProxyError`) to abort the request.
+     */
+    validateProxyRequestUrl?: (args: {
+        absoluteUrl: string;
+        proxyConfig: ApplicationConstructedProxyConfiguration;
+        connection: ConnectionForProxy;
+        integrationConfig?: IntegrationConfigForProxy;
+    }) => void;
     /**
      * 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.
@@ -39,7 +49,7 @@ export interface UserProvidedProxyConfiguration extends BaseProxyConfiguration {
     paginate?: Partial<CursorPagination> | Partial<LinkPagination> | Partial<OffsetPagination>;
 }
 export type ConnectionForProxy = Pick<DBConnectionDecrypted, 'connection_id' | 'connection_config' | 'credentials' | 'metadata'>;
-export type IntegrationConfigForProxy = Pick<DBIntegrationDecrypted, 'oauth_client_id' | 'oauth_client_secret'>;
+export type IntegrationConfigForProxy = Pick<DBIntegrationDecrypted, 'oauth_client_id' | 'oauth_client_secret' | 'custom'>;
 export interface ApplicationConstructedProxyConfiguration extends BaseProxyConfiguration {
     decompress: boolean;
     method: HTTP_METHOD;

package/dist/runner/index.d.ts

@@ -21,6 +21,7 @@ export interface RunnerFlags {
     validateActionOutput: boolean;
     validateSyncRecords: boolean;
     validateSyncMetadata: boolean;
+    exportRunnerTelemetry: boolean;
 }
 export interface RoutingContext {
     plan: DBPlan | null;

package/package.json

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