@versori/run 0.2.14 → 0.2.15

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

@@ -0,0 +1,248 @@
+import cors from 'cors';
+import { pipeline } from 'node:stream/promises';
+import { Observable } from 'rxjs';
+import { WebhookTrigger } from '../../../dsl/triggers/WebhookTrigger.js';
+import { createActIdDynamicWebhookMiddleware, createStaticWebhookMiddleware, createUserIdDynamicWebhookMiddleware } from '../../../dsl/http/versori/webhookmiddleware.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.webhookRouter) {
+                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.webhookRouter.use(cors());
+                }
+                else {
+                    ctx.webhookRouter.use(cors(corsOptions));
+                }
+            }
+            // endpoint for sans user because I'm not quite sure how the dynamic routing works
+            ctx.webhookRouter.post(`/${trigger.id}`, createStaticWebhookMiddleware({
+                id: trigger.id,
+                connName: trigger.options.connection,
+                credentials: ctx.roundTripperFactory.credentials(),
+                cnxProvider: ctx.connectionProvider,
+                cfgReader: ctx.configReader,
+                log: ctx.log,
+            }), async (req, res) => {
+                await ctx.tracer.startActiveSpan(`webhook-${trigger.id}`, async (span) => {
+                    span.setAttribute('task.id', trigger.id);
+                    span.setAttribute('task.type', 'webhook');
+                    let executionCtx = ctx.contextProvider.create(req.body, ctxOptionsFn(res));
+                    const staticActivation = res.locals.activation;
+                    if (staticActivation) {
+                        executionCtx = executionCtx.withActivation(staticActivation);
+                    }
+                    span.setAttribute('execution.id', executionCtx.executionId);
+                    try {
+                        subscriber.next(executionCtx);
+                        if (isAsync) {
+                            sendResponse(res, onSuccess(executionCtx));
+                        }
+                    }
+                    catch (error) {
+                        executionCtx.log.error('webhook execution error', {
+                            error: JSON.stringify(error),
+                        });
+                        if (isAsync) {
+                            sendResponse(res, onError(executionCtx.withData(error)));
+                        }
+                    }
+                    finally {
+                        span.end();
+                    }
+                });
+            });
+            // this endpoint will trigger the workflow for each activation given by the external user ID
+            ctx.webhookRouter.post(`/${trigger.id}/users/:userId`, createUserIdDynamicWebhookMiddleware({
+                id: trigger.id,
+                connName: trigger.options.connection,
+                credentials: ctx.roundTripperFactory.credentials(),
+                cnxProvider: ctx.connectionProvider,
+                cfgReader: ctx.configReader,
+                log: ctx.log,
+            }), async (req, res) => {
+                await ctx.tracer.startActiveSpan(`webhook-${trigger.id}`, async (span) => {
+                    span.setAttribute('task.id', trigger.id);
+                    span.setAttribute('task.type', 'webhook');
+                    span.setAttribute('user.id', req.params.userId);
+                    const userId = req.params.userId;
+                    const activation = res.locals.activation;
+                    const activations = [activation];
+                    // Right now we only support a user having one activation
+                    // so this will need changing when we support multiple activations per user
+                    // as will the middleware
+                    if (!activations || activations.length === 0) {
+                        res.status(404).json({
+                            status: 'error',
+                            message: `No activations found for user: ${userId}`,
+                        });
+                        span.setAttribute('error.message', `No activations found for user: ${userId}`);
+                        span.setAttribute('http.status_code', '404');
+                        span.end();
+                        return;
+                    }
+                    const executionCtx = ctx.contextProvider.create(req.body, ctxOptionsFn(res));
+                    span.setAttribute('execution.id', executionCtx.executionId);
+                    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)));
+                        }
+                    }
+                    span.end();
+                });
+            });
+            // this endpoint will trigger the workflow only for the activation given by its ID
+            ctx.webhookRouter.post(`/${trigger.id}/activations/:activationId`, createActIdDynamicWebhookMiddleware({
+                id: trigger.id,
+                connName: trigger.options.connection,
+                credentials: ctx.roundTripperFactory.credentials(),
+                cnxProvider: ctx.connectionProvider,
+                cfgReader: ctx.configReader,
+                log: ctx.log,
+            }), async (req, res) => {
+                await ctx.tracer.startActiveSpan(`webhook-${trigger.id}`, async (span) => {
+                    span.setAttribute('task.id', trigger.id);
+                    span.setAttribute('task.type', 'webhook');
+                    span.setAttribute('activation.id', req.params.activationId);
+                    const activation = res.locals.activation;
+                    const activationId = activation.id || req.params.activationId;
+                    if (!activation) {
+                        // TODO report back actual errors
+                        res.status(404).json({
+                            status: 'error',
+                            message: `No activation found for ID: ${activationId}`,
+                        });
+                        span.setAttribute('error.message', `No activation found for ID: ${activationId}`);
+                        span.setAttribute('http.status_code', '404');
+                        span.end();
+                        return;
+                    }
+                    const activationCtx = ctx.contextProvider.create(req.body, {
+                        ...ctxOptionsFn(res),
+                        activation,
+                    });
+                    span.setAttribute('execution.id', activationCtx.executionId);
+                    try {
+                        subscriber.next(activationCtx);
+                        if (isAsync) {
+                            sendResponse(res, onSuccess(activationCtx));
+                        }
+                    }
+                    catch (error) {
+                        activationCtx.log.error('webhook execution error', {
+                            error: JSON.stringify(error),
+                        });
+                        if (isAsync) {
+                            sendResponse(res, onError(activationCtx.withData(error)));
+                        }
+                    }
+                    finally {
+                        span.end();
+                    }
+                });
+            });
+            function cleanup() {
+                ctx.log.debug('webhook trigger stopped');
+                subscriber.complete();
+            }
+            signal.addEventListener('abort', cleanup, { once: true });
+            return () => {
+                signal.removeEventListener('abort', cleanup);
+                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/interpreter/durable/mod.d.ts

@@ -0,0 +1,5 @@
+export * from './DurableInterpreter.js';
+export * from './ObservableCompiler.js';
+export * from './ExecutionError.js';
+export * from './compilers/mod.js';
+//# sourceMappingURL=mod.d.ts.map

package/esm/src/interpreter/durable/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/interpreter/durable/mod.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/esm/src/interpreter/durable/mod.js

@@ -0,0 +1,4 @@
+export * from './DurableInterpreter.js';
+export * from './ObservableCompiler.js';
+export * from './ExecutionError.js';
+export * from './compilers/mod.js';

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

@@ -1,2 +1,3 @@
 export * from './memory/mod.js';
+export * as durable from './durable/mod.js';
 //# sourceMappingURL=mod.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/interpreter/mod.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/interpreter/mod.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC"}

package/esm/src/interpreter/mod.js

@@ -1 +1,2 @@
 export * from './memory/mod.js';
+export * as durable from './durable/mod.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@versori/run",
-  "version": "v0.2.14",
+  "version": "v0.2.15",
   "description": "Versori Run",
   "homepage": "https://github.com/versori/versori-run#readme",
   "repository": {

package/script/src/context/AsyncWorkflow.d.ts

@@ -0,0 +1,14 @@
+import { QueueAPI } from '../interpreter/durable/Queue.js';
+export declare class AsyncWorkflow {
+    private workflowId;
+    private queue;
+    private data;
+    private dataRaw;
+    private isWaiting;
+    private isCompleted;
+    constructor(queue: QueueAPI, workflowId: string);
+    wait(maxWait?: number): Promise<void>;
+    getData(): Promise<unknown | undefined>;
+    getDataRaw(): Promise<string | undefined>;
+}
+//# sourceMappingURL=AsyncWorkflow.d.ts.map

package/script/src/context/AsyncWorkflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncWorkflow.d.ts","sourceRoot":"","sources":["../../../src/src/context/AsyncWorkflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,qBAAa,aAAa;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,WAAW,CAAkB;gBAEzB,KAAK,EAAE,QAAQ,EAAC,UAAU,EAAE,MAAM;IASxC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCrC,OAAO,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAQvC,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAMlD"}

package/script/src/context/AsyncWorkflow.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncWorkflow = void 0;
+class AsyncWorkflow {
+    constructor(queue, workflowId) {
+        Object.defineProperty(this, "workflowId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "queue", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "data", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "dataRaw", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "isWaiting", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "isCompleted", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        this.queue = queue;
+        this.workflowId = workflowId;
+    }
+    // wait will wait for the workflow to complete by polling the queue
+    // If maxWait is provided (in milliseconds), it will wait for that long before giving up
+    // If the workflow is already completed, it will return immediately.
+    // Throws an error if already waiting or if the wait times out.
+    async wait(maxWait) {
+        if (this.isWaiting) {
+            return Promise.reject(new Error('already waiting for workflow to complete'));
+        }
+        if (this.isCompleted) {
+            return;
+        }
+        this.isWaiting = true;
+        const start = Date.now();
+        while (true && !this.isCompleted) {
+            if (maxWait !== undefined && Date.now() - start >= maxWait) {
+                this.isWaiting = false;
+                throw new Error('wait timed out');
+            }
+            const workflow = await this.queue.poll(this.workflowId);
+            if (workflow.status === 'completed') {
+                // workflow is completed, parse the output and set the data and completed to true
+                const stringData = workflow.output;
+                if (stringData) {
+                    this.data = JSON.parse(atob(stringData));
+                    this.dataRaw = workflow.output;
+                }
+                this.isWaiting = false;
+                this.isCompleted = true;
+                return;
+            }
+            await new Promise(resolve => setTimeout(resolve, 1000));
+        }
+    }
+    // getData returns the data as D type, which is JSON parsed
+    async getData() {
+        if (!this.isWaiting) {
+            await this.wait();
+        }
+        return this.data;
+    }
+    // getDataRaw returns the raw data as base64 encoded string
+    async getDataRaw() {
+        if (!this.isWaiting) {
+            await this.wait();
+        }
+        return this.dataRaw;
+    }
+}
+exports.AsyncWorkflow = AsyncWorkflow;

package/script/src/context/Context.d.ts

@@ -1,14 +1,21 @@
 import { Activation } from '../dsl/http/types.js';
 import { CredentialsProvider } from '../dsl/http/versori/contextcredentials.js';
+import { QueueAPI } from '../interpreter/durable/Queue.js';
 import { KeyValue, KeyValueProvider, KeyValueScope } from '../kv/KeyValue.js';
 import { Logger } from '../observability/logging/Logger.js';
+import { AsyncWorkflow } from './AsyncWorkflow.js';
 export type OnSuccessFn = (ctx: Context<any>) => void;
 export type OnErrorFn = (ctx: Context<any>) => void;
 export type ContextOptions = {
     activation?: Activation;
+    workflowId?: string;
     onSuccess?: OnSuccessFn;
     onError?: OnErrorFn;
 };
+export type WorkflowOpts = {
+    data?: unknown;
+    dataRaw?: string;
+};
 export interface Context<D> {
     readonly log: Logger;
     readonly executionId: string;
@@ -20,6 +27,7 @@ export interface Context<D> {
      * @param scope
      */
     openKv(scope?: KeyValueScope): KeyValue;
+    start(workflowId: string, workflowOpts: WorkflowOpts): Promise<AsyncWorkflow>;
     credentials(): CredentialsProvider;
 }
 export declare class ContextImpl<D, Index = void> implements Context<D> {
@@ -30,13 +38,16 @@ export declare class ContextImpl<D, Index = void> implements Context<D> {
     readonly data: D;
     idx: Index;
     readonly kvp: KeyValueProvider;
+    readonly queue?: QueueAPI;
     readonly options: ContextOptions;
-    constructor(log: Logger, kvp: KeyValueProvider, creds: CredentialsProvider, executionId: string, startTime: Date, data: D, options?: ContextOptions);
+    constructor(log: Logger, kvp: KeyValueProvider, creds: CredentialsProvider, executionId: string, startTime: Date, data: D, queue?: QueueAPI, options?: ContextOptions);
     get activation(): Activation | undefined;
+    get workflowId(): string | undefined;
     setIndex(idx: number): ContextImpl<D, number>;
     withActivation(activation: Activation): ContextImpl<D, Index>;
     withData<D2>(data: D2): ContextImpl<D2, Index>;
     openKv(scope?: KeyValueScope): KeyValue;
+    start(group: string, opts: WorkflowOpts): Promise<AsyncWorkflow>;
     credentials(): CredentialsProvider;
     destroy(scope: KeyValueScope): Promise<void>;
     [Symbol.toPrimitive](): Record<string, unknown>;

package/script/src/context/Context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../../src/src/context/Context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AAEpD,MAAM,MAAM,cAAc,GAAG;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,OAAO,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,OAAO,CAAC,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAEjB,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC;IAExC,WAAW,IAAI,mBAAmB,CAAC;CACtC;AAED,qBAAa,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAE,YAAW,OAAO,CAAC,CAAC,CAAC;;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAEjB,GAAG,EAAE,KAAK,CAAC;IAEX,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;gBAI7B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,mBAAmB,EAC1B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,EACf,IAAI,EAAE,CAAC,EACP,OAAO,GAAE,cAAmB;IAmBhC,IAAI,UAAU,IAAI,UAAU,GAAG,SAAS,CAEvC;IAED,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC;IAe7C,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC;IAoB7D,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC;IAY9C,MAAM,CAAC,KAAK,GAAE,aAA2B,GAAG,QAAQ;IAepD,WAAW,IAAI,mBAAmB;IAQlC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5C,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlD"}
+{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../../src/src/context/Context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AAEpD,MAAM,MAAM,cAAc,GAAG;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,OAAO,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAIF,MAAM,MAAM,YAAY,GAAG;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,WAAW,OAAO,CAAC,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAEjB,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC;IAExC,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE9E,WAAW,IAAI,mBAAmB,CAAC;CACtC;AAED,qBAAa,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAE,YAAW,OAAO,CAAC,CAAC,CAAC;;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAEjB,GAAG,EAAE,KAAK,CAAC;IAEX,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;gBAI7B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,mBAAmB,EAC1B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,EACf,IAAI,EAAE,CAAC,EACP,KAAK,CAAC,EAAE,QAAQ,EAChB,OAAO,GAAE,cAAmB;IAqBhC,IAAI,UAAU,IAAI,UAAU,GAAG,SAAS,CAEvC;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC;IAgB7C,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC;IAqB7D,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC;IAa9C,MAAM,CAAC,KAAK,GAAE,aAA2B,GAAG,QAAQ;IAe9C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA+BtE,WAAW,IAAI,mBAAmB;IAQlC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5C,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlD"}

package/script/src/context/Context.js

@@ -13,8 +13,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _ContextImpl_creds;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ContextImpl = void 0;
+const AsyncWorkflow_js_1 = require("./AsyncWorkflow.js");
 class ContextImpl {
-    constructor(log, kvp, creds, executionId, startTime, data, options = {}) {
+    constructor(log, kvp, creds, executionId, startTime, data, queue, options = {}) {
         Object.defineProperty(this, "log", {
             enumerable: true,
             configurable: true,
@@ -51,6 +52,12 @@ class ContextImpl {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "queue", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        }); // Optional, can be used for durable workflows
         Object.defineProperty(this, "options", {
             enumerable: true,
             configurable: true,
@@ -66,17 +73,22 @@ class ContextImpl {
         this.idx = void 0;
         this.kvp = kvp;
         this.options = options;
+        this.queue = queue;
         // all methods on ContextImpl which are exposed via the Context interface need to be bound
         // so that destructuring the context object doesn't break the binding of the methods to the
         // correct instance.
         this.openKv = this.openKv.bind(this);
         this.credentials = this.credentials.bind(this);
+        this.start = this.start.bind(this);
     }
     get activation() {
         return this.options.activation;
     }
+    get workflowId() {
+        return this.options.workflowId;
+    }
     setIndex(idx) {
-        const next = new ContextImpl(this.log, this.kvp, __classPrivateFieldGet(this, _ContextImpl_creds, "f"), this.executionId, this.startTime, this.data, this.options);
+        const next = new ContextImpl(this.log, this.kvp, __classPrivateFieldGet(this, _ContextImpl_creds, "f"), this.executionId, this.startTime, this.data, this.queue, this.options);
         next.idx = idx;
         return next;
     }
@@ -85,13 +97,13 @@ class ContextImpl {
         if (this.activation) {
             throw new Error('Activation is already set');
         }
-        return new ContextImpl(this.log, this.kvp, __classPrivateFieldGet(this, _ContextImpl_creds, "f"), this.executionId, this.startTime, this.data, {
+        return new ContextImpl(this.log, this.kvp, __classPrivateFieldGet(this, _ContextImpl_creds, "f"), this.executionId, this.startTime, this.data, this.queue, {
             ...this.options,
             activation,
         });
     }
     withData(data) {
-        return new ContextImpl(this.log, this.kvp, __classPrivateFieldGet(this, _ContextImpl_creds, "f"), this.executionId, this.startTime, data, this.options);
+        return new ContextImpl(this.log, this.kvp, __classPrivateFieldGet(this, _ContextImpl_creds, "f"), this.executionId, this.startTime, data, this.queue, this.options);
     }
     openKv(scope = ':project:') {
         if (scope === ':execution:') {
@@ -106,6 +118,33 @@ class ContextImpl {
             activationId: this.activation?.id,
         });
     }
+    async start(group, opts) {
+        // this makes a post request to the endpoint sending a message and schedule the workflow to run
+        if (!this.queue) {
+            throw new Error('Queue is not available for this context, cannot start workflow');
+        }
+        let payload;
+        if (opts.data) {
+            payload = opts.data ? btoa(JSON.stringify(opts.data)) : undefined;
+        }
+        else if (opts.dataRaw) {
+            payload = opts.dataRaw; // Assume this is already base64 encoded
+        }
+        const resp = await this.queue.submit({
+            workflows: [
+                {
+                    group,
+                    metadata: {
+                        executionId: this.executionId,
+                        activationId: this.activation?.id,
+                        userId: this.activation?.user.externalId,
+                    },
+                    payload,
+                }
+            ]
+        });
+        return new AsyncWorkflow_js_1.AsyncWorkflow(this.queue, resp.workflows[0].id ?? 'unknown');
+    }
     credentials() {
         return {
             getRaw: (name) => __classPrivateFieldGet(this, _ContextImpl_creds, "f").getRaw(name, this.activation?.id || undefined),

package/script/src/context/ContextProvider.d.ts

@@ -2,6 +2,7 @@ import { KeyValueProvider } from '../kv/KeyValue.js';
 import { Logger } from '../observability/logging/Logger.js';
 import { Context, ContextImpl, ContextOptions } from './Context.js';
 import { CredentialsProvider } from '../dsl/http/versori/contextcredentials.js';
+import { QueueAPI } from '../interpreter/durable/Queue.js';
 export interface ContextProvider {
     create<D>(data: D, options?: ContextOptions): ContextImpl<D, void>;
     destroy(ctx: Context<any>): Promise<void>;
@@ -10,7 +11,8 @@ export declare class ContextProviderImpl implements ContextProvider {
     log: Logger;
     kvp: KeyValueProvider;
     creds: CredentialsProvider;
-    constructor(log: Logger, kvp: KeyValueProvider, creds: CredentialsProvider);
+    queue?: QueueAPI;
+    constructor(log: Logger, kvp: KeyValueProvider, creds: CredentialsProvider, queue: QueueAPI | undefined);
     create<D>(data: D, options?: ContextOptions): ContextImpl<D>;
     destroy(ctx: Context<any>): Promise<void>;
 }

package/script/src/context/ContextProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContextProvider.d.ts","sourceRoot":"","sources":["../../../src/src/context/ContextProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,qBAAa,mBAAoB,YAAW,eAAe;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,gBAAgB,CAAC;IACtB,KAAK,EAAE,mBAAmB,CAAC;gBAEf,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,mBAAmB;IAM1E,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,WAAW,CAAC,CAAC,CAAC;IAehE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAM5C"}
+{"version":3,"file":"ContextProvider.d.ts","sourceRoot":"","sources":["../../../src/src/context/ContextProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,qBAAa,mBAAoB,YAAW,eAAe;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,gBAAgB,CAAC;IACtB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,KAAK,CAAC,EAAE,QAAQ,CAAC;gBAEL,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,QAAQ,GAAG,SAAS;IAOvG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,WAAW,CAAC,CAAC,CAAC;IAehE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAM5C"}

package/script/src/context/ContextProvider.js

@@ -4,7 +4,7 @@ exports.ContextProviderImpl = void 0;
 const mod_js_1 = require("../../deps/jsr.io/@std/ulid/1.0.0/mod.js");
 const Context_js_1 = require("./Context.js");
 class ContextProviderImpl {
-    constructor(log, kvp, creds) {
+    constructor(log, kvp, creds, queue) {
         Object.defineProperty(this, "log", {
             enumerable: true,
             configurable: true,
@@ -23,9 +23,16 @@ class ContextProviderImpl {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "queue", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.log = log;
         this.kvp = kvp;
         this.creds = creds;
+        this.queue = queue;
     }
     create(data, options = {}) {
         const executionId = (0, mod_js_1.ulid)();
@@ -36,7 +43,7 @@ class ContextProviderImpl {
                 externalUserId: options.activation.user.externalId,
             });
         }
-        return new Context_js_1.ContextImpl(logger, this.kvp, this.creds, executionId, new Date(), data, options);
+        return new Context_js_1.ContextImpl(logger, this.kvp, this.creds, executionId, new Date(), data, this.queue, options);
     }
     destroy(ctx) {
         return this.kvp.destroy({

package/script/src/dsl/http/versori/constants.d.ts

@@ -5,6 +5,7 @@ export declare const envVarProjectId = "RUN_SERVICE_ID";
 export declare const envVarOrgSlug = "RUN_ORGANISATION_SLUG";
 export declare const envVarPlatformApiBaseURL = "RUN_PLATFORM_API_INTERNAL_URL";
 export declare const envVarCronApiBaseURL = "RUN_CRON_API_INTERNAL_URL";
+export declare const envVarWorkflowApiBaseURL = "RUN_SDK_API_URL";
 export declare const envVarSelfRefURL = "RUN_SELF_REF_URL";
 export declare const envVarCredsBaseURL = "RUN_CREDENTIALS_SERVICE_INTERNAL_URL";
 export declare const envVarOtelTracesURL = "RUN_OTEL_TRACES_URL";

package/script/src/dsl/http/versori/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/src/dsl/http/versori/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW,wBAAwB,CAAC;AACjD,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAChD,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAChD,eAAO,MAAM,aAAa,0BAA0B,CAAC;AACrD,eAAO,MAAM,wBAAwB,kCAAkC,CAAC;AACxE,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAChE,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AACzE,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,aAAa,wBAAwB,CAAC;AAEnD,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAGlD,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAC9C,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AACtD,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AACxD,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AAGxD,eAAO,MAAM,cAAc,cAAc,CAAC;AAI1C,eAAO,MAAM,QAAQ,OAAO,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/src/dsl/http/versori/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW,wBAAwB,CAAC;AACjD,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAChD,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAChD,eAAO,MAAM,aAAa,0BAA0B,CAAC;AACrD,eAAO,MAAM,wBAAwB,kCAAkC,CAAC;AACxE,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAChE,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAC1D,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AACzE,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,aAAa,wBAAwB,CAAC;AAEnD,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAGlD,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAC9C,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AACtD,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AACxD,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AAGxD,eAAO,MAAM,cAAc,cAAc,CAAC;AAI1C,eAAO,MAAM,QAAQ,OAAO,CAAC"}

package/script/src/dsl/http/versori/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cronPort = exports.envVarLocalRun = exports.envVarInternalToken = exports.envVarTokenEndpoint = exports.envVarClientSecret = exports.envVarClientId = exports.envVarConfigFile = exports.envVarVersion = exports.envVarOtelTracesURL = exports.envVarCredsBaseURL = exports.envVarSelfRefURL = exports.envVarCronApiBaseURL = exports.envVarPlatformApiBaseURL = exports.envVarOrgSlug = exports.envVarProjectId = exports.envVarEnvironmentName = exports.envVarEnvId = exports.envVarOrgId = void 0;
+exports.cronPort = exports.envVarLocalRun = exports.envVarInternalToken = exports.envVarTokenEndpoint = exports.envVarClientSecret = exports.envVarClientId = exports.envVarConfigFile = exports.envVarVersion = exports.envVarOtelTracesURL = exports.envVarCredsBaseURL = exports.envVarSelfRefURL = exports.envVarWorkflowApiBaseURL = exports.envVarCronApiBaseURL = exports.envVarPlatformApiBaseURL = exports.envVarOrgSlug = exports.envVarProjectId = exports.envVarEnvironmentName = exports.envVarEnvId = exports.envVarOrgId = void 0;
 // This file contains constants used in the Versori DSL HTTP client.
 exports.envVarOrgId = 'RUN_ORGANISATION_ID';
 exports.envVarEnvId = 'RUN_ENVIRONMENT_ID';
@@ -9,6 +9,7 @@ exports.envVarProjectId = 'RUN_SERVICE_ID';
 exports.envVarOrgSlug = 'RUN_ORGANISATION_SLUG';
 exports.envVarPlatformApiBaseURL = 'RUN_PLATFORM_API_INTERNAL_URL';
 exports.envVarCronApiBaseURL = 'RUN_CRON_API_INTERNAL_URL';
+exports.envVarWorkflowApiBaseURL = 'RUN_SDK_API_URL';
 exports.envVarSelfRefURL = 'RUN_SELF_REF_URL';
 exports.envVarCredsBaseURL = 'RUN_CREDENTIALS_SERVICE_INTERNAL_URL';
 exports.envVarOtelTracesURL = 'RUN_OTEL_TRACES_URL';