@nangohq/types 0.71.14 → 0.72.1

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

@@ -1,6 +1,6 @@
 /** Every wildcard in a namespace: `environment:*`, `environment:connections:*`, … */
 export type WildcardsFor<Namespace extends string> = `${Namespace}:*` | `${Namespace}:${string}:*`;
-export declare const API_KEY_SCOPES: readonly ["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:connections:list", "environment:connections:list_credentials", "environment:connections:read", "environment:connections:read_credentials", "environment:connections:create", "environment:connections:update", "environment:connections:delete", "environment:connect_sessions:write", "environment:agent_sessions:write", "environment:syncs:read", "environment:syncs:execute", "environment:syncs:update", "environment:syncs:variant:create", "environment:syncs:variant:delete", "environment:functions:list", "environment:functions:read", "environment:functions:update", "environment:functions:delete", "environment:functions:compile", "environment:functions:dryrun", "environment:functions:invocations", "environment:deploy", "environment:records:read", "environment:records:write", "environment:logs:read", "environment:actions:execute", "environment:proxy", "environment:variables:read", "environment:webhook_signing_key:rotate", "environment:mcp"];
+export declare const API_KEY_SCOPES: readonly ["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:connections:list", "environment:connections:list_credentials", "environment:connections:read", "environment:connections:read_credentials", "environment:connections:create", "environment:connections:update", "environment:connections:delete", "environment:connect_sessions:write", "environment:agent_sessions:write", "environment:syncs:read", "environment:syncs:execute", "environment:syncs:update", "environment:syncs:variant:create", "environment:syncs:variant:delete", "environment:functions:list", "environment:functions:read", "environment:functions:update", "environment:functions:delete", "environment:functions:compile", "environment:functions:dryrun", "environment:functions:invocations", "environment:deploy", "environment:records:read", "environment:records:write", "environment:logs:read", "environment:tools:call", "environment:proxy", "environment:variables:read", "environment:webhook_signing_key:rotate", "environment:mcp"];
 export type ConcreteApiKeyScope = (typeof API_KEY_SCOPES)[number];
 /** A scope, or a wildcard over scopes. Which wildcards resolve to something is checked at runtime. */
 export type ApiKeyScope = ConcreteApiKeyScope | WildcardsFor<'environment'>;

package/dist/api.endpoints.d.ts

