@endora-commerce/mod-catalog 0.100.0

package/dist/backend/services/catalog-bulk-update.service.d.ts

@@ -0,0 +1,91 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type BulkUpdateProductsRequest } from '@endora-commerce/contracts';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import type { SalesChannelMembershipPort } from '@endora-commerce/platform/kernel';
+import type { CatalogAdminService } from './catalog-admin.service.js';
+import { type AdminAuditContext } from './catalog-admin.service.js';
+/**
+ * Feature 022 — Products Bulk Edit.
+ *
+ * Composes existing module-public services to apply a sparse field-patch
+ * to a selection of products and report a per-product outcome. Honours:
+ *
+ *  - Per-product atomicity (each product writes inside its own transaction).
+ *  - No batch abort: a single failure does NOT roll back other products.
+ *  - One summary `audit_logs` row per bulk operation; per-product audit
+ *    rows are emitted by `CatalogAdminService.updateProduct` as before.
+ */
+export interface BulkUpdateOutcome {
+    productId: string;
+    status: 'succeeded' | 'skipped' | 'failed';
+    reason?: 'attribute_not_in_set' | 'validation_failed' | 'permission_denied' | 'concurrent_modification' | 'product_not_found';
+    details?: {
+        code?: string;
+        message?: string;
+        attribute?: string;
+    };
+    changedFields?: string[];
+}
+export interface BulkUpdateResult {
+    bulkOperationId: string;
+    summary: {
+        succeeded: number;
+        skipped: number;
+        failed: number;
+        total: number;
+    };
+    results: BulkUpdateOutcome[];
+}
+export interface BulkUpdateProgress {
+    processed: number;
+    total: number;
+    succeeded: number;
+    skipped: number;
+    failed: number;
+}
+export interface BulkUpdateOptions {
+    /**
+     * Skip the synchronous MAX_BATCH_SIZE guard. Set by the queued worker
+     * path, which is allowed to process arbitrarily large selections off
+     * the request thread.
+     */
+    skipBatchLimit?: boolean;
+    /**
+     * Invoked periodically (every {@link PROGRESS_REPORT_EVERY} products and
+     * once at the end) so the worker can persist live progress counters.
+     */
+    onProgress?: (progress: BulkUpdateProgress) => Promise<void> | void;
+}
+export declare class CatalogBulkUpdateService {
+    private readonly emFactory;
+    private readonly catalogAdmin;
+    private readonly salesChannelMembership?;
+    private readonly auditLog?;
+    constructor(emFactory: () => EntityManager, catalogAdmin: CatalogAdminService, salesChannelMembership?: SalesChannelMembershipPort | undefined, auditLog?: AuditPort | undefined);
+    /**
+     * Apply `req.fields` to every product in `req.productIds`.
+     *
+     * Pre-flight (rejects whole request):
+     *   - productIds.length > 200            → BULK_TOO_LARGE
+     *   - attributeValues key not flagged    → ATTRIBUTE_NOT_MASS_EDITABLE
+     *     mass_editable=true
+     *
+     * Per-product outcomes:
+     *   - succeeded                          → all touched fields applied
+     *   - skipped, product_not_found         → product id missing in DB
+     *   - skipped, attribute_not_in_set      → one of the requested
+     *                                          attribute keys is not in
+     *                                          the product's attribute set
+     *                                          AND no other field changed
+     *   - failed,  validation_failed         → any other write rejection
+     */
+    bulkUpdate(req: BulkUpdateProductsRequest, auditCtx?: AdminAuditContext, opts?: BulkUpdateOptions): Promise<BulkUpdateResult>;
+    private assertAllAttributesAreMassEditable;
+    private applyToOneProduct;
+    private classifyPerProductError;
+    private readCurrentCategoryIds;
+    private readAllowedAttributeKeys;
+    private applySalesChannels;
+    private recordSummaryAudit;
+}
+//# sourceMappingURL=catalog-bulk-update.service.d.ts.map

