@endora-commerce/mod-megamenu 0.100.0

package/dist/backend/index.d.ts

@@ -0,0 +1,116 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { Redis } from 'ioredis';
+import type { AssetReferenceRegistryPort, CmsExternalReferenceScanner, DictionaryValidator } from '@endora-commerce/contracts';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+import { MegamenuCache, type MegamenuCacheOptions } from './services/megamenu-cache.js';
+import { MegamenuReferenceRegistry } from './services/megamenu-reference-registry.js';
+import { MegamenuService } from './services/megamenu-service.js';
+import { MegamenuItemService } from './services/megamenu-item-service.js';
+import { StorefrontResolver } from './services/storefront-resolver.js';
+import { MegamenuBinding } from './entities/megamenu-binding.entity.js';
+import { MegamenuItem } from './entities/megamenu-item.entity.js';
+import { Megamenu } from './entities/megamenu.entity.js';
+/**
+ * `megamenu` — the module reads its own cross-module targets
+ * (`specs/110-instance-repository/` T118c).
+ *
+ * Until T118c this block said the opposite, and said it firmly: two dependency
+ * bundles stayed in the composition roots because both were raw SQL against
+ * `categories`, `cms_pages`, `cms_blocks` and `assets`, and moving *that* into
+ * the module would have given it direct reads of three other modules' storage.
+ * The reasoning was right and the conclusion had an expiry date the block wrote
+ * down itself: *"it belongs to whichever of `catalog`, `cms` and
+ * `assets_library` grows the existence-check port first."* All three have.
+ * `catalogCategoryReadPort`, `cmsPageReadPort` and `assetReadPort` came out of
+ * `specs/075-cross-module-decoupling-sweep/` Phase C, and `cmsBlockReadPort` is
+ * this merge request's — the one port the drain still needed and the reason
+ * T118c's row picks this target.
+ *
+ * So the eight closures are gone from both roots and their two interfaces with
+ * them. What replaces them is `MegamenuCrossModulePorts`: five published ports,
+ * resolved per call by `lazyPort`, with the four judgements that used to sit
+ * inside the closures — a storefront URL's shape, which category counts as live,
+ * which asset kinds a menu may embed, what an absent language means — in
+ * `services/cross-module-ports.ts`, where they have a test.
+ *
+ * **What the roots were getting wrong, which is the argument for the drain
+ * rather than a bonus.** A root's contribution is nobody's declared dependency,
+ * so none of these edges appeared in a manifest: an operator switching `cms` off
+ * was told nothing about the menu embeds that stop. And the two roots did not
+ * agree — production dropped a deactivated or soft-deleted category from the
+ * menu where the harness kept it, and production built `/c/<slug>` where the
+ * harness built `/catalog/<slug>`, which the storefront serves from nowhere. No
+ * test in the tree read either value, so both divergences were invisible.
+ *
+ * `requireAdmin` stops being optional — `routes.admin.ts` defaulted an absent
+ * gate to `?? (async () => {})`, the permissive form, which both roots happened
+ * to pass.
+ *
+ * `megamenuCacheOptions` is a contribution point that **neither** composition
+ * currently overrides, and that is deliberate rather than an oversight. Unlike
+ * `seo`'s sitemap options, the harness wants this module's cache *on*:
+ * `test/integration/megamenu/storefront-cache.test.ts` exists to prove the
+ * payload is cached and dropped on write, so a zero TTL there would make the
+ * suite assert nothing. The seam stays for a deployment that wants to tune the
+ * TTL; the default is the behaviour both compositions actually want.
+ */
+interface MegamenuServices {
+    readonly menuService: MegamenuService;
+    readonly itemService: MegamenuItemService;
+    readonly storefrontResolver: StorefrontResolver;
+    readonly cache: MegamenuCache | undefined;
+}
+export interface MegamenuCradle {
+    readonly emFactory: () => EntityManager;
+    readonly redis: Redis | undefined;
+    readonly requireAdmin: RequireAdminFactory;
+    readonly dictionaryValidator: DictionaryValidator;
+    /** Composition-specific cache tuning; `{}` in production. */
+    readonly megamenuCacheOptions: MegamenuCacheOptions;
+    /**
+     * Owned by `assets_library`: the registry that refuses to delete an asset a
+     * menu item points at, whether as the item's target or as its icon. Named by
+     * its published contract since Phase C, not by that module's class.
+     */
+    readonly assetReferenceRegistry: AssetReferenceRegistryPort;
+    /**
+     * Owned by `cms`: the registry that refuses to delete a page or a block a
+     * menu item links to. This module contributes the scanner; `cms` calls it.
+     */
+    readonly cmsReferenceRegistry: {
+        register: (scanner: CmsExternalReferenceScanner) => void;
+    };
+    readonly megamenuServices: MegamenuServices;
+    readonly megamenuReferenceRegistry: MegamenuReferenceRegistry;
+}
+export declare function registerModule(ctx: ModuleContext): void;
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table->owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ *
+ * The order is the one `db/entities-registry.generated.ts` declared before this
+ * module became a package, so the registered set is the same list in the same
+ * sequence.
+ */
+export declare const entities: (typeof MegamenuBinding | typeof MegamenuItem | typeof Megamenu)[];
+export {};
+/**
+ * **Nothing is published for a composition root any more**
+ * (`specs/110-instance-repository/` T118c).
+ *
+ * `TargetValidatorDeps` and `StorefrontDeps` were exported here so
+ * `backend/src/composition.ts` and `backend/test/helpers/test-server.ts` could
+ * write objects that `satisfies` them. Both roots have stopped, both interfaces
+ * are deleted rather than relocated, and this module's outward reach is
+ * `MegamenuCrossModulePorts` — module-private, and a bundle of five published
+ * ports with no closure in it, so there is nothing left for a root to build.
+ */
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAEV,0BAA0B,EAI1B,2BAA2B,EAE3B,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAMvE,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,UAAU,gBAAgB;IACxB,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,aAAa,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAClD,6DAA6D;IAC7D,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,sBAAsB,EAAE,0BAA0B,CAAC;IAC5D;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,EAAE;QAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAA;KAAE,CAAC;IAC5F,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,yBAAyB,EAAE,yBAAyB,CAAC;CAC/D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAmHvD;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,oEAIpB,CAAC;;AAEF;;;;;;;;;;GAUG"}

