@versori/run 0.0.1-alpha.9 → 0.1.0-alpha.10

package/esm/src/interpreter/memory/MemoryInterpreter.js

@@ -1,50 +1,52 @@
 import * as dntShim from "../../../_dnt.shims.js";
+import express from 'express';
 import { catchError, EMPTY, mergeMap, of, tap } from 'rxjs';
 import { ContextProviderImpl } from '../../context/ContextProvider.js';
-import { WorkflowImpl } from '../../dsl/Workflow.js';
-import { ObservableCompiler } from './ObservableCompiler.js';
-import { ConsoleLogger } from '../../observability/logging/ConsoleLogger.js';
 import { DefaultRoundTripperFactory } from '../../dsl/http/default.js';
-import express from 'express';
 import { PlatformAPIClient } from '../../dsl/http/versori/platformapi.js';
 import { VersoriRoundTripperFactory } from '../../dsl/http/versori/roundtripper.js';
+import { WorkflowImpl } from '../../dsl/Workflow.js';
+import { MemoryKeyValueProvider } from '../../kv/memory/MemoryKeyValueProvider.js';
+import { NatsKeyValueProvider } from '../../kv/nats/NatsKeyValueProvider.js';
+import { ConsoleLogger } from '../../observability/logging/ConsoleLogger.js';
+import { ObservableCompiler } from './ObservableCompiler.js';
 export class MemoryInterpreter {
-    constructor(options = {}) {
+    constructor(log, compiler, contextProvider, roundTripperFactory, router, connectionProvider) {
         Object.defineProperty(this, "log", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: log
         });
         Object.defineProperty(this, "compiler", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: compiler
         });
         Object.defineProperty(this, "contextProvider", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: contextProvider
         });
         Object.defineProperty(this, "roundTripperFactory", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: roundTripperFactory
         });
         Object.defineProperty(this, "router", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: router
         });
         Object.defineProperty(this, "connectionProvider", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: connectionProvider
         });
         Object.defineProperty(this, "registeredWorkflows", {
             enumerable: true,
@@ -52,26 +54,28 @@ export class MemoryInterpreter {
             writable: true,
             value: []
         });
-        this.log = options.logger || new ConsoleLogger('debug');
-        this.compiler = options.compiler || new ObservableCompiler();
-        this.contextProvider = options.contextProvider || new ContextProviderImpl(this.log);
-        this.roundTripperFactory = options.skipVersoriCredentials ? new DefaultRoundTripperFactory() : VersoriRoundTripperFactory.fromEnv(this.log);
-        this.router = express.Router();
-        this.connectionProvider = PlatformAPIClient.fromEnv();
+    }
+    static async newInstance(options = {}) {
+        const log = options.logger || new ConsoleLogger('debug');
+        const compiler = options.compiler || new ObservableCompiler();
+        const roundTripperFactory = options.skipVersoriCredentials
+            ? new DefaultRoundTripperFactory()
+            : VersoriRoundTripperFactory.fromEnv(log);
+        if (options.contextProvider) {
+            // no need to set up a key-value provider if options.contextProvider is already
+            // initialised.
+            return new MemoryInterpreter(log, compiler, options.contextProvider, roundTripperFactory, express.Router(), PlatformAPIClient.fromEnv());
+        }
+        const kvp = await (options.skipVersoriCredentials
+            ? new MemoryKeyValueProvider()
+            : NatsKeyValueProvider.fromEnv());
+        return new MemoryInterpreter(log, compiler, new ContextProviderImpl(log, kvp), roundTripperFactory, express.Router(), PlatformAPIClient.fromEnv());
     }
     register(workflow, options) {
-        const registration = {
-            trigger$: null,
-            task$: null,
-            localAbortController: new AbortController(),
-            sigintListener: () => {
-                this.log.info('Received SIGINT, shutting down workflow');
-                registration.localAbortController.abort();
-            }
-        };
+        const localAbortController = new AbortController();
         const combinedSignal = options?.signal
-            ? AbortSignal.any([registration.localAbortController.signal, options.signal])
-            : registration.localAbortController.signal;
+            ? AbortSignal.any([localAbortController.signal, options.signal])
+            : localAbortController.signal;
         if (!(workflow instanceof WorkflowImpl)) {
             throw new Error('workflow is not an instance of WorkflowImpl');
         }
@@ -84,13 +88,22 @@ export class MemoryInterpreter {
             router: this.router,
             connectionProvider: this.connectionProvider
         };
-        registration.trigger$ = this.compiler.compileTrigger(compilerContext, workflow.trigger, combinedSignal);
-        registration.task$ = this.compiler.compileTask(compilerContext, workflow.task);
+        const trigger$ = this.compiler.compileTrigger(compilerContext, workflow.trigger, combinedSignal);
+        const task$ = this.compiler.compileTask(compilerContext, workflow.task);
+        const registration = {
+            trigger$,
+            task$,
+            localAbortController,
+            sigintListener: () => {
+                this.log.info('Received SIGINT, shutting down workflow');
+                localAbortController.abort();
+            }
+        };
         this.registeredWorkflows.push(registration);
         return registration;
     }
     async start() {
-        const port = 3000;
+        const port = dntShim.Deno.env.get('PORT') || 3000;
         const app = express();
         app.use(express.json()); // Add JSON body parser middleware
         // Add health check route
@@ -116,6 +129,7 @@ export class MemoryInterpreter {
                         durationMs,
                         data: ctx.data,
                     });
