@webda/async 3.9.3 → 4.0.0-beta.10

package/README.md

@@ -2,7 +2,7 @@
 
 This module is part of Webda Application Framework that allows you to quickly develop applications with all modern prerequisites: Security, Extensibility, GraphQL, REST, CloudNative [https://webda.io](https://webda.io)
 
-<img src="https://webda.io/images/webda.svg" width="128" />
+<img src="https://webda.io/img/webda.svg" width="128" />
 
 ![CI](https://github.com/loopingz/webda.io/workflows/CI/badge.svg)
 
@@ -13,12 +13,96 @@ This module is part of Webda Application Framework that allows you to quickly de
 
 <!-- README_HEADER -->
 
-This package is exposing a logic of asynchronous tasks management.
-You have different types of runner available.
-It allows you to launch other language/binary from within your application
-and capure the output.
+> Durable asynchronous job orchestration for Webda — queue a service method call, track its status, and optionally schedule it for later execution.
+
+## When to use it
+
+- You need to offload long-running work (report generation, data imports) to a background worker without blocking the HTTP response.
+- You want to schedule a recurring or time-delayed operation (cron-based or timestamp-based).
+- You need a persistent audit trail of job executions with status, logs, and results stored in a Webda Store.
+
+## Install
+
+```bash
+pnpm add @webda/async
+```
+
+## Configuration
+
+```json
+{
+  "services": {
+    "AsyncActionsQueue": {
+      "type": "MemoryQueue"
+    },
+    "asyncJobService": {
+      "type": "AsyncJobService",
+      "queue": "AsyncActionsQueue",
+      "url": "/async",
+      "runners": ["serviceRunner"],
+      "includeCron": true,
+      "logsLimit": 500
+    },
+    "serviceRunner": {
+      "type": "ServiceRunner"
+    }
+  }
+}
+```
+
+| Parameter | Type | Default | Required | Description |
+|---|---|---|---|---|
+| `queue` | string | `"AsyncActionsQueue"` | Yes | Name of the Queue service to dispatch jobs through |
+| `url` | string | `"/async"` | No | URL prefix for the status hook endpoint |
+| `runners` | string[] | `[]` | Yes | List of Runner service names to execute jobs |
+| `localLaunch` | boolean | `false` | No | Execute jobs inline (no queue) — useful for development |
+| `fallbackOnFirst` | boolean | `false` | No | Use first runner if no runner matches the job type |
+| `concurrencyLimit` | number | — | No | Maximum number of jobs running concurrently |
+| `includeCron` | boolean | `true` | No | Auto-schedule `@Cron`-annotated methods as async actions |
+| `logsLimit` | number | `500` | No | Max log lines retained per job in the store |
+| `asyncOperationDefinition` | string | — | No | Path to a JSON file of operation definitions generated by `webda operations` |
+| `schedulerResolution` | number | `60000` | No | Scheduler tick interval in milliseconds |
+
+## Usage
+
+```typescript
+import { Service } from "@webda/core";
+import { Bean, Inject } from "@webda/core";
+import AsyncJobService from "@webda/async/services/asyncjobservice";
+
+@Bean
+export class ReportService extends Service {
+  @Inject("asyncJobService")
+  asyncJobService: AsyncJobService;
+
+  // Expose an HTTP endpoint that queues a job and returns immediately
+  async generateReport(ctx: any): Promise<void> {
+    const action = await this.asyncJobService.launchAsAsyncAction(
+      "ReportService",   // service name
+      "runReport",       // method name
+      ctx.getParameters().reportId
+    );
+    ctx.write({ jobId: action.getUuid(), status: action.status });
+  }
+
+  // This method runs inside the worker process
+  async runReport(reportId: string): Promise<void> {
+    // ... long-running work here
+  }
+}
+
+// Start the worker (typically in a separate process)
+// asyncJobService.worker().then(() => console.log("worker stopped"));
+```
+
+## Reference
+
+- API reference: see the auto-generated typedoc at `docs/pages/Modules/async/`.
+- Source: [`packages/async`](https://github.com/loopingz/webda.io/tree/main/packages/async)
+- Related: [`@webda/amqp`](../amqp) for a RabbitMQ-backed queue, [`@webda/aws`](../aws) for SQS, [`@webda/core`](../core) for the base `Queue` and `Store` abstractions.
 
 <!-- README_FOOTER -->
+
 ## Sponsors
 
 <!--
@@ -27,12 +111,12 @@ Support this project by becoming a sponsor. Your logo will show up here with a l
 
 Arize AI is a machine learning observability and model monitoring platform. It helps you visualize, monitor, and explain your machine learning models. [Learn more](https://arize.com)
 
-[<img src="https://arize.com/hubfs/arize/brand/arize-logomark-1.png" width="200">](https://arize.com)
+[<img src="https://webda.io/img/sponsors/arize.svg" width="200">](https://arize.com)
 
 Loopingz is a software development company that provides consulting and development services. [Learn more](https://loopingz.com)
 
-[<img src="https://loopingz.com/images/logo.png" width="200">](https://loopingz.com)
+[<img src="https://webda.io/img/sponsors/loopingz.png" width="200">](https://loopingz.com)
 
 Tellae is an innovative consulting firm specialized in cities transportation issues. We provide our clients, both public and private, with solutions to support your strategic and operational decisions. [Learn more](https://tellae.fr)
 
-[<img src="https://tellae.fr/" width="200">](https://tellae.fr)
+[<img src="https://webda.io/img/sponsors/tellae.svg" width="200">](https://tellae.fr)

package/lib/asyncaction.model.d.ts

@@ -0,0 +1,207 @@
+import { CoreModel, IOperationContext, OperationContext, WebContext } from "@webda/core";
+import { WorkerLogLevel } from "@webda/workout";
+/**
+ * Represent an item for processing queue
+ */
+export interface AsyncActionQueueItem {
+    /**
+     * Item to launch
+     */
+    uuid: string;
+    /**
+     * Secret key for status hook
+     */
+    __secretKey: string;
+    /**
+     * Type of action
+     */
+    type: string;
+}
+/**
+ * Define here a model that can be used along with Store service
+ * @WebdaModel
+ * @WebdaPlural AsyncActions
+ */
+export default class AsyncAction extends CoreModel {
+    /**
+     * Create a new action
+     * @param data - initial data
+     */
+    constructor(data?: Partial<AsyncAction>);
+    /**
+     * By default AsyncAction are not considered internal
+     *
+     * Internal: That execute a method or operation of Webda application framework
+     * @returns false
+     */
+    isInternal(): boolean;
+    /**
+     * Current status
+     */
+    status: "RUNNING" | "SUCCESS" | "ERROR" | "QUEUED" | "STARTING" | "TIMEOUT" | "SCHEDULED";
+    /**
+     * Timestamp when the action was scheduled
+     */
+    scheduled?: number;
+    /**
+     * If an error occured it should contain the message
+     */
+    errorMessage?: string;
+    /**
+     * If an error occured it should contain the name
+     */
+    errorName?: string;
+    /**
+     * Job information
+     */
+    job: any;
+    /**
+     * Last time the job was updated
+     */
+    _lastJobUpdate: number;
+    /**
+     * Results from the job
+     */
+    results: any;
+    /**
+     * Job current status
+     */
+    statusDetails: any;
+    /**
+     * Type of action
+     */
+    type: string;
+    /**
+     * Arguments of the action
+     */
+    arguments?: any[];
+    /**
+     * Current logs
+     */
+    logs: string[];
+    /**
+     * Secret key to post feedback
+     */
+    __secretKey: string;
+    /**
+     * Expected action for the job
+     *
+     * It should be a verb
+     */
+    action?: "STOP" | string;
+    /**
+     * Maximum number of log lines kept
+     * @returns the limit
+     */
+    getLogsLimit(): number;
+    /**
+     * Allow to report status for a job
+     *
+     * Only a job runner with a valid HMAC can call it
+     * @param context - the web context of the job runner
+     */
+    statusAction(context?: OperationContext): Promise<void>;
+    /**
+     * Return the absolute url of this action status route ({uuid}/status)
+     *
+     * Remote runners report to AsyncJobService.getHookUrl() instead, as this route
+     * still has to be authorized by the application request filters
+     * @returns the absolute url of the status action
+     */
+    getHookUrl(): string;
+    /**
+     * Update the action with a status report
+     * @param body - the status report
+     * @param time - the job time header
+     * @returns this
+     */
+    update(body: any, time?: string): Promise<this>;
+    /**
+     * Verify the job HMAC headers
+     * @param context - the web context
+     */
+    protected verifyJobRequest(context: WebContext): Promise<void>;
+    /**
+     * Get the hmac for the job
+     * @param jobTime - the job time header
+     * @returns the hex hmac
+     */
+    getHmac(jobTime: string): string;
+    /**
+     * Only job runners with a valid HMAC can report status or use binaries
+     * @param context - the operation context
+     * @param action - the action
+     * @returns true or the reason of refusal
+     */
+    canAct(context: IOperationContext, action: string): Promise<string | boolean>;
+    /**
+     * Throw a Forbidden error if the action is not allowed
+     * @param context - the operation context
+     * @param action - the action
+     */
+    checkAct(context: IOperationContext, action: string): Promise<void>;
+}
+/**
+ * Define a Webda Async Action
+ *
+ * @WebdaModel
+ * @WebdaPlural AsyncWebdaActions
+ */
+export declare class AsyncWebdaAction extends AsyncAction {
+    /**
+     * Log level to capture
+     */
+    logLevel: WorkerLogLevel;
+    /**
+     * Service to call
+     */
+    serviceName?: string;
+    /**
+     * Method to call
+     */
+    method?: string;
+    /**
+     * @param serviceName service to call or initial data
+     * @param method method to call
+     * @param args to call with the method
+     */
+    constructor(serviceName?: string | Partial<AsyncWebdaAction>, method?: string, ...args: any[]);
+    /**
+     * Execute a serviceName.method(...args) so this is internal
+     * @returns true
+     */
+    isInternal(): boolean;
+}
+/**
+ * Operation called asynchronously
+ *
+ * @WebdaModel
+ * @WebdaPlural AsyncOperationActions
+ */
+export declare class AsyncOperationAction extends AsyncAction {
+    /**
+     * Operation to call
+     */
+    operationId: string;
+    /**
+     * Context to call the operation with
+     */
+    context: any;
+    /**
+     * Log level to capture
+     */
+    logLevel: WorkerLogLevel;
+    /**
+     * @param operationId operation to call or initial data
+     * @param context context to use
+     * @param logLevel log level to capture
+     */
+    constructor(operationId?: string | Partial<AsyncOperationAction>, context?: OperationContext, logLevel?: WorkerLogLevel);
+    /**
+     * Execute a webda.callOperation(context ,id) so this is internal
+     * @returns true
+     */
+    isInternal(): boolean;
+}
+export { AsyncAction };
+//# sourceMappingURL=asyncaction.model.d.ts.map

package/lib/asyncaction.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncaction.model.d.ts","sourceRoot":"","sources":["../src/asyncaction.model.ts"],"names":[],"mappings":"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"}

package/lib/asyncaction.model.js

@@ -0,0 +1,269 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { Action, CoreModel, WebContext, WebdaError, useContext, useLog, useParameters, useRouter } from "@webda/core";
+import * as crypto from "node:crypto";
+/**
+ * Headers sent by a job runner to authenticate against the status hook
+ */
+const JOB_HEADERS = ["X-Job-Hash", "X-Job-Time"];
+/**
+ * Check if the context carries the job runner headers
+ * @param context - the context to check
+ * @returns true if both job headers are present
+ */
+function hasJobHeaders(context) {
+    return (context instanceof WebContext &&
+        JOB_HEADERS.every(h => context.getHttpContext()?.getUniqueHeader(h) !== undefined));
+}
+let AsyncAction = (() => {
+    var _a;
+    let _classSuper = CoreModel;
+    let _instanceExtraInitializers = [];
+    let _statusAction_decorators;
+    return _a = class AsyncAction extends _classSuper {
+            /**
+             * Create a new action
+             * @param data - initial data
+             */
+            constructor(data) {
+                super(data);
+                /**
+                 * Current status
+                 */
+                this.status = __runInitializers(this, _instanceExtraInitializers);
+                if (data) {
+                    Object.assign(this, data);
+                }
+                this.type ?? (this.type = this.constructor.name);
+            }
+            /**
+             * By default AsyncAction are not considered internal
+             *
+             * Internal: That execute a method or operation of Webda application framework
+             * @returns false
+             */
+            isInternal() {
+                return false;
+            }
+            /**
+             * Maximum number of log lines kept
+             * @returns the limit
+             */
+            getLogsLimit() {
+                return 1000;
+            }
+            /**
+             * Allow to report status for a job
+             *
+             * Only a job runner with a valid HMAC can call it
+             * @param context - the web context of the job runner
+             */
+            async statusAction(context = useContext()) {
+                if (!(context instanceof WebContext)) {
+                    throw new Error("Only WebContext can call this action");
+                }
+                await this.checkAct(context, "status");
+                await this.update(await context.getRequestBody(), context.getHttpContext().getUniqueHeader("X-Job-Time"));
+                context.write({ ...this, logs: undefined, statusDetails: undefined });
+            }
+            /**
+             * Return the absolute url of this action status route ({uuid}/status)
+             *
+             * Remote runners report to AsyncJobService.getHookUrl() instead, as this route
+             * still has to be authorized by the application request filters
+             * @returns the absolute url of the status action
+             */
+            getHookUrl() {
+                return `${useParameters().apiUrl ?? ""}${useRouter().getModelUrl(this)}/${this.uuid}/status`;
+            }
+            /**
+             * Update the action with a status report
+             * @param body - the status report
+             * @param time - the job time header
+             * @returns this
+             */
+            async update(body, time = undefined) {
+                if (body.logs && Array.isArray(body.logs)) {
+                    this.logs ?? (this.logs = []);
+                    this.logs.push(...body.logs);
+                    // Prevent having too much logs
+                    if (this.logs.length > this.getLogsLimit()) {
+                        this.logs = this.logs.slice(-1 * this.getLogsLimit());
+                    }
+                }
+                this._lastJobUpdate = Number.parseInt(time || "0") || 0;
+                if (Date.now() - this._lastJobUpdate > 60) {
+                    this._lastJobUpdate = Date.now();
+                }
+                await this.patch({
+                    _lastJobUpdate: this._lastJobUpdate,
+                    logs: this.logs,
+                    status: body.status || this.status,
+                    errorMessage: body.errorMessage || this.errorMessage,
+                    statusDetails: body.statusDetails || this.statusDetails,
+                    results: body.results || this.results
+                });
+                return this;
+            }
+            /**
+             * Verify the job HMAC headers
+             * @param context - the web context
+             */
+            async verifyJobRequest(context) {
+                const jobTime = context.getHttpContext().getUniqueHeader("X-Job-Time");
+                const jobHash = context.getHttpContext().getUniqueHeader("X-Job-Hash");
+                // Ensure hash mac is correct
+                if (jobHash !== this.getHmac(jobTime)) {
+                    useLog("TRACE", "Invalid Job HMAC");
+                    throw new WebdaError.Forbidden("Invalid Job HMAC");
+                }
+                // Set the context extension
+                context.setExtension("asyncJob", this);
+            }
+            /**
+             * Get the hmac for the job
+             * @param jobTime - the job time header
+             * @returns the hex hmac
+             */
+            getHmac(jobTime) {
+                return crypto.createHmac("sha256", this.__secretKey).update(jobTime).digest("hex");
+            }
+            /**
+             * Only job runners with a valid HMAC can report status or use binaries
+             * @param context - the operation context
+             * @param action - the action
+             * @returns true or the reason of refusal
+             */
+            async canAct(context, action) {
+                if ("status" === action || ["get_binary", "attach_binary", "update_binary_metadata"].includes(action)) {
+                    if (!hasJobHeaders(context)) {
+                        return "Only Job runner can call this action";
+                    }
+                    try {
+                        await this.verifyJobRequest(context);
+                        return true;
+                    }
+                    catch (err) {
+                        return err.message;
+                    }
+                }
+                return "This model does not support any action: override canAct";
+            }
+            /**
+             * Throw a Forbidden error if the action is not allowed
+             * @param context - the operation context
+             * @param action - the action
+             */
+            async checkAct(context, action) {
+                const result = await this.canAct(context, action);
+                if (result !== true) {
+                    throw new WebdaError.Forbidden(typeof result === "string" ? result : "Forbidden");
+                }
+            }
+        },
+        (() => {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _statusAction_decorators = [Action({ name: "status", openapi: { hidden: true } })];
+            __esDecorate(_a, null, _statusAction_decorators, { kind: "method", name: "statusAction", static: false, private: false, access: { has: obj => "statusAction" in obj, get: obj => obj.statusAction }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(_a, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        })(),
+        _a;
+})();
+/**
+ * Define here a model that can be used along with Store service
+ * @WebdaModel
+ * @WebdaPlural AsyncActions
+ */
+export default AsyncAction;
+/**
+ * Define a Webda Async Action
+ *
+ * @WebdaModel
+ * @WebdaPlural AsyncWebdaActions
+ */
+export class AsyncWebdaAction extends AsyncAction {
+    /**
+     * @param serviceName service to call or initial data
+     * @param method method to call
+     * @param args to call with the method
+     */
+    constructor(serviceName, method, ...args) {
+        super(typeof serviceName === "object" ? serviceName : undefined);
+        if (typeof serviceName !== "object") {
+            this.serviceName = serviceName;
+            this.method = method;
+            this.arguments = args;
+        }
+        this.logLevel ?? (this.logLevel = "INFO");
+    }
+    /**
+     * Execute a serviceName.method(...args) so this is internal
+     * @returns true
+     */
+    isInternal() {
+        return true;
+    }
+}
+/**
+ * Operation called asynchronously
+ *
+ * @WebdaModel
+ * @WebdaPlural AsyncOperationActions
+ */
+export class AsyncOperationAction extends AsyncAction {
+    /**
+     * @param operationId operation to call or initial data
+     * @param context context to use
+     * @param logLevel log level to capture
+     */
+    constructor(operationId, context, logLevel = "INFO") {
+        super(typeof operationId === "object" ? operationId : undefined);
+        if (typeof operationId !== "object") {
+            this.operationId = operationId;
+            this.context = context;
+            this.logLevel = logLevel;
+        }
+        this.logLevel ?? (this.logLevel = "INFO");
+    }
+    /**
+     * Execute a webda.callOperation(context ,id) so this is internal
+     * @returns true
+     */
+    isInternal() {
+        return true;
+    }
+}
+export { AsyncAction };
+//# sourceMappingURL=asyncaction.model.js.map

package/lib/asyncaction.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncaction.model.js","sourceRoot":"","sources":["../src/asyncaction.model.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -1,5 +1,7 @@
-export * from "./models.js";
-export * from "./services/asyncjobservice.js";
-export * from "./services/runner.js";
-export * from "./services/localrunner.js";
-export * from "./services/servicerunner.js";
+export * from "./asyncaction.model.js";
+export * from "./services/asyncjobservice.service.js";
+export * from "./services/runner.service.js";
+export * from "./services/localrunner.service.js";
+export * from "./services/servicerunner.service.js";
+export * from "./services/asyncevents.service.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC"}

package/lib/index.js

@@ -1,6 +1,7 @@
-export * from "./models.js";
-export * from "./services/asyncjobservice.js";
-export * from "./services/runner.js";
-export * from "./services/localrunner.js";
-export * from "./services/servicerunner.js";
+export * from "./asyncaction.model.js";
+export * from "./services/asyncjobservice.service.js";
+export * from "./services/runner.service.js";
+export * from "./services/localrunner.service.js";
+export * from "./services/servicerunner.service.js";
+export * from "./services/asyncevents.service.js";
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC"}