package/dist/backend/index.js

@@ -0,0 +1,147 @@
+import { lazyPort } from '@endora-commerce/platform/kernel';
+import { MegamenuCache } from './services/megamenu-cache.js';
+import { MegamenuReferenceRegistry } from './services/megamenu-reference-registry.js';
+import { MegamenuService } from './services/megamenu-service.js';
+import { MegamenuItemService } from './services/megamenu-item-service.js';
+import { StorefrontResolver } from './services/storefront-resolver.js';
+import { registerMegamenuAdminRoutes } from './routes.admin.js';
+import { registerMegamenuStorefrontRoutes } from './routes.storefront.js';
+import { registerMegamenuAssetReferences } from './services/asset-references.js';
+import { registerMegamenuCmsReferences } from './services/cms-references.js';
+import { registerMegamenuLanguageReferences } from './services/megamenu-language-reference.js';
+import { MegamenuBinding } from './entities/megamenu-binding.entity.js';
+import { MegamenuItem } from './entities/megamenu-item.entity.js';
+import { Megamenu } from './entities/megamenu.entity.js';
+export function registerModule(ctx) {
+    ctx.di.register({
+        megamenuCacheOptions: ctx.asFunction(() => ({})).singleton(),
+        megamenuServices: ctx
+            .asFunction(({ emFactory, redis, megamenuCacheOptions }) => {
+            const cache = redis ? new MegamenuCache(redis, megamenuCacheOptions) : undefined;
+            const menuService = new MegamenuService(emFactory, cache, lazyPort(ctx, 'dictionaryValidator'));
+            /**
+             * The five published ports this module reads outside itself
+             * (`specs/110-instance-repository/` T118c). Every one is a `lazyPort`
+             * proxy that resolves on the call rather than here, so nothing
+             * captures a gated registration — a captured gate keeps answering
+             * after its owner is switched off.
+             *
+             * Two of them are `assets_library`'s, because neither answers the
+             * whole question: `AssetRecord` carries the stored `kind` and no
+             * resolved URL, `AssetDetail` carries the URL and no `kind`, and
+             * `resolveUrl` is published on no port (D-223).
+             */
+            const ports = {
+                categories: lazyPort(ctx, 'catalogCategoryReadPort'),
+                pages: lazyPort(ctx, 'cmsPageReadPort'),
+                blocks: lazyPort(ctx, 'cmsBlockReadPort'),
+                assets: lazyPort(ctx, 'assetReadPort'),
+                assetLibrary: lazyPort(ctx, 'assetsLibraryPort'),
+            };
+            return {
+                menuService,
+                cache,
+                itemService: new MegamenuItemService(emFactory, menuService, ports, cache),
+                storefrontResolver: new StorefrontResolver(emFactory, ports, cache),
+            };
+        })
+            .singleton(),
+    });
+    /**
+     * The lookup behind this module's own CMS scanner, deliberately **ungated**
+     * (feature 072, D-39).
+     *
+     * It was a `providePort`, and the only thing that resolves it is this
+     * module's own boot hook, twenty lines down — so switching `megamenu` off
+     * made `megamenu` throw `MODULE_DISABLED` at its own registration and the
+     * backend stopped starting. The gate protected nothing: the sole consumer is
+     * the module the gate was about.
+     *
+     * It stays ungated rather than merely moving: what it feeds is a scanner
+     * `cms` walks on delete, and `cms` honours that edge while `megamenu` is off
+     * on purpose — the menu items still hold the reference. A gate here would be
+     * a second, contradictory answer to a question `cms` has already answered.
+     */
+    ctx.di.register({
+        megamenuReferenceRegistry: ctx
+            .asFunction(({ emFactory }) => new MegamenuReferenceRegistry(emFactory))
+            .singleton(),
+    });
+    /**
+     * The two reference edges this module holds against other modules' entities
+     * (T143a): an asset a menu item targets or uses as an icon, and a CMS page or
+     * block a menu item links to. Both refuse the upstream delete with a 409 that
+     * names the menu.
+     *
+     * Both roots used to cross-register these, which had the failure this cluster
+     * exists to remove: a root's push survives `megamenu` being switched off, so
+     * an operator who had disabled the module still could not delete a page a
+     * megamenu item referenced, and the 409 named a menu the platform was no
+     * longer serving.
+     *
+     * `ctx.onBoot` rather than a registration: both registries are *read* by
+     * their owners on delete, and a registration declares without resolving.
+     */
+    ctx.onBoot(() => {
+        const { assetReferenceRegistry, cmsReferenceRegistry, megamenuReferenceRegistry, emFactory } = ctx.cradle();
+        registerMegamenuAssetReferences(assetReferenceRegistry, emFactory);
+        registerMegamenuCmsReferences(cmsReferenceRegistry, megamenuReferenceRegistry);
+    });
+    ctx.routes(async (app) => {
+        const { megamenuServices, requireAdmin } = ctx.cradle();
+        await registerMegamenuAdminRoutes(app, {
+            menuService: megamenuServices.menuService,
+            itemService: megamenuServices.itemService,
+            requireAdmin,
+        });
+        await registerMegamenuStorefrontRoutes(app, {
+            storefrontResolver: megamenuServices.storefrontResolver,
+        });
+    });
+    /**
+     * This module's rows carry a language code, so it answers "who still points at
+     * this language?" about its own tables (feature 077, D-87), where the owner used
+     * to count them with SQL naming this module's tables.
+     *
+     * A **contribution** hook: it pushes an inert descriptor into `languageReferenceRegistry`,
+     * an ungated registry, and carries no presence probe (D-62/D-68). Probing
+     * would be wrong in the dangerous direction — a switched-off module still owns
+     * the rows, so its language must still refuse the delete, which is the
+     * enumeration policy the registry states.
+     */
+    ctx.onBoot(() => {
+        registerMegamenuLanguageReferences(lazyPort(ctx, 'languageReferenceRegistry'), ctx.cradle().emFactory);
+    });
+}
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table->owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ *
+ * The order is the one `db/entities-registry.generated.ts` declared before this
+ * module became a package, so the registered set is the same list in the same
+ * sequence.
+ */
+export const entities = [
+    MegamenuBinding,
+    MegamenuItem,
+    Megamenu,
+];
+/**
+ * **Nothing is published for a composition root any more**
+ * (`specs/110-instance-repository/` T118c).
+ *
+ * `TargetValidatorDeps` and `StorefrontDeps` were exported here so
+ * `backend/src/composition.ts` and `backend/test/helpers/test-server.ts` could
+ * write objects that `satisfies` them. Both roots have stopped, both interfaces
+ * are deleted rather than relocated, and this module's outward reach is
+ * `MegamenuCrossModulePorts` — module-private, and a bundle of five published
+ * ports with no closure in it, so there is nothing left for a root to build.
+ */
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

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

