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

package/esm/src/dsl/mod.js

@@ -1,3 +1,28 @@
-// Re-export types from Trigger base interfaces
+/*
+ * 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.
+ */
+/**
+ * The dsl module provides the functionality for defining workflows. Workflows created via this module must be
+ * registered with an interpreter to be executed, see the {@link interpreter} module for more information.
+ *
+ * The main exports you will need to use from this module are:
+ *
+ * - {@link http}: Provides the functionality for defining tasks which inject a `fetch` function onto the context with
+ *   authentication automatically configured for the provided connection.
+ * - {@link schedule}: Provides the functionality for defining workflows which are triggered on a cron schedule.
+ * - {@link webhook}: Provides the functionality for defining workflows which are triggered when a webhook is received.
+ *
+ * @module
+ */
+export * from './http/mod.js';
 export * from './tasks/mod.js';
 export * from './triggers/mod.js';

package/esm/src/dsl/tasks/BackgroundTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BackgroundTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/BackgroundTask.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKjE,qBAAa,cAAc,CAAC,EAAE,EAAE,GAAG,CAAE,YAAW,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAC1D,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAgB;IAElC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;gBAET,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;IAI/B,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAI/D,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,OAAO,GAAG,GAAG,SAAS,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,GAAG,KAAK,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IACtF,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IAS1E,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;CAG1B"}
+{"version":3,"file":"BackgroundTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/BackgroundTask.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKjE,qBAAa,cAAc,CAAC,EAAE,EAAE,GAAG,CAAE,YAAW,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAC1D,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAgB;IAElC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;gBAET,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;IAI/B,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAI/D,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,OAAO,GAAG,GAAG,SAAS,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,GAAG,KAAK,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IACtF,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IAS1E,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;CAG1B"}

package/esm/src/dsl/tasks/BackgroundTask.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 _a;
 import { ensureTask } from '../ensureTask.js';
 import { TaskType } from '../Task.js';

package/esm/src/dsl/tasks/CatchTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CatchTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/CatchTask.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKjE,qBAAa,SAAS,CAAC,EAAE,EAAE,GAAG,CAAE,YAAW,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;IACpD,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAW;IAE7B,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,aAAa,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAEpB,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC;IAK1D,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAI9D,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,OAAO,GAAG,GAAG,SAAS,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,GAAG,KAAK,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IACtF,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IASzE,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;CAGzB"}
+{"version":3,"file":"CatchTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/CatchTask.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKjE,qBAAa,SAAS,CAAC,EAAE,EAAE,GAAG,CAAE,YAAW,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;IACpD,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAW;IAE7B,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,aAAa,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAEpB,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC;IAK1D,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAI9D,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,OAAO,GAAG,GAAG,SAAS,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,GAAG,KAAK,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IACtF,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IASzE,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;CAGzB"}

package/esm/src/dsl/tasks/CatchTask.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 _a;
 import { ensureTask } from '../ensureTask.js';
 import { TaskType } from '../Task.js';

package/esm/src/dsl/tasks/ChainTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChainTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/ChainTask.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKjE,qBAAa,SAAS,CAAC,EAAE,EAAE,GAAG,CAAE,YAAW,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;IACpD,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAW;IAE7B,KAAK,EAAE,IAAI,EAAE,CAAM;gBAEP,GAAG,KAAK,EAAE,IAAI,EAAE;IAI5B,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAI9D,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,OAAO,GAAG,GAAG,SAAS,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,GAAG,KAAK,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IACtF,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IASzE,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;CAGzB"}
+{"version":3,"file":"ChainTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/ChainTask.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKjE,qBAAa,SAAS,CAAC,EAAE,EAAE,GAAG,CAAE,YAAW,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;IACpD,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAW;IAE7B,KAAK,EAAE,IAAI,EAAE,CAAM;gBAEP,GAAG,KAAK,EAAE,IAAI,EAAE;IAI5B,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAI9D,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,OAAO,GAAG,GAAG,SAAS,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,GAAG,KAAK,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IACtF,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IASzE,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;CAGzB"}

package/esm/src/dsl/tasks/ChainTask.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 _a;
 import { ensureTask } from '../ensureTask.js';
 import { TaskType } from '../Task.js';
