feat: add module runtime lifecycle

packages/module-sdk/src/define-module-runtime.ts

@@ -0,0 +1,7 @@
+import { type ModuleRuntimeDefinition, parseModuleRuntimeDefinition } from "@ekklesia/contracts";
+
+export function defineModuleRuntime<const Definition extends ModuleRuntimeDefinition>(
+  definition: Definition,
+): Readonly<Definition> {
+  return parseModuleRuntimeDefinition(definition) as Readonly<Definition>;
+}

packages/module-sdk/src/define-module.ts

@@ -1,9 +0,0 @@
-import {
-  type ModuleManifest,
-  type ModuleManifestInput,
-  parseModuleManifest,
-} from "@ekklesia/contracts";
-
-export function defineModule(manifest: ModuleManifestInput): ModuleManifest {
-  return parseModuleManifest(manifest);
-}

packages/module-sdk/src/index.ts

@@ -1,2 +1,2 @@
 export * from "@ekklesia/contracts";
-export * from "./define-module.js";
+export * from "./define-module-runtime.js";

packages/module-sdk/tests/define-module-runtime.test.ts

@@ -0,0 +1,25 @@
+import { describe, expect, it, vi } from "vitest";
+import { defineModuleRuntime } from "../src/index.js";
+
+describe("defineModuleRuntime", () => {
+  it("defines a frozen server runtime without duplicating the static manifest", async () => {
+    const start = vi.fn();
+    const runtime = defineModuleRuntime({
+      id: "example",
+      start,
+      version: "0.1.0",
+    });
+
+    expect(runtime).toEqual({ id: "example", start, version: "0.1.0" });
+    expect(Object.isFrozen(runtime)).toBe(true);
+  });
+
+  it("rejects invalid runtime definitions", () => {
+    expect(() =>
+      defineModuleRuntime({
+        id: "Not Valid",
+        version: "0.1.0",
+      }),
+    ).toThrow("Invalid Ekklesia module runtime definition.");
+  });
+});

packages/module-sdk/tests/define-module.test.ts

@@ -1,42 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { defineModule } from "../src/index.js";
-
-describe("defineModule", () => {
-  it("returns a validated and normalized public manifest", () => {
-    const module = defineModule({
-      manifestVersion: 1,
-      id: "example",
-      name: "Example",
-      version: "0.1.0",
-      compatibility: {
-        platform: "^0.1.0",
-        moduleSdk: "^0.1.0",
-      },
-      entrypoints: {
-        server: "./src/server/index.ts",
-      },
-    });
-
-    expect(module.capabilities).toEqual([]);
-    expect(module.permissions).toEqual([]);
-    expect(module.storage.buckets).toEqual([]);
-  });
-
-  it("rejects invalid module definitions before runtime registration", () => {
-    expect(() =>
-      defineModule({
-        manifestVersion: 1,
-        id: "Not Valid",
-        name: "Invalid",
-        version: "0.1.0",
-        compatibility: {
-          platform: "^0.1.0",
-          moduleSdk: "^0.1.0",
-        },
-        entrypoints: {
-          server: "./src/server/index.ts",
-        },
-      }),
-    ).toThrow();
-  });
-});