@versori/run 0.1.0-alpha.8 → 0.2.0-alpha.1

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

@@ -1,50 +1,51 @@
-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 +53,51 @@ 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();
+        Object.defineProperty(this, "server", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "shutdownServer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "isShuttingDown", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        if (typeof this.log === 'undefined') {
+            // this captures the old way of instantiating the MemoryInterpreter and provides an 
+            // error message back to the user to let them know they should use the new way.
+            throw new Error('MemoryInterpreter should not be instantiated directly. Use MemoryInterpreter.newInstance() instead.');
+        }
+    }
+    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 +110,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 = Deno.env.get('PORT') || 3000;
         const app = express();
         app.use(express.json()); // Add JSON body parser middleware
         // Add health check route
@@ -101,12 +136,13 @@ export class MemoryInterpreter {
         app.use(this.router);
         // Start all registered workflows
         for (const registration of this.registeredWorkflows) {
-            dntShim.Deno.addSignalListener('SIGINT', registration.sigintListener);
-            registration.trigger$
+            Deno.addSignalListener('SIGINT', registration.sigintListener);
+            registration.subscription = registration.trigger$
                 .pipe(tap((ctx) => {
                 ctx.log.info('MemoryInterpreter.executionStarted', { data: ctx.data });
             }), mergeMap((ctx) => of(ctx).pipe(registration.task$, catchError((error) => {
                 ctx.log.error('MemoryInterpreter.executionError', { error });
+                ctx.options.onError?.(ctx.withData(error));
                 return EMPTY;
             }))))
                 .subscribe({
@@ -116,19 +152,66 @@ export class MemoryInterpreter {
                         durationMs,
                         data: ctx.data,
                     });
+                    ctx.options.onSuccess?.(ctx);
+                    this.contextProvider.destroy(ctx);
                 },
                 error: (err) => {
                     this.log.error('MemoryInterpreter.error', { error: err });
-                    dntShim.Deno.removeSignalListener('SIGINT', registration.sigintListener);
+                    Deno.removeSignalListener('SIGINT', registration.sigintListener);
                 },
                 complete: () => {
                     this.log.info('MemoryInterpreter.workflowCompleted');
-                    dntShim.Deno.removeSignalListener('SIGINT', registration.sigintListener);
+                    Deno.removeSignalListener('SIGINT', registration.sigintListener);
                 },
             });
+            registration.subscription.add(() => {
+                registration.subscription = undefined;
+            });
         }