package/dist/backend/routes.admin.d.ts

@@ -0,0 +1,10 @@
+import type { FastifyInstance } from 'fastify';
+import type { MegamenuService } from './services/megamenu-service.js';
+import type { MegamenuItemService } from './services/megamenu-item-service.js';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+export declare function registerMegamenuAdminRoutes(app: FastifyInstance, deps: {
+    menuService: MegamenuService;
+    itemService: MegamenuItemService;
+    requireAdmin: RequireAdminFactory;
+}): Promise<void>;
+//# sourceMappingURL=routes.admin.d.ts.map

package/dist/backend/routes.admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.admin.d.ts","sourceRoot":"","sources":["../../src/backend/routes.admin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAQ/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE;IACJ,WAAW,EAAE,eAAe,CAAC;IAC7B,WAAW,EAAE,mBAAmB,CAAC;IACjC,YAAY,EAAE,mBAAmB,CAAC;CACnC,GACA,OAAO,CAAC,IAAI,CAAC,CAoHf"}

package/dist/backend/routes.admin.js

@@ -0,0 +1,50 @@
+import { activateBindingRequestSchema, addBindingRequestSchema, createMegamenuRequestSchema, patchMegamenuRequestSchema, putItemsRequestSchema, } from '@endora-commerce/contracts';
+export async function registerMegamenuAdminRoutes(app, deps) {
+    const requireRead = deps.requireAdmin('megamenu.read');
+    const requireWrite = deps.requireAdmin('megamenu.write');
+    app.get('/api/v1/admin/megamenu/menus', { preHandler: requireRead }, async () => deps.menuService.list());
+    app.post('/api/v1/admin/megamenu/menus', { preHandler: requireWrite }, async (request, reply) => {
+        const body = createMegamenuRequestSchema.parse(request.body);
+        const created = await deps.menuService.create(body);
+        return reply.code(201).send({ data: created });
+    });
+    app.get('/api/v1/admin/megamenu/menus/:id', { preHandler: requireRead }, async (request) => ({ data: await deps.menuService.get(request.params.id) }));
+    app.patch('/api/v1/admin/megamenu/menus/:id', { preHandler: requireWrite }, async (request) => {
+        const body = patchMegamenuRequestSchema.parse(request.body);
+        return { data: await deps.menuService.patch(request.params.id, body) };
+    });
+    app.delete('/api/v1/admin/megamenu/menus/:id', { preHandler: requireWrite }, async (request, reply) => {
+        await deps.menuService.delete(request.params.id);
+        return reply.code(204).send();
+    });
+    app.put('/api/v1/admin/megamenu/menus/:id/items', { preHandler: requireWrite }, async (request) => {
+        const body = putItemsRequestSchema.parse(request.body);
+        const result = await deps.itemService.setTree(request.params.id, body);
+        return {
+            data: result.detail,
+            ...(result.warnings.length > 0 ? { meta: { warnings: result.warnings } } : {}),
+        };
+    });
+    // ── Bindings ──────────────────────────────────────────────────────
+    app.get('/api/v1/admin/megamenu/menus/:id/bindings', { preHandler: requireRead }, async (request) => ({ data: await deps.menuService.listBindings(request.params.id) }));
+    app.post('/api/v1/admin/megamenu/menus/:id/bindings', { preHandler: requireWrite }, async (request, reply) => {
+        const body = addBindingRequestSchema.parse(request.body);
+        const created = await deps.menuService.addBinding(request.params.id, body.salesChannelId, body.language);
+        return reply.code(201).send({ data: created });
+    });
+    app.delete('/api/v1/admin/megamenu/menus/:id/bindings/:salesChannelId/:language', { preHandler: requireWrite }, async (request, reply) => {
+        await deps.menuService.removeBinding(request.params.id, request.params.salesChannelId, request.params.language);
+        return reply.code(204).send();
+    });
+    app.post('/api/v1/admin/megamenu/menus/:id/activate', { preHandler: requireWrite }, async (request) => {
+        const body = activateBindingRequestSchema.parse(request.body);
+        const result = await deps.menuService.activate(request.params.id, body.salesChannelId, body.language);
+        return { data: result };
+    });
+    app.post('/api/v1/admin/megamenu/menus/:id/deactivate', { preHandler: requireWrite }, async (request, reply) => {
+        const body = activateBindingRequestSchema.parse(request.body);
+        await deps.menuService.deactivate(request.params.id, body.salesChannelId, body.language);
+        return reply.code(200).send({ data: { deactivated: body } });
+    });
+}
+//# sourceMappingURL=routes.admin.js.map

