integrate-sdk 0.8.60-dev.0 → 0.8.62-dev.0

package/dist/src/triggers/executor.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Trigger Executor
+ * Handles local trigger execution (single and multi-step) without sending tokens externally.
+ * The scheduler sends a notification; the user's app retrieves the trigger,
+ * gets the token locally, and executes the tool directly.
+ */
+import type { Trigger, TriggerCallbacks, StepResult } from './types.js';
+import type { MCPContext } from '../config/types.js';
+/**
+ * Configuration for the trigger executor
+ */
+export interface ExecuteTriggerConfig {
+    /** Trigger callbacks for DB operations */
+    triggers: TriggerCallbacks;
+    /** Retrieve provider OAuth token locally */
+    getProviderToken: (provider: string, email?: string, context?: MCPContext) => Promise<{
+        accessToken: string;
+        tokenType?: string;
+    } | undefined>;
+    /** Execute a tool call via the OAuthHandler */
+    handleToolCall: (body: {
+        name: string;
+        arguments: Record<string, unknown>;
+    }, authHeader: string | null, integrationsHeader: string | null) => Promise<any>;
+}
+/**
+ * Result from executeTrigger
+ */
+export interface ExecuteTriggerResult {
+    success: boolean;
+    steps: StepResult[];
+    error?: string;
+}
+/**
+ * Execute a trigger locally, including multi-step execution.
+ *
+ * Flow:
+ * 1. Execute initial tool call
+ * 2. If onComplete callback exists, call it with result
+ * 3. If onComplete returns hasMore + nextStep, get token for next step's provider, execute, repeat
+ * 4. Respect MAX_TRIGGER_STEPS limit
+ * 5. On final step: update trigger DB state, fire webhooks
+ *
+ * @param trigger - The trigger to execute
+ * @param config - Executor configuration (DB callbacks, token retrieval, tool execution)
+ * @param context - Optional MCP context for multi-tenant support
+ * @returns Execution result with all step results
+ */
+export declare function executeTrigger(trigger: Trigger, config: ExecuteTriggerConfig, context?: MCPContext): Promise<ExecuteTriggerResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/src/triggers/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/triggers/executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EACV,OAAO,EACP,gBAAgB,EAChB,UAAU,EAGX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,4CAA4C;IAC5C,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;IAC/I,+CAA+C;IAC/C,cAAc,EAAE,CACd,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAC1D,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,KAC9B,OAAO,CAAC,GAAG,CAAC,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,UAAU,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAkL/B"}

package/dist/src/triggers/index.d.ts

@@ -2,9 +2,13 @@
  * Triggers Module
  * Exports for scheduled tool execution functionality
  */
-export type { Trigger, TriggerSchedule, TriggerStatus, CreateTriggerParams, CreateTriggerInput, UpdateTriggerParams, ListTriggersParams, ListTriggersResponse, ListTriggersCallbackResponse, TriggerExecutionResult, TriggerCallbacks, } from './types.js';
-export { generateTriggerId, extractProviderFromToolName, validateStatusTransition, calculateHasMore, } from './utils.js';
+export type { Trigger, TriggerSchedule, TriggerStatus, CreateTriggerParams, CreateTriggerInput, UpdateTriggerParams, ListTriggersParams, ListTriggersResponse, ListTriggersCallbackResponse, TriggerExecutionResult, TriggerCallbacks, StepResult, CompleteRequest, CompleteResponse, WebhookConfig, WebhookPayload, CompleteCallbackContext, } from './types.js';
+export { MAX_TRIGGER_STEPS, WEBHOOK_DELIVERY_TIMEOUT_MS } from './types.js';
+export { generateTriggerId, extractProviderFromToolName, validateStatusTransition, validateStepLimit, calculateHasMore, } from './utils.js';
 export type { StatusTransitionResult } from './utils.js';
