feat: deliver module database ABI by manifest

packages/module-database/tests/architecture.test.ts

@@ -20,10 +20,12 @@ describe("the module-side database architecture", () => {
   });
 
   it("keeps ABI v1 contracts free of ORM imports", async () => {
-    const source = await text("packages/contracts/src/module-database-abi.ts");
-    expect(source).not.toMatch(/(?:import|export).*drizzle-orm/u);
-    expect(source).not.toMatch(/(?:import|export).*kysely/u);
-    expect(source).not.toMatch(/(?:import|export).*\bpg\b/u);
+    for (const file of ["module-database-abi.ts", "module-schema-metadata.ts"]) {
+      const source = await text(`packages/contracts/src/${file}`);
+      expect(source).not.toMatch(/(?:import|export).*drizzle-orm/u);
+      expect(source).not.toMatch(/(?:import|export).*kysely/u);
+      expect(source).not.toMatch(/(?:import|export).*\bpg\b/u);
+    }
   });
 
   it("makes Drizzle an optional ranged peer and keeps raw SQL independent from it", async () => {

packages/module-database/tests/drizzle.test.ts

@@ -8,7 +8,7 @@ import {
   type ModuleDatabaseQueryResult,
   type ModuleDatabaseTransaction,
 } from "@ekklesia/contracts";
-import { and, eq, sql as drizzleSql } from "drizzle-orm";
+import { and, sql as drizzleSql, eq } from "drizzle-orm";
 import {
   bigint,
   customType,
@@ -22,7 +22,11 @@ import {
   timestamp,
 } from "drizzle-orm/pg-core";
 import { describe, expect, expectTypeOf, it } from "vitest";
-import { moduleDrizzle, type ModuleDrizzleDatabase } from "../src/drizzle.js";
+import {
+  type ModuleDrizzleDatabase,
+  moduleDrizzle,
+  moduleDrizzleSchemaMetadata,
+} from "../src/drizzle.js";
 import { findEkklesiaDatabaseError } from "../src/index.js";
 
 const bytea = customType<{ data: Uint8Array; driverData: Uint8Array }>({
@@ -159,6 +163,24 @@ function setup(...outcomes: Outcome[]) {
 }
 
 describe("moduleDrizzle query compilation and ABI mapping", () => {
+  it("derives plain Ekklesia schema metadata with foreign-key targets", () => {
+    const child = pgTable("calendar_children", {
+      id: integer("id").primaryKey(),
+      recordId: integer("record_id").references(() => records.id),
+    });
+
+    const metadata = moduleDrizzleSchemaMetadata("calendar", { records, child });
+
+    expect(metadata).toEqual({
+      moduleId: "calendar",
+      tables: [
+        { name: "calendar_children", foreignKeys: [{ table: "calendar_records" }] },
+        { name: "calendar_records", foreignKeys: [] },
+      ],
+    });
+    expect(JSON.parse(JSON.stringify(metadata))).toEqual(metadata);
+  });
+
   it("compiles a select and decodes its positional result on the module side", async () => {
     const { db, executor } = setup(result([[7, "Launch"]]));
     await expect(