feat: standalone module-build readiness for the public @ekklesia packages (ADR 0053)
CI / verify (pull_request) Successful in 1m2s
CI / infrastructure-smoke (pull_request) Successful in 28s
CI / migration-smoke (pull_request) Successful in 1m52s
CI / standalone-module (pull_request) Successful in 26s
CI / image-build (pull_request) Successful in 30s
CI / deploy-smoke (same-origin) (pull_request) Successful in 50s
CI / deploy-smoke (split) (pull_request) Successful in 1m42s

Makes the public module-development package set usable from a module
repository outside the monorepo. Nothing is published.

- Curated @ekklesia/module-sdk: an explicit author API, no contracts
  barrel, no identity/authorization internals, no Drizzle and no legacy
  ModuleDatabase type. defineModuleRuntime returns the SDK's own named
  interfaces so a module's emitted declarations never reach into
  @ekklesia/contracts. defineModuleSchema is gone; createModuleTable and
  defineModuleSchemaMetadata live in @ekklesia/module-database.
- Drizzle: no longer a dependency of module-sdk or contracts. Core keeps
  the legacy Drizzle schema validator (moved to core/src/modules) and
  its legacy runtime support; drizzle-orm is an optional peer only.
- React is a peer (plus devDependency) of @ekklesia/ui; the boundary
  checker allows exactly that consumer-selected peer.
- @ekklesia/typescript-config is publishable; module-ui-host is private.
  Every public package carries "ekklesia.distribution":
  "module-development" and no monorepo-root prepack.
- module-pack reads the Node.js range from the module's own engines.node
  and recognizes Ekklesia packages by name plus that marker, so
  registry-installed packages are incorporated, SDK-compatibility
  checked, and never credited as third-party.
- scripts/pack-public-packages.ts (pnpm packages:pack) rebuilds, packs
  and inspects the nine public tarballs; scripts/test-standalone-module.sh
  (pnpm test:standalone-module, new CI job) installs them into a fixture
  module outside the repository and proves it typechecks, builds,
  packages, and verifies.
- Public-package boundary tests and module-development docs.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
ekklesia
2026-10-08 07:28:54 -05:00
co-authored by Claude Opus 5.5
parent 9426c83109
commit 89d5d0f2da
63 changed files with 2320 additions and 237 deletions
+6
View File
@@ -0,0 +1,6 @@
import { defineModuleSchemaMetadata } from "@ekklesia/module-database";
export default defineModuleSchemaMetadata({
moduleId: "standalone-proof",
tables: [{ name: "standalone_proof_notes", foreignKeys: [] }],
});
+23
View File
@@ -0,0 +1,23 @@
import { sql } from "@ekklesia/module-database";
import { defineModuleRuntime } from "@ekklesia/module-sdk";
/** A Module Database ABI v1 module with no ORM: SQL through the executor Core provides. */
export default defineModuleRuntime({
database: { abi: 1 },
id: "standalone-proof",
version: "0.1.0",
register({ http }) {
http.route({
method: "GET",
path: "/notes",
permission: "standalone-proof.notes.read",
maxBodyBytes: 0,
async handler(_request, { services }) {
const result = await services.database.query(
sql`SELECT id, body FROM standalone_proof_notes ORDER BY id LIMIT ${50}`,
);
return Response.json(result.rows);
},
});
},
});
+23
View File
@@ -0,0 +1,23 @@
import { designTokenVariableName } from "@ekklesia/design-tokens";
import { defineModuleUi } from "@ekklesia/module-ui-sdk";
import { EKKLESIA_UI_STYLESHEET, EmptyState, Panel } from "@ekklesia/ui";
import { createRoot } from "react-dom/client";
const accent = `var(${designTokenVariableName("color.accent")})`;
export default defineModuleUi({
id: "standalone-proof",
version: "0.1.0",
styles: EKKLESIA_UI_STYLESHEET,
mount(container) {
const root = createRoot(container);
root.render(
<Panel title="Notes">
<div style={{ borderColor: accent }}>
<EmptyState title="No notes yet" />
</div>
</Panel>,
);
return () => root.unmount();
},
});