-        app.listen(port, () => {
+        this.server = app.listen(port, () => {
             this.log.info(`Express server listening on http://localhost:${port}`);
         });
+        this.shutdownServer = () => {
+            if (this.isShuttingDown) {
+                return;
+            }
+            this.isShuttingDown = true;
+            this.log.info('Shutting down server');
+            // Close the server
+            if (this.server) {
+                this.server.close();
+            }
+            // Remove all signal listeners
+            for (const registration of this.registeredWorkflows) {
+                Deno.removeSignalListener('SIGINT', registration.sigintListener);
+                // Unsubscribe from all observables
+                if (registration.subscription) {
+                    registration.subscription.unsubscribe();
+                }
+                // Abort all controllers
+                registration.localAbortController.abort();
+            }
+            // Remove the server shutdown listener
+            if (this.shutdownServer) {
+                Deno.removeSignalListener('SIGINT', this.shutdownServer);
+            }
+        };
+        Deno.addSignalListener('SIGINT', this.shutdownServer);
+        return new Promise((resolve) => {
+            if (this.server) {
+                this.server.on('close', () => {
+                    this.log.info('Server closed');
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    async stop() {
+        if (this.shutdownServer) {
+            this.shutdownServer();
+        }
     }
 }

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

@@ -30,7 +30,7 @@ function compileSchedule(ctx, trigger, signal) {
                     return;
                 }
                 activations.forEach((activation) => {
-                    const executionCtx = ctx.contextProvider.create({}, activation);
+                    const executionCtx = ctx.contextProvider.create({}, { activation });
                     executionCtx.log.info('no activations found, continuing');
                     try {
                         subscriber.next(executionCtx);

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":"AAOA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAgD7C,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,WAAW,EAAE,cAAc,CA+LxE,CAAC"}

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

@@ -1,43 +1,169 @@
 // In src/interpreter/memory/compilers/webhook.ts
+import cors from 'cors';
 import { Observable } from 'rxjs';
+import { pipeline } from 'node:stream/promises';
 import { WebhookTrigger } from '../../../dsl/triggers/WebhookTrigger.js';
+const DEFAULT_SYNC_ON_SUCCESS = (ctx) => new Response(JSON.stringify(ctx.data), {
+    status: 200,
+    headers: {
+        'Content-Type': 'application/json',
+        'X-Execution-Id': ctx.executionId,
+    },
+});
+const DEFAULT_SYNC_ON_ERROR = (ctx) => new Response(JSON.stringify({ message: 'Internal server error', error: ctx.data }), {
+    status: 500,
+    headers: {
+        'Content-Type': 'application/json',
+        'X-Execution-Id': ctx.executionId,
+    },
+});
+const DEFAULT_ASYNC_ON_SUCCESS = (ctx) => new Response(JSON.stringify({
+    status: 'accepted',
+    executionId: ctx.executionId,
+}), {
+    status: 202,
+    headers: {
+        'Content-Type': 'application/json',
+        'X-Execution-Id': ctx.executionId,
+    },
+});
+const DEFAULT_ASYNC_ON_ERROR = (ctx) => new Response(JSON.stringify({
+    message: 'Internal server error',
+    executionId: ctx.executionId,
+}), {
+    status: 500,
+    headers: {
+        'Content-Type': 'application/json',
+        'X-Execution-Id': ctx.executionId,
+    },
+});
 export const webhookCompiler = {
     ctor: WebhookTrigger,
     compile: (ctx, trigger, signal) => {
+        const { response: { mode = 'async', } = {}, cors: corsOptions, } = trigger.options;
+        const isSync = mode === 'sync';
+        const isAsync = mode === 'async';
+        if (!isSync && !isAsync) {
+            throw new Error('Invalid response mode, must be either "sync" or "async"');
+        }
+        let onSuccess = isSync ? DEFAULT_SYNC_ON_SUCCESS : DEFAULT_ASYNC_ON_SUCCESS;
+        let onError = isSync ? DEFAULT_SYNC_ON_ERROR : DEFAULT_ASYNC_ON_ERROR;
+        if (trigger.options.response?.onSuccess) {
+            onSuccess = trigger.options.response.onSuccess;
+        }
+        if (trigger.options.response?.onError) {
+            onError = trigger.options.response.onError;
+        }
+        const ctxOptionsFn = (res) => ({
+            onSuccess: (ctx) => {
+                if (isSync) {
+                    sendResponse(res, onSuccess(ctx));
+                }
+            },
+            onError: (ctx) => {
+                if (isSync) {
+                    sendResponse(res, onError(ctx));
+                }
+            },
+        });
         return new Observable((subscriber) => {
             if (!ctx.router) {
                 throw new Error('Router not available in compiler context');
             }
             // add the webhook endpoint to the router
             ctx.log.info('webhook endpoint added:', { trigger });
+            if (corsOptions) {
+                if (typeof corsOptions === 'boolean') {
+                    ctx.router.use(cors());
+                }
+                else {
+                    ctx.router.use(cors(corsOptions));
+                }
+            }
             // endpoint for sans user because I'm not quite sure how the dynamic routing works
             ctx.router.post(`/${trigger.id}`, (req, res) => {
-                const executionCtx = ctx.contextProvider.create(req.body, undefined);
+                const executionCtx = ctx.contextProvider.create(req.body, ctxOptionsFn(res));
                 try {
                     subscriber.next(executionCtx);
-                    res.status(200).json({ status: "accepted" });
+                    if (isAsync) {
+                        sendResponse(res, onSuccess(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 });
+                    executionCtx.log.error('webhook execution error', {
+                        error: JSON.stringify(error),
+                    });
+                    if (isAsync) {
+                        sendResponse(res, onError(executionCtx.withData(error)));
+                    }
                 }
             });
-            ctx.router.post(`/${trigger.id}/:activationId`, (req, res) => {
-                const activationId = req.params.activationId || undefined;
-                let activation = undefined;
-                if (activationId) {
-                    activation = { id: activationId };
+            // 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;
+                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;
                 }
-                const executionCtx = ctx.contextProvider.create(req.body, activation);
+                const executionCtx = ctx.contextProvider.create(req.body, ctxOptionsFn(res));
+                const errors = [];
+                activations.forEach((activation) => {
+                    const activationCtx = executionCtx.withActivation(activation);
+                    try {
+                        subscriber.next(activationCtx);
+                    }
+                    catch (error) {
+                        activationCtx.log.error('webhook execution error', {
+                            error: JSON.stringify(error),
+                        });
+                        errors.push({
+                            activationId: activation.id,
+                            error,
+                        });
+                    }
+                });
+                if (isAsync) {
+                    if (errors.length === 0) {
+                        sendResponse(res, onSuccess(executionCtx));
+                    }
+                    else {
+                        sendResponse(res, onError(executionCtx.withData(errors)));
+                    }
+                }
+            });
+            // 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;
+                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 activationCtx = ctx.contextProvider.create(req.body, {
+                    ...ctxOptionsFn(res),
+                    activation,
+                });
                 try {
-                    subscriber.next(executionCtx);
-                    res.status(200).json({ status: "accepted" });
+                    subscriber.next(activationCtx);
+                    if (isAsync) {
+                        sendResponse(res, onSuccess(activationCtx));
+                    }
                 }
                 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 });
+                    activationCtx.log.error('webhook execution error', {
+                        error: JSON.stringify(error),
+                    });
+                    if (isAsync) {
+                        sendResponse(res, onError(activationCtx.withData(error)));
+                    }
                 }
             });
             function cleanup() {
@@ -50,5 +176,14 @@ export const webhookCompiler = {
                 ctx.log.debug('webhook execution unsubscribed');
             };
         });
-    }
+    },
 };
+function sendResponse(res, response) {
+    res.status(response.status);
+    response.headers.forEach((value, key) => {
+        res.setHeader(key, value);
+    });
+    if (response.body) {
+        pipeline(response.body, res);
+    }
+}

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"}