package/dist/backend/routes.admin.js.map

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

package/dist/backend/routes.storefront.d.ts

@@ -0,0 +1,6 @@
+import type { FastifyInstance } from 'fastify';
+import type { StorefrontResolver } from './services/storefront-resolver.js';
+export declare function registerMegamenuStorefrontRoutes(app: FastifyInstance, deps: {
+    storefrontResolver: StorefrontResolver;
+}): Promise<void>;
+//# sourceMappingURL=routes.storefront.d.ts.map

package/dist/backend/routes.storefront.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.storefront.d.ts","sourceRoot":"","sources":["../../src/backend/routes.storefront.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,SAAS,CAAC;AAI/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAE5E,wBAAsB,gCAAgC,CACpD,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE;IAAE,kBAAkB,EAAE,kBAAkB,CAAA;CAAE,GAC/C,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/backend/routes.storefront.js

@@ -0,0 +1,26 @@
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { getResolvedChannel } from '@endora-commerce/platform/kernel';
+export async function registerMegamenuStorefrontRoutes(app, deps) {
+    app.get('/api/v1/megamenu/by-channel', async (request) => {
+        const query = (request.query ?? {});
+        const language = query['language'] ?? readHeader(request.headers['accept-language'])?.split(',')[0];
+        const resolved = await deps.storefrontResolver.resolveByChannelAndLanguage({
+            resolvedChannel: resolvedChannel(request),
+            ...(language !== undefined ? { language } : {}),
+        });
+        if (!resolved) {
+            throw new HttpError(404, ERROR_CODES.MEGAMENU_NOT_FOUND, 'No active Megamenu for the requested scope.');
+        }
+        return { data: resolved };
+    });
+}
+/** Reads the request's already-resolved sales channel (set by the resolver middleware). */
+function resolvedChannel(request) {
+    const ch = getResolvedChannel(request);
+    return { id: ch.id, code: ch.code, defaultLanguage: ch.defaultLanguage };
+}
+function readHeader(value) {
+    return Array.isArray(value) ? value[0] : value;
+}
+//# sourceMappingURL=routes.storefront.js.map

