@zudojs/lifecycle 0.0.1

package/dist/lifecycleSignal/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/lifecycle/signal
+ *
+ * Process signal handler for graceful shutdown.
+ */
+export { installSignalHandlers, DEFAULT_SHUTDOWN_SIGNALS, } from "./lifecycleSignal.handler.js";
+//# sourceMappingURL=index.js.map

package/dist/lifecycleSignal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lifecycleSignal/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,8BAA8B,CAAC"}

package/dist/lifecycleSignal/lifecycleSignal.handler.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @zudojs/lifecycle/signal
+ *
+ * Process signal handler — manages SIGTERM, SIGINT, SIGHUP for graceful shutdown.
+ */
+/** Options for signal handling. */
+export interface SignalHandlerOptions {
+    /** Signals to listen for. */
+    readonly signals?: readonly NodeJS.Signals[];
+    /** Function to call when a signal is received. */
+    readonly handler: () => void;
+}
+/**
+ * Installs process signal handlers that trigger lifecycle shutdown.
+ * Returns a cleanup function to remove the handlers.
+ */
+export declare function installSignalHandlers(options: SignalHandlerOptions): () => void;
+/** Default signal configuration for graceful shutdown. */
+export declare const DEFAULT_SHUTDOWN_SIGNALS: readonly NodeJS.Signals[];
+//# sourceMappingURL=lifecycleSignal.handler.d.ts.map

package/dist/lifecycleSignal/lifecycleSignal.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleSignal.handler.d.ts","sourceRoot":"","sources":["../../src/lifecycleSignal/lifecycleSignal.handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mCAAmC;AACnC,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,OAAO,EAAE,CAAC;IAC7C,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,oBAAoB,GAC5B,MAAM,IAAI,CAmBZ;AAED,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,CAAC,OAAO,EACxB,CAAC"}

package/dist/lifecycleSignal/lifecycleSignal.handler.js

@@ -0,0 +1,29 @@
+/**
+ * @zudojs/lifecycle/signal
+ *
+ * Process signal handler — manages SIGTERM, SIGINT, SIGHUP for graceful shutdown.
+ */
+/**
+ * Installs process signal handlers that trigger lifecycle shutdown.
+ * Returns a cleanup function to remove the handlers.
+ */
+export function installSignalHandlers(options) {
+    const signals = options.signals ?? ["SIGINT", "SIGTERM"];
+    const handler = options.handler;
+    const installed = [];
+    for (const signal of signals) {
+        const listener = () => {
+            handler();
+        };
+        process.on(signal, listener);
+        installed.push([signal, listener]);
+    }
+    return () => {
+        for (const [sig, listener] of installed) {
+            process.removeListener(sig, listener);
+        }
+    };
+}
+/** Default signal configuration for graceful shutdown. */
+export const DEFAULT_SHUTDOWN_SIGNALS = Object.freeze(["SIGINT", "SIGTERM"]);
+//# sourceMappingURL=lifecycleSignal.handler.js.map

package/dist/lifecycleSignal/lifecycleSignal.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleSignal.handler.js","sourceRoot":"","sources":["../../src/lifecycleSignal/lifecycleSignal.handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAA6B;IAE7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhC,MAAM,SAAS,GAAwC,EAAE,CAAC;IAE1D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC7B,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,GAAG,EAAE;QACV,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;YACxC,OAAO,CAAC,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GACnC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC"}

package/dist/lifecycleState/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/lifecycle/state
+ *
+ * Lifecycle state machine for tracking and validating state transitions.
+ */
+export { LifecycleStateMachine } from "./lifecycleState.machine.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lifecycleState/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycleState/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/lifecycleState/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/lifecycle/state
+ *
+ * Lifecycle state machine for tracking and validating state transitions.
+ */
+export { LifecycleStateMachine } from "./lifecycleState.machine.js";
+//# sourceMappingURL=index.js.map

package/dist/lifecycleState/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lifecycleState/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/lifecycleState/lifecycleState.machine.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @zudojs/lifecycle/state-machine
+ *
+ * Lifecycle state machine — validates transitions and tracks current state.
+ */
+import { LifecycleState } from "@zudojs/constants";
+/**
+ * Manages lifecycle state transitions for a single entity.
+ * Validates transitions against the allowed transition map.
+ */
+export declare class LifecycleStateMachine {
+    private readonly _id;
+    private _state;
+    constructor(_id: string);
+    /** Returns the current state. */
+    get state(): LifecycleState;
+    /** Returns whether the entity is in a terminal state. */
+    get isTerminal(): boolean;
+    /** Returns whether the entity is in a running state. */
+    get isRunning(): boolean;
+    /**
+     * Transitions to a new state.
+     * Throws LifecycleStateError if the transition is invalid.
+     */
+    transition(to: LifecycleState): void;
+    /**
+     * Checks whether a transition to the given state is valid.
+     */
+    canTransition(to: LifecycleState): boolean;
+    /**
+     * Force-sets the state without validation.
+     * Use only for initialization or error recovery.
+     */
+    forceState(state: LifecycleState): void;
+}
+//# sourceMappingURL=lifecycleState.machine.d.ts.map

