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

package/esm/src/dsl/http/versori/kvapi/services/KvOperationsService.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.
+ */
 import { OpenAPI } from '../core/OpenAPI.js';
 import { request as __request } from '../core/request.js';
 export class KvOperationsService {

package/esm/src/dsl/http/versori/kvapi/services/QueryOperationsService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueryOperationsService.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/dsl/http/versori/kvapi/services/QueryOperationsService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,qBAAa,sBAAsB;IAC/B;;;;;;OAMG;WACW,MAAM,CAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,aAAa,GAC3B,iBAAiB,CAAC,cAAc,CAAC;IAWpC;;;;;;OAMG;WACW,OAAO,CACjB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,cAAc,GAC5B,iBAAiB,CAAC,eAAe,CAAC;CAWxC"}
+{"version":3,"file":"QueryOperationsService.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/dsl/http/versori/kvapi/services/QueryOperationsService.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,qBAAa,sBAAsB;IAC/B;;;;;;OAMG;WACW,MAAM,CAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,aAAa,GAC3B,iBAAiB,CAAC,cAAc,CAAC;IAWpC;;;;;;OAMG;WACW,OAAO,CACjB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,cAAc,GAC5B,iBAAiB,CAAC,eAAe,CAAC;CAWxC"}

package/esm/src/dsl/http/versori/kvapi/services/QueryOperationsService.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.
+ */
 import { OpenAPI } from '../core/OpenAPI.js';
 import { request as __request } from '../core/request.js';
 export class QueryOperationsService {

package/esm/src/dsl/http/versori/kvapi/services/StoresService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StoresService.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/dsl/http/versori/kvapi/services/StoresService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,qBAAa,aAAa;IACtB;;;;;OAKG;WACW,WAAW,CACrB,WAAW,EAAE,kBAAkB,GAChC,iBAAiB,CAAC,mBAAmB,CAAC;IAQzC;;;;;OAKG;WACW,UAAU,CACpB,KAAK,EAAE,MAAM,GACd,iBAAiB,CAAC,kBAAkB,CAAC;CAS3C"}
+{"version":3,"file":"StoresService.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/dsl/http/versori/kvapi/services/StoresService.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,qBAAa,aAAa;IACtB;;;;;OAKG;WACW,WAAW,CACrB,WAAW,EAAE,kBAAkB,GAChC,iBAAiB,CAAC,mBAAmB,CAAC;IAQzC;;;;;OAKG;WACW,UAAU,CACpB,KAAK,EAAE,MAAM,GACd,iBAAiB,CAAC,kBAAkB,CAAC;CAS3C"}

package/esm/src/dsl/http/versori/kvapi/services/StoresService.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.
+ */
 import { OpenAPI } from '../core/OpenAPI.js';
 import { request as __request } from '../core/request.js';
 export class StoresService {

package/esm/src/dsl/http/versori/webhookmiddleware.d.ts

@@ -1,7 +1,7 @@
+import { Logger } from '@versori/run/observability';
+import { PlatformApi } from '@versori/run/services/platform';
 import { NextFunction, Request, Response } from 'express';
 import { ConnectionFactory } from '../../../connection/types.js';
-import { Logger } from '../../../observability/mod.js';
-import { PlatformApi } from '../../../services/platform/mod.js';
 import { ConfigReader } from '../types.js';
 export type CreateWebhookMiddleWareOpts = {
     id: string;

package/esm/src/dsl/http/versori/webhookmiddleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhookmiddleware.d.ts","sourceRoot":"","sources":["../../../../../src/src/dsl/http/versori/webhookmiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAc,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAU3C,MAAM,MAAM,2BAA2B,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,SAAS,EAAE,YAAY,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;CACf,CAAC;AAiCF,wBAAgB,6BAA6B,CACzC,IAAI,EAAE,2BAA2B,GAClC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAkFpE;AAED,wBAAgB,mCAAmC,CAC/C,IAAI,EAAE,2BAA2B,GAClC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CA6DpE;AAED,wBAAgB,oCAAoC,CAChD,IAAI,EAAE,2BAA2B,GAClC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAqFpE"}
+{"version":3,"file":"webhookmiddleware.d.ts","sourceRoot":"","sources":["../../../../../src/src/dsl/http/versori/webhookmiddleware.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAc,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAU3C,MAAM,MAAM,2BAA2B,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,SAAS,EAAE,YAAY,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;CACf,CAAC;AAGF,wBAAgB,6BAA6B,CACzC,IAAI,EAAE,2BAA2B,GAClC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CA4GpE;AAED,wBAAgB,mCAAmC,CAC/C,IAAI,EAAE,2BAA2B,GAClC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAkGpE;AAED,wBAAgB,oCAAoC,CAChD,IAAI,EAAE,2BAA2B,GAClC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAoFpE"}

package/esm/src/dsl/http/versori/webhookmiddleware.js

@@ -1,52 +1,54 @@
-import { enabled as supervisorEnabled } from '../../../internal/supervisor.js';
-// TODO: this gets called for every request for all endpoints, can we cache this?
-async function getStaticActivation(opts) {
-    const { data: activations } = await opts.platformApi.listActivations({
-        path: {
-            organisation_id: opts.organisationId,
-            environment_id: opts.environmentId,
-        },
-        query: {
-            static: true,
-        },
-        throwOnError: true,
-    });
-    let activation;
-    if (activations && activations.length > 0) {
-        if (activations.length > 1) {
-            opts.log.warn('Multiple static activations found, using the first one', {
-                activationsCount: activations.length,
-            });
-        }
-        activation = activations[0];
-    }
-    else {
-        opts.log.error('No static activation found', { webhookId: opts.id });
-    }
-    return activation;
-}
-// TODO: Refactor this so we don't have like three different middlewares for static and dynamic webhooks
+/*
+ * 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 { LRUCache } from 'lru-cache';
 export function createStaticWebhookMiddleware(opts) {
+    // create lru cache for activation
+    const activationCache = new LRUCache({ max: 100, ttl: 5 * 60 * 1000 }); // 5 minute ttl
+    const staticActivationID = "static";
+    const getStaticActivation = (forceFetch = false) => {
+        const cachedActivation = activationCache.get(staticActivationID);
+        if (cachedActivation && !forceFetch) {
+            return cachedActivation;
+        }
+        else {
+            const fetchActivation = async () => {
+                const { data: activations } = await opts.platformApi.listActivations({
+                    path: {
+                        organisation_id: opts.organisationId,
+                        environment_id: opts.environmentId,
+                    },
+                    query: {
+                        static: true,
+                    },
+                    throwOnError: true,
+                });
+                if (activations.length === 0) {
+                    throw new Error('No static activation found');
+                }
+                return activations[0];
+            };
+            const activationPromise = fetchActivation();
+            activationCache.set(staticActivationID, activationPromise);
+            return activationPromise;
+        }
+    };
     if (opts.connName === undefined) {
         opts.log.warn(`No connection ID found for webhook, accepting any requests which is unsecure!`, { webhookId: opts.id });
         return async (_req, res, next) => {
-            try {
-                res.locals.activation = await getStaticActivation(opts);
-            }
-            catch (err) {
-                if (supervisorEnabled) {
-                    res.locals.activation = {};
-                    next();
-                    return;
-                }
-                opts.log.error('Failed to get static activation', { error: err });
-                res.status(500).json({ error: 'Failed to get static activation' });
-                return;
-            }
+            res.locals.activation = await getStaticActivation();
             next();
         };
     }
-    // TODO(@teo): move db access to outside of the middleware??? (genuine question - not instruction)
     return async (req, res, next) => {
         if (!opts.connName) {
             // This is mainly for type safety, but we should never reach this point
@@ -60,11 +62,13 @@ export function createStaticWebhookMiddleware(opts) {
             res.status(500).json({ error: 'Missing connection for webhook' });
             return;
         }
-        const activation = await getStaticActivation(opts);
-        if (!activation) {
-            opts.log.error('No activation found for static webhook', { webhookId: opts.id, connName: opts.connName });
-            res.status(500).json({ error: 'No activation found for static webhook' });
-            return;
+        let activation;
+        try {
+            activation = await getStaticActivation();
+        }
+        catch (err) {
+            opts.log.error('Failed to get static activation', { error: err });
+            activation = await getStaticActivation(true);
         }
         res.locals.activation = activation;
         const { data: cnx } = await opts.platformApi.getConnection({
@@ -74,7 +78,10 @@ export function createStaticWebhookMiddleware(opts) {
             },
         });
         if (!cnx) {
-            opts.log.error(`No connection found for webhook`, { webhookId: opts.id, connName: opts.connName });
+            opts.log.error(`No connection found for webhook`, {
+                webhookId: opts.id,
+                connName: opts.connName,
+            });
             res.status(500).json({ error: 'No connection found for webhook' });
             return;
         }
@@ -84,18 +91,44 @@ export function createStaticWebhookMiddleware(opts) {
     };
 }
 export function createActIdDynamicWebhookMiddleware(opts) {
+    // create lru cache for activation
+    const activationCache = new LRUCache({ max: 100, ttl: 5 * 60 * 1000 }); // 5 minute ttl
+    const getActivation = (activationId, forceFetch = false) => {
+        const cachedActivation = activationCache.get(activationId);
+        if (cachedActivation && !forceFetch) {
+            return cachedActivation;
+        }
+        else {
+            const fetchActivation = async () => {
+                const activation = await opts.platformApi.getActivation({
+                    path: {
+                        organisation_id: opts.organisationId,
+                        environment_id: opts.environmentId,
+                        activation_id: activationId,
+                    },
+                    throwOnError: true,
+                });
+                return activation.data;
+            };
+            const activationPromise = fetchActivation();
+            activationCache.set(activationId, activationPromise);
+            return activationPromise;
+        }
+    };
     if (!opts.connName) {
         opts.log.warn(`No template ID found for webhook, accepting any requests which is unsecure!`, { webhookId: opts.id });
         return async (req, res, next) => {
             const activationId = req.params.activationId;
-            const activation = await opts.platformApi.getActivation({
-                path: {
-                    organisation_id: opts.organisationId,
-                    environment_id: opts.environmentId,
-                    activation_id: activationId,
-                },
-                throwOnError: true,
-            });
+            let activation;
+            try {
+                activation = await await getActivation(activationId);
+                ;
+            }
+            catch (err) {
+                opts.log.error('Failed to get static activation', { error: err });
+                activation = await await getActivation(activationId, true);
+                ;
+            }
             res.locals.activation = activation;
             next();
         };
@@ -109,14 +142,16 @@ export function createActIdDynamicWebhookMiddleware(opts) {
         }
         const templateId = opts.cfgReader.getTemplateID(opts.connName);
         const activationId = req.params.activationId;
-        const activation = await opts.platformApi.getActivation({
-            path: {
-                organisation_id: opts.organisationId,
-                environment_id: opts.environmentId,
-                activation_id: activationId,
-            },
-            throwOnError: true,
-        });
+        let activation;
+        try {
+            activation = await await getActivation(activationId);
+            ;
+        }
+        catch (err) {
+            opts.log.error('Failed to get static activation', { error: err });
+            activation = await await getActivation(activationId, true);
+            ;
+        }
         const conn = await opts.platformApi.getActivationConnection({
             path: {
                 organisation_id: opts.organisationId,

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

@@ -1,4 +1,20 @@
-export type { Task, Taskable, ArrayTask, } from './Task.js';
+/**
+ * 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';
+export type { Trigger } from './Trigger.js';
+export type { Task, Taskable, TaskType } from './Task.js';
+export type { Workflow } from './Workflow.js';
 //# sourceMappingURL=mod.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/dsl/mod.ts"],"names":[],"mappings":"AACA,YAAY,EACR,IAAI,EACJ,QAAQ,EACR,SAAS,GACZ,MAAM,WAAW,CAAC;AAGnB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/dsl/mod.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;GAYG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAElC,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1D,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

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);
 }