@@ -21,7 +33,7 @@ export class ChainTask {
         this.tasks = tasks;
     }
     then(task) {
-        return new ChainTask(...this.tasks.map(t => t.clone()), ensureTask(task));
+        return new ChainTask(...this.tasks.map((t) => t.clone()), ensureTask(task));
     }
     catch(task) {
         return new CatchTask(this.clone(), ensureTask(task));
@@ -36,7 +48,7 @@ export class ChainTask {
         return new UnpackTask(this.clone());
     }
     clone() {
-        return new ChainTask(...this.tasks.map(t => t.clone()));
+        return new ChainTask(...this.tasks.map((t) => t.clone()));
     }
 }
 _a = TaskType;

package/esm/src/dsl/tasks/FnTask.d.ts

@@ -10,7 +10,31 @@ export declare class FnTask<In, Out, Index = void> implements Task<In, Out> {
     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>;
-    clone(): FnTask<In, Out, Index>;
+    clone(): Task<In, Out>;
 }
+/**
+ * Create a task that executes a function with access to the workflow context.
+ *
+ * The provided function receives a {@link Context} object containing the current workflow data, logger, and other
+ * utilities for implementing workflow logic. This is the primary building block for custom workflow tasks.
+ *
+ * @template I The input type expected by the function.
+ * @template O The output type produced by the function.
+ * @template Index Optional index parameter used when processing arrays.
+ * @param id A unique identifier for this task, this will be used in execution traces to identify spans in the
+ *        execution.
+ * @param fn The function to execute, which receives a context object.
+ * @returns A task that can be chained in a workflow.
+ *
+ * @example
+ * ```typescript
+ * import { fn } from '@versori/run';
+ *
+ * const myTask = fn('process-data', (ctx) => {
+ *   ctx.log.info('Processing data', { input: ctx.data });
+ *   return { result: ctx.data * 2 };
+ * });
+ * ```
+ */
 export declare function fn<I, O, Index = void>(id: string, fn: ContextFunc<I, O, Index>): Task<I, O>;
 //# sourceMappingURL=FnTask.d.ts.map

package/esm/src/dsl/tasks/FnTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FnTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/FnTask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMjE,qBAAa,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAE,YAAW,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;IAC/D,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAQ;IAC1B,EAAE,EAAE,MAAM,CAAC;IAEX,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;gBAErB,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC;IAKvD,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAI9D,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,OAAO,GAAG,GAAG,SAAS,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,GAAG,KAAK,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IACtF,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IASzE,KAAK;CAGR;AAED,wBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAE3F"}
+{"version":3,"file":"FnTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/FnTask.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMjE,qBAAa,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAE,YAAW,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;IAC/D,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAQ;IAC1B,EAAE,EAAE,MAAM,CAAC;IAEX,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;gBAErB,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC;IAKvD,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAI9D,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,OAAO,GAAG,GAAG,SAAS,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,GAAG,KAAK,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IACtF,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;IASzE,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;CAGzB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAE3F"}

package/esm/src/dsl/tasks/FnTask.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 _a;
 import { ensureTask } from '../ensureTask.js';
 import { TaskType } from '../Task.js';
@@ -48,6 +60,30 @@ export class FnTask {
     }
 }
 _a = TaskType;
+/**
+ * Create a task that executes a function with access to the workflow context.
+ *
+ * The provided function receives a {@link Context} object containing the current workflow data, logger, and other
+ * utilities for implementing workflow logic. This is the primary building block for custom workflow tasks.
+ *
+ * @template I The input type expected by the function.
+ * @template O The output type produced by the function.
+ * @template Index Optional index parameter used when processing arrays.
+ * @param id A unique identifier for this task, this will be used in execution traces to identify spans in the
+ *        execution.
+ * @param fn The function to execute, which receives a context object.
+ * @returns A task that can be chained in a workflow.
+ *
+ * @example
+ * ```typescript
+ * import { fn } from '@versori/run';
+ *
+ * const myTask = fn('process-data', (ctx) => {
+ *   ctx.log.info('Processing data', { input: ctx.data });
+ *   return { result: ctx.data * 2 };
+ * });
+ * ```
+ */
 export function fn(id, fn) {
     return new FnTask(id, fn);
 }

