@endora-commerce/mod-megamenu 0.100.0

package/dist/backend/services/megamenu-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"megamenu-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/megamenu-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,eAAe,IAAI,kBAAkB,EAC1C,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,KAAK,WAAW,GAAG;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,UAAU,EAAE,IAAI,GAAG,MAAM,CAAC;CAC3B,CAAC;AAuBF;;;;;GAKG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAFpB,SAAS,EAAE,MAAM,aAAa,EAC9B,KAAK,CAAC,EAAE,aAAa,YAAA,EACrB,mBAAmB,CAAC,EAAE,mBAAmB,YAAA;IAOtD,IAAI,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QAAC,UAAU,EAAE,IAAI,CAAA;KAAE,CAAC;IAQ9D,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IAY7D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMxC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IA8BvE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAS3D,UAAU,CACd,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC;YA2ChB,gBAAgB;IAmBxB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5F;;;;;OAKG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,uBAAuB,CAAC;IA0E7B,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BnF,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;YAM5D,gBAAgB;IAK9B,OAAO,CAAC,aAAa;IAMrB;;;;;;;;;;;OAWG;YACW,YAAY;YAIZ,UAAU;YASV,aAAa;YAOb,SAAS;YAcT,QAAQ;IAStB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,GAAG;CAGZ;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,IAAI,gBAAgB,EAAE,CAEvD"}

package/dist/backend/services/megamenu-service.js