@@ -18,7 +18,7 @@ import type { CreateApiKey, DeleteApiKey, DeleteEnvironment, DeletePublicApiKey,
 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 { DeleteFunctionVariant, DeleteIntegrationFunction, DeletePublicIntegrationFunction, GetFunction, GetFunctionDeployment, GetFunctionDryrun, GetFunctionInvocation, GetFunctions, GetIntegrationFunction, GetIntegrationFunctions, GetIntegrationTemplates, GetProviderTemplates, GetPublicIntegrationFunction, GetPublicIntegrationFunctions, GetPublicProviderTemplates, PatchConnectionFunction, PatchFunction, PatchFunctionVariant, PostFunctionCompile, PostFunctionDeployment, PostFunctionDeploymentBundle, PostFunctionDeploymentBundlePreview, PostFunctionDeploymentResult, PostFunctionDryrun, PostFunctionDryrunResult, PostFunctionInvocation, PostFunctionVariant, PostToolCall } from './functions/api.js';
+import type { DeleteFunctionVariant, DeleteIntegrationFunction, DeletePublicIntegrationFunction, GetFunction, GetFunctionDeployment, GetFunctionDryrun, GetFunctionInvocation, GetFunctions, GetIntegrationFunction, GetIntegrationFunctions, GetIntegrationTemplates, GetProviderTemplateCode, GetProviderTemplates, GetPublicIntegrationFunction, GetPublicIntegrationFunctions, GetPublicProviderTemplateCode, GetPublicProviderTemplates, PatchConnectionFunction, PatchFunction, PatchFunctionVariant, PostFunctionCompile, PostFunctionDeployment, PostFunctionDeploymentBundle, PostFunctionDeploymentBundlePreview, PostFunctionDeploymentResult, PostFunctionDryrun, PostFunctionDryrunResult, PostFunctionInvocation, PostFunctionVariant, PostToolCall } from './functions/api.js';
 import type { GetGettingStarted, PatchGettingStarted } from './gettingStarted/api.js';
 import type { DeleteIntegration, DeletePublicIntegration, GetFunctionCode, GetIntegration, GetIntegrationFlows, GetPublicFunctionCode, GetPublicIntegration, GetPublicListIntegrations, PatchIntegration, PatchPublicIntegration, PostIntegration, PostPublicIntegration, PostPublicQuickstartIntegration } from './integration/api.js';
 import type { DeleteInvite, GetInvite, PostInvite } from './invitations/api.js';
@@ -37,8 +37,8 @@ import type { GetConnectionSyncs, GetPublicSyncStatus, PostPublicSyncPause, Post
 import type { DeleteTeamUser, GetTeam, PatchTeamUser, PutTeam } from './team/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 | GetPublicProviders | GetPublicProvider | GetPublicListIntegrations | GetPublicIntegration | DeletePublicIntegration | PostConnectSessions | PostAgentSessions | DeleteAgentSession | PostAgentSessionMcp | GetAgentSessionMcp | PostConnectionToolsMcp | GetConnectionToolsMcp | PostPublicConnectSessionsReconnect | GetPublicConnections | GetPublicConnection | GetConnectSession | DeleteConnectSession | PostDeployInternal | PostPublicBillAuthorization | DeletePublicConnection | DeleteConnection | PostPublicSignatureAuthorization | PostPublicTwoStepAuthorization | PostPublicWebhook | GetPublicClientMetadata | GetPublicRecords | PatchPublicPruneRecords | GetPublicScriptsConfig | PostPublicConnectTelemetry | PostCliTelemetry | PutPublicSyncConnectionFrequency | PostPublicIntegration | PostPublicQuickstartIntegration | PatchPublicIntegration | GetAsyncActionResult | PostPublicOauthOutboundAuthorization | PostPublicAwsSigV4Authorization | PostPublicConnection | PatchPublicConnection | PostPublicSyncStart | PostPublicSyncPause | GetPublicSyncStatus | GetPublicV1 | PostPublicTriggerAction | PostFunctionCompile | GetFunction | GetFunctions | PatchFunction | PostFunctionDryrun | GetFunctionDryrun | PostFunctionDryrunResult | PostFunctionDeployment | GetFunctionDeployment | PostFunctionDeploymentResult | PostFunctionInvocation | PostFunctionVariant | PatchFunctionVariant | PatchConnectionFunction | DeleteFunctionVariant | GetFunctionInvocation | PostFunctionDeploymentBundle | PostFunctionDeploymentBundlePreview | GetPublicFunctionCode | GetPublicIntegrationFunctions | GetPublicIntegrationFunction | PostToolCall | DeletePublicIntegrationFunction | GetPublicProviderTemplates | PostPublicRotateWebhookSigningKey | AllPublicProxy | PostPublicEnvironment | DeletePublicEnvironment | GetPublicEnvironment | GetPublicEnvironments | GetPublicApiKey | GetPublicApiKeys | PostPublicApiKey | PatchPublicApiKey | DeletePublicApiKey;
-export type PrivateApiEndpoints = GetAuditTrail | GetAuditTrailExport | ListAccountApiKeys | CreateAccountApiKey | DeleteAccountApiKey | ConfirmEmail | PostSignup | PostSignin | PostLogout | GetTeam | PutTeam | PostPlanExtendTrial | PostPlanChange | PutBillingInvoicingDetails | GetOverdueInvoices | GetBillingUsage | GetBillingUsageTopDimensionValues | GetUpcomingInvoice | GetBillingPeriodCosts | GetProjectedCosts | GetSpendAlert | PutSpendAlert | DeleteSpendAlert | GetUser | PatchUser | PutUserPassword | PostInvite | DeleteInvite | DeleteTeamUser | PatchTeamUser | PostInsights | PostForgotPassword | PutResetPassword | SearchOperations | GetOperation | SearchMessages | SearchFilters | PostInternalConnectSessions | GetIntegrationFlows | GetIntegrationFunction | GetIntegrationFunctions | GetFunctionCode | DeleteIntegrationFunction | GetIntegrationTemplates | GetProviderTemplates | DeleteIntegration | PatchIntegration | GetIntegration | PostIntegration | GetConnections | GetConnectionsCount | GetConnection | PatchConnection | PostConnectionMetadata | GetConnectionRecordModels | GetConnectionRecords | GetConnectionSyncs | GetInvite | GetMeta | GetEmailByExpiredToken | GetEmailByUuid | GetManagedCallback | GetManagedEmailVerification | GetOnboardingAccountDiscovery | PostOnboardingRequestInvite | PatchFlowDisable | PatchFlowEnable | PatchFlowFrequency | PutUpgradePreBuiltFlow | PostConnectionRefresh | PostManagedEmailVerification | PostManagedSignup | PostPreBuiltDeploy | PostEnvironment | PatchEnvironment | DeleteEnvironment | GetEnvironments | GetEnvironment | PostRotateWebhookSigningKey | ListApiKeys | CreateApiKey | DeleteApiKey | PatchApiKey | PatchWebhook | PostEnvironmentVariables | PostImpersonate | GetSharedCredentialsProviders | GetSharedCredentialsProvider | PostSharedCredentialsProvider | PatchSharedCredentialsProvider | GetGettingStarted | PatchGettingStarted | GetConnectUISettings | PutConnectUISettings | GetProviders | GetProvider | PostInternalInvokeFunction | GetMFAStatus | PostMFAEnrollment | PostMFAActivation | PostMFARecoveryCodes | PostMFALoginVerification | DeleteMFA | GetPlainHmac | PostAgentPlaygroundChat;
+export type PublicApiEndpoints = SetMetadata | UpdateMetadata | PostDeploy | PostDeployConfirmation | PostPublicTrigger | PostPublicTbaAuthorization | PostPublicJwtAuthorization | PostPublicUnauthenticatedAuthorization | PostPublicApiKeyAuthorization | PostPublicBasicAuthorization | GetPublicProviders | GetPublicProvider | GetPublicListIntegrations | GetPublicIntegration | DeletePublicIntegration | PostConnectSessions | PostAgentSessions | DeleteAgentSession | PostAgentSessionMcp | GetAgentSessionMcp | PostConnectionToolsMcp | GetConnectionToolsMcp | PostPublicConnectSessionsReconnect | GetPublicConnections | GetPublicConnection | GetConnectSession | DeleteConnectSession | PostDeployInternal | PostPublicBillAuthorization | DeletePublicConnection | DeleteConnection | PostPublicSignatureAuthorization | PostPublicTwoStepAuthorization | PostPublicWebhook | GetPublicClientMetadata | GetPublicRecords | PatchPublicPruneRecords | GetPublicScriptsConfig | PostPublicConnectTelemetry | PostCliTelemetry | PutPublicSyncConnectionFrequency | PostPublicIntegration | PostPublicQuickstartIntegration | PatchPublicIntegration | GetAsyncActionResult | PostPublicOauthOutboundAuthorization | PostPublicAwsSigV4Authorization | PostPublicConnection | PatchPublicConnection | PostPublicSyncStart | PostPublicSyncPause | GetPublicSyncStatus | GetPublicV1 | PostPublicTriggerAction | PostFunctionCompile | GetFunction | GetFunctions | PatchFunction | PostFunctionDryrun | GetFunctionDryrun | PostFunctionDryrunResult | PostFunctionDeployment | GetFunctionDeployment | PostFunctionDeploymentResult | PostFunctionInvocation | PostFunctionVariant | PatchFunctionVariant | PatchConnectionFunction | DeleteFunctionVariant | GetFunctionInvocation | PostFunctionDeploymentBundle | PostFunctionDeploymentBundlePreview | GetPublicFunctionCode | GetPublicIntegrationFunctions | GetPublicIntegrationFunction | PostToolCall | DeletePublicIntegrationFunction | GetPublicProviderTemplates | GetPublicProviderTemplateCode | PostPublicRotateWebhookSigningKey | AllPublicProxy | PostPublicEnvironment | DeletePublicEnvironment | GetPublicEnvironment | GetPublicEnvironments | GetPublicApiKey | GetPublicApiKeys | PostPublicApiKey | PatchPublicApiKey | DeletePublicApiKey;
+export type PrivateApiEndpoints = GetAuditTrail | GetAuditTrailExport | ListAccountApiKeys | CreateAccountApiKey | DeleteAccountApiKey | ConfirmEmail | PostSignup | PostSignin | PostLogout | GetTeam | PutTeam | PostPlanExtendTrial | PostPlanChange | PutBillingInvoicingDetails | GetOverdueInvoices | GetBillingUsage | GetBillingUsageTopDimensionValues | GetUpcomingInvoice | GetBillingPeriodCosts | GetProjectedCosts | GetSpendAlert | PutSpendAlert | DeleteSpendAlert | GetUser | PatchUser | PutUserPassword | PostInvite | DeleteInvite | DeleteTeamUser | PatchTeamUser | PostInsights | PostForgotPassword | PutResetPassword | SearchOperations | GetOperation | SearchMessages | SearchFilters | PostInternalConnectSessions | GetIntegrationFlows | GetIntegrationFunction | GetIntegrationFunctions | GetFunctionCode | DeleteIntegrationFunction | GetIntegrationTemplates | GetProviderTemplates | GetProviderTemplateCode | DeleteIntegration | PatchIntegration | GetIntegration | PostIntegration | GetConnections | GetConnectionsCount | GetConnection | PatchConnection | PostConnectionMetadata | GetConnectionRecordModels | GetConnectionRecords | GetConnectionSyncs | GetInvite | GetMeta | GetEmailByExpiredToken | GetEmailByUuid | GetManagedCallback | GetManagedEmailVerification | GetOnboardingAccountDiscovery | PostOnboardingRequestInvite | PatchFlowDisable | PatchFlowEnable | PatchFlowFrequency | PutUpgradePreBuiltFlow | PostConnectionRefresh | PostManagedEmailVerification | PostManagedSignup | PostPreBuiltDeploy | PostEnvironment | PatchEnvironment | DeleteEnvironment | GetEnvironments | GetEnvironment | PostRotateWebhookSigningKey | ListApiKeys | CreateApiKey | DeleteApiKey | PatchApiKey | PatchWebhook | PostEnvironmentVariables | PostImpersonate | GetSharedCredentialsProviders | GetSharedCredentialsProvider | PostSharedCredentialsProvider | PatchSharedCredentialsProvider | GetGettingStarted | PatchGettingStarted | GetConnectUISettings | PutConnectUISettings | GetProviders | GetProvider | PostInternalInvokeFunction | GetMFAStatus | PostMFAEnrollment | PostMFAActivation | PostMFARecoveryCodes | PostMFALoginVerification | DeleteMFA | GetPlainHmac | PostAgentPlaygroundChat;
 export type APIEndpoints = PrivateApiEndpoints | PublicApiEndpoints;
 /**
  * Automatically narrow endpoints type with Method + Path

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

@@ -103,6 +103,7 @@ export type PostPublicEnvironment = ApiEndpoint<{
             on_sync_error?: boolean | undefined;
             on_async_action_completion?: boolean | undefined;
             on_connection_deletion?: boolean | undefined;
+            signing_key?: string | undefined;
         } | undefined;
     };
     Success: {

package/dist/function/config.d.ts

@@ -1,5 +1,6 @@
 import type { OnEventType } from '../scripts/on-events/api.js';
-export type FunctionTags = Record<string, string | string[]>;
+export type FunctionTagValue = string | string[];
+export type FunctionTags = Record<string, FunctionTagValue>;
 export interface FunctionCapabilities {
     usesRecords: boolean;
     usesOutbound: boolean;

package/dist/function/db.d.ts

@@ -1,6 +1,7 @@
 import type { TimestampsAndDeletedAt } from '../db.js';
 import type { FunctionSource } from '../syncConfigs/db.js';
 import type { FunctionCapabilities, FunctionLimits, FunctionRequires, FunctionTags, FunctionTriggerDefinition } from './config.js';
+import type { ToolTags } from './tool.js';
 import type { JSONSchema7 } from 'json-schema';
 export interface DBFunctionConfig extends TimestampsAndDeletedAt {
     id: number;
@@ -15,7 +16,7 @@ export interface DBFunctionConfigVersion extends TimestampsAndDeletedAt {
     id: number;
     function_config_id: number;
     description: string;
-    tags: FunctionTags;
+    tags: FunctionTags | ToolTags;
     file_location: string;
     version: string;
     source: FunctionSource;

package/dist/function/tool.d.ts

@@ -1,5 +1,20 @@
-import type { FunctionTags } from './config.js';
-export type ToolTags = {
-    required_scopes?: string[];
+import type { FunctionTagValue } from './config.js';
+/** Explicit provider scope requirements; omit the declaration when requirements are unknown. */
+export type RequiredScopes = {
+    all: [string, ...string[]];
+    any?: never;
+    none?: never;
+} | {
+    any: [string, ...string[]];
+    all?: never;
+    none?: never;
+} | {
+    none: true;
+    all?: never;
+    any?: never;
+};
+export interface ToolTags {
     instructions?: string;
-} & FunctionTags;
+    required_scopes?: RequiredScopes;
+    [key: string]: FunctionTagValue | RequiredScopes;
+}

package/dist/functions/api.d.ts

@@ -1,6 +1,7 @@
 import type { ApiEndpoint, ApiError } from '../api.js';
 import type { AuditPolicy } from '../audit-trail/event.js';
 import type { FunctionCapabilities, FunctionLimits, FunctionRequires, FunctionTags, FunctionTriggerDefinition } from '../function/config.js';
+import type { ToolTags } from '../function/tool.js';
 import type { FunctionSource } from '../syncConfigs/db.js';
 import type { FunctionListType, FunctionType, ListedNangoFunction, NangoActionFunction, NangoFunctionTemplate, NangoSyncFunction } from './domain.js';
 import type { JSONSchema7 } from 'json-schema';
@@ -229,7 +230,7 @@ export interface GetFunctionResponse {
     provider: string;
     name: string;
     description: string;
-    tags: FunctionTags;
+    tags: FunctionTags | ToolTags;
     state: 'enabled' | 'disabled';
     source: FunctionSource;
     trigger: FunctionTriggerDefinition;
@@ -301,7 +302,7 @@ export type PostFunctionInvocation = ApiEndpoint<{
         invocation_type: FunctionInvocationType;
         options?: Record<string, unknown> | undefined;
     };
-    Error: ApiError<FunctionInvocationErrorCode>;
+    Error: ApiError<FunctionInvocationErrorCode | 'function_runtime_error'>;
     Success: FunctionInvocationSuccess;
 }>;
 export type FunctionVariantErrorCode = 'invalid_variant' | 'function_not_found' | 'connection_not_found' | 'function_disabled' | 'function_variant_not_found' | 'invalid_frequency' | 'resource_capped' | 'server_error';
@@ -385,7 +386,7 @@ export type GetFunctionInvocation = ApiEndpoint<{
         functionUuid: string;
         id: string;
     };
-    Error: ApiError<'invalid_uri_params' | 'not_found' | 'function_not_found' | 'connection_not_found' | 'function_failed' | 'server_error'>;
+    Error: ApiError<'invalid_uri_params' | 'not_found' | 'function_not_found' | 'connection_not_found' | 'function_failed' | 'function_runtime_error' | 'server_error'>;
     Success: FunctionInvocationSuccess;
 }>;
 export interface FunctionListFilters {
@@ -537,7 +538,7 @@ export type PostToolCall = ApiEndpoint<{
     Body: {
         input?: unknown | undefined;
     };
-    Error: ApiError<FunctionInvocationErrorCode | 'ambiguous_connection'>;
+    Error: ApiError<FunctionInvocationErrorCode | 'function_runtime_error' | 'ambiguous_connection'>;
     Success: FunctionInvocationSuccess;
 }>;
 export type GetPublicProviderTemplates = ApiEndpoint<{
@@ -552,6 +553,53 @@ export type GetPublicProviderTemplates = ApiEndpoint<{
     };
     Success: ProviderTemplatesSuccess;
 }>;
+type ProviderTemplateCodeError = ApiError<'unknown_function'> | ApiError<'source_unavailable'> | ApiError<'ambiguous_function', undefined, {
+    matches: {
+        type: FunctionType;
+        name: string;
+    }[];
+}>;
+export type GetPublicProviderTemplateCode = ApiEndpoint<{
+    Audit: {
+        kind: 'no-audit';
+        reason: 'non-auditable';
+    };
+    Method: 'GET';
+    Path: '/providers/:provider/templates/:name/code';
+    Params: {
+        provider: string;
+        name: string;
+    };
+    Querystring: {
+        type?: FunctionType | undefined;
+    };
+    Success: {
+        type: FunctionType;
+        code: string;
+    };
+    Error: ProviderTemplateCodeError;
+}>;
+export type GetProviderTemplateCode = ApiEndpoint<{
+    Audit: {
+        kind: 'no-audit';
+        reason: 'non-auditable';
+    };
+    Method: 'GET';
+    Path: '/api/v1/providers/:providerConfigKey/templates/:name/code';
+    Params: {
+        providerConfigKey: string;
+        name: string;
+    };
+    Querystring: {
+        env: string;
+        type?: FunctionType | undefined;
+    };
+    Success: {
+        type: FunctionType;
+        code: string;
+    };
+    Error: ProviderTemplateCodeError;
+}>;
 export type GetIntegrationTemplates = ApiEndpoint<{
     Audit: {
         kind: 'no-audit';
@@ -573,7 +621,7 @@ export interface FunctionDeploymentArtifact {
     name: string;
     integrationId: string;
     description: string;
-    tags?: FunctionTags | undefined;
+    tags?: FunctionTags | ToolTags | undefined;
     trigger: FunctionTriggerDefinition;
     requires: FunctionRequires;
     capabilities: FunctionCapabilities;

package/dist/index.d.ts

@@ -118,3 +118,4 @@ export type * from './functions/domain.js';
 export type * from './lambda/index.js';
 export type * from './pubsub/events.js';
 export type { SignupAdvertising } from './account/signupAdvertising.js';
+export type * from './self-hosting/db.js';

package/dist/integration/api.d.ts

@@ -2,7 +2,7 @@ import type { ApiEndpoint, ApiError, ApiTimestamps } from '../api.js';
 import type { AuditPolicy } from '../audit-trail/event.js';
 import type { AuthModes, AuthModeType } from '../auth/api.js';
 import type { NangoSyncConfig } from '../flow/index.js';
-import type { ScriptTypeLiteral } from '../nangoYaml/index.js';
+import type { FunctionListType } from '../functions/domain.js';
 import type { Provider } from '../providers/provider.js';
 import type { IntegrationConfig } from './db.js';
 import type { Merge } from 'type-fest';
@@ -70,11 +70,18 @@ export type PostPublicIntegration = ApiEndpoint<{
         provider: string;
         unique_key: string;
         display_name?: string | undefined;
-        credentials?: ApiPublicIntegrationCredentials | undefined;
         forward_webhooks?: boolean | undefined;
+    } & ({
+        credentials?: ApiPublicIntegrationCredentials | undefined;
         integration_config?: Record<string, string> | undefined;
         custom?: Record<string, string> | undefined;
-    };
+    } | {
+        credentials: {
+            type: 'NANGO_MANAGED';
+        };
+        integration_config?: never;
+        custom?: never;
+    });
     Success: {
         data: ApiPublicIntegration;
     };
@@ -152,18 +159,13 @@ export type GetPublicFunctionCode = ApiEndpoint<{
         name: string;
     };
     Querystring: {
-        type?: ScriptTypeLiteral | undefined;
+        type?: FunctionListType | undefined;
     };
     Success: {
-        type: ScriptTypeLiteral;
+        type: FunctionListType;
         code: string;
     };
-    Error: ApiError<'not_found'> | ApiError<'ambiguous_function', undefined, {
-        matches: {
-            type: ScriptTypeLiteral;
-            name: string;
-        }[];
-    }>;
+    Error: ApiError<'not_found'>;
 }>;
 export type GetFunctionCode = ApiEndpoint<{
     Audit: {
@@ -178,18 +180,13 @@ export type GetFunctionCode = ApiEndpoint<{
     };
     Querystring: {
         env: string;
-        type?: ScriptTypeLiteral | undefined;
+        type?: FunctionListType | undefined;
     };
     Success: {
-        type: ScriptTypeLiteral;
+        type: FunctionListType;
         code: string;
     };
-    Error: ApiError<'not_found'> | ApiError<'ambiguous_function', undefined, {
-        matches: {
-            type: ScriptTypeLiteral;
-            name: string;
-        }[];
-    }>;
+    Error: ApiError<'not_found'>;
 }>;
 export type ApiIntegration = Omit<Merge<IntegrationConfig, ApiTimestamps>, 'oauth_client_secret_iv' | 'oauth_client_secret_tag'>;
 export type ApiIntegrationList = ApiIntegration & {

package/dist/proxy/api.d.ts

@@ -1,3 +1,4 @@
+import type { ApiKeyPrincipal } from '../api-keys/auth.js';
 import type { AllAuthCredentials } from '../auth/api.js';
 import type { DBConnectionDecrypted } from '../connection/db.js';
 import type { DBIntegrationDecrypted } from '../integration/db.js';
@@ -53,7 +54,7 @@ export type ConnectionForProxy = Pick<DBConnectionDecrypted, 'connection_id' | '
     credentials: AllAuthCredentials;
 };
 export type IntegrationConfigForProxy = Pick<DBIntegrationDecrypted, 'oauth_client_id' | 'oauth_client_secret' | 'custom'>;
-export interface ApplicationConstructedProxyConfiguration extends BaseProxyConfiguration {
+export interface ApplicationConstructedProxyConfiguration extends BaseProxyConfiguration, InternalProxyConfiguration {
     decompress: boolean;
     method: HTTP_METHOD;
     providerName: string;
@@ -62,6 +63,13 @@ export interface ApplicationConstructedProxyConfiguration extends BaseProxyConfi
 export type ResponseType = 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream';
 export interface InternalProxyConfiguration {
     providerName: string;
+    /** Only set for customer API/MCP proxy requests or calls from deployed code. */
+    monitoringContext?: {
+        accountId: number;
+        environmentId: number;
+        apiKey?: ApiKeyPrincipal | undefined;
+        callsite: 'proxy' | 'sdk';
+    };
 }
 export interface RetryHeaderConfig {
     at?: string[] | string;

package/dist/self-hosting/db.d.ts

@@ -0,0 +1,44 @@
+import type { Timestamps } from '../db.js';
+export type SelfHostingInstallationMode = 'byoc' | 'self_managed';
+export type SelfHostingInstallationStage = 'production' | 'staging' | 'development';
+export type SelfHostingInstallationAlerts = 'off' | 'slack' | 'oncall';
+export interface DBSelfHostingCustomer extends Timestamps {
+    id: number;
+    name: string;
+    deleted_at: Date | null;
+}
+export interface DBSelfHostingInstallation extends Timestamps {
+    id: number;
+    /** The only identity that leaves the registry: in the license, the tokens and the export files. */
+    uuid: string;
+    customer_id: number;
+    name: string;
+    mode: SelfHostingInstallationMode;
+    stage: SelfHostingInstallationStage;
+    telemetry: boolean;
+    alerts: SelfHostingInstallationAlerts;
+    deleted_at: Date | null;
+    last_seen_at: Date | null;
+}
+export interface DBSelfHostingInstallationKey {
+    id: number;
+    installation_id: number;
+    kid: string;
+    public_key: string;
+    created_at: Date;
+    /** Set on rotation; the key still verifies files it signed until it is pruned. */
+    deleted_at: Date | null;
+}
+export interface DBSelfHostingInstallationLicense {
+    id: number;
+    installation_id: number;
+    issued_at: Date;
+    expires_at: Date;
+    grace_until: Date;
+    /** The exact signed text, so the signature can be re-verified from the row. */
+    license: string;
+    signature: string;
+    signing_kid: string;
+    active: boolean;
+    created_at: Date;
+}

package/package.json

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