package/dist/backend/routes.storefront.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.storefront.js","sourceRoot":"","sources":["../../src/backend/routes.storefront.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGtE,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,GAAoB,EACpB,IAAgD;IAEhD,GAAG,CAAC,GAAG,CAAC,6BAA6B,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACvD,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAuC,CAAC;QAC1E,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpG,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,2BAA2B,CAAC;YACzE,eAAe,EAAE,eAAe,CAAC,OAAO,CAAC;YACzC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,kBAAkB,EAAE,6CAA6C,CAAC,CAAC;QAC1G,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,2FAA2F;AAC3F,SAAS,eAAe,CAAC,OAAuB;IAC9C,MAAM,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,CAAC,eAAe,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,UAAU,CAAC,KAAoC;IACtD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACjD,CAAC"}

package/dist/backend/services/asset-references.d.ts

@@ -0,0 +1,4 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { AssetReferenceRegistryPort } from '@endora-commerce/contracts';
+export declare function registerMegamenuAssetReferences(registry: AssetReferenceRegistryPort, emFactory: () => EntityManager): void;
+//# sourceMappingURL=asset-references.d.ts.map

package/dist/backend/services/asset-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-references.d.ts","sourceRoot":"","sources":["../../../src/backend/services/asset-references.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAGV,0BAA0B,EAC3B,MAAM,4BAA4B,CAAC;AAEpC,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,0BAA0B,EACpC,SAAS,EAAE,MAAM,aAAa,GAC7B,IAAI,CAEN"}

package/dist/backend/services/asset-references.js

@@ -0,0 +1,36 @@
+// Megamenu → AssetReferenceRegistry descriptor — feature 015 / T015.
+//
+// Scans `megamenu_items.target` for both `assetId` (asset items) and
+// `iconAssetId` (link items with an icon). Both edges block deletion of
+// the upstream Library Asset with a 409.
+//
+// The registry and the descriptor are named by their `@endora-commerce/contracts` shapes
+// since feature 075's Phase C: this file describes what it contributes, and
+// `assets_library` decides what enumerating it means — including the policy
+// that honours this scanner while `megamenu` is switched off, which is why the
+// seam stays an ungated registration rather than becoming a port.
+export function registerMegamenuAssetReferences(registry, emFactory) {
+    registry.register(megamenuAssetReferenceDescriptor(emFactory));
+}
+function megamenuAssetReferenceDescriptor(emFactory) {
+    return {
+        ownerModuleId: 'megamenu',
+        async findReferences(assetIds) {
+            if (assetIds.length === 0)
+                return [];
+            const em = emFactory();
+            const placeholders = assetIds.map(() => '?').join(', ');
+            const rows = (await em.execute(`select mi.id::text as item_id, m.name as menu_name
+           from megamenu_items mi
+           join megamenus m on m.id = mi.megamenu_id
+          where mi.target->>'assetId'     in (${placeholders})
+             or mi.target->>'iconAssetId' in (${placeholders})`, [...assetIds, ...assetIds]));
+            return rows.map((r) => ({
+                kind: 'megamenu_item_target',
+                entityId: r.item_id,
+                label: `Megamenu "${r.menu_name}"`,
+            }));
+        },
+    };
+}
+//# sourceMappingURL=asset-references.js.map