package/esm/src/dsl/tasks/HttpTask.d.ts

@@ -1,35 +1,86 @@
 import type * as express from 'express';
+import { FetchLike } from '../../connection/types.js';
+import { ActivationImpl } from '../../context/ActivationImpl.js';
 import { AsyncWorkflow } from '../../context/AsyncWorkflow.js';
 import { Context, ContextImpl, CreateIssue } from '../../context/Context.js';
-import { WorkflowInterface, WorkflowOpts } from '../../context/WorkflowClient.js';
+import { WorkflowInterface, WorkflowOpts } from '../../context/WorkflowsClient.js';
 import { Issue } from '../../issues/Issues.js';
 import { KeyValue, KeyValueScope } from '../../kv/KeyValue.js';
 import { Logger } from '../../observability/logging/Logger.js';
 import { CredentialsProvider } from '../http/versori/contextcredentials.js';
 import { ArrayTask, Task, Taskable, TaskType } from '../Task.js';
-import { ActivationImpl } from '../../context/ActivationImpl.js';
-import { FetchLike } from '../../connection/types.js';
+/**
+ * HttpContext extends the standard {@link Context} with HTTP-specific functionality including an authenticated
+ * `fetch` function and connection variables.
+ *
+ * @template Data The type of data being processed by the workflow.
+ * @template PageParams Optional pagination parameters type.
+ */
 export interface HttpContext<Data, PageParams = undefined> extends Context<Data> {
+    /**
+     * An authenticated fetch function preconfigured with the base URL and authentication from the connection
+     * configuration.
+     */
     fetch: typeof fetch;
+    /**
+     * Variables configured for this connection, which can include dynamic values set by the user.
+     */
     connectionVariables: Record<string, any>;
+    /**
+     * Current pagination parameters when using pagination.
+     */
     pageParams?: PageParams;
+    /**
+     * Function to trigger the next page of results when using pagination.
+     *
+     * @param nextParams The parameters for the next page.
+     */
     nextPage: (nextParams: PageParams) => Promise<void>;
+    /**
+     * The base URL for the connection, resolved asynchronously.
+     */
     baseUrl: Promise<string>;
 }
+/**
+ * HttpContextFunc is the function signature for HTTP task implementations.
+ *
+ * @template In The input type expected by the function.
+ * @template Out The output type produced by the function.
+ * @template PageParams Optional pagination parameters type.
+ */
 export type HttpContextFunc<In, Out, PageParams> = (ctx: HttpContext<In, PageParams>) => Promise<Out>;
+/**
+ * PaginateOptions configures pagination for an HTTP task.
+ *
+ * @template P The type of pagination parameters.
+ */
 export type PaginateOptions<P> = {
+    /**
+     * The initial pagination parameters to start with.
+     */
     initialParams: P;
 };
