@xentom/integration-framework 0.0.12 → 0.0.16

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> {
@@ -33,29 +33,33 @@ export interface SelectControlOptionsCallbackOptions extends IntegrationOptions<
         inputs: Record<string, unknown>;
         outputs: Record<string, unknown>;
     };
-    pagination: {
-        /**
-         * The limit of options to return.
-         */
-        limit: number;
-        /**
-         * The cursor to use to get the next page of options.
-         */
-        after?: string | number;
-        /**
-         * The cursor to use to get the previous page of options.
-         */
-        before?: string | number;
-        /**
-         * The page number to use to get the next page of options.
-         */
-        page: number;
-    };
+    /**
+     * The pagination options for the options callback.
+     */
+    pagination: SelectControlOptionsPagination;
     /**
      * The search query used to filter the options.
      */
     search?: string;
 }
+export interface SelectControlOptionsPagination {
+    /**
+     * The limit of options to return.
+     */
+    limit: number;
+    /**
+     * The cursor to use to get the next page of options.
+     */
+    after?: string | number;
+    /**
+     * The cursor to use to get the previous page of options.
+     */
+    before?: string | number;
+    /**
+     * The page number to use to get the next page of options.
+     */
+    page: number;
+}
 export interface SelectControlOptionsWithMetadata<S = never> {
     items: SelectControlOption<S>[];
     hasMore?: boolean;

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

@@ -135,7 +135,22 @@ export interface TriggerSubscribeOptions<I extends TriggerNodeInputs, O extends
      *
      * @remarks `NodeNextCallback`
      */
-    next: NodeNextCallback<O, [ctx?: TriggerRunContext]>;
+    next: NodeNextCallback<O, [options?: TriggerNextOptions]>;
+}
+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.12",
+  "version": "0.0.16",
   "license": "MIT",
   "homepage": "https://xentom.com",
   "author": {
@@ -32,10 +32,11 @@
   "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",
+    "prepare": "bun run build",
     "build": "tsc"
   },
   "sideEffects": false,
@@ -53,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"
+  }
 }