package/dist/lifecycleState/lifecycleState.machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleState.machine.d.ts","sourceRoot":"","sources":["../../src/lifecycleState/lifecycleState.machine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAG3B;;;GAGG;AACH,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,MAAM,CAAuC;IAErD,YAA6B,GAAG,EAAE,MAAM,EAAI;IAE5C,iCAAiC;IACjC,IAAW,KAAK,IAAI,cAAc,CAEjC;IAED,yDAAyD;IACzD,IAAW,UAAU,IAAI,OAAO,CAK/B;IAED,wDAAwD;IACxD,IAAW,SAAS,IAAI,OAAO,CAK9B;IAED;;;OAGG;IACI,UAAU,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAK1C;IAED;;OAEG;IACI,aAAa,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAGhD;IAED;;;OAGG;IACI,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAE7C;CACF"}

package/dist/lifecycleState/lifecycleState.machine.js

@@ -0,0 +1,57 @@
+/**
+ * @zudojs/lifecycle/state-machine
+ *
+ * Lifecycle state machine — validates transitions and tracks current state.
+ */
+import { LifecycleState, LIFECYCLE_VALID_TRANSITIONS, } from "@zudojs/constants";
+import { LifecycleStateError } from "@zudojs/errors";
+/**
+ * Manages lifecycle state transitions for a single entity.
+ * Validates transitions against the allowed transition map.
+ */
+export class LifecycleStateMachine {
+    _id;
+    _state = LifecycleState.IDLE;
+    constructor(_id) {
+        this._id = _id;
+    }
+    /** Returns the current state. */
+    get state() {
+        return this._state;
+    }
+    /** Returns whether the entity is in a terminal state. */
+    get isTerminal() {
+        return (this._state === LifecycleState.DISPOSED ||
+            this._state === LifecycleState.STOPPED);
+    }
+    /** Returns whether the entity is in a running state. */
+    get isRunning() {
+        return (this._state === LifecycleState.STARTED ||
+            this._state === LifecycleState.READY);
+    }
+    /**
+     * Transitions to a new state.
+     * Throws LifecycleStateError if the transition is invalid.
+     */
+    transition(to) {
+        if (!this.canTransition(to)) {
+            throw new LifecycleStateError(this._state, to, this._id);
+        }
+        this._state = to;
+    }
+    /**
+     * Checks whether a transition to the given state is valid.
+     */
+    canTransition(to) {
+        const allowed = LIFECYCLE_VALID_TRANSITIONS[this._state];
+        return allowed.includes(to);
+    }
+    /**
+     * Force-sets the state without validation.
+     * Use only for initialization or error recovery.
+     */
+    forceState(state) {
+        this._state = state;
+    }
+}
+//# sourceMappingURL=lifecycleState.machine.js.map

package/dist/lifecycleState/lifecycleState.machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleState.machine.js","sourceRoot":"","sources":["../../src/lifecycleState/lifecycleState.machine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IAGH,GAAG;IAFxB,MAAM,GAAmB,cAAc,CAAC,IAAI,CAAC;IAErD,YAA6B,GAAW;mBAAX,GAAG;IAAW,CAAC;IAE5C,iCAAiC;IACjC,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,yDAAyD;IACzD,IAAW,UAAU;QACnB,OAAO,CACL,IAAI,CAAC,MAAM,KAAK,cAAc,CAAC,QAAQ;YACvC,IAAI,CAAC,MAAM,KAAK,cAAc,CAAC,OAAO,CACvC,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,IAAW,SAAS;QAClB,OAAO,CACL,IAAI,CAAC,MAAM,KAAK,cAAc,CAAC,OAAO;YACtC,IAAI,CAAC,MAAM,KAAK,cAAc,CAAC,KAAK,CACrC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,EAAkB;QAClC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,EAAkB;QACrC,MAAM,OAAO,GAAG,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,KAAqB;QACrC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@zudojs/lifecycle",
+  "version": "0.0.1",
+  "description": "Application and component lifecycle orchestration with state machine, dependency ordering, graceful shutdown, rollback, and signals.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@zudojs/errors": "0.0.1",
+    "@zudojs/constants": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.1",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "zudojs",
+    "lifecycle",
+    "state-machine",
+    "startup",
+    "shutdown"
+  ],
+  "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oyinlola-tech/zudo"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}