@@ -0,0 +1,299 @@
+import { randomUUID } from 'crypto';
+import { DictionaryReferenceError, ERROR_CODES, } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+/**
+ * Megamenu CRUD + binding lifecycle. The activation transaction enforces
+ * "exactly one active megamenu per (channel, language)" via the partial
+ * unique index on `megamenu_bindings(sales_channel_id, language) WHERE
+ * active = true` (R3 / FR-008).
+ */
+export class MegamenuService {
+    emFactory;
+    cache;
+    dictionaryValidator;
+    constructor(emFactory, cache, dictionaryValidator) {
+        this.emFactory = emFactory;
+        this.cache = cache;
+        this.dictionaryValidator = dictionaryValidator;
+    }
+    // ────────────────────────────────────────────────────────────────────
+    // CRUD
+    // ────────────────────────────────────────────────────────────────────
+    async list() {
+        const rows = (await this.emFactory().execute(`select * from megamenus order by updated_at desc limit 100`));
+        const data = await Promise.all(rows.map((row) => this.toSummary(row)));
+        return { data, nextCursor: null };
+    }
+    async create(input) {
+        const em = this.emFactory();
+        const id = randomUUID();
+        const now = new Date();
+        await em.execute(`insert into megamenus (id, name, description, version, created_at, updated_at)
+       values (?, ?, ?, 1, ?, ?)`, [id, input.name, input.description ?? null, now, now]);
+        return this.get(id);
+    }
+    async get(id) {
+        const row = await this.findRow(id);
+        if (!row)
+            throw new HttpError(404, ERROR_CODES.MEGAMENU_NOT_FOUND, 'Megamenu not found.');
+        return this.toDetail(row);
+    }
+    async patch(id, input) {
+        const em = this.emFactory();
+        await em.transactional(async (tx) => {
+            const row = await this.findRow(id, tx);
+            if (!row)
+                throw new HttpError(404, ERROR_CODES.MEGAMENU_NOT_FOUND, 'Megamenu not found.');
+            this.assertVersion(row.version, input.version);
+            const sets = [];
+            const params = [];
+            if (input.name !== undefined) {
+                sets.push('name = ?');
+                params.push(input.name);
+            }
+            if (input.description !== undefined) {
+                sets.push('description = ?');
+                params.push(input.description);
+            }
+            if (sets.length === 0)
+                return;
+            params.push(id);
+            await tx.execute(`update megamenus
+            set ${sets.join(', ')}, version = version + 1, updated_at = now()
+          where id = ?`, params);
+        });
+        if (this.cache)
+            await this.cache.invalidateAll();
+        return this.get(id);
+    }
+    async delete(id) {
+        const em = this.emFactory();
+        const activeRows = (await em.execute(`select 1 from megamenu_bindings where megamenu_id = ? and active = true limit 1`, [id]));
+        if (activeRows.length > 0) {
+            throw new HttpError(409, ERROR_CODES.MEGAMENU_HAS_ACTIVE_BINDINGS, 'Megamenu has at least one active binding; deactivate before deleting.');
+        }
+        await em.execute('delete from megamenus where id = ?', [id]);
+        if (this.cache)
+            await this.cache.invalidateAll();
+    }
+    // ────────────────────────────────────────────────────────────────────
+    // Bindings
+    // ────────────────────────────────────────────────────────────────────
+    async listBindings(menuId) {
+        await this.assertMenuExists(menuId);
+        const rows = (await this.emFactory().execute(`select * from megamenu_bindings where megamenu_id = ? order by created_at asc`, [menuId]));
+        return rows.map((row) => this.toBindingDto(row));
+    }
+    async addBinding(menuId, salesChannelId, language) {
+        const em = this.emFactory();
+        await this.assertMenuExists(menuId);
+        await this.validateLanguage(language);
+        const channel = await this.fetchChannel(em, salesChannelId);
+        if (!channel) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Sales channel ${salesChannelId} not found.`);
+        }
+        if (!channel.languages.includes(language)) {
+            throw new HttpError(400, ERROR_CODES.MEGAMENU_LANGUAGE_NOT_IN_CHANNEL_SCOPE, `Language "${language}" is not in the channel's configured language set.`);
+        }
+        const existing = (await em.execute(`select 1 from megamenu_bindings
+        where megamenu_id = ? and sales_channel_id = ? and language = ?`, [menuId, salesChannelId, language]));
+        if (existing.length > 0) {
+            throw new HttpError(409, ERROR_CODES.MEGAMENU_BINDING_ALREADY_EXISTS, 'Binding for this (channel, language) already exists.');
+        }
+        const now = new Date();
+        await em.execute(`insert into megamenu_bindings
+         (megamenu_id, sales_channel_id, language, active, version, created_at, updated_at)
+       values (?, ?, ?, false, 1, ?, ?)`, [menuId, salesChannelId, language, now, now]);
+        if (this.cache)
+            await this.cache.invalidateScope(channel.code, language);
+        const rows = (await em.execute(`select * from megamenu_bindings
+        where megamenu_id = ? and sales_channel_id = ? and language = ?`, [menuId, salesChannelId, language]));
+        return this.toBindingDto(rows[0]);
+    }
+    async validateLanguage(language) {
+        if (!this.dictionaryValidator)
+            return;
+        try {
+            await this.dictionaryValidator.validateLanguageCode(language, 'create-or-change');
+        }
+        catch (err) {
+            if (err instanceof DictionaryReferenceError) {
+                throw new HttpError(409, err.code, err.code === 'DICTIONARY_ENTRY_INACTIVE'
+                    ? `Language code ${err.entryCode} is no longer available for megamenu bindings.`
+                    : `Language code ${err.entryCode} is not recognised.`, [{ path: 'language', issue: err.code }]);
+            }
+            throw err;
+        }
+    }
+    async removeBinding(menuId, salesChannelId, language) {
+        const em = this.emFactory();
+        await this.assertMenuExists(menuId);
+        const channel = await this.fetchChannel(em, salesChannelId);
+        await em.execute(`delete from megamenu_bindings
+        where megamenu_id = ? and sales_channel_id = ? and language = ?`, [menuId, salesChannelId, language]);
+        // DELETE is idempotent — a missing row is fine. Cache invalidation
+        // runs unconditionally so a stale entry never lingers.
+        if (this.cache && channel)
+            await this.cache.invalidateScope(channel.code, language);
+    }
+    /**
+     * Atomic activation swap (FR-008 / R3): deactivate the prior holder
+     * for the scope (if any) inside the same transaction, then upsert the
+     * new active row. The partial unique index refuses dual-active state
+     * even if this method's body regresses.
+     */
+    async activate(menuId, salesChannelId, language) {
+        const em = this.emFactory();
+        let response;
+        await em.transactional(async (tx) => {
+            // Verify the binding exists.
+            const binding = (await tx.execute(`select * from megamenu_bindings
+          where megamenu_id = ? and sales_channel_id = ? and language = ?`, [menuId, salesChannelId, language]));
+            if (binding.length === 0) {
+                throw new HttpError(404, ERROR_CODES.MEGAMENU_BINDING_NOT_FOUND, 'Binding not found.');
+            }
+            // Refuse on empty tree (R10).
+            const items = (await tx.execute(`select 1 from megamenu_items where megamenu_id = ? limit 1`, [menuId]));
+            if (items.length === 0) {
+                throw new HttpError(400, ERROR_CODES.MEGAMENU_EMPTY_TREE, 'Megamenu has no items; populate the tree before activating.');
+            }
+            // Identify any prior holder for the (channel, language) pair.
+            const prior = (await tx.execute(`select b.megamenu_id, m.name
+           from megamenu_bindings b
+           join megamenus m on m.id = b.megamenu_id
+          where b.sales_channel_id = ? and b.language = ? and b.active = true
+            and b.megamenu_id <> ?
+          limit 1`, [salesChannelId, language, menuId]));
+            // Deactivate any existing active binding in the scope (this menu or another).
+            await tx.execute(`update megamenu_bindings
+            set active = false, version = version + 1, updated_at = now()
+          where sales_channel_id = ? and language = ? and active = true`, [salesChannelId, language]);
+            // Activate the requested binding.
+            await tx.execute(`update megamenu_bindings
+            set active = true, version = version + 1, updated_at = now()
+          where megamenu_id = ? and sales_channel_id = ? and language = ?`, [menuId, salesChannelId, language]);
+            response = {
+                activated: { megamenuId: menuId, salesChannelId, language },
+                previouslyActive: prior.length > 0 && prior[0]
+                    ? { megamenuId: prior[0].megamenu_id, name: prior[0].name }
+                    : null,
+            };
+        });
+        if (this.cache) {
+            const channel = await this.fetchChannel(em, salesChannelId);
+            if (channel)
+                await this.cache.invalidateScope(channel.code, language);
+        }
+        return response;
+    }
+    async deactivate(menuId, salesChannelId, language) {
+        const em = this.emFactory();
+        const existing = (await em.execute(`select 1 from megamenu_bindings
+        where megamenu_id = ? and sales_channel_id = ? and language = ? limit 1`, [menuId, salesChannelId, language]));
+        if (existing.length === 0) {
+            throw new HttpError(404, ERROR_CODES.MEGAMENU_BINDING_NOT_FOUND, 'Binding not found.');
+        }
+        await em.execute(`update megamenu_bindings
+          set active = false, version = version + 1, updated_at = now()
+        where megamenu_id = ? and sales_channel_id = ? and language = ?`, [menuId, salesChannelId, language]);
+        if (this.cache) {
+            const channel = await this.fetchChannel(em, salesChannelId);
+            if (channel)
+                await this.cache.invalidateScope(channel.code, language);
+        }
+    }
+    // ────────────────────────────────────────────────────────────────────
+    // Helpers
+    // ────────────────────────────────────────────────────────────────────
+    async findRow(id, em) {
+        const targetEm = (em ?? this.emFactory());
+        const rows = (await targetEm.execute('select * from megamenus where id = ?', [id]));
+        return rows[0] ?? null;
+    }
+    async assertMenuExists(id) {
+        const row = await this.findRow(id);
+        if (!row)
+            throw new HttpError(404, ERROR_CODES.MEGAMENU_NOT_FOUND, 'Megamenu not found.');
+    }
+    assertVersion(current, supplied) {
+        if (supplied !== undefined && supplied !== current) {
+            throw new HttpError(409, ERROR_CODES.VERSION_CONFLICT, 'Megamenu was updated concurrently.');
+        }
+    }
+    /**
+     * The kernel's own entity, not `select … from sales_channels` (feature 075,
+     * D-87). `sales_channels` is the kernel's table since feature 072 moved the
+     * resolution machinery there, and a module relating into the kernel by ORM is
+     * the sanctioned access.
+     *
+     * Read through the caller's `em`, not through
+     * `salesChannelResolutionPort.getById`: every caller here is inside
+     * `em.transactional`, and that accessor forks its own EntityManager, so the
+     * binding checks below would validate against rows outside the transaction
+     * they are about to write into.
+     */
+    async fetchChannel(em, id) {
+        return em.findOne(SalesChannel, { id });
+    }
+    async fetchItems(menuId) {
+        return (await this.emFactory().execute(`select * from megamenu_items
+        where megamenu_id = ?
+        order by parent_id nulls first, position asc, id asc`, [menuId]));
+    }
+    async fetchBindings(menuId) {
+        return (await this.emFactory().execute(`select * from megamenu_bindings where megamenu_id = ? order by created_at asc`, [menuId]));
+    }
+    async toSummary(row) {
+        const bindings = (await this.fetchBindings(row.id)).map((b) => this.toBindingDto(b));
+        return {
+            id: row.id,
+            name: row.name,
+            description: row.description,
+            version: row.version,
+            bindings,
+            activeIn: bindings.filter((b) => b.active).length,
+            createdAt: this.iso(row.created_at),
+            updatedAt: this.iso(row.updated_at),
+        };
+    }
+    async toDetail(row) {
+        const summary = await this.toSummary(row);
+        const itemRows = await this.fetchItems(row.id);
+        return {
+            ...summary,
+            items: itemRows.map((item) => this.toItemDto(item)),
+        };
+    }
+    toBindingDto(row) {
+        return {
+            salesChannelId: row.sales_channel_id,
+            language: row.language,
+            active: row.active,
+            version: row.version,
+            createdAt: this.iso(row.created_at),
+            updatedAt: this.iso(row.updated_at),
+        };
+    }
+    toItemDto(row) {
+        // The Zod discriminated union enforces shape on the way in; the way
+        // out we trust the persisted data and re-shape into the contract type.
+        return {
+            id: row.id,
+            parentId: row.parent_id,
+            position: row.position,
+            kind: row.kind,
+            labels: row.labels,
+            descriptions: row.descriptions,
+            target: row.target,
+        };
+    }
+    iso(value) {
+        return value instanceof Date ? value.toISOString() : new Date(value).toISOString();
+    }
+}
+/** Small helper for tests / smoke flows that need to assemble a tree. */
+export function emptyResolvedItems() {
+    return [];
+}
+//# sourceMappingURL=megamenu-service.js.map