-export type HttpOptions<In, Out, PageParams> = {
+/**
+ * HttpOptions configures an HTTP task with connection and pagination settings.
+ *
+ * @template PageParams Optional pagination parameters type.
+ */
+export type HttpOptions<PageParams> = {
+    /**
+     * The name of the connection to use for authentication and base URL configuration.
+     */
     connection: string;
+    /**
+     * Optional pagination configuration.
+     */
     pagination?: PaginateOptions<PageParams>;
 };
 export declare class HttpTaskImpl<In, Out, PageParams> implements Task<In, Out> {
     [TaskType]: string;
     id: string;
     fn: HttpContextFunc<In, Out, PageParams>;
-    opts: HttpOptions<In, Out, PageParams>;
-    constructor(id: string, opts: HttpOptions<In, Out, PageParams>, fn: HttpContextFunc<In, Out, PageParams>);
+    opts: HttpOptions<PageParams>;
+    constructor(id: string, opts: HttpOptions<PageParams>, fn: HttpContextFunc<In, Out, PageParams>);
     then<NextOut>(task: Taskable<Out, NextOut>): Task<In, NextOut>;
     catch<NextOut>(task: Taskable<Error, NextOut>): Task<In, NextOut>;
     background(): Task<In, void>;
@@ -61,5 +112,30 @@ export declare class HttpContextImpl<D, PageParams> implements HttpContext<D, Pa
     request(): express.Request | undefined;
     workflowClient(): WorkflowInterface;
 }
-export declare function http<In = any, Out = any, PageParams = unknown>(taskId: string, opts: HttpOptions<In, Out, PageParams>, fn: HttpContextFunc<In, Out, PageParams>): Task<In, Out>;
+/**
+ * Create a task that makes HTTP requests using an authenticated connection.
+ *
+ * The provided function receives an {@link HttpContext} with a pre-configured `fetch` function that includes
+ * authentication and the base URL from the specified connection. This is the primary way to interact with external
+ * APIs in Versori workflows.
+ *
+ * @template In The input type expected by the function.
+ * @template Out The output type produced by the function.
+ * @template PageParams Optional pagination parameters type.
+ * @param taskId A unique identifier for this task.
+ * @param opts Configuration including the connection name and optional pagination settings.
+ * @param fn The function to execute, which receives an HTTP context.
+ * @returns A task that can be chained in a workflow.
+ *
+ * @example
+ * ```typescript
+ * import { http } from '@versori/run';
+ *
+ * const fetchUsers = http('get-users', { connection: 'my-api' }, async ({ fetch }) => {
+ *   const response = await fetch('/users');
+ *   return response.json();
+ * });
+ * ```
+ */
+export declare function http<In = any, Out = any, PageParams = unknown>(taskId: string, opts: HttpOptions<PageParams>, fn: HttpContextFunc<In, Out, PageParams>): Task<In, Out>;
 //# sourceMappingURL=HttpTask.d.ts.map

package/esm/src/dsl/tasks/HttpTask.d.ts.map

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

package/esm/src/dsl/tasks/HttpTask.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");
@@ -147,6 +159,31 @@ export class HttpContextImpl {
     }
 }
 _HttpContextImpl_inner = new WeakMap();
+/**
+ * Create a task that makes HTTP requests using an authenticated connection.
+ *
+ * The provided function receives an {@link HttpContext} with a pre-configured `fetch` function that includes
+ * authentication and the base URL from the specified connection. This is the primary way to interact with external
+ * APIs in Versori workflows.
+ *
+ * @template In The input type expected by the function.
+ * @template Out The output type produced by the function.
+ * @template PageParams Optional pagination parameters type.
+ * @param taskId A unique identifier for this task.
+ * @param opts Configuration including the connection name and optional pagination settings.
+ * @param fn The function to execute, which receives an HTTP context.
+ * @returns A task that can be chained in a workflow.
+ *
+ * @example
+ * ```typescript
+ * import { http } from '@versori/run';
+ *
+ * const fetchUsers = http('get-users', { connection: 'my-api' }, async ({ fetch }) => {
+ *   const response = await fetch('/users');
+ *   return response.json();
+ * });
+ * ```
+ */
 export function http(taskId, opts, fn) {
     return new HttpTaskImpl(taskId, opts, fn);
 }

package/esm/src/dsl/tasks/ParallelTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParallelTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/ParallelTask.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMjE;;;;GAIG;AACH,qBAAa,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,SAAS,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,CAClF,YAAW,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;IAE9B,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAc;IAEhC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzB,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBAEtB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IAKrE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIpE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,QAAQ,GAAG,OAAO,KAAK,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC;IACrD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC;IAWlF,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;CAG/B"}
+{"version":3,"file":"ParallelTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/ParallelTask.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMjE;;;;GAIG;AACH,qBAAa,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,SAAS,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,CAClF,YAAW,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAc;IAEhC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzB,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBAEtB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IAKrE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIpE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,QAAQ,GAAG,OAAO,KAAK,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC;IACrD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC;IAWlF,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;CAG/B"}

package/esm/src/dsl/tasks/ParallelTask.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 _a;
 import { ensureTask } from '../ensureTask.js';
 import { TaskType } from '../Task.js';

package/esm/src/dsl/tasks/SerialTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SerialTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/SerialTask.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMjE;;;;GAIG;AACH,qBAAa,UAAU,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,SAAS,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,CAChF,YAAW,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;IAE9B,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAY;IAE9B,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzB,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBAEtB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IAKrE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIpE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,QAAQ,GAAG,OAAO,KAAK,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC;IACrD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC;IAWlF,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;CAG/B"}
+{"version":3,"file":"SerialTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/SerialTask.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMjE;;;;GAIG;AACH,qBAAa,UAAU,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,SAAS,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,CAChF,YAAW,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAY;IAE9B,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzB,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBAEtB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IAKrE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIpE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,QAAQ,GAAG,OAAO,KAAK,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC;IACrD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC;IAWlF,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;CAM/B"}

