@endora-commerce/mod-catalog 0.100.0

package/dist/backend/services/bulk-operation.service.js

@@ -0,0 +1,510 @@
+import { randomUUID } from 'crypto';
+import { BULK_OPERATION_TYPES, } from '@endora-commerce/contracts';
+import { effectiveState } from '@endora-commerce/platform/kernel';
+import { rethrowIfModuleDisabled } from '@endora-commerce/platform/kernel';
+import { applyUndo } from '@endora-commerce/platform/commands';
+import { Product } from '../entities/product.entity.js';
+import { BulkOperation, } from '../entities/bulk-operation.entity.js';
+/**
+ * BulkOperationService — queued product bulk-edit.
+ *
+ * Owns the lifecycle of {@link BulkOperation} rows:
+ *   - `create()` persists a `pending` row and enqueues it (via the injected
+ *     `onEnqueued` producer) onto the durable BullMQ queue — it never
+ *     inline-executes the job (Constitution Principle X).
+ *   - `processById()` is the consumer entry point invoked by the BullMQ
+ *     worker: it claims the row atomically (`pending → running`) and applies
+ *     it through {@link CatalogBulkUpdateService} with live progress persisted
+ *     on the row. The conditional claim makes it idempotent under BullMQ
+ *     redelivery / retries and safe at N ≥ 2 worker instances.
+ *   - `processPending()` drains every `pending` row in-process; it is kept for
+ *     manual scripts / tests only — the deployed path is the queue worker.
+ *   - On completion / failure the requester is notified twice: an
+ *     in-app bell notification and an email.
+ *   - `list()` / `get()` back the "Bulk actions" admin page.
+ */
+/** Per-product outcomes are capped on the row so a huge run can't bloat it. */
+const MAX_PERSISTED_RESULTS = 1000;
+/**
+ * Wraps the gated port in the presence decision, so absence is *decided* rather
+ * than caught (D-60; Constitution XVII).
+ *
+ * A function rather than an object literal at the composition site on purpose:
+ * `check-port-catches.ts` follows the port **through the value**, and an object
+ * literal is where that trail deliberately stops.
+ */
+export function presenceAwareBulkRecorder(adminNotifications) {
+    return {
+        async record(input) {
+            // First, and outside any `try`: a closed gate throws rather than
+            // answering, so asking after the call is asking too late.
+            if (!effectiveState.isPresent('admin_notifications'))
+                return 'not-present';
+            await adminNotifications.record(input);
+            return 'recorded';
+        },
+    };
+}
+export class BulkOperationService {
+    emFactory;
+    bulkUpdateService;
+    deps;
+    commandBus;
+    /** Single-flight guard so overlapping sweep ticks don't double-process. */
+    draining = false;
+    constructor(emFactory, bulkUpdateService, deps = {}, 
+    /**
+     * Feature 054 — when injected, product bulk edits capture per-product revert
+     * state and expose an audited, conflict-aware undo (US2). Optional so bus-less
+     * constructions (some tests) keep the pre-054 behavior.
+     */
+    commandBus) {
+        this.emFactory = emFactory;
+        this.bulkUpdateService = bulkUpdateService;
+        this.deps = deps;
+        this.commandBus = commandBus;
+    }
+    async create(input) {
+        // command-coverage-ignore: catalog_bulk_operations row bookkeeping (queue
+        // status / progress counters); the actual product mutations are audited by
+        // updateProduct. The operation record itself is not a domain-audit target.
+        const em = this.emFactory();
+        const op = new BulkOperation();
+        op.type = input.type ?? 'product_bulk_update';
+        op.status = 'pending';
+        op.requestedByAdminUserId = input.requestedByAdminUserId;
+        op.total = input.payload.productIds.length;
+        op.payload = input.payload;
+        op.logs = [
+            logEntry('info', op.type === BULK_OPERATION_TYPES.SEARCH_REINDEX
+                ? 'Operacja przeindeksowania wyszukiwarki utworzona i dodana do kolejki.'
+                : `Operacja utworzona i dodana do kolejki (${op.total} elementów).`),
+        ];
+        await em.persistAndFlush(op);
+        // Producer side (Principle X): enqueue and return. Never block the HTTP
+        // response on actual processing. Enqueue errors are non-fatal — the row
+        // stays `pending` and the worker's boot reconciliation re-enqueues it.
+        try {
+            await this.deps.onEnqueued?.(op.id);
+        }
+        catch {
+            /* enqueue is best-effort; reconciliation is the safety net */
+        }
+        return serialize(op);
+    }
+    /**
+     * Consumer entry point invoked by the BullMQ worker for one queued
+     * operation. Atomically claims the row (`pending → running`); if the claim
+     * affects no row the operation was already taken or finished, so this is a
+     * no-op — making the handler idempotent under redelivery/retries and safe at
+     * N ≥ 2 worker instances.
+     */
+    async processById(operationId) {
+        // command-coverage-ignore: catalog_bulk_operations row bookkeeping (queue
+        // status / progress counters); the actual product mutations are audited by
+        // updateProduct. The operation record itself is not a domain-audit target.
+        const em = this.emFactory();
+        const affected = await em.nativeUpdate(BulkOperation, { id: operationId, status: 'pending' }, { status: 'running', startedAt: new Date() });
+        if (affected === 0)
+            return;
+        await this.processOne(operationId);
+    }
+    /**
+     * Ids of every operation still `pending`. Used by the worker at boot to
+     * re-enqueue rows that were created while no producer/queue was reachable
+     * (e.g. an enqueue failure, or a row predating this deployment).
+     */
+    async findPendingIds() {
+        const em = this.emFactory();
+        const rows = await em.find(BulkOperation, { status: 'pending' }, { fields: ['id'], orderBy: { createdAt: 'asc' } });
+        return rows.map((r) => r.id);
+    }
+    async list(input = {}) {
+        const em = this.emFactory();
+        const where = input.status && input.status.length > 0 ? { status: { $in: input.status } } : {};
+        const limit = Math.min(Math.max(input.limit ?? 25, 1), 100);
+        const offset = Math.max(input.offset ?? 0, 0);
+        const [rows, total] = await em.findAndCount(BulkOperation, where, {
+            orderBy: { createdAt: 'desc' },
+            limit,
+            offset,
+        });
+        return { items: rows.map(serialize), total };
+    }
+    async get(id) {
+        const em = this.emFactory();
+        const op = await em.findOne(BulkOperation, { id });
+        return op ? serialize(op) : null;
+    }
+    /**
+     * Drain every `pending` operation. Safe to call repeatedly and
+     * concurrently — the single-flight guard ensures one drain at a time.
+     */
+    async processPending() {
+        if (this.draining)
+            return { processed: 0 };
+        this.draining = true;
+        let processed = 0;
+        try {
+            for (;;) {
+                const next = await this.claimNextPending();
+                if (!next)
+                    break;
+                await this.processOne(next);
+                processed += 1;
+            }
+        }
+        finally {
+            this.draining = false;
+        }
+        return { processed };
+    }
+    /**
+     * Atomically flip the oldest `pending` row to `running` and return its
+     * id. The conditional UPDATE means even if two drains race past the
+     * in-process guard (e.g. across worker restarts) only one wins a row.
+     */
+    async claimNextPending() {
+        // command-coverage-ignore: catalog_bulk_operations row bookkeeping (queue
+        // status / progress counters); the actual product mutations are audited by
+        // updateProduct. The operation record itself is not a domain-audit target.
+        const em = this.emFactory();
+        const candidate = await em.findOne(BulkOperation, { status: 'pending' }, { orderBy: { createdAt: 'asc' } });
+        if (!candidate)
+            return null;
+        const affected = await em.nativeUpdate(BulkOperation, { id: candidate.id, status: 'pending' }, { status: 'running', startedAt: new Date() });
+        if (affected === 0) {
+            // Lost the race — try again on the next loop iteration.
+            return this.claimNextPending();
+        }
+        return candidate.id;
+    }
+    async processOne(id) {
+        // command-coverage-ignore: catalog_bulk_operations row bookkeeping (queue
+        // status / progress counters); the actual product mutations are audited by
+        // updateProduct. The operation record itself is not a domain-audit target.
+        const em = this.emFactory();
+        const op = await em.findOne(BulkOperation, { id });
+        if (!op)
+            return;
+        const logs = Array.isArray(op.logs) ? [...op.logs] : [];
+        logs.push(logEntry('info', `Rozpoczęto przetwarzanie operacji (${op.total} elementów).`));
+        if (op.type === BULK_OPERATION_TYPES.SEARCH_REINDEX) {
+            await this.processReindex(op, logs);
+            return;
+        }
+        const req = {
+            productIds: op.payload.productIds,
+            fields: op.payload.fields,
+        };
+        // Feature 054 (US2) — capture per-product before-state for undo, but only
+        // when the edit touches revertible direct columns (never the category
+        // bridge). Read BEFORE the mutation so the snapshot is the true pre-state.
+        const revertKeys = this.commandBus ? revertibleFieldKeys(op.payload.fields) : null;
+        const beforeByProduct = revertKeys && revertKeys.length > 0
+            ? await this.#snapshotProductFields(em, op.payload.productIds, revertKeys)
+            : null;
+        try {
+            const result = await this.bulkUpdateService.bulkUpdate(req, { actorAdminUserId: op.requestedByAdminUserId }, {
+                skipBatchLimit: true,
+                onProgress: async (p) => {
+                    await em.nativeUpdate(BulkOperation, { id }, {
+                        processed: p.processed,
+                        succeeded: p.succeeded,
+                        skipped: p.skipped,
+                        failed: p.failed,
+                    });
+                },
+            });
+            logs.push(logEntry('info', `Zakończono: ${result.summary.succeeded} z powodzeniem, ${result.summary.skipped} pominięto, ${result.summary.failed} z błędem (łącznie ${result.summary.total}).`));
+            if (result.summary.failed > 0) {
+                logs.push(logEntry('warn', `${result.summary.failed} elementów zakończyło się błędem — szczegóły w statusie pojedynczych elementów.`));
+            }
+            // Build revert state from the products that actually succeeded, reading
+            // their post-state so undo can detect later changes (research §R5).
+            let revertState = null;
+            if (revertKeys && revertKeys.length > 0 && beforeByProduct) {
+                const succeededIds = result.results
+                    .filter((r) => r.status === 'succeeded')
+                    .map((r) => r.productId)
+                    .filter((pid) => beforeByProduct.has(pid));
+                const afterByProduct = await this.#snapshotProductFields(em, succeededIds, revertKeys);
+                revertState = succeededIds.map((pid) => ({
+                    recordId: pid,
+                    before: beforeByProduct.get(pid),
+                    after: afterByProduct.get(pid) ?? {},
+                }));
+            }
+            await em.nativeUpdate(BulkOperation, { id }, {
+                status: 'completed',
+                processed: result.summary.total,
+                succeeded: result.summary.succeeded,
+                skipped: result.summary.skipped,
+                failed: result.summary.failed,
+                results: result.results.slice(0, MAX_PERSISTED_RESULTS),
+                logs,
+                finishedAt: new Date(),
+                ...(revertState && revertState.length > 0
+                    ? { reversible: true, revertState }
+                    : {}),
+            });
+            await this.notify(op, 'completed', result.summary);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            logs.push(logEntry('error', `Operacja nie powiodła się: ${message}`));
+            await em.nativeUpdate(BulkOperation, { id }, { status: 'failed', error: message, logs, finishedAt: new Date() });
+            await this.notify(op, 'failed', null, message);
+        }
+    }
+    /**
+     * Runs a `search_reindex` operation: a full Meilisearch reindex (the
+     * `search:reindex` CLI equivalent). Counts every reindexed document as
+     * both processed and succeeded; failure surfaces on the row + notifications.
+     */
+    async processReindex(op, logs = []) {
+        // command-coverage-ignore: catalog_bulk_operations row bookkeeping (queue
+        // status / progress counters); the actual product mutations are audited by
+        // updateProduct. The operation record itself is not a domain-audit target.
+        const em = this.emFactory();
+        if (!this.deps.reindexRunner) {
+            const message = 'Search reindex handler is not configured.';
+            logs.push(logEntry('error', `Operacja nie powiodła się: ${message}`));
+            await em.nativeUpdate(BulkOperation, { id: op.id }, { status: 'failed', error: message, logs, finishedAt: new Date() });
+            await this.notify(op, 'failed', null, message);
+            return;
+        }
+        try {
+            const { documentCount } = await this.deps.reindexRunner();
+            logs.push(logEntry('info', `Przeindeksowano ${documentCount} dokumentów we wszystkich indeksach.`));
+            await em.nativeUpdate(BulkOperation, { id: op.id }, {
+                status: 'completed',
+                total: documentCount,
+                processed: documentCount,
+                succeeded: documentCount,
+                skipped: 0,
+                failed: 0,
+                logs,
+                finishedAt: new Date(),
+            });
+            await this.notify(op, 'completed', {
+                succeeded: documentCount,
+                skipped: 0,
+                failed: 0,
+                total: documentCount,
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            logs.push(logEntry('error', `Operacja nie powiodła się: ${message}`));
+            await em.nativeUpdate(BulkOperation, { id: op.id }, { status: 'failed', error: message, logs, finishedAt: new Date() });
+            await this.notify(op, 'failed', null, message);
+        }
+    }
+    async notify(op, status, summary, error) {
+        const admin = await this.deps.adminUsers?.findById(op.requestedByAdminUserId);
+        const succeeded = summary?.succeeded ?? 0;
+        const total = summary?.total ?? op.total;
+        const isReindex = op.type === BULK_OPERATION_TYPES.SEARCH_REINDEX;
+        const title = isReindex
+            ? status === 'completed'
+                ? `Search reindex finished — ${total} documents indexed`
+                : 'Search reindex failed'
+            : status === 'completed'
+                ? `Bulk edit finished — ${succeeded}/${total} updated`
+                : 'Bulk edit failed';
+        const body = isReindex
+            ? status === 'completed'
+                ? `The search index was rebuilt: ${total} documents indexed.`
+                : `The search reindex could not be completed: ${error ?? 'unknown error'}.`
+            : status === 'completed'
+                ? `${total} products processed: ${succeeded} succeeded, ${summary?.skipped ?? 0} skipped, ${summary?.failed ?? 0} failed.`
+                : `The bulk edit of ${op.total} products could not be completed: ${error ?? 'unknown error'}.`;
+        try {
+            // The outcome is read rather than discarded: `not-present` is the
+            // operator having switched `admin_notifications` off, which is their
+            // choice and not a failure, and it used to be indistinguishable from a
+            // failed write inside this `catch` (D-60).
+            await this.deps.notificationService?.record({
+                audience: 'admin_user',
+                targetAdminUserId: op.requestedByAdminUserId,
+                kind: `catalog.bulk_operation.${status}`,
+                subjectType: 'bulk_operation',
+                subjectId: op.id,
+                title,
+                body,
+                linkPath: '/catalog/bulk-operations',
+            });
+        }
+        catch (err) {
+            // Narrow, and correct: the bell is written when the operation has already
+            // finished and its row carries the outcome, so a failed write must not
+            // fail a job whose work is done. Presence is decided by the recorder
+            // before the port is reached, so what is left here is a failed write.
+            rethrowIfModuleDisabled(err);
+            /* notification is best-effort */
+        }
+        if (this.deps.mailer && admin?.email) {
+            try {
+                const outcome = await this.deps.mailer.send({
+                    messageId: `bulk-op-${op.id}-${status}`,
+                    to: admin.email,
+                    subject: title,
+                    text: `${body}\n\nView the bulk actions page in the admin panel for details.`,
+                    kind: `catalog.bulk_operation.${status}`,
+                    meta: { bulkOperationId: op.id, status },
+                });
+                if (outcome.status !== 'sent') {
+                    // The products are already written; this only tells the operator it
+                    // finished. Named rather than silent, and durable in D-59's record.
+                    console.warn('[catalog] the bulk-operation e-mail was not sent', {
+                        bulkOperationId: op.id,
+                        reason: outcome.reason,
+                    });
+                }
+            }
+            catch {
+                /* email is best-effort */
+            }
+        }
+    }
+    // ---- Feature 054 (US2) — undo -----------------------------------------
+    /**
+     * Undo a reversible bulk edit: restore every affected product whose current
+     * state still matches the operation's captured after-state; refuse (report,
+     * never clobber) any product changed since. Runs as an audited `bulk.undo`
+     * Command and is idempotent-safe on re-invocation (FR-006/FR-007/FR-014).
+     */
+    async undo(operationId) {
+        const em = this.emFactory();
+        const op = await em.findOne(BulkOperation, { id: operationId });
+        if (!op)
+            return { ok: false, code: 'NOT_FOUND' };
+        if (op.status !== 'completed' || !op.reversible || !op.revertState || op.revertState.length === 0) {
+            return { ok: false, code: 'NOT_REVERSIBLE' };
+        }
+        if (op.undoStatus === 'reverted')
+            return { ok: false, code: 'ALREADY_REVERTED' };
+        if (!this.commandBus)
+            return { ok: false, code: 'NOT_REVERSIBLE' };
+        const records = op.revertState.map((r) => ({
+            recordId: r.recordId,
+            before: r.before,
+            after: r.after,
+        }));
+        return this.commandBus.run(this.#undoCommand(operationId, records));
+    }
+    #undoCommand(operationId, records) {
+        return {
+            action: 'product.bulk_update.undo',
+            objectType: 'bulk_operation',
+            objectId: operationId,
+            run: async ({ em }) => {
+                const op = await em.findOne(BulkOperation, { id: operationId });
+                if (!op || op.undoStatus === 'reverted') {
+                    return {
+                        result: { ok: true, reverted: [], conflicts: [], undoStatus: 'reverted' },
+                        skipAudit: true,
+                    };
+                }
+                const res = await applyUndo(em, records, {
+                    readCurrent: async (tem, rec) => {
+                        const p = await tem.findOne(Product, { id: rec.recordId });
+                        return p ? pickProductFields(p, Object.keys(rec.after)) : null;
+                    },
+                    restore: async (tem, rec) => {
+                        const p = await tem.findOne(Product, { id: rec.recordId });
+                        if (!p)
+                            return;
+                        tem.assign(p, rec.before);
+                        tem.persist(p);
+                    },
+                });
+                op.undoStatus = res.undoStatus === 'reverted' ? 'reverted' : 'partially_reverted';
+                op.undoneAt = new Date();
+                op.undoOperationId = randomUUID();
+                em.persist(op);
+                return {
+                    result: { ok: true, ...res },
+                    after: { reverted: res.reverted.length, conflicts: res.conflicts.length },
+                };
+            },
+        };
+    }
+    /** Read `productIds` and pick each product's values for `keys`. */
+    async #snapshotProductFields(em, productIds, keys) {
+        const out = new Map();
+        if (productIds.length === 0)
+            return out;
+        const products = await em.find(Product, { id: { $in: [...productIds] } });
+        for (const p of products) {
+            out.set(p.id, pickProductFields(p, keys));
+        }
+        return out;
+    }
+}
+/**
+ * Field keys of a bulk edit that can be undone by restoring direct product
+ * columns. Returns `[]` (⇒ not reversible) when the edit is empty or touches a
+ * non-revertible field (the category bridge) — all-or-nothing, never partial.
+ */
+const NON_REVERTIBLE_BULK_FIELDS = new Set(['categoryIds']);
+function revertibleFieldKeys(fields) {
+    const keys = Object.keys(fields);
+    if (keys.length === 0)
+        return [];
+    if (keys.some((k) => NON_REVERTIBLE_BULK_FIELDS.has(k)))
+        return [];
+    const set = new Set(keys);
+    // `status` changes also flip `archivedAt` in updateProduct — restore both.
+    if (set.has('status'))
+        set.add('archivedAt');
+    return [...set];
+}
+/** Pick a plain, JSON-cloned snapshot of a product's `keys` for revert state. */
+function pickProductFields(product, keys) {
+    const src = product;
+    const out = {};
+    for (const key of keys) {
+        const v = src[key];
+        out[key] = v === undefined ? null : JSON.parse(JSON.stringify(v ?? null));
+    }
+    return out;
+}
+function logEntry(level, message) {
+    return { ts: new Date().toISOString(), level, message };
+}
+function touchedFieldsOf(payload) {
+    const fields = payload.fields ?? {};
+    const keys = Object.keys(fields).filter((k) => k !== 'attributeValues');
+    if (fields['attributeValues'] && typeof fields['attributeValues'] === 'object') {
+        for (const attrKey of Object.keys(fields['attributeValues'])) {
+            keys.push(`attribute:${attrKey}`);
+        }
+    }
+    return keys;
+}
+function serialize(op) {
+    return {
+        id: op.id,
+        type: op.type,
+        status: op.status,
+        requestedByAdminUserId: op.requestedByAdminUserId,
+        total: op.total,
+        processed: op.processed,
+        succeeded: op.succeeded,
+        skipped: op.skipped,
+        failed: op.failed,
+        touchedFields: touchedFieldsOf(op.payload),
+        results: op.results ?? null,
+        logs: op.logs ?? null,
+        error: op.error ?? null,
+        createdAt: op.createdAt.toISOString(),
+        startedAt: op.startedAt ? op.startedAt.toISOString() : null,
+        finishedAt: op.finishedAt ? op.finishedAt.toISOString() : null,
+        reversible: op.reversible,
+        undoStatus: op.undoStatus,
+        undoneAt: op.undoneAt ? op.undoneAt.toISOString() : null,
+    };
+}
+//# sourceMappingURL=bulk-operation.service.js.map

package/dist/backend/services/bulk-operation.service.js.map

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

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

@@ -0,0 +1,87 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CommandBus } from '@endora-commerce/platform/commands';
+/**
+ * BundleService — admin CRUD for bundle slots + their options, plus the
+ * pure-compute `validateConfiguration` used by the public storefront
+ * endpoint (feature 002 US5, T129).
+ *
+ * Same composite-nesting guard as GroupedService: option products MUST
+ * NOT be `type='grouped'` or `type='bundle'` (research R-8).
+ */
+export interface BundleSlotRow {
+    id: string;
+    parentProductId: string;
+    name: Record<string, string>;
+    minQuantity: number;
+    maxQuantity: number;
+    position: number;
+    options: BundleSlotOptionRow[];
+}
+export interface BundleSlotOptionRow {
+    id: string;
+    slotId: string;
+    optionProductId: string;
+    defaultQuantity: number;
+    position: number;
+}
+export interface ConfigurationSelection {
+    slotId: string;
+    optionId: string;
+    quantity: number;
+}
+export interface BundleValidationError {
+    code: 'MIN_NOT_MET' | 'MAX_EXCEEDED' | 'UNKNOWN_OPTION';
+    slotId?: string;
+    message: string;
+}
+export interface BundleValidationResult {
+    valid: boolean;
+    errors: BundleValidationError[];
+    resolvedSelections: Array<{
+        slotId: string;
+        optionId: string;
+        optionProductId: string;
+        quantity: number;
+    }>;
+}
+export declare class BundleService {
+    #private;
+    private readonly emFactory;
+    /** Feature 054 — audits bundle slot/option writes co-transactionally when provided. */
+    private readonly commandBus?;
+    constructor(emFactory: () => EntityManager, 
+    /** Feature 054 — audits bundle slot/option writes co-transactionally when provided. */
+    commandBus?: CommandBus | undefined);
+    listSlots(parentProductId: string): Promise<BundleSlotRow[]>;
+    createSlot(parentProductId: string, input: {
+        name: Record<string, string>;
+        minQuantity?: number | undefined;
+        maxQuantity: number;
+        position?: number | undefined;
+    }): Promise<BundleSlotRow>;
+    updateSlot(parentProductId: string, slotId: string, input: {
+        name?: Record<string, string> | undefined;
+        minQuantity?: number | undefined;
+        maxQuantity?: number | undefined;
+        position?: number | undefined;
+    }): Promise<BundleSlotRow>;
+    deleteSlot(parentProductId: string, slotId: string): Promise<void>;
+    addOption(parentProductId: string, slotId: string, input: {
+        optionProductId: string;
+        defaultQuantity?: number | undefined;
+        position?: number | undefined;
+    }): Promise<BundleSlotOptionRow>;
+    removeOption(parentProductId: string, slotId: string, optionId: string): Promise<void>;
+    /**
+     * Pure-compute validation of a buyer's bundle configuration. Returns a
+     * structured result rather than throwing — the storefront wants the
+     * whole error list per-slot so it can highlight every offending row.
+     *
+     * Throws HttpError 400 only when the parent product is not a bundle
+     * (the call doesn't make sense in that case).
+     */
+    validateConfiguration(parentProductId: string, selections: ConfigurationSelection[]): Promise<BundleValidationResult>;
+    private assertBundleParent;
+    private toOptionRow;
+}
+//# sourceMappingURL=bundle.service.d.ts.map

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

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