+                    this.contextProvider.destroy(ctx);
                 },
                 error: (err) => {
                     this.log.error('MemoryInterpreter.error', { error: err });

package/esm/src/interpreter/memory/compilers/webhook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../../../src/src/interpreter/memory/compilers/webhook.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAM7C,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,WAAW,EAAE,cAAc,CA6DxE,CAAC"}
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../../../src/src/interpreter/memory/compilers/webhook.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAK7C,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,WAAW,EAAE,cAAc,CAwGxE,CAAC"}

package/esm/src/interpreter/memory/compilers/webhook.js

@@ -15,29 +15,57 @@ export const webhookCompiler = {
                 const executionCtx = ctx.contextProvider.create(req.body, undefined);
                 try {
                     subscriber.next(executionCtx);
-                    res.status(200).json({ status: "accepted" });
+                    res.status(200).json({ status: 'accepted' });
                 }
                 catch (error) {
                     const message = error instanceof Error ? error.message : 'Unknown error';
                     executionCtx.log.error('webhook execution error', { error });
-                    res.status(500).json({ status: "error", message });
+                    res.status(500).json({ status: 'error', message });
                 }
             });
-            ctx.router.post(`/${trigger.id}/:activationId`, (req, res) => {
+            // this endpoint will trigger the workflow for each activation given by the external user ID
+            ctx.router.post(`/${trigger.id}/users/:userId`, async (req, res) => {
+                const userId = req.params.userId || undefined;
+                if (!userId) {
+                    res.status(400).json({ status: 'error', message: 'User ID is required' });
+                    return;
+                }
+                const activations = await ctx.connectionProvider.getUserActivations(userId);
+                if (!activations || activations.length === 0) {
+                    res.status(404).json({ status: 'error', message: `No activations found for user: ${userId}` });
+                    return;
+                }
+                activations.forEach((activation) => {
+                    const executionCtx = ctx.contextProvider.create(req.body, activation);
+                    try {
+                        subscriber.next(executionCtx);
+                    }
+                    catch (error) {
+                        const message = error instanceof Error ? error.message : 'Unknown error';
+                        executionCtx.log.error('webhook execution error', { error });
+                        res.status(500).json({ status: 'error', message });
+                    }
+                });
+                res.status(200).json({ status: 'accepted' });
+            });
+            // this endpoint will trigger the workflow only for the activation given by its ID
+            ctx.router.post(`/${trigger.id}/activations/:activationId`, async (req, res) => {
                 const activationId = req.params.activationId || undefined;
-                let activation = undefined;
-                if (activationId) {
-                    activation = { id: activationId };
+                const activation = await ctx.connectionProvider.getActivation(activationId);
+                if (!activation) {
+                    // TODO report back actual errors
+                    res.status(404).json({ status: 'error', message: `No activation found for ID: ${activationId}` });
+                    return;
                 }
                 const executionCtx = ctx.contextProvider.create(req.body, activation);
                 try {
                     subscriber.next(executionCtx);
-                    res.status(200).json({ status: "accepted" });
+                    res.status(200).json({ status: 'accepted' });
                 }
                 catch (error) {
                     const message = error instanceof Error ? error.message : 'Unknown error';
                     executionCtx.log.error('webhook execution error', { error });
-                    res.status(500).json({ status: "error", message });
+                    res.status(500).json({ status: 'error', message });
                 }
             });
             function cleanup() {
@@ -50,5 +78,5 @@ export const webhookCompiler = {
                 ctx.log.debug('webhook execution unsubscribed');
             };
         });
-    }
+    },
 };

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

