@zudojs/runtime 0.0.1

package/dist/testRuntime/testRuntime.core.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @zudojs/runtime — Test Runtime
+ *
+ * Provides a lightweight runtime for testing purposes with
+ * mock infrastructure and easy lifecycle management.
+ */
+import type { Module } from "@zudojs/core";
+import { DefaultRuntime } from "../runtime/runtime.core.js";
+import type { RuntimeOptions } from "../runtimeOptions/runtimeOptions.type.js";
+/**
+ * Creates a test runtime with mock infrastructure.
+ *
+ * @param modules - Optional modules to register.
+ * @param options - Optional runtime options overrides.
+ * @returns A runtime instance ready for testing.
+ */
+export declare function createTestRuntime(modules?: Module[], options?: Partial<RuntimeOptions>): DefaultRuntime;
+/**
+ * Creates a mock module for testing.
+ *
+ * @param id - Module identifier.
+ * @param dependencies - Module dependencies.
+ * @returns A mock module with vi.fn() hooks.
+ */
+export declare function createMockModule(id: string, dependencies?: string[]): Module;
+/**
+ * Starts a test runtime, runs a callback, and stops it.
+ *
+ * @param fn - Async function to run with the started runtime.
+ * @param modules - Optional modules to register.
+ * @param options - Optional runtime options.
+ */
+export declare function withTestRuntime<T>(fn: (runtime: DefaultRuntime) => Promise<T>, modules?: Module[], options?: Partial<RuntimeOptions>): Promise<T>;
+//# sourceMappingURL=testRuntime.core.d.ts.map

package/dist/testRuntime/testRuntime.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testRuntime.core.d.ts","sourceRoot":"","sources":["../../src/testRuntime/testRuntime.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAE/E;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,MAAM,EAAO,EACtB,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GACpC,cAAc,CA8BhB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,EACV,YAAY,GAAE,MAAM,EAAO,GAC1B,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,EAAE,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,EAC3C,OAAO,GAAE,MAAM,EAAO,EACtB,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GACpC,OAAO,CAAC,CAAC,CAAC,CAQZ"}

package/dist/testRuntime/testRuntime.core.js

@@ -0,0 +1,81 @@
+/**
+ * @zudojs/runtime — Test Runtime
+ *
+ * Provides a lightweight runtime for testing purposes with
+ * mock infrastructure and easy lifecycle management.
+ */
+import { createLogger } from "@zudojs/logger";
+import { createContainer } from "@zudojs/container";
+import { createEventBus } from "@zudojs/events";
+import { DefaultRuntime } from "../runtime/runtime.core.js";
+/**
+ * Creates a test runtime with mock infrastructure.
+ *
+ * @param modules - Optional modules to register.
+ * @param options - Optional runtime options overrides.
+ * @returns A runtime instance ready for testing.
+ */
+export function createTestRuntime(modules = [], options = {}) {
+    const logger = createLogger({ name: "test-runtime" });
+    const container = createContainer();
+    const eventBus = createEventBus();
+    const moduleMap = new Map();
+    for (const module of modules) {
+        moduleMap.set(module.id, module);
+    }
+    const dependencies = {
+        modules: moduleMap,
+        logger,
+        container,
+        eventBus,
+    };
+    const runtimeOptions = {
+        environment: "test",
+        applicationName: "test-app",
+        applicationVersion: "0.0.0-test",
+        handleSignals: false,
+        handleFatalErrors: false,
+        shutdownTimeout: 5000,
+        startupTimeout: 10000,
+        emitEvents: false,
+        ...options,
+    };
+    return new DefaultRuntime(dependencies, runtimeOptions);
+}
+/**
+ * Creates a mock module for testing.
+ *
+ * @param id - Module identifier.
+ * @param dependencies - Module dependencies.
+ * @returns A mock module with vi.fn() hooks.
+ */
+export function createMockModule(id, dependencies = []) {
+    const { vi } = require("vitest");
+    return {
+        id,
+        name: `Module ${id}`,
+        dependencies,
+        onInitialize: vi.fn().mockResolvedValue(undefined),
+        onReady: vi.fn().mockResolvedValue(undefined),
+        onShutdown: vi.fn().mockResolvedValue(undefined),
+        onDestroy: vi.fn().mockResolvedValue(undefined),
+    };
+}
+/**
+ * Starts a test runtime, runs a callback, and stops it.
+ *
+ * @param fn - Async function to run with the started runtime.
+ * @param modules - Optional modules to register.
+ * @param options - Optional runtime options.
+ */
+export async function withTestRuntime(fn, modules = [], options = {}) {
+    const runtime = createTestRuntime(modules, options);
+    await runtime.start();
+    try {
+        return await fn(runtime);
+    }
+    finally {
+        await runtime.stop();
+    }
+}
+//# sourceMappingURL=testRuntime.core.js.map

package/dist/testRuntime/testRuntime.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testRuntime.core.js","sourceRoot":"","sources":["../../src/testRuntime/testRuntime.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAI5D;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAO,GAAa,EAAE,EACtB,OAAO,GAA4B,EAAE;IAErC,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAElC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,YAAY,GAAwB;QACxC,OAAO,EAAE,SAAS;QAClB,MAAM;QACN,SAAS;QACT,QAAQ;KACT,CAAC;IAEF,MAAM,cAAc,GAAmB;QACrC,WAAW,EAAE,MAAM;QACnB,eAAe,EAAE,UAAU;QAC3B,kBAAkB,EAAE,YAAY;QAChC,aAAa,EAAE,KAAK;QACpB,iBAAiB,EAAE,KAAK;QACxB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,KAAK;QACrB,UAAU,EAAE,KAAK;QACjB,GAAG,OAAO;KACX,CAAC;IAEF,OAAO,IAAI,cAAc,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAU,EACV,YAAY,GAAa,EAAE;IAE3B,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO;QACL,EAAE;QACF,IAAI,EAAE,UAAU,EAAE,EAAE;QACpB,YAAY;QACZ,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAClD,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC7C,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAChD,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;KAChD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,EAA2C,EAC3C,OAAO,GAAa,EAAE,EACtB,OAAO,GAA4B,EAAE;IAErC,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@zudojs/runtime",
+  "version": "0.0.1",
+  "description": "Application lifecycle orchestrator with dependency ordering, rollback, signals, and readiness checks.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "tsc -p tsconfig.json --clean"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.1",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "dependencies": {
+    "@zudojs/errors": "workspace:*",
+    "@zudojs/constants": "workspace:*",
+    "@zudojs/container": "workspace:*",
+    "@zudojs/config": "workspace:*",
+    "@zudojs/logger": "workspace:*",
+    "@zudojs/events": "workspace:*",
+    "@zudojs/core": "workspace:*"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "module": "./dist/index.js",
+  "keywords": [
+    "zudojs",
+    "runtime",
+    "orchestrator",
+    "services"
+  ],
+  "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oyinlola-tech/zudo"
+  }
+}