package/esm/src/dsl/tasks/SerialTask.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 _a;
 import { ensureTask } from '../ensureTask.js';
 import { TaskType } from '../Task.js';

package/esm/src/dsl/tasks/UnpackTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UnpackTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/UnpackTask.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAOjE,qBAAa,UAAU,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,GAAG,GAAG,CAC9C,YAAW,SAAS,CAAC,EAAE,EAAE,WAAW,CAAC;IAErC,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAY;IAE9B,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAErB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,WAAW,EAAE,CAAC;gBAE3B,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;gBACnB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,WAAW,EAAE;IAMrE,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;IAIpF,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;IAIlF,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIxE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,QAAQ,GAAG,WAAW,KAAK,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC;IACzD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC;IAWtF,KAAK;CAOR"}
+{"version":3,"file":"UnpackTask.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/UnpackTask.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAOjE,qBAAa,UAAU,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,GAAG,GAAG,CAAE,YAAW,SAAS,CAAC,EAAE,EAAE,WAAW,CAAC;IACrF,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAY;IAE9B,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAErB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,WAAW,EAAE,CAAC;gBAE3B,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;gBACnB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,WAAW,EAAE;IAMrE,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;IAIpF,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC;IAIlF,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIxE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;IAIjE,UAAU,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;IAI5B,MAAM,CAAC,QAAQ,GAAG,WAAW,KAAK,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC;IACzD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC;IAWtF,KAAK;CAOR"}

package/esm/src/dsl/tasks/UnpackTask.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 _a;
 import { ensureTask } from '../ensureTask.js';
 import { TaskType } from '../Task.js';

package/esm/src/dsl/tasks/mod.d.ts

@@ -1,11 +1,3 @@
 export { fn } from './FnTask.js';
-export { http } from './HttpTask.js';
-export type { HttpContext, HttpContextFunc, HttpOptions, PaginateOptions, } from './HttpTask.js';
-export type { BackgroundTask } from './BackgroundTask.js';
-export type { CatchTask } from './CatchTask.js';
-export type { ChainTask } from './ChainTask.js';
-export type { FnTask } from './FnTask.js';
-export type { ParallelTask } from './ParallelTask.js';
-export type { SerialTask } from './SerialTask.js';
-export type { UnpackTask } from './UnpackTask.js';
+export { http, type HttpContext, type HttpContextFunc, type HttpOptions, type PaginateOptions, } from './HttpTask.js';
 //# sourceMappingURL=mod.d.ts.map

package/esm/src/dsl/tasks/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/mod.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGrC,YAAY,EACR,WAAW,EACX,eAAe,EACf,WAAW,EACX,eAAe,GAClB,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/tasks/mod.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EACH,IAAI,EACJ,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,GACvB,MAAM,eAAe,CAAC"}

package/esm/src/dsl/tasks/mod.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.
+ */
 // Re-export task functions
 export { fn } from './FnTask.js';
-export { http } from './HttpTask.js';
+export { http, } from './HttpTask.js';

package/esm/src/dsl/triggers/DurableTrigger.d.ts

@@ -1,10 +1,24 @@
-import { Taskable } from '../mod.js';
+import { Taskable } from '../Task.js';
 import { Trigger, TriggerType } from '../Trigger.js';
 import { Workflow } from '../Workflow.js';
+/**
+ * DurableWorkflowOptions configures durable workflow execution behavior including TTL, concurrency limits, and retry
+ * attempts.
+ */
 export type DurableWorkflowOptions = {
+    /**
+     * Time-to-live in seconds for workflow instances in the queue.
+     */
     ttl?: number;
+    /**
+     * Maximum number of concurrent workflow instances allowed.
+     */
     limit?: number;
 };
+/**
+ * DurableWorkflowData is the type of data passed to durable workflow tasks. The data structure is determined by
+ * what's passed when starting the workflow via `ctx.start()`.
+ */
 export type DurableWorkflowData = Record<string, unknown>;
 export declare class DurableWorkflowTrigger implements Trigger<DurableWorkflowData> {
     id: string;
@@ -13,5 +27,28 @@ export declare class DurableWorkflowTrigger implements Trigger<DurableWorkflowDa
     constructor(id: string, options?: DurableWorkflowOptions);
     then<OO>(task: Taskable<DurableWorkflowData, OO>): Workflow<OO>;
 }
+/**
+ * Create a durable workflow that can be started programmatically from other workflows.
+ *
+ * Durable workflows are designed for long-running processes and can be started using `ctx.start()` from within
+ * another workflow. They are queued and executed asynchronously, with support for retries, TTL, and concurrency
+ * limits. This trigger requires the {@link DurableInterpreter} instead of {@link MemoryInterpreter}.
+ *
+ * @param id A unique identifier for this workflow, used when calling `ctx.start(id, options)`.
+ * @param options Optional configuration for TTL, concurrency limits, and retry behavior.
+ * @returns A trigger that can be used to create a durable workflow.
+ *
+ * @example
+ * ```typescript
+ * import { workflow, fn } from '@versori/run';
+ *
+ * const processOrder = workflow('process-order', { maxAttempts: 3 })
+ *   .then(fn('process', async (ctx) => {
+ *     const order = ctx.data;
+ *     ctx.log.info('Processing order', { order });
+ *     // ... long-running process
+ *   }));
+ * ```
+ */
 export declare function workflow(id: string, options?: DurableWorkflowOptions): Trigger<DurableWorkflowData>;
 //# sourceMappingURL=DurableTrigger.d.ts.map

package/esm/src/dsl/triggers/DurableTrigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DurableTrigger.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/triggers/DurableTrigger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAgB,MAAM,gBAAgB,CAAC;AAExD,MAAM,MAAM,sBAAsB,GAAG;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1D,qBAAa,sBAAuB,YAAW,OAAO,CAAC,mBAAmB,CAAC;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,sBAAsB,CAAC;IAEhC,CAAC,WAAW,CAAC,EAAE,MAAM,CAAqB;gBAE9B,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B;IAK5D,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,mBAAmB,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;CAIlE;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAEnG"}
+{"version":3,"file":"DurableTrigger.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/triggers/DurableTrigger.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAgB,MAAM,gBAAgB,CAAC;AAExD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1D,qBAAa,sBAAuB,YAAW,OAAO,CAAC,mBAAmB,CAAC;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,sBAAsB,CAAC;IAEhC,CAAC,WAAW,CAAC,EAAE,MAAM,CAAqB;gBAE9B,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B;IAK5D,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,mBAAmB,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;CAGlE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CACpB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,sBAAsB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAE9B"}

package/esm/src/dsl/triggers/DurableTrigger.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 _a;
 import { ensureTask } from '../ensureTask.js';
 import { TriggerType } from '../Trigger.js';
@@ -30,7 +42,29 @@ export class DurableWorkflowTrigger {
     }
 }
 _a = TriggerType;
-;
+/**
+ * Create a durable workflow that can be started programmatically from other workflows.
+ *
+ * Durable workflows are designed for long-running processes and can be started using `ctx.start()` from within
+ * another workflow. They are queued and executed asynchronously, with support for retries, TTL, and concurrency
+ * limits. This trigger requires the {@link DurableInterpreter} instead of {@link MemoryInterpreter}.
+ *
+ * @param id A unique identifier for this workflow, used when calling `ctx.start(id, options)`.
+ * @param options Optional configuration for TTL, concurrency limits, and retry behavior.
+ * @returns A trigger that can be used to create a durable workflow.
+ *
+ * @example
+ * ```typescript
+ * import { workflow, fn } from '@versori/run';
+ *
+ * const processOrder = workflow('process-order', { maxAttempts: 3 })
+ *   .then(fn('process', async (ctx) => {
+ *     const order = ctx.data;
+ *     ctx.log.info('Processing order', { order });
+ *     // ... long-running process
+ *   }));
+ * ```
+ */
 export function workflow(id, options) {
     return new DurableWorkflowTrigger(id, options);
 }