@versori/run 0.7.0-alpha.8 → 0.7.0

package/esm/src/kv/fingerprintExternalUserId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprintExternalUserId.d.ts","sourceRoot":"","sources":["../../../src/src/kv/fingerprintExternalUserId.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAExE"}

package/esm/src/kv/fingerprintExternalUserId.js

@@ -0,0 +1,20 @@
+/*
+ * 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 { createHash } from 'node:crypto';
+/**
+ * Stable hex fingerprint of an external user id for KV path segments.
+ * Output is `[0-9a-f]{64}` so it satisfies backends that only allow `[a-zA-Z0-9_-]+` per segment.
+ */
+export function fingerprintExternalUserId(externalUserId) {
+    return createHash('sha256').update(externalUserId, 'utf8').digest('hex');
+}

package/esm/src/kv/memory/MemoryKeyValue.d.ts

@@ -1,9 +1,10 @@
-import { GetOptions, KeyValue } from '../KeyValue.js';
-import { CountKVResponse, ListKVRequest, ListKVResponse } from '../../dsl/http/versori/kvapi/index.js';
+import { GetOptions, KeyValue, SetManyEntry } from '../KeyValue.js';
+import { CountKVResponse, KVBatchResult, ListKVRequest, ListKVResponse } from '../../dsl/http/versori/kvapi/index.js';
 export declare class MemoryKeyValue implements KeyValue {
     private store;
     get<T>(key: string | string[], options?: GetOptions<T>): Promise<T | undefined>;
     set<T>(key: string | string[], value: T): Promise<void>;
+    setMany(entries: SetManyEntry[]): Promise<KVBatchResult>;
     delete(key: string | string[]): Promise<void>;
     list(prefix: string[], options?: ListKVRequest): Promise<ListKVResponse>;
     count(prefix: string[]): Promise<CountKVResponse>;

package/esm/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,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"}
+{"version":3,"file":"MemoryKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/memory/MemoryKeyValue.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EACH,eAAe,EAEf,aAAa,EAEb,aAAa,EACb,cAAc,EACjB,MAAM,uCAAuC,CAAC;AAK/C,qBAAa,cAAe,YAAW,QAAQ;IAC3C,OAAO,CAAC,KAAK,CAAmC;IAE1C,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;IA0B/E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvD,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IA6BxD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAYxE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;CAWpD"}

package/esm/src/kv/memory/MemoryKeyValue.js

@@ -11,6 +11,8 @@
  * use of this software will be governed by the Apache License, Version 2.0.
  */
 import { KVNotFoundError } from '../KVNotFoundError.js';
+import opentelemetry from '@opentelemetry/api';
+const tracer = opentelemetry.trace.getTracer('versori-run-kv');
 export class MemoryKeyValue {
     constructor() {
         Object.defineProperty(this, "store", {
@@ -20,30 +22,106 @@ export class MemoryKeyValue {
             value: new Map()
         });
     }
-    get(key, options) {
-        const raw = this.store.get(key instanceof Array ? key.join('.') : key);
-        if (typeof raw === 'undefined') {
-            if (options?.throwOnNotFound) {
-                throw new KVNotFoundError(key instanceof Array ? key.join('.') : key);
-            }
-            return Promise.resolve(undefined);
-        }
-        return Promise.resolve(raw);
+    async get(key, options) {
+        return await tracer.startActiveSpan('kv.get', (span) => {
+            const keyStr = key instanceof Array ? key.join('.') : key;
+            span.setAttribute('kv.key', keyStr);
+            try {
+                const raw = this.store.get(keyStr);
+                if (typeof raw === 'undefined') {
+                    if (options?.throwOnNotFound) {
+                        throw new KVNotFoundError(keyStr);
+                    }
+                    return undefined;
+                }
+                return raw;
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+    async set(key, value) {
+        return await tracer.startActiveSpan('kv.set', (span) => {
+            const keyStr = key instanceof Array ? key.join('.') : key;
+            span.setAttribute('kv.key', keyStr);
+            try {
+                this.store.set(keyStr, value);
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
     }
-    set(key, value) {
-        this.store.set(key instanceof Array ? key.join('.') : key, value);
-        return Promise.resolve();
+    async setMany(entries) {
+        return await tracer.startActiveSpan('kv.set_many', async (span) => {
+            span.setAttribute('kv.count', entries.length);
+            // No native batch primitive in the in-memory store; write each entry sequentially and
+            // assemble a partial-success result mirroring the SDK-backed store's contract.
+            const successes = [];
+            const failures = [];
+            try {
+                for (const entry of entries) {
+                    try {
+                        await this.set(entry.key, entry.value);
+                        successes.push({ ok: true, versionstamp: '', committed: true });
+                    }
+                    catch (error) {
+                        failures.push({
+                            key: entry.key instanceof Array ? entry.key : [entry.key],
+                            error: error instanceof Error ? error.message : String(error),
+                        });
+                    }
+                }
+                return { successes, failures };
+            }
+            finally {
+                span.end();
+            }
+        });
     }
-    delete(key) {
-        this.store.delete(key instanceof Array ? key.join('.') : key);
-        return Promise.resolve();
+    async delete(key) {
+        return await tracer.startActiveSpan('kv.delete', (span) => {
+            const keyStr = key instanceof Array ? key.join('.') : key;
+            span.setAttribute('kv.key', keyStr);
+            try {
+                this.store.delete(keyStr);
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
     }
     list(prefix, options) {
-        console.log('Listing not implemented', prefix, options);
-        return Promise.reject(new Error('Listing not implemented'));
+        return tracer.startActiveSpan('kv.list', (span) => {
+            span.setAttribute('kv.prefix', prefix.join('.'));
+            console.log('Listing not implemented', prefix, options);
+            const err = new Error('Listing not implemented');
+            span.recordException(err);
+            span.end();
+            return Promise.reject(err);
+        });
     }
     count(prefix) {
-        console.log('Count not implemented', prefix);
-        return Promise.reject(new Error('Count not implemented'));
+        return tracer.startActiveSpan('kv.count', (span) => {
+            span.setAttribute('kv.prefix', prefix.join('.'));
+            console.log('Count not implemented', prefix);
+            const err = new Error('Count not implemented');
+            span.recordException(err);
+            span.end();
+            return Promise.reject(err);
+        });
     }
 }

package/esm/src/kv/memory/MemoryKeyValueProvider.d.ts

@@ -2,8 +2,12 @@ import { DestroyOptions, KeyValue, KeyValueProvider, KVOptions } from '../KeyVal
 export declare class MemoryKeyValueProvider implements KeyValueProvider {
     private executionKv;
     private projectKv;
+    private workspaceKv;
+    private organizationKv;
+    private userKv;
     kv(options: KVOptions): KeyValue;
     destroy(options: DestroyOptions): Promise<void>;
     private getExecutionKv;
+    private getUserKv;
 }
 //# sourceMappingURL=MemoryKeyValueProvider.d.ts.map

package/esm/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;IACvD,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,MAAM,CAAoC;IAElD,EAAE,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ;IAyBhC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC/C,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,SAAS;CAUpB"}

package/esm/src/kv/memory/MemoryKeyValueProvider.js

@@ -25,6 +25,24 @@ export class MemoryKeyValueProvider {
             writable: true,
             value: new MemoryKeyValue()
         });
+        Object.defineProperty(this, "workspaceKv", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new MemoryKeyValue()
+        });
+        Object.defineProperty(this, "organizationKv", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new MemoryKeyValue()
+        });
+        Object.defineProperty(this, "userKv", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
     }
     kv(options) {
         switch (options.scope) {
@@ -35,6 +53,15 @@ export class MemoryKeyValueProvider {
                 return this.getExecutionKv(options.executionId);
             case ':project:':
                 return this.projectKv;
+            case ':workspace:':
+                return this.workspaceKv;
+            case ':organization:':
+                return this.organizationKv;
+            case ':user:':
+                if (typeof options.externalUserId === 'undefined') {
+                    throw new Error('externalUserId is required when scope is :user:');
+                }
+                return this.getUserKv(options.externalUserId);
             default:
                 throw new Error(`Unsupported scope: ${options.scope}`);
         }
@@ -47,6 +74,21 @@ export class MemoryKeyValueProvider {
                 }
                 this.executionKv.delete(options.executionId);
                 return Promise.resolve();
+            case ':project:':
+                this.projectKv = new MemoryKeyValue();
+                return Promise.resolve();
+            case ':workspace:':
+                this.workspaceKv = new MemoryKeyValue();
+                return Promise.resolve();
+            case ':organization:':
+                this.organizationKv = new MemoryKeyValue();
+                return Promise.resolve();
+            case ':user:':
+                if (typeof options.externalUserId === 'undefined') {
+                    throw new Error('externalUserId is required when scope is :user:');
+                }
+                this.userKv.delete(options.externalUserId);
+                return Promise.resolve();
             default:
                 return Promise.resolve();
         }
@@ -59,4 +101,12 @@ export class MemoryKeyValueProvider {
         }
         return kv;
     }
+    getUserKv(externalUserId) {
+        let kv = this.userKv.get(externalUserId);
+        if (!kv) {
+            kv = new MemoryKeyValue();
+            this.userKv.set(externalUserId, kv);
+        }
+        return kv;
+    }
 }

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

@@ -5,4 +5,5 @@
  */
 export * from './KeyValue.js';
 export * from './KVNotFoundError.js';
+export type { BatchEntry, KVBatchFailure, KVBatchResult, KVCommitResult, SetOptions, } from '../dsl/http/versori/kvapi/index.js';
 //# sourceMappingURL=mod.d.ts.map

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

@@ -1 +1 @@
-{"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"}
+{"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;AAIrC,YAAY,EACR,UAAU,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,UAAU,GACb,MAAM,oCAAoC,CAAC"}

package/esm/src/kv/nats/NatsKeyValue.d.ts

@@ -1,12 +1,13 @@
-import { KV } from '../../../deps/jsr.io/@nats-io/kv/3.3.1/src/mod.js';
-import { GetOptions, KeyValue } from '../KeyValue.js';
-import { CountKVResponse, ListKVRequest, ListKVResponse } from '../../dsl/http/versori/kvapi/index.js';
+import { KV } from '../../../deps/jsr.io/@nats-io/kv/3.4.0/src/mod.js';
+import { GetOptions, KeyValue, SetManyEntry } from '../KeyValue.js';
+import { CountKVResponse, KVBatchResult, ListKVRequest, ListKVResponse } from '../../dsl/http/versori/kvapi/index.js';
 export declare class NatsKeyValue implements KeyValue {
     private readonly kv;
     private readonly prefix;
     constructor(kv: KV, prefix: string);
     get<T>(key: string | string[], options?: GetOptions<T>): Promise<T | undefined>;
     set<T>(key: string | string[], value: T): Promise<void>;
+    setMany(entries: SetManyEntry[]): Promise<KVBatchResult>;
     delete(key: string | string[]): Promise<void>;
     list(prefix: string[], options?: ListKVRequest): Promise<ListKVResponse>;
     count(prefix: string[]): Promise<CountKVResponse>;

package/esm/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,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"}
+{"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,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EACH,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACjB,MAAM,uCAAuC,CAAC;AAK/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;IAqCnF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7D,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAYlD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAYxE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAYjD,OAAO,CAAC,WAAW;CAGtB"}

package/esm/src/kv/nats/NatsKeyValue.js

@@ -11,6 +11,8 @@
  * use of this software will be governed by the Apache License, Version 2.0.
  */
 import { KVNotFoundError } from '../KVNotFoundError.js';
+import opentelemetry from '@opentelemetry/api';
+const tracer = opentelemetry.trace.getTracer('versori-run-kv');
 export class NatsKeyValue {
     constructor(kv, prefix) {
         Object.defineProperty(this, "kv", {
@@ -27,39 +29,101 @@ export class NatsKeyValue {
         });
     }
     async get(key, options = {}) {
-        let entry;
-        try {
-            entry = await this.kv.get(this.generateKey(key instanceof Array ? key.join('.') : key));
-        }
-        catch (error) {
-            console.error('Unknown error reading from KV store', error);
-            throw new Error('Unknown error reading from KV store');
-        }
-        if (!entry || ['DEL', 'PURGE'].includes(entry.operation)) {
-            if (options.throwOnNotFound) {
-                throw new KVNotFoundError(key instanceof Array ? key.join('.') : key);
+        return await tracer.startActiveSpan('kv.get', async (span) => {
+            const keyStr = key instanceof Array ? key.join('.') : key;
+            span.setAttribute('kv.key', keyStr);
+            try {
+                let entry;
+                try {
+                    entry = await this.kv.get(this.generateKey(keyStr));
+                }
+                catch (error) {
+                    span.recordException(error instanceof Error ? error : new Error(String(error)));
+                    console.error('Unknown error reading from KV store', error);
+                    throw new Error('Unknown error reading from KV store');
+                }
+                if (!entry || ['DEL', 'PURGE'].includes(entry.operation)) {
+                    if (options.throwOnNotFound) {
+                        throw new KVNotFoundError(keyStr);
+                    }
+                    else if (typeof options.defaultValue !== 'undefined') {
+                        return options.defaultValue;
+                    }
+                    return undefined;
+                }
+                return entry.json();
             }
-            else if (typeof options.defaultValue !== 'undefined') {
-                return options.defaultValue;
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
             }
-            return undefined;
-        }
-        return entry.json();
+            finally {
+                span.end();
+            }
+        });
     }
     async set(key, value) {
-        const payload = JSON.stringify(value);
-        await this.kv.put(this.generateKey(key instanceof Array ? key.join('.') : key), payload);
+        return await tracer.startActiveSpan('kv.set', async (span) => {
+            const keyStr = key instanceof Array ? key.join('.') : key;
+            span.setAttribute('kv.key', keyStr);
+            try {
+                const payload = JSON.stringify(value);
+                await this.kv.put(this.generateKey(keyStr), payload);
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+    setMany(entries) {
+        return tracer.startActiveSpan('kv.set_many', (span) => {
+            span.setAttribute('kv.count', entries.length);
+            console.log('SetMany not implemented', entries.length);
+            const err = new Error('SetMany not implemented');
+            span.recordException(err);
+            span.end();
+            return Promise.reject(err);
+        });
     }
     async delete(key) {
-        await this.kv.delete(this.generateKey(key instanceof Array ? key.join('.') : key));
+        return await tracer.startActiveSpan('kv.delete', async (span) => {
+            const keyStr = key instanceof Array ? key.join('.') : key;
+            span.setAttribute('kv.key', keyStr);
+            try {
+                await this.kv.delete(this.generateKey(keyStr));
+            }
+            catch (error) {
+                span.recordException(error instanceof Error ? error : new Error(String(error)));
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
     }
     list(prefix, options) {
-        console.log('Listing not implemented', prefix, options);
-        return Promise.reject(new Error('Listing not implemented'));
+        return tracer.startActiveSpan('kv.list', (span) => {
+            span.setAttribute('kv.prefix', prefix.join('.'));
+            console.log('Listing not implemented', prefix, options);
+            const err = new Error('Listing not implemented');
+            span.recordException(err);
+            span.end();
+            return Promise.reject(err);
+        });
     }
     count(prefix) {
-        console.log('Count not implemented', prefix);
-        return Promise.reject(new Error('Count not implemented'));
+        return tracer.startActiveSpan('kv.count', (span) => {
+            span.setAttribute('kv.prefix', prefix.join('.'));
+            console.log('Count not implemented', prefix);
+            const err = new Error('Count not implemented');
+            span.recordException(err);
+            span.end();
+            return Promise.reject(err);
+        });
     }
     generateKey(key) {
         return `${this.prefix}.${key instanceof Array ? key.join('.') : key}`;

package/esm/src/kv/nats/NatsKeyValueProvider.d.ts

@@ -1,4 +1,4 @@
-import { TlsOptions } from '../../../deps/jsr.io/@nats-io/transport-deno/3.3.1/src/mod.js';
+import { TlsOptions } from '../../../deps/jsr.io/@nats-io/transport-deno/3.4.0/src/mod.js';
 import { DestroyOptions, KeyValue, KeyValueProvider, KVOptions } from '../KeyValue.js';
 export type NatsKeyValueProviderOptions = {
     organizationId: string;

package/esm/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;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"}
+{"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;AAGxH,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;IAyB1B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CrD,OAAO,CAAC,aAAa;CAsBxB"}

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

@@ -10,9 +10,10 @@
  * 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 { JetStreamApiCodes, JetStreamApiError } from '../../../deps/jsr.io/@nats-io/jetstream/3.3.1/src/mod.js';
-import { Kvm } from '../../../deps/jsr.io/@nats-io/kv/3.3.1/src/mod.js';
-import { connect, credsAuthenticator } from '../../../deps/jsr.io/@nats-io/transport-deno/3.3.1/src/mod.js';
+import { JetStreamApiCodes, JetStreamApiError } from '../../../deps/jsr.io/@nats-io/jetstream/3.4.0/src/mod.js';
+import { Kvm } from '../../../deps/jsr.io/@nats-io/kv/3.4.0/src/mod.js';
+import { connect, credsAuthenticator } from '../../../deps/jsr.io/@nats-io/transport-deno/3.4.0/src/mod.js';
+import { fingerprintExternalUserId } from '../fingerprintExternalUserId.js';
 import { isKVOptionsExecution } from '../isKVOptionsExecution.js';
 import { NatsKeyValue } from './NatsKeyValue.js';
 function getOptionsFromEnv() {
@@ -125,6 +126,10 @@ export class NatsKeyValueProvider {
                 return new NatsKeyValue(this.kvOrgScope, this.subjectPrefix(options));
             case ':project:':
                 return new NatsKeyValue(this.kvProjectScope, this.subjectPrefix(options));
+            case ':workspace:':
+                return new NatsKeyValue(this.kvProjectScope, this.subjectPrefix(options));
+            case ':user:':
+                return new NatsKeyValue(this.kvProjectScope, this.subjectPrefix(options));
             case ':execution:':
                 if (!isKVOptionsExecution(options)) {
                     throw new Error('invalid KV options, executionId is required for :execution: scope');
@@ -175,8 +180,17 @@ export class NatsKeyValueProvider {
                 return `${this.opts.organizationId}`;
             case ':project:':
                 return `${this.opts.organizationId}.${this.opts.projectId}.${this.opts.environment}${activationSuffix}`;
+            case ':workspace:':
+                return `${this.opts.organizationId}.${this.opts.projectId}.${this.opts.environment}`;
+            case ':user:':
+                if (typeof options.externalUserId === 'undefined') {
+                    throw new Error('externalUserId is required when scope is :user:');
+                }
+                return `${this.opts.organizationId}.${this.opts.projectId}.${this.opts.environment}.${fingerprintExternalUserId(options.externalUserId)}`;
             case ':execution:':
                 return `${this.opts.organizationId}.${this.opts.projectId}.${this.opts.environment}.${options.executionId}${activationSuffix}`;
+            default:
+                throw new Error(`Unsupported scope for subjectPrefix: ${options.scope}`);
         }
     }
 }

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

@@ -1,17 +1,25 @@
 import { CountKVResponse } from '../../dsl/http/versori/kvapi/models/CountKVResponse.js';
 import { CreateStoreResponse } from '../../dsl/http/versori/kvapi/models/CreateStoreResponse.js';
+import { KVBatchResult } from '../../dsl/http/versori/kvapi/models/KVBatchResult.js';
 import { ListKVRequest } from '../../dsl/http/versori/kvapi/models/ListKVRequest.js';
 import { ListKVResponse } from '../../dsl/http/versori/kvapi/models/ListKVResponse.js';
-import { GetOptions, KeyValue } from '../KeyValue.js';
+import { GetOptions, KeyValue, SetManyEntry } from '../KeyValue.js';
 export declare class SDKKeyValue implements KeyValue {
     private readonly store;
     private readonly prefix;
     constructor(store: CreateStoreResponse, prefix: string);
     get<T>(key: string | string[], options?: GetOptions<T>): Promise<T | undefined>;
     set<T>(key: string | string[], value: T): Promise<void>;
+    setMany(entries: SetManyEntry[]): Promise<KVBatchResult>;
     delete(key: string | string[]): Promise<void>;
     count(prefix: string[]): Promise<CountKVResponse>;
     list(prefix: string[], options?: ListKVRequest): Promise<ListKVResponse>;
     private generateKey;
+    /**
+     * Removes this store's scope prefix from a key echoed back by the API, yielding the caller-space
+     * key path. The server echoes the fully-prefixed key we sent; if a returned key does not carry our
+     * prefix (an unexpected shape) it is returned unchanged rather than mangled.
+     */
+    private stripPrefix;
 }
 //# sourceMappingURL=SDKKeyValue.d.ts.map

package/esm/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,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"}
+{"version":3,"file":"SDKKeyValue.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/sdk/SDKKeyValue.ts"],"names":[],"mappings":"AAcA,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,aAAa,EAAE,MAAM,sDAAsD,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAC;AAIvF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKpE,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;IAuCnF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBvD,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IA6CxD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB7C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAsBjD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAwB9E,OAAO,CAAC,WAAW;IAInB;;;;OAIG;IACH,OAAO,CAAC,WAAW;CAStB"}