package/dist/backend/services/asset-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-references.js","sourceRoot":"","sources":["../../../src/backend/services/asset-references.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,qEAAqE;AACrE,wEAAwE;AACxE,yCAAyC;AACzC,EAAE;AACF,yFAAyF;AACzF,4EAA4E;AAC5E,4EAA4E;AAC5E,+EAA+E;AAC/E,kEAAkE;AASlE,MAAM,UAAU,+BAA+B,CAC7C,QAAoC,EACpC,SAA8B;IAE9B,QAAQ,CAAC,QAAQ,CAAC,gCAAgC,CAAC,SAAS,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,gCAAgC,CACvC,SAA8B;IAE9B,OAAO;QACL,aAAa,EAAE,UAAU;QACzB,KAAK,CAAC,cAAc,CAAC,QAAkB;YACrC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACrC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;YACvB,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAC5B;;;gDAGwC,YAAY;gDACZ,YAAY,GAAG,EACvD,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAC3B,CAAkD,CAAC;YACpD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtB,IAAI,EAAE,sBAAsB;gBAC5B,QAAQ,EAAE,CAAC,CAAC,OAAO;gBACnB,KAAK,EAAE,aAAa,CAAC,CAAC,SAAS,GAAG;aACnC,CAAC,CAAC,CAAC;QACN,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/backend/services/cms-references.d.ts

@@ -0,0 +1,6 @@
+import type { CmsExternalReferenceScanner } from '@endora-commerce/contracts';
+import type { MegamenuReferenceRegistry } from './megamenu-reference-registry.js';
+export declare function registerMegamenuCmsReferences(cmsRegistry: {
+    register: (scanner: CmsExternalReferenceScanner) => void;
+}, megamenuRegistry: MegamenuReferenceRegistry): void;
+//# sourceMappingURL=cms-references.d.ts.map

package/dist/backend/services/cms-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-references.d.ts","sourceRoot":"","sources":["../../../src/backend/services/cms-references.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,2BAA2B,EAAgB,MAAM,4BAA4B,CAAC;AAC5F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAElF,wBAAgB,6BAA6B,CAK3C,WAAW,EAAE;IAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAA;CAAE,EACzE,gBAAgB,EAAE,yBAAyB,GAC1C,IAAI,CAoBN"}

package/dist/backend/services/cms-references.js

@@ -0,0 +1,39 @@
+// Megamenu → CmsReferenceRegistry external scanner — feature 015 / T047.
+//
+// Adapts the in-process `MegamenuReferenceRegistry` into the shape the
+// CMS module's `CmsReferenceRegistry` registers. When the CMS module's
+// page or block delete endpoints consult their registry, our scanner
+// surfaces megamenu items that hold the reference, so the delete is
+// refused with the merged-holder list.
+//
+// Both shapes are read from `@endora-commerce/contracts` since feature 075's Phase C, so
+// this module no longer names a file in `cms`. The seam itself is unchanged:
+// an ungated registration `cms` enumerates on delete, honoured while `megamenu`
+// is off because the items still hold the reference.
+export function registerMegamenuCmsReferences(
+// `CmsReferenceRegistryPort` is the whole seam; a contributor calls one
+// method of it, and `cms`' registry spells the other one `externalOwners`.
+// Naming just `register` keeps this signature what it has always been while
+// the scanner shape comes from the contract.
+cmsRegistry, megamenuRegistry) {
+    cmsRegistry.register({
+        ownerModuleId: 'megamenu',
+        async findPageReferences(pageId) {
+            const refs = await megamenuRegistry.findCmsPageReferences(pageId);
+            return refs.map((ref) => ({
+                kind: 'megamenu',
+                entityId: ref.menuId,
+                label: `Megamenu "${ref.menuName}"`,
+            }));
+        },
+        async findBlockReferences(blockId) {
+            const refs = await megamenuRegistry.findCmsBlockReferences(blockId);
+            return refs.map((ref) => ({
+                kind: 'megamenu',
+                entityId: ref.menuId,
+                label: `Megamenu "${ref.menuName}"`,
+            }));
+        },
+    });
+}
+//# sourceMappingURL=cms-references.js.map

