@xentom/integration-framework 0.0.8 → 0.0.10

package/dist/controls/select.d.ts

@@ -27,17 +27,39 @@ export interface SelectControl<S = never, Multiple extends boolean = boolean> ex
     placeholder?: string;
 }
 export type SelectControlOptions<S = never> = SelectControlOption<S>[];
-export type SelectControlOptionsCallback<S = never> = (opts: SelectControlOptionsCallbackOptions) => Promise<SelectControlOption<S>[]> | SelectControlOption<S>[];
+export type SelectControlOptionsCallback<S = never> = (opts: SelectControlOptionsCallbackOptions) => Promise<SelectControlOptionsWithMetadata<S>> | SelectControlOptionsWithMetadata<S>;
 export interface SelectControlOptionsCallbackOptions extends IntegrationOptions<Auth> {
     node: {
         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 search query used to filter the options.
      */
     search?: string;
 }
+export interface SelectControlOptionsWithMetadata<S = never> {
+    items: SelectControlOption<S>[];
+    hasMore: boolean;
+}
 export interface SelectControlOption<S = never> {
     /**
      * The value associated with the option, which will be used as the pin's value.

package/dist/index.d.ts

@@ -5,5 +5,6 @@ export * from './pins';
 export * from './env';
 export * from './generic';
 export * from './integration';
+export * from './kv';
 export * from './utils';
 export * from './webhook';

package/dist/index.js

@@ -5,5 +5,6 @@ export * from './pins';
 export * from './env';
 export * from './generic';
 export * from './integration';
+export * from './kv';
 export * from './utils';
 export * from './webhook';

package/dist/integration.d.ts

@@ -1,5 +1,6 @@
 import { type Auth, type AuthResponse } from './auth';
 import { type EnvRecord, type InferEnvRecordOutput } from './env';
+import { type KeyValueStore } from './kv';
 import { type NodeRecord } from './nodes';
 import { type PartialKeyValues, type Serialize } from './utils';
 import { type Webhook } from './webhook';
@@ -114,6 +115,7 @@ export interface IntegrationOptions<A extends Auth = never, E extends Record<str
     env: E;
     state: IntegrationState;
     webhook: Webhook;
+    kv: KeyValueStore;
 }
 /**
  * In-memory state for the integration, shared across all nodes.

package/dist/kv.d.ts

@@ -0,0 +1,19 @@
+export interface KeyValueStore {
+    /**
+     * Retrieves a value from the store.
+     * @param key - The key to look up.
+     * @returns The stored value, or null if the key doesn't exist.
+     */
+    get: (key: string) => Promise<string | null>;
+    /**
+     * Stores a value under the given key, overwriting any existing value.
+     * @param key - The key to store under.
+     * @param value - The value to store.
+     */
+    set: (key: string, value: string) => Promise<void>;
+    /**
+     * Removes one or more keys from the store.
+     * @param keys - The keys to delete. Non-existent keys are ignored.
+     */
+    delete: (...keys: string[]) => Promise<void>;
+}

package/dist/nodes/callable.d.ts

@@ -1,5 +1,6 @@
 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';
@@ -69,6 +70,13 @@ export interface CallableNodeRunOptions<I extends CallableNodeInputs, O extends
      * @remarks `{ url: string }`
      */
     webhook: Pick<Webhook, 'url'>;
+    /**
+     * Persistent key-value store for this integration.
+     *
+     * Use this to store configuration, state, or cached data that should
+     * persist across restarts and be accessible from any instance.
+     */
+    kv: KeyValueStore;
     /**
      * Function used to programmatically run an output pin of the node.
      * Calling this starts a workflow run with optional execution context and output values.

package/dist/nodes/pure.d.ts

@@ -1,5 +1,6 @@
 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 BaseNode } from './base';
@@ -78,5 +79,12 @@ export interface PureNodeRunOptions<I extends PureNodeInputs = PureNodeInputs, O
      * @remarks `{ url: string }`
      */
     webhook: Pick<Webhook, 'url'>;
+    /**
+     * Persistent key-value store for this integration.
+     *
+     * Use this to store configuration, state, or cached data that should
+     * persist across restarts and be accessible from any instance.
+     */
+    kv: KeyValueStore;
 }
 export type PureNodeBuilder = <I extends PureNodeInputs, O extends PureNodeOutputs>(definition: Omit<PureNode<I, O>, 'type'>) => PureNode<I, O>;

package/dist/nodes/trigger.d.ts

@@ -1,4 +1,5 @@
 import { type IntegrationState } from '../integration';
+import { type KeyValueStore } from '../kv';
 import { type DataPin, type ExecPin, type InferPinRecordOutput, type PinRecord } from '../pins';
 import { type Webhook } from '../webhook';
 import { type BaseNode } from './base';
@@ -104,6 +105,13 @@ export interface TriggerSubscribeOptions<I extends TriggerNodeInputs, O extends
      * during execution or generation.
      */
     variables: Record<string, unknown>;
+    /**
+     * Persistent key-value store for this integration.
+     *
+     * Use this to store configuration, state, or cached data that should
+     * persist across restarts and be accessible from any instance.
+     */
+    kv: KeyValueStore;
     /**
      * Function used to programmatically run an output pin of the trigger.
      * Calling this starts a workflow run with optional execution context and output values.

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.8",
+  "version": "0.0.10",
   "license": "MIT",
   "homepage": "https://xentom.com",
   "author": {
@@ -46,6 +46,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "xentom": ">=0.0.6"
+  },
   "imports": {
     "#src/*": "./src/*.ts"
   },