@nangohq/types 0.70.6 → 0.70.8

package/dist/account/api.d.ts

@@ -95,12 +95,11 @@ export type PostLogout = Endpoint<{
     Success: never;
 }>;
 export type PostForgotPassword = Endpoint<{
-    Method: 'PUT';
+    Method: 'POST';
     Path: '/api/v1/account/forgot-password';
     Body: {
         email: string;
     };
-    Error: ApiError<'user_not_found'>;
     Success: {
         success: true;
     };

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: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 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,24 +12,25 @@ 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 { GetFunctionDryrun, GetIntegrationFunction, GetIntegrationFunctions, GetIntegrationTemplates, GetProviderTemplates, PostFunctionCompile, PostFunctionDeployment, PostFunctionDryrun, PostFunctionDryrunResult, 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 { GetPlainHmac } from './plain/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';
+import type { GetConnectionRecordModels, GetConnectionRecords, GetPublicRecords, PatchPublicPruneRecords } from './record/api.js';
 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 | PostFunctionCompile | PostFunctionDryrun | GetFunctionDryrun | PostFunctionDryrunResult | PostFunctionDeployment | 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 | GetConnectionRecordModels | GetConnectionRecords | 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 | GetPlainHmac;
 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,7 +1,7 @@
 import type { ApiError, Endpoint } from '../api.js';
 import type { DeployedNangoFunction, FunctionType, NangoActionFunction, NangoFunctionTemplate, NangoSyncFunction } from './domain.js';
 export type RunnableFunctionType = Extract<FunctionType, 'action' | 'sync'>;
-export type FunctionErrorCode = 'invalid_request' | 'integration_not_found' | 'compilation_error' | 'dryrun_error' | 'deployment_error' | 'connection_not_found' | 'dryrun_not_found' | 'function_disabled' | 'execution_environment_unavailable' | 'timeout' | 'validation_error';
+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;
@@ -32,7 +32,9 @@ export interface FunctionDryrunBody {
     checkpoint?: Record<string, unknown> | undefined;
     last_sync_date?: string | undefined;
 }
-export type FunctionDryrunStatus = 'waiting' | 'running' | 'success' | 'failed';
+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'>;
@@ -75,17 +77,44 @@ export interface FunctionDeploymentBody {
     version?: string | undefined;
     allow_destructive?: boolean | undefined;
 }
-export interface FunctionDeploySuccess {
+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;
-    deployed: boolean;
-    deployed_functions: {
+    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;
-    }[];
-    output: 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';
@@ -126,78 +155,64 @@ export type PostFunctionDeployment = Endpoint<{
     Path: '/functions/deployments';
     Body: FunctionDeploymentBody;
     Error: ApiError<FunctionErrorCode>;
-    Success: FunctionDeploySuccess;
-}>;
-export interface RemoteFunctionCompileBody {
-    integration_id: string;
-    function_name: string;
-    function_type: RunnableFunctionType;
-    code: string;
-}
-export interface RemoteFunctionCompileSuccess extends FunctionCompileSuccess {
-    integration_id: string;
-    function_name: string;
-    function_type: RunnableFunctionType;
-}
-export interface RemoteFunctionDryrunBody extends RemoteFunctionCompileBody {
-    connection_id: string;
-    input?: unknown;
-    metadata?: Record<string, unknown> | undefined;
-    checkpoint?: Record<string, unknown> | undefined;
-    last_sync_date?: string | undefined;
-}
-export interface RemoteFunctionDryrunSuccess {
-    integration_id: string;
-    function_name: string;
-    function_type: RunnableFunctionType;
-    duration_ms: number;
-    result?: unknown;
-}
-export interface RemoteFunctionDeployBody extends RemoteFunctionCompileBody {
-    allow_destructive?: boolean | undefined;
-}
-export type PostRemoteFunctionCompile = Endpoint<{
-    Method: 'POST';
-    Path: '/remote-function/compile';
-    Body: RemoteFunctionCompileBody;
-    Error: ApiError<FunctionErrorCode>;
-    Success: RemoteFunctionCompileSuccess;
+    Success: FunctionDeploymentCreateSuccess;
 }>;
-export type PostRemoteFunctionDryrun = Endpoint<{
-    Method: 'POST';
-    Path: '/remote-function/dryrun';
-    Body: RemoteFunctionDryrunBody;
+export type GetFunctionDeployment = Endpoint<{
+    Method: 'GET';
+    Path: '/functions/deployments/:id';
+    Params: {
+        id: string;
+    };
     Error: ApiError<FunctionErrorCode>;
-    Success: RemoteFunctionDryrunSuccess;
+    Success: FunctionDeploymentResultSuccess;
 }>;
-export type PostRemoteFunctionDeploy = Endpoint<{
+export type PostFunctionDeploymentResult = Endpoint<{
     Method: 'POST';
-    Path: '/remote-function/deploy';
-    Body: RemoteFunctionDeployBody;
+    Path: '/functions/deployments/:id/result';
+    Params: {
+        id: string;
+    };
+    Body: FunctionDeploymentResultBody;
     Error: ApiError<FunctionErrorCode>;
-    Success: FunctionDeploySuccess;
+    Success: {
+        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';
@@ -210,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';
@@ -223,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/index.d.ts

@@ -13,6 +13,7 @@ export type * from './admin/http.api.js';
 export type * from './account/api.js';
 export type * from './user/api.js';
 export type * from './user/db.js';
+export type * from './plain/api.js';
 export type * from './connection/api/metadata.js';
 export type * from './connection/db.js';
 export type * from './connectUISettings/dto.js';

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/nangoYaml/index.d.ts

@@ -4,8 +4,13 @@ import type { JSONSchema7 } from 'json-schema';
 export type HTTP_METHOD = 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
 /** @deprecated **/
 export type SyncTypeLiteral = 'incremental' | 'full';
-export type ScriptFileType = 'actions' | 'syncs' | 'on-events' | 'post-connection-scripts';
+export type ScriptFileType = 'actions' | 'syncs' | 'on-events' | 'functions' | 'webhooks' | 'post-connection-scripts';
 export type ScriptTypeLiteral = 'action' | 'sync' | 'on-event';
+/**
+ * The `function` primitive is authored via `createFunction()` / `createWebhook()`. It is tracked
+ * separately from {@link ScriptTypeLiteral} (sync/action/on-event) while it is introduced additively.
+ */
+export type FunctionScriptTypeLiteral = 'function';
 export interface NangoYamlV1 {
     integrations: Record<string, Record<string, NangoYamlV1Integration>>;
     models: NangoYamlModel;
@@ -76,6 +81,7 @@ export interface NangoYamlParsedIntegration {
     providerConfigKey: string;
     syncs: ParsedNangoSync[];
     actions: ParsedNangoAction[];
+    functions: ParsedNangoFunction[];
     onEventScripts: Record<OnEventType, string[]>;
     /**
      * @deprecated
@@ -101,6 +107,47 @@ export interface ParsedNangoSync {
     json_schema?: JSONSchema7 | undefined;
     features?: Feature[] | undefined;
 }
+/** Serializable view of a function trigger (the executable hooks live in the deployed file body). */
+export interface ParsedFunctionTrigger {
+    type: 'http' | 'schedule' | 'event';
+    /** http trigger: maps to the URL path segment. */
+    name?: string;
+    /** http trigger: 'integration' (default) or 'connection' for tokenized per-connection URLs. */
+    scope?: 'integration' | 'connection';
+    /** schedule trigger. */
+    schedule?: string;
+    /** event trigger. */
+    event?: string;
+    /** Whether ingress coalescing is configured (the window/key config). */
+    debounce?: {
+        key?: {
+            body: string;
+        } | {
+            header: string;
+        };
+        windowMs: number;
+        maxWindowMs?: number;
+        maxEntities?: number;
+        payloadMode?: 'latest' | 'all';
+    };
+    /** Whether the trigger ships an `ingressChallenge` hook (executed at ingress). */
+    hasIngressChallenge?: boolean;
+    /** Whether the trigger ships an `ingressValidation` hook (executed at ingress). */
+    hasIngressValidation?: boolean;
+}
+export interface ParsedNangoFunction {
+    name: string;
+    type: 'function';
+    description: string;
+    triggers: ParsedFunctionTrigger[];
+    input: string | null;
+    output: string[] | null;
+    scopes: string[];
+    usedModels: string[];
+    version: string;
+    json_schema?: JSONSchema7 | undefined;
+    features?: Feature[] | undefined;
+}
 export interface ParsedNangoAction {
     name: string;
     type: 'action';
@@ -143,7 +190,7 @@ export interface FlowsYaml {
         models: NangoYamlModel;
     }>;
 }
-export type FlowZeroJson = NangoYamlParsedIntegration & {
+export type FlowZeroJson = Omit<NangoYamlParsedIntegration, 'functions'> & {
     jsonSchema?: JSONSchema7;
     sdkVersion: string;
 };

package/dist/persist/api.d.ts

@@ -23,8 +23,10 @@ type WithTags<T> = T & {
 };
 export type RunnerDataTransferTelemetry = WithTags<{
     type: 'data_transfer';
+    callsite: 'proxy' | 'uncontrolled_fetch' | 'persist_records' | 'persist_logs';
     bytesSent: number;
     bytesReceived: number;
+    count: number;
 }>;
 export type RunnerTelemetry = RunnerDataTransferTelemetry;
 export type PostRunnerTelemetry = Endpoint<{

package/dist/plain/api.d.ts

@@ -0,0 +1,11 @@
+import type { ApiError, Endpoint } from '../api.js';
+export type GetPlainHmac = Endpoint<{
+    Method: 'GET';
+    Path: `/api/v1/plain`;
+    Success: {
+        data: {
+            hash: string;
+        };
+    };
+    Error: ApiError<'unauthorized'>;
+}>;

package/dist/plans/db.d.ts

@@ -126,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"
@@ -161,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/pubsub/events.d.ts

@@ -95,6 +95,17 @@ export type UsageWebhookForwardEvent = UsageEventBase<'usage.webhook_forward', {
         success: boolean;
     };
 }>;
+export type DataTransferCallsite = 'credential_test_hook' | 'credential_verification_hook' | 'connection_hook' | 'webhook_forward' | 'proxy' | 'uncontrolled_fetch' | 'persist_logs' | 'persist_records';
+export type UsageDataTransferEvent = UsageEventBase<'usage.data_transfer', {
+    value: number;
+    properties: {
+        package: 'server' | 'runner' | 'shared';
+        callsite: DataTransferCallsite;
+        ingressedBytes: number;
+        egressedBytes: number;
+        syncId?: string;
+    };
+}>;
 type EnforceUsageEventBase<T extends UsageEventBase<any, any>> = T;
-export type UsageEvent = EnforceUsageEventBase<UsageMarEvent | UsageRecordsEvent | UsageActionsEvent | UsageConnectionsEvent | UsageFunctionExecutionsEvent | UsageProxyEvent | UsageWebhookForwardEvent>;
+export type UsageEvent = EnforceUsageEventBase<UsageMarEvent | UsageRecordsEvent | UsageActionsEvent | UsageConnectionsEvent | UsageFunctionExecutionsEvent | UsageProxyEvent | UsageWebhookForwardEvent | UsageDataTransferEvent>;
 export {};

package/dist/record/api.d.ts

@@ -63,3 +63,48 @@ export type PatchPublicPruneRecords = Endpoint<{
         has_more: boolean;
     };
 }>;
+export interface ConnectionRecordModel {
+    model: string;
+    variant: string | null;
+    count: number;
+    size_bytes: number;
+    updated_at: string;
+}
+export type GetConnectionRecordModels = Endpoint<{
+    Method: 'GET';
+    Path: '/api/v1/connections/:connectionId/records/models';
+    Params: {
+        connectionId: string;
+    };
+    Querystring: {
+        env: string;
+        provider_config_key: string;
+    };
+    Success: {
+        data: ConnectionRecordModel[];
+    };
+}>;
+export type GetConnectionRecords = Endpoint<{
+    Method: 'GET';
+    Path: '/api/v1/connections/:connectionId/records';
+    Params: {
+        connectionId: string;
+    };
+    Querystring: {
+        env: string;
+        provider_config_key: string;
+        model: string;
+        variant?: string | undefined;
+        limit?: number | undefined;
+        cursor?: string | undefined;
+        metadata_only?: boolean | undefined;
+        /** When set, return at most one full record for this external id (for lazy payload fetch). metadata_only is ignored */
+        record_id?: string | undefined;
+    };
+    Success: {
+        data: {
+            next_cursor: string | null;
+            records: NangoRecord[];
+        };
+    };
+}>;

package/dist/web/env.d.ts

@@ -8,6 +8,7 @@ export interface WindowEnv {
     publicPosthogHost: string;
     publicLogoDevKey: string;
     publicStripeKey: string;
+    publicPlainAppId: string;
     isCloud: boolean;
     isHosted: boolean;
     isEnterprise: boolean;

package/package.json

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