@endora-commerce/mod-catalog 0.100.0

package/dist/backend/services/category-admin.service.js

@@ -0,0 +1,271 @@
+import { randomUUID } from 'node:crypto';
+import { UniqueConstraintViolationException } from '@mikro-orm/core';
+import { ERROR_CODES, isCustomFieldValidationFailure, } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { Category } from '../entities/category.entity.js';
+function categoryUpdatedEvent(categoryId) {
+    return {
+        eventName: 'category.updated.v1',
+        payload: {
+            eventId: randomUUID(),
+            occurredAt: new Date().toISOString(),
+            categoryId,
+        },
+    };
+}
+export class CategoryAdminService {
+    emFactory;
+    salesChannelMembership;
+    commandBus;
+    customFieldValues;
+    events;
+    constructor(emFactory, 
+    /**
+     * Feature 005 / T027b — when injected, every newly-created Category
+     * that does not declare explicit channel membership lands in the
+     * system-default Sales Channel automatically (FR-011). Optional so
+     * existing tests that construct this service without sales-channels
+     * keep compiling; production composition.ts always provides it.
+     */
+    salesChannelMembership, 
+    /** Feature 054 — audits category writes co-transactionally when provided. */
+    commandBus, 
+    /** Feature 055 — validates + merges custom-field values on category write. */
+    customFieldValues, 
+    /**
+     * Feature 068 — publishes `category.updated.v1`. Only consulted on the
+     * bus-less fallback path: when a Command Bus is injected it dispatches the
+     * command's event itself, on commit.
+     */
+    events) {
+        this.emFactory = emFactory;
+        this.salesChannelMembership = salesChannelMembership;
+        this.commandBus = commandBus;
+        this.customFieldValues = customFieldValues;
+        this.events = events;
+    }
+    /** Validate + merge a custom-field patch, mapping validation errors to HTTP 422. */
+    async #mergeCustomFields(current, patch) {
+        if (!this.customFieldValues)
+            return current;
+        try {
+            return await this.customFieldValues.validateAndMerge('category', current ?? {}, patch);
+        }
+        catch (err) {
+            // Feature 075 — narrowed structurally, not by `instanceof` on
+            // `custom_fields`' class. The guard tests `name` and the `errors`
+            // array, which is what still works once each module is its own npm
+            // package; and the re-throw below stays unconditional, so a
+            // `ModuleDisabledError` from the port leaves through it.
+            if (isCustomFieldValidationFailure(err)) {
+                throw new HttpError(422, ERROR_CODES.CUSTOM_FIELD_VALUE_INVALID, 'One or more custom fields are invalid.', err.errors.map((e) => ({ path: e.field, issue: e.message })));
+            }
+            throw err;
+        }
+    }
+    /**
+     * Feature 054 — run a category write through the Command Bus (co-transactional
+     * audit) or a plain forked em (bus-less tests). `write` performs the mutation
+     * on the given em and returns the entity + before/after snapshot.
+     */
+    async #audited(action, objectId, write) {
+        if (this.commandBus) {
+            // The event is declared per run, so `event()` can hand the bus whatever
+            // the closure produced. Captured here rather than on the entity because
+            // the bus dispatches it after the transaction commits.
+            let declared;
+            return this.commandBus.run({
+                action,
+                objectType: 'category',
+                objectId,
+                run: async ({ em }) => {
+                    const w = await write(em);
+                    declared = w.event;
+                    return {
+                        result: w.result,
+                        before: w.before,
+                        after: w.after,
+                        ...(w.skipAudit ? { skipAudit: true } : {}),
+                    };
+                },
+                event: () => declared,
+            });
+        }
+        const em = this.emFactory();
+        const w = await write(em);
+        await em.flush(); // no-op when the closure already flushed (create/update)
+        if (w.event) {
+            this.events?.emit(w.event.eventName, w.event.payload);
+        }
+        return w.result;
+    }
+    async listAll() {
+        const em = this.emFactory();
+        return em.find(Category, { deletedAt: null }, { orderBy: { sortOrder: 'asc', slug: 'asc' } });
+    }
+    async create(input) {
+        const id = randomUUID();
+        const cat = await this.#audited('category.create', id, async (em) => {
+            if (input.parentCategoryId)
+                await this.#assertParentExists(em, input.parentCategoryId);
+            const created = em.create(Category, {
+                id,
+                ...(input.parentCategoryId !== undefined
+                    ? { parentCategoryId: input.parentCategoryId }
+                    : {}),
+                name: input.name,
+                slug: input.slug,
+                sortOrder: input.sortOrder ?? 0,
+                // Feature 068 — omitted means active (the column default).
+                ...(input.isActive !== undefined ? { isActive: input.isActive } : {}),
+            });
+            try {
+                await em.flush();
+            }
+            catch (err) {
+                if (err instanceof UniqueConstraintViolationException) {
+                    throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, `Slug "${input.slug}" already exists under this parent.`);
+                }
+                throw err;
+            }
+            return {
+                result: created,
+                before: null,
+                after: {
+                    name: created.name,
+                    slug: created.slug,
+                    parentCategoryId: created.parentCategoryId ?? null,
+                    sortOrder: created.sortOrder,
+                    isActive: created.isActive,
+                },
+            };
+        });
+        // Feature 005 / FR-011 — bind to Default unless this category was
+        // already given memberships through some other path.
+        if (this.salesChannelMembership) {
+            await this.salesChannelMembership.bindToDefaultIfEmpty('category', cat.id);
+        }
+        return cat;
+    }
+    async update(id, input) {
+        return this.#audited('category.update', id, async (em) => {
+            const cat = await em.findOne(Category, { id, deletedAt: null });
+            if (!cat)
+                throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Category not found.');
+            const before = {
+                name: cat.name,
+                slug: cat.slug,
+                parentCategoryId: cat.parentCategoryId ?? null,
+                sortOrder: cat.sortOrder,
+                isActive: cat.isActive,
+            };
+            if (input.parentCategoryId !== undefined) {
+                if (input.parentCategoryId !== null) {
+                    await this.#assertParentExists(em, input.parentCategoryId);
+                    await this.#assertNoCycle(em, id, input.parentCategoryId);
+                }
+                cat.parentCategoryId = input.parentCategoryId;
+            }
+            if (input.name !== undefined)
+                cat.name = input.name;
+            if (input.slug !== undefined)
+                cat.slug = input.slug;
+            if (input.sortOrder !== undefined)
+                cat.sortOrder = input.sortOrder;
+            if (input.isActive !== undefined)
+                cat.isActive = input.isActive;
+            if (input.mainImageAssetId !== undefined)
+                cat.mainImageAssetId = input.mainImageAssetId;
+            if (input.customFieldValues !== undefined) {
+                cat.customFieldValues = await this.#mergeCustomFields(cat.customFieldValues ?? {}, input.customFieldValues);
+            }
+            try {
+                await em.flush();
+            }
+            catch (err) {
+                if (err instanceof UniqueConstraintViolationException) {
+                    throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, 'Another category already uses this slug under that parent.');
+                }
+                throw err;
+            }
+            return {
+                result: cat,
+                before,
+                after: {
+                    name: cat.name,
+                    slug: cat.slug,
+                    parentCategoryId: cat.parentCategoryId ?? null,
+                    sortOrder: cat.sortOrder,
+                    isActive: cat.isActive,
+                },
+                // Feature 068 — the subtree's products carry this category's slug and
+                // (through the activation flag) their reachability, so every update
+                // has to reach the search index.
+                event: categoryUpdatedEvent(cat.id),
+            };
+        });
+    }
+    async softDelete(id) {
+        await this.#audited('category.delete', id, async (em) => {
+            const cat = await em.findOne(Category, { id, deletedAt: null });
+            if (!cat)
+                throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Category not found.');
+            const childCount = await em.count(Category, { parentCategoryId: id, deletedAt: null });
+            if (childCount > 0) {
+                throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, `Cannot delete: ${childCount} child category(ies) still attached. Move or delete them first.`);
+            }
+            cat.deletedAt = new Date();
+            return { result: cat, before: { name: cat.name, slug: cat.slug }, after: { deletedAt: cat.deletedAt } };
+        });
+    }
+    /**
+     * Set the inventory display-band thresholds on a category (feature 075,
+     * Phase C — published as `catalogCategoryWritePort.setInventoryThresholds`).
+     *
+     * `inventory` owns the meaning of these three columns and stored them here
+     * because the storefront resolver reads them alongside the category row. It
+     * wrote them by importing `Category`; this is the same write, on this side of
+     * the boundary, and deliberately the same write and no more: no Command, no
+     * `category.updated.v1`, no `category.update` audit row. The caller records
+     * one `low_stock_threshold.update` summary row for the whole patch, and
+     * routing this through {@link update} would give an operator reading a
+     * category's history a second, differently-named entry for the same act.
+     */
+    async setInventoryThresholds(id, patch) {
+        // command-coverage-ignore: three threshold columns on a category row, audited
+        // by the caller as one `low_stock_threshold.update` summary — see the doc
+        // comment above and `ThresholdAdminService.patch`.
+        const em = this.emFactory();
+        const cat = await em.findOne(Category, { id, deletedAt: null });
+        if (!cat)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Category ${id} not found`);
+        if (patch.high !== undefined)
+            cat.inventoryThresholdHigh = patch.high;
+        if (patch.medium !== undefined)
+            cat.inventoryThresholdMedium = patch.medium;
+        if (patch.low !== undefined)
+            cat.inventoryThresholdLow = patch.low;
+        await em.flush();
+    }
+    async #assertParentExists(em, parentId) {
+        const exists = await em.count(Category, { id: parentId, deletedAt: null });
+        if (exists === 0) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Parent category not found.');
+        }
+    }
+    async #assertNoCycle(em, movedId, newParentId) {
+        let cursor = newParentId;
+        const seen = new Set();
+        while (cursor) {
+            if (cursor === movedId) {
+                throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, 'Cannot move category beneath one of its descendants.');
+            }
+            if (seen.has(cursor))
+                break; // defensive guard against pre-existing cycles
+            seen.add(cursor);
+            const parent = await em.findOne(Category, { id: cursor });
+            cursor = parent?.parentCategoryId ?? null;
+        }
+    }
+}
+//# sourceMappingURL=category-admin.service.js.map

package/dist/backend/services/category-admin.service.js.map

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

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

@@ -0,0 +1,85 @@
+/**
+ * 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 type { EntityManager } from '@mikro-orm/postgresql';
+import { type AssetReadPort, type CatalogGalleryBatchItem, type GalleryItem as GalleryItemDto, type CreateGalleryItemRequest, type UpdateGalleryItemRequest } from '@endora-commerce/contracts';
+import type { CommandBus } from '@endora-commerce/platform/commands';
+export interface GalleryServiceOptions {
+    /** When true, conflicting labels on other items are silently moved. */
+    replaceConflictingLabels: boolean;
+}
+export declare class GalleryService {
+    #private;
+    private readonly emFactory;
+    /** Feature 054 — audits gallery-item writes co-transactionally when provided. */
+    private readonly 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.
+     */
+    private readonly assets?;
+    constructor(emFactory: () => EntityManager, 
+    /** Feature 054 — audits gallery-item writes co-transactionally when provided. */
+    commandBus?: CommandBus | undefined, 
+    /**
+     * 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?: AssetReadPort | undefined);
+    list(productId: string): Promise<GalleryItemDto[]>;
+    /**
+     * 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.
+     */
+    listForProducts(productIds: readonly string[]): Promise<CatalogGalleryBatchItem[]>;
+    /**
+     * 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.
+     */
+    baseImageUrls(productIds: readonly string[]): Promise<Map<string, string | null>>;
+    create(productId: string, req: CreateGalleryItemRequest, options: GalleryServiceOptions): Promise<GalleryItemDto>;
+    update(productId: string, itemId: string, req: UpdateGalleryItemRequest, options: GalleryServiceOptions): Promise<GalleryItemDto>;
+    delete(productId: string, itemId: string): Promise<void>;
+    reorder(productId: string, orderedIds: string[]): Promise<void>;
+}
+//# sourceMappingURL=gallery.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gallery.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/gallery.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,IAAI,cAAc,EAElC,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAYrE,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAED,qBAAa,cAAc;;IAEvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC5B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBATP,SAAS,EAAE,MAAM,aAAa;IAC/C,iFAAiF;IAChE,UAAU,CAAC,EAAE,UAAU,YAAA;IACxC;;;;;OAKG;IACc,MAAM,CAAC,EAAE,aAAa,YAAA;IAmCnC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAMxD;;;;;;;;;;;;;;OAcG;IACG,eAAe,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAuBxF;;;;;;;;;;;;;;;;;;;OAmBG;IACG,aAAa,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAiCjF,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,wBAAwB,EAC7B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC;IAuCpB,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,wBAAwB,EAC7B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC;IA4BpB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA0KtE"}