@endora-commerce/platform 0.100.0

package/dist/packages/installed-packages.js

@@ -0,0 +1,312 @@
+// Installed extension packages — the enumeration half (feature 080, T031).
+//
+// This answers one question: which `node_modules` directories does this
+// platform read, and which of the packages in them claim to be Endora modules?
+// Turning those claims into composer entries is `package-runtime.ts`'s job.
+//
+// ## What it can see
+//
+//   - a package installed from a registry or from a tarball, in any layout that
+//     leaves the package inside the `node_modules` tree it was found under:
+//     npm/yarn's hoisted layout (a real directory), and pnpm's isolated layout
+//     (`node_modules/<name>` → `node_modules/.pnpm/<name>@<v>/node_modules/<name>`);
+//   - scoped and unscoped names alike, one level of `@scope/` deep, which is
+//     the whole of npm's namespace shape;
+//   - packages in **every** root {@link nodeModulesRootsFor} returns: the
+//     declared instance root first, then the `node_modules` chain above the
+//     running platform, which is Node's own resolution directory list.
+//
+// ## What it cannot see, deliberately
+//
+//   - **a workspace member.** pnpm links one into `node_modules` from outside,
+//     so `<root>/node_modules/@endora-commerce/contracts` really is `packages/contracts`.
+//     Every such link is refused, and that is the point: this repository's own
+//     five `packages/*` must never be discovered as installed packages, and a
+//     module package that is a workspace member is a fact about *the tree* and
+//     belongs in the committed registry (D-149), not here. The predicate is
+//     where the link **lands** — the same property assertion A8 of D-110
+//     measures on the acceptance instance — and never "is there a symlink",
+//     which would refuse the only layout a real pnpm instance has;
+//   - **a `link:` or `file:` dependency onto a directory**, for the same reason
+//     and by the same rule. An author developing a module against a live
+//     instance has to `pnpm pack` and install the tarball, or point
+//     `ENDORA_INSTANCE_ROOT` at a directory whose `node_modules` holds a real
+//     install;
+//   - **anything nested inside another package's `node_modules`.** Only the top
+//     level of each root is enumerated. A transitive dependency that happens to
+//     carry an `endora` field is not something this instance installed;
+//   - **`.pnpm`, and any other dot-directory.** The store's contents are
+//     reached through the top-level link, so descending would find each package
+//     twice;
+//   - **a package that is installed but whose `package.json` cannot be read or
+//     parsed.** It is reported as `skipped`, never composed and never thrown
+//     at: one unreadable stranger must not stop a shop from booting.
+//
+// ## The containment test is over real paths on both sides, and that is load-bearing
+//
+// A workspace link is **relative** — `backend/node_modules/@endora-commerce/contracts ->
+// ../../../packages/contracts` — so it re-roots with whatever directory it
+// physically sits in. Issue #255 is that fact biting from the other side: a
+// `node_modules` symlinked at another checkout's makes every `@endora-commerce/*` resolve
+// into that checkout, while `pnpm ls` cheerfully reports the local path,
+// because it answers from the manifest's `link:` declaration and never reads
+// the symlink.
+//
+// So the predicate here `realpath`s the **root** as well as the candidate. What
+// it asks is "did this package's install stay inside the directory the roots
+// really are", never "does its path start with the string we were handed" — a
+// prefix test over the declared path would accept a `node_modules` that is
+// itself a link into somebody else's tree. Both wirings of the `@endora-commerce/*` case
+// come out the same and correct: the link lands on `packages/<name>`, which is
+// outside whichever `node_modules` it was reached through, so a workspace
+// member is refused whether the instance's `node_modules` is its own, a copy,
+// or a link at another checkout's.
+//
+// ## Cost
+//
+// One `readdir` per root, one `readdir` per `@scope`, one `lstat` + one
+// `readFile` per candidate. `package-runtime.ts` memoises the result for the
+// process, because an instance's `node_modules` does not change while the
+// platform runs.
+import { existsSync, readFileSync, readdirSync, realpathSync, statSync } from 'node:fs';
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * The environment variable naming the **instance** — the directory whose
+ * `node_modules` holds this platform's installed extension packages.
+ *
+ * Unset is the ordinary case and is not a degraded one: a deployed instance
+ * *is* the directory the platform runs from, so the chain above the running
+ * code already names it. The variable exists for the case where the two are not
+ * the same — a platform executed out of a checkout against an instance built
+ * somewhere else, which is exactly what D-110's acceptance criterion does.
+ */
+export const INSTANCE_ROOT_ENV = 'ENDORA_INSTANCE_ROOT';
+/** `true` when `child` is inside `parent` (and is not `parent` itself). */
+function isUnder(child, parent) {
+    const rel = relative(parent, child);
+    return rel !== '' && !rel.startsWith(`..${sep}`) && rel !== '..' && !isAbsolute(rel);
+}
+/**
+ * Every `node_modules` directory this platform reads, nearest first.
+ *
+ * The declared instance root comes first, then the chain above the running
+ * platform — in an instance, `<instance>/node_modules/@endora-commerce/platform`
+ * upward to the instance root; in this checkout, the platform package's own and
+ * the repository's. The chain is Node's own module-resolution directory list,
+ * which is the honest answer to "where would an installed package be": wherever
+ * `import` would find it. Roots that do not exist are dropped, so an empty
+ * result means *nothing to read* rather than *nothing found*.
+ *
+ * **The chain is derived from this file's own location and therefore moved with
+ * it** (`specs/110-instance-repository/` T113). It read from
+ * `backend/src/packages/` until the relocation, so `backend/node_modules` was on
+ * it and the platform package's was not; it now reads from
+ * `@endora-commerce/platform`, which is where the platform actually runs from in
+ * an instance, and is the reading `ENDORA_INSTANCE_ROOT` exists to override. No
+ * discovery is lost in this checkout: every `@endora-commerce/*` entry under
+ * `backend/node_modules` is a workspace link and is refused as one a few
+ * hundred lines down, which is what `installed-packages.test.ts` asserts either
+ * side of the move.
+ */
+export function nodeModulesRootsFor(env = process.env) {
+    const roots = [];
+    const push = (candidate) => {
+        if (!roots.includes(candidate))
+            roots.push(candidate);
+    };
+    const declared = env[INSTANCE_ROOT_ENV];
+    if (typeof declared === 'string' && declared.trim().length > 0) {
+        push(join(resolve(declared.trim()), 'node_modules'));
+    }
+    let directory = dirname(fileURLToPath(import.meta.url));
+    for (;;) {
+        if (basename(directory) !== 'node_modules')
+            push(join(directory, 'node_modules'));
+        const parent = dirname(directory);
+        if (parent === directory)
+            break;
+        directory = parent;
+    }
+    return roots.filter((root) => {
+        try {
+            return statSync(root).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/**
+ * Read one candidate directory and classify it.
+ *
+ * `null` means "not a candidate at all" — no `package.json`, or one with no
+ * `endora` field. That is the overwhelmingly common case in any `node_modules`
+ * and is deliberately silent: reporting every ordinary dependency as `skipped`
+ * would bury the three answers that matter.
+ */
+function classify(directory, root) {
+    const manifestPath = join(directory, 'package.json');
+    if (!existsSync(manifestPath))
+        return null;
+    let parsed;
+    let raw;
+    try {
+        raw = readFileSync(manifestPath, 'utf8');
+    }
+    catch (error) {
+        return {
+            skipped: {
+                kind: 'unreadable',
+                at: manifestPath,
+                reason: error instanceof Error ? error.message : String(error),
+            },
+        };
+    }
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        return {
+            skipped: {
+                kind: 'unreadable',
+                at: manifestPath,
+                reason: `package.json is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
+            },
+        };
+    }
+    const endora = parsed.endora;
+    if (endora === undefined || endora === null || typeof endora !== 'object')
+        return null;
+    const name = typeof parsed.name === 'string' ? parsed.name : basename(directory);
+    if (endora.type !== 'module') {
+        // A theme, a kit, a distribution meta-package. Reported rather than
+        // silent: it carries the field, so its author meant the platform to see it.
+        return { skipped: { kind: 'not-an-endora-module', name, at: manifestPath } };
+    }
+    if (typeof endora.id !== 'string' || endora.id.trim().length === 0) {
+        return {
+            skipped: {
+                kind: 'unreadable',
+                at: manifestPath,
+                reason: '`endora.type` is "module" but `endora.id` is missing or empty, so the package claims ' +
+                    'no module id. The id is the platform\'s identity for a module (D-142); the npm name ' +
+                    'is not, because an author may rename a package.',
+            },
+        };
+    }
+    // Where the install really landed. See the header: this is the whole of "a
+    // workspace member is not an installed package", and it is a property of the
+    // install rather than a claim the package makes about itself.
+    //
+    // `realpath` on **both** sides, unconditionally. Not "resolve the candidate
+    // if it happens to be a symlink and compare it to the path we were handed":
+    // a `node_modules` that is itself a link — a copied or aliased tree, issue
+    // #255's shape — would then refuse every real directory under it, and a
+    // declared root that is a link into another checkout would be trusted on its
+    // spelling.
+    let realPath;
+    let realRoot;
+    try {
+        realPath = realpathSync(directory);
+        realRoot = realpathSync(root);
+    }
+    catch (error) {
+        return {
+            skipped: {
+                kind: 'unreadable',
+                at: manifestPath,
+                reason: error instanceof Error ? error.message : String(error),
+            },
+        };
+    }
+    if (!isUnder(realPath, realRoot)) {
+        return { skipped: { kind: 'links-out-of-node-modules', name, at: directory, realPath } };
+    }
+    return {
+        package: {
+            id: endora.id.trim(),
+            name,
+            version: typeof parsed.version === 'string' ? parsed.version : '0.0.0',
+            directory,
+            manifestPath,
+            foundUnder: root,
+        },
+    };
+}
+/** Top-level candidate directories in one `node_modules`, `@scope/` expanded. */
+function candidatesIn(root) {
+    const out = [];
+    let entries;
+    try {
+        entries = readdirSync(root);
+    }
+    catch {
+        return out;
+    }
+    for (const name of entries.sort()) {
+        // `.pnpm`, `.bin`, `.modules.yaml` — the store is reached through the
+        // top-level link, so descending finds every package a second time.
+        if (name.startsWith('.'))
+            continue;
+        const full = join(root, name);
+        if (!name.startsWith('@')) {
+            out.push(full);
+            continue;
+        }
+        let scoped;
+        try {
+            scoped = readdirSync(full);
+        }
+        catch {
+            continue;
+        }
+        for (const inner of scoped.sort()) {
+            if (inner.startsWith('.'))
+                continue;
+            out.push(join(full, inner));
+        }
+    }
+    return out;
+}
+/**
+ * Scan the given `node_modules` roots for installed Endora module packages.
+ *
+ * A package found in more than one root is taken from the nearest one — the
+ * same precedence Node's resolver applies, so what the platform composes is
+ * what an `import` of that name in the instance would load.
+ */
+export function scanNodeModulesRoots(roots) {
+    const packages = new Map();
+    const skipped = [];
+    const rootsRead = [];
+    for (const root of roots) {
+        try {
+            if (!statSync(root).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        rootsRead.push(root);
+        for (const directory of candidatesIn(root)) {
+            const verdict = classify(directory, root);
+            if (verdict === null)
+                continue;
+            if ('skipped' in verdict) {
+                skipped.push(verdict.skipped);
+                continue;
+            }
+            // Nearest root wins; a farther copy of the same npm package is shadowed
+            // exactly as it would be for an `import`.
+            if (!packages.has(verdict.package.name))
+                packages.set(verdict.package.name, verdict.package);
+        }
+    }
+    return {
+        packages: [...packages.values()].sort((a, b) => a.name.localeCompare(b.name)),
+        skipped,
+        rootsRead,
+    };
+}
+//# sourceMappingURL=installed-packages.js.map

package/dist/packages/installed-packages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed-packages.js","sourceRoot":"","sources":["../../src/packages/installed-packages.ts"],"names":[],"mappings":"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"}

package/dist/packages/package-entity-lookup.d.ts

@@ -0,0 +1,120 @@
+import type { EntityClass } from '@mikro-orm/core';
+/**
+ * How a **host program** names one entity class out of a module package's
+ * published `entities` array, with the entity's own type (feature 080, T040b —
+ * criterion 7).
+ *
+ * ## The problem this exists for
+ *
+ * A module package publishes `export const entities = [...]` and **no entity
+ * class by name**, type-only exports included (D-168;
+ * `test/unit/packages/module-package-entity-surface.test.ts` is the arbiter, and
+ * `d169PortsFindings` shuts the `./ports` door on the same shape). That is the
+ * ruling's load-bearing half: `import { Megamenu } from
+ * '@endora-commerce/mod-megamenu/backend'` has to fail in a stranger's compiler,
+ * where none of this repository's checks run.
+ *
+ * A host program that has to **construct** one of those entities therefore picks
+ * it out of the array, and a `find` over a heterogeneous array returns the
+ * **union** of its constructors. Measured on `@endora-commerce/mod-returns`
+ * (eleven entities): `em.create(entityNamed(returnsEntities, 'ReturnReason'), …)`
+ * type-checks the payload against `RequiredEntityData<ReturnStatus>` — TypeScript
+ * collapses the union to one constituent and it is not the one asked for. The
+ * failure is silent whenever the two shapes happen to agree, which is the whole
+ * reason this is a mechanism and not a call-site fix.
+ *
+ * The union is precise only for a package publishing **one** entity, which is
+ * why `delivery_methods`, `payment_methods` and `taxes` went through the
+ * inferred form and `megamenu` could not.
+ *
+ * ## The mechanism
+ *
+ * Two halves, and the split is the whole content of this file:
+ *
+ *  * the **runtime class** comes off the package's published `entities` array —
+ *    the one array `entities-registry.generated.ts` hands the ORM, so there is
+ *    exactly one of it in the process (D-160.6, D-160.6.1). Resolution is **by
+ *    name and never by index**: a tuple index compiles for any ordering, so
+ *    re-ordering the array in the package would silently re-point an insert at
+ *    another table;
+ *  * the **type** is supplied by the caller as `T`, from an `import type` of the
+ *    entity's declaration inside the package's **built** artefact. It erases at
+ *    compile time and constructs nothing, so no second copy exists and
+ *    `check:singleton-identity` reads it for what it is (its `valueImportOrigins`
+ *    skips a type-only import outright).
+ *
+ * ## Why the type import names `dist` and not `src`
+ *
+ * `backend/test/helpers/package-entities.ts` does the same split against the
+ * package's **source**, which is legal there and is refused here:
+ * `backend/tsconfig.build.json` sets `rootDir: ./src`, and a `.ts` outside it is
+ * **TS6059 even for an `import type`** — measured, because a type-only import
+ * still joins the program. A `.d.ts` does not: declaration files are exempt from
+ * the `rootDir` check, so the emitted declaration inside the package's own
+ * `dist` is the one spelling a file in this build may name. This file is in that
+ * build: `deploy/README.md` documents running the demo seed as
+ * `node dist/cli.js demo seed`, and D-165 makes the compiled tree the
+ * production path.
+ *
+ * That is not a workaround wearing a rule's clothes. The `.d.ts` inside `dist`
+ * is the declaration of the class the platform actually registered, which is the
+ * identity D-160.6 is about; the source spelling is the one that merely happens
+ * to be structurally identical.
+ *
+ * D-168 is untouched by either: the guarantee is about the **bare specifier** an
+ * installed consumer is limited to, and a package's `exports` map does not gate
+ * a filesystem path — the ruling's own delivery note says so. A stranger has no
+ * such path to write.
+ *
+ * ## What is checked, and where
+ *
+ * A name that is not in the array throws **here**, at module load, naming every
+ * class the array does declare. That is the one failure mode D-160.6 calls
+ * acceptable, precisely because it is loud.
+ *
+ * The remaining hazard is a call that asks for one entity's **type** while
+ * naming another's — both are members of the same package, so no constraint
+ * expressible on `T` can separate them (`EntityClass<T>` is
+ * `Function & { prototype: T }`, and `Function.prototype` is `any`, so the type
+ * argument is an assertion rather than a check). It is closed outside the type
+ * system, by `test/unit/packages/package-entity-lookup.test.ts`: it walks every
+ * host program that calls this, resolves each call's type argument back to its
+ * `import type`, and refuses a specifier whose original name is not the string
+ * literal beside it — and refuses one that is not the **emitted counterpart**,
+ * derived from the package's own `tsconfig.build.json`, of a file in that
+ * package declaring that class. So the `dist/…` path spelled at a call site is a
+ * checked copy of a derived fact rather than a written-down one (D-100).
+ */
+/**
+ * What a published `entities` array holds.
+ *
+ * Deliberately a construct signature and not `unknown`: it refuses an argument
+ * that is not an array of classes at all — the shape a package that lost its
+ * array answers with, since the host reads a missing `entities` export as `[]`
+ * and reports nothing.
+ */
+type PublishedEntityClass = abstract new (...args: never[]) => object;
+/**
+ * The default `T`, whose whole job is to be unsatisfiable.
+ *
+ * Omitting the row type is the pre-repair shape and it has to be a compile
+ * error, not a quieter version of the same defect: with `T` free, it resolves to
+ * its own constraint and `em.create` then checks the payload against `object`,
+ * which accepts everything. That is *worse* than the union collapse this file
+ * exists for — the collapse at least errors when the two shapes disagree.
+ * So the default is a shape no entity has and no payload satisfies: the first
+ * `em.create` against it is TS2353 naming this interface, which is the
+ * instruction. It is a required, plainly-typed property on purpose — a `never`
+ * or a `unique symbol` key is filtered out of MikroORM's `RequiredEntityData`
+ * mapped type and accepts everything, measured both ways.
+ *
+ * The default is the *loud* half. The half a type cannot reach — a call that
+ * asks for one entity's row type while naming another's — belongs to
+ * `test/unit/packages/package-entity-lookup.test.ts`.
+ */
+export interface EntityRowTypeIsRequired {
+    readonly entityNamedNeedsTheRowTypeOfTheClassItIsAskedFor: 'see src/packages/package-entity-lookup.ts';
+}
+export declare function entityNamed<T extends object = EntityRowTypeIsRequired>(published: readonly PublishedEntityClass[], name: string, source?: string): EntityClass<T>;
+export {};
+//# sourceMappingURL=package-entity-lookup.d.ts.map

package/dist/packages/package-entity-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-entity-lookup.d.ts","sourceRoot":"","sources":["../../src/packages/package-entity-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqFG;AAEH;;;;;;;GAOG;AACH,KAAK,oBAAoB,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,MAAM,CAAC;AAEtE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,gDAAgD,EAAE,2CAA2C,CAAC;CACxG;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,uBAAuB,EACpE,SAAS,EAAE,SAAS,oBAAoB,EAAE,EAC1C,IAAI,EAAE,MAAM,EACZ,MAAM,SAAkD,GACvD,WAAW,CAAC,CAAC,CAAC,CAmBhB"}

package/dist/packages/package-entity-lookup.js

@@ -0,0 +1,17 @@
+export function entityNamed(published, name, source = "a module package's published `entities` array") {
+    // The `typeof` test is not redundant with the parameter type: the array comes
+    // out of a package, which at runtime may be an installed one this repository
+    // never compiled, so its members are whatever that package put there.
+    const found = published.find((candidate) => typeof candidate === 'function' && candidate.name === name);
+    if (found === undefined) {
+        const declared = published
+            .map((candidate) => (typeof candidate === 'function' ? candidate.name : String(candidate)))
+            .join(', ');
+        throw new Error(`[package-entities] ${source} publishes no entity class named '${name}' ` +
+            `(it declares: ${declared || '(empty)'}). Either the class was renamed, or it was ` +
+            `left out of the array — which the host answers by mapping it to no table, ` +
+            `silently. See D-168.`);
+    }
+    return found;
+}
+//# sourceMappingURL=package-entity-lookup.js.map

package/dist/packages/package-entity-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-entity-lookup.js","sourceRoot":"","sources":["../../src/packages/package-entity-lookup.ts"],"names":[],"mappings":"AAyHA,MAAM,UAAU,WAAW,CACzB,SAA0C,EAC1C,IAAY,EACZ,MAAM,GAAG,+CAA+C;IAExD,8EAA8E;IAC9E,6EAA6E;IAC7E,sEAAsE;IACtE,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAC1B,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,SAAS,KAAK,UAAU,IAAI,SAAS,CAAC,IAAI,KAAK,IAAI,CAC1E,CAAC;IACF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,SAAS;aACvB,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;aAC1F,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CACb,sBAAsB,MAAM,qCAAqC,IAAI,IAAI;YACvE,iBAAiB,QAAQ,IAAI,SAAS,6CAA6C;YACnF,4EAA4E;YAC5E,sBAAsB,CACzB,CAAC;IACJ,CAAC;IACD,OAAO,KAAkC,CAAC;AAC5C,CAAC"}

package/dist/packages/package-runtime.d.ts

@@ -0,0 +1,177 @@
+import type { MigrationObject } from '@mikro-orm/core';
+import type { ModuleManifest, ModuleManifestExports } from '@endora-commerce/contracts';
+import type { ModuleEntry } from '../kernel/compose.js';
+import { type ModuleIdClaim } from '../lifecycle/services/module-id-claims.js';
+/**
+ * One entry of a migration registry, as this reader produces them.
+ *
+ * **Declared here rather than imported**, for `manifest-registry.ts`'
+ * `DiscoveredManifestEntry` reason one directory over: the merge that turns
+ * these into an execution order is the host's
+ * (`backend/src/db/configured-migrations.ts`, moving under
+ * `specs/110-instance-repository/` T116), and the platform may not name a file
+ * in the tree that installs it (D-52/D-53). `tsc` is what holds the two shapes
+ * together — the host's `MigrationRegistryEntry` is structurally assignable to
+ * this one at the call site, so a field dropped on either side fails in the
+ * host's own type-check rather than at runtime.
+ *
+ * It is *not* a second answer to "what order do migrations run in": that is
+ * `migration-order.ts`' and the platform's `./migrations` subpath's, and this
+ * carries no ordering decision at all — only the three fields a reader of a
+ * package's `./migrations` export can fill in.
+ */
+export interface MigrationRegistryEntry {
+    /** Owning module id — a package's `endora.id` (D-142). */
+    moduleId: string;
+    /** The migration class. `cls.name` IS the migration name persisted in the DB. */
+    cls: MigrationObject['class'];
+    /** Absent means `'core'`; a producer outside the committed registry sets `'external'`. */
+    origin?: 'core' | 'external';
+}
+/** An installed package's manifest plus where on disk it came from. */
+export interface PackageModuleManifest {
+    id: string;
+    manifest: ModuleManifest;
+    /**
+     * The resolved `package.json`.
+     *
+     * `dirname(filePath)` is how the i18n reconciler and the lifecycle
+     * orchestrator locate a module's assets, so this has to be a path *inside*
+     * the package directory. For a core module the anchor is `manifest.ts`; for a
+     * package it is the `package.json` that claimed the id — a file that
+     * genuinely exists in the published artefact, which the compiled root export
+     * (`dist/manifest.js`, whose directory holds no `i18n/`) does not give.
+     */
+    filePath: string;
+    /** The npm package name, for diagnostics. Never the platform's identity. */
+    packageName: string;
+    installHook?: ModuleManifestExports['installHook'];
+    uninstallHook?: ModuleManifestExports['uninstallHook'];
+    /**
+     * This module's interest in every *other* module's install and hard
+     * uninstall — feature 080, T036a / D-159. Read here for the same reason the
+     * two hooks are: the export travels with the manifest, so an overlay module
+     * and an installed package declare one on exactly core's terms.
+     */
+    lifecycleParticipant?: ModuleManifestExports['lifecycleParticipant'];
+    /**
+     * The operator commands this module declares — feature 080, T042b / D-160.9.
+     *
+     * This is the origin the shape was designed for: a file under `node_modules`
+     * can name no specifier that resolves to the instance's
+     * `backend/src/composition.ts`, so a package's CLI can only ever be a
+     * declaration the host invokes. Read here on exactly core's terms.
+     */
+    cliCommands?: ModuleManifestExports['cliCommands'];
+    /**
+     * The module's recent-activity eligibility — feature 080, T042j / D-163.1.
+     *
+     * The declaration axis of D-163.1, and the reason it is a manifest export:
+     * the four host-owned action tables it replaced were closed lists of core
+     * module ids, so a package's audit row was silently absent from the dashboard
+     * card rather than refused. Read here on exactly core's terms.
+     */
+    recentActivity?: ModuleManifestExports['recentActivity'];
+}
+/**
+ * The module-id claims of every installed module package under `roots`.
+ *
+ * Exported so the *overlay* seams can be held to one collision rule over one
+ * claimed set (feature 103, FR-004) without a second enumeration of what is
+ * installed: the scan below is memoised per root list, so asking here costs a
+ * map lookup on a boot that has already asked.
+ */
+export declare function installedPackageModuleIdClaims(roots: readonly string[]): ModuleIdClaim[];
+/**
+ * The manifests of every installed module package, refusing an id two of them
+ * claim.
+ *
+ * A package with no `./backend` export still appears here: an admin- or
+ * storefront-only module has permissions, an activation control and i18n
+ * bundles, and dropping the manifest would take all three with it.
+ */
+export declare function packageModuleManifestsUnder(roots: readonly string[]): Promise<PackageModuleManifest[]>;
+/** {@link packageModuleManifestsUnder} over the roots this platform reads. */
+export declare function discoverPackageModuleManifests(env?: NodeJS.ProcessEnv): Promise<PackageModuleManifest[]>;
+/**
+ * The composer entries of every installed module package, against explicit
+ * roots.
+ *
+ * Exported so the loader can be driven over a fixture instance that enters at
+ * the top of the analysis — a `node_modules` tree on disk, enumerated,
+ * `exports`-resolved and imported by the same code the deployment path runs —
+ * rather than by handing the last function a pre-built entry (issue #130).
+ */
+export declare function packageModuleEntriesUnder(roots: readonly string[]): Promise<ModuleEntry[]>;
+/**
+ * Every installed module package this platform composes.
+ *
+ * Empty for an instance that installed none, which is every developer checkout
+ * and every test run — and empty is the whole story there: the composition is
+ * byte-for-byte what it was before this loader existed.
+ */
+export declare function loadPackageModuleEntries(env?: NodeJS.ProcessEnv): Promise<ModuleEntry[]>;
+/**
+ * An entity class as the ORM configuration takes it.
+ *
+ * Deliberately structural and deliberately weak: the host cannot type-check a
+ * stranger's class against `EntityClass<T>` without importing the stranger, and
+ * MikroORM validates it anyway — something that is not an entity fails metadata
+ * discovery loudly and by name.
+ */
+export type EntityClassLike = new (...args: never[]) => object;
+/** What one installed package contributes to the platform's schema. */
+export interface PackageSchemaContribution {
+    /** The module id it claims (`endora.id`, D-142) — the migrations' `moduleId`. */
+    readonly id: string;
+    /** The npm package name. For humans, and for the template digest's path. */
+    readonly packageName: string;
+    readonly version: string;
+    /**
+     * The directory the `./migrations` subpath resolves into, or `null` when the
+     * package publishes no such subpath.
+     *
+     * The test harness digests the files under it (`test/template-identity.ts`,
+     * D-155.5): a package ships compiled `.js` with no `.ts` source to hash, so
+     * what it contributes to the migration-template identity as *content* is read
+     * from here rather than from any tree this repository owns.
+     */
+    readonly migrationsDirectory: string | null;
+    /** Registry entries, already tagged `origin: 'external'`. */
+    readonly migrations: readonly MigrationRegistryEntry[];
+    /** The entity classes its `./backend` export declares. */
+    readonly entities: readonly EntityClassLike[];
+    /**
+     * The module ids this package's manifest declares it depends on — the edges
+     * its migrations are ordered by (`specs/110-instance-repository/` T141).
+     *
+     * It is read here, beside the migrations, because `configuredMigrationsFrom`
+     * is the one reader and it had no other source: it fell back to `[]` for any
+     * id the **host's** committed manifest index did not carry, and the comment
+     * beside that fallback claimed these were "read from the manifest the package
+     * published" when nothing read them. In this repository the index carries
+     * every module package, so the fallback was unreachable and the claim was
+     * never tested; in an instance the index does not exist, so **every** module
+     * was a graph root and the per-module order (feature 081) degenerated to the
+     * order `orderMigrations` breaks ties in.
+     */
+    readonly dependencies: readonly string[];
+}
+/**
+ * Every installed package's schema contribution, against explicit roots.
+ *
+ * Exported so a test can drive it over a `node_modules` tree on disk — the same
+ * entry point the deployment path takes, enumerated, `exports`-resolved and
+ * imported by the same code — rather than by handing a downstream function a
+ * pre-built entry (issue #130).
+ */
+export declare function packageSchemaContributionsUnder(roots: readonly string[]): Promise<PackageSchemaContribution[]>;
+/**
+ * {@link packageSchemaContributionsUnder} over the roots this platform reads.
+ *
+ * Empty for an instance that installed no module package — every developer
+ * checkout and every test run — and empty means the ORM configuration is what
+ * it was before a package could ship schema at all.
+ */
+export declare function discoverPackageSchema(env?: NodeJS.ProcessEnv): Promise<PackageSchemaContribution[]>;
+//# sourceMappingURL=package-runtime.d.ts.map

package/dist/packages/package-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-runtime.d.ts","sourceRoot":"","sources":["../../src/packages/package-runtime.ts"],"names":[],"mappings":"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"}