package/dist/backend/services/cms-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-references.js","sourceRoot":"","sources":["../../../src/backend/services/cms-references.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,qEAAqE;AACrE,oEAAoE;AACpE,uCAAuC;AACvC,EAAE;AACF,yFAAyF;AACzF,6EAA6E;AAC7E,gFAAgF;AAChF,qDAAqD;AAKrD,MAAM,UAAU,6BAA6B;AAC3C,wEAAwE;AACxE,2EAA2E;AAC3E,4EAA4E;AAC5E,6CAA6C;AAC7C,WAAyE,EACzE,gBAA2C;IAE3C,WAAW,CAAC,QAAQ,CAAC;QACnB,aAAa,EAAE,UAAU;QACzB,KAAK,CAAC,kBAAkB,CAAC,MAAc;YACrC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;YAClE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACxB,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,GAAG,CAAC,MAAM;gBACpB,KAAK,EAAE,aAAa,GAAG,CAAC,QAAQ,GAAG;aACpC,CAAC,CAAC,CAAC;QACN,CAAC;QACD,KAAK,CAAC,mBAAmB,CAAC,OAAe;YACvC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;YACpE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACxB,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,GAAG,CAAC,MAAM;gBACpB,KAAK,EAAE,aAAa,GAAG,CAAC,QAAQ,GAAG;aACpC,CAAC,CAAC,CAAC;QACN,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/services/cross-module-ports.d.ts

