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

package/script/src/kv/KVNotFoundError.js

@@ -1,7 +1,29 @@
 "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.KVNotFoundError = void 0;
+/**
+ * KVNotFoundError is thrown when attempting to get a key that doesn't exist in the key-value store with the
+ * `throwOnNotFound` option set to true.
+ */
 class KVNotFoundError extends Error {
+    /**
+     * Create a new KVNotFoundError.
+     *
+     * @param key The key that was not found.
+     * @param opts Optional error options.
+     */
     constructor(key, opts) {
         super(`KVNotFoundError: ${key}`, opts);
         Object.defineProperty(this, "key", {

package/script/src/kv/KeyValue.d.ts

@@ -1,4 +1,4 @@
-import { ListKVRequest, ListKVResponse, CountKVResponse } from '../dsl/http/versori/kvapi/index.js';
+import { CountKVResponse, ListKVRequest, ListKVResponse } from '../dsl/http/versori/kvapi/index.js';
 type GetOptionsMaybeDefault<T> = {
     defaultValue?: T;
     throwOnNotFound?: false;
@@ -10,37 +10,106 @@ type GetOptionsWithDefault<T> = {
 type GetOptionsWithThrow<T> = {
     throwOnNotFound: true;
 };
+/**
+ * GetOptions configures the behavior of {@link KeyValue.get} operations, including default values and error handling.
+ *
+ * @template T The expected type of the value.
+ */
 export type GetOptions<T> = GetOptionsMaybeDefault<T> | GetOptionsWithDefault<T> | GetOptionsWithThrow<T>;
+/**
+ * KeyValue provides a simple key-value storage interface for workflow data. Values are automatically JSON serialized
+ * and deserialized. The storage scope is determined when opening the KV store via `ctx.openKv()`.
+ */
 export interface KeyValue {
+    /**
+     * Get a value from the key-value store.
+     *
+     * @template T The expected type of the value.
+     * @param key The key or key path as a string or array of strings.
+     * @param options Options controlling default values and error behavior.
+     * @returns The value, or undefined if not found (unless throwOnNotFound or defaultValue is set).
+     * @throws {KVNotFoundError} if throwOnNotFound is true and the key doesn't exist.
+     */
     get<T = any>(key: string | string[], options: GetOptionsWithDefault<T> | GetOptionsWithThrow<T>): Promise<T>;
     get<T = any>(key: string | string[], options?: GetOptionsMaybeDefault<T>): Promise<T | undefined>;
     get<T = any>(key: string | string[], options?: GetOptions<T>): Promise<T | undefined>;
+    /**
+     * Set a value in the key-value store.
+     *
+     * @template T The type of the value to store.
+     * @param key The key or key path as a string or array of strings.
+     * @param value The value to store (will be JSON serialized).
+     */
     set<T>(key: string | string[], value: T): Promise<void>;
+    /**
+     * List all keys with a given prefix.
+     *
+     * @param prefix The key prefix as an array of strings.
+     * @param options Optional pagination and filtering options.
+     * @returns A response containing matching keys.
+     */
     list(prefix: string[], options?: ListKVRequest): Promise<ListKVResponse>;
+    /**
+     * Count the number of keys with a given prefix.
+     *
+     * @param prefix The key prefix as an array of strings.
+     * @returns A response containing the count.
+     */
     count(prefix: string[]): Promise<CountKVResponse>;
+    /**
+     * Delete a key from the key-value store.
+     *
+     * @param key The key or key path as a string or array of strings.
+     */
     delete(key: string | string[]): Promise<void>;
 }
+/**
+ * KeyValueScope determines the visibility and lifetime of key-value data.
+ *
+ * - `:execution:` - Data scoped to a single workflow execution (deleted after execution completes).
+ * - `:project:` - Data scoped to the current project (shared across all executions).
+ * - `:organization:` - Data scoped to the organization (shared across all projects).
+ */
 export type KeyValueScope = ':execution:' | ':project:' | ':organization:';
-type KVOptionsExecution = {
+/**
+ * KVOptionsExecution specifies options for opening an execution-scoped KV store.
+ */
+export type KVOptionsExecution = {
     scope: ':execution:';
     executionId: string;
 };
-export declare function isKVOptionsExecution(options: KVOptions): options is KVOptionsExecution;
-type KVOptionsNotExecution = {
+/**
+ * KVOptionsNotExecution specifies options for opening project or organization-scoped KV stores.
+ */
+export type KVOptionsNotExecution = {
     scope: Exclude<KeyValueScope, ':execution:'>;
 };
+/**
+ * KVOptions configures which KV store to open based on scope and activation.
+ */
 export type KVOptions = (KVOptionsExecution | KVOptionsNotExecution) & {
     activationId?: string;
 };
+/**
+ * DestroyOptions configures which KV store to destroy.
+ */
 export type DestroyOptions = KVOptions;
+/**
+ * KeyValueProvider creates and manages key-value stores at different scopes.
+ */
 export interface KeyValueProvider {
     /**
      * Get a KeyValue store for the given scope.
      *
-     * @param options configures which KV store to open.
-     * @returns A key value store.
+     * @param options Configures which KV store to open.
+     * @returns A key-value store instance.
      */
     kv(options: KVOptions): KeyValue;
+    /**
+     * Destroy a key-value store, deleting all its data.
+     *
+     * @param scope The scope of the KV store to destroy.
+     */
     destroy(scope: DestroyOptions): Promise<void>;
 }
 export {};

package/script/src/kv/KeyValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KeyValue.d.ts","sourceRoot":"","sources":["../../../src/src/kv/KeyValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAEpG,KAAK,sBAAsB,CAAC,CAAC,IAAI;IAC7B,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,eAAe,CAAC,EAAE,KAAK,CAAC;CAC3B,CAAC;AAEF,KAAK,qBAAqB,CAAC,CAAC,IAAI;IAC5B,YAAY,EAAE,CAAC,CAAC;IAChB,eAAe,CAAC,EAAE,KAAK,CAAC;CAC3B,CAAC;AAEF,KAAK,mBAAmB,CAAC,CAAC,IAAI;IAC1B,eAAe,EAAE,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,IAClB,sBAAsB,CAAC,CAAC,CAAC,GACzB,qBAAqB,CAAC,CAAC,CAAC,GACxB,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE7B,MAAM,WAAW,QAAQ;IACrB,GAAG,CAAC,CAAC,GAAG,GAAG,EACP,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EACtB,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,GAC3D,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAClG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAEtF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEzE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAElD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE3E,KAAK,kBAAkB,GAAG;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,SAAS,GACnB,OAAO,IAAI,kBAAkB,CAI/B;AAED,KAAK,qBAAqB,GAAG;IACzB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,kBAAkB,GAAG,qBAAqB,CAAC,GAAG;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC7B;;;;;OAKG;IACH,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC;IAEjC,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD"}
+{"version":3,"file":"KeyValue.d.ts","sourceRoot":"","sources":["../../../src/src/kv/KeyValue.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpG,KAAK,sBAAsB,CAAC,CAAC,IAAI;IAC7B,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,eAAe,CAAC,EAAE,KAAK,CAAC;CAC3B,CAAC;AAEF,KAAK,qBAAqB,CAAC,CAAC,IAAI;IAC5B,YAAY,EAAE,CAAC,CAAC;IAChB,eAAe,CAAC,EAAE,KAAK,CAAC;CAC3B,CAAC;AAEF,KAAK,mBAAmB,CAAC,CAAC,IAAI;IAC1B,eAAe,EAAE,IAAI,CAAC;CACzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAClB,sBAAsB,CAAC,CAAC,CAAC,GACzB,qBAAqB,CAAC,CAAC,CAAC,GACxB,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE7B;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB;;;;;;;;OAQG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EACP,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EACtB,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,GAC3D,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,GAAG,CAAC,CAAC,GAAG,GAAG,EACP,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1B,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAEtF;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAElD;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;CAChD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,kBAAkB,GAAG,qBAAqB,CAAC,GAAG;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;;OAKG;IACH,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC;IAEjC;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD"}

package/script/src/kv/KeyValue.js

@@ -1,8 +1,14 @@
 "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.isKVOptionsExecution = isKVOptionsExecution;
-function isKVOptionsExecution(options) {
-    return options.scope === ':execution:' &&
-        typeof options.executionId === 'string' &&
-        options.executionId.length > 0;
-}

package/script/src/kv/isKVOptionsExecution.d.ts

@@ -0,0 +1,3 @@
+import { KVOptions, KVOptionsExecution } from './KeyValue.js';
+export declare function isKVOptionsExecution(options: KVOptions): options is KVOptionsExecution;
+//# sourceMappingURL=isKVOptionsExecution.d.ts.map

package/script/src/kv/isKVOptionsExecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isKVOptionsExecution.d.ts","sourceRoot":"","sources":["../../../src/src/kv/isKVOptionsExecution.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE9D,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,SAAS,GACnB,OAAO,IAAI,kBAAkB,CAI/B"}

package/script/src/kv/isKVOptionsExecution.js

@@ -0,0 +1,20 @@
+"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.isKVOptionsExecution = isKVOptionsExecution;
+function isKVOptionsExecution(options) {
+    return options.scope === ':execution:' &&
+        typeof options.executionId === 'string' &&
+        options.executionId.length > 0;
+}

package/script/src/kv/memory/MemoryKeyValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemoryKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/memory/MemoryKeyValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvG,qBAAa,cAAe,YAAW,QAAQ;IAC3C,OAAO,CAAC,KAAK,CAAmC;IAEhD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAc/E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAKxE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;CAIpD"}
+{"version":3,"file":"MemoryKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/memory/MemoryKeyValue.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EACH,eAAe,EACf,aAAa,EACb,cAAc,EACjB,MAAM,uCAAuC,CAAC;AAC/C,qBAAa,cAAe,YAAW,QAAQ;IAC3C,OAAO,CAAC,KAAK,CAAmC;IAEhD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAc/E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAKxE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;CAIpD"}

package/script/src/kv/memory/MemoryKeyValue.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.MemoryKeyValue = void 0;
 const KVNotFoundError_js_1 = require("../KVNotFoundError.js");

package/script/src/kv/memory/MemoryKeyValueProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemoryKeyValueProvider.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/memory/MemoryKeyValueProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGvF,qBAAa,sBAAuB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,WAAW,CAAoC;IAEvD,OAAO,CAAC,SAAS,CAAkC;IAEnD,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ;IAehC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/C,OAAO,CAAC,cAAc;CAUzB"}
+{"version":3,"file":"MemoryKeyValueProvider.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/memory/MemoryKeyValueProvider.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGvF,qBAAa,sBAAuB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,WAAW,CAAoC;IAEvD,OAAO,CAAC,SAAS,CAAkC;IAEnD,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ;IAehC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/C,OAAO,CAAC,cAAc;CAUzB"}

package/script/src/kv/memory/MemoryKeyValueProvider.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.MemoryKeyValueProvider = void 0;
 const MemoryKeyValue_js_1 = require("./MemoryKeyValue.js");

package/script/src/kv/mod.d.ts

@@ -1,5 +1,8 @@
-export * from './memory/mod.js';
-export * from './sdk/mod.js';
+/**
+ * The kv module provides the functionality for storing and retrieving data from Versori's Key/Value storage solution.
+ *
+ * @module
+ */
 export * from './KeyValue.js';
 export * from './KVNotFoundError.js';
 //# sourceMappingURL=mod.d.ts.map

package/script/src/kv/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/kv/mod.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/kv/mod.ts"],"names":[],"mappings":"AAaA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC"}

package/script/src/kv/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.
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -14,7 +26,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./memory/mod.js"), exports);
-__exportStar(require("./sdk/mod.js"), exports);
+/**
+ * The kv module provides the functionality for storing and retrieving data from Versori's Key/Value storage solution.
+ *
+ * @module
+ */
 __exportStar(require("./KeyValue.js"), exports);
 __exportStar(require("./KVNotFoundError.js"), exports);

package/script/src/kv/nats/NatsKeyValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NatsKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/nats/NatsKeyValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAW,MAAM,mDAAmD,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvG,qBAAa,YAAa,YAAW,QAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAM,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAA/B,EAAE,EAAE,EAAE,EAAmB,MAAM,EAAE,MAAM;IAE9D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,GAAE,UAAU,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAwBnF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAKxE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAKjD,OAAO,CAAC,WAAW;CAGtB"}
+{"version":3,"file":"NatsKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/nats/NatsKeyValue.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,EAAE,EAAW,MAAM,mDAAmD,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EACH,eAAe,EACf,aAAa,EACb,cAAc,EACjB,MAAM,uCAAuC,CAAC;AAE/C,qBAAa,YAAa,YAAW,QAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAM,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAA/B,EAAE,EAAE,EAAE,EAAmB,MAAM,EAAE,MAAM;IAE9D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,GAAE,UAAU,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAwBnF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAKxE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAKjD,OAAO,CAAC,WAAW;CAGtB"}

package/script/src/kv/nats/NatsKeyValue.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.NatsKeyValue = void 0;
 const KVNotFoundError_js_1 = require("../KVNotFoundError.js");

package/script/src/kv/nats/NatsKeyValueProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NatsKeyValueProvider.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/nats/NatsKeyValueProvider.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,UAAU,EAAE,MAAM,+DAA+D,CAAC;AACxH,OAAO,EACH,cAAc,EAEd,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACZ,MAAM,gBAAgB,CAAC;AA4CxB,MAAM,MAAM,2BAA2B,GAAG;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE;QACF,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,GAAG,CAAC,EAAE,UAAU,CAAC;KACpB,CAAC;CACL,CAAC;AAuBF,qBAAa,oBAAqB,YAAW,gBAAgB,EAAE,eAAe;IAEtE,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI;IALzB,OAAO;WAQM,WAAW,CACpB,IAAI,GAAE,OAAO,CAAC,2BAA2B,CAAM,GAChD,OAAO,CAAC,oBAAoB,CAAC;IA0BhC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAI/C,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC;IAI1C,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ;IAqB1B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCrD,OAAO,CAAC,aAAa;CAYxB"}
+{"version":3,"file":"NatsKeyValueProvider.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/nats/NatsKeyValueProvider.ts"],"names":[],"mappings":"AAeA,OAAO,EAA+B,UAAU,EAAE,MAAM,+DAA+D,CAAC;AAExH,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AA4CvF,MAAM,MAAM,2BAA2B,GAAG;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE;QACF,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,GAAG,CAAC,EAAE,UAAU,CAAC;KACpB,CAAC;CACL,CAAC;AAuBF,qBAAa,oBAAqB,YAAW,gBAAgB,EAAE,eAAe;IAEtE,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI;IALzB,OAAO;WAQM,WAAW,CACpB,IAAI,GAAE,OAAO,CAAC,2BAA2B,CAAM,GAChD,OAAO,CAAC,oBAAoB,CAAC;IA0BhC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAI/C,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC;IAI1C,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ;IAqB1B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CrD,OAAO,CAAC,aAAa;CAYxB"}

package/script/src/kv/nats/NatsKeyValueProvider.js

@@ -1,10 +1,22 @@
 "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.NatsKeyValueProvider = void 0;
 const mod_js_1 = require("../../../deps/jsr.io/@nats-io/jetstream/3.2.0/src/mod.js");
 const mod_js_2 = require("../../../deps/jsr.io/@nats-io/kv/3.2.0/src/mod.js");
 const mod_js_3 = require("../../../deps/jsr.io/@nats-io/transport-deno/3.2.0/src/mod.js");
-const KeyValue_js_1 = require("../KeyValue.js");
+const isKVOptionsExecution_js_1 = require("../isKVOptionsExecution.js");
 const NatsKeyValue_js_1 = require("./NatsKeyValue.js");
 function getOptionsFromEnv() {
     const natsTlsCaFile = Deno.env.get('RUN_NATS_TLS_CA_FILE');
@@ -117,7 +129,7 @@ class NatsKeyValueProvider {
             case ':project:':
                 return new NatsKeyValue_js_1.NatsKeyValue(this.kvProjectScope, this.subjectPrefix(options));
             case ':execution:':
-                if (!(0, KeyValue_js_1.isKVOptionsExecution)(options)) {
+                if (!(0, isKVOptionsExecution_js_1.isKVOptionsExecution)(options)) {
                     throw new Error('invalid KV options, executionId is required for :execution: scope');
                 }
                 return new NatsKeyValue_js_1.NatsKeyValue(this.kvExecutionScope, this.subjectPrefix(options));
@@ -163,7 +175,7 @@ class NatsKeyValueProvider {
         const activationSuffix = options.activationId ? `.${options.activationId}` : '';
         switch (options.scope) {
             case ':organization:':
-                return `${this.opts.organizationId}${activationSuffix}`;
+                return `${this.opts.organizationId}`;
             case ':project:':
                 return `${this.opts.organizationId}.${this.opts.projectId}.${this.opts.environment}${activationSuffix}`;
             case ':execution:':

package/script/src/kv/sdk/SDKKeyValue.d.ts

@@ -1,8 +1,8 @@
-import { GetOptions, KeyValue } from '../KeyValue.js';
+import { CountKVResponse } from '../../dsl/http/versori/kvapi/models/CountKVResponse.js';
 import { CreateStoreResponse } from '../../dsl/http/versori/kvapi/models/CreateStoreResponse.js';
 import { ListKVRequest } from '../../dsl/http/versori/kvapi/models/ListKVRequest.js';
 import { ListKVResponse } from '../../dsl/http/versori/kvapi/models/ListKVResponse.js';
-import { CountKVResponse } from '../../dsl/http/versori/kvapi/models/CountKVResponse.js';
+import { GetOptions, KeyValue } from '../KeyValue.js';
 export declare class SDKKeyValue implements KeyValue {
     private readonly store;
     private readonly prefix;

package/script/src/kv/sdk/SDKKeyValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SDKKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/sdk/SDKKeyValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4DAA4D,CAAC;AAGjG,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,wDAAwD,CAAC;AAEzF,qBAAa,WAAY,YAAW,QAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAuB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAnD,KAAK,EAAE,mBAAmB,EAAmB,MAAM,EAAE,MAAM;IAElF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,GAAE,UAAU,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAoBnF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAUjD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAY9E,OAAO,CAAC,WAAW;CAGtB"}
+{"version":3,"file":"SDKKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/sdk/SDKKeyValue.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,eAAe,EAAE,MAAM,wDAAwD,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4DAA4D,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAC;AAGvF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtD,qBAAa,WAAY,YAAW,QAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAuB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAnD,KAAK,EAAE,mBAAmB,EAAmB,MAAM,EAAE,MAAM;IAElF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,GAAE,UAAU,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IA8BnF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAUjD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAY9E,OAAO,CAAC,WAAW;CAGtB"}

package/script/src/kv/sdk/SDKKeyValue.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.SDKKeyValue = void 0;
 const KvOperationsService_js_1 = require("../../dsl/http/versori/kvapi/services/KvOperationsService.js");
@@ -22,10 +34,17 @@ class SDKKeyValue {
         try {
             const k = this.generateKey(key instanceof Array ? key.join('/') : key);
             const entry = await KvOperationsService_js_1.KvOperationsService.getKv(this.store.id, k);
+            if (entry.value === undefined) {
+                if (options.throwOnNotFound) {
+                    throw new Error('Key not found');
+                }
+                return undefined;
+            }
             return entry.value;
         }
         catch (error) {
-            if (options.throwOnNotFound && error instanceof Error && error.message === 'Key not found') {
+            if (options.throwOnNotFound && error instanceof Error &&
+                error.message === 'Key not found') {
                 throw new Error('Key not found');
             }
             else if (!options.throwOnNotFound) {
@@ -40,25 +59,25 @@ class SDKKeyValue {
         const k = this.generateKey(key instanceof Array ? key.join('/') : key);
         await KvOperationsService_js_1.KvOperationsService.setKv(this.store.id, k, {
             value: value,
-            options: {}
+            options: {},
         });
     }
     async delete(key) {
         const k = this.generateKey(key instanceof Array ? key.join('/') : key);
         await KvOperationsService_js_1.KvOperationsService.deleteKv(this.store.id, k, {
-            options: {}
+            options: {},
         });
     }
     async count(prefix) {
-        const k = this.generateKey(prefix).split("/");
+        const k = this.generateKey(prefix).split('/');
         return await QueryOperationsService_js_1.QueryOperationsService.countKv(this.store.id, {
             selector: {
-                prefix: k
-            }
+                prefix: k,
+            },
         });
     }
     async list(prefix, options) {
-        const k = this.generateKey(prefix).split("/");
+        const k = this.generateKey(prefix).split('/');
         return await QueryOperationsService_js_1.QueryOperationsService.listKv(this.store.id, {
             selector: {
                 prefix: k,

package/script/src/kv/sdk/SDKKeyValueProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SDKKeyValueProvider.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/sdk/SDKKeyValueProvider.ts"],"names":[],"mappings":"AAIA,OAAO,EACH,cAAc,EAEd,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACZ,MAAM,gBAAgB,CAAC;AAmCxB,MAAM,MAAM,0BAA0B,GAAG;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAyBF,qBAAa,mBAAoB,YAAW,gBAAgB,EAAE,eAAe;IAErE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJzB,OAAO;WAOM,WAAW,CACpB,IAAI,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAC/C,OAAO,CAAC,mBAAmB,CAAC;IAY/B,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI9C,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC;IAI1C,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ;IAqB1B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCrD,OAAO,CAAC,aAAa;CAYxB"}
+{"version":3,"file":"SDKKeyValueProvider.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/sdk/SDKKeyValueProvider.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAkCvF,MAAM,MAAM,0BAA0B,GAAG;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AA6BF,qBAAa,mBAAoB,YAAW,gBAAgB,EAAE,eAAe;IAErE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJzB,OAAO;WAOM,WAAW,CACpB,IAAI,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAC/C,OAAO,CAAC,mBAAmB,CAAC;IAY/B,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI9C,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC;IAI1C,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ;IAqB1B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CrD,OAAO,CAAC,aAAa;CAYxB"}

package/script/src/kv/sdk/SDKKeyValueProvider.js

@@ -1,16 +1,28 @@
 "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.SDKKeyValueProvider = void 0;
-const StoresService_js_1 = require("../../dsl/http/versori/kvapi/services/StoresService.js");
 const KvOperationsService_js_1 = require("../../dsl/http/versori/kvapi/services/KvOperationsService.js");
-const KeyValue_js_1 = require("../KeyValue.js");
+const StoresService_js_1 = require("../../dsl/http/versori/kvapi/services/StoresService.js");
+const isKVOptionsExecution_js_1 = require("../isKVOptionsExecution.js");
 const SDKKeyValue_js_1 = require("./SDKKeyValue.js");
 function getOptionsFromEnv() {
     return {
         organizationId: Deno.env.get('RUN_ORGANISATION_ID'),
         projectId: Deno.env.get('RUN_SERVICE_ID'),
         environment: Deno.env.get('RUN_ENVIRONMENT'),
-        kvApiUrl: Deno.env.get('RUN_SDK_API_URL') || 'http://localhost:8092'
+        kvApiUrl: Deno.env.get('RUN_SDK_API_URL') || 'http://localhost:8092',
     };
 }
 function mergeOptions(defaults, provided) {
@@ -30,8 +42,8 @@ async function openOrCreateKV(storeName) {
     try {
         try {
             const existingStore = await StoresService_js_1.StoresService.listStores(Deno.env.get('RUN_ORGANISATION_ID'));
-            if (existingStore.stores?.find(store => store.name === storeName)) {
-                return existingStore.stores.find(store => store.name === storeName);
+            if (existingStore.stores?.find((store) => store.name === storeName)) {
+                return existingStore.stores.find((store) => store.name === storeName);
             }
         }
         catch (error) {
@@ -39,7 +51,7 @@ async function openOrCreateKV(storeName) {
         }
         const store = await StoresService_js_1.StoresService.createStore({
             name: storeName,
-            orgId: Deno.env.get('RUN_ORGANISATION_ID')
+            orgId: Deno.env.get('RUN_ORGANISATION_ID'),
         });
         return store;
     }
@@ -96,7 +108,7 @@ class SDKKeyValueProvider {
             case ':project:':
                 return new SDKKeyValue_js_1.SDKKeyValue(this.kvProjectScope, this.subjectPrefix(options));
             case ':execution:':
-                if (!(0, KeyValue_js_1.isKVOptionsExecution)(options)) {
+                if (!(0, isKVOptionsExecution_js_1.isKVOptionsExecution)(options)) {
                     throw new Error('invalid KV options, executionId is required for :execution: scope');
                 }
                 return new SDKKeyValue_js_1.SDKKeyValue(this.kvExecutionScope, this.subjectPrefix(options));
@@ -111,22 +123,22 @@ class SDKKeyValueProvider {
             }
             await KvOperationsService_js_1.KvOperationsService.deleteKv(this.kvExecutionScope.id, options.executionId, {
                 options: {
-                    cascade: true
-                }
+                    cascade: true,
+                },
             });
         }
         if (options.scope === ':project:') {
             await KvOperationsService_js_1.KvOperationsService.deleteKv(this.kvProjectScope.id, this.subjectPrefix(options), {
                 options: {
-                    cascade: true
-                }
+                    cascade: true,
+                },
             });
         }
         if (options.scope === ':organization:') {
             await KvOperationsService_js_1.KvOperationsService.deleteKv(this.kvOrgScope.id, this.subjectPrefix(options), {
                 options: {
-                    cascade: true
-                }
+                    cascade: true,
+                },
             });
         }
         // TODO: interface may need updating, workers should not be deleting KV buckets, only execution keys should be purged.
@@ -136,7 +148,7 @@ class SDKKeyValueProvider {
         const activationSuffix = options.activationId ? `/${options.activationId}` : '';
         switch (options.scope) {
             case ':organization:':
-                return `${this.opts.organizationId}${activationSuffix}`;
+                return `${this.opts.organizationId}`;
             case ':project:':
                 return `${this.opts.organizationId}/${this.opts.projectId}/${this.opts.environment}${activationSuffix}`;
             case ':execution:':

package/script/src/mod.d.ts

@@ -1,6 +1,7 @@
-export * from "./context/mod.js";
-export * from "./dsl/mod.js";
-export * from "./interpreter/mod.js";
-export * from "./kv/mod.js";
-export * from "./observability/mod.js";
+export * from './context/mod.js';
+export * from './dsl/mod.js';
+export * from './interpreter/mod.js';
+export * from './kv/mod.js';
+export * from './observability/mod.js';
+export * from './services/mod.js';
 //# sourceMappingURL=mod.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/src/mod.ts"],"names":[],"mappings":"AAaA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC"}

package/script/src/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.
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -19,3 +31,4 @@ __exportStar(require("./dsl/mod.js"), exports);
 __exportStar(require("./interpreter/mod.js"), exports);
 __exportStar(require("./kv/mod.js"), exports);
 __exportStar(require("./observability/mod.js"), exports);
+__exportStar(require("./services/mod.js"), exports);

package/script/src/observability/logging/ConsoleLogger.d.ts

@@ -1,7 +1,10 @@
 import * as log from '../../../deps/jsr.io/@std/log/0.224.14/mod.js';
 import { Logger, LogLevel } from './Logger.js';
 /**
- * ConsoleLogger implements Logger.
+ * ConsoleLogger is a {@link Logger} implementation that outputs JSON-formatted logs to the console.
+ *
+ * This is the default logger used by interpreters. Logs are formatted as JSON with structured fields, timestamps,
+ * and proper error serialization.
  */
 export declare class ConsoleLogger implements Logger {
     log: log.Logger;