@versori/run 0.4.0-alpha.1 → 0.4.0-alpha.11

package/script/src/dsl/tasks/HttpTask.js

@@ -1,4 +1,16 @@
 "use strict";
+/*
+ * 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,9 +159,37 @@ class HttpContextImpl {
     request() {
         return __classPrivateFieldGet(this, _HttpContextImpl_inner, "f").request();
     }
+    workflowClient() {
+        return __classPrivateFieldGet(this, _HttpContextImpl_inner, "f").workflowClient();
+    }
 }
 exports.HttpContextImpl = 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();
+ * });
+ * ```
+ */
 function http(taskId, opts, fn) {
     return new HttpTaskImpl(taskId, opts, fn);
 }

package/script/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/script/src/dsl/tasks/ParallelTask.js

@@ -1,4 +1,16 @@
 "use strict";
+/*
+ * 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;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ParallelTask = void 0;

package/script/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/script/src/dsl/tasks/SerialTask.js

@@ -1,4 +1,16 @@
 "use strict";
+/*
+ * 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;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SerialTask = void 0;

package/script/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/script/src/dsl/tasks/UnpackTask.js

@@ -1,4 +1,16 @@
 "use strict";
+/*
+ * 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;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UnpackTask = void 0;

package/script/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/script/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/script/src/dsl/tasks/mod.js

@@ -1,4 +1,16 @@
 "use strict";
+/*
+ * 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.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.http = exports.fn = void 0;
 // Re-export task functions

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

@@ -1,11 +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;
-    maxAttempts?: 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;
@@ -14,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/script/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;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,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/script/src/dsl/triggers/DurableTrigger.js

@@ -1,4 +1,16 @@
 "use strict";
+/*
+ * 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;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DurableWorkflowTrigger = void 0;
@@ -35,7 +47,29 @@ class DurableWorkflowTrigger {
 }
 exports.DurableWorkflowTrigger = DurableWorkflowTrigger;
 _a = Trigger_js_1.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
+ *   }));
+ * ```
+ */
 function workflow(id, options) {
     return new DurableWorkflowTrigger(id, options);
 }

package/script/src/dsl/triggers/ScheduleTrigger.d.ts

@@ -2,8 +2,19 @@ import { Activation } from '../http/types.js';
 import { Taskable } from '../Task.js';
 import { Trigger, TriggerType } from '../Trigger.js';
 import { Workflow } from '../Workflow.js';
+/**
+ * ScheduleData is the type of data passed to tasks triggered by a schedule. It's always an empty object.
+ */
 export type ScheduleData = Record<string, never>;
+/**
+ * PrebuiltPredicate represents built-in activation predicates. Currently only 'all' is supported, which runs the
+ * workflow for all user activations.
+ */
 export type PrebuiltPredicate = 'all';
