@endora-commerce/mod-catalog 0.100.0

package/dist/backend/services/gallery.service.js

@@ -0,0 +1,326 @@
+/**
+ * GalleryService — admin-only CRUD for Product Gallery Items + their
+ * Base/Small/Thumbnail label assignments (feature 002 US3,
+ * data-model.md §2.3, §2.4, research.md R-2).
+ *
+ * The per-product UNIQUE constraint on `gallery_item_labels(product_id,
+ * label)` is the load-bearing invariant. The atomic-swap operation
+ * (`?replace=true`) wraps the swap in a single transaction:
+ *   DELETE conflicting labels FROM other items → INSERT/UPDATE the new
+ *   ones. Reading "current owner" + writing "new owner" is one atomic
+ *   step so concurrent admins don't crash into each other's swaps.
+ */
+import { randomUUID } from 'node:crypto';
+import { ERROR_CODES, } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { Product } from '../entities/product.entity.js';
+import { GalleryItem } from '../entities/gallery-item.entity.js';
+import { GalleryItemLabel } from '../entities/gallery-item-label.entity.js';
+const GALLERY_LABELS_VALID = new Set([
+    'base_image',
+    'small_image',
+    'thumbnail',
+]);
+const ASSET_KINDS_GALLERY = new Set(['image', 'video']);
+export class GalleryService {
+    emFactory;
+    commandBus;
+    assets;
+    constructor(emFactory, 
+    /** Feature 054 — audits gallery-item writes co-transactionally when provided. */
+    commandBus, 
+    /**
+     * Feature 075 — `assets_library`'s read port, where `em.findOne(Asset, …)`
+     * used to be. It backs the kind check below, so with `assets_library` off
+     * the port fails closed and a gallery item pointing at an unverifiable
+     * asset is refused rather than stored.
+     */
+    assets) {
+        this.emFactory = emFactory;
+        this.commandBus = commandBus;
+        this.assets = assets;
+    }
+    #requireAssets() {
+        if (!this.assets) {
+            throw new Error('GalleryService: the asset read port is not wired — a gallery item cannot be verified.');
+        }
+        return this.assets;
+    }
+    /**
+     * Feature 054 — run a gallery-item write through the Command Bus. The item +
+     * audit are co-transactional; the raw-SQL LABEL writes stay AFTER the command
+     * (a gallery item with no labels is a valid state, so nothing is orphaned).
+     */
+    async #audited(action, objectId, write) {
+        if (this.commandBus) {
+            return this.commandBus.run({ action, objectType: 'gallery_item', objectId, run: ({ em }) => write(em) });
+        }
+        const em = this.emFactory();
+        const w = await write(em);
+        await em.flush();
+        return w.result;
+    }
+    async list(productId) {
+        const em = this.emFactory();
+        await this.#assertProductExists(em, productId);
+        return this.#fetchAllForProduct(em, productId);
+    }
+    /**
+     * Feature 075 / D-87 — the batch half of {@link list}, for the callers that
+     * walk a page or a whole sellable catalogue.
+     *
+     * `product_feeds` used to run this statement itself, inside its own hydration
+     * batch, against a table `catalog` owns. It named no import specifier, so the
+     * boundary compiled and returned rows; `list` could not replace it because
+     * three round-trips per product is 1500 for a 500-product batch.
+     *
+     * Two things are deliberately absent. There is **no `#assertProductExists`**:
+     * a caller asks about the ids it holds, one of which may have been removed
+     * since, and answering 404 for the batch would be answering about a different
+     * question. And there are **no labels**: neither consumer reads them here, and
+     * fetching them costs a second statement per batch.
+     */
+    async listForProducts(productIds) {
+        if (productIds.length === 0)
+            return [];
+        const ids = [...new Set(productIds)];
+        // `em.execute`, not `em.getConnection().execute`, so a caller that opens a
+        // transaction around this read sees its own uncommitted writes (issue #200).
+        const rows = await this.emFactory().execute(`select gi.product_id::text as product_id,
+              gi.asset_id::text as asset_id,
+              gi.position
+         from gallery_items gi
+        where gi.product_id in (${ids.map(() => '?').join(',')})
+        order by gi.product_id, gi.position asc, gi.id asc`, ids);
+        return rows.map((row) => ({
+            productId: row.product_id,
+            assetId: row.asset_id,
+            position: Number(row.position),
+        }));
+    }
+    /**
+     * Feature 075 / D-87 — the `base_image` url of each of a batch of products.
+     *
+     * `comparisons` used to answer this with one statement joining this module's
+     * `gallery_item_labels` and `gallery_items` to `assets_library`'s `assets` —
+     * three cross-module reaches in a single join, which is why they retire
+     * together or not at all. Here the join stops at this module's own two tables
+     * and the asset row is asked of its owner through the port this service
+     * already holds, in one call for the whole batch.
+     *
+     * `base_image` only. This is not {@link resolvePrimaryAssetUrls}, which walks
+     * thumbnail → base_image → first item and answers "which image represents
+     * this product"; the comparison column names the base image explicitly
+     * (feature 007, FR-006), and a fallback here would quietly put a thumbnail in
+     * a column an operator set deliberately.
+     *
+     * The map holds one entry per requested id. `null` covers three cases the
+     * callers render identically — no label, no product, no asset row — and the
+     * inner join it replaces collapsed all three the same way.
+     */
+    async baseImageUrls(productIds) {
+        const urlByProduct = new Map();
+        for (const id of productIds)
+            urlByProduct.set(id, null);
+        if (urlByProduct.size === 0)
+            return urlByProduct;
+        const ids = [...urlByProduct.keys()];
+        const rows = await this.emFactory().execute(`select gil.product_id::text as product_id, gi.asset_id::text as asset_id
+         from gallery_item_labels gil
+         join gallery_items gi on gi.id = gil.gallery_item_id
+        where gil.label = 'base_image'
+          and gil.product_id in (${ids.map(() => '?').join(',')})`, ids);
+        if (rows.length === 0)
+            return urlByProduct;
+        // One call to the owner for every base image in the batch. `assets_library`
+        // is a binding dependency of this module, so an absent owner fails closed
+        // here rather than quietly answering "no product has an image".
+        const assetIds = [...new Set(rows.map((row) => row.asset_id))];
+        const urlByAsset = new Map((await this.#requireAssets().findByIds(assetIds)).map((asset) => [
+            asset.id,
+            asset.storageUrl,
+        ]));
+        for (const row of rows) {
+            const url = urlByAsset.get(row.asset_id);
+            if (url !== undefined)
+                urlByProduct.set(row.product_id, url);
+        }
+        return urlByProduct;
+    }
+    async create(productId, req, options) {
+        const em0 = this.emFactory();
+        await this.#assertProductExists(em0, productId);
+        const asset = await this.#requireAssets().findById(req.assetId);
+        if (!asset) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Asset ${req.assetId} not found.`);
+        }
+        if (!ASSET_KINDS_GALLERY.has(asset.kind)) {
+            throw new HttpError(400, ERROR_CODES.ASSET_KIND_NOT_SUPPORTED, `Gallery items require asset.kind ∈ {image, video}; got "${asset.kind}".`);
+        }
+        const labels = this.#normalizeAndValidateLabels(req.labels);
+        const position = req.position ?? (await this.#nextPosition(em0, productId));
+        const id = randomUUID();
+        await this.#audited('gallery_item.create', id, async (em) => {
+            const item = em.create(GalleryItem, { id, productId, assetId: req.assetId, position });
+            await em.flush();
+            return {
+                result: item,
+                before: null,
+                after: { productId, assetId: req.assetId, position, labels },
+            };
+        });
+        // Labels run AFTER the item commits (bridge-after-command) — matches the
+        // pre-054 two-step; an item with no labels is a valid state.
+        const em = this.emFactory();
+        if (labels.length > 0) {
+            await this.#applyLabels(em, productId, id, labels, options);
+        }
+        return (await this.#fetchOne(em, id));
+    }
+    async update(productId, itemId, req, options) {
+        await this.#audited('gallery_item.update', itemId, async (em) => {
+            const item = await em.findOne(GalleryItem, { id: itemId, productId });
+            if (!item) {
+                throw new HttpError(404, ERROR_CODES.GALLERY_ITEM_NOT_FOUND, `Gallery item ${itemId} not found under Product ${productId}.`);
+            }
+            const before = { position: item.position };
+            if (req.position !== undefined)
+                item.position = req.position;
+            return { result: undefined, before, after: { position: item.position } };
+        });
+        // Label replacement runs AFTER the item update (bridge-after-command).
+        if (req.labels !== undefined) {
+            const em = this.emFactory();
+            const labels = this.#normalizeAndValidateLabels(req.labels);
+            await em.execute(`delete from gallery_item_labels where gallery_item_id = ?`, [itemId]);
+            if (labels.length > 0) {
+                await this.#applyLabels(em, productId, itemId, labels, options);
+            }
+        }
+        return (await this.#fetchOne(this.emFactory(), itemId));
+    }
+    async delete(productId, itemId) {
+        await this.#audited('gallery_item.delete', itemId, async (em) => {
+            const item = await em.findOne(GalleryItem, { id: itemId, productId });
+            if (!item) {
+                throw new HttpError(404, ERROR_CODES.GALLERY_ITEM_NOT_FOUND, `Gallery item ${itemId} not found under Product ${productId}.`);
+            }
+            const before = { productId, assetId: item.assetId };
+            em.remove(item); // CASCADE on gallery_item_labels picks up the children.
+            return { result: undefined, before, after: null };
+        });
+    }
+    async reorder(productId, orderedIds) {
+        const em = this.emFactory();
+        await this.#assertProductExists(em, productId);
+        // Verify all ids belong to this product.
+        const existing = await em.find(GalleryItem, { productId });
+        const existingIds = new Set(existing.map((i) => i.id));
+        if (orderedIds.length !== existing.length ||
+            !orderedIds.every((id) => existingIds.has(id))) {
+            throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, 'orderedGalleryItemIds must cover every existing gallery item exactly once.');
+        }
+        // One UPDATE per row. `em.execute`, not `em.getConnection().execute`, so a
+        // caller that ever opens a transaction around this gets the whole reorder
+        // in it (issue #207). This comment used to claim the loop was transactional
+        // and it is not: `em` here is a bare fork, so a failure part-way through
+        // leaves the gallery in the order the successful updates put it.
+        for (let i = 0; i < orderedIds.length; i++) {
+            await em.execute(`update gallery_items set position = ? where id = ?`, [i, orderedIds[i]]);
+        }
+    }
+    // -- INTERNALS -------------------------------------------------------------
+    async #assertProductExists(em, productId) {
+        const product = await em.findOne(Product, { id: productId });
+        if (!product) {
+            throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, `Product ${productId} not found.`);
+        }
+    }
+    #normalizeAndValidateLabels(labels) {
+        if (!labels)
+            return [];
+        const seen = new Set();
+        for (const l of labels) {
+            if (!GALLERY_LABELS_VALID.has(l)) {
+                throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, `Unknown gallery label "${l}".`);
+            }
+            seen.add(l);
+        }
+        if (seen.size !== labels.length) {
+            throw new HttpError(400, ERROR_CODES.GALLERY_LABEL_LIMIT_EXCEEDED, 'A gallery item cannot carry the same label twice (1-3 distinct labels).');
+        }
+        if (seen.size > 3) {
+            throw new HttpError(400, ERROR_CODES.GALLERY_LABEL_LIMIT_EXCEEDED, 'A gallery item can have at most 3 labels.');
+        }
+        return Array.from(seen);
+    }
+    async #nextPosition(em, productId) {
+        const rows = (await em.execute(`select coalesce(max(position), -1) + 1 as next_position from gallery_items where product_id = ?`, [productId]));
+        return rows[0]?.next_position ?? 0;
+    }
+    /**
+     * Apply a set of labels to a gallery item. If `replaceConflictingLabels`
+     * is true, any existing assignment of the same label to ANOTHER item
+     * under the same product is removed first (atomic swap). If false and
+     * a conflict exists, throws 409 GALLERY_LABEL_ALREADY_TAKEN.
+     */
+    async #applyLabels(em, productId, itemId, labels, options) {
+        if (options.replaceConflictingLabels) {
+            // Remove any other assignment of these labels under the product.
+            const placeholders = labels.map(() => '?').join(', ');
+            await em.execute(`delete from gallery_item_labels
+         where product_id = ? and label in (${placeholders}) and gallery_item_id <> ?`, [productId, ...labels, itemId]);
+        }
+        else {
+            // Fail-fast on any conflict.
+            const placeholders = labels.map(() => '?').join(', ');
+            const conflicts = (await em.execute(`select label, gallery_item_id from gallery_item_labels
+         where product_id = ? and label in (${placeholders}) and gallery_item_id <> ?`, [productId, ...labels, itemId]));
+            if (conflicts.length > 0) {
+                const c = conflicts[0];
+                throw new HttpError(409, ERROR_CODES.GALLERY_LABEL_ALREADY_TAKEN, `Label "${c.label}" is already assigned to gallery item ${c.gallery_item_id}.`, [{ path: 'labels', issue: `currently on ${c.gallery_item_id}` }]);
+            }
+        }
+        // Insert the new assignments. ON CONFLICT (gallery_item_id, label)
+        // DO NOTHING handles the case where the same label is already on
+        // this item (idempotent re-application).
+        const values = labels.map(() => '(?, ?, ?)').join(', ');
+        const params = [];
+        for (const l of labels)
+            params.push(itemId, productId, l);
+        await em.execute(`insert into gallery_item_labels (gallery_item_id, product_id, label) values ${values}
+       on conflict (gallery_item_id, label) do nothing`, params);
+    }
+    async #fetchAllForProduct(em, productId) {
+        const items = await em.find(GalleryItem, { productId }, { orderBy: { position: 'asc', id: 'asc' } });
+        if (items.length === 0)
+            return [];
+        const labels = await em.find(GalleryItemLabel, { productId });
+        const labelsByItem = new Map();
+        for (const l of labels) {
+            const existing = labelsByItem.get(l.galleryItemId) ?? [];
+            existing.push(l.label);
+            labelsByItem.set(l.galleryItemId, existing);
+        }
+        return items.map((i) => this.#toDto(i, labelsByItem.get(i.id) ?? []));
+    }
+    async #fetchOne(em, itemId) {
+        const item = await em.findOne(GalleryItem, { id: itemId });
+        if (!item)
+            return null;
+        const labels = await em.find(GalleryItemLabel, { galleryItemId: itemId });
+        return this.#toDto(item, labels.map((l) => l.label));
+    }
+    #toDto(item, labels) {
+        return {
+            id: item.id,
+            productId: item.productId,
+            assetId: item.assetId,
+            position: item.position,
+            labels: [...labels].sort(),
+            createdAt: item.createdAt.toISOString(),
+            updatedAt: item.updatedAt.toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=gallery.service.js.map

package/dist/backend/services/gallery.service.js.map

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

package/dist/backend/services/grouped.service.d.ts

@@ -0,0 +1,39 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CommandBus } from '@endora-commerce/platform/commands';
+/**
+ * GroupedService — admin CRUD for grouped product children (feature 002
+ * US5, T128). The parent product MUST be `type='grouped'`; children MUST
+ * NOT be `type='grouped'` or `type='bundle'` (research R-8 — no nested
+ * composites, enforced at the service layer because PG CHECK can't JOIN
+ * `products`).
+ */
+export interface GroupedItemRow {
+    id: string;
+    parentProductId: string;
+    childProductId: string;
+    quantity: number;
+    position: number;
+}
+export declare class GroupedService {
+    #private;
+    private readonly emFactory;
+    /** Feature 054 — audits grouped-item writes co-transactionally when provided. */
+    private readonly commandBus?;
+    constructor(emFactory: () => EntityManager, 
+    /** Feature 054 — audits grouped-item writes co-transactionally when provided. */
+    commandBus?: CommandBus | undefined);
+    list(parentProductId: string): Promise<GroupedItemRow[]>;
+    addItem(parentProductId: string, input: {
+        childProductId: string;
+        quantity: number;
+        position?: number | undefined;
+    }): Promise<GroupedItemRow>;
+    updateItem(parentProductId: string, itemId: string, input: {
+        quantity?: number | undefined;
+        position?: number | undefined;
+    }): Promise<GroupedItemRow>;
+    removeItem(parentProductId: string, itemId: string): Promise<void>;
+    private assertGroupedParent;
+    private toRow;
+}
+//# sourceMappingURL=grouped.service.d.ts.map

package/dist/backend/services/grouped.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouped.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/grouped.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAIrE;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAc;;IAEvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAFX,SAAS,EAAE,MAAM,aAAa;IAC/C,iFAAiF;IAChE,UAAU,CAAC,EAAE,UAAU,YAAA;IAsBpC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAWxD,OAAO,CACX,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GACjF,OAAO,CAAC,cAAc,CAAC;IAyEpB,UAAU,CACd,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GACtE,OAAO,CAAC,cAAc,CAAC;IAwBpB,UAAU,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAiB1D,mBAAmB;IAsBjC,OAAO,CAAC,KAAK;CASd"}

package/dist/backend/services/grouped.service.js

@@ -0,0 +1,136 @@
+import { randomUUID } from 'node:crypto';
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { Product } from '../entities/product.entity.js';
+import { GroupedItem } from '../entities/grouped-item.entity.js';
+export class GroupedService {
+    emFactory;
+    commandBus;
+    constructor(emFactory, 
+    /** Feature 054 — audits grouped-item writes co-transactionally when provided. */
+    commandBus) {
+        this.emFactory = emFactory;
+        this.commandBus = commandBus;
+    }
+    /** Feature 054 — run a grouped-item write through the Command Bus. */
+    async #audited(action, objectId, write) {
+        if (this.commandBus) {
+            return this.commandBus.run({ action, objectType: 'grouped_item', objectId, run: ({ em }) => write(em) });
+        }
+        const em = this.emFactory();
+        const w = await write(em);
+        await em.flush();
+        return w.result;
+    }
+    async list(parentProductId) {
+        const em = this.emFactory();
+        await this.assertGroupedParent(em, parentProductId);
+        const rows = await em.find(GroupedItem, { parentProductId }, { orderBy: { position: 'asc', id: 'asc' } });
+        return rows.map((r) => this.toRow(r));
+    }
+    async addItem(parentProductId, input) {
+        const em = this.emFactory();
+        await this.assertGroupedParent(em, parentProductId);
+        if (input.childProductId === parentProductId) {
+            throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, 'A grouped product cannot include itself as a child.');
+        }
+        const child = await em.findOne(Product, { id: input.childProductId });
+        if (!child || child.deletedAt) {
+            throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, `Child product "${input.childProductId}" not found.`);
+        }
+        if (child.type === 'grouped' || child.type === 'bundle') {
+            throw new HttpError(400, ERROR_CODES.NESTED_COMPOSITE_NOT_ALLOWED, `Grouped products cannot include another ${child.type} product as a child.`);
+        }
+        if (input.quantity <= 0) {
+            throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, 'quantity must be positive.');
+        }
+        // Append by default; admin can override.
+        let position = input.position;
+        if (position === undefined) {
+            const tally = await em.find(GroupedItem, { parentProductId });
+            position = tally.reduce((max, r) => Math.max(max, r.position + 1), 0);
+        }
+        const id = randomUUID();
+        const row = await this.#audited('grouped_item.add', id, async (cem) => {
+            const r = cem.create(GroupedItem, {
+                id,
+                parentProductId,
+                childProductId: input.childProductId,
+                quantity: input.quantity,
+                position,
+            });
+            try {
+                await cem.flush();
+            }
+            catch (err) {
+                if (err instanceof Error && /uniq_grouped_items_parent_child/.test(err.message)) {
+                    throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, `Child product "${input.childProductId}" is already in this group.`);
+                }
+                throw err;
+            }
+            return {
+                result: r,
+                before: null,
+                after: {
+                    parentProductId,
+                    childProductId: input.childProductId,
+                    quantity: input.quantity,
+                    position,
+                },
+            };
+        });
+        return this.toRow(row);
+    }
+    async updateItem(parentProductId, itemId, input) {
+        const row = await this.#audited('grouped_item.update', itemId, async (em) => {
+            await this.assertGroupedParent(em, parentProductId);
+            const r = await em.findOne(GroupedItem, { id: itemId, parentProductId });
+            if (!r) {
+                throw new HttpError(404, ERROR_CODES.GROUPED_ITEM_NOT_FOUND, `Grouped item "${itemId}" not found on parent ${parentProductId}.`);
+            }
+            const before = { quantity: r.quantity, position: r.position };
+            if (input.quantity !== undefined) {
+                if (input.quantity <= 0) {
+                    throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, 'quantity must be positive.');
+                }
+                r.quantity = input.quantity;
+            }
+            if (input.position !== undefined)
+                r.position = input.position;
+            return { result: r, before, after: { quantity: r.quantity, position: r.position } };
+        });
+        return this.toRow(row);
+    }
+    async removeItem(parentProductId, itemId) {
+        await this.#audited('grouped_item.delete', itemId, async (em) => {
+            await this.assertGroupedParent(em, parentProductId);
+            const row = await em.findOne(GroupedItem, { id: itemId, parentProductId });
+            if (!row) {
+                throw new HttpError(404, ERROR_CODES.GROUPED_ITEM_NOT_FOUND, `Grouped item "${itemId}" not found on parent ${parentProductId}.`);
+            }
+            const before = { parentProductId, childProductId: row.childProductId };
+            em.remove(row);
+            return { result: undefined, before, after: null };
+        });
+    }
+    async assertGroupedParent(em, parentProductId) {
+        const parent = await em.findOne(Product, { id: parentProductId });
+        if (!parent || parent.deletedAt) {
+            throw new HttpError(404, ERROR_CODES.PRODUCT_NOT_FOUND, `Product "${parentProductId}" not found.`);
+        }
+        if (parent.type !== 'grouped') {
+            throw new HttpError(400, ERROR_CODES.PRODUCT_TYPE_MISMATCH, `Product type is "${parent.type}", expected "grouped".`);
+        }
+        return parent;
+    }
+    toRow(r) {
+        return {
+            id: r.id,
+            parentProductId: r.parentProductId,
+            childProductId: r.childProductId,
+            quantity: r.quantity,
+            position: r.position,
+        };
+    }
+}
+//# sourceMappingURL=grouped.service.js.map

package/dist/backend/services/grouped.service.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * Per-locale label resolver (feature 012 / R-3).
+ *
+ * Reads `label[locale]` from the per-locale JSONB map; falls back to
+ * `labelDefault` when the active locale is missing or the per-locale
+ * value is empty. Locale tags are normalised so `pl_PL` matches a map
+ * keyed `pl-PL` (and vice-versa) and the region tag is matched
+ * case-insensitively.
+ *
+ * The resolver is pure — given the same inputs it returns the same
+ * output. No I/O, no clock, no globals. Used by every storefront +
+ * admin reader that needs the rendered label of an attribute or
+ * option.
+ */
+export declare function resolveLabel(label: Record<string, string> | null | undefined, labelDefault: string, locale: string): string;
+//# sourceMappingURL=label-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"label-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/services/label-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EAChD,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,MAAM,CASR"}

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

@@ -0,0 +1,43 @@
+/**
+ * Per-locale label resolver (feature 012 / R-3).
+ *
+ * Reads `label[locale]` from the per-locale JSONB map; falls back to
+ * `labelDefault` when the active locale is missing or the per-locale
+ * value is empty. Locale tags are normalised so `pl_PL` matches a map
+ * keyed `pl-PL` (and vice-versa) and the region tag is matched
+ * case-insensitively.
+ *
+ * The resolver is pure — given the same inputs it returns the same
+ * output. No I/O, no clock, no globals. Used by every storefront +
+ * admin reader that needs the rendered label of an attribute or
+ * option.
+ */
+export function resolveLabel(label, labelDefault, locale) {
+    if (!label)
+        return labelDefault;
+    const wantedKeys = normaliseLocaleVariants(locale);
+    const lookup = buildKeyLookup(label);
+    for (const key of wantedKeys) {
+        const hit = lookup.get(key);
+        if (hit !== undefined && hit !== '')
+            return hit;
+    }
+    return labelDefault;
+}
+function normaliseLocaleVariants(locale) {
+    if (!locale)
+        return [];
+    const lower = locale.toLowerCase();
+    // Generate the four common spellings: as-is, lower-case, dash↔underscore variants.
+    const variants = new Set([locale, lower, lower.replace('_', '-'), lower.replace('-', '_')]);
+    return [...variants];
+}
+function buildKeyLookup(label) {
+    const out = new Map();
+    for (const [key, value] of Object.entries(label)) {
+        out.set(key, value);
+        out.set(key.toLowerCase(), value);
+    }
+    return out;
+}
+//# sourceMappingURL=label-resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"label-resolver.js","sourceRoot":"","sources":["../../../src/backend/services/label-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAgD,EAChD,YAAoB,EACpB,MAAc;IAEd,IAAI,CAAC,KAAK;QAAE,OAAO,YAAY,CAAC;IAChC,MAAM,UAAU,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;YAAE,OAAO,GAAG,CAAC;IAClD,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc;IAC7C,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,mFAAmF;IACnF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACpG,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,cAAc,CAAC,KAA6B;IACnD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACpB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/backend/services/packaging-unit.service.d.ts

@@ -0,0 +1,28 @@
+/**
+ * PackagingUnitService — admin CRUD for product packaging units (feature 043).
+ *
+ * A packaging unit is a named ordering unit on a product (e.g. "Paleta" = 480
+ * pieces). Units apply only to physical, purchasable product types
+ * (simple / configurable). At most one unit per product is the default
+ * presented on the storefront; setting a new default clears the previous one
+ * (last write wins). Names are unique within a product. Hard delete is safe
+ * because cart/order/RFQ lines snapshot their own copy.
+ */
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type CreatePackagingUnitRequest, type PackagingUnitDto, type ReorderPackagingUnitsRequest, type UpdatePackagingUnitRequest } from '@endora-commerce/contracts';
+import type { CommandBus } from '@endora-commerce/platform/commands';
+export declare class PackagingUnitService {
+    #private;
+    private readonly emFactory;
+    /** Feature 054 — audits packaging-unit writes co-transactionally when provided. */
+    private readonly commandBus?;
+    constructor(emFactory: () => EntityManager, 
+    /** Feature 054 — audits packaging-unit writes co-transactionally when provided. */
+    commandBus?: CommandBus | undefined);
+    list(productId: string): Promise<PackagingUnitDto[]>;
+    create(productId: string, req: CreatePackagingUnitRequest): Promise<PackagingUnitDto>;
+    update(productId: string, unitId: string, req: UpdatePackagingUnitRequest): Promise<PackagingUnitDto>;
+    delete(productId: string, unitId: string): Promise<void>;
+    reorder(productId: string, req: ReorderPackagingUnitsRequest): Promise<PackagingUnitDto[]>;
+}
+//# sourceMappingURL=packaging-unit.service.d.ts.map

package/dist/backend/services/packaging-unit.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packaging-unit.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/packaging-unit.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAChC,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAYrE,qBAAa,oBAAoB;;IAE7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,mFAAmF;IACnF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAFX,SAAS,EAAE,MAAM,aAAa;IAC/C,mFAAmF;IAClE,UAAU,CAAC,EAAE,UAAU,YAAA;IA0BpC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAWpD,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,0BAA0B,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IA4BtB,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,0BAA0B,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IAuBtB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxD,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,4BAA4B,GAChC,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAqH/B"}