@@ -1,20 +1,44 @@
+type GetOptionsMaybeDefault<T> = {
+    defaultValue?: T;
+    throwOnNotFound?: false;
+};
+type GetOptionsWithDefault<T> = {
+    defaultValue: T;
+    throwOnNotFound?: false;
+};
+type GetOptionsWithThrow<T> = {
+    throwOnNotFound: true;
+};
+export type GetOptions<T> = GetOptionsMaybeDefault<T> | GetOptionsWithDefault<T> | GetOptionsWithThrow<T>;
 export interface KeyValue {
-    get<T>(key: string): Promise<T>;
+    get<T = any>(key: string, options: GetOptionsWithDefault<T> | GetOptionsWithThrow<T>): Promise<T>;
+    get<T = any>(key: string, options?: GetOptionsMaybeDefault<T>): Promise<T | undefined>;
+    get<T = any>(key: string, options?: GetOptions<T>): Promise<T | undefined>;
     set<T>(key: string, value: T): Promise<void>;
     delete(key: string): Promise<void>;
 }
 export type KeyValueScope = ':execution:' | ':project:' | ':organization:';
+type KVOptionsExecution = {
+    scope: ':execution:';
+    executionId: string;
+};
+export declare function isKVOptionsExecution(options: KVOptions): options is KVOptionsExecution;
+type KVOptionsNotExecution = {
+    scope: Exclude<KeyValueScope, ':execution:'>;
+};
+export type KVOptions = (KVOptionsExecution | KVOptionsNotExecution) & {
+    activationId?: string;
+};
+export type DestroyOptions = KVOptions;
 export interface KeyValueProvider {
     /**
      * Get a KeyValue store for the given scope.
      *
-     * @param scope The scope of the key value store. Whilst only local development is supported, the
-     *   scope is limited to ':project:' or ':execution:'.
+     * @param options configures which KV store to open.
      * @returns A key value store.
      */
-    kv(scope?: Omit<KeyValueScope, ':execution:'>): KeyValue;
-    kv(scope: ':execution:', executionId: string): KeyValue;
-    destroy(scope?: Omit<KeyValueScope, ':execution:'>): Promise<void>;
-    destroy(scope: ':execution:', executionId: string): Promise<void>;
+    kv(options: KVOptions): KeyValue;
+    destroy(scope: DestroyOptions): Promise<void>;
 }
+export {};
 //# sourceMappingURL=KeyValue.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"KeyValue.d.ts","sourceRoot":"","sources":["../../../src/src/kv/KeyValue.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACrB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,WAAW,GAAE,gBAAgB,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC7B;;;;;;OAMG;IACH,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC;IACzD,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC;IAExD,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE"}
+{"version":3,"file":"KeyValue.d.ts","sourceRoot":"","sources":["../../../src/src/kv/KeyValue.ts"],"names":[],"mappings":"AAAA,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,EACX,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,EAAE,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACvF,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE3E,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;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"}

package/esm/src/kv/KeyValue.js

@@ -1 +1,5 @@
-export {};
+export function isKVOptionsExecution(options) {
+    return options.scope === ':execution:' &&
+        typeof options.executionId === 'string' &&
+        options.executionId.length > 0;
+}

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

@@ -1,7 +1,7 @@
-import { KeyValue } from '../KeyValue.js';
+import { GetOptions, KeyValue } from '../KeyValue.js';
 export declare class MemoryKeyValue implements KeyValue {
     private store;
-    get<T = any>(key: string): Promise<T>;
+    get<T>(key: string, options?: GetOptions<T>): Promise<T | undefined>;
     set<T>(key: string, value: T): Promise<void>;
     delete(key: string): Promise<void>;
 }

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,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,qBAAa,cAAe,YAAW,QAAQ;IAC3C,OAAO,CAAC,KAAK,CAAmC;IAEhD,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAUrC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKrC"}
+{"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;AAGtD,qBAAa,cAAe,YAAW,QAAQ;IAC3C,OAAO,CAAC,KAAK,CAAmC;IAEhD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAcpE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKrC"}

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

@@ -8,10 +8,13 @@ export class MemoryKeyValue {
             value: new Map()
         });
     }
-    get(key) {
+    get(key, options) {
         const raw = this.store.get(key);
         if (typeof raw === 'undefined') {
-            throw new KVNotFoundError(key);
+            if (options?.throwOnNotFound) {
+                throw new KVNotFoundError(key);
+            }
+            return Promise.resolve(undefined);
         }
         return Promise.resolve(raw);
     }

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

@@ -1,11 +1,9 @@
-import { KeyValue, KeyValueProvider, KeyValueScope } from '../KeyValue.js';
+import { DestroyOptions, KeyValue, KeyValueProvider, KVOptions } from '../KeyValue.js';
 export declare class MemoryKeyValueProvider implements KeyValueProvider {
     private executionKv;
     private projectKv;
-    kv(scope?: Omit<KeyValueScope, ':execution:'>): KeyValue;
-    kv(scope: ':execution:', executionId: string): KeyValue;
-    destroy(scope?: Omit<KeyValueScope, ':execution:'>): Promise<void>;
-    destroy(scope: ':execution:', executionId: string): Promise<void>;
+    kv(options: KVOptions): KeyValue;
+    destroy(options: DestroyOptions): Promise<void>;
     private getExecutionKv;
 }
 //# 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,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG3E,qBAAa,sBAAuB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,WAAW,CAAoC;IAEvD,OAAO,CAAC,SAAS,CAAkC;IAEnD,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,GAAG,QAAQ;IACxD,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ;IAgBvD,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAClE,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjE,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/esm/src/kv/memory/MemoryKeyValueProvider.js

@@ -14,26 +14,26 @@ export class MemoryKeyValueProvider {
             value: new MemoryKeyValue()
         });
     }
-    kv(scope, executionId) {
-        switch (scope) {
+    kv(options) {
+        switch (options.scope) {
             case ':execution:':
-                if (typeof executionId === 'undefined') {
+                if (typeof options.executionId === 'undefined') {
                     throw new Error('executionId is required when scope is :execution:');
                 }
-                return this.getExecutionKv(executionId);
+                return this.getExecutionKv(options.executionId);
             case ':project:':
                 return this.projectKv;
             default:
-                throw new Error(`Unsupported scope: ${scope}`);
+                throw new Error(`Unsupported scope: ${options.scope}`);
         }
     }
-    destroy(scope, executionId) {
-        switch (scope) {
+    destroy(options) {
+        switch (options.scope) {
             case ':execution:':
-                if (typeof executionId === 'undefined') {
+                if (typeof options.executionId === 'undefined') {
                     throw new Error('executionId is required when scope is :execution:');
                 }
-                this.executionKv.delete(executionId);
+                this.executionKv.delete(options.executionId);
                 return Promise.resolve();
             default:
                 return Promise.resolve();

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

@@ -0,0 +1,12 @@
+import { KV } from '../../../deps/jsr.io/@nats-io/kv/3.0.2/src/mod.js';
+import { GetOptions, KeyValue } from '../KeyValue.js';
+export declare class NatsKeyValue implements KeyValue {
+    private readonly kv;
+    private readonly prefix;
+    constructor(kv: KV, prefix: string);
+    get<T>(key: string, options?: GetOptions<T>): Promise<T | undefined>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    private generateKey;
+}
+//# sourceMappingURL=NatsKeyValue.d.ts.map

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

@@ -0,0 +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;AAGtD,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,EAAE,OAAO,GAAE,UAAU,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAwBxE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,OAAO,CAAC,WAAW;CAGtB"}

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

@@ -0,0 +1,47 @@
+import { KVNotFoundError } from '../KVNotFoundError.js';
+export class NatsKeyValue {
+    constructor(kv, prefix) {
+        Object.defineProperty(this, "kv", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: kv
+        });
+        Object.defineProperty(this, "prefix", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: prefix
+        });
+    }
+    async get(key, options = {}) {
+        let entry;
+        try {
+            entry = await this.kv.get(this.generateKey(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);
+            }
+            else if (typeof options.defaultValue !== 'undefined') {
+                return options.defaultValue;
+            }
+            return undefined;
+        }
+        return entry.json();
+    }
+    async set(key, value) {
+        const payload = JSON.stringify(value);
+        await this.kv.put(this.generateKey(key), payload);
+    }
+    async delete(key) {
+        await this.kv.delete(this.generateKey(key));
+    }
+    generateKey(key) {
+        return `${this.prefix}.${key}`;
+    }
+}

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

@@ -0,0 +1,27 @@
+import { TlsOptions } from '../../../deps/jsr.io/@nats-io/transport-deno/3.0.2/src/mod.js';
+import { DestroyOptions, KeyValue, KeyValueProvider, KVOptions } from '../KeyValue.js';
+export type NatsKeyValueProviderOptions = {
+    organizationId: string;
+    projectId: string;
+    environment: string;
+    nats: {
+        url: string;
+        credsFile?: string;
+        tls?: TlsOptions;
+    };
+};
+export declare class NatsKeyValueProvider implements KeyValueProvider, AsyncDisposable {
+    private readonly kvm;
+    private readonly kvOrgScope;
+    private readonly kvProjectScope;
+    private readonly kvExecutionScope;
+    private readonly opts;
+    private constructor();
+    static newInstance(opts?: Partial<NatsKeyValueProviderOptions>): Promise<NatsKeyValueProvider>;
+    static fromEnv(): Promise<NatsKeyValueProvider>;
+    [Symbol.asyncDispose](): PromiseLike<void>;
+    kv(options: KVOptions): KeyValue;
+    destroy(options: DestroyOptions): Promise<void>;
+    private subjectPrefix;
+}
+//# sourceMappingURL=NatsKeyValueProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NatsKeyValueProvider.d.ts","sourceRoot":"","sources":["../../../../src/src/kv/nats/NatsKeyValueProvider.ts"],"names":[],"mappings":"AAGA,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;IAuBrD,OAAO,CAAC,aAAa;CAYxB"}

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

@@ -0,0 +1,155 @@
+import * as dntShim from "../../../_dnt.shims.js";
+import { JetStreamApiCodes, JetStreamApiError } from '../../../deps/jsr.io/@nats-io/jetstream/3.0.2/src/mod.js';
+import { Kvm } from '../../../deps/jsr.io/@nats-io/kv/3.0.2/src/mod.js';
+import { connect, credsAuthenticator } from '../../../deps/jsr.io/@nats-io/transport-deno/3.0.2/src/mod.js';
+import { isKVOptionsExecution, } from '../KeyValue.js';
+import { NatsKeyValue } from './NatsKeyValue.js';
+function getOptionsFromEnv() {
+    const natsTlsCaFile = dntShim.Deno.env.get('RUN_NATS_TLS_CA_FILE');
+    return {
+        organizationId: dntShim.Deno.env.get('RUN_ORGANISATION_ID'),
+        projectId: dntShim.Deno.env.get('RUN_SERVICE_ID'),
+        environment: dntShim.Deno.env.get('RUN_ENVIRONMENT'),
+        nats: {
+            url: dntShim.Deno.env.get('RUN_NATS_URL') || 'nats://localhost:4222',
+            credsFile: dntShim.Deno.env.get('RUN_NATS_CREDS_FILE'),
+            ...(natsTlsCaFile && {
+                tls: {
+                    caFile: natsTlsCaFile,
+                },
+            }),
+        },
+    };
+}
+function mergeOptions(defaults, provided) {
+    const merged = {
+        ...defaults,
+        ...provided,
+    };
+    if (!merged.organizationId) {
+        throw new Error('organizationId is required but not provided and VERSORI_ORGANIZATION_ID is not set');
+    }
+    if (!merged.projectId) {
+        throw new Error('projectId is required but not provided and VERSORI_PROJECT_ID is not set');
+    }
+    return merged;
+}
+async function openOrCreateKV(kvm, bucket) {
+    try {
+        const kv = await kvm.open(bucket);
+        await kv.status();
+        return kv;
+    }
+    catch (error) {
+        if (error instanceof JetStreamApiError &&
+            error.code === JetStreamApiCodes.StreamNotFound) {
+            console.log('stream not found, creating...');
+            return await kvm.create(bucket);
+        }
+        throw error;
+    }
+}
+export class NatsKeyValueProvider {
+    constructor(kvm, kvOrgScope, kvProjectScope, kvExecutionScope, opts) {
+        Object.defineProperty(this, "kvm", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: kvm
+        });
+        Object.defineProperty(this, "kvOrgScope", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: kvOrgScope
+        });
+        Object.defineProperty(this, "kvProjectScope", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: kvProjectScope
+        });
+        Object.defineProperty(this, "kvExecutionScope", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: kvExecutionScope
+        });
+        Object.defineProperty(this, "opts", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: opts
+        });
+    }
+    static async newInstance(opts = {}) {
+        const parsedOpts = mergeOptions(getOptionsFromEnv(), opts);
+        const credsFile = parsedOpts.nats.credsFile
+            ? await dntShim.Deno.readFile(parsedOpts.nats.credsFile)
+            : undefined;
+        const conn = await connect({
+            servers: [parsedOpts.nats.url],
+            authenticator: credsFile ? credsAuthenticator(credsFile) : undefined,
+            ...(parsedOpts.nats.tls && {
+                tls: parsedOpts.nats.tls,
+            }),
+        });
+        const kvm = new Kvm(conn);
+        const [orgKv, projKv, execKv] = await Promise.all([
+            openOrCreateKV(kvm, `ORG_${parsedOpts.organizationId}`),
+            openOrCreateKV(kvm, `PROJECT_${parsedOpts.projectId}`),
+            openOrCreateKV(kvm, `EXECUTION_${parsedOpts.projectId}`),
+        ]);
+        return new NatsKeyValueProvider(kvm, orgKv, projKv, execKv, parsedOpts);
+    }
+    static fromEnv() {
+        return NatsKeyValueProvider.newInstance(getOptionsFromEnv());
+    }
+    [Symbol.asyncDispose]() {
+        return this.kvm.js.nc.close();
+    }
+    kv(options) {
+        switch (options.scope) {
+            case ':organization:':
+                return new NatsKeyValue(this.kvOrgScope, this.subjectPrefix(options));
+            case ':project:':
+                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');
+                }
+                return new NatsKeyValue(this.kvExecutionScope, this.subjectPrefix(options));
+            default:
+                throw new Error(`invalid KV options, scope ${options.scope} is not supported`);
+        }
+    }
+    async destroy(options) {
+        if (options.scope === ':execution:') {
+            if (typeof options.executionId === 'undefined') {
+                throw new Error('executionId is required when scope is :execution:');
+            }
+            const keys = await this.kvExecutionScope.keys(`${this.subjectPrefix(options)}.>`);
+            for await (const key of keys) {
+                try {
+                    await this.kvExecutionScope.purge(key);
+                }
+                catch (error) {
+                    console.error(`Failed to purge key: ${key}`, error);
+                }
+            }
+        }
+        // TODO: interface may need updating, workers should not be deleting KV buckets, only execution keys should be purged.
+        return;
+    }
+    subjectPrefix(options) {
+        const activationSuffix = options.activationId ? `.${options.activationId}` : '';
+        switch (options.scope) {
+            case ':organization:':
+                return `${this.opts.organizationId}${activationSuffix}`;
+            case ':project:':
+                return `${this.opts.organizationId}.${this.opts.projectId}.${this.opts.environment}${activationSuffix}`;
+            case ':execution:':
+                return `${this.opts.organizationId}.${this.opts.projectId}.${this.opts.environment}.${options.executionId}${activationSuffix}`;
+        }
+    }
+}