@endora-commerce/test-kit 0.100.0

package/dist/server/compose-test-server.d.ts

@@ -0,0 +1,251 @@
+/**
+ * `composeTestServer` — the host-shaped half of `setupBackendServer`, lifted
+ * (feature 109, T023).
+ *
+ * ## What "host-shaped" means, precisely
+ *
+ * Everything in the harness's composition that is true of **any** Endora
+ * platform and mentions no module: open the ORM, build the container, register
+ * the ORM-derived names, construct the audit writer, the event bus, the command
+ * bus and the two Redis clients, prime the registry cache from the manifests,
+ * compose the settings and sales-channel kernels, run `composeModules` once,
+ * open the contribution window once, install the request-scope hook, run the
+ * boot phase once, build the server, and take all of it down again.
+ *
+ * Everything else — which modules, which schema, which fixtures, which actor a
+ * request carries — is the caller's, and reaches this function either as
+ * {@link PlatformComposition} or as one of the hooks below. The hooks are at
+ * the four points the boot order makes load-bearing (D-45) and nowhere else:
+ * before the modules register, in the contribution window, before the boot
+ * phase, and after the server is ready. A fifth hook would be a fifth place for
+ * two composition roots to drift.
+ *
+ * ## The one ordering rule, and why it is a shape rather than a comment
+ *
+ * `composeModules` runs once and `runBootHooks` runs once, immediately before
+ * the app is built, so a boot hook may resolve anything. A contribution over a
+ * name a module defaults goes in the single slot between them — earlier and the
+ * module's own registration overwrites it, later and a boot hook has already
+ * read the default. That slot is {@link ComposeTestServerOptions.contribute},
+ * and both edges are enforced by the platform rather than remembered: the early
+ * one because `ComposedModules` does not exist until every module has
+ * registered, the late one because `contribute` throws once `runBootHooks` has
+ * started.
+ *
+ * ## What it refuses, and with whose words
+ *
+ * A composition whose `modules` lacks a module declaring
+ * `activation.nonDeactivatable` is refused by `composeModules`, before the
+ * first module registers, with `RequiredModuleAbsentError` — naming the module,
+ * the sentence its own manifest gives and the remedy. This function adds no
+ * second check and catches nothing on that path (R2.4): a stranger composing an
+ * incomplete set has to get the platform's answer, because the kit's would be a
+ * paraphrase that goes stale.
+ *
+ * What it *does* do on that path is give back the two connections and the ORM
+ * it had already opened. That is not a swallow — the refusal is re-thrown
+ * unchanged, and unconditionally — it is the difference between a test that
+ * reports one refusal and a run that reports it once and then dies of a
+ * connection leak.
+ */
+import type { EntityManager, MikroORM } from '@mikro-orm/postgresql';
+import type { FastifyInstance, FastifyRequest } from 'fastify';
+import { Redis } from 'ioredis';
+import { ApiInterceptorRegistry, AuditLogService, buildServer, composeModules, type KernelContainer, type ModulePlugin, type SalesChannelsKernel, type SettingsKernel } from '@endora-commerce/platform/composition';
+import { CommandBus } from '@endora-commerce/platform/commands';
+import { EventBus } from '@endora-commerce/platform/events';
+import type { TenantContext } from '@endora-commerce/platform/tenancy';
+import type { PlatformComposition } from './composition.js';
+/**
+ * `buildServer`'s own options, named through its signature.
+ *
+ * `BuildServerOptions` is on no barrel and this feature widens none (R3.1), so
+ * the type is taken from the function that *is* published rather than by
+ * publishing a second symbol to spell it. It stays correct by construction: a
+ * field added to `buildServer` is a field here in the same compile.
+ */
+type BuildServerOptions = Parameters<typeof buildServer>[0];
+/**
+ * `ComposeModules`' return, named through its signature, for the same reason.
+ */
+type ComposedModules = ReturnType<typeof composeModules>;
+/** What every hook is handed before the modules have registered. */
+export interface TestPlatformContext {
+    readonly orm: MikroORM;
+    /** A fresh tenant-filtered fork per call — the seam production forks through. */
+    readonly em: () => EntityManager;
+    readonly container: KernelContainer;
+    readonly eventBus: EventBus;
+    readonly commandBus: CommandBus;
+    readonly auditLogService: AuditLogService;
+    readonly apiInterceptors: ApiInterceptorRegistry;
+    readonly redis: Redis;
+    readonly redisSubscriber: Redis;
+    readonly settings: SettingsKernel;
+    readonly salesChannels: SalesChannelsKernel;
+}
+/** What every hook is handed once the modules have registered. */
+export interface ComposedPlatformContext extends TestPlatformContext {
+    readonly composed: ComposedModules;
+}
+export interface ComposeTestServerOptions {
+    /** The four things only the caller knows. */
+    readonly composition: PlatformComposition;
+    /**
+     * Host values **no module defaults** — a deployment flag, a base URL, a
+     * substitute transport. Registered before the modules do, where a value comes
+     * into existence, because there is nothing to overwrite and therefore no
+     * contribution window (AGENTS.md § Composition item 8).
+     *
+     * The kit registers the platform's own here too: `redis`, `redisSubscriber`,
+     * `eventBus`, `commandBus`, `auditLogService`, `apiInterceptors`,
+     * `resolvedModuleRegistry` and `processRunsWorkers` (`false`). A caller's entry of the same name wins, and that
+     * is deliberate — the alternative is a caller with no way to substitute a
+     * connection.
+     */
+    readonly values?: Readonly<Record<string, unknown>>;
+    /**
+     * Truncate, seed, reconcile — whatever this caller's schema needs before the
+     * modules register.
+     *
+     * It runs after the ORM is open and the caches are the caller's to drop, and
+     * before `composeModules`, because a module's registration may not observe a
+     * half-seeded database.
+     */
+    readonly prepareDatabase?: (ctx: TestPlatformContext) => Promise<void>;
+    /**
+     * The contribution window (D-45, issue #52) — the one slot where a value a
+     * module defaults may be overwritten.
+     */
+    readonly contribute?: (ctx: ComposedPlatformContext) => void | Promise<void>;
+    /**
+     * Route plugins mounted after every module's own, after the modules' root
+     * plugins, and **before** the request-scope hook.
+     *
+     * This is where a harness's synthetic authentication goes: it registers after
+     * the platform's own auth plugin so its `onRequest` hook runs second and the
+     * synthetic actor wins, through the same decorator — and before the scope
+     * hook, which builds its {@link TenantContext} out of the actor that hook
+     * resolved.
+     */
+    readonly plugins?: readonly ModulePlugin[];
+    /**
+     * Route plugins mounted **after** the request-scope hook.
+     *
+     * The scope sits in the middle of the chain rather than at its end, so there
+     * are two sides to it and a caller needs both. Production's own root has the
+     * same shape: `authModulePlugin`, `tenantContextModulePlugin`, then
+     * `salesChannels.plugin` — and the sales-channel resolver is exactly why the
+     * second slot exists, because it writes the resolved channel into the open
+     * request scope and refuses when there is none.
+     *
+     * Both arrays are read after the contribution window closes, so a caller may
+     * push into either from inside `contribute`, where the value a plugin needs
+     * finally exists.
+     */
+    readonly scopedPlugins?: readonly ModulePlugin[];
+    /**
+     * Establish the ambient `TenantContext` for a request (Principle XI).
+     *
+     * Omitting it is not "no tenancy": the kit installs the platform's own
+     * `registerRequestScopeHook` either way, and the default context is a system
+     * one. There is no path through this function that leaves the hook off,
+     * because a server composed without it is one under which every tenant-scope
+     * test passes for the wrong reason.
+     */
+    readonly buildTenantContext?: (request: FastifyRequest) => Promise<TenantContext>;
+    /**
+     * Runs after every contribution and **before** the boot phase — a manifest
+     * reconcile, a settings write a boot hook will read.
+     */
+    readonly beforeBoot?: (ctx: ComposedPlatformContext) => Promise<void>;
+    /** Runs after `app.ready()`, with the composed platform and the app. */
+    readonly afterReady?: (ctx: ComposedPlatformContext, app: FastifyInstance) => Promise<void>;
+    /**
+     * Whatever this caller wants on `buildServer` — the error envelope, the
+     * OpenAPI metadata, a rate-limit ceiling.
+     *
+     * `modules` and `apiInterceptors` are the kit's and are ignored here: the
+     * first is assembled from the composition plus {@link plugins} plus the
+     * request-scope hook, in that order, and the second is the registry every
+     * module was handed at registration.
+     */
+    readonly server?: Omit<Partial<BuildServerOptions>, 'modules' | 'apiInterceptors'>;
+    /** Defaults to `REDIS_URL`, or `redis://localhost:6379`. */
+    readonly redisUrl?: string;
+    /**
+     * Register the **real** subscriber client rather than an inert one.
+     *
+     * Off by default, because one armed subscription per composition is the leak
+     * this opt-in was measured into existence to stop. A test that exercises the
+     * cross-process invalidation path asks for it.
+     */
+    readonly exercisePubSub?: boolean;
+    /**
+     * The wrapping order this instance declares for a name more than one module
+     * decorates (feature 107, FR-040/FR-041).
+     *
+     * A caller's fact and not the kit's: it is read from the deployment's own
+     * `divergence.ts` in this repository, and from whatever an instance keeps it
+     * in elsewhere. It is forwarded to `composeModules` unchanged and **checked,
+     * never applied** — the composer emits in its own topological order and
+     * drains decorations once; this declaration asserts that the resulting order
+     * was the intended one and `AmbiguousDecorationError` names it when the two
+     * disagree.
+     *
+     * It is an option rather than a fifth `PlatformComposition` member because
+     * `PlatformComposition`'s four members are the things a composition cannot be
+     * built without (R2.1); an instance that declares no ambiguity resolution
+     * composes perfectly well, and every test in this repository's own suite
+     * passes an empty one.
+     */
+    readonly decorationOrder?: Readonly<Record<string, readonly string[]>> | undefined;
+    /**
+     * Which module ids presence reports as enabled.
+     *
+     * Defaults to every module the composition's manifests declare, which is what
+     * a test wants: production loads presence from `module_registrations`, and a
+     * harness that never boots the orchestrator would otherwise 503 every gated
+     * route. An off-state test passes a narrower set.
+     */
+    readonly enabledModuleIds?: readonly string[];
+}
+/**
+ * A composed platform, and everything the kit itself owns in it.
+ *
+ * **It names no module**, which is the property Phase 2 is about: the
+ * application's own handle carries 29 module-specific fields today, and every
+ * one of them is a container resolution its readers can make for themselves.
+ * `container.cradle` is how a caller reaches a module's service from here.
+ */
+export interface TestServerHandle {
+    readonly app: FastifyInstance;
+    readonly orm: MikroORM;
+    readonly em: () => EntityManager;
+    readonly container: KernelContainer;
+    readonly eventBus: EventBus;
+    readonly commandBus: CommandBus;
+    readonly auditLogService: AuditLogService;
+    readonly apiInterceptors: ApiInterceptorRegistry;
+    readonly redis: Redis;
+    readonly redisSubscriber: Redis;
+    /** Whether the real subscriber client was registered — `teardownTestServer` needs it. */
+    readonly pubSubArmed: boolean;
+    readonly settings: SettingsKernel;
+    readonly salesChannels: SalesChannelsKernel;
+    readonly composed: ComposedModules;
+    /** The composition's own closer, kept so teardown needs no second reference. */
+    readonly closeOrm: () => Promise<void>;
+}
+export declare function composeTestServer(options: ComposeTestServerOptions): Promise<TestServerHandle>;
+/**
+ * Take the composed platform down.
+ *
+ * Every step is here rather than in a caller's own teardown for the reason
+ * `check:harness-teardown` refuses a hand-written one: a copy of this sequence
+ * is frozen at the moment it was copied, so it cannot learn about the container
+ * or the second Redis client, and both leak for the length of the run.
+ */
+export declare function teardownTestServer(handle: TestServerHandle): Promise<void>;
+export {};
+//# sourceMappingURL=compose-test-server.d.ts.map

package/dist/server/compose-test-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-test-server.d.ts","sourceRoot":"","sources":["../../src/server/compose-test-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EACL,sBAAsB,EACtB,eAAe,EAGf,WAAW,EACX,cAAc,EAcd,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;;;;;GAOG;AACH,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5D;;GAEG;AACH,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAuBzD,oEAAoE;AACpE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,EAAE,MAAM,aAAa,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;CAC7C;AAED,kEAAkE;AAClE,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAClE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAED,MAAM,WAAW,wBAAwB;IACvC,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACjD;;;;;;;;OAQG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAClF;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,uBAAuB,EAAE,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,SAAS,GAAG,iBAAiB,CAAC,CAAC;IACnF,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;IACnF;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,aAAa,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC;IAChC,yFAAyF;IACzF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,gBAAgB,CAAC,CA6Q3B;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBhF"}

package/dist/server/compose-test-server.js

@@ -0,0 +1,359 @@
+/**
+ * `composeTestServer` — the host-shaped half of `setupBackendServer`, lifted
+ * (feature 109, T023).
+ *
+ * ## What "host-shaped" means, precisely
+ *
+ * Everything in the harness's composition that is true of **any** Endora
+ * platform and mentions no module: open the ORM, build the container, register
+ * the ORM-derived names, construct the audit writer, the event bus, the command
+ * bus and the two Redis clients, prime the registry cache from the manifests,
+ * compose the settings and sales-channel kernels, run `composeModules` once,
+ * open the contribution window once, install the request-scope hook, run the
+ * boot phase once, build the server, and take all of it down again.
+ *
+ * Everything else — which modules, which schema, which fixtures, which actor a
+ * request carries — is the caller's, and reaches this function either as
+ * {@link PlatformComposition} or as one of the hooks below. The hooks are at
+ * the four points the boot order makes load-bearing (D-45) and nowhere else:
+ * before the modules register, in the contribution window, before the boot
+ * phase, and after the server is ready. A fifth hook would be a fifth place for
+ * two composition roots to drift.
+ *
+ * ## The one ordering rule, and why it is a shape rather than a comment
+ *
+ * `composeModules` runs once and `runBootHooks` runs once, immediately before
+ * the app is built, so a boot hook may resolve anything. A contribution over a
+ * name a module defaults goes in the single slot between them — earlier and the
+ * module's own registration overwrites it, later and a boot hook has already
+ * read the default. That slot is {@link ComposeTestServerOptions.contribute},
+ * and both edges are enforced by the platform rather than remembered: the early
+ * one because `ComposedModules` does not exist until every module has
+ * registered, the late one because `contribute` throws once `runBootHooks` has
+ * started.
+ *
+ * ## What it refuses, and with whose words
+ *
+ * A composition whose `modules` lacks a module declaring
+ * `activation.nonDeactivatable` is refused by `composeModules`, before the
+ * first module registers, with `RequiredModuleAbsentError` — naming the module,
+ * the sentence its own manifest gives and the remedy. This function adds no
+ * second check and catches nothing on that path (R2.4): a stranger composing an
+ * incomplete set has to get the platform's answer, because the kit's would be a
+ * paraphrase that goes stale.
+ *
+ * What it *does* do on that path is give back the two connections and the ORM
+ * it had already opened. That is not a swallow — the refusal is re-thrown
+ * unchanged, and unconditionally — it is the difference between a test that
+ * reports one refusal and a run that reports it once and then dies of a
+ * connection leak.
+ */
+import { Redis } from 'ioredis';
+import { ApiInterceptorRegistry, AuditLogService, activationDeclarationsFrom, capabilityRegistryFrom, buildServer, composeModules, composeSalesChannelsKernel, composeSettingsKernel, createRegistrationOwnership, createRootContainer, forkScopedEm, healthRoutePlugin, platformLogger, registerOrm, registerRequestScopeHook, registerValues, registryCache, requiredModulesFrom, systemTenantContext, } from '@endora-commerce/platform/composition';
+import { CommandBus } from '@endora-commerce/platform/commands';
+import { EventBus } from '@endora-commerce/platform/events';
+import { mergeTestSupportRegistrations } from '../support/index.js';
+/**
+ * A subscriber-shaped object that subscribes to nothing.
+ *
+ * Every composition *asks* for a subscriber, because a module that arms an
+ * invalidation channel from `onBoot` resolves one. Production hands it the real
+ * client; a test gets this unless it opted into pub/sub, because a live
+ * subscription per composition is a leak measured in hundreds of megabytes
+ * across a suite — and because a module that never receives an invalidation
+ * still behaves correctly, it just falls back to the cache's TTL.
+ */
+function inertRedisSubscriber() {
+    const inert = {
+        subscribe: async () => 0,
+        on: () => inert,
+        removeAllListeners: () => inert,
+        unsubscribe: async () => 0,
+        disconnect: () => undefined,
+    };
+    return inert;
+}
+export async function composeTestServer(options) {
+    const { composition } = options;
+    const manifests = composition.manifests.map((entry) => entry.manifest);
+    const orm = await composition.orm.open();
+    // Mirror the production seam: forks stamp the tenant filter from the ambient
+    // `TenantContext`, which the request-scope hook below establishes.
+    const em = () => forkScopedEm(orm);
+    const redisUrl = options.redisUrl ?? process.env['REDIS_URL'] ?? 'redis://localhost:6379';
+    const redis = new Redis(redisUrl, { maxRetriesPerRequest: null, lazyConnect: false });
+    // ioredis puts a subscribed client into a mode where it will not accept
+    // ordinary commands, so production keeps subscriptions on a second
+    // connection. A harness with one client cannot exercise that path at all, and
+    // the pub/sub channel is the platform's only cross-process invalidation
+    // mechanism — the EventBus is in-process and the caches converge by TTL.
+    //
+    // **Opened only when it is armed** (issue #199). It used to be opened on
+    // every composition while reaching `teardownTestServer` only through
+    // `pubSubArmed`, so an unarmed composition — which is nearly every
+    // composition in the suite — left a connected ioredis client behind that
+    // nothing ever closed. Measured over twelve compose/teardown cycles in one
+    // process: `process.getActiveResourcesInfo()` reported one more
+    // `TCPSocketWrap` after each, twelve in all, and none after this change.
+    // (That call is not the general instrument — it excludes an `unref`ed timer,
+    // which is how the companion leak stayed invisible — but a socket is not
+    // `unref`ed and it does show one.)
+    //
+    // An open socket is a libuv handle and therefore a GC root. That is why it is
+    // worth repairing, and it is also the honest limit of the claim: measured on
+    // a full `test:backend` shard, this one is **not** where the heap went —
+    // `ksef`'s undisposed reconcile sweep was, and a run with that repaired and
+    // this left alone reads the same live set to 0.8 MB. What this costs is one
+    // ioredis client and one connection per composition, which a developer's
+    // long-lived local Redis notices long before the heap does.
+    // `heap-ceiling.test.ts` now refuses a `TCPWRAP` that survives a cycle.
+    //
+    // Not opening it is the repair rather than closing it, because a composition
+    // that never subscribes has no use for the connection: a resource that is
+    // never created cannot be left behind by any path, including the ones that
+    // throw before they reach a disconnect.
+    const pubSubArmed = options.exercisePubSub === true;
+    const realSubscriber = pubSubArmed
+        ? new Redis(redisUrl, { maxRetriesPerRequest: null, lazyConnect: false })
+        : undefined;
+    const redisSubscriber = realSubscriber ?? inertRedisSubscriber();
+    // Everything from here is disposable, and a failure between here and the
+    // handle has to give it back. The re-throw is unconditional: this catch
+    // releases resources and decides nothing.
+    const release = async () => {
+        redis.disconnect();
+        realSubscriber?.disconnect();
+        await composition.orm.close();
+    };
+    try {
+        const container = createRootContainer();
+        registerOrm(container, orm);
+        const registrationOwnership = createRegistrationOwnership();
+        const apiInterceptors = new ApiInterceptorRegistry({
+            isModuleEnabled: (moduleId) => registryCache.isEnabled(moduleId),
+        });
+        const auditLogService = new AuditLogService(em);
+        const eventBus = new EventBus();
+        const commandBus = new CommandBus(orm, auditLogService, eventBus);
+        const salesChannels = composeSalesChannelsKernel({
+            emFactory: em,
+            eventBus,
+            redis,
+            auditLogService,
+        });
+        const settings = composeSettingsKernel({
+            emFactory: em,
+            redis,
+            ...(process.env['SETTINGS_SECRET_ENCRYPTION_KEY']
+                ? { secretEncryptionKey: process.env['SETTINGS_SECRET_ENCRYPTION_KEY'] }
+                : {}),
+        });
+        const platform = {
+            orm,
+            em,
+            container,
+            eventBus,
+            commandBus,
+            auditLogService,
+            apiInterceptors,
+            redis,
+            redisSubscriber,
+            settings,
+            salesChannels,
+        };
+        await options.prepareDatabase?.(platform);
+        // Presence is seeded **before** the modules compose, not after: the enabled
+        // set is a precondition for every gated resolution, and a converted
+        // module's port is resolved as soon as something asks for it. While no
+        // module provided a port the late seeding was invisible; the first one that
+        // did turned it into `Module 'auth' is currently disabled` on a platform
+        // where nothing was disabled.
+        registryCache.setActivationDeclarations(activationDeclarationsFrom(manifests));
+        // Feature 132 — the derived capability families, from the same manifest list
+        // and at the same point the production root installs them
+        // (`loadModulePresence`). A harness that seeded presence but not the families
+        // would answer an empty family for every key, so a family owner's exclusion
+        // interceptor would be registered over nobody and every test of it would be
+        // green over a population it never had.
+        registryCache.setCapabilityDeclarations(capabilityRegistryFrom(manifests));
+        registryCache.__setEnabledForTesting([
+            ...(options.enabledModuleIds ?? manifests.map((manifest) => manifest.id)),
+        ]);
+        // The host values this root owns outright. No module registers a default
+        // for any of them, so they have no contribution window and are registered
+        // where the value comes into existence.
+        registerValues(container, {
+            redis,
+            redisSubscriber,
+            eventBus,
+            commandBus,
+            auditLogService,
+            apiInterceptors,
+            resolvedModuleRegistry: composition.manifests,
+            // Whether this process runs queue consumers — the platform's one
+            // module-agnostic switch (`specs/134-paid-module-extraction/` research
+            // D16). A harness runs none: every test process shares the queues.
+            processRunsWorkers: false,
+            ...options.values,
+        });
+        const composed = composeModules(composition.modules, {
+            container,
+            eventBus,
+            log: platformLogger(),
+            interceptorRegistry: apiInterceptors,
+            ownership: registrationOwnership,
+            // Issue #258 — derived from the same manifest set presence was seeded
+            // from, so a caller that withdraws a required module meets the refusal
+            // production would meet, at the point production meets it.
+            requiredModules: requiredModulesFrom(manifests),
+            // Feature 107 — the caller's declaration, forwarded unchanged. A root
+            // that resolves an ambiguity in production and not in its tests composes
+            // a different platform on the one axis a deployment can change.
+            decorationOrder: options.decorationOrder,
+        });
+        const composedContext = { ...platform, composed };
+        const buildTenantContext = options.buildTenantContext ??
+            (async (request) => systemTenantContext(`test-kit:${request.method} ${request.url}`));
+        // The sub-kernel names this composer composed the sub-kernels **for**,
+        // mirroring `compose-app.ts`' own contribution block.
+        //
+        // **They belong to the composer and not to the caller**, and the reason is
+        // measured rather than tidy: this function composes the sales-channel kernel
+        // itself — it has to, the subscriber ordering depends on it happening above
+        // `composeModules` — so a caller could only re-derive from a `salesChannels`
+        // it did not build. It did not, and the four names were absent from every
+        // container the kit composed: `inventory`'s channel-scoped stock read,
+        // `payment_methods`' and `delivery_methods`' auto-bind and every
+        // channel-bridge declaration each failed with `AwilixResolutionError` on
+        // their first call, in a composition that had booted cleanly.
+        //
+        // It stayed invisible in this repository because its reference harness
+        // registers all four itself under a comment reading *"mirrors
+        // `compose-app.ts`"* — the one caller that would have noticed had already
+        // worked around it. An out-of-tree host found them one failed boot at a
+        // time. `registerValues` overwrites, and the harness contributes identical
+        // values, so that workaround stays correct while it is being removed.
+        //
+        // First, so a caller that genuinely wants a different answer for one of them
+        // can still say so in `options.contribute` — the ordering `compose-app.ts`
+        // gives its own twenty for the same reason.
+        composed.contribute({
+            salesChannelsCache: salesChannels.cache,
+            salesChannelBridgeRegistry: salesChannels.bridgeRegistry,
+            salesChannelMembershipPort: salesChannels.membershipService,
+            salesChannelResolutionPort: salesChannels.resolver,
+            // The channel a **channel-scoped** settings read resolves against outside
+            // a request — worker, boot hook, CLI. D-48: the resolver cannot fail to
+            // find a default, so this cannot answer "none"; the return type keeps
+            // `null` because the *seam* still admits one.
+            settingsChannelResolver: async () => (await salesChannels.resolver.getSystemDefault()).id,
+        });
+        // The module test-support substitutions, then the caller's own: a test that
+        // wants a different stub than its module's default says so at its own call
+        // site, which is where the coupling is visible.
+        const supportRegistrations = mergeTestSupportRegistrations(composition.testSupport ?? []);
+        if (Object.keys(supportRegistrations).length > 0)
+            composed.contribute(supportRegistrations);
+        await options.contribute?.(composedContext);
+        await options.beforeBoot?.(composedContext);
+        // Assembled here rather than above the contribution window, and that is a
+        // guarantee rather than a placement: a caller adds to `options.plugins` or
+        // `options.scopedPlugins` from inside `contribute`, where the value a plugin
+        // needs finally exists. The reference application's harness pushes the
+        // sales-channel plugin and a test's `extraModules` exactly there.
+        const modules = [
+            // D-229 — the platform's liveness and readiness probe, in the position
+            // `composeApp` keeps it in. Not a module any more, and not a copy: the
+            // factory is the platform's, so the route this harness serves is the one
+            // production serves. `health_checks` existed in production and nowhere
+            // else for years because this root and that one wired it separately.
+            healthRoutePlugin({ orm, redis }),
+            // Every module's route contribution, in the composer's order, ahead of
+            // the root plugins for the same reason production keeps them there.
+            ...composed.sink.plugins,
+            async (app) => {
+                for (const plugin of composed.sink.rootPlugins)
+                    await plugin(app);
+            },
+            ...(options.plugins ?? []),
+            async (app) => {
+                // Principle XI. The same hook factory the production composition root
+                // uses — two hand-written copies is how the request seam gets a leak
+                // that no test can see, and a composition without it is one under which
+                // every tenant-scope assertion passes for the wrong reason.
+                await registerRequestScopeHook(app, { buildTenantContext });
+            },
+            ...(options.scopedPlugins ?? []),
+        ];
+        // The explicit boot phase, run **once**, after every registration and every
+        // contribution and immediately before the app is built — exactly where a
+        // production composition root runs it (D-45). A boot hook may therefore
+        // resolve anything. It is also what closes the contribution window.
+        await composed.runBootHooks();
+        const app = await buildServer({
+            sessionCookieSecret: 'test-secret-do-not-use-in-production',
+            openApi: { title: 'Endora Commerce API (test)', version: 'test', serverUrl: 'http://localhost' },
+            disableRateLimit: true,
+            ...options.server,
+            modules,
+            apiInterceptors,
+        });
+        await app.ready();
+        await options.afterReady?.(composedContext, app);
+        return {
+            app,
+            orm,
+            em,
+            container,
+            eventBus,
+            commandBus,
+            auditLogService,
+            apiInterceptors,
+            redis,
+            redisSubscriber,
+            pubSubArmed,
+            settings,
+            salesChannels,
+            composed,
+            closeOrm: () => composition.orm.close(),
+        };
+    }
+    catch (error) {
+        await release();
+        throw error;
+    }
+}
+/**
+ * Take the composed platform down.
+ *
+ * Every step is here rather than in a caller's own teardown for the reason
+ * `check:harness-teardown` refuses a hand-written one: a copy of this sequence
+ * is frozen at the moment it was copied, so it cannot learn about the container
+ * or the second Redis client, and both leak for the length of the run.
+ */
+export async function teardownTestServer(handle) {
+    await handle.app.close();
+    // Runs every registration's disposer and drops the resolution cache, so a
+    // file's composed services do not outlive its server.
+    await handle.container.dispose();
+    handle.redis.disconnect();
+    // Unsubscribe and drop listeners **before** disconnecting. A subscribed
+    // client that is merely disconnected keeps its subscription set, and ioredis
+    // re-establishes it on any reconnect.
+    handle.redisSubscriber.removeAllListeners('message');
+    // Only when something actually subscribed: `unsubscribe()` on a client that
+    // never entered subscriber mode rejects asynchronously from ioredis's socket
+    // close handler — a rejection no `try` around this call can catch, which
+    // surfaces as an unhandled rejection failing otherwise-green runs.
+    if (handle.pubSubArmed) {
+        try {
+            await handle.redisSubscriber.unsubscribe();
+        }
+        catch {
+            // Already closed — nothing left to unsubscribe from.
+        }
+    }
+    handle.redisSubscriber.disconnect();
+    await handle.closeOrm();
+}
+//# sourceMappingURL=compose-test-server.js.map

package/dist/server/compose-test-server.js.map

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