+export { deliverWebhooks } from './webhooks.js';
+export { executeTrigger } from './executor.js';
+export type { ExecuteTriggerConfig, ExecuteTriggerResult } from './executor.js';
 export { TriggerClient } from './client.js';
 export type { TriggerClientConfig } from './client.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/triggers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/triggers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,OAAO,EACP,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/triggers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,OAAO,EACP,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,EACtB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAG5E,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGhF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/triggers/types.d.ts

@@ -153,6 +153,105 @@ export interface TriggerExecutionResult {
     /** Execution duration in milliseconds */
     duration?: number;
 }
+/** Maximum number of steps allowed in a multi-step trigger execution */
+export declare const MAX_TRIGGER_STEPS = 20;
+/** Default timeout for webhook delivery in milliseconds */
+export declare const WEBHOOK_DELIVERY_TIMEOUT_MS = 10000;
+/**
+ * Result from a single step in a multi-step trigger execution
+ */
+export interface StepResult {
+    /** Zero-based index of this step */
+    stepIndex: number;
+    /** Tool that was executed */
+    toolName: string;
+    /** Whether this step succeeded */
+    success: boolean;
+    /** Step result data if successful */
+    result?: Record<string, unknown>;
+    /** Error message if step failed */
+    error?: string;
+    /** Execution duration in milliseconds */
+    duration: number;
+    /** ISO datetime when this step was executed */
+    executedAt: string;
+}
+/**
+ * Enhanced request body for the complete endpoint
+ * Backward-compatible: existing fields preserved, new fields optional
+ */
+export interface CompleteRequest {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Tool execution result if successful */
+    result?: Record<string, unknown>;
+    /** Error message if execution failed */
+    error?: string;
+    /** ISO datetime when execution completed */
+    executedAt: string;
+    /** Execution duration in milliseconds */
+    duration?: number;
+    /** Current step index (zero-based) for multi-step triggers */
+    stepIndex?: number;
+    /** Results from all previous steps (includes current step) */
+    previousResults?: StepResult[];
+    /** Whether this is the final step */
+    final?: boolean;
+}
+/**
+ * Response from the complete endpoint for multi-step triggers
+ */
+export interface CompleteResponse {
+    /** Whether there are more steps to execute */
+    hasMore?: boolean;
+    /** Next step to execute if hasMore is true */
+    nextStep?: {
+        toolName: string;
+        toolArguments: Record<string, unknown>;
+        provider: string;
+    };
+    /** Webhooks to deliver results to after all steps complete */
+    webhooks?: WebhookConfig[];
+}
+/**
+ * Webhook endpoint configuration
+ */
+export interface WebhookConfig {
+    /** URL to deliver the webhook payload to */
+    url: string;
+    /** Secret for HMAC-SHA256 signature (optional) */
+    secret?: string;
+    /** Additional headers to include in the request */
+    headers?: Record<string, string>;
+}
+/**
+ * Payload delivered to webhook endpoints
+ */
+export interface WebhookPayload {
+    /** Trigger ID that was executed */
+    triggerId: string;
+    /** Whether the overall execution succeeded */
+    success: boolean;
+    /** Results from all steps */
+    steps: StepResult[];
+    /** Total number of steps executed */
+    totalSteps: number;
+    /** Total execution duration in milliseconds */
+    totalDuration: number;
+    /** ISO datetime when execution completed */
+    executedAt: string;
+}
+/**
+ * Context passed to the onComplete callback
+ */
+export interface CompleteCallbackContext {
+    /** The trigger being completed */
+    trigger: Trigger;
+    /** The complete request body */
+    request: CompleteRequest;
+    /** Optional MCP context for multi-tenant support */
+    context?: MCPContext;
+}
 /**
  * Callbacks for trigger storage (required for createMCPServer)
  * Implement these to store triggers in your database
@@ -193,5 +292,22 @@ export interface TriggerCallbacks {
      * @param context - Optional user context for multi-tenant support
      */
     delete: (triggerId: string, context?: MCPContext) => Promise<void>;
