@endora-commerce/mod-sales-channels 0.100.0

package/dist/backend/routes.admin.js

@@ -0,0 +1,302 @@
+import { ChannelMemberEntityTypeSchema, ERROR_CODES, SalesChannelCreateBodySchema, SalesChannelSetDefaultBodySchema, SalesChannelUpdateBodySchema, } from '@endora-commerce/contracts';
+import { z } from 'zod';
+import { HttpError } from '@endora-commerce/platform/http';
+/**
+ * Admin HTTP surface — feature 005 / US2 (T034).
+ *
+ * Mounts under `/api/v1/admin/sales-channels/*`:
+ *   - GET    /                   — list (sales_channels:read)
+ *   - GET    /:code              — detail (sales_channels:read)
+ *   - POST   /                   — create (sales_channels:write)
+ *   - PATCH  /:code              — update (sales_channels:write); optimistic-
+ *                                  concurrency via the body's `expectedVersion`
+ *                                  field (matches feature 003/004 pattern; the
+ *                                  `If-Match` header in the contract markdown
+ *                                  is sugar that drops here later).
+ *   - POST   /:code/deactivate   — deactivate (sales_channels:write)
+ *   - POST   /:code/activate     — activate (sales_channels:write)
+ *   - POST   /:code/set-default  — move the system-default flag here
+ *                                  (sales_channels:write); a Command, so the
+ *                                  move is audited and the demote/promote pair
+ *                                  is one transaction (D-51).
+ *   - DELETE /:code              — hard delete (sales_channels:write); accepts
+ *                                  `?fallbackToDefault=true` to rebind orphan
+ *                                  members in the same transaction.
+ *
+ * Permission codes are placeholders that match the existing settings /
+ * admin-roles vocabulary; the constitution authority gate (Principle II)
+ * is upheld by the `requireAdmin(<permission>)` factory injected by the
+ * composition root.
+ */
+const SC_READ = 'sales_channels:read';
+const SC_WRITE = 'sales_channels:write';
+const ListQuerySchema = z.object({
+    page: z.coerce.number().int().nonnegative().optional(),
+    pageSize: z.coerce.number().int().positive().max(200).optional(),
+    activeOnly: z
+        .union([z.boolean(), z.enum(['true', 'false'])])
+        .transform((v) => (typeof v === 'string' ? v === 'true' : v))
+        .optional(),
+});
+const DeleteQuerySchema = z.object({
+    fallbackToDefault: z
+        .union([z.boolean(), z.enum(['true', 'false'])])
+        .transform((v) => (typeof v === 'string' ? v === 'true' : v))
+        .optional(),
+});
+/**
+ * The PATCH body's optimistic-concurrency token rides alongside the
+ * partial identity fields. We pull out `expectedVersion` and parse the
+ * rest with the contract's update schema so the cross-field
+ * `defaultLanguage ∈ languages` rule still applies (the contract's
+ * superRefine cannot be `extended()`).
+ */
+const ExpectedVersionShape = z.object({
+    expectedVersion: z.number().int().positive(),
+});
+export async function registerSalesChannelsAdminRoutes(app, deps) {
+    const { salesChannelsService, membershipService, requireAdmin, resolveAdminAuditContext, } = deps;
+    const auditContext = (request) => {
+        const ctx = resolveAdminAuditContext?.(request) ?? { actorAdminUserId: null };
+        const rid = request.headers['x-request-id'];
+        return {
+            ...ctx,
+            requestId: typeof rid === 'string' ? rid : null,
+        };
+    };
+    function setEtag(reply, channel) {
+        reply.header('etag', `W/"${channel.id}:${channel.version}"`);
+    }
+    function serializeSummary(c) {
+        return {
+            id: c.id,
+            code: c.code,
+            name: c.name,
+            active: c.active,
+            systemDefault: c.systemDefault,
+            defaultLanguage: c.defaultLanguage,
+            defaultCurrency: c.defaultCurrency,
+            themeCode: c.themeCode ?? null,
+            logoAssetId: c.logoAssetId ?? null,
+            version: c.version,
+            createdAt: c.createdAt.toISOString(),
+            updatedAt: c.updatedAt.toISOString(),
+        };
+    }
+    function serializeDetail(c) {
+        return {
+            ...serializeSummary(c),
+            languages: c.languages,
+            currencies: c.currencies,
+            // logoUrl resolved through the assets module is left null here for
+            // the initial v1; T038's admin client just reads logoAssetId and
+            // resolves the URL via the existing assets endpoint. A follow-up
+            // can fold the resolution server-side if storefront use grows.
+            logoUrl: null,
+        };
+    }
+    // -- List -----------------------------------------------------------------
+    app.get('/api/v1/admin/sales-channels', { preHandler: requireAdmin(SC_READ) }, async (request) => {
+        const q = ListQuerySchema.parse(request.query ?? {});
+        const result = await salesChannelsService.list({
+            ...(q.page !== undefined ? { page: q.page } : {}),
+            ...(q.pageSize !== undefined ? { pageSize: q.pageSize } : {}),
+            ...(q.activeOnly !== undefined ? { activeOnly: q.activeOnly } : {}),
+        });
+        return {
+            items: result.items.map(serializeSummary),
+            page: result.page,
+            pageSize: result.pageSize,
+            total: result.total,
+        };
+    });
+    // -- Detail ---------------------------------------------------------------
+    app.get('/api/v1/admin/sales-channels/:code', { preHandler: requireAdmin(SC_READ) }, async (request, reply) => {
+        const channel = await salesChannelsService.getByCode(request.params.code);
+        if (channel === null) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Sales channel "${request.params.code}" was not found.`);
+        }
+        setEtag(reply, channel);
+        return serializeDetail(channel);
+    });
+    // -- Create ---------------------------------------------------------------
+    app.post('/api/v1/admin/sales-channels', { preHandler: requireAdmin(SC_WRITE) }, async (request, reply) => {
+        const body = SalesChannelCreateBodySchema.parse(request.body);
+        const channel = await salesChannelsService.create(body, auditContext(request));
+        reply.code(201);
+        setEtag(reply, channel);
+        return serializeDetail(channel);
+    });
+    // -- Update ---------------------------------------------------------------
+    app.patch('/api/v1/admin/sales-channels/:code', { preHandler: requireAdmin(SC_WRITE) }, async (request, reply) => {
+        const raw = (request.body ?? {});
+        const { expectedVersion } = ExpectedVersionShape.parse({
+            expectedVersion: raw['expectedVersion'],
+        });
+        const { expectedVersion: _ignored, ...rest } = raw;
+        const body = SalesChannelUpdateBodySchema.parse(rest);
+        const channel = await salesChannelsService.update(request.params.code, body, expectedVersion, auditContext(request));
+        setEtag(reply, channel);
+        return serializeDetail(channel);
+    });
+    // -- Lifecycle ------------------------------------------------------------
+    app.post('/api/v1/admin/sales-channels/:code/deactivate', { preHandler: requireAdmin(SC_WRITE) }, async (request, reply) => {
+        const channel = await salesChannelsService.deactivate(request.params.code, auditContext(request));
+        setEtag(reply, channel);
+        return serializeDetail(channel);
+    });
+    app.post('/api/v1/admin/sales-channels/:code/activate', { preHandler: requireAdmin(SC_WRITE) }, async (request, reply) => {
+        const channel = await salesChannelsService.activate(request.params.code, auditContext(request));
+        setEtag(reply, channel);
+        return serializeDetail(channel);
+    });
+    /**
+     * Move the system-default flag — feature 072 / D-51.
+     *
+     * Gated by the same `sales_channels:write` that gates every other mutation on
+     * this surface: it is a channel-registry write, and an operator who may retire
+     * a channel may certainly choose which one is the fallback. No new permission
+     * code, so `/admin-roles` and the permission inventory are unchanged.
+     *
+     * Mounted before the membership routes' `/:code/:entityType` shapes, which
+     * mount no POST — and Fastify prefers the static `set-default` segment anyway.
+     */
+    app.post('/api/v1/admin/sales-channels/:code/set-default', { preHandler: requireAdmin(SC_WRITE) }, async (request, reply) => {
+        SalesChannelSetDefaultBodySchema.parse(request.body ?? {});
+        const result = await salesChannelsService.setDefault(request.params.code);
+        setEtag(reply, result.channel);
+        return {
+            channel: serializeDetail(result.channel),
+            previousDefaultCode: result.previousDefaultCode,
+            changed: result.changed,
+        };
+    });
+    app.delete('/api/v1/admin/sales-channels/:code', { preHandler: requireAdmin(SC_WRITE) }, async (request, reply) => {
+        const q = DeleteQuerySchema.parse(request.query ?? {});
+        await salesChannelsService.delete(request.params.code, { fallbackToDefault: q.fallbackToDefault ?? false }, auditContext(request));
+        reply.code(204);
+        return reply.send();
+    });
+    // -------------------------------------------------------------------------
+    // Membership routes — feature 005 / Phase 5b (T049-T058 consolidated).
+    //
+    // Both directions of the bidirectional relationship are mounted under
+    // `/api/v1/admin/sales-channels/*` so all 9 entity types (no
+    // `inventory-location` per the deferral) get coverage in one
+    // centralised file. The plan's per-owning-module mounts under
+    // `/admin/products/{id}/sales-channels` etc. would have required
+    // touching 9 modules' route files; consolidating here keeps the
+    // feature reviewable and the membership service is the single
+    // source of truth either way (FR-010).
+    //
+    //   GET    /api/v1/admin/sales-channels/:code/:entityType
+    //   PUT    /api/v1/admin/sales-channels/:code/:entityType/:entityId
+    //   DELETE /api/v1/admin/sales-channels/:code/:entityType/:entityId
+    //                  ?fallbackToDefault=true
+    //   GET    /api/v1/admin/sales-channels/by-entity/:entityType/:entityId
+    //
+    // The "by-entity" path replaces the contract's
+    // `/admin/{T}/{entityId}/sales-channels` shape — functionally
+    // equivalent for the admin UI's membership panel and avoids
+    // dispersing the implementation across each owning module's
+    // routes.admin.ts.
+    // -------------------------------------------------------------------------
+    const PageQuerySchema = z.object({
+        page: z.coerce.number().int().nonnegative().optional(),
+        pageSize: z.coerce.number().int().positive().max(200).optional(),
+    });
+    const MembershipDeleteQuerySchema = z.object({
+        fallbackToDefault: z
+            .union([z.boolean(), z.enum(['true', 'false'])])
+            .transform((v) => (typeof v === 'string' ? v === 'true' : v))
+            .optional(),
+    });
+    function parseEntityType(raw) {
+        const result = ChannelMemberEntityTypeSchema.safeParse(raw);
+        if (!result.success) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Unknown channel-scoped entity type "${raw}".`);
+        }
+        return result.data;
+    }
+    async function requireChannelByCode(code) {
+        const channel = await salesChannelsService.getByCode(code);
+        if (channel === null) {
+            throw new HttpError(404, ERROR_CODES.UNKNOWN_SALES_CHANNEL, `Sales channel "${code}" was not found.`);
+        }
+        return channel;
+    }
+    // -- Channel-side: list members of a channel for one entity type ---------
+    app.get('/api/v1/admin/sales-channels/:code/:entityType', { preHandler: requireAdmin(SC_READ) }, async (request) => {
+        const entityType = parseEntityType(request.params.entityType);
+        const channel = await requireChannelByCode(request.params.code);
+        const q = PageQuerySchema.parse(request.query ?? {});
+        const page = q.page ?? 0;
+        const pageSize = q.pageSize ?? 100;
+        const result = await membershipService.listEntityIdsForChannel(channel.id, entityType, page, pageSize);
+        return {
+            salesChannelCode: channel.code,
+            entityType,
+            entityIds: result.entityIds,
+            page,
+            pageSize,
+            total: result.total,
+        };
+    });
+    // -- Channel-side: add membership ----------------------------------------
+    app.put('/api/v1/admin/sales-channels/:code/:entityType/:entityId', { preHandler: requireAdmin(SC_WRITE) }, async (request, reply) => {
+        const entityType = parseEntityType(request.params.entityType);
+        const channel = await requireChannelByCode(request.params.code);
+        const ctx = auditContext(request);
+        const result = await membershipService.addToChannel(channel.id, entityType, request.params.entityId, { actorAdminUserId: ctx.actorAdminUserId });
+        reply.code(result.changed ? 201 : 200);
+        return {
+            salesChannelCode: channel.code,
+            entityType,
+            entityId: request.params.entityId,
+            changed: result.changed,
+        };
+    });
+    // -- Channel-side: remove membership -------------------------------------
+    app.delete('/api/v1/admin/sales-channels/:code/:entityType/:entityId', { preHandler: requireAdmin(SC_WRITE) }, async (request, reply) => {
+        const entityType = parseEntityType(request.params.entityType);
+        const channel = await requireChannelByCode(request.params.code);
+        const q = MembershipDeleteQuerySchema.parse(request.query ?? {});
+        const ctx = auditContext(request);
+        const result = await membershipService.removeFromChannel(channel.id, entityType, request.params.entityId, {
+            fallbackToDefault: q.fallbackToDefault ?? false,
+            actorAdminUserId: ctx.actorAdminUserId,
+        });
+        reply.code(200);
+        return {
+            salesChannelCode: channel.code,
+            entityType,
+            entityId: request.params.entityId,
+            changed: result.changed,
+            fallbackAppliedToDefault: result.fallbackAppliedToDefault ?? false,
+        };
+    });
+    // -- Entity-side: list channels of an entity -----------------------------
+    app.get('/api/v1/admin/sales-channels/by-entity/:entityType/:entityId', { preHandler: requireAdmin(SC_READ) }, async (request) => {
+        const entityType = parseEntityType(request.params.entityType);
+        const channels = await membershipService.listChannelsForEntity(entityType, request.params.entityId);
+        return {
+            entityType,
+            entityId: request.params.entityId,
+            channels: channels.map((c) => ({
+                id: c.id,
+                code: c.code,
+                name: c.name,
+                active: c.active,
+                systemDefault: c.systemDefault,
+                defaultLanguage: c.defaultLanguage,
+                defaultCurrency: c.defaultCurrency,
+                themeCode: c.themeCode ?? null,
+                logoAssetId: c.logoAssetId ?? null,
+                version: c.version,
+                createdAt: c.createdAt.toISOString(),
+                updatedAt: c.updatedAt.toISOString(),
+            })),
+        };
+    });
+}
+//# sourceMappingURL=routes.admin.js.map

package/dist/backend/routes.admin.js.map

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

package/dist/backend/routes.storefront.d.ts

@@ -0,0 +1,36 @@
+import type { FastifyInstance } from 'fastify';
+/**
+ * Public read of the resolved sales channel.
+ *
+ *   GET /api/v1/storefront/sales-channel
+ *
+ * `PublicSalesChannelSchema` has existed since feature `005-sales-channels`
+ * and its own doc block describes this endpoint as "what the storefront app
+ * fetches on first paint to know its theme / language / currency". The schema
+ * shipped; the route did not. Measured on 2026-08-29: the path appeared in the
+ * repository exactly twice, in that comment and in the 005 prose contract, and
+ * in no route registration anywhere — so `theme_code`, `logoAssetId`, and the
+ * per-channel language and currency scopes had no way of reaching the buyer's
+ * first paint at all.
+ *
+ * ## Channel resolution
+ *
+ * `getResolvedChannel()` — the sanctioned accessor (Constitution XII). The
+ * resolver middleware has already filled the request scope from the api-key
+ * binding, the `X-Sales-Channel` header, `?salesChannel`, the host map or the
+ * system default, in that order; re-deriving any of that here would be a second
+ * answer to a question the platform has already answered, and would be the
+ * hand-rolled query Principle XII refuses. Nothing in this file reads
+ * `sales_channels` or any bridge table.
+ *
+ * ## Why the module gate is not a hazard here
+ *
+ * `sales_channels` declares `activation.nonDeactivatable`, so the seam
+ * `ctx.routes` wraps this registration in has no off state to take the
+ * storefront's first paint down with. The route would still be the wrong place
+ * for a fallback if it did: a buyer-facing page that cannot learn its channel
+ * is answered by the storefront's own default theme, not by a backend that
+ * invents a channel.
+ */
+export declare function registerSalesChannelsStorefrontRoutes(app: FastifyInstance): Promise<void>;
+//# sourceMappingURL=routes.storefront.d.ts.map

package/dist/backend/routes.storefront.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.storefront.d.ts","sourceRoot":"","sources":["../../src/backend/routes.storefront.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,qCAAqC,CACzD,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/backend/routes.storefront.js

@@ -0,0 +1,58 @@
+import { getResolvedChannel } from '@endora-commerce/platform/kernel';
+/**
+ * Public read of the resolved sales channel.
+ *
+ *   GET /api/v1/storefront/sales-channel
+ *
+ * `PublicSalesChannelSchema` has existed since feature `005-sales-channels`
+ * and its own doc block describes this endpoint as "what the storefront app
+ * fetches on first paint to know its theme / language / currency". The schema
+ * shipped; the route did not. Measured on 2026-08-29: the path appeared in the
+ * repository exactly twice, in that comment and in the 005 prose contract, and
+ * in no route registration anywhere — so `theme_code`, `logoAssetId`, and the
+ * per-channel language and currency scopes had no way of reaching the buyer's
+ * first paint at all.
+ *
+ * ## Channel resolution
+ *
+ * `getResolvedChannel()` — the sanctioned accessor (Constitution XII). The
+ * resolver middleware has already filled the request scope from the api-key
+ * binding, the `X-Sales-Channel` header, `?salesChannel`, the host map or the
+ * system default, in that order; re-deriving any of that here would be a second
+ * answer to a question the platform has already answered, and would be the
+ * hand-rolled query Principle XII refuses. Nothing in this file reads
+ * `sales_channels` or any bridge table.
+ *
+ * ## Why the module gate is not a hazard here
+ *
+ * `sales_channels` declares `activation.nonDeactivatable`, so the seam
+ * `ctx.routes` wraps this registration in has no off state to take the
+ * storefront's first paint down with. The route would still be the wrong place
+ * for a fallback if it did: a buyer-facing page that cannot learn its channel
+ * is answered by the storefront's own default theme, not by a backend that
+ * invents a channel.
+ */
+export async function registerSalesChannelsStorefrontRoutes(app) {
+    app.get('/api/v1/storefront/sales-channel', async () => {
+        const channel = getResolvedChannel();
+        const data = {
+            code: channel.code,
+            name: channel.name,
+            defaultLanguage: channel.defaultLanguage,
+            defaultCurrency: channel.defaultCurrency,
+            languages: [...channel.languages],
+            currencies: [...channel.currencies],
+            themeCode: channel.themeCode,
+            // Null for the same reason the admin detail returns null: resolving an
+            // asset id to an absolute URL needs the assets module, and this route is
+            // not the merge request that adds that edge. `logoAssetId` is on the
+            // admin shapes and the public schema deliberately carries a URL rather
+            // than an id, so the two are answered together or not at all. Recorded
+            // here rather than left to be rediscovered — the theme half of this
+            // schema is the half this change makes true.
+            logoUrl: null,
+        };
+        return { data };
+    });
+}
+//# sourceMappingURL=routes.storefront.js.map

package/dist/backend/routes.storefront.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.storefront.js","sourceRoot":"","sources":["../../src/backend/routes.storefront.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,KAAK,UAAU,qCAAqC,CACzD,GAAoB;IAEpB,GAAG,CAAC,GAAG,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QACrC,MAAM,IAAI,GAAuB;YAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,SAAS,EAAE,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;YACjC,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;YACnC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,uEAAuE;YACvE,yEAAyE;YACzE,qEAAqE;YACrE,uEAAuE;YACvE,uEAAuE;YACvE,oEAAoE;YACpE,6CAA6C;YAC7C,OAAO,EAAE,IAAI;SACd,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/services/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}

package/dist/backend/services/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/backend/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backend/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}

package/dist/backend/services/sales-channel-attribution-registry.d.ts

@@ -0,0 +1,28 @@
+import type { SalesChannelAttribution, SalesChannelAttributionDescriptor, SalesChannelAttributionRegistryPort } from '@endora-commerce/contracts';
+/**
+ * In-process registry of "who is still attributed to this sales channel?"
+ * counters (feature 075, D-87 drain).
+ *
+ * Registered under `salesChannelAttributionRegistry` and contributed to from
+ * other modules' boot hooks. `SalesChannelsService.delete` is the only reader
+ * today, and it used to answer the question itself — one raw statement naming
+ * `orders` and `quote_requests`, two other modules' tables, invisible to the
+ * import-level boundary check because SQL names no specifier.
+ *
+ * **Enumeration policy: honoured while the contributing module is absent.**
+ * The reasoning is at `SalesChannelAttributionRegistryPort` in
+ * `@endora-commerce/contracts`, and the short of it is that this is referential integrity
+ * rather than a surface: a switched-off module still owns the rows carrying the
+ * channel id, so skipping its counter would let an operator delete the channel
+ * underneath them. That is why this class takes no presence predicate — unlike
+ * `AuditReferenceRegistry`, which resolves a deep link into a contributor's own
+ * admin screen and therefore has one.
+ */
+export declare class SalesChannelAttributionRegistry implements SalesChannelAttributionRegistryPort {
+    private readonly descriptors;
+    register(descriptor: SalesChannelAttributionDescriptor): void;
+    /** The contributing module of every registered descriptor, in registration order. */
+    owners(): readonly string[];
+    countForChannel(salesChannelId: string): Promise<SalesChannelAttribution[]>;
+}
+//# sourceMappingURL=sales-channel-attribution-registry.d.ts.map

package/dist/backend/services/sales-channel-attribution-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sales-channel-attribution-registry.d.ts","sourceRoot":"","sources":["../../../src/backend/services/sales-channel-attribution-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,iCAAiC,EACjC,mCAAmC,EACpC,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,+BAAgC,YAAW,mCAAmC;IACzF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;IAEvE,QAAQ,CAAC,UAAU,EAAE,iCAAiC,GAAG,IAAI;IAM7D,qFAAqF;IACrF,MAAM,IAAI,SAAS,MAAM,EAAE;IAIrB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAiBlF"}

package/dist/backend/services/sales-channel-attribution-registry.js

@@ -0,0 +1,50 @@
+/**
+ * In-process registry of "who is still attributed to this sales channel?"
+ * counters (feature 075, D-87 drain).
+ *
+ * Registered under `salesChannelAttributionRegistry` and contributed to from
+ * other modules' boot hooks. `SalesChannelsService.delete` is the only reader
+ * today, and it used to answer the question itself — one raw statement naming
+ * `orders` and `quote_requests`, two other modules' tables, invisible to the
+ * import-level boundary check because SQL names no specifier.
+ *
+ * **Enumeration policy: honoured while the contributing module is absent.**
+ * The reasoning is at `SalesChannelAttributionRegistryPort` in
+ * `@endora-commerce/contracts`, and the short of it is that this is referential integrity
+ * rather than a surface: a switched-off module still owns the rows carrying the
+ * channel id, so skipping its counter would let an operator delete the channel
+ * underneath them. That is why this class takes no presence predicate — unlike
+ * `AuditReferenceRegistry`, which resolves a deep link into a contributor's own
+ * admin screen and therefore has one.
+ */
+export class SalesChannelAttributionRegistry {
+    descriptors = [];
+    register(descriptor) {
+        if (!this.descriptors.includes(descriptor)) {
+            this.descriptors.push(descriptor);
+        }
+    }
+    /** The contributing module of every registered descriptor, in registration order. */
+    owners() {
+        return this.descriptors.map((d) => d.ownerModuleId);
+    }
+    async countForChannel(salesChannelId) {
+        const found = [];
+        for (const descriptor of this.descriptors) {
+            const count = await descriptor.countForChannel(salesChannelId);
+            // A consumer that points at nothing is not an attribution. Reporting it
+            // would put a module's name in a refusal message that is not refusing.
+            if (count <= 0)
+                continue;
+            found.push({
+                ownerModuleId: descriptor.ownerModuleId,
+                consumer: descriptor.consumer,
+                tableName: descriptor.tableName,
+                columnName: descriptor.columnName,
+                count,
+            });
+        }
+        return found;
+    }
+}
+//# sourceMappingURL=sales-channel-attribution-registry.js.map

package/dist/backend/services/sales-channel-attribution-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sales-channel-attribution-registry.js","sourceRoot":"","sources":["../../../src/backend/services/sales-channel-attribution-registry.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,+BAA+B;IACzB,WAAW,GAAwC,EAAE,CAAC;IAEvE,QAAQ,CAAC,UAA6C;QACpD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,qFAAqF;IACrF,MAAM;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,cAAsB;QAC1C,MAAM,KAAK,GAA8B,EAAE,CAAC;QAC5C,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;YAC/D,wEAAwE;YACxE,uEAAuE;YACvE,IAAI,KAAK,IAAI,CAAC;gBAAE,SAAS;YACzB,KAAK,CAAC,IAAI,CAAC;gBACT,aAAa,EAAE,UAAU,CAAC,aAAa;gBACvC,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,UAAU,EAAE,UAAU,CAAC,UAAU;gBACjC,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}