@xentom/integration-framework 0.0.16 → 0.0.17

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.

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.17",
   "license": "MIT",
   "homepage": "https://xentom.com",
   "author": {
@@ -61,4 +61,4 @@
     "bun-types": "^1.3.6",
     "typescript": "^5.9.3"
   }
-}
+}