+/**
+ * ActivationPredicate determines which user activations should trigger the workflow. Can be either a built-in
+ * predicate like 'all', or a custom function that receives an activation and returns a boolean.
+ */
 export type ActivationPredicate = PrebuiltPredicate | ((a?: Activation) => boolean);
 export declare class ScheduleTrigger implements Trigger<ScheduleData> {
     id: string;
@@ -12,7 +23,30 @@ export declare class ScheduleTrigger implements Trigger<ScheduleData> {
     activationPredicate?: ActivationPredicate;
     constructor(id: string, schedule: string, activationPredicate?: ActivationPredicate);
     then<OO>(task: Taskable<ScheduleData, OO>): Workflow<OO>;
-    catch<OO>(error: any): Workflow<OO>;
+    catch<OO>(_error: any): Workflow<OO>;
 }
+/**
+ * Create a workflow that executes on a cron schedule.
+ *
+ * The schedule is defined using cron syntax, which allows for flexible scheduling patterns. The workflow will execute
+ * at the specified intervals. Optionally, you can provide an activation predicate to control which user activations
+ * should trigger the workflow.
+ *
+ * @param id A unique identifier for this workflow.
+ * @param schedule A cron expression defining when the workflow should run (e.g., '0 0 * * *' for daily at midnight).
+ * @param activationPredicate Optional predicate to filter which activations should trigger this workflow.
+ * @returns A workflow that will execute on the specified schedule.
+ *
+ * @example
+ * ```typescript
+ * import { schedule, fn } from '@versori/run';
+ *
+ * const dailySync = schedule('daily-sync', '0 0 * * *')
+ *   .then(fn('sync', async (ctx) => {
+ *     ctx.log.info('Running daily sync');
+ *     // ... sync logic
+ *   }));
+ * ```
+ */
 export declare function schedule(id: string, schedule: string, activationPredicate?: ActivationPredicate): Workflow<ScheduleData>;
 //# sourceMappingURL=ScheduleTrigger.d.ts.map

package/script/src/dsl/triggers/ScheduleTrigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScheduleTrigger.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/triggers/ScheduleTrigger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,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,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEtC,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC;AAEpF,qBAAa,eAAgB,YAAW,OAAO,CAAC,YAAY,CAAC;IACzD,EAAE,EAAE,MAAM,CAAC;IAEX,CAAC,WAAW,CAAC,EAAE,MAAM,CAAc;IAEnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;gBAE9B,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,mBAAmB;IAMnF,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;IAIxD,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC;CAGtC;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,QAAQ,CAAC,YAAY,CAAC,CAExH"}
+{"version":3,"file":"ScheduleTrigger.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/triggers/ScheduleTrigger.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,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;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEtC;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC;AAEpF,qBAAa,eAAgB,YAAW,OAAO,CAAC,YAAY,CAAC;IACzD,EAAE,EAAE,MAAM,CAAC;IAEX,CAAC,WAAW,CAAC,EAAE,MAAM,CAAc;IAEnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;gBAE9B,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,mBAAmB;IAMnF,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;IAIxD,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC;CAGvC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CACpB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,mBAAmB,CAAC,EAAE,mBAAmB,GAC1C,QAAQ,CAAC,YAAY,CAAC,CAExB"}

package/script/src/dsl/triggers/ScheduleTrigger.js

@@ -1,4 +1,16 @@
 "use strict";
+/*
+ * 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;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ScheduleTrigger = void 0;
@@ -39,12 +51,35 @@ class ScheduleTrigger {
     then(task) {
         return new Workflow_js_1.WorkflowImpl(this, (0, ensureTask_js_1.ensureTask)(task));
     }
-    catch(error) {
+    catch(_error) {
         return this;
     }
 }
 exports.ScheduleTrigger = ScheduleTrigger;
 _a = Trigger_js_1.TriggerType;
+/**
+ * Create a workflow that executes on a cron schedule.
+ *
+ * The schedule is defined using cron syntax, which allows for flexible scheduling patterns. The workflow will execute
+ * at the specified intervals. Optionally, you can provide an activation predicate to control which user activations
+ * should trigger the workflow.
+ *
+ * @param id A unique identifier for this workflow.
+ * @param schedule A cron expression defining when the workflow should run (e.g., '0 0 * * *' for daily at midnight).
+ * @param activationPredicate Optional predicate to filter which activations should trigger this workflow.
+ * @returns A workflow that will execute on the specified schedule.
+ *
+ * @example
+ * ```typescript
+ * import { schedule, fn } from '@versori/run';
+ *
+ * const dailySync = schedule('daily-sync', '0 0 * * *')
+ *   .then(fn('sync', async (ctx) => {
+ *     ctx.log.info('Running daily sync');
+ *     // ... sync logic
+ *   }));
+ * ```
+ */
 function schedule(id, schedule, activationPredicate) {
     return new ScheduleTrigger(id, schedule, activationPredicate);
 }

package/script/src/dsl/triggers/WebhookTrigger.d.ts

@@ -2,14 +2,40 @@ import { Context } from '../../context/Context.js';
 import { Taskable } from '../Task.js';
 import { Trigger, TriggerType } from '../Trigger.js';
 import { Workflow } from '../Workflow.js';
+/**
+ * WebhookData is the type of data passed to tasks triggered by a webhook. The actual request data is available
+ * through the context.
+ */
 export type WebhookData = Record<string, never>;
+/**
+ * WebhookCorsOptions configures Cross-Origin Resource Sharing (CORS) for webhook endpoints. Can be a boolean to
+ * enable/disable CORS with defaults, or an object with detailed CORS configuration.
+ */
 export type WebhookCorsOptions = boolean | {
+    /**
+     * The allowed origin(s) for CORS requests.
+     */
     origin: string;
+    /**
+     * The allowed HTTP methods.
+     */
     methods: string[];
+    /**
+     * The allowed request headers.
+     */
     allowedHeaders: string[];
+    /**
+     * The headers exposed in the response.
+     */
     exposedHeaders: string[];
+    /**
+     * Whether to allow credentials in CORS requests.
+     */
     credentials: boolean;
 };
+/**
+ * WebhookRequestOptions configures how webhook requests are processed.
+ */
 export type WebhookRequestOptions = {
     /**
      * If true, the raw body of the request will be passed to the context. Users will need to
@@ -18,6 +44,9 @@ export type WebhookRequestOptions = {
      */
     rawBody?: boolean;
 };
+/**
+ * WebhookResponseOptions configures how webhook responses are sent to clients.
+ */
 export type WebhookResponseOptions = {
     /**
      * Mode determines how the response is sent to the client. The response can be customized by
@@ -48,11 +77,29 @@ export type WebhookResponseOptions = {
      */
     onError?: <T>(ctx: Context<T>) => Response;
 };
+/**
+ * WebhookOptions configures a webhook trigger with CORS, response handling, and HTTP method settings.
+ */
 export type WebhookOptions = {
+    /**
+     * CORS configuration for the webhook endpoint.
+     */
     cors?: WebhookCorsOptions;
+    /**
+     * Response handling configuration.
+     */
     response?: WebhookResponseOptions;
+    /**
+     * Optional connection to use for verifying webhook signatures or authentication.
+     */
     connection?: string;
-    method?: "all" | "get" | "post" | "put" | "delete" | "patch" | "options" | "head";
+    /**
+     * The HTTP method(s) to accept. Defaults to 'all'.
+     */
+    method?: 'all' | 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';
+    /**
+     * Request processing configuration.
+     */
     request?: WebhookRequestOptions;
 };
 export declare class WebhookTrigger implements Trigger<WebhookData> {
@@ -62,5 +109,28 @@ export declare class WebhookTrigger implements Trigger<WebhookData> {
     constructor(id: string, options?: WebhookOptions);
     then<OO>(task: Taskable<WebhookData, OO>): Workflow<OO>;
 }
+/**
+ * Create a workflow that is triggered by incoming HTTP webhook requests.
+ *
+ * Webhook workflows create an HTTP endpoint that can receive requests from external systems. The request data is
+ * available through the context object. You can configure CORS, response handling, HTTP methods, and request
+ * processing options.
+ *
+ * @param id A unique identifier for this workflow, which will be used in the webhook URL path.
+ * @param options Optional configuration for CORS, response handling, and request processing.
+ * @returns A trigger that can be used to create a workflow.
+ *
+ * @example
+ * ```typescript
+ * import { webhook, fn } from '@versori/run';
+ *
+ * const handleWebhook = webhook('github-push', { method: 'post' })
+ *   .then(fn('process-push', async (ctx) => {
+ *     const payload = ctx.data;
+ *     ctx.log.info('Received push event', { payload });
+ *     // ... process webhook
+ *   }));
+ * ```
+ */
 export declare function webhook(id: string, options?: WebhookOptions): Trigger<WebhookData>;
 //# sourceMappingURL=WebhookTrigger.d.ts.map

package/script/src/dsl/triggers/WebhookTrigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebhookTrigger.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/triggers/WebhookTrigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnD,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,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEhD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACxB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACjC;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAExB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;IAE7C;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;CAC9C,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAClF,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACnC,CAAA;AAED,qBAAa,cAAe,YAAW,OAAO,CAAC,WAAW,CAAC;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IAExB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAa;gBAEtB,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB;IAOpD,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;CAK1D;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAElF"}
+{"version":3,"file":"WebhookTrigger.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/triggers/WebhookTrigger.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnD,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,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG;IACvC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB;;OAEG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAExB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;IAE7C;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;CAC9C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAElC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAElF;;OAEG;IACH,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACnC,CAAC;AAEF,qBAAa,cAAe,YAAW,OAAO,CAAC,WAAW,CAAC;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IAExB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAa;gBAEtB,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB;IAKpD,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;CAG1D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAElF"}

package/script/src/dsl/triggers/WebhookTrigger.js

@@ -1,4 +1,16 @@
 "use strict";
+/*
+ * 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;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebhookTrigger = void 0;
@@ -28,15 +40,36 @@ class WebhookTrigger {
         });
         this.id = id;
         this.options = options;
-        this.then = this.then.bind(this);
     }
     then(task) {
-        const actualTask = (0, ensureTask_js_1.ensureTask)(task);
-        return new Workflow_js_1.WorkflowImpl(this, actualTask);
+        return new Workflow_js_1.WorkflowImpl(this, (0, ensureTask_js_1.ensureTask)(task));
     }
 }
 exports.WebhookTrigger = WebhookTrigger;
 _a = Trigger_js_1.TriggerType;
+/**
+ * Create a workflow that is triggered by incoming HTTP webhook requests.
+ *
+ * Webhook workflows create an HTTP endpoint that can receive requests from external systems. The request data is
+ * available through the context object. You can configure CORS, response handling, HTTP methods, and request
+ * processing options.
+ *
+ * @param id A unique identifier for this workflow, which will be used in the webhook URL path.
+ * @param options Optional configuration for CORS, response handling, and request processing.
+ * @returns A trigger that can be used to create a workflow.
+ *
+ * @example
+ * ```typescript
+ * import { webhook, fn } from '@versori/run';
+ *
+ * const handleWebhook = webhook('github-push', { method: 'post' })
+ *   .then(fn('process-push', async (ctx) => {
+ *     const payload = ctx.data;
+ *     ctx.log.info('Received push event', { payload });
+ *     // ... process webhook
+ *   }));
+ * ```
+ */
 function webhook(id, options) {
     return new WebhookTrigger(id, options);
 }

package/script/src/dsl/triggers/mod.d.ts

@@ -1,6 +1,4 @@
-export type * from './ScheduleTrigger.js';
-export type * from './WebhookTrigger.js';
-export { schedule } from './ScheduleTrigger.js';
-export { webhook } from './WebhookTrigger.js';
-export { workflow } from './DurableTrigger.js';
+export { type ActivationPredicate, type PrebuiltPredicate, schedule, type ScheduleData, } from './ScheduleTrigger.js';
+export { webhook, type WebhookCorsOptions, type WebhookData, type WebhookOptions, type WebhookRequestOptions, type WebhookResponseOptions, } from './WebhookTrigger.js';
+export { type DurableWorkflowData, type DurableWorkflowOptions, workflow, } from './DurableTrigger.js';
 //# sourceMappingURL=mod.d.ts.map

package/script/src/dsl/triggers/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/triggers/mod.ts"],"names":[],"mappings":"AAAA,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,qBAAqB,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/dsl/triggers/mod.ts"],"names":[],"mappings":"AAaA,OAAO,EACH,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,QAAQ,EACR,KAAK,YAAY,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,OAAO,EACP,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,QAAQ,GACX,MAAM,qBAAqB,CAAC"}

package/script/src/dsl/triggers/mod.js

@@ -1,4 +1,16 @@
 "use strict";
+/*
+ * 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.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.workflow = exports.webhook = exports.schedule = void 0;
 var ScheduleTrigger_js_1 = require("./ScheduleTrigger.js");

package/script/src/internal/InternalAuth.d.ts

@@ -5,7 +5,9 @@ export declare class InternalAuth {
     private clientId;
     private clientSecret;
     private tokenEndpoint;
+    private runLocal;
     private accessToken;
+    private jwt;
     private expiresAt;
     constructor();
     getAuthHeader(): Promise<internalAuthHeader>;

package/script/src/internal/InternalAuth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InternalAuth.d.ts","sourceRoot":"","sources":["../../../src/src/internal/InternalAuth.ts"],"names":[],"mappings":"AAOA,KAAK,kBAAkB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAEpD,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAS;IAE9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;;IA2BpB,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAsBrD"}
+{"version":3,"file":"InternalAuth.d.ts","sourceRoot":"","sources":["../../../src/src/internal/InternalAuth.ts"],"names":[],"mappings":"AAuBA,KAAK,kBAAkB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAEpD,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAU;IAE1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,SAAS,CAAS;;IA6CpB,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC;CA8BrD"}