@versori/run 0.3.0-veta.2 → 0.4.0-alpha.10

package/esm/src/context/Context.d.ts

@@ -1,13 +1,12 @@
 import type * as express from 'express';
 import { CredentialsProvider } from '../dsl/http/versori/contextcredentials.js';
-import { QueueAPI } from '../interpreter/durable/Queue.js';
+import { QueueAPI, Workflow } from '../interpreter/durable/Queue.js';
 import { Issue, IssueAPI } from '../issues/Issues.js';
 import { KeyValue, KeyValueProvider, KeyValueScope } from '../kv/KeyValue.js';
 import { Logger } from '../observability/logging/Logger.js';
-import { AsyncWorkflow } from './AsyncWorkflow.js';
-import { Workflow } from '../interpreter/durable/Queue.js';
 import { ActivationImpl } from './ActivationImpl.js';
-import { WorkflowInterface, WorkflowOpts } from './WorkflowClient.js';
+import { AsyncWorkflow } from './AsyncWorkflow.js';
+import { WorkflowInterface, WorkflowOpts } from './WorkflowsClient.js';
 export type OnSuccessFn = (ctx: Context<any>) => void;
 export type OnErrorFn = (ctx: Context<any>) => void;
 export type ContextOptions = {
@@ -16,12 +15,31 @@ export type ContextOptions = {
     onSuccess?: OnSuccessFn;
     onError?: OnErrorFn;
 };
+/**
+ * CreateIssue is the payload for creating a new issue.
+ */
 export type CreateIssue = {
+    /**
+     * The severity of the issue.
+     */
     severity: 'low' | 'medium' | 'high';
+    /**
+     * The title of the issue.
+     */
     title: string;
+    /**
+     * The message of the issue.
+     */
     message: string;
+    /**
+     * Any additional annotations to attach to the issue.
+     */
     annotations: Record<string, string>;
 };
+/**
+ * Context is the object passed to workflow functions, it provides access to the data being processed by the workflow,
+ * as well as a number of other properties and methods for implementing the workflow logic.
+ */
 export interface Context<D> {
     readonly log: Logger;
     readonly executionId: string;
@@ -30,16 +48,47 @@ export interface Context<D> {
     activation: ActivationImpl;
     /**
      * Opens a key value store for the given scope, defaulting to ':project:' if not provided.
-     * @param scope
+     * @param scope The scope of the key value store to open, defaulting to ':project:' if not provided.
      */
     openKv(scope?: KeyValueScope): KeyValue;
+    /**
+     * Starts a workflow with the given ID and options.
+     * @param workflowId The ID of the workflow to start, this should refer to a workflow registered with the
+     *  {@link DurableInterpreter}.
+     * @param workflowOpts The options for the workflow.
+     *
+     * The integration must be ran using the {@link DurableInterpreter} and not {@link MemoryInterpreter} (the
+     * default interpreter). Reach out to support if you need help with this.
+     */
     start(workflowId: string, workflowOpts: WorkflowOpts): Promise<AsyncWorkflow>;
+    /**
+     * Returns a {@link CredentialsProvider} which can be used to read credential data directly and construct requests
+     * for systems using custom authentication methods which are not supported natively by Versori.
+     */
     credentials(): CredentialsProvider;
+    /**
+     * Destroys the key value store for the given scope, ":execution:", ":project:" or ":organization:".
+     *
+     * @param scope The scope of the key value store to destroy, ":execution:", ":project:" or ":organization:".
+     */
     destroy(scope: KeyValueScope): Promise<void>;
+    /**
+     * Creates a new issue for the current context. Issues can be managed through the Versori platform or via the API.
+     * Users can configure notification channels within their account settings to be notified of new issues.
+     *
+     * @param issue The issue to create.
+     * @param options Optional options for the issue creation.
+     */
     createIssue(issue: CreateIssue, options?: {
         deduplicate?: boolean;
     }): Promise<Issue | null>;
+    /**
+     * Returns the underlying express {@link express.Request} object for the current execution.
+     */
     request(): express.Request | undefined;
+    /**
+     * Returns a client for managing workflows.
+     */
     workflowClient(): WorkflowInterface;
 }
 export declare class ContextImpl<D, Index = void> implements Context<D> {
@@ -59,13 +108,13 @@ export declare class ContextImpl<D, Index = void> implements Context<D> {
     withData<D2>(data: D2): ContextImpl<D2, Index>;
     openKv(scope?: KeyValueScope): KeyValue;
     request(): express.Request | undefined;
-    workflowClient(): WorkflowInterface;
     start(group: string, opts: WorkflowOpts): Promise<AsyncWorkflow>;
     createIssue(issue: CreateIssue, options?: {
         deduplicate?: boolean;
     }): Promise<Issue | null>;
     credentials(): CredentialsProvider;
     destroy(scope: KeyValueScope): Promise<void>;
+    workflowClient(): WorkflowInterface;
     [Symbol.toPrimitive](): Record<string, unknown>;
 }
 //# sourceMappingURL=Context.d.ts.map

package/esm/src/context/Context.d.ts.map

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

package/esm/src/context/Context.js

@@ -1,3 +1,15 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
@@ -11,7 +23,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _ContextImpl_activation, _ContextImpl_issues, _ContextImpl_creds;
 import { AsyncWorkflow } from './AsyncWorkflow.js';
-import { WorkflowImpl } from './WorkflowClient.js';
+import { WorkflowImpl } from './WorkflowsClient.js';
 export class ContextImpl {
     constructor(log, kvp, creds, executionId, startTime, data, activation, issues, queue, options = {}) {
         Object.defineProperty(this, "log", {
@@ -117,12 +129,6 @@ export class ContextImpl {
     request() {
         return this.options.request;
     }
-    workflowClient() {
-        if (!this.queue) {
-            throw new Error('Queue is not available for this context, cannot start workflow');
-        }
-        return new WorkflowImpl(this.queue, this.executionId, this.activation);
-    }
     async start(group, opts) {
         // this makes a post request to the endpoint sending a message and schedule the workflow to run
         if (!this.queue) {
@@ -179,6 +185,12 @@ export class ContextImpl {
             activationId: this.activation?.id,
         });
     }
+    workflowClient() {
+        if (!this.queue) {
+            throw new Error('Queue is not available for this context, cannot start workflow');
+        }
+        return new WorkflowImpl(this.queue, this.executionId, this.activation);
+    }
     [(_ContextImpl_activation = new WeakMap(), _ContextImpl_issues = new WeakMap(), _ContextImpl_creds = new WeakMap(), Symbol.toPrimitive)]() {
         return {
             startTime: this.startTime,

package/esm/src/context/ContextFunc.d.ts

@@ -1,5 +1,27 @@
 import { Context } from './Context.js';
+/**
+ * ContextFunc represents a function that can be used as a task in a workflow. It can be either synchronous or
+ * asynchronous, and receives a {@link Context} object and an optional index parameter.
+ *
+ * @template Input The type of data expected in the context.
+ * @template Output The type of data returned by the function.
+ * @template Index Optional index parameter, typically used when processing arrays.
+ */
 export type ContextFunc<Input, Output, Index = void> = AsyncContextFunc<Input, Output, Index> | SyncContextFunc<Input, Output, Index>;
+/**
+ * AsyncContextFunc is an asynchronous function that can be used as a task in a workflow.
+ *
+ * @template Input The type of data expected in the context.
+ * @template Output The type of data returned by the function.
+ * @template Index Optional index parameter, typically used when processing arrays.
+ */
 export type AsyncContextFunc<Input, Output, Index> = (ctx: Context<Input>, idx: Index) => Promise<Output>;
+/**
+ * SyncContextFunc is a synchronous function that can be used as a task in a workflow.
+ *
+ * @template Input The type of data expected in the context.
+ * @template Output The type of data returned by the function.
+ * @template Index Optional index parameter, typically used when processing arrays.
+ */
 export type SyncContextFunc<Input, Output, Index> = (ctx: Context<Input>, idx: Index) => Output;
 //# sourceMappingURL=ContextFunc.d.ts.map

package/esm/src/context/ContextFunc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContextFunc.d.ts","sourceRoot":"","sources":["../../../src/src/context/ContextFunc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI,IAC7C,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GACtC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAE5C,MAAM,MAAM,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE1G,MAAM,MAAM,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,KAAK,MAAM,CAAC"}
+{"version":3,"file":"ContextFunc.d.ts","sourceRoot":"","sources":["../../../src/src/context/ContextFunc.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI,IAC7C,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GACtC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CACjD,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,EACnB,GAAG,EAAE,KAAK,KACT,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,KAAK,MAAM,CAAC"}

package/esm/src/context/ContextFunc.js

@@ -1 +1,13 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 export {};

package/esm/src/context/ContextProvider.d.ts

@@ -1,14 +1,14 @@
+import { Activation, PlatformApi } from '@versori/run/services/platform';
 import { CredentialsProvider } from '../dsl/http/versori/contextcredentials.js';
 import { QueueAPI } from '../interpreter/durable/Queue.js';
 import { IssueAPI } from '../issues/Issues.js';
 import { KeyValueProvider } from '../kv/KeyValue.js';
 import { Logger } from '../observability/logging/Logger.js';
 import { Context, ContextImpl, ContextOptions } from './Context.js';
-import { Activation, PlatformApi } from '../services/platform/mod.js';
 export interface ContextProvider {
     create<D>(activation: Activation, data: D, options?: ContextOptions): ContextImpl<D, void>;
-    createWithExecutionId<D>(activation: Activation, data: D, executionId: string, options?: ContextOptions): ContextImpl<D, void>;
     destroy(ctx: Context<any>): Promise<void>;
+    createWithExecutionId<D>(activation: Activation, data: D, executionId: string, options?: ContextOptions): ContextImpl<D, void>;
 }
 export declare class ContextProviderImpl implements ContextProvider {
     private readonly platformApi;

package/esm/src/context/ContextProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContextProvider.d.ts","sourceRoot":"","sources":["../../../src/src/context/ContextProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAGtE,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3F,qBAAqB,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC/H,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,qBAAa,mBAAoB,YAAW,eAAe;IAWnD,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAZlC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,gBAAgB,CAAC;IACtB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;gBAGb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,mBAAmB,EACT,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACtC,MAAM,EAAE,QAAQ,EAChB,KAAK,GAAE,QAAQ,GAAG,SAAqB;IAS3C,qBAAqB,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC;IAuBlI,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,WAAW,CAAC,CAAC,CAAC;IAMxF,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C"}
+{"version":3,"file":"ContextProvider.d.ts","sourceRoot":"","sources":["../../../src/src/context/ContextProvider.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAE5D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3F,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,qBAAqB,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;CAClI;AAED,qBAAa,mBAAoB,YAAW,eAAe;IAWnD,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAZlC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,gBAAgB,CAAC;IACtB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;gBAGb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,mBAAmB,EACT,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACtC,MAAM,EAAE,QAAQ,EAChB,KAAK,GAAE,QAAQ,GAAG,SAAqB;IAS3C,qBAAqB,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC;IAuBlI,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,WAAW,CAAC,CAAC,CAAC;IAMxF,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C"}

package/esm/src/context/ContextProvider.js

@@ -1,6 +1,18 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 import { ulid } from '../../deps/jsr.io/@std/ulid/1.0.0/mod.js';
-import { ContextImpl } from './Context.js';
 import { ActivationImpl } from './ActivationImpl.js';
+import { ContextImpl } from './Context.js';
 export class ContextProviderImpl {
     constructor(log, kvp, creds, platformApi, organisationId, environmentId, issues, queue = undefined) {
         Object.defineProperty(this, "platformApi", {

package/{script/src/context/WorkflowClient.d.ts → esm/src/context/WorkflowsClient.d.ts}

@@ -1,5 +1,4 @@
-import { QueueAPI } from '../interpreter/durable/Queue.js';
-import { Workflow } from '../interpreter/durable/Queue.js';
+import { QueueAPI, Workflow } from '../interpreter/durable/Queue.js';
 import { ActivationImpl } from './ActivationImpl.js';
 export type WorkflowOpts = {
     maxAttempts?: number;
@@ -26,4 +25,4 @@ export declare class WorkflowImpl implements WorkflowInterface {
     rescheduleWorkflow(wf: Workflow, after: string): Promise<void>;
     completeWorkflow(wf: Workflow, status: 'completed' | 'failed', output?: any): Promise<void>;
 }
-//# sourceMappingURL=WorkflowClient.d.ts.map
+//# sourceMappingURL=WorkflowsClient.d.ts.map

package/esm/src/context/WorkflowsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowsClient.d.ts","sourceRoot":"","sources":["../../../src/src/context/WorkflowsClient.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD,MAAM,MAAM,YAAY,GAAG;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAC9B,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9C,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,QAAQ,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/F;AAED,qBAAa,YAAa,YAAW,iBAAiB;IAClD,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAiB;gBAEvB,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc;IActE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmBnE,WAAW,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI5C,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI9C,iBAAiB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IASlD,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B9D,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,QAAQ,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAYpG"}

package/esm/src/context/{WorkflowClient.js → WorkflowsClient.js}

@@ -1,3 +1,15 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 export class WorkflowImpl {
     constructor(queue, executionId, activation) {
         Object.defineProperty(this, "queue", {

package/esm/src/context/mod.d.ts

@@ -1,4 +1,11 @@
-export * from './Context.js';
+/**
+ * The context module provides the functionality for accessing the data, metadata, and interacting with the Versori
+ * managed services within a workflow.
+ *
+ * @module
+ */
+export type { AsyncWorkflow } from './AsyncWorkflow.js';
+export type { Context, CreateIssue } from './Context.js';
 export * from './ContextFunc.js';
-export * from './ContextProvider.js';
+export type { WorkflowOpts } from './WorkflowsClient.js';
 //# sourceMappingURL=mod.d.ts.map

package/esm/src/context/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/context/mod.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/context/mod.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzD,cAAc,kBAAkB,CAAC;AACjC,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/esm/src/context/mod.js

@@ -1,3 +1,13 @@
-export * from './Context.js';
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
 export * from './ContextFunc.js';
-export * from './ContextProvider.js';

package/esm/src/credentials/CredentialsProvider.d.ts

@@ -0,0 +1,49 @@
+import { MessageInitShape } from '@bufbuild/protobuf';
+import { Client } from '@connectrpc/connect';
+import { credentialv1alpha1, oauth1v1 } from '../services/credentials/mod.js';
+export type Token = {
+    accessToken: string;
+    tokenType: string;
+    expiry?: Date;
+};
+/**
+ * CredentialsProvider is the interface for interacting with the credentials service.
+ */
+export interface CredentialsProvider {
+    getRaw(name: string, activationId?: string): Promise<Uint8Array>;
+    getAccessToken(name: string, forceRefresh?: boolean, activationId?: string): Promise<Token>;
+    getOAuth1Metadata(name: string, activationId?: string): Promise<oauth1v1.GetAuthorizationMetadataResponse>;
+}
+export type CredentialData = {
+    [key: string]: Uint8Array;
+};
+/**
+ * CredentialsProviderV2 is the latest version of the CredentialsProvider interface and provides more capabilities for
+ * interacting with the credentials service.
+ *
+ * All implementations should be provided a fixed organisation ID to prevent misuse of the API.
+ */
+export interface CredentialsProviderV2 {
+    get(id: string): Promise<credentialv1alpha1.Credential>;
+    updateApiKey(id: string, key: string): Promise<credentialv1alpha1.Credential>;
+    updateBasicAuth(id: string, username: string, password: string): Promise<credentialv1alpha1.Credential>;
+    updateCertificate(id: string, payload: MessageInitShape<typeof credentialv1alpha1.CredentialDataCertificateSchema>): Promise<credentialv1alpha1.Credential>;
+}
+/**
+ * CredentialsProviderV2 is the latest version of the CredentialsProvider interface and provides more capabilities for
+ * interacting with the credentials service.
+ *
+ * THIS IS A WORK IN PROGRESS - WE SHOULD STILL USE THE V1 INTERFACE FOR NOW.
+ *
+ * No idea if this approach is a good idea, happy to change it if there's a better way.
+ */
+export declare class CredentialsProviderImpl implements CredentialsProviderV2 {
+    private readonly client;
+    private readonly organisationId;
+    constructor(client: Client<typeof credentialv1alpha1.CredentialService>, organisationId: string);
+    get(id: string): Promise<credentialv1alpha1.Credential>;
+    updateApiKey(id: string, key: string): Promise<credentialv1alpha1.Credential>;
+    updateBasicAuth(id: string, username: string, password: string): Promise<credentialv1alpha1.Credential>;
+    updateCertificate(id: string, payload: MessageInitShape<typeof credentialv1alpha1.CredentialDataCertificateSchema>): Promise<credentialv1alpha1.Credential>;
+}
+//# sourceMappingURL=CredentialsProvider.d.ts.map

package/esm/src/credentials/CredentialsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CredentialsProvider.d.ts","sourceRoot":"","sources":["../../../src/src/credentials/CredentialsProvider.ts"],"names":[],"mappings":"AAaA,OAAO,EAAU,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAS9E,MAAM,MAAM,KAAK,GAAG;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEjE,cAAc,CACV,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,OAAO,EACtB,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,KAAK,CAAC,CAAC;IAElB,iBAAiB,CACb,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC;CACzD;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;CAAE,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACxD,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC9E,eAAe,CACX,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC1C,iBAAiB,CACb,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,gBAAgB,CAAC,OAAO,kBAAkB,CAAC,+BAA+B,CAAC,GACrF,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;CAC7C;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAwB,YAAW,qBAAqB;IAE7D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBADd,MAAM,EAAE,MAAM,CAAC,OAAO,kBAAkB,CAAC,iBAAiB,CAAC,EAC3D,cAAc,EAAE,MAAM;IAIrC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC;IAUvD,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC;IAoB7E,eAAe,CACjB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC;IAwBnC,iBAAiB,CACnB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,gBAAgB,CAAC,OAAO,kBAAkB,CAAC,+BAA+B,CAAC,GACrF,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC;CAyB5C"}

package/esm/src/credentials/CredentialsProvider.js

@@ -0,0 +1,102 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
+import { create } from '@bufbuild/protobuf';
+import { encodeBase64 } from '../../deps/jsr.io/@std/encoding/1.0.10/base64.js';
+import { credentialv1alpha1 } from '../services/credentials/mod.js';
+/**
+ * CredentialsProviderV2 is the latest version of the CredentialsProvider interface and provides more capabilities for
+ * interacting with the credentials service.
+ *
+ * THIS IS A WORK IN PROGRESS - WE SHOULD STILL USE THE V1 INTERFACE FOR NOW.
+ *
+ * No idea if this approach is a good idea, happy to change it if there's a better way.
+ */
+export class CredentialsProviderImpl {
+    constructor(client, organisationId) {
+        Object.defineProperty(this, "client", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: client
+        });
+        Object.defineProperty(this, "organisationId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: organisationId
+        });
+    }
+    async get(id) {
+        const response = await this.client.get({ id, organisationId: this.organisationId });
+        if (!response.credential) {
+            throw new Error('Failed to get credential, response was undefined');
+        }
+        return response.credential;
+    }
+    async updateApiKey(id, key) {
+        const rawMsg = create(credentialv1alpha1.CredentialDataRawSchema, {
+            raw: new TextEncoder().encode(encodeBase64(key)),
+        });
+        const response = await this.client.update({
+            id,
+            organisationId: this.organisationId,
+            data: {
+                raw: rawMsg.raw,
+            },
+        });
+        if (!response.credential) {
+            throw new Error('Failed to update API key credential, response was undefined');
+        }
+        return response.credential;
+    }
+    async updateBasicAuth(id, username, password) {
+        const basicAuthMsg = create(credentialv1alpha1.CredentialDataBasicAuthSchema, {
+            username,
+            password,
+        });
+        const data = {
+            username: new TextEncoder().encode(encodeBase64(basicAuthMsg.username)),
+            password: new TextEncoder().encode(encodeBase64(basicAuthMsg.password)),
+        };
+        const response = await this.client.update({
+            id,
+            organisationId: this.organisationId,
+            data,
+        });
+        if (!response.credential) {
+            throw new Error('Failed to update basic auth credential, response was undefined');
+        }
+        return response.credential;
+    }
+    async updateCertificate(id, payload) {
+        const certificateMsg = create(credentialv1alpha1.CredentialDataCertificateSchema, {
+            certificate: payload.certificate,
+            key: payload.key,
+            ca: payload.ca,
+        });
+        const data = {
+            certificate: new TextEncoder().encode(encodeBase64(certificateMsg.certificate)),
+            key: new TextEncoder().encode(encodeBase64(certificateMsg.key)),
+            ca: new TextEncoder().encode(encodeBase64(certificateMsg.ca)),
+        };
+        const response = await this.client.update({
+            id,
+            organisationId: this.organisationId,
+            data,
+        });
+        if (!response.credential) {
+            throw new Error('Failed to update certificate credential, response was undefined');
+        }
+        return response.credential;
+    }
+}

package/esm/src/dsl/Task.d.ts

@@ -1,5 +1,15 @@
 import { ContextFunc } from '../context/ContextFunc.js';
+/**
+ * Symbol used to identify objects as tasks.
+ */
 export declare const TaskType: unique symbol;
+/**
+ * Task represents a single unit of work in a workflow. Tasks can be chained together using the `.then()` method,
+ * handle errors with `.catch()`, run in the background with `.background()`, and process arrays with `.unpack()`.
+ *
+ * @template In The input type expected by this task.
+ * @template Out The output type produced by this task.
+ */
 export interface Task<In = any, Out = any> extends Object {
     [TaskType]: string;
     /**
@@ -18,16 +28,51 @@ export interface Task<In = any, Out = any> extends Object {
      */
     catch<NextOut>(task: Taskable<Error, NextOut>): Task<In, NextOut>;
     /**
-     * Run the current task in the background and continue execution of the workflow.
+     * Run the current task in the background and continue execution of the workflow. The next step's input data will be
+     * of type `void`.
      */
     background(): Task<In, void>;
     unpack<NextOut = Out extends Array<infer Elem> ? Elem : Out>(): ArrayTask<In, NextOut>;
     unpack<NextOut>(mapper: (data: Out) => NextOut[]): ArrayTask<In, NextOut>;
+    /**
+     * Create a copy of this task.
+     *
+     * @returns A cloned instance of this task.
+     */
     clone(): Task<In, Out>;
 }
+/**
+ * ArrayTask extends {@link Task} with methods for processing array elements either in parallel or serial.
+ * It is created by calling `.unpack()` on a task that produces an array.
+ *
+ * @template In The input type expected by this task.
+ * @template OutElem The type of individual elements in the output array.
+ */
 export type ArrayTask<In, OutElem> = Task<In, OutElem[]> & {
+    /**
+     * Process each element of the array in parallel.
+     *
+     * @template NextOut The output type produced by the task for each element.
+     * @param task The task to apply to each element.
+     * @returns A task that outputs an array of results.
+     */
     parallel<NextOut>(task: Taskable<OutElem, NextOut, number>): Task<In, NextOut[]>;
+    /**
+     * Process each element of the array in series (one after another).
+     *
+     * @template NextOut The output type produced by the task for each element.
+     * @param task The task to apply to each element.
+     * @returns A task that outputs an array of results.
+     */
     serial<NextOut>(task: Taskable<OutElem, NextOut, number>): Task<In, NextOut[]>;
 };
+/**
+ * Taskable represents anything that can be used as a task in a workflow: either a {@link Task} object or a
+ * {@link ContextFunc} function.
+ *
+ * @template In The input type expected by this task.
+ * @template O The output type produced by this task.
+ * @template Index Optional index parameter used when processing arrays.
+ */
 export type Taskable<In, O, Index = unknown> = Task<In, O> | ContextFunc<In, O, Index>;
 //# sourceMappingURL=Task.d.ts.map

package/esm/src/dsl/Task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../../src/src/dsl/Task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,eAAO,MAAM,QAAQ,eAAiB,CAAC;AAEvC,MAAM,WAAW,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,CAAE,SAAQ,MAAM;IACrD,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAE/D;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAElE;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAQ7B,MAAM,CAAC,OAAO,GAAG,GAAG,SAAS,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,GAAG,KAAK,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACvF,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAO1E,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;CAC1B;AAID,MAAM,MAAM,SAAS,CAAC,EAAE,EAAE,OAAO,IAAI,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG;IACvD,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACjF,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;CAClF,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,GAAG,OAAO,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC"}
+{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../../src/src/dsl/Task.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,QAAQ,eAAiB,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,WAAW,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,CAAE,SAAQ,MAAM;IACrD,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAE/D;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAElE;;;OAGG;IACH,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAQ7B,MAAM,CAAC,OAAO,GAAG,GAAG,SAAS,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,GAAG,KAAK,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACvF,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAO1E;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;CAC1B;AAID;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,CAAC,EAAE,EAAE,OAAO,IAAI,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG;IACvD;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAEjF;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;CAClF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,GAAG,OAAO,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC"}

package/esm/src/dsl/Task.js

@@ -1 +1,16 @@
+/*
+ * Copyright (c) 2025 Versori Group Inc
+ *
+ * Use of this software is governed by the Business Source License 1.1
+ * included in the LICENSE file at the root of this repository.
+ *
+ * Change Date: 2029-01-01
+ * Change License: Apache License, Version 2.0
+ *
+ * As of the Change Date, in accordance with the Business Source License,
+ * use of this software will be governed by the Apache License, Version 2.0.
+ */
+/**
+ * Symbol used to identify objects as tasks.
+ */
 export const TaskType = Symbol('Task');

package/esm/src/dsl/Trigger.d.ts

@@ -1,8 +1,24 @@
 import { Taskable } from './Task.js';
 import { Workflow } from './Workflow.js';
+/**
+ * Symbol used to identify the type of trigger.
+ */
 export declare const TriggerType: unique symbol;
+/**
+ * Trigger represents the starting point of a workflow. Triggers define when and how a workflow should be executed.
+ * Common trigger types include {@link schedule}, {@link webhook}, and {@link workflow}.
+ *
+ * @template O The type of data produced by this trigger.
+ */
 export interface Trigger<O> {
     [TriggerType]: string;
+    /**
+     * Attach a task to this trigger, creating a workflow.
+     *
+     * @template OO The output type of the task.
+     * @param task The task to execute when the trigger fires.
+     * @returns A workflow combining this trigger with the provided task.
+     */
     then<OO>(task: Taskable<O, OO>): Workflow<OO>;
 }
 //# sourceMappingURL=Trigger.d.ts.map

package/esm/src/dsl/Trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Trigger.d.ts","sourceRoot":"","sources":["../../../src/src/dsl/Trigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,eAAO,MAAM,WAAW,eAAwB,CAAC;AAEjD,MAAM,WAAW,OAAO,CAAC,CAAC;IACtB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAEtB,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;CACjD"}
+{"version":3,"file":"Trigger.d.ts","sourceRoot":"","sources":["../../../src/src/dsl/Trigger.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,WAAW,eAAwB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC;IACtB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;CACjD"}