package/dist/backend/services/megamenu-service.js.map

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

package/dist/backend/services/storefront-resolver.d.ts

@@ -0,0 +1,46 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { ResolvedMegamenu } from '@endora-commerce/contracts';
+import type { MegamenuCache } from './megamenu-cache.js';
+import { type MegamenuCrossModulePorts } from './cross-module-ports.js';
+/** Request-resolved sales channel handed in by the resolver middleware. */
+export type ResolvedChannel = {
+    id: string;
+    code: string;
+    defaultLanguage: string;
+};
+/**
+ * Storefront resolution for the Megamenu module — feature 015 / T028.
+ *
+ * `resolveByChannelAndLanguage` is the single read endpoint behind
+ * `GET /api/v1/megamenu/by-channel`. It looks up the active binding via
+ * the partial unique index, fetches every item in one query, batches
+ * cross-module URL resolution, and assembles a recursive payload.
+ * Optional Redis read-through wraps the whole call.
+ */
+export declare class StorefrontResolver {
+    private readonly emFactory;
+    /**
+     * The four cross-module reads a resolved menu needs, as their owners'
+     * published ports (`specs/110-instance-repository/` T118c). This was
+     * `StorefrontDeps`, an interface this module exported so a composition root
+     * could build four closures against it — twice, and not identically.
+     */
+    private readonly ports;
+    private readonly cache?;
+    constructor(emFactory: () => EntityManager, 
+    /**
+     * The four cross-module reads a resolved menu needs, as their owners'
+     * published ports (`specs/110-instance-repository/` T118c). This was
+     * `StorefrontDeps`, an interface this module exported so a composition root
+     * could build four closures against it — twice, and not identically.
+     */
+    ports: MegamenuCrossModulePorts, cache?: MegamenuCache | undefined);
+    resolveByChannelAndLanguage(input: {
+        resolvedChannel: ResolvedChannel;
+        language?: string | undefined;
+    }): Promise<ResolvedMegamenu | null>;
+    private buildOne;
+    private resolveIcon;
+    private resolveLabel;
+}
+//# sourceMappingURL=storefront-resolver.d.ts.map