package/dist/backend/services/catalog-bulk-update.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-bulk-update.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/catalog-bulk-update.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAe,KAAK,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAGzF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAC,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3C,MAAM,CAAC,EACH,sBAAsB,GACtB,mBAAmB,GACnB,mBAAmB,GACnB,yBAAyB,GACzB,mBAAmB,CAAC;IACxB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAOD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrE;AAED,qBAAa,wBAAwB;IAEjC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAHT,SAAS,EAAE,MAAM,aAAa,EAC9B,YAAY,EAAE,mBAAmB,EACjC,sBAAsB,CAAC,EAAE,0BAA0B,YAAA,EACnD,QAAQ,CAAC,EAAE,SAAS,YAAA;IAGvC;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CACd,GAAG,EAAE,yBAAyB,EAC9B,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,IAAI,CAAC,EAAE,iBAAiB,GACvB,OAAO,CAAC,gBAAgB,CAAC;YA8Dd,kCAAkC;YAkBlC,iBAAiB;IA8I/B,OAAO,CAAC,uBAAuB;YA2BjB,sBAAsB;YAetB,wBAAwB;YAwBxB,kBAAkB;YAqClB,kBAAkB;CA+BjC"}

package/dist/backend/services/catalog-bulk-update.service.js

@@ -0,0 +1,330 @@
+import { randomUUID } from 'crypto';
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { rethrowIfModuleDisabled } from '@endora-commerce/platform/kernel';
+import {} from './catalog-admin.service.js';
+import { Product } from '../entities/product.entity.js';
+const MAX_BATCH_SIZE = 200;
+const RECOMMENDED_SPLIT_INTO = 100;
+/** How often the async worker path is told how far the run has progressed. */
+const PROGRESS_REPORT_EVERY = 25;
+export class CatalogBulkUpdateService {
+    emFactory;
+    catalogAdmin;
+    salesChannelMembership;
+    auditLog;
+    constructor(emFactory, catalogAdmin, salesChannelMembership, auditLog) {
+        this.emFactory = emFactory;
+        this.catalogAdmin = catalogAdmin;
+        this.salesChannelMembership = salesChannelMembership;
+        this.auditLog = auditLog;
+    }
+    /**
+     * Apply `req.fields` to every product in `req.productIds`.
+     *
+     * Pre-flight (rejects whole request):
+     *   - productIds.length > 200            → BULK_TOO_LARGE
+     *   - attributeValues key not flagged    → ATTRIBUTE_NOT_MASS_EDITABLE
+     *     mass_editable=true
+     *
+     * Per-product outcomes:
+     *   - succeeded                          → all touched fields applied
+     *   - skipped, product_not_found         → product id missing in DB
+     *   - skipped, attribute_not_in_set      → one of the requested
+     *                                          attribute keys is not in
+     *                                          the product's attribute set
+     *                                          AND no other field changed
+     *   - failed,  validation_failed         → any other write rejection
+     */
+    async bulkUpdate(req, auditCtx, opts) {
+        // The synchronous request path caps the selection at MAX_BATCH_SIZE so a
+        // single HTTP call never blocks on thousands of writes. The asynchronous
+        // worker path (queued bulk operations) passes `skipBatchLimit` because it
+        // already chunks progress reporting and runs off the request thread.
+        if (!opts?.skipBatchLimit && req.productIds.length > MAX_BATCH_SIZE) {
+            throw new HttpError(400, ERROR_CODES.BULK_TOO_LARGE, `productIds.length=${req.productIds.length} exceeds maxBatchSize=${MAX_BATCH_SIZE}`, { maxBatchSize: MAX_BATCH_SIZE, recommendedSplitInto: RECOMMENDED_SPLIT_INTO });
+        }
+        // Pre-flight: every attributeValues key MUST be flagged mass_editable=true.
+        // This is a client-side bug (the dialog should never offer a non-flagged
+        // attribute), so the whole batch is rejected before any per-product write.
+        if (req.fields.attributeValues && Object.keys(req.fields.attributeValues).length > 0) {
+            await this.assertAllAttributesAreMassEditable(Object.keys(req.fields.attributeValues));
+        }
+        const bulkOperationId = randomUUID();
+        const results = [];
+        const total = req.productIds.length;
+        let processed = 0;
+        let succeeded = 0;
+        let skipped = 0;
+        let failed = 0;
+        for (const productId of req.productIds) {
+            const outcome = await this.applyToOneProduct(productId, req, auditCtx);
+            results.push(outcome);
+            processed += 1;
+            if (outcome.status === 'succeeded')
+                succeeded += 1;
+            else if (outcome.status === 'skipped')
+                skipped += 1;
+            else
+                failed += 1;
+            if (opts?.onProgress &&
+                (processed % PROGRESS_REPORT_EVERY === 0 || processed === total)) {
+                await opts.onProgress({ processed, total, succeeded, skipped, failed });
+            }
+        }
+        const summary = {
+            succeeded: results.filter((r) => r.status === 'succeeded').length,
+            skipped: results.filter((r) => r.status === 'skipped').length,
+            failed: results.filter((r) => r.status === 'failed').length,
+            total: results.length,
+        };
+        await this.recordSummaryAudit(bulkOperationId, req, results, summary, auditCtx);
+        return { bulkOperationId, summary, results };
+    }
+    // --------------------------------------------------------------------
+    // Internal helpers
+    // --------------------------------------------------------------------
+    async assertAllAttributesAreMassEditable(keys) {
+        // Feature 061 — the flag lives on the extension; the key on the definition.
+        // Read through the composed view (catalog's sanctioned attribute read).
+        const views = await this.catalogAdmin.listAttributes();
+        const byKey = new Map(views.map((v) => [v.key, v]));
+        for (const key of keys) {
+            const view = byKey.get(key);
+            if (!view || !view.massEditable) {
+                throw new HttpError(400, ERROR_CODES.ATTRIBUTE_NOT_MASS_EDITABLE, `attribute_not_mass_editable`, { attribute: key });
+            }
+        }
+    }
+    async applyToOneProduct(productId, req, auditCtx) {
+        const em = this.emFactory();
+        const product = await em.findOne(Product, { id: productId });
+        if (!product) {
+            return { productId, status: 'skipped', reason: 'product_not_found' };
+        }
+        // Partition attributeValues into those allowed for the product's set
+        // and those that must be skipped. Build the partial UpdateProductRequest.
+        const fields = req.fields;
+        const partial = {};
+        let touchedAny = false;
+        let attributeSkipReason = null;
+        if (fields.status !== undefined) {
+            partial.status = fields.status;
+            touchedAny = true;
+        }
+        if (fields.visibility !== undefined) {
+            partial.visibility = fields.visibility;
+            touchedAny = true;
+        }
+        // Attribute Set — assign (or clear, with null) on every selected product.
+        if (fields.attributeSetId !== undefined) {
+            partial.attributeSetId = fields.attributeSetId;
+            touchedAny = true;
+        }
+        // Categories — translate {mode, categoryIds} into the partial's
+        // categoryIds field (which the single-product PATCH treats as the
+        // canonical set when present). For `add` mode, union the target with
+        // current memberships before passing through.
+        if (fields.categories) {
+            if (fields.categories.mode === 'replace') {
+                partial.categoryIds = fields.categories.categoryIds;
+            }
+            else if (fields.categories.mode === 'remove') {
+                const current = await this.readCurrentCategoryIds(em, productId);
+                const toRemove = new Set(fields.categories.categoryIds);
+                partial.categoryIds = current.filter((id) => !toRemove.has(id));
+            }
+            else {
+                const current = await this.readCurrentCategoryIds(em, productId);
+                const union = Array.from(new Set([...current, ...fields.categories.categoryIds]));
+                partial.categoryIds = union;
+            }
+            touchedAny = true;
+        }
+        // Attribute values — drop keys that are not in this product's set;
+        // surface a skip reason if NO other field is being touched and EVERY
+        // attribute write would be dropped.
+        if (fields.attributeValues && Object.keys(fields.attributeValues).length > 0) {
+            const allowedKeys = await this.readAllowedAttributeKeys(em, product.attributeSetId);
+            const allowed = {};
+            const dropped = [];
+            for (const [k, v] of Object.entries(fields.attributeValues)) {
+                if (allowedKeys.has(k)) {
+                    allowed[k] = v;
+                }
+                else {
+                    dropped.push(k);
+                }
+            }
+            if (Object.keys(allowed).length > 0) {
+                partial.attributeValues = allowed;
+                touchedAny = true;
+            }
+            if (dropped.length > 0 &&
+                Object.keys(allowed).length === 0 &&
+                fields.status === undefined &&
+                fields.visibility === undefined &&
+                fields.categories === undefined &&
+                fields.salesChannels === undefined &&
+                fields.attributeSetId === undefined) {
+                // Nothing else to do for this product and at least one attribute
+                // was skipped — report skip with the first dropped key for
+                // visibility in the response.
+                attributeSkipReason = { attribute: dropped[0] };
+            }
+        }
+        // Apply updateProduct (status / visibility / categories / attributeValues).
+        let changedFields = [];
+        if (touchedAny) {
+            try {
+                await this.catalogAdmin.updateProduct(productId, partial, auditCtx);
+                // The service tracks changedFields internally; from the caller's
+                // perspective we report the set of fields we *attempted* to write
+                // (the audit row has the canonical changedFields).
+                changedFields = Object.keys(partial);
+            }
+            catch (err) {
+                return this.classifyPerProductError(productId, err);
+            }
+        }
+        // Sales channels run AFTER updateProduct because they live on a
+        // different bridge table and use a dedicated service.
+        if (fields.salesChannels && this.salesChannelMembership) {
+            try {
+                const changed = await this.applySalesChannels(productId, fields.salesChannels.mode, fields.salesChannels.channelIds);
+                if (changed) {
+                    changedFields = Array.from(new Set([...changedFields, 'salesChannels']));
+                }
+            }
+            catch (err) {
+                return this.classifyPerProductError(productId, err);
+            }
+        }
+        if (changedFields.length === 0 && attributeSkipReason) {
+            return {
+                productId,
+                status: 'skipped',
+                reason: 'attribute_not_in_set',
+                details: attributeSkipReason,
+            };
+        }
+        return {
+            productId,
+            status: 'succeeded',
+            changedFields,
+            // Surface the skipped attribute when other fields *did* succeed —
+            // not strictly required by the contract but useful to the admin.
+            ...(attributeSkipReason
+                ? { details: { ...attributeSkipReason, message: 'attribute_not_in_set' } }
+                : {}),
+        };
+    }
+    classifyPerProductError(productId, err) {
+        // The per-product tolerance is right — one product that fails validation
+        // must not abandon the other 4 999 — but a presence answer is not per
+        // product. `ModuleDisabledError` is an `HttpError`, so without this line it
+        // classified as `validation_failed` on every row, and the report read as a
+        // data problem in the catalogue rather than a module that is off. Placed
+        // here rather than at the two call sites so a third one inherits it.
+        rethrowIfModuleDisabled(err);
+        if (err instanceof HttpError) {
+            if (err.code === ERROR_CODES.PRODUCT_NOT_FOUND) {
+                return { productId, status: 'skipped', reason: 'product_not_found' };
+            }
+            return {
+                productId,
+                status: 'failed',
+                reason: 'validation_failed',
+                details: { code: err.code, message: err.message },
+            };
+        }
+        return {
+            productId,
+            status: 'failed',
+            reason: 'validation_failed',
+            details: { message: err instanceof Error ? err.message : String(err) },
+        };
+    }
+    async readCurrentCategoryIds(em, productId) {
+        const rows = await em
+            .getConnection()
+            .execute(`select category_id from product_categories where product_id = ?`, [productId], 'all', em.getTransactionContext());
+        return rows.map((r) => r.category_id);
+    }
+    async readAllowedAttributeKeys(em, attributeSetId) {
+        // Feature 061 — set membership is definition-keyed; keys come from the
+        // composed view.
+        const rows = await em
+            .getConnection()
+            .execute(`select custom_field_definition_id from attribute_set_attributes ` +
+            `where attribute_set_id = ?`, [attributeSetId], 'all', em.getTransactionContext());
+        const views = await this.catalogAdmin.listAttributes();
+        const keyByDefinitionId = new Map(views.map((v) => [v.customFieldDefinitionId, v.key]));
+        return new Set(rows
+            .map((r) => keyByDefinitionId.get(r.custom_field_definition_id))
+            .filter((k) => k !== undefined));
+    }
+    async applySalesChannels(productId, mode, targetChannelIds) {
+        const svc = this.salesChannelMembership;
+        const current = await svc.listChannelsForEntity('product', productId);
+        const currentIds = new Set(current.map((c) => c.id));
+        const targetSet = new Set(targetChannelIds);
+        let changed = false;
+        if (mode === 'add') {
+            for (const id of targetChannelIds) {
+                if (!currentIds.has(id)) {
+                    const r = await svc.addToChannel(id, 'product', productId);
+                    if (r.changed)
+                        changed = true;
+                }
+            }
+        }
+        else {
+            // replace
+            for (const id of targetChannelIds) {
+                if (!currentIds.has(id)) {
+                    const r = await svc.addToChannel(id, 'product', productId);
+                    if (r.changed)
+                        changed = true;
+                }
+            }
+            for (const id of currentIds) {
+                if (!targetSet.has(id)) {
+                    const r = await svc.removeFromChannel(id, 'product', productId, {
+                        fallbackToDefault: true,
+                    });
+                    if (r.changed)
+                        changed = true;
+                }
+            }
+        }
+        return changed;
+    }
+    async recordSummaryAudit(bulkOperationId, req, results, summary, auditCtx) {
+        if (!this.auditLog || !auditCtx)
+            return;
+        await this.auditLog.record({
+            actorAdminUserId: auditCtx.actorAdminUserId,
+            ...(auditCtx.impersonatedCustomerAccountId !== undefined
+                ? { impersonatedCustomerAccountId: auditCtx.impersonatedCustomerAccountId }
+                : {}),
+            action: 'product.bulk_update',
+            objectType: 'bulk_operation',
+            objectId: bulkOperationId,
+            stateAfter: {
+                selectionIds: req.productIds,
+                touchedFields: Object.entries(req.fields)
+                    .filter(([, v]) => v !== undefined)
+                    .map(([k]) => k),
+                categoryMode: req.fields.categories?.mode ?? null,
+                salesChannelMode: req.fields.salesChannels?.mode ?? null,
+                resultsSummary: summary,
+                perProductOutcomes: results,
+            },
+            ...(auditCtx.ipAddress !== undefined ? { ipAddress: auditCtx.ipAddress } : {}),
+            ...(auditCtx.userAgent !== undefined ? { userAgent: auditCtx.userAgent } : {}),
+            ...(auditCtx.requestId !== undefined ? { requestId: auditCtx.requestId } : {}),
+        });
+    }
+}
+//# sourceMappingURL=catalog-bulk-update.service.js.map

