@venizia/ignis-worker 0.4.3 → 0.4.5

package/LICENSE.md

@@ -4,7 +4,7 @@ Ignis is a TypeScript Server Infrastructure framework built on [Hono](https://ho
 
 ## MIT License
 
-Copyright (c) 2025 VENIZIA Ltd. Co.
+Copyright (c) 2025 Venizia Co., Ltd.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -88,12 +88,9 @@ Ignis uses the following open-source libraries. We are grateful to the authors a
 
 ## Acknowledgments
 
-Ignis Framework is inspired by and built upon the work of many open-source projects:
+Ignis Framework is built on the work of open-source projects:
 
 - **[Hono](https://hono.dev/)** by Yusuke Wada - The ultrafast web framework that powers Ignis
-- **[LoopBack 4](https://loopback.io/)** by IBM/StrongLoop - Inspiration for the enterprise architecture patterns
-- **[NestJS](https://nestjs.com/)** by Kamil Mysliwiec - Inspiration for decorator-based controllers
-- **[InversifyJS](https://inversify.io/)** - Inspiration for the IoC container design
 
 We thank all the maintainers and contributors of these projects for their excellent work.
 

package/README.md

@@ -131,3 +131,16 @@ browser sibling of `@venizia/ignis`; neither depends on the other, and it does n
 - [All changelogs](https://ignis.venizia.ai/changelogs/)
 
 MIT licensed - see [LICENSE.md](https://github.com/VENIZIA-AI/ignis/blob/main/LICENSE.md).
+
+---
+
+<p align="center">
+  <a href="https://venizia.ai">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://venizia.ai/assets/logo-white.svg">
+      <img src="https://venizia.ai/assets/logo.svg" alt="VENIZIA" height="28">
+    </picture>
+  </a>
+  <br>
+  <sub>@venizia/ignis-worker is part of IGNIS, built and maintained by <a href="https://venizia.ai">VENIZIA</a>.</sub>
+</p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ignis-worker",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Browser Web Worker host for the IGNIS framework: the request/response envelope, the transport contract, and WorkerApplication - the layer that listens on `onmessage` instead of a socket, so a RestApplication can serve its controllers with no server anywhere.",
   "keywords": [
     "browser",
@@ -8,8 +8,6 @@
     "envelope",
     "hono",
     "ignis",
-    "loopback",
-    "loopback4",
     "rest",
     "transport",
     "typescript",
@@ -39,18 +37,14 @@
     "!**/*.tsbuildinfo"
   ],
   "sideEffects": [
-    "./dist/cjs/index.js",
     "./dist/esm/index.js"
   ],
-  "main": "./dist/cjs/index.js",
-  "module": "./dist/esm/index.js",
-  "types": "./dist/cjs/index.d.ts",
+  "main": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/cjs/index.d.ts",
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js",
-      "default": "./dist/cjs/index.js"
+      "types": "./dist/esm/index.d.ts",
+      "default": "./dist/esm/index.js"
     },
     "./package.json": "./package.json"
   },
@@ -62,14 +56,14 @@
     "prepublishOnly": "make rebuild"
   },
   "dependencies": {
-    "@venizia/ignis-helpers": "0.4.3",
-    "@venizia/ignis-inversion": "0.4.3",
-    "@venizia/ignis-kernel": "0.4.3",
+    "@venizia/ignis-helpers": "0.4.5",
+    "@venizia/ignis-inversion": "0.4.4",
+    "@venizia/ignis-kernel": "0.4.5",
     "reflect-metadata": "^0.2.2"
   },
   "devDependencies": {
     "@types/bun": "^1.4.3",
-    "@venizia/dev-configs": "0.4.3",
+    "@venizia/dev-configs": "0.4.5",
     "eslint": "^10.13.0",
     "oxlint": "1.89.0",
     "oxlint-tsgolint": "7.0.2004",

package/dist/cjs/applications/common/index.d.ts

@@ -1,2 +0,0 @@
-export * from './types';
-//# sourceMappingURL=index.d.ts.map

package/dist/cjs/applications/common/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/applications/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/cjs/applications/common/index.js

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./types"), exports);
-//# sourceMappingURL=index.js.map

package/dist/cjs/applications/common/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/applications/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB","sourcesContent":["export * from './types';\n"]}

package/dist/cjs/applications/common/types.d.ts

@@ -1,10 +0,0 @@
-import type { IApplicationConfigs } from '@venizia/ignis-kernel';
-/**
- * What a Web Worker host configures on top of the kernel's shape. `host`/`port` stay off this
- * interface on purpose - `@venizia/ignis`'s `IServerApplicationConfigs` is the one with a socket.
- */
-export interface IWorkerApplicationConfigs extends IApplicationConfigs {
-    /** Bound as `CoreBindings.APPLICATION_PROJECT_ROOT` when `getProjectRoot()` resolves it, and shared with `ModuleUtility`; default is the host's own working directory when one exists, else `''`. */
-    projectRoot?: string;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/cjs/applications/common/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/applications/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IACpE,qMAAqM;IACrM,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/cjs/applications/common/types.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/cjs/applications/common/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/applications/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { IApplicationConfigs } from '@venizia/ignis-kernel';\n\n/**\n * What a Web Worker host configures on top of the kernel's shape. `host`/`port` stay off this\n * interface on purpose - `@venizia/ignis`'s `IServerApplicationConfigs` is the one with a socket.\n */\nexport interface IWorkerApplicationConfigs extends IApplicationConfigs {\n  /** Bound as `CoreBindings.APPLICATION_PROJECT_ROOT` when `getProjectRoot()` resolves it, and shared with `ModuleUtility`; default is the host's own working directory when one exists, else `''`. */\n  projectRoot?: string;\n}\n"]}

package/dist/cjs/applications/index.d.ts

@@ -1,3 +0,0 @@
-export * from './common';
-export * from './worker';
-//# sourceMappingURL=index.d.ts.map

package/dist/cjs/applications/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/applications/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/cjs/applications/index.js

@@ -1,19 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./common"), exports);
-__exportStar(require("./worker"), exports);
-//# sourceMappingURL=index.js.map

package/dist/cjs/applications/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/applications/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,2CAAyB","sourcesContent":["export * from './common';\nexport * from './worker';\n"]}

package/dist/cjs/applications/worker.d.ts

@@ -1,79 +0,0 @@
-import { RestApplication } from '@venizia/ignis-kernel';
-import type { Env, Schema } from 'hono';
-import type { IWorkerApplicationConfigs } from './common';
-/**
- * Structural shape of the two globals `listen()` can attach to. Never `DedicatedWorkerGlobalScope`:
- * naming it emits it into the published `.d.ts` and forces every consumer to compile with
- * `lib.webworker`. `start` is optional because a `MessagePort`s queue starts disabled and only
- * `start()` enables it, while a worker global scope has no such method at all.
- */
-export interface IWorkerMessageScope {
-    postMessage(message: unknown, transfer?: Array<ArrayBuffer | MessagePort>): void;
-    addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;
-    removeEventListener?(type: 'message', listener: (event: MessageEvent) => void): void;
-    start?(): void;
-}
-/**
- * Runs an IGNIS application inside a browser Web Worker: `listen()` replaces what
- * `ServerApplication.start()` does with a socket, attaching `onmessage` instead. Gets REST
- * controller registration by inheritance - `RestApplication.registerControllers()` - the whole
- * reason the DI helpers and `RestComponent` sit in the kernel.
- */
-export declare abstract class WorkerApplication<AppEnv extends Env = Env, AppSchema extends Schema = {}, BasePath extends string = '/'> extends RestApplication<AppEnv, AppSchema, BasePath> {
-    /** Widened by this layer, the only one with an optional `projectRoot` to read. Assigned by the base constructor - `declare` so no field initializer runs here and overwrites it with `undefined`. */
-    protected configs: IWorkerApplicationConfigs;
-    /** Resolves once the router tree is mounted - what an envelope arriving during boot waits on. */
-    private servingPromise?;
-    /** The whole `listen()` call, kept so a second one is a no-op instead of a second listener. */
-    private listenPromise?;
-    private detachFromScope?;
-    private isStopped;
-    /**
-     * `configs.projectRoot` wins, else the host's own working directory - read as
-     * `globalThis.process?.cwd?.()`, never a bare `process.cwd()`, because a real browser Worker has no
-     * such global and this class ships there. Bound AND shared with `ModuleUtility` (through the
-     * purity-safe `ProjectRootRegistry`), the same seam `ServerApplication` gives a socket host. No
-     * `node_modules` check here, unlike that host: a browser has no filesystem to check, and `node:fs`
-     * would bundle a Node builtin straight into a Worker.
-     */
-    getProjectRoot(): string;
-    /**
-     * Every failure here is posted back as an `IBffErrorEnvelope`, the failed `postMessage` included:
-     * an exception nobody posts leaves the UI waiting out the transport timeout.
-     */
-    private handleMessage;
-    /** No transfer list: an error envelope carries no `ArrayBuffer` body, and this is already the fallback path - nothing left to hand off if this post fails too. */
-    private postErrorEnvelope;
-    /** Everything `ServerApplication.start()` does short of binding a socket. Once this resolves the application answers requests. */
-    private startServing;
-    /**
-     * Holds an envelope until the application is serving. A dedicated worker's queue is enabled when
-     * its module script is evaluated, so anything posted during boot - PGlite takes ~350ms - reaches
-     * this listener and would otherwise be dropped. One shared promise also hands them on in arrival
-     * order.
-     */
-    private dispatchMessage;
-    private attachTo;
-    /**
-     * `ServerApplication.start()` minus the socket. `opts.scope` defaults to `globalThis`, never a
-     * bare `self`, which would tie the published types to `lib.webworker`. Idempotent: without the
-     * guard one envelope runs its handler once per call - a POST inserting two rows - and Vite HMR
-     * re-evaluating the worker module is the everyday trigger. A boot failure keeps the listener
-     * attached so every request hears the failure instead of waiting out the transport timeout.
-     */
-    listen(opts?: {
-        scope?: MessagePort | IWorkerMessageScope;
-    }): Promise<void>;
-    /**
-     * The counterpart to `listen()`, and to `ServerApplication.stop()`: runs the post-stop hooks, then
-     * closes every datasource the boot configured. Without it the OPFS exclusive lock a PGlite holds
-     * is never released - the next Worker then fails with `NoModificationAllowedError` until a full
-     * page reload. The Vite recipe is `import.meta.hot?.dispose(() => application.stop())`.
-     *
-     * Detaches BEFORE draining, unlike the server: here the listener IS the socket, and a request
-     * admitted while a datasource is closing has nothing left to run against. A stopped application
-     * is not restartable - build a new one.
-     */
-    stop(): Promise<void>;
-}
-//# sourceMappingURL=worker.d.ts.map

package/dist/cjs/applications/worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/applications/worker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGxC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC;IACjF,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAC;IACjF,mBAAmB,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAC;IACrF,KAAK,CAAC,IAAI,IAAI,CAAC;CAChB;AAED;;;;;GAKG;AACH,8BAAsB,iBAAiB,CACrC,MAAM,SAAS,GAAG,GAAG,GAAG,EACxB,SAAS,SAAS,MAAM,GAAG,EAAE,EAC7B,QAAQ,SAAS,MAAM,GAAG,GAAG,CAC7B,SAAQ,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;IACpD,qMAAqM;IACrM,UAAkB,OAAO,EAAE,yBAAyB,CAAC;IAErD,iGAAiG;IACjG,OAAO,CAAC,cAAc,CAAC,CAAgB;IACvC,+FAA+F;IAC/F,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;;;;OAOG;IACM,cAAc,IAAI,MAAM;IASjC;;;OAGG;YACW,aAAa;IAoC3B,kKAAkK;IAClK,OAAO,CAAC,iBAAiB;IAgBzB,kIAAkI;YACpH,YAAY;IAW1B;;;;;OAKG;YACW,eAAe;IAqC7B,OAAO,CAAC,QAAQ;IAsChB;;;;;;OAMG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,WAAW,GAAG,mBAAmB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjF;;;;;;;;;OASG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAW5B"}

package/dist/cjs/applications/worker.js

@@ -1,190 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkerApplication = void 0;
-const core_1 = require("@venizia/ignis-helpers/core");
-const common_1 = require("@venizia/ignis-helpers/common");
-const ignis_kernel_1 = require("@venizia/ignis-kernel");
-const encode_1 = require("../envelope/encode");
-/**
- * Runs an IGNIS application inside a browser Web Worker: `listen()` replaces what
- * `ServerApplication.start()` does with a socket, attaching `onmessage` instead. Gets REST
- * controller registration by inheritance - `RestApplication.registerControllers()` - the whole
- * reason the DI helpers and `RestComponent` sit in the kernel.
- */
-class WorkerApplication extends ignis_kernel_1.RestApplication {
-    constructor() {
-        super(...arguments);
-        this.isStopped = false;
-    }
-    /**
-     * `configs.projectRoot` wins, else the host's own working directory - read as
-     * `globalThis.process?.cwd?.()`, never a bare `process.cwd()`, because a real browser Worker has no
-     * such global and this class ships there. Bound AND shared with `ModuleUtility` (through the
-     * purity-safe `ProjectRootRegistry`), the same seam `ServerApplication` gives a socket host. No
-     * `node_modules` check here, unlike that host: a browser has no filesystem to check, and `node:fs`
-     * would bundle a Node builtin straight into a Worker.
-     */
-    getProjectRoot() {
-        const projectRoot = this.configs.projectRoot ?? globalThis.process?.cwd?.() ?? '';
-        this.bind({ key: ignis_kernel_1.CoreBindings.APPLICATION_PROJECT_ROOT }).toValue(projectRoot);
-        core_1.ProjectRootRegistry.set({ projectRoot });
-        return projectRoot;
-    }
-    /**
-     * Every failure here is posted back as an `IBffErrorEnvelope`, the failed `postMessage` included:
-     * an exception nobody posts leaves the UI waiting out the transport timeout.
-     */
-    async handleMessage(opts) {
-        const { scope, envelope } = opts;
-        const logger = this.logger.for(this.handleMessage.name);
-        let responseEnvelope;
-        let failure;
-        try {
-            const request = encode_1.BffEnvelope.decodeRequest({ envelope });
-            const response = await this.getServer().fetch(request);
-            responseEnvelope = await encode_1.BffEnvelope.encodeResponse({ response, id: envelope.id });
-        }
-        catch (error) {
-            logger.error('Failed to handle worker message | id: %s | error: %s', envelope.id, error);
-            failure = error;
-        }
-        if (responseEnvelope) {
-            try {
-                scope.postMessage(responseEnvelope, responseEnvelope.body ? [responseEnvelope.body] : []);
-                return;
-            }
-            catch (postError) {
-                logger.error('Failed to post response back to scope, falling back to an error envelope | id: %s | error: %s', envelope.id, postError);
-                failure = postError;
-            }
-        }
-        this.postErrorEnvelope({ scope, id: envelope.id, error: failure });
-    }
-    /** No transfer list: an error envelope carries no `ArrayBuffer` body, and this is already the fallback path - nothing left to hand off if this post fails too. */
-    postErrorEnvelope(opts) {
-        const { scope, id, error } = opts;
-        try {
-            scope.postMessage(encode_1.BffEnvelope.encodeError({ id, error }));
-        }
-        catch (postError) {
-            this.logger
-                .for(this.postErrorEnvelope.name)
-                .error('Failed to post error envelope back to scope | id: %s | error: %s', id, postError);
-        }
-    }
-    /** Everything `ServerApplication.start()` does short of binding a socket. Once this resolves the application answers requests. */
-    async startServing() {
-        // The stack itself is `RestApplication.registerDefaultMiddlewares()` - a BFF must answer with
-        // the framework's envelope exactly as the server does, so it adds nothing and overrides nothing.
-        await this.registerDefaultMiddlewares();
-        await this.initialize();
-        await this.setupMiddlewares();
-        this.getServer().route(this.configs.path.base, this.rootRouter);
-    }
-    /**
-     * Holds an envelope until the application is serving. A dedicated worker's queue is enabled when
-     * its module script is evaluated, so anything posted during boot - PGlite takes ~350ms - reaches
-     * this listener and would otherwise be dropped. One shared promise also hands them on in arrival
-     * order.
-     */
-    async dispatchMessage(opts) {
-        const { scope, envelope } = opts;
-        const logger = this.logger.for(this.dispatchMessage.name);
-        try {
-            await this.servingPromise;
-        }
-        catch (error) {
-            logger.error('The application failed to start, answering with an error envelope | id: %s | error: %s', envelope.id, error);
-            this.postErrorEnvelope({ scope, id: envelope.id, error });
-            return;
-        }
-        // Answered, not dropped: a request admitted before `stop()` and still waiting on the boot has
-        // a caller holding a promise, and silence there is the timeout this whole path exists to avoid.
-        if (this.isStopped) {
-            logger.warn('Refusing a request that arrived after stop() | id: %s', envelope.id);
-            this.postErrorEnvelope({
-                scope,
-                id: envelope.id,
-                error: (0, core_1.getError)({
-                    statusCode: common_1.HTTP.ResultCodes.RS_5.ServiceUnavailable,
-                    message: `[WorkerApplication] The application was stopped before this request could run | id: ${envelope.id}`,
-                }),
-            });
-            return;
-        }
-        await this.handleMessage({ scope, envelope });
-    }
-    attachTo(opts) {
-        const { scope } = opts;
-        const logger = this.logger.for(this.attachTo.name);
-        // Typed as the broader `Event`, not `MessageEvent`: Node's ambient `worker_threads.MessagePort`
-        // (the fallback this package's DOM-less tsconfig resolves `MessagePort` to) declares
-        // `addEventListener` over `Event | MessageEvent`, and a handler narrower than that is not
-        // assignable to it.
-        const listener = (event) => {
-            const envelope = event.data;
-            // A worker scope receives every `postMessage` sent to it, not only ours - a dev-server ping,
-            // a devtools/extension probe, a library's own init handshake. None of those carry an `id`;
-            // silently dropping them (rather than dereferencing `envelope.id` inside `handleMessage`'s
-            // own catch block) is what keeps a foreign message from throwing a bare `TypeError` that
-            // would otherwise escape this listener entirely, unlogged and unposted.
-            if (!envelope?.id) {
-                logger.debug('Ignoring worker message with no request id | data: %j', envelope);
-                return;
-            }
-            // `dispatchMessage` never rejects - every failure inside it, including a failed post, is
-            // caught and handled internally. This `.catch` only guards the sliver of code before its own
-            // try block ever runs.
-            this.dispatchMessage({ scope, envelope }).catch((error) => {
-                logger.error('Unexpected failure handling worker message | error: %s', error);
-            });
-        };
-        scope.addEventListener('message', listener);
-        scope.start?.();
-        this.detachFromScope = () => {
-            scope.removeEventListener?.('message', listener);
-        };
-    }
-    /**
-     * `ServerApplication.start()` minus the socket. `opts.scope` defaults to `globalThis`, never a
-     * bare `self`, which would tie the published types to `lib.webworker`. Idempotent: without the
-     * guard one envelope runs its handler once per call - a POST inserting two rows - and Vite HMR
-     * re-evaluating the worker module is the everyday trigger. A boot failure keeps the listener
-     * attached so every request hears the failure instead of waiting out the transport timeout.
-     */
-    async listen(opts) {
-        if (this.listenPromise) {
-            this.logger
-                .for(this.listen.name)
-                .warn('Already listening - ignoring this call | one scope, one listener');
-            return this.listenPromise;
-        }
-        // Everything down to the first `await` runs synchronously with the caller, which is what makes
-        // the listener observable to anything posted in the same turn.
-        const scope = opts?.scope ?? globalThis;
-        this.attachTo({ scope });
-        this.servingPromise = this.startServing();
-        this.listenPromise = this.servingPromise.then(() => this.executePostStartHooks());
-        return this.listenPromise;
-    }
-    /**
-     * The counterpart to `listen()`, and to `ServerApplication.stop()`: runs the post-stop hooks, then
-     * closes every datasource the boot configured. Without it the OPFS exclusive lock a PGlite holds
-     * is never released - the next Worker then fails with `NoModificationAllowedError` until a full
-     * page reload. The Vite recipe is `import.meta.hot?.dispose(() => application.stop())`.
-     *
-     * Detaches BEFORE draining, unlike the server: here the listener IS the socket, and a request
-     * admitted while a datasource is closing has nothing left to run against. A stopped application
-     * is not restartable - build a new one.
-     */
-    async stop() {
-        this.isStopped = true;
-        this.detachFromScope?.();
-        this.detachFromScope = undefined;
-        await this.executePostStopHooks();
-        await this.closeDataSources();
-        this.logger.for(this.stop.name).info('Worker application STOPPED');
-    }
-}
-exports.WorkerApplication = WorkerApplication;
-//# sourceMappingURL=worker.js.map

package/dist/cjs/applications/worker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../src/applications/worker.ts"],"names":[],"mappings":";;;AAAA,sDAA4E;AAC5E,0DAAqD;AACrD,wDAAsE;AAEtE,8CAAgD;AAiBhD;;;;;GAKG;AACH,MAAsB,iBAIpB,SAAQ,8BAA4C;IAJtD;;QAaU,cAAS,GAAG,KAAK,CAAC;IA0N5B,CAAC;IAxNC;;;;;;;OAOG;IACM,cAAc;QACrB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC;QAElF,IAAI,CAAC,IAAI,CAAS,EAAE,GAAG,EAAE,2BAAY,CAAC,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACvF,0BAAmB,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QAEzC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,aAAa,CAAC,IAG3B;QACC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAExD,IAAI,gBAAkD,CAAC;QACvD,IAAI,OAAgB,CAAC;QAErB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,oBAAW,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YACxD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACvD,gBAAgB,GAAG,MAAM,oBAAW,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACrF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,sDAAsD,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACzF,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;QAED,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,KAAK,CAAC,WAAW,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC1F,OAAO;YACT,CAAC;YAAC,OAAO,SAAS,EAAE,CAAC;gBACnB,MAAM,CAAC,KAAK,CACV,+FAA+F,EAC/F,QAAQ,CAAC,EAAE,EACX,SAAS,CACV,CAAC;gBACF,OAAO,GAAG,SAAS,CAAC;YACtB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,kKAAkK;IAC1J,iBAAiB,CAAC,IAIzB;QACC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAElC,IAAI,CAAC;YACH,KAAK,CAAC,WAAW,CAAC,oBAAW,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;iBAChC,KAAK,CAAC,kEAAkE,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IAED,kIAAkI;IAC1H,KAAK,CAAC,YAAY;QACxB,8FAA8F;QAC9F,iGAAiG;QACjG,MAAM,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAExC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE9B,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAClE,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,eAAe,CAAC,IAG7B;QACC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE1D,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV,wFAAwF,EACxF,QAAQ,CAAC,EAAE,EACX,KAAK,CACN,CAAC;YACF,IAAI,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,8FAA8F;QAC9F,gGAAgG;QAChG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,uDAAuD,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClF,IAAI,CAAC,iBAAiB,CAAC;gBACrB,KAAK;gBACL,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,KAAK,EAAE,IAAA,eAAQ,EAAC;oBACd,UAAU,EAAE,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB;oBACpD,OAAO,EAAE,uFAAuF,QAAQ,CAAC,EAAE,EAAE;iBAC9G,CAAC;aACH,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChD,CAAC;IAEO,QAAQ,CAAC,IAAkD;QACjE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEnD,gGAAgG;QAChG,qFAAqF;QACrF,0FAA0F;QAC1F,oBAAoB;QACpB,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAQ,EAAE;YACtC,MAAM,QAAQ,GAAI,KAAsB,CAAC,IAAuC,CAAC;YAEjF,6FAA6F;YAC7F,2FAA2F;YAC3F,2FAA2F;YAC3F,yFAAyF;YACzF,wEAAwE;YACxE,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC;gBAClB,MAAM,CAAC,KAAK,CAAC,uDAAuD,EAAE,QAAQ,CAAC,CAAC;gBAChF,OAAO;YACT,CAAC;YAED,yFAAyF;YACzF,6FAA6F;YAC7F,uBAAuB;YACvB,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACxD,MAAM,CAAC,KAAK,CAAC,wDAAwD,EAAE,KAAK,CAAC,CAAC;YAChF,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE5C,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAEhB,IAAI,CAAC,eAAe,GAAG,GAAG,EAAE;YAC1B,KAAK,CAAC,mBAAmB,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACnD,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,IAAoD;QAC/D,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;iBACrB,IAAI,CAAC,kEAAkE,CAAC,CAAC;YAC5E,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QAED,+FAA+F;QAC/F,+DAA+D;QAC/D,MAAM,KAAK,GACT,IAAI,EAAE,KAAK,IAAK,UAAkC,CAAC;QAErD,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAEzB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC;QAElF,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACzB,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QAEjC,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAClC,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE9B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACrE,CAAC;CACF;AAvOD,8CAuOC","sourcesContent":["import { getError, ProjectRootRegistry } from '@venizia/ignis-helpers/core';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { CoreBindings, RestApplication } from '@venizia/ignis-kernel';\nimport type { Env, Schema } from 'hono';\nimport { BffEnvelope } from '@/envelope/encode';\nimport type { IBffRequestEnvelope, IBffResponseEnvelope } from '@/envelope/common';\nimport type { IWorkerApplicationConfigs } from './common';\n\n/**\n * Structural shape of the two globals `listen()` can attach to. Never `DedicatedWorkerGlobalScope`:\n * naming it emits it into the published `.d.ts` and forces every consumer to compile with\n * `lib.webworker`. `start` is optional because a `MessagePort`s queue starts disabled and only\n * `start()` enables it, while a worker global scope has no such method at all.\n */\nexport interface IWorkerMessageScope {\n  postMessage(message: unknown, transfer?: Array<ArrayBuffer | MessagePort>): void;\n  addEventListener(type: 'message', listener: (event: MessageEvent) => void): void;\n  removeEventListener?(type: 'message', listener: (event: MessageEvent) => void): void;\n  start?(): void;\n}\n\n/**\n * Runs an IGNIS application inside a browser Web Worker: `listen()` replaces what\n * `ServerApplication.start()` does with a socket, attaching `onmessage` instead. Gets REST\n * controller registration by inheritance - `RestApplication.registerControllers()` - the whole\n * reason the DI helpers and `RestComponent` sit in the kernel.\n */\nexport abstract class WorkerApplication<\n  AppEnv extends Env = Env,\n  AppSchema extends Schema = {},\n  BasePath extends string = '/',\n> extends RestApplication<AppEnv, AppSchema, BasePath> {\n  /** Widened by this layer, the only one with an optional `projectRoot` to read. Assigned by the base constructor - `declare` so no field initializer runs here and overwrites it with `undefined`. */\n  declare protected configs: IWorkerApplicationConfigs;\n\n  /** Resolves once the router tree is mounted - what an envelope arriving during boot waits on. */\n  private servingPromise?: Promise<void>;\n  /** The whole `listen()` call, kept so a second one is a no-op instead of a second listener. */\n  private listenPromise?: Promise<void>;\n  private detachFromScope?: () => void;\n  private isStopped = false;\n\n  /**\n   * `configs.projectRoot` wins, else the host's own working directory - read as\n   * `globalThis.process?.cwd?.()`, never a bare `process.cwd()`, because a real browser Worker has no\n   * such global and this class ships there. Bound AND shared with `ModuleUtility` (through the\n   * purity-safe `ProjectRootRegistry`), the same seam `ServerApplication` gives a socket host. No\n   * `node_modules` check here, unlike that host: a browser has no filesystem to check, and `node:fs`\n   * would bundle a Node builtin straight into a Worker.\n   */\n  override getProjectRoot(): string {\n    const projectRoot = this.configs.projectRoot ?? globalThis.process?.cwd?.() ?? '';\n\n    this.bind<string>({ key: CoreBindings.APPLICATION_PROJECT_ROOT }).toValue(projectRoot);\n    ProjectRootRegistry.set({ projectRoot });\n\n    return projectRoot;\n  }\n\n  /**\n   * Every failure here is posted back as an `IBffErrorEnvelope`, the failed `postMessage` included:\n   * an exception nobody posts leaves the UI waiting out the transport timeout.\n   */\n  private async handleMessage(opts: {\n    scope: MessagePort | IWorkerMessageScope;\n    envelope: IBffRequestEnvelope;\n  }): Promise<void> {\n    const { scope, envelope } = opts;\n    const logger = this.logger.for(this.handleMessage.name);\n\n    let responseEnvelope: IBffResponseEnvelope | undefined;\n    let failure: unknown;\n\n    try {\n      const request = BffEnvelope.decodeRequest({ envelope });\n      const response = await this.getServer().fetch(request);\n      responseEnvelope = await BffEnvelope.encodeResponse({ response, id: envelope.id });\n    } catch (error) {\n      logger.error('Failed to handle worker message | id: %s | error: %s', envelope.id, error);\n      failure = error;\n    }\n\n    if (responseEnvelope) {\n      try {\n        scope.postMessage(responseEnvelope, responseEnvelope.body ? [responseEnvelope.body] : []);\n        return;\n      } catch (postError) {\n        logger.error(\n          'Failed to post response back to scope, falling back to an error envelope | id: %s | error: %s',\n          envelope.id,\n          postError,\n        );\n        failure = postError;\n      }\n    }\n\n    this.postErrorEnvelope({ scope, id: envelope.id, error: failure });\n  }\n\n  /** No transfer list: an error envelope carries no `ArrayBuffer` body, and this is already the fallback path - nothing left to hand off if this post fails too. */\n  private postErrorEnvelope(opts: {\n    scope: MessagePort | IWorkerMessageScope;\n    id: string;\n    error: unknown;\n  }): void {\n    const { scope, id, error } = opts;\n\n    try {\n      scope.postMessage(BffEnvelope.encodeError({ id, error }));\n    } catch (postError) {\n      this.logger\n        .for(this.postErrorEnvelope.name)\n        .error('Failed to post error envelope back to scope | id: %s | error: %s', id, postError);\n    }\n  }\n\n  /** Everything `ServerApplication.start()` does short of binding a socket. Once this resolves the application answers requests. */\n  private async startServing(): Promise<void> {\n    // The stack itself is `RestApplication.registerDefaultMiddlewares()` - a BFF must answer with\n    // the framework's envelope exactly as the server does, so it adds nothing and overrides nothing.\n    await this.registerDefaultMiddlewares();\n\n    await this.initialize();\n    await this.setupMiddlewares();\n\n    this.getServer().route(this.configs.path.base, this.rootRouter);\n  }\n\n  /**\n   * Holds an envelope until the application is serving. A dedicated worker's queue is enabled when\n   * its module script is evaluated, so anything posted during boot - PGlite takes ~350ms - reaches\n   * this listener and would otherwise be dropped. One shared promise also hands them on in arrival\n   * order.\n   */\n  private async dispatchMessage(opts: {\n    scope: MessagePort | IWorkerMessageScope;\n    envelope: IBffRequestEnvelope;\n  }): Promise<void> {\n    const { scope, envelope } = opts;\n    const logger = this.logger.for(this.dispatchMessage.name);\n\n    try {\n      await this.servingPromise;\n    } catch (error) {\n      logger.error(\n        'The application failed to start, answering with an error envelope | id: %s | error: %s',\n        envelope.id,\n        error,\n      );\n      this.postErrorEnvelope({ scope, id: envelope.id, error });\n      return;\n    }\n\n    // Answered, not dropped: a request admitted before `stop()` and still waiting on the boot has\n    // a caller holding a promise, and silence there is the timeout this whole path exists to avoid.\n    if (this.isStopped) {\n      logger.warn('Refusing a request that arrived after stop() | id: %s', envelope.id);\n      this.postErrorEnvelope({\n        scope,\n        id: envelope.id,\n        error: getError({\n          statusCode: HTTP.ResultCodes.RS_5.ServiceUnavailable,\n          message: `[WorkerApplication] The application was stopped before this request could run | id: ${envelope.id}`,\n        }),\n      });\n      return;\n    }\n\n    await this.handleMessage({ scope, envelope });\n  }\n\n  private attachTo(opts: { scope: MessagePort | IWorkerMessageScope }): void {\n    const { scope } = opts;\n    const logger = this.logger.for(this.attachTo.name);\n\n    // Typed as the broader `Event`, not `MessageEvent`: Node's ambient `worker_threads.MessagePort`\n    // (the fallback this package's DOM-less tsconfig resolves `MessagePort` to) declares\n    // `addEventListener` over `Event | MessageEvent`, and a handler narrower than that is not\n    // assignable to it.\n    const listener = (event: Event): void => {\n      const envelope = (event as MessageEvent).data as IBffRequestEnvelope | undefined;\n\n      // A worker scope receives every `postMessage` sent to it, not only ours - a dev-server ping,\n      // a devtools/extension probe, a library's own init handshake. None of those carry an `id`;\n      // silently dropping them (rather than dereferencing `envelope.id` inside `handleMessage`'s\n      // own catch block) is what keeps a foreign message from throwing a bare `TypeError` that\n      // would otherwise escape this listener entirely, unlogged and unposted.\n      if (!envelope?.id) {\n        logger.debug('Ignoring worker message with no request id | data: %j', envelope);\n        return;\n      }\n\n      // `dispatchMessage` never rejects - every failure inside it, including a failed post, is\n      // caught and handled internally. This `.catch` only guards the sliver of code before its own\n      // try block ever runs.\n      this.dispatchMessage({ scope, envelope }).catch((error) => {\n        logger.error('Unexpected failure handling worker message | error: %s', error);\n      });\n    };\n\n    scope.addEventListener('message', listener);\n\n    scope.start?.();\n\n    this.detachFromScope = () => {\n      scope.removeEventListener?.('message', listener);\n    };\n  }\n\n  /**\n   * `ServerApplication.start()` minus the socket. `opts.scope` defaults to `globalThis`, never a\n   * bare `self`, which would tie the published types to `lib.webworker`. Idempotent: without the\n   * guard one envelope runs its handler once per call - a POST inserting two rows - and Vite HMR\n   * re-evaluating the worker module is the everyday trigger. A boot failure keeps the listener\n   * attached so every request hears the failure instead of waiting out the transport timeout.\n   */\n  async listen(opts?: { scope?: MessagePort | IWorkerMessageScope }): Promise<void> {\n    if (this.listenPromise) {\n      this.logger\n        .for(this.listen.name)\n        .warn('Already listening - ignoring this call | one scope, one listener');\n      return this.listenPromise;\n    }\n\n    // Everything down to the first `await` runs synchronously with the caller, which is what makes\n    // the listener observable to anything posted in the same turn.\n    const scope: MessagePort | IWorkerMessageScope =\n      opts?.scope ?? (globalThis as IWorkerMessageScope);\n\n    this.attachTo({ scope });\n\n    this.servingPromise = this.startServing();\n    this.listenPromise = this.servingPromise.then(() => this.executePostStartHooks());\n\n    return this.listenPromise;\n  }\n\n  /**\n   * The counterpart to `listen()`, and to `ServerApplication.stop()`: runs the post-stop hooks, then\n   * closes every datasource the boot configured. Without it the OPFS exclusive lock a PGlite holds\n   * is never released - the next Worker then fails with `NoModificationAllowedError` until a full\n   * page reload. The Vite recipe is `import.meta.hot?.dispose(() => application.stop())`.\n   *\n   * Detaches BEFORE draining, unlike the server: here the listener IS the socket, and a request\n   * admitted while a datasource is closing has nothing left to run against. A stopped application\n   * is not restartable - build a new one.\n   */\n  async stop(): Promise<void> {\n    this.isStopped = true;\n\n    this.detachFromScope?.();\n    this.detachFromScope = undefined;\n\n    await this.executePostStopHooks();\n    await this.closeDataSources();\n\n    this.logger.for(this.stop.name).info('Worker application STOPPED');\n  }\n}\n"]}

package/dist/cjs/envelope/common/index.d.ts

@@ -1,2 +0,0 @@
-export * from './types';
-//# sourceMappingURL=index.d.ts.map

package/dist/cjs/envelope/common/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/envelope/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/cjs/envelope/common/index.js

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./types"), exports);
-//# sourceMappingURL=index.js.map

package/dist/cjs/envelope/common/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/envelope/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB","sourcesContent":["export * from './types';\n"]}

package/dist/cjs/envelope/common/types.d.ts

@@ -1,37 +0,0 @@
-/** Headers are carried as tuples: a `Headers` instance is not structured-cloneable. */
-export type TEnvelopeHeaders = Array<[string, string]>;
-export interface IBffRequestEnvelope {
-    id: string;
-    method: string;
-    url: string;
-    headers: TEnvelopeHeaders;
-    /** Buffered, never a stream - `ReadableStream` does not transfer in Safari. */
-    body?: ArrayBuffer;
-}
-export interface IBffResponseEnvelope {
-    id: string;
-    status: number;
-    statusText?: string;
-    headers: TEnvelopeHeaders;
-    body?: ArrayBuffer;
-}
-/**
- * A custom `Error` subclass loses its name, its own properties and its prototype through structured
- * clone, so an `ApplicationError` cannot cross as itself. It crosses as its normalised shape and is
- * rebuilt with `fromError` on the far side.
- */
-export interface IBffErrorEnvelope {
-    id: string;
-    /**
-     * Carried explicitly, because `fromError` defaults a missing one to 400. This envelope is only
-     * ever produced when something escaped Hono's `onError` - the 500-class failures a UI must not
-     * classify as its own bad request.
-     */
-    statusCode: number;
-    error: {
-        text: string;
-        code?: string;
-        args?: unknown;
-    };
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/cjs/envelope/common/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/envelope/common/types.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,gBAAgB,CAAC;IAC1B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACxD"}

package/dist/cjs/envelope/common/types.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map

package/dist/cjs/envelope/common/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/envelope/common/types.ts"],"names":[],"mappings":"","sourcesContent":["/** Headers are carried as tuples: a `Headers` instance is not structured-cloneable. */\nexport type TEnvelopeHeaders = Array<[string, string]>;\n\nexport interface IBffRequestEnvelope {\n  id: string;\n  method: string;\n  url: string;\n  headers: TEnvelopeHeaders;\n  /** Buffered, never a stream - `ReadableStream` does not transfer in Safari. */\n  body?: ArrayBuffer;\n}\n\nexport interface IBffResponseEnvelope {\n  id: string;\n  status: number;\n  statusText?: string;\n  headers: TEnvelopeHeaders;\n  body?: ArrayBuffer;\n}\n\n/**\n * A custom `Error` subclass loses its name, its own properties and its prototype through structured\n * clone, so an `ApplicationError` cannot cross as itself. It crosses as its normalised shape and is\n * rebuilt with `fromError` on the far side.\n */\nexport interface IBffErrorEnvelope {\n  id: string;\n  /**\n   * Carried explicitly, because `fromError` defaults a missing one to 400. This envelope is only\n   * ever produced when something escaped Hono's `onError` - the 500-class failures a UI must not\n   * classify as its own bad request.\n   */\n  statusCode: number;\n  error: { text: string; code?: string; args?: unknown };\n}\n"]}