@helyx/core 0.1.20 → 0.1.21

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.21
+
+### Patch Changes
+
+- Harden startup cleanup, lease ownership, database transaction handling, worker shutdown, and stale-work fencing across the hosted and self-hosted runtime.
+
 ## 0.1.20
 
 ### Patch Changes

package/dist/async-cleanup-stack.d.ts

@@ -0,0 +1,8 @@
+export type AsyncCleanup = () => void | Promise<void>;
+export declare class AsyncCleanupStack {
+    #private;
+    defer(cleanup: AsyncCleanup): void;
+    close(): Promise<void>;
+    fail(cause: unknown): Promise<never>;
+}
+//# sourceMappingURL=async-cleanup-stack.d.ts.map

package/dist/async-cleanup-stack.js

@@ -0,0 +1,41 @@
+export class AsyncCleanupStack {
+    #cleanups = [];
+    #closing;
+    defer(cleanup) {
+        if (this.#closing)
+            throw new Error("Cannot register cleanup after shutdown has started");
+        this.#cleanups.push(cleanup);
+    }
+    close() {
+        if (this.#closing)
+            return this.#closing;
+        this.#closing = this.#drain();
+        return this.#closing;
+    }
+    async fail(cause) {
+        try {
+            await this.close();
+        }
+        catch (cleanupError) {
+            throw new AggregateError([cause, cleanupError], "Startup and cleanup both failed", { cause: cleanupError });
+        }
+        throw cause;
+    }
+    async #drain() {
+        const failures = [];
+        for (const cleanup of this.#cleanups.reverse()) {
+            try {
+                await cleanup();
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        }
+        this.#cleanups.length = 0;
+        if (failures.length === 1)
+            throw failures[0];
+        if (failures.length > 1)
+            throw new AggregateError(failures, "Multiple runtime cleanups failed");
+    }
+}
+//# sourceMappingURL=async-cleanup-stack.js.map

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import type { HealthResult, Logger, ModuleDefinition, ModulePermissionConfiguration, PermissionActor, GuildAccessPolicy, HelyxAccessLevel, PermissionPolicy, ServiceAccess } from "@helyx/sdk";
+export * from "./async-cleanup-stack.js";
 export type RuntimeState = "created" | "starting" | "running" | "stopping" | "stopped" | "failed";
 export interface ModuleHealth {
     id: string;

package/dist/index.js

@@ -1,4 +1,5 @@
 import { orderModuleManifests, parseModuleManifest, } from "@helyx/module-manifest";
+export * from "./async-cleanup-stack.js";
 export class ServiceRegistry {
     #services;
     constructor(services = new Map()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helyx/core",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "Module lifecycle and runtime registry for Helyx.",
   "keywords": [
     "helyx",