package/dist/backend/services/catalog-bulk-update.service.js.map

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

package/dist/backend/services/catalog-category-read.service.d.ts

@@ -0,0 +1,66 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CatalogCategoryAssignmentRecord, CatalogCategoryProductCount, CatalogCategoryReadPort, CatalogCategoryRecord } from '@endora-commerce/contracts';
+import { Category } from '../entities/category.entity.js';
+export declare class CatalogCategoryReadService implements CatalogCategoryReadPort {
+    private readonly emFactory;
+    constructor(emFactory: () => EntityManager);
+    findById(id: string, options?: {
+        liveOnly?: boolean;
+    }): Promise<CatalogCategoryRecord | null>;
+    findByIds(ids: readonly string[], options?: {
+        liveOnly?: boolean;
+    }): Promise<CatalogCategoryRecord[]>;
+    findBySlug(slug: string): Promise<CatalogCategoryRecord | null>;
+    countByIds(ids: readonly string[]): Promise<number>;
+    listAll(options?: {
+        liveOnly?: boolean;
+    }): Promise<CatalogCategoryRecord[]>;
+    listWithInventoryThresholds(): Promise<CatalogCategoryRecord[]>;
+    ancestorsOf(categoryId: string): Promise<CatalogCategoryRecord[]>;
+    /**
+     * Feature 075 / D-87 — the `product_categories` bridge, which has no entity
+     * class and was therefore joined in raw SQL by whoever needed it. `search`
+     * ran this statement three times from inside its indexer.
+     *
+     * `em.execute` rather than `getConnection().execute`: the two are the same
+     * outside a transaction and only the first joins one when the caller has it
+     * open (issue #200).
+     */
+    listAssignmentsForProducts(productIds: readonly string[], options?: {
+        activeOnly?: boolean;
+    }): Promise<CatalogCategoryAssignmentRecord[]>;
+    /**
+     * One recursive query rather than a query per level: a subtree re-projection
+     * runs on every category write, and the depth of the tree is data.
+     *
+     * No `is_active` / `deleted_at` filter anywhere in the walk — see the port's
+     * contract. The caller re-projects *because* a category changed, and a
+     * deactivation is the change that matters most.
+     */
+    listProductIdsInSubtree(categoryId: string): Promise<string[]>;
+    /**
+     * The selection walk — see the port's contract for why it is not a batched
+     * {@link listProductIdsInSubtree}. It skips soft-deleted categories and it
+     * tolerates a cycle; the structural read above does neither, deliberately.
+     *
+     * It was `CatalogQueryService.expandCategoryProductIds` until
+     * `specs/110-instance-repository/` T118c, reached by both composition roots
+     * over the unpublished `catalogQueryPort` name and by nothing else. It is a
+     * category read, so it belongs to the category read model; there is one copy.
+     */
+    expandCategoryProductIds(categoryIds: readonly string[]): Promise<Map<string, Set<string>>>;
+    /**
+     * The one category, not its subtree — see the port's contract for why the two
+     * are separate methods. `pim_ergonode` wrote this statement itself before the
+     * port had it, to detach the products of a category the source tree dropped.
+     */
+    listProductIdsInCategory(categoryId: string): Promise<string[]>;
+    /**
+     * One grouped query rather than a count per id: the caller renders a source
+     * hierarchy of a few hundred bound categories on one screen, so a count per
+     * row would be a few hundred round trips every time it loads.
+     */
+    countLiveProductsByCategory(categoryIds: readonly string[]): Promise<CatalogCategoryProductCount[]>;
+}
+export declare function toCatalogCategoryRecord(category: Category): CatalogCategoryRecord;
+//# sourceMappingURL=catalog-category-read.service.d.ts.map

package/dist/backend/services/catalog-category-read.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-category-read.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/catalog-category-read.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EACV,+BAA+B,EAC/B,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAiB1D,qBAAa,0BAA2B,YAAW,uBAAuB;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,aAAa;IAErD,QAAQ,CACZ,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAQlC,SAAS,CACb,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAS7B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAK/D,UAAU,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnD,OAAO,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAS3E,2BAA2B,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAW/D,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAevE;;;;;;;;OAQG;IACG,0BAA0B,CAC9B,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GACjC,OAAO,CAAC,+BAA+B,EAAE,CAAC;IAoB7C;;;;;;;OAOG;IACG,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAepE;;;;;;;;;OASG;IACG,wBAAwB,CAC5B,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAsEpC;;;;OAIG;IACG,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQrE;;;;OAIG;IACG,2BAA2B,CAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAAC,2BAA2B,EAAE,CAAC;CAkB1C;AAMD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,GAAG,qBAAqB,CAmBjF"}