package/dist/backend/services/storefront-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/services/storefront-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,gBAAgB,EAOjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAKL,KAAK,wBAAwB,EAC9B,MAAM,yBAAyB,CAAC;AAQjC,2EAA2E;AAC3E,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAqBpF;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBARN,SAAS,EAAE,MAAM,aAAa;IAC/C;;;;;OAKG;IACc,KAAK,EAAE,wBAAwB,EAC/B,KAAK,CAAC,EAAE,aAAa,YAAA;IAGlC,2BAA2B,CAAC,KAAK,EAAE;QACvC,eAAe,EAAE,eAAe,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC/B,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;YA6DtB,QAAQ;YA4ER,WAAW;IAUzB,OAAO,CAAC,YAAY;CAiBrB"}

package/dist/backend/services/storefront-resolver.js

@@ -0,0 +1,162 @@
+import { resolveCategoryUrl, resolveCmsPageUrl, resolveMenuAsset, resolveMenuBlock, } from './cross-module-ports.js';
+function toChannelRow(channel) {
+    return { id: channel.id, code: channel.code, default_language: channel.defaultLanguage };
+}
+/**
+ * Storefront resolution for the Megamenu module — feature 015 / T028.
+ *
+ * `resolveByChannelAndLanguage` is the single read endpoint behind
+ * `GET /api/v1/megamenu/by-channel`. It looks up the active binding via
+ * the partial unique index, fetches every item in one query, batches
+ * cross-module URL resolution, and assembles a recursive payload.
+ * Optional Redis read-through wraps the whole call.
+ */
+export class StorefrontResolver {
+    emFactory;
+    ports;
+    cache;
+    constructor(emFactory, 
+    /**
+     * The four cross-module reads a resolved menu needs, as their owners'
+     * published ports (`specs/110-instance-repository/` T118c). This was
+     * `StorefrontDeps`, an interface this module exported so a composition root
+     * could build four closures against it — twice, and not identically.
+     */
+    ports, cache) {
+        this.emFactory = emFactory;
+        this.ports = ports;
+        this.cache = cache;
+    }
+    async resolveByChannelAndLanguage(input) {
+        const em = this.emFactory();
+        const channel = toChannelRow(input.resolvedChannel);
+        const requestedLanguage = input.language ?? channel.default_language;
+        if (this.cache) {
+            const cached = await this.cache.get(channel.code, requestedLanguage);
+            if (cached)
+                return cached;
+        }
+        const menuRows = (await em.execute(`select m.id::text as id, m.name as name
+         from megamenu_bindings b
+         join megamenus m on m.id = b.megamenu_id
+        where b.sales_channel_id = ? and b.language = ? and b.active = true
+        limit 1`, [channel.id, requestedLanguage]));
+        const active = menuRows[0];
+        if (!active)
+            return null;
+        const itemRows = (await em.execute(`select id::text, parent_id::text, position, kind, labels, descriptions, target
+         from megamenu_items
+        where megamenu_id = ?
+        order by parent_id nulls first, position asc, id asc`, [active.id]));
+        const byParent = new Map();
+        for (const row of itemRows) {
+            const list = byParent.get(row.parent_id) ?? [];
+            list.push(row);
+            byParent.set(row.parent_id, list);
+        }
+        const buildSubtree = async (parentId) => {
+            const children = byParent.get(parentId) ?? [];
+            const out = [];
+            for (const row of children) {
+                const built = await this.buildOne(row, requestedLanguage, channel.default_language, buildSubtree);
+                if (built)
+                    out.push(built);
+            }
+            return out;
+        };
+        const tree = await buildSubtree(null);
+        const payload = {
+            megamenuId: active.id,
+            name: active.name,
+            language: requestedLanguage,
+            items: tree,
+        };
+        if (this.cache) {
+            await this.cache.set(channel.code, requestedLanguage, payload);
+        }
+        return payload;
+    }
+    async buildOne(row, language, fallbackLanguage, buildSubtree) {
+        const label = this.resolveLabel(row.labels, language, fallbackLanguage);
+        if (label === null)
+            return null;
+        const description = this.resolveLabel(row.descriptions ?? {}, language, fallbackLanguage);
+        const children = await buildSubtree(row.id);
+        const base = {
+            id: row.id,
+            parentId: row.parent_id,
+            kind: row.kind,
+            label,
+            ...(description !== null ? { description } : {}),
+            children,
+        };
+        switch (row.kind) {
+            case 'category-link': {
+                const target = row.target;
+                const url = await resolveCategoryUrl(this.ports.categories, target.categoryId);
+                if (!url)
+                    return null;
+                const icon = await this.resolveIcon(target.iconAssetId, target.iconPosition);
+                return { ...base, url, ...(icon ? { icon } : {}) };
+            }
+            case 'cms-page-link': {
+                const target = row.target;
+                const url = await resolveCmsPageUrl(this.ports.pages, target.pageId);
+                if (!url)
+                    return null;
+                const icon = await this.resolveIcon(target.iconAssetId, target.iconPosition);
+                return { ...base, url, ...(icon ? { icon } : {}) };
+            }
+            case 'external-link': {
+                const target = row.target;
+                const icon = await this.resolveIcon(target.iconAssetId, target.iconPosition);
+                return { ...base, url: target.url, ...(icon ? { icon } : {}) };
+            }
+            case 'button': {
+                const target = row.target;
+                return { ...base, url: target.url, variant: target.variant };
+            }
+            case 'asset': {
+                const target = row.target;
+                if (!target.assetId)
+                    return null;
+                const resolved = await resolveMenuAsset(this.ports, target.assetId);
+                if (!resolved)
+                    return null;
+                return {
+                    ...base,
+                    asset: { id: target.assetId, kind: resolved.kind, url: resolved.url, label: resolved.label },
+                };
+            }
+            case 'cms-block-embed': {
+                const target = row.target;
+                const block = await resolveMenuBlock(this.ports.blocks, target.blockId, language);
+                if (!block)
+                    return null;
+                return { ...base, block, embedSide: target.embedSide };
+            }
+        }
+    }
+    async resolveIcon(iconAssetId, iconPosition) {
+        if (!iconAssetId)
+            return null;
+        const asset = await resolveMenuAsset(this.ports, iconAssetId);
+        if (!asset)
+            return null;
+        return { assetId: iconAssetId, url: asset.url, position: iconPosition ?? 'left' };
+    }
+    resolveLabel(labels, language, fallbackLanguage) {
+        const direct = labels[language];
+        if (typeof direct === 'string' && direct.length > 0) {
+            return direct;
+        }
+        if (language !== fallbackLanguage) {
+            const fallback = labels[fallbackLanguage];
+            if (typeof fallback === 'string' && fallback.length > 0) {
+                return fallback;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=storefront-resolver.js.map

package/dist/backend/services/storefront-resolver.js.map

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

package/dist/backend/services/target-validator.d.ts

@@ -0,0 +1,24 @@
+import { type MegamenuItem } from '@endora-commerce/contracts';
+import type { MegamenuCrossModulePorts } from './cross-module-ports.js';
+/**
+ * Validates a single MegamenuItem against the cross-module ports. Throws
+ * `HttpError` on the first failure so callers (`MegamenuItemService.setTree`)
+ * can re-raise unchanged.
+ *
+ * The four checks used to arrive as `TargetValidatorDeps`, an interface this
+ * module exported for a composition root to build closures against
+ * (`specs/110-instance-repository/` T118c). They are their owners' published read
+ * ports now, resolved by `backend/index.ts` and declared in this module's
+ * manifest.
+ *
+ * **`_channelIds` is threaded and read by nothing, which is what the roots' SQL
+ * did.** `setTree` computes the union of the menu's bound channels and passes it
+ * here; neither root's closure ever looked at it, so `MEGAMENU_TARGET_OUT_OF_SCOPE`
+ * has only ever meant *the target does not exist*. That is a documented v1
+ * narrowing — `megamenu-item-service.ts` says so at the call site, and the scope
+ * refusal is US3's — and the parameter is kept so US3 lands inside this function
+ * rather than re-plumbing its caller. Naming it `_` is the only change: the
+ * ignoring used to happen two files away in a root nobody reads.
+ */
+export declare function validateTarget(item: MegamenuItem, _channelIds: string[], ports: MegamenuCrossModulePorts): Promise<void>;
+//# sourceMappingURL=target-validator.d.ts.map

package/dist/backend/services/target-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-validator.d.ts","sourceRoot":"","sources":["../../../src/backend/services/target-validator.ts"],"names":[],"mappings":"AAQA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE5E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAIxE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAwGf"}