+    /**
+     * Optional callback for multi-step trigger completion
+     * Called after each step completes during local trigger execution.
+     * Return a CompleteResponse to control whether more steps should execute
+     * and which webhooks to fire.
+     * @param context - Trigger, request body, and optional MCP context
+     * @returns CompleteResponse indicating next step or final state
+     */
+    onComplete?: (context: CompleteCallbackContext) => Promise<CompleteResponse>;
+    /**
+     * Optional callback to resolve the callback URL for scheduler registration.
+     * When provided, this is used instead of the default INTEGRATE_URL-based URL.
+     * Useful when the app URL varies per tenant or environment.
+     * @param context - Optional MCP context for multi-tenant support
+     * @returns The base URL for trigger notification callbacks
+     */
+    getCallbackUrl?: (context?: MCPContext) => Promise<string> | string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/src/triggers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/triggers/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/triggers/types.ts"],"names":[],"mappings":"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"}

package/dist/src/triggers/utils.d.ts

@@ -59,6 +59,26 @@ export type StatusTransitionResult = {
  * ```
  */
 export declare function validateStatusTransition(currentStatus: TriggerStatus, targetStatus: TriggerStatus): StatusTransitionResult;
+/**
+ * Validate that a step index is within the allowed limit
+ *
+ * @param stepIndex - Current step index (zero-based)
+ * @param maxSteps - Maximum number of steps allowed
+ * @returns Validation result with error message if invalid
+ *
+ * @example
+ * ```typescript
+ * validateStepLimit(0, 20);  // { valid: true }
+ * validateStepLimit(19, 20); // { valid: true }
+ * validateStepLimit(20, 20); // { valid: false, error: "..." }
+ * ```
+ */
+export declare function validateStepLimit(stepIndex: number, maxSteps: number): {
+    valid: true;
+} | {
+    valid: false;
+    error: string;
+};
 /**
  * Calculate whether more results are available for pagination
  *

package/dist/src/triggers/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/triggers/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACf;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,aAAa,GAC1B,sBAAsB,CAkBxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAET"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/triggers/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACf;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,aAAa,GAC1B,sBAAsB,CAkBxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAQnD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAET"}

package/dist/src/triggers/webhooks.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Webhook Delivery
+ * HMAC-SHA256 signed webhook delivery for multi-step trigger results
+ */
+import type { WebhookConfig, WebhookPayload } from './types.js';
+/**
+ * Sign a payload with HMAC-SHA256 using the Web Crypto API
+ * @param payload - The webhook payload to sign
+ * @param secret - The secret key for HMAC signing
+ * @returns Hex-encoded HMAC-SHA256 signature
+ */
+export declare function signPayload(payload: WebhookPayload, secret: string): Promise<string>;
+/**
+ * Deliver a webhook payload to a single endpoint
+ * @param webhook - Webhook configuration (url, secret, headers)
+ * @param payload - The webhook payload to deliver
+ * @param timeoutMs - Request timeout in milliseconds
+ */
+export declare function deliverWebhook(webhook: WebhookConfig, payload: WebhookPayload, timeoutMs: number): Promise<void>;
+/**
+ * Deliver a webhook payload to multiple endpoints in parallel (fire-and-forget)
+ * Errors are logged but never thrown — delivery failures do not affect trigger completion.
+ * @param webhooks - Array of webhook configurations
+ * @param payload - The webhook payload to deliver
+ * @param timeoutMs - Request timeout in milliseconds per webhook
+ */
+export declare function deliverWebhooks(webhooks: WebhookConfig[], payload: WebhookPayload, timeoutMs: number): Promise<void>;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/src/triggers/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../../src/triggers/webhooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIhE;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc1F;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "integrate-sdk",
-  "version": "0.8.60-dev.0",
+  "version": "0.8.62-dev.0",
   "description": "Type-safe 3rd party integration SDK for the Integrate MCP server",
   "type": "module",
   "main": "./dist/index.js",