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

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

@@ -3,6 +3,7 @@ var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HttpContextImpl = exports.HttpTaskImpl = void 0;
 exports.http = http;
+const Context_js_1 = require("../../context/Context.js");
 const ensureTask_js_1 = require("../ensureTask.js");
 const types_js_1 = require("../http/types.js");
 const Task_js_1 = require("../Task.js");
@@ -61,38 +62,11 @@ class HttpTaskImpl {
 }
 exports.HttpTaskImpl = HttpTaskImpl;
 _a = Task_js_1.TaskType;
-class HttpContextImpl {
+class HttpContextImpl extends Context_js_1.ContextImpl {
     constructor(ctx, connectionVars, staticFetcher, dynamicFetcher, pageParams) {
-        Object.defineProperty(this, "log", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "startTime", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "executionId", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "activation", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "data", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
+        // We need to cast ctx to InternalContext to access kvp
+        const internalCtx = ctx;
+        super(ctx.log, internalCtx.kvp, ctx.executionId, ctx.startTime, ctx.data, ctx.activation);
         Object.defineProperty(this, "connectionVariables", {
             enumerable: true,
             configurable: true,
@@ -104,7 +78,8 @@ class HttpContextImpl {
             configurable: true,
             writable: true,
             value: void 0
-        }); // TODO: Implement page params
+        });
+        // ideally only one of these should be set to a value
         Object.defineProperty(this, "dynamicFetcher", {
             enumerable: true,
             configurable: true,
@@ -117,26 +92,14 @@ class HttpContextImpl {
             writable: true,
             value: void 0
         });
-        this.log = ctx.log;
-        this.executionId = ctx.executionId;
-        this.startTime = ctx.startTime;
-        this.activation = ctx.activation;
-        this.data = ctx.data;
         this.pageParams = pageParams;
         this.connectionVariables = connectionVars;
         this.dynamicFetcher = dynamicFetcher;
         this.staticFetcher = staticFetcher;
     }
     get fetch() {
-        // TODO: this will need some work to make dynamic and static connections work in tandem.
-        let fetch;
-        if (this.dynamicFetcher && this.activation) {
-            fetch = (0, types_js_1.wrapDynamicFetcher)(this.dynamicFetcher, this.activation.id);
-        }
-        else {
-            fetch = this.staticFetcher;
-        }
-        return fetch;
+        // This is maybe hard to read.
+        return this.dynamicFetcher && this.activation ? (0, types_js_1.wrapDynamicFetcher)(this.dynamicFetcher, this.activation) : this.staticFetcher ?? globalThis.fetch;
     }
     async nextPage(nextParams) {
         throw new Error("Method not implemented.");

package/script/src/interpreter/memory/MemoryInterpreter.d.ts

@@ -1,7 +1,11 @@
+import { Router } from 'express';
+import { Observable } from 'rxjs';
 import { ContextProvider } from '../../context/ContextProvider.js';
+import { ConnectionProvider, RoundTripperFactory } from '../../dsl/http/types.js';
 import { Workflow } from '../../dsl/Workflow.js';
 import { Logger } from '../../observability/logging/Logger.js';
 import { ObservableCompiler } from './ObservableCompiler.js';
+import { ContextImpl, ContextOperatorFunction } from '../../mod.js';
 export type MemoryInterpreterOptions = {
     logger?: Logger;
     compiler?: ObservableCompiler;
@@ -9,21 +13,24 @@ export type MemoryInterpreterOptions = {
     signal?: AbortSignal;
     skipVersoriCredentials?: boolean;
 };
+type Registration = {
+    trigger$: Observable<ContextImpl<any, void>>;
+    task$: ContextOperatorFunction<any, any, any>;
+    localAbortController: AbortController;
+    sigintListener: () => void;
+};
 export declare class MemoryInterpreter {
-    private log;
-    private compiler;
-    private contextProvider;
-    private roundTripperFactory;
-    private router;
-    private connectionProvider;
+    private readonly log;
+    private readonly compiler;
+    private readonly contextProvider;
+    private readonly roundTripperFactory;
+    private readonly router;
+    private readonly connectionProvider;
     private registeredWorkflows;
-    constructor(options?: MemoryInterpreterOptions);
-    register<O>(workflow: Workflow<O>, options?: MemoryInterpreterOptions): {
-        trigger$: any;
-        task$: any;
-        localAbortController: AbortController;
-        sigintListener: () => void;
-    };
+    constructor(log: Logger, compiler: ObservableCompiler, contextProvider: ContextProvider, roundTripperFactory: RoundTripperFactory, router: Router, connectionProvider: ConnectionProvider);
+    static newInstance(options?: MemoryInterpreterOptions): Promise<MemoryInterpreter>;
+    register<O>(workflow: Workflow<O>, options?: MemoryInterpreterOptions): Registration;
     start(): Promise<void>;
 }
+export {};
 //# sourceMappingURL=MemoryInterpreter.d.ts.map

package/script/src/interpreter/memory/MemoryInterpreter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemoryInterpreter.d.ts","sourceRoot":"","sources":["../../../../src/src/interpreter/memory/MemoryInterpreter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAuB,MAAM,kCAAkC,CAAC;AACxF,OAAO,EAAE,QAAQ,EAAgB,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAC/D,OAAO,EAAmB,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAQ9E,MAAM,MAAM,wBAAwB,GAAG;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CACpC,CAAC;AAEF,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,kBAAkB,CAAqB;IAE/C,OAAO,CAAC,mBAAmB,CAKnB;gBAEI,OAAO,GAAE,wBAA6B;IASlD,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,wBAAwB;kBAE3C,GAAG;eACN,GAAG;;;;IAuCpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAwD/B"}
+{"version":3,"file":"MemoryInterpreter.d.ts","sourceRoot":"","sources":["../../../../src/src/interpreter/memory/MemoryInterpreter.ts"],"names":[],"mappings":"AACA,OAAgB,EAAqB,MAAM,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAA+B,UAAU,EAAW,MAAM,MAAM,CAAC;AACxE,OAAO,EAAE,eAAe,EAAuB,MAAM,kCAAkC,CAAC;AAExF,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGlF,OAAO,EAAE,QAAQ,EAAgB,MAAM,uBAAuB,CAAC;AAI/D,OAAO,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AAC/D,OAAO,EAAmB,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,MAAM,wBAAwB,GAAG;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CACpC,CAAC;AAEF,KAAK,YAAY,GAAG;IAChB,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7C,KAAK,EAAE,uBAAuB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9C,oBAAoB,EAAE,eAAe,CAAC;IACtC,cAAc,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAA;AAED,qBAAa,iBAAiB;IAItB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IARvC,OAAO,CAAC,mBAAmB,CAA2B;gBAGjC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,kBAAkB,EAC5B,eAAe,EAAE,eAAe,EAChC,mBAAmB,EAAE,mBAAmB,EACxC,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,kBAAkB;WAI9C,WAAW,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoC5F,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,wBAAwB;IA6C/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA0D/B"}

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

@@ -28,52 +28,54 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MemoryInterpreter = void 0;
 const dntShim = __importStar(require("../../../_dnt.shims.js"));
+const express_1 = __importDefault(require("express"));
 const rxjs_1 = require("rxjs");
 const ContextProvider_js_1 = require("../../context/ContextProvider.js");
-const Workflow_js_1 = require("../../dsl/Workflow.js");
-const ObservableCompiler_js_1 = require("./ObservableCompiler.js");
-const ConsoleLogger_js_1 = require("../../observability/logging/ConsoleLogger.js");
 const default_js_1 = require("../../dsl/http/default.js");
-const express_1 = __importDefault(require("express"));
 const platformapi_js_1 = require("../../dsl/http/versori/platformapi.js");
 const roundtripper_js_1 = require("../../dsl/http/versori/roundtripper.js");
+const Workflow_js_1 = require("../../dsl/Workflow.js");
+const MemoryKeyValueProvider_js_1 = require("../../kv/memory/MemoryKeyValueProvider.js");
+const NatsKeyValueProvider_js_1 = require("../../kv/nats/NatsKeyValueProvider.js");
+const ConsoleLogger_js_1 = require("../../observability/logging/ConsoleLogger.js");
+const ObservableCompiler_js_1 = require("./ObservableCompiler.js");
 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,
@@ -81,26 +83,28 @@ class MemoryInterpreter {
             writable: true,
             value: []
         });
-        this.log = options.logger || new ConsoleLogger_js_1.ConsoleLogger('debug');
-        this.compiler = options.compiler || new ObservableCompiler_js_1.ObservableCompiler();
-        this.contextProvider = options.contextProvider || new ContextProvider_js_1.ContextProviderImpl(this.log);
-        this.roundTripperFactory = options.skipVersoriCredentials ? new default_js_1.DefaultRoundTripperFactory() : roundtripper_js_1.VersoriRoundTripperFactory.fromEnv(this.log);
-        this.router = express_1.default.Router();
-        this.connectionProvider = platformapi_js_1.PlatformAPIClient.fromEnv();
+    }
+    static async newInstance(options = {}) {
+        const log = options.logger || new ConsoleLogger_js_1.ConsoleLogger('debug');
+        const compiler = options.compiler || new ObservableCompiler_js_1.ObservableCompiler();
+        const roundTripperFactory = options.skipVersoriCredentials
+            ? new default_js_1.DefaultRoundTripperFactory()
+            : roundtripper_js_1.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_1.default.Router(), platformapi_js_1.PlatformAPIClient.fromEnv());
+        }
+        const kvp = await (options.skipVersoriCredentials
+            ? new MemoryKeyValueProvider_js_1.MemoryKeyValueProvider()
+            : NatsKeyValueProvider_js_1.NatsKeyValueProvider.fromEnv());
+        return new MemoryInterpreter(log, compiler, new ContextProvider_js_1.ContextProviderImpl(log, kvp), roundTripperFactory, express_1.default.Router(), platformapi_js_1.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 Workflow_js_1.WorkflowImpl)) {
             throw new Error('workflow is not an instance of WorkflowImpl');
         }
@@ -113,13 +117,22 @@ 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 = (0, express_1.default)();
         app.use(express_1.default.json()); // Add JSON body parser middleware
         // Add health check route
@@ -145,6 +158,7 @@ class MemoryInterpreter {
                         durationMs,
                         data: ctx.data,
                     });
+                    this.contextProvider.destroy(ctx);
                 },
                 error: (err) => {
                     this.log.error('MemoryInterpreter.error', { error: err });

package/script/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/script/src/interpreter/memory/compilers/webhook.js

@@ -18,29 +18,57 @@ exports.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() {
@@ -53,5 +81,5 @@ exports.webhookCompiler = {
                 ctx.log.debug('webhook execution unsubscribed');
             };
         });
-    }
+    },
 };

package/script/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/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,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/script/src/kv/KeyValue.js

@@ -1,2 +1,8 @@
 "use strict";
 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

@@ -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/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,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/script/src/kv/memory/MemoryKeyValue.js

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

package/script/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/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,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/script/src/kv/memory/MemoryKeyValueProvider.js

@@ -17,26 +17,26 @@ class MemoryKeyValueProvider {
             value: new MemoryKeyValue_js_1.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/script/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/script/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/script/src/kv/nats/NatsKeyValue.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NatsKeyValue = void 0;
+const KVNotFoundError_js_1 = require("../KVNotFoundError.js");
+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_js_1.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}`;
+    }
+}
+exports.NatsKeyValue = NatsKeyValue;

package/script/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/script/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"}