@xentom/integration-framework 0.0.16 → 0.0.18

package/dist/nodes/trigger.d.ts

@@ -112,6 +112,23 @@ export interface TriggerSubscribeOptions<I extends TriggerNodeInputs, O extends
      * persist across restarts and be accessible from any instance.
      */
     kv: KeyValueStore;
+    /**
+     * Workflow-related utilities and metadata.
+     *
+     * Provides access to workflow lifecycle information and hooks
+     * that allow the integration to react to workflow behavior.
+     */
+    workflow: {
+        /**
+         * Subscribe to workflow lifecycle events (e.g. start).
+         *
+         * Use this to run initialization logic when a workflow starts
+         * or respond to other lifecycle state changes.
+         *
+         * Returns an unsubscribe function that removes the listener.
+         */
+        on<T extends keyof WorkflowEventMap>(type: T, callback: (...args: WorkflowEventMap[T]) => void): () => void;
+    };
     /**
      * Function used to programmatically run an output pin of the trigger.
      * Calling this starts a workflow run with optional execution context and output values.
@@ -137,6 +154,9 @@ export interface TriggerSubscribeOptions<I extends TriggerNodeInputs, O extends
      */
     next: NodeNextCallback<O, [options?: TriggerNextOptions]>;
 }
+export type WorkflowEventMap = {
+    start: [];
+};
 export interface TriggerNextOptions {
     /**
      * Optional context object to pass custom data to integration nodes.
@@ -145,12 +165,23 @@ export interface TriggerNextOptions {
      */
     ctx?: TriggerRunContext;
     /**
-     * Optional identifier to prevent duplicate executions of the same trigger.
-     * If a trigger with the same deduplicationId is already queued or recently
-     * executed, this run will be skipped. Useful for ensuring idempotency when
-     * the same event may be received multiple times.
+     * Optional configuration for deduplicating trigger executions.
+     * Helps prevent the same trigger from running multiple times when
+     * identical events are received.
      */
-    deduplicationId?: string;
+    deduplication?: {
+        /**
+         * Unique identifier used to detect duplicate executions.
+         * If a trigger with the same ID is already queued or was recently
+         * executed, this run will be skipped.
+         */
+        id: string;
+        /**
+         * Optional time-to-live (in seconds) for the deduplication record.
+         * After this period expires, a trigger with the same ID may run again.
+         */
+        ttl?: number;
+    };
 }
 export type TriggerRunContext = Record<string, any>;
 export type TriggerNodeBuilder = <I extends TriggerNodeInputs, O extends TriggerNodeOutputs>(definition: Omit<TriggerNode<I, O>, 'type'>) => TriggerNode<I, O>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xentom/integration-framework",
   "description": "A type-safe, declarative framework for building composable workflow integrations using nodes, pins, and rich controls.",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "license": "MIT",
   "homepage": "https://xentom.com",
   "author": {
@@ -61,4 +61,4 @@
     "bun-types": "^1.3.6",
     "typescript": "^5.9.3"
   }
-}
+}