@@ -0,0 +1,112 @@
+import type { AssetReadPort, AssetsLibraryPort, CatalogCategoryReadPort, CmsBlockReadPort, CmsPageReadPort, MegamenuAssetKind, MegamenuResolvedBlock } from '@endora-commerce/contracts';
+/**
+ * Everything this module reads outside itself, in one declaration
+ * (`specs/110-instance-repository/` T118c).
+ *
+ * Until T118c this was two objects a composition root built —
+ * `megamenuValidatorDeps` and `megamenuStorefrontDeps`, eight closures written
+ * twice, once in `backend/src/composition.ts` and once in
+ * `backend/test/helpers/test-server.ts`. Every one of them was a
+ * `select … from categories | cms_pages | cms_blocks | assets` issued from a file
+ * this module does not own, by a root that is nobody's declared dependency: an
+ * operator switching `cms` off was told nothing about what stops, because the
+ * edge existed nowhere a manifest could see it. The two roots also disagreed —
+ * production dropped a deactivated category from the menu and the harness did
+ * not, and production built `/c/<slug>` where the harness built `/catalog/<slug>`,
+ * a path the storefront serves from nowhere.
+ *
+ * Every member is now its owner's **published** port, resolved per call by
+ * `lazyPort` in `backend/index.ts`, so the gate is the registration's and the
+ * edges are in this module's manifest `dependencies`.
+ *
+ * The four functions below are the judgements that used to live inside those
+ * closures — a storefront URL's shape, which category counts as live, which
+ * asset kinds a menu may embed, and what an absent language means. They are
+ * functions of their ports rather than of a `ModuleContext`, so each is testable
+ * over a stub with nothing composed.
+ */
+export interface MegamenuCrossModulePorts {
+    /** `catalog` — a menu item's category target and its storefront URL. */
+    readonly categories: Pick<CatalogCategoryReadPort, 'findById'>;
+    /** `cms` — a menu item's page target and its storefront URL. */
+    readonly pages: Pick<CmsPageReadPort, 'findById'>;
+    /** `cms` — a menu item's block target, and the tree a panel inlines. */
+    readonly blocks: Pick<CmsBlockReadPort, 'findById' | 'findLocalizedById'>;
+    /** `assets_library` — the stored kind, which is what an item's target declares. */
+    readonly assets: Pick<AssetReadPort, 'findById'>;
+    /**
+     * `assets_library` again, for the URL alone.
+     *
+     * Two ports for one asset because neither answers the whole question:
+     * `AssetRecord` carries the stored `kind` and no resolved URL, and
+     * `AssetDetail` carries the URL and no `kind`. `resolveUrl`, which is what
+     * both roots called, **is published on no port** — D-223, in as many words —
+     * so `getAsset` is the sanctioned way to turn an asset id into a URL and this
+     * is the same two reads the roots issued.
+     */
+    readonly assetLibrary: Pick<AssetsLibraryPort, 'getAsset'>;
+}
+/** What a menu item renders an asset target or an icon as. */
+export interface MegamenuAssetTarget {
+    url: string;
+    label: string | null;
+    kind: MegamenuAssetKind;
+}
+/**
+ * A category target's public storefront URL, or `null` for one a shopper may not
+ * reach — which drops the item, and its children with it.
+ *
+ * `/c/<slug>` is the storefront's category route
+ * (`storefront/app/(catalog)/c/[slug]`), and a module naming it is the tree's
+ * established shape: `seo`'s sitemap builds `/c/`, `/p/` and `/<slug>` in its own
+ * sources for the same three things. The composition roots disagreed about it —
+ * the harness built `/catalog/<slug>`, which no route serves — and no test in the
+ * tree read the value, so the harness's answer was wrong for as long as it
+ * existed.
+ *
+ * **Deactivated and soft-deleted are both refusals**, which is production's
+ * `is_active = true and deleted_at is null`. `liveOnly` is the port's word for
+ * the second; `isActive` rides on the record because it is the caller's
+ * judgement, and the admin-side existence check below deliberately makes the
+ * opposite one.
+ */
+export declare function resolveCategoryUrl(categories: MegamenuCrossModulePorts['categories'], categoryId: string): Promise<string | null>;
+/**
+ * A CMS page target's public storefront URL, or `null` when the page is gone.
+ *
+ * **No status or `active` narrowing**, which is what both roots did and is an
+ * asymmetry with the category case above rather than an oversight of this drain:
+ * a draft or deactivated page keeps its menu item and answers for itself when the
+ * shopper follows the link. Changing it is a product decision, and T118c moves a
+ * value rather than redesigning it.
+ */
+export declare function resolveCmsPageUrl(pages: MegamenuCrossModulePorts['pages'], pageId: string): Promise<string | null>;
+/**
+ * An asset target or icon, resolved to the three fields a menu payload carries.
+ *
+ * `null` for an asset that is gone, and for one whose stored kind a menu cannot
+ * render: the library holds `pdf`, `certificate` and `other` as well, and
+ * `MegamenuAssetKind` is the narrower pair. The narrowing is the roots' own
+ * (`if (row.kind !== 'image' && row.kind !== 'video') return null`) and it is what
+ * keeps the wire shape's union honest.
+ *
+ * **No `catch` around `getAsset`, deliberately.** It throws 404 for a row that is
+ * gone, which the read above has already answered `null` for, so the only way to
+ * reach it is an asset deleted between the two reads — and swallowing it would
+ * also swallow `ModuleDisabledError`, which is the fail-open composition
+ * checklist item 7 refuses. Neither root caught here either.
+ */
+export declare function resolveMenuAsset(ports: Pick<MegamenuCrossModulePorts, 'assets' | 'assetLibrary'>, assetId: string): Promise<MegamenuAssetTarget | null>;
+/**
+ * The block a panel inlines, in the language the menu is being resolved for, or
+ * `null` when there is nothing to inline — which drops the item.
+ *
+ * `schemaVersion: 1` is **this module's wire contract**
+ * (`megamenuResolvedBlockSchema`) and not the CMS envelope's deprecated
+ * `schema_version`, which is normalized away on read. It is a constant here for
+ * the same reason it was a constant in the root closures: nothing produces a
+ * second version of this payload shape, and the field belongs to whoever owns the
+ * response.
+ */
+export declare function resolveMenuBlock(blocks: MegamenuCrossModulePorts['blocks'], blockId: string, language: string): Promise<MegamenuResolvedBlock | null>;
+//# sourceMappingURL=cross-module-ports.d.ts.map

package/dist/backend/services/cross-module-ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-module-ports.d.ts","sourceRoot":"","sources":["../../../src/backend/services/cross-module-ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAC;IAC/D,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAClD,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,mBAAmB,CAAC,CAAC;IAC1E,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACjD;;;;;;;;;OASG;IACH,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;CAC5D;AAED,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,wBAAwB,CAAC,YAAY,CAAC,EAClD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,wBAAwB,CAAC,OAAO,CAAC,EACxC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,cAAc,CAAC,EAChE,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CASrC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,EAC1C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CASvC"}