@xentom/integration-framework 0.0.13 → 0.0.17

package/dist/auth/basic.d.ts

@@ -1,6 +1,6 @@
 import { type StandardSchemaV1 } from '@standard-schema/spec';
-import { type AuthType } from '.';
 import { type TextControl } from '../controls';
+import { type AuthType } from '.';
 export interface BasicAuth {
     type: AuthType.Basic;
     username?: {

package/dist/auth/oauth2.d.ts

@@ -1,5 +1,5 @@
-import { type AuthType } from '.';
 import { type IntegrationOptions } from '../integration';
+import { type AuthType } from '.';
 export declare enum OAuth2GrantType {
     AuthorizationCode = "authorization_code",
     ClientCredentials = "client_credentials"

package/dist/auth/token.d.ts

@@ -1,6 +1,6 @@
 import { type StandardSchemaV1 } from '@standard-schema/spec';
-import { type AuthType } from '.';
 import { type TextControl } from '../controls';
+import { type AuthType } from '.';
 export interface TokenAuth {
     type: AuthType.Token;
     /**

package/dist/controls/select.d.ts

@@ -1,6 +1,6 @@
-import { type ControlType } from '.';
 import { type Auth } from '../auth';
 import { type IntegrationOptions } from '../integration';
+import { type ControlType } from '.';
 import { type BaseControl } from './base';
 type ArrayElementType<T> = T extends readonly (infer U)[] ? U : T;
 export interface SelectControl<S = never, Multiple extends boolean = boolean> extends BaseControl<S> {

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 export * from './auth';
 export * from './controls';
-export * from './nodes';
-export * from './pins';
 export * from './env';
 export * from './generic';
 export * from './integration';
 export * from './kv';
+export * from './nodes';
+export * from './pins';
 export * from './utils';
 export * from './webhook';

package/dist/index.js

@@ -1,10 +1,10 @@
 export * from './auth';
 export * from './controls';
-export * from './nodes';
-export * from './pins';
 export * from './env';
 export * from './generic';
 export * from './integration';
 export * from './kv';
+export * from './nodes';
+export * from './pins';
 export * from './utils';
 export * from './webhook';

package/dist/nodes/callable.d.ts

@@ -1,9 +1,9 @@
-import { type NodeType } from '.';
 import { type IntegrationState } from '../integration';
 import { type KeyValueStore } from '../kv';
 import { type DataPin, type ExecPin, type ExtractPinsOfType, type InferPinRecordInput, type InferPinRecordOutput, type PinRecord, type PinRecordHasPinType } from '../pins';
 import { type HasRequiredKeys } from '../utils';
 import { type Webhook } from '../webhook';
+import { type NodeType } from '.';
 import { type BaseNode } from './base';
 import { type TriggerRunContext } from './trigger';
 export type CallableNodeInputs = PinRecord<DataPin>;

package/dist/nodes/pure.d.ts

@@ -1,8 +1,8 @@
-import { type NodeType } from '.';
 import { type IntegrationState } from '../integration';
 import { type KeyValueStore } from '../kv';
 import { type DataPin, type InferPinRecordInput, type InferPinRecordOutput, type PinRecord } from '../pins';
 import { type Webhook } from '../webhook';
+import { type NodeType } from '.';
 import { type BaseNode } from './base';
 import { type TriggerRunContext } from './trigger';
 export type PureNodeInputs = PinRecord<DataPin>;

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.
@@ -135,7 +152,25 @@ export interface TriggerSubscribeOptions<I extends TriggerNodeInputs, O extends
      *
      * @remarks `NodeNextCallback`
      */
-    next: NodeNextCallback<O, [ctx?: TriggerRunContext]>;
+    next: NodeNextCallback<O, [options?: TriggerNextOptions]>;
+}
+export type WorkflowEventMap = {
+    start: [];
+};
+export interface TriggerNextOptions {
+    /**
+     * Optional context object to pass custom data to integration nodes.
+     * This data will be available throughout the trigger execution and can be
+     * accessed by any integration node in the workflow.
+     */
+    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.
+     */
+    deduplicationId?: string;
 }
 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/dist/nodes/utils.d.ts

@@ -1,5 +1,5 @@
-import { type Node, type NodeRecord } from '.';
 import { type InferPinRecordInput, type InferPinRecordOutput, type PinRecord } from '../pins';
+import { type Node, type NodeRecord } from '.';
 export declare const DefaultExecPinName = "__exec";
 export declare const DefaultErrorPinName = "__error";
 export type InferNodeRecordOutput<R extends NodeRecord> = {

package/dist/pins/data.d.ts

@@ -1,9 +1,9 @@
 import { type StandardSchemaV1 } from '@standard-schema/spec';
-import { type PinType } from '.';
 import { type Auth } from '../auth';
 import { type Control } from '../controls';
 import { type IntegrationOptions } from '../integration';
 import { type ConditionalOptional } from '../utils';
+import { type PinType } from '.';
 import { type BasePin } from './base';
 export interface DataPin<Input = any, Output = Input, Optional extends boolean = boolean, MultiSelect extends boolean = boolean> extends BasePin {
     /**

package/dist/utils.d.ts

@@ -1,3 +1,4 @@
+/** biome-ignore-all lint/complexity/noBannedTypes: `Function` here is intentional for broad type acceptance in this API layer. */
 import { type StandardSchemaV1 } from '@standard-schema/spec';
 export type HasRequiredKeys<T> = keyof T extends never ? false : {
     [K in keyof T]-?: undefined extends T[K] ? false : true;

package/dist/utils.js

@@ -1 +1 @@
-/* eslint-disable @typescript-eslint/no-unsafe-function-type */
+/** biome-ignore-all lint/complexity/noBannedTypes: `Function` here is intentional for broad type acceptance in this API layer. */

package/dist/webhook.d.ts

@@ -1,3 +1,4 @@
+/** biome-ignore-all lint/suspicious/noConfusingVoidType: This is a valid use case for void return type */
 export interface Webhook {
     /**
      * The external URL that an external service can call to trigger the webhook handler.

package/dist/webhook.js

@@ -0,0 +1 @@
+/** biome-ignore-all lint/suspicious/noConfusingVoidType: This is a valid use case for void return type */

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.13",
+  "version": "0.0.17",
   "license": "MIT",
   "homepage": "https://xentom.com",
   "author": {
@@ -32,12 +32,12 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "lint": "eslint",
-    "format": "prettier --check . --ignore-path ../../.gitignore",
+    "lint": "biome lint",
+    "format": "biome format",
     "typecheck": "tsc --noEmit",
     "clean": "git clean -xdf .cache .turbo node_modules dist",
-    "build": "tsc",
-    "prepack": "bun run build"
+    "prepare": "bun run build",
+    "build": "tsc"
   },
   "sideEffects": false,
   "files": [
@@ -54,14 +54,11 @@
     "#src/*": "./src/*.ts"
   },
   "dependencies": {
-    "@standard-schema/spec": "^1.0.0"
+    "@standard-schema/spec": "^1.1.0"
   },
   "devDependencies": {
-    "@types/bun": "^1.3.1",
     "@xentom/style-guide": "^0.0.0",
-    "eslint": "^9.39.1",
-    "prettier": "^3.6.2",
+    "bun-types": "^1.3.6",
     "typescript": "^5.9.3"
-  },
-  "prettier": "@xentom/style-guide/prettier"
-}
+  }
+}