@loxtep/sdk 0.2.1 → 0.3.0

package/dist/authoring/define-data-workflow.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `defineDataWorkflow` factory — the core code-first authoring entry point.
+ *
+ * Validates the module specification synchronously using zod and throws a
+ * `ValidationError` naming the invalid argument on failure.
+ */
+import type { DataWorkflowModule } from './types.js';
+/**
+ * Validates a `DataWorkflowModule` specification and returns it unchanged.
+ *
+ * Throws `ValidationError` (from `@loxtep/sdk/errors`) with a `field_errors`
+ * entry naming the invalid argument when validation fails.
+ *
+ * Validation rules:
+ * - `name`: 1–64 characters (R3.1, R3.8)
+ * - `triggers`: at least 1 and at most 10 entries (R3.1, R3.8)
+ * - `requireApproval`: at most 100 entries, each 1–256 characters (R6.1)
+ *
+ * @param spec - The workflow module specification to validate.
+ * @returns The validated specification (unchanged).
+ * @throws {ValidationError} If any argument is invalid.
+ */
+export declare function defineDataWorkflow(spec: DataWorkflowModule): DataWorkflowModule;
+//# sourceMappingURL=define-data-workflow.d.ts.map

package/dist/authoring/define-data-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-data-workflow.d.ts","sourceRoot":"","sources":["../../src/authoring/define-data-workflow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAWrD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAiE/E"}

package/dist/authoring/define-data-workflow.js

@@ -0,0 +1,93 @@
+/**
+ * `defineDataWorkflow` factory — the core code-first authoring entry point.
+ *
+ * Validates the module specification synchronously using zod and throws a
+ * `ValidationError` naming the invalid argument on failure.
+ */
+import { z } from 'zod';
+import { ValidationError } from '../errors/index.js';
+/**
+ * Zod schema for the `requireApproval` array.
+ * Each entry is a non-empty string of 1–256 characters, with at most 100 entries.
+ */
+const requireApprovalSchema = z
+    .array(z.string().min(1).max(256))
+    .max(100)
+    .optional();
+/**
+ * Validates a `DataWorkflowModule` specification and returns it unchanged.
+ *
+ * Throws `ValidationError` (from `@loxtep/sdk/errors`) with a `field_errors`
+ * entry naming the invalid argument when validation fails.
+ *
+ * Validation rules:
+ * - `name`: 1–64 characters (R3.1, R3.8)
+ * - `triggers`: at least 1 and at most 10 entries (R3.1, R3.8)
+ * - `requireApproval`: at most 100 entries, each 1–256 characters (R6.1)
+ *
+ * @param spec - The workflow module specification to validate.
+ * @returns The validated specification (unchanged).
+ * @throws {ValidationError} If any argument is invalid.
+ */
+export function defineDataWorkflow(spec) {
+    const errors = [];
+    // Validate name (1–64 characters)
+    if (typeof spec.name !== 'string' || spec.name.length < 1 || spec.name.length > 64) {
+        errors.push({
+            field: 'name',
+            message: `name must be between 1 and 64 characters, got ${typeof spec.name === 'string' ? spec.name.length : typeof spec.name}`,
+        });
+    }
+    // Validate triggers (1–10)
+    if (!Array.isArray(spec.triggers) || spec.triggers.length < 1 || spec.triggers.length > 10) {
+        const count = Array.isArray(spec.triggers) ? spec.triggers.length : 0;
+        errors.push({
+            field: 'triggers',
+            message: `triggers must contain between 1 and 10 entries, got ${count}`,
+        });
+    }
+    // Validate requireApproval (≤100 entries, each 1–256 chars)
+    if (spec.requireApproval !== undefined) {
+        const result = requireApprovalSchema.safeParse(spec.requireApproval);
+        if (!result.success) {
+            const zodIssues = result.error.issues;
+            // Provide a targeted message based on the zod failure
+            const issue = zodIssues[0];
+            if (issue) {
+                if (issue.code === 'too_big' && issue.path.length === 0) {
+                    errors.push({
+                        field: 'requireApproval',
+                        message: `requireApproval must contain at most 100 entries, got ${spec.requireApproval.length}`,
+                    });
+                }
+                else if (issue.code === 'too_small' && issue.path.length > 0) {
+                    const idx = String(issue.path[0]);
+                    errors.push({
+                        field: 'requireApproval',
+                        message: `requireApproval[${idx}] must be between 1 and 256 characters`,
+                    });
+                }
+                else if (issue.code === 'too_big' && issue.path.length > 0) {
+                    const idx = issue.path[0];
+                    const idxStr = String(idx);
+                    errors.push({
+                        field: 'requireApproval',
+                        message: `requireApproval[${idxStr}] must be between 1 and 256 characters, got ${spec.requireApproval[idx]?.length}`,
+                    });
+                }
+                else {
+                    errors.push({
+                        field: 'requireApproval',
+                        message: `requireApproval is invalid: ${issue.message}`,
+                    });
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        const message = errors.map((e) => `${e.field}: ${e.message}`).join('; ');
+        throw new ValidationError(`Invalid defineDataWorkflow specification: ${message}`, errors);
+    }
+    return spec;
+}
+//# sourceMappingURL=define-data-workflow.js.map

package/dist/authoring/define-data-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-data-workflow.js","sourceRoot":"","sources":["../../src/authoring/define-data-workflow.ts"],"names":[],"mappings":"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"}

package/dist/authoring/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Code-first data workflow authoring surface.
+ *
+ * Entry points:
+ * - `defineDataWorkflow` — validates and returns a `DataWorkflowModule` spec
+ * - `on` — trigger builders (`queueEvent`, `connectorEvent`, `schedule`, `webhook`)
+ * - `createToolbox` — deterministic typed platform calls (no model in the loop)
+ * - `agent` — agentic operation entry point with scope enforcement and action trace
+ */
+export { defineDataWorkflow } from './define-data-workflow.js';
+export { on } from './triggers.js';
+export { createToolbox, ToolboxOperationError } from './toolbox.js';
+export { agent, validateAgentOptions, computeReachableScope, enforceAgentScope, createScopeGuardedToolbox, ActionTrace, AgentScopeError, } from './agent.js';
+export type { DataWorkflowModule, TriggerSpec, QueueRef, ConnectorRef, HandlerContext, } from './types.js';
+export { compileModule, computeRemovalSet } from './compiler.js';
+export type { GraphPatchOp, ResourceRef, CompiledWorkflow, } from './compiler.js';
+export type { Toolbox, ToolboxDataProducts, ToolboxQueues, ToolboxConnections, ToolboxWorkflows, CreateToolboxOptions, DataProductRef, WorkflowRef, WriteResult, QueryRows, } from './toolbox.js';
+export type { SkillRef, AgentOptions, ActionOutcome, ActionTraceEntry, AgentResult, AgentExecutionContext, } from './agent.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/authoring/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/authoring/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EACL,KAAK,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,yBAAyB,EACzB,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EACV,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,OAAO,EACP,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,WAAW,EACX,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/authoring/index.js

@@ -0,0 +1,15 @@
+/**
+ * Code-first data workflow authoring surface.
+ *
+ * Entry points:
+ * - `defineDataWorkflow` — validates and returns a `DataWorkflowModule` spec
+ * - `on` — trigger builders (`queueEvent`, `connectorEvent`, `schedule`, `webhook`)
+ * - `createToolbox` — deterministic typed platform calls (no model in the loop)
+ * - `agent` — agentic operation entry point with scope enforcement and action trace
+ */
+export { defineDataWorkflow } from './define-data-workflow.js';
+export { on } from './triggers.js';
+export { createToolbox, ToolboxOperationError } from './toolbox.js';
+export { agent, validateAgentOptions, computeReachableScope, enforceAgentScope, createScopeGuardedToolbox, ActionTrace, AgentScopeError, } from './agent.js';
+export { compileModule, computeRemovalSet } from './compiler.js';
+//# sourceMappingURL=index.js.map

package/dist/authoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/authoring/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EACL,KAAK,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,yBAAyB,EACzB,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/authoring/toolbox.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Deterministic `toolbox` namespace — direct, typed platform calls with no model
+ * in the loop (R4.1, R4.7).
+ *
+ * Each method is a thin wrapper over the corresponding `LoxtepClient` namespace
+ * method. On success, it returns a typed result. On failure, it throws a
+ * `ToolboxOperationError` identifying the failed operation — it never falls back
+ * to a model.
+ */
+import type { LoxtepClient } from '../client/loxtep-client.js';
+import type { DataProduct, DataProductQueryResult } from '../client/data-products-types.js';
+import type { Connection, ConnectionTestResult } from '../client/connection-types.js';
+import type { Flow } from '../client/flow-types.js';
+import type { WorkflowGraph } from '../client/workflows-types.js';
+import type { QueueRef } from './types.js';
+import { LoxtepError } from '../errors/base.js';
+/** Result of a data product write operation. */
+export interface WriteResult {
+    /** Whether the write succeeded. */
+    success: true;
+    /** Number of events written. */
+    events_written: number;
+}
+/** Rows returned from a data product query. */
+export interface QueryRows {
+    items: Record<string, unknown>[];
+    metadata: DataProductQueryResult['metadata'];
+}
+/**
+ * Error thrown when a deterministic toolbox operation fails.
+ * Identifies the failed operation and namespace so the caller can
+ * distinguish it from other errors.
+ *
+ * Per R4.7 — the SDK never falls back to a model on failure.
+ */
+export declare class ToolboxOperationError extends LoxtepError {
+    /** The toolbox namespace where the failure occurred (e.g. 'dataProducts'). */
+    readonly namespace: string;
+    /** The operation that failed (e.g. 'write', 'query', 'list'). */
+    readonly operation: string;
+    constructor(namespace: string, operation: string, message: string, cause?: unknown);
+}
+/** Typed reference to a data product from the Generated_SDK_Artifact. */
+export interface DataProductRef {
+    id: string;
+    name: string;
+}
+/** Typed reference to a workflow from the Generated_SDK_Artifact. */
+export interface WorkflowRef {
+    id: string;
+    name: string;
+}
+export type { QueueRef, ConnectorRef } from './types.js';
+/**
+ * Data products toolbox — deterministic operations on data products.
+ */
+export interface ToolboxDataProducts {
+    /** Write an event to a data product's stream queue. */
+    write(ref: DataProductRef, event: unknown): Promise<WriteResult>;
+    /** Execute a SQL query against a data product. */
+    query(ref: DataProductRef, sql: string): Promise<QueryRows>;
+    /** Get a data product by reference. */
+    get(ref: DataProductRef): Promise<DataProduct>;
+    /** List data products (optionally filtered by domain). */
+    list(filters?: {
+        domain_id?: string;
+    }): Promise<DataProduct[]>;
+}
+/**
+ * Queues toolbox — deterministic operations on queues.
+ */
+export interface ToolboxQueues {
+    /** Write an event to a queue. */
+    write(ref: QueueRef, event: unknown): Promise<void>;
+    /** Get queue metadata. */
+    getMetadata(ref: QueueRef): Promise<{
+        queue_name: string;
+        [key: string]: unknown;
+    }>;
+}
+/**
+ * Connections toolbox — deterministic operations on connections.
+ */
+export interface ToolboxConnections {
+    /** List connections for the project. */
+    list(): Promise<Connection[]>;
+    /** Get a specific connection. */
+    get(connectionId: string): Promise<Connection>;
+    /** Test a connection. */
+    test(connectionId: string): Promise<ConnectionTestResult>;
+}
+/**
+ * Workflows toolbox — deterministic operations on workflows.
+ */
+export interface ToolboxWorkflows {
+    /** List workflows for the project. */
+    list(): Promise<Flow[]>;
+    /** Get a workflow's graph. */
+    getGraph(ref: WorkflowRef): Promise<WorkflowGraph>;
+}
+/**
+ * The deterministic Toolbox namespace — thin typed wrappers over
+ * `LoxtepClient` namespaces. Each method returns typed results or throws a
+ * `ToolboxOperationError`. No model is ever invoked.
+ */
+export interface Toolbox {
+    dataProducts: ToolboxDataProducts;
+    queues: ToolboxQueues;
+    connections: ToolboxConnections;
+    workflows: ToolboxWorkflows;
+}
+/**
+ * Options for creating a toolbox.
+ */
+export interface CreateToolboxOptions {
+    /** The LoxtepClient instance to use for platform calls. */
+    client: LoxtepClient;
+    /** The project ID (used for project-scoped operations). */
+    projectId: string;
+}
+/**
+ * Create a `Toolbox` — deterministic, typed platform operations with no model
+ * in the loop.
+ *
+ * On success each method returns a typed result. On failure, a
+ * `ToolboxOperationError` is thrown identifying the failed operation.
+ * The toolbox never falls back to an AI model.
+ *
+ * @param options - Client and project configuration.
+ * @returns A `Toolbox` instance.
+ */
+export declare function createToolbox(options: CreateToolboxOptions): Toolbox;
+//# sourceMappingURL=toolbox.d.ts.map

package/dist/authoring/toolbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbox.d.ts","sourceRoot":"","sources":["../../src/authoring/toolbox.ts"],"names":[],"mappings":"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"}

package/dist/authoring/toolbox.js

@@ -0,0 +1,166 @@
+/**
+ * Deterministic `toolbox` namespace — direct, typed platform calls with no model
+ * in the loop (R4.1, R4.7).
+ *
+ * Each method is a thin wrapper over the corresponding `LoxtepClient` namespace
+ * method. On success, it returns a typed result. On failure, it throws a
+ * `ToolboxOperationError` identifying the failed operation — it never falls back
+ * to a model.
+ */
+import { LoxtepError } from '../errors/base.js';
+// ─── Error type ──────────────────────────────────────────────────────────────
+/**
+ * Error thrown when a deterministic toolbox operation fails.
+ * Identifies the failed operation and namespace so the caller can
+ * distinguish it from other errors.
+ *
+ * Per R4.7 — the SDK never falls back to a model on failure.
+ */
+export class ToolboxOperationError extends LoxtepError {
+    /** The toolbox namespace where the failure occurred (e.g. 'dataProducts'). */
+    namespace;
+    /** The operation that failed (e.g. 'write', 'query', 'list'). */
+    operation;
+    constructor(namespace, operation, message, cause) {
+        super(`toolbox.${namespace}.${operation} failed: ${message}`, {
+            code: 'TOOLBOX_OPERATION_FAILED',
+            status_code: cause?.status_code,
+            details: {
+                namespace,
+                operation,
+                ...(cause instanceof Error ? { cause_message: cause.message } : {}),
+            },
+        });
+        this.name = 'ToolboxOperationError';
+        this.namespace = namespace;
+        this.operation = operation;
+        Object.setPrototypeOf(this, ToolboxOperationError.prototype);
+    }
+}
+/**
+ * Create a `Toolbox` — deterministic, typed platform operations with no model
+ * in the loop.
+ *
+ * On success each method returns a typed result. On failure, a
+ * `ToolboxOperationError` is thrown identifying the failed operation.
+ * The toolbox never falls back to an AI model.
+ *
+ * @param options - Client and project configuration.
+ * @returns A `Toolbox` instance.
+ */
+export function createToolbox(options) {
+    const { client, projectId } = options;
+    const dataProducts = {
+        async write(ref, event) {
+            try {
+                const writer = await client.data_products.get_writer(ref.name);
+                writer.write(event);
+                await writer.close();
+                return { success: true, events_written: 1 };
+            }
+            catch (err) {
+                throw new ToolboxOperationError('dataProducts', 'write', err instanceof Error ? err.message : String(err), err);
+            }
+        },
+        async query(ref, sql) {
+            try {
+                const result = await client.data_products.query(ref.id, sql);
+                return { items: result.items, metadata: result.metadata };
+            }
+            catch (err) {
+                throw new ToolboxOperationError('dataProducts', 'query', err instanceof Error ? err.message : String(err), err);
+            }
+        },
+        async get(ref) {
+            try {
+                return await client.data_products.get(ref.id);
+            }
+            catch (err) {
+                throw new ToolboxOperationError('dataProducts', 'get', err instanceof Error ? err.message : String(err), err);
+            }
+        },
+        async list(filters) {
+            try {
+                const result = await client.data_products.list({
+                    domain_id: filters?.domain_id,
+                });
+                return result.items;
+            }
+            catch (err) {
+                throw new ToolboxOperationError('dataProducts', 'list', err instanceof Error ? err.message : String(err), err);
+            }
+        },
+    };
+    const queues = {
+        async write(ref, event) {
+            try {
+                const writer = await client.queues.open_writer({
+                    bot_id: `toolbox-writer-${ref.name}`,
+                    queue_name: ref.name,
+                });
+                await writer.write(event);
+                await writer.close();
+            }
+            catch (err) {
+                throw new ToolboxOperationError('queues', 'write', err instanceof Error ? err.message : String(err), err);
+            }
+        },
+        async getMetadata(ref) {
+            try {
+                const metadata = await client.queues.get_queue_metadata(ref.name);
+                return metadata;
+            }
+            catch (err) {
+                throw new ToolboxOperationError('queues', 'getMetadata', err instanceof Error ? err.message : String(err), err);
+            }
+        },
+    };
+    const connections = {
+        async list() {
+            try {
+                const result = await client.connections.list();
+                return result.items;
+            }
+            catch (err) {
+                throw new ToolboxOperationError('connections', 'list', err instanceof Error ? err.message : String(err), err);
+            }
+        },
+        async get(connectionId) {
+            try {
+                return await client.connections.get(connectionId);
+            }
+            catch (err) {
+                throw new ToolboxOperationError('connections', 'get', err instanceof Error ? err.message : String(err), err);
+            }
+        },
+        async test(connectionId) {
+            try {
+                return await client.connections.test(connectionId);
+            }
+            catch (err) {
+                throw new ToolboxOperationError('connections', 'test', err instanceof Error ? err.message : String(err), err);
+            }
+        },
+    };
+    const workflows = {
+        async list() {
+            try {
+                const result = await client.workflows.listWorkflows({ project_id: projectId });
+                return result.items;
+            }
+            catch (err) {
+                throw new ToolboxOperationError('workflows', 'list', err instanceof Error ? err.message : String(err), err);
+            }
+        },
+        async getGraph(ref) {
+            try {
+                return await client.workflows.getWorkflowGraph(ref.id, projectId);
+            }
+            catch (err) {
+                throw new ToolboxOperationError('workflows', 'getGraph', err instanceof Error ? err.message : String(err), err);
+            }
+        },
+    };
+    return { dataProducts, queues, connections, workflows };
+}
+//# sourceMappingURL=toolbox.js.map

package/dist/authoring/toolbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbox.js","sourceRoot":"","sources":["../../src/authoring/toolbox.ts"],"names":[],"mappings":"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"}

package/dist/authoring/triggers.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Trigger builders for code-first data workflow authoring.
+ *
+ * Each builder accepts typed constants from the Generated_SDK_Artifact and
+ * returns a `TriggerSpec` describing the event source.
+ */
+import type { TriggerSpec, QueueRef, ConnectorRef } from './types.js';
+/**
+ * Trigger builder namespace. Each method constructs a `TriggerSpec` from a
+ * typed workspace constant.
+ *
+ * Usage:
+ * ```ts
+ * import { on } from '@loxtep/sdk/authoring';
+ * import { queues, connectors } from './.loxtep/generated/index';
+ *
+ * on.queueEvent(queues.orders_raw)
+ * on.connectorEvent(connectors.shopify_main)
+ * on.schedule('0 * * * *')
+ * on.webhook('/ingest/orders')
+ * ```
+ */
+export declare const on: {
+    /**
+     * Trigger on a queue event from a typed queue constant.
+     */
+    readonly queueEvent: (queue: QueueRef) => TriggerSpec;
+    /**
+     * Trigger on a connector event from a typed connector constant.
+     */
+    readonly connectorEvent: (connector: ConnectorRef) => TriggerSpec;
+    /**
+     * Trigger on a cron schedule.
+     */
+    readonly schedule: (cron: string) => TriggerSpec;
+    /**
+     * Trigger on an incoming webhook at the given path.
+     */
+    readonly webhook: (path: string) => TriggerSpec;
+};
+//# sourceMappingURL=triggers.d.ts.map

package/dist/authoring/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../src/authoring/triggers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEtE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,EAAE;IACb;;OAEG;iCACe,QAAQ,KAAG,WAAW;IAOxC;;OAEG;yCACuB,YAAY,KAAG,WAAW;IAOpD;;OAEG;8BACY,MAAM,KAAG,WAAW;IAOnC;;OAEG;6BACW,MAAM,KAAG,WAAW;CAM1B,CAAC"}

package/dist/authoring/triggers.js

@@ -0,0 +1,60 @@
+/**
+ * Trigger builders for code-first data workflow authoring.
+ *
+ * Each builder accepts typed constants from the Generated_SDK_Artifact and
+ * returns a `TriggerSpec` describing the event source.
+ */
+/**
+ * Trigger builder namespace. Each method constructs a `TriggerSpec` from a
+ * typed workspace constant.
+ *
+ * Usage:
+ * ```ts
+ * import { on } from '@loxtep/sdk/authoring';
+ * import { queues, connectors } from './.loxtep/generated/index';
+ *
+ * on.queueEvent(queues.orders_raw)
+ * on.connectorEvent(connectors.shopify_main)
+ * on.schedule('0 * * * *')
+ * on.webhook('/ingest/orders')
+ * ```
+ */
+export const on = {
+    /**
+     * Trigger on a queue event from a typed queue constant.
+     */
+    queueEvent(queue) {
+        return {
+            kind: 'queue',
+            ref: { id: queue.id, name: queue.name },
+        };
+    },
+    /**
+     * Trigger on a connector event from a typed connector constant.
+     */
+    connectorEvent(connector) {
+        return {
+            kind: 'connector',
+            ref: { id: connector.id, name: connector.type },
+        };
+    },
+    /**
+     * Trigger on a cron schedule.
+     */
+    schedule(cron) {
+        return {
+            kind: 'schedule',
+            schedule: cron,
+        };
+    },
+    /**
+     * Trigger on an incoming webhook at the given path.
+     */
+    webhook(path) {
+        return {
+            kind: 'webhook',
+            path,
+        };
+    },
+};
+//# sourceMappingURL=triggers.js.map

package/dist/authoring/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../src/authoring/triggers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB;;OAEG;IACH,UAAU,CAAC,KAAe;QACxB,OAAO;YACL,IAAI,EAAE,OAAO;YACb,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;SACxC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,SAAuB;QACpC,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,GAAG,EAAE,EAAE,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE;SAChD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAY;QACnB,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,IAAI;SACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAY;QAClB,OAAO;YACL,IAAI,EAAE,SAAS;YACf,IAAI;SACL,CAAC;IACJ,CAAC;CACO,CAAC"}