@endora-commerce/mod-sales-channels 0.100.0

package/dist/admin/pages/SalesChannelsListPage.js

@@ -0,0 +1,91 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from 'react';
+import { Link } from 'react-router-dom';
+import { ApiError, useAuth } from '@endora-commerce/admin-kit/lib';
+import { Alert, AlertDescription, Badge, Button, Card, CardContent, Checkbox, Label, PageHeader, Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@endora-commerce/admin-kit/ui';
+import { salesChannelsClient } from '../api/sales-channels-client.js';
+import { DefaultChannelBadge } from '../components/DefaultChannelBadge.js';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+/**
+ * SalesChannelsListPage — feature 005 / T041.
+ *
+ * Top-level list view. The system-default channel always lives in
+ * the list; the activeOnly filter toggles whether deactivated
+ * channels are hidden. The "+ New channel" CTA sends the operator
+ * to the create form (`/sales-channels/new`).
+ *
+ * The system-default column is where the flag moves (feature 072 / D-51). The
+ * list is the right surface for it because the decision is comparative — which
+ * of these channels should be the fallback — and because the current default
+ * has to be visible while another one is promoted. The current default's cell
+ * is deliberately inert: the flag is moved by promoting a different channel,
+ * never by clearing it here, which is what keeps "exactly one default" true at
+ * every moment.
+ */
+export function SalesChannelsListPage() {
+    const t = useTranslation('sales_channels');
+    const { hasPermission } = useAuth();
+    const canWrite = hasPermission('sales_channels:write');
+    const [rows, setRows] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [activeOnly, setActiveOnly] = useState(false);
+    const [promoting, setPromoting] = useState(null);
+    const refresh = useCallback(async () => {
+        setLoading(true);
+        setError(null);
+        try {
+            const res = await salesChannelsClient.list({ activeOnly });
+            setRows(res.items);
+        }
+        catch (err) {
+            setError(err instanceof ApiError
+                ? err.envelope.error.message
+                : t('list.error.load'));
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [activeOnly, t]);
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    const makeDefault = useCallback(async (channel) => {
+        const previous = rows.find((c) => c.systemDefault)?.code ?? '—';
+        if (!window.confirm(t('list.action.makeDefault.confirm', { code: channel.code, previous }))) {
+            return;
+        }
+        setPromoting(channel.code);
+        setError(null);
+        try {
+            await salesChannelsClient.setDefault(channel.code);
+            await refresh();
+        }
+        catch (err) {
+            setError(err instanceof ApiError
+                ? err.envelope.error.message
+                : t('list.error.makeDefault'));
+        }
+        finally {
+            setPromoting(null);
+        }
+    }, [refresh, rows, t]);
+    return (_jsxs(_Fragment, { children: [_jsx(PageHeader, { title: t('list.page.title'), description: t('list.page.description'), actions: 
+                // Gated on the code the create route now enforces (feature 091, batch
+                // 14). It was ungated while `/sales-channels/new` was `App.tsx`'s and
+                // therefore ungated too; the route is this module's own now and takes
+                // `sales_channels:write`, so an ungated button would be a dead end for
+                // a read-only operator rather than a refusal they could act on.
+                canWrite ? (_jsx(Button, { asChild: true, children: _jsx(Link, { to: "/sales-channels/new", children: t('list.action.newChannel') }) })) : null }), error && (_jsx(Alert, { variant: "destructive", className: "mb-4", children: _jsx(AlertDescription, { children: error }) })), _jsx(Card, { className: "mb-4", children: _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Checkbox, { id: "sc-active-only", checked: activeOnly, onChange: (e) => setActiveOnly(e.target.checked) }), _jsx(Label, { htmlFor: "sc-active-only", className: "cursor-pointer", children: t('list.filter.activeOnly') })] }) }) }), _jsx(Card, { children: _jsx(CardContent, { className: "pt-6", children: loading ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('list.loading') })) : rows.length === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('list.empty') })) : (_jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: t('list.column.code') }), _jsx(TableHead, { children: t('list.column.name') }), _jsx(TableHead, { children: t('list.column.defaultLangCurrency') }), _jsx(TableHead, { children: t('list.column.status') }), _jsx(TableHead, { className: "w-32 text-right", children: t('list.column.version') }), _jsx(TableHead, { className: "w-48 text-right", children: t('list.column.systemDefault') })] }) }), _jsx(TableBody, { children: rows.map((c) => (_jsxs(TableRow, { children: [_jsxs(TableCell, { className: "font-mono text-xs", children: [_jsx(Link, { to: `/sales-channels/${encodeURIComponent(c.code)}`, className: "text-primary hover:underline", children: c.code }), _jsx(DefaultChannelBadge, { systemDefault: c.systemDefault })] }), _jsx(TableCell, { children: c.name['en-US'] ?? c.name['en'] ?? Object.values(c.name)[0] ?? '—' }), _jsxs(TableCell, { className: "text-xs text-muted-foreground", children: [c.defaultLanguage, " / ", c.defaultCurrency] }), _jsx(TableCell, { children: c.active ? (_jsx(Badge, { variant: "default", className: "text-[10px]", children: t('status.active') })) : (_jsx(Badge, { variant: "outline", className: "text-[10px]", children: t('status.inactive') })) }), _jsxs(TableCell, { className: "text-right text-xs text-muted-foreground", children: ["v", c.version] }), _jsx(TableCell, { className: "text-right", children: c.systemDefault ? (
+                                            // The current default: stated, not offered. Clearing the
+                                            // flag without giving it to another channel is the one
+                                            // state the platform must never be in.
+                                            _jsx("span", { className: "text-xs text-muted-foreground", children: t('list.action.makeDefault.current') })) : canWrite ? (_jsx(Button, { variant: "outline", size: "sm", disabled: !c.active || promoting !== null, title: c.active ? undefined : t('list.action.makeDefault.inactiveHelp'), onClick: () => void makeDefault(c), children: t('list.action.makeDefault') })) : null })] }, c.id))) })] })) }) })] }));
+}
+/**
+ * The registry loads a route component through a dynamic-import factory and
+ * reads its default export (feature 091, FR-013). The named export stays: it is
+ * the spelling this module's own code and its tests use.
+ */
+export default SalesChannelsListPage;
+//# sourceMappingURL=SalesChannelsListPage.js.map

package/dist/admin/pages/SalesChannelsListPage.js.map

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

package/dist/admin/zones/OrganizationChannelMembership.d.ts

@@ -0,0 +1,34 @@
+import type { ReactNode } from 'react';
+import type { AdminZoneProps } from '@endora-commerce/contracts';
+/**
+ * The channels an organization belongs to (feature 091, P7b).
+ *
+ * `organizations`' `OrganizationDetail.tsx` used to import
+ * `EntityChannelMembership` by path and render it with
+ * `entityType="organization"` — one of the three keys of
+ * `backend/scripts/ledgers/cross-module-imports/organizations.ts`. The place is
+ * `organization.detail.after` now, and the `entityType` is *this module's*
+ * constant: an organization's detail screen is the only thing it could be.
+ *
+ * **Two contributions over one component, not one contribution with a `match`**
+ * (Z4, Z13). This wrapper and `ProductChannelMembership` differ only in the
+ * `entityType` they pass, and that is the whole cost of `organization.detail.after`
+ * and `product.editor.channels` being two places rather than one name narrowed
+ * per mount.
+ *
+ * **No `match`, and it is a decision rather than an omission.** This place has
+ * one host and one mount, so there is nothing to narrow.
+ * `admin/test/modules/sales_channels/organization-channels-zone.test.tsx`
+ * asserts it absent so a later author cannot add one quietly.
+ *
+ * The host used to pass no `onChanged`, and neither does this: the panel's own
+ * refresh is what the operator sees, and a zone has no callback to give it.
+ */
+export type OrganizationChannelMembershipProps = AdminZoneProps<'organization.detail.after'>;
+export declare function OrganizationChannelMembership({ organizationId, }: OrganizationChannelMembershipProps): ReactNode;
+/**
+ * The zone renderer loads a contribution through a dynamic-import factory and
+ * reads its default export (feature 091, FR-013).
+ */
+export default OrganizationChannelMembership;
+//# sourceMappingURL=OrganizationChannelMembership.d.ts.map

package/dist/admin/zones/OrganizationChannelMembership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrganizationChannelMembership.d.ts","sourceRoot":"","sources":["../../../src/admin/zones/OrganizationChannelMembership.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGjE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,kCAAkC,GAAG,cAAc,CAAC,2BAA2B,CAAC,CAAC;AAE7F,wBAAgB,6BAA6B,CAAC,EAC5C,cAAc,GACf,EAAE,kCAAkC,GAAG,SAAS,CAEhD;AAED;;;GAGG;AACH,eAAe,6BAA6B,CAAC"}

package/dist/admin/zones/OrganizationChannelMembership.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { EntityChannelMembership } from '../components/EntityChannelMembership.js';
+export function OrganizationChannelMembership({ organizationId, }) {
+    return _jsx(EntityChannelMembership, { entityType: "organization", entityId: organizationId });
+}
+/**
+ * The zone renderer loads a contribution through a dynamic-import factory and
+ * reads its default export (feature 091, FR-013).
+ */
+export default OrganizationChannelMembership;
+//# sourceMappingURL=OrganizationChannelMembership.js.map

package/dist/admin/zones/OrganizationChannelMembership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrganizationChannelMembership.js","sourceRoot":"","sources":["../../../src/admin/zones/OrganizationChannelMembership.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AA4BnF,MAAM,UAAU,6BAA6B,CAAC,EAC5C,cAAc,GACqB;IACnC,OAAO,KAAC,uBAAuB,IAAC,UAAU,EAAC,cAAc,EAAC,QAAQ,EAAE,cAAc,GAAI,CAAC;AACzF,CAAC;AAED;;;GAGG;AACH,eAAe,6BAA6B,CAAC"}

package/dist/admin/zones/ProductChannelMembership.d.ts

@@ -0,0 +1,23 @@
+import type { ReactNode } from 'react';
+import type { AdminZoneProps } from '@endora-commerce/contracts';
+/**
+ * The body of the product editor's Channels tab (feature 091, P7a).
+ *
+ * `catalog`'s `ProductEditor.tsx` used to import `EntityChannelMembership` and
+ * render it as the whole tab body, passing `entityType="product"`. The place is
+ * `product.editor.channels` now, and the `entityType` is *this module's*
+ * constant: the zone is the product editor's, so nothing else it could be.
+ *
+ * **No `match`, and it is a decision rather than an omission.** `match` narrows
+ * the mounts of one place (Z13); this place has one host and one mount.
+ * `admin/test/modules/sales_channels/product-channels-zone.test.tsx` asserts it
+ * absent so a later author cannot add one quietly.
+ */
+export type ProductChannelMembershipProps = AdminZoneProps<'product.editor.channels'>;
+export declare function ProductChannelMembership({ productId, }: ProductChannelMembershipProps): ReactNode;
+/**
+ * The zone renderer loads a contribution through a dynamic-import factory and
+ * reads its default export (feature 091, FR-013).
+ */
+export default ProductChannelMembership;
+//# sourceMappingURL=ProductChannelMembership.d.ts.map

package/dist/admin/zones/ProductChannelMembership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductChannelMembership.d.ts","sourceRoot":"","sources":["../../../src/admin/zones/ProductChannelMembership.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGjE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,6BAA6B,GAAG,cAAc,CAAC,yBAAyB,CAAC,CAAC;AAEtF,wBAAgB,wBAAwB,CAAC,EACvC,SAAS,GACV,EAAE,6BAA6B,GAAG,SAAS,CAE3C;AAED;;;GAGG;AACH,eAAe,wBAAwB,CAAC"}

package/dist/admin/zones/ProductChannelMembership.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { EntityChannelMembership } from '../components/EntityChannelMembership.js';
+export function ProductChannelMembership({ productId, }) {
+    return _jsx(EntityChannelMembership, { entityType: "product", entityId: productId });
+}
+/**
+ * The zone renderer loads a contribution through a dynamic-import factory and
+ * reads its default export (feature 091, FR-013).
+ */
+export default ProductChannelMembership;
+//# sourceMappingURL=ProductChannelMembership.js.map

package/dist/admin/zones/ProductChannelMembership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductChannelMembership.js","sourceRoot":"","sources":["../../../src/admin/zones/ProductChannelMembership.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAiBnF,MAAM,UAAU,wBAAwB,CAAC,EACvC,SAAS,GACqB;IAC9B,OAAO,KAAC,uBAAuB,IAAC,UAAU,EAAC,SAAS,EAAC,QAAQ,EAAE,SAAS,GAAI,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,eAAe,wBAAwB,CAAC"}

package/dist/backend/commands/set-default.command.d.ts

@@ -0,0 +1,53 @@
+import type { Command } from '@endora-commerce/platform/commands';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+/**
+ * Moving the `system_default` flag — feature 072 / D-51, Principle XIII.
+ *
+ * The third property of the product owner's invariant: exactly one channel is
+ * the default, and the flag is **movable**. The first two have been enforced
+ * since feature 005 (a partial unique index, plus a boot reconciler and three
+ * service refusals); this is the one nothing in the platform could do.
+ *
+ * It is a Command because it is the definition of a sensitive write: it changes
+ * where every unattributed order, every platform-wide fallback read and every
+ * orphan rebind lands, and the operator who did it has to be recoverable from
+ * the audit trail. The audit row names both channels — `stateBefore` the one
+ * that held the flag, `stateAfter` the one that holds it now — because "which
+ * channel was the default in March" is the question this row exists to answer.
+ *
+ * **Not `reversible`.** The registry's `reversible` marks commands wired into
+ * the operator-facing undo of feature 054 (a `RevertRecord` set on a bulk
+ * operation row), and there is no such surface for a single channel flag. The
+ * move is undone by making the same call against the previous default, whose
+ * code the response and the audit row both carry — an inverse an operator can
+ * perform, not a stored revert state.
+ */
+export interface SetSystemDefaultChannelResult {
+    /** The channel that holds the flag once the command has run. */
+    readonly channel: SalesChannel;
+    /**
+     * The code that held the flag when the command started — the channel a
+     * subsequent `set-default` would move it back to. `null` only in the state the
+     * boot reconciler exists to repair: a table with rows but no default at all.
+     */
+    readonly previousDefaultCode: string | null;
+    /** False when the target already held the flag; the call wrote nothing. */
+    readonly changed: boolean;
+}
+/**
+ * Demote-then-promote, in this order, inside the Command Bus's transaction.
+ *
+ * `sales_channels_one_system_default` is a partial unique index and Postgres
+ * cannot defer one, so the two updates are two statements with the demote
+ * first — the flag has to be off the old row before it can land on the new one.
+ * Assigning both and flushing once is **not** equivalent: MikroORM decides the
+ * statement order for a change set, and the promote-first ordering trips the
+ * index. That is also why a concurrent second move blocks on the index and then
+ * fails closed rather than racing, which is the behaviour we want.
+ *
+ * Both guards live inside the transaction rather than in the caller: the
+ * caller's lookup produces the 404 and a readable message, this one is what is
+ * still true at the moment of the write.
+ */
+export declare function makeSetSystemDefaultChannelCommand(channelId: string): Command<SetSystemDefaultChannelResult>;
+//# sourceMappingURL=set-default.command.d.ts.map

package/dist/backend/commands/set-default.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-default.command.d.ts","sourceRoot":"","sources":["../../../src/backend/commands/set-default.command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,6BAA6B;IAC5C,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,6BAA6B,CAAC,CAmFxC"}

package/dist/backend/commands/set-default.command.js

@@ -0,0 +1,87 @@
+import { randomUUID } from 'node:crypto';
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+/**
+ * Demote-then-promote, in this order, inside the Command Bus's transaction.
+ *
+ * `sales_channels_one_system_default` is a partial unique index and Postgres
+ * cannot defer one, so the two updates are two statements with the demote
+ * first — the flag has to be off the old row before it can land on the new one.
+ * Assigning both and flushing once is **not** equivalent: MikroORM decides the
+ * statement order for a change set, and the promote-first ordering trips the
+ * index. That is also why a concurrent second move blocks on the index and then
+ * fails closed rather than racing, which is the behaviour we want.
+ *
+ * Both guards live inside the transaction rather than in the caller: the
+ * caller's lookup produces the 404 and a readable message, this one is what is
+ * still true at the moment of the write.
+ */
+export function makeSetSystemDefaultChannelCommand(channelId) {
+    return {
+        action: 'sales_channel.set_default',
+        objectType: 'sales_channel',
+        objectId: channelId,
+        run: async ({ em }) => {
+            const target = await em.findOne(SalesChannel, { id: channelId });
+            if (target === null) {
+                throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'The sales channel to promote no longer exists.');
+            }
+            const current = await em.findOne(SalesChannel, { systemDefault: true });
+            // Already the default: a no-op success, not an error. A retried request and
+            // a double-clicked button answer the same 200, and `skipAudit` keeps "no
+            // write ⇒ no audit row" honest.
+            if (target.systemDefault) {
+                return {
+                    result: { channel: target, previousDefaultCode: target.code, changed: false },
+                    skipAudit: true,
+                };
+            }
+            // A default nobody can transact on is not a default. The mirror of the
+            // three refusals that keep the default channel from being deactivated or
+            // deleted (`sales-channels.service.ts:231/272/317`): they stop the flag's
+            // holder from going inactive, this stops an inactive channel from becoming
+            // the holder.
+            if (!target.active) {
+                throw new HttpError(422, ERROR_CODES.INACTIVE_SALES_CHANNEL, `Sales channel "${target.code}" is inactive and cannot become the system default. ` +
+                    `Activate it first.`);
+            }
+            const before = current === null ? null : { id: current.id, code: current.code };
+            // 1. Demote, and get it into the database before step 2 exists.
+            if (current !== null) {
+                current.systemDefault = false;
+                current.version += 1;
+                await em.flush();
+            }
+            // 2. Promote.
+            target.systemDefault = true;
+            target.version += 1;
+            await em.flush();
+            return {
+                result: {
+                    channel: target,
+                    previousDefaultCode: current?.code ?? null,
+                    changed: true,
+                },
+                before,
+                after: { id: target.id, code: target.code },
+            };
+        },
+        event: (result) => result.changed
+            ? {
+                eventName: 'sales_channels.lifecycle_changed',
+                payload: {
+                    eventId: randomUUID(),
+                    occurredAt: new Date().toISOString(),
+                    channelCode: result.channel.code,
+                    // Two rows changed identity-bearing state, and the cache is keyed
+                    // by code with `systemDefault` inside the cached value — so the
+                    // demoted channel's entry is stale too. Same shape the delete path
+                    // uses for the same reason.
+                    invalidateAll: true,
+                },
+            }
+            : undefined,
+    };
+}
+//# sourceMappingURL=set-default.command.js.map

package/dist/backend/commands/set-default.command.js.map

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

package/dist/backend/index.d.ts

@@ -0,0 +1,71 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { FastifyRequest } from 'fastify';
+import type { DictionaryValidator, SalesChannelAttributionRegistryPort } from '@endora-commerce/contracts';
+import type { CommandBus } from '@endora-commerce/platform/commands';
+import type { EventBus } from '@endora-commerce/platform/events';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+import type { SalesChannelsCache } from '@endora-commerce/platform/kernel';
+import type { SalesChannelMembershipPort } from '@endora-commerce/platform/kernel';
+import { SalesChannelsService } from './services/sales-channels.service.js';
+import type { AdminAuditContext } from './services/sales-channels.service.js';
+/**
+ * `sales_channels` — what is left after the kernel took the resolution
+ * machinery (feature 072, wave 2, T110).
+ *
+ * T019 moved the cache, the resolver, the membership service, the middleware
+ * and the default-channel reconciler into `kernel/sales-channels/`, and this
+ * conversion finishes the thought: a composition root composes those through
+ * `composeSalesChannelsKernel`, and the module keeps only what an operator
+ * would recognise as the module — the admin CRUD service and its routes.
+ *
+ * The division is not cosmetic. Resolving which channel a request belongs to
+ * backs every channel-scoped read in the platform (Principle XII), so it must
+ * not be gated on this module: switching the administration screens off would
+ * otherwise leave every storefront request with no resolved channel.
+ *
+ * **`dictionaryValidator` was optional, and never once supplied.** Neither
+ * composition passed it, so `SalesChannelsService` has been skipping the
+ * language- and currency-code checks it declares — creating a channel with a
+ * language nothing in the platform speaks is accepted today, silently. It is a
+ * declared dependency now, not an option: its absence removes a check rather
+ * than a capability, which is the line these conversions have been drawing.
+ */
+export interface SalesChannelsCradle {
+    readonly emFactory: () => EntityManager;
+    readonly eventBus: EventBus;
+    readonly auditLogService: AuditPort;
+    /** D-51 — moving the system-default flag is a Command (Principle XIII). */
+    readonly commandBus: CommandBus;
+    readonly requireAdmin: RequireAdminFactory;
+    readonly adminAuditActorResolver: (req: FastifyRequest) => AdminAuditContext;
+    /** Kernel-composed, so it is the same cache the resolver reads through. */
+    readonly salesChannelsCache: SalesChannelsCache;
+    readonly salesChannelMembershipPort: SalesChannelMembershipPort;
+    readonly dictionaryValidator: DictionaryValidator;
+    /**
+     * Owned here, contributed to from `orders` and `quote_requests` (feature 075,
+     * D-87). A plain registration, not a port: a contributor pushes into it from
+     * a boot hook, and a gate there would stop the backend from starting.
+     */
+    readonly salesChannelAttributionRegistry: SalesChannelAttributionRegistryPort;
+    readonly salesChannelsService: SalesChannelsService;
+}
+export declare function registerModule(ctx: ModuleContext): void;
+/**
+ * This module owns **no persisted entity**, and says so with an empty array
+ * rather than by omission (D-168).
+ *
+ * The two are not the same thing to the platform. When the package is
+ * *installed*, `src/packages/package-runtime.ts` reads `exported['entities']`
+ * and answers a missing export with `[]` — so "this module has no table" and
+ * "somebody forgot the array" arrive at the host as the same silence, and the
+ * only symptom of the second is a query against a table nobody created. The
+ * declaration is what makes the first case a statement.
+ *
+ * A first entity added here goes in this array in the same merge request, and
+ * `test/unit/packages/module-package-entity-surface.test.ts` is what says so.
+ */
+export declare const entities: readonly never[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EACV,mBAAmB,EACnB,mCAAmC,EACpC,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAEnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,sCAAsC,CAAC;AAIjG;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,aAAa,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,uBAAuB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,iBAAiB,CAAC;IAC7E,2EAA2E;IAC3E,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,QAAQ,CAAC,0BAA0B,EAAE,0BAA0B,CAAC;IAChE,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAClD;;;;OAIG;IACH,QAAQ,CAAC,+BAA+B,EAAE,mCAAmC,CAAC;IAC9E,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;CACrD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAkFvD;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,KAAK,EAAO,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,81 @@
+import { lazyPort } from '@endora-commerce/platform/kernel';
+import { SalesChannelAttributionRegistry } from './services/sales-channel-attribution-registry.js';
+import { SalesChannelsService } from './services/sales-channels.service.js';
+import { registerSalesChannelsAdminRoutes } from './routes.admin.js';
+import { registerSalesChannelsStorefrontRoutes } from './routes.storefront.js';
+export function registerModule(ctx) {
+    ctx.di.register({
+        /**
+         * "Who is still attributed to this channel?" — the contribution seam the
+         * FR-006 delete guard reads (feature 075, D-87). `SalesChannelsService`
+         * used to answer it here, with one statement naming `orders` and
+         * `quote_requests`; each owner counts its own rows now.
+         *
+         * `di.register`, not `di.providePort`: `orders` and `quote_requests` push
+         * into this from their own boot hooks, and a gate resolved there would
+         * refuse at a point in the boot that has nothing to answer. This module is
+         * `nonDeactivatable`, so there is no flip for a gate to protect either.
+         */
+        salesChannelAttributionRegistry: ctx
+            .asFunction(() => new SalesChannelAttributionRegistry())
+            .singleton(),
+    });
+    ctx.di.providePort('salesChannelsService', ctx
+        .asFunction(({ emFactory, eventBus, auditLogService, commandBus, salesChannelAttributionRegistry, }) => new SalesChannelsService(emFactory, eventBus, 
+    // Another module's port, so it is resolved per call rather than
+    // captured. Required since feature 075 — the branch its absence
+    // used to take was a raw `select` over `languages` and
+    // `currencies`, and it is gone.
+    lazyPort(ctx, 'dictionaryValidator'), 
+    // This module's own registration, so it is captured like `emFactory`.
+    salesChannelAttributionRegistry, 
+    // Feature 120 (FR-015) — which table holds each entity type's
+    // memberships, said by the module that owns the entity type. A
+    // kernel registration a root contributes, resolved per call rather
+    // than captured for the same reason `salesChannelsCache` is: the
+    // registry is filled by every owning module's boot hook, so a value
+    // captured while this module registers would be the empty one.
+    lazyPort(ctx, 'salesChannelBridgeRegistry'), auditLogService, 
+    // Resolved per call rather than captured: the cache is composed by a
+    // root. Narrowed to the invalidating half (D-93): this service drops
+    // the cache at its write seam and must not be able to seed it, which
+    // is the resolver's job.
+    lazyPort(ctx, 'salesChannelsCache'), 
+    // A deployment input, like `emFactory` and `eventBus` — not a port,
+    // so it is captured with them.
+    commandBus))
+        .singleton());
+    ctx.routes(async (app) => {
+        const { salesChannelMembershipPort, requireAdmin } = ctx.cradle();
+        await registerSalesChannelsAdminRoutes(app, {
+            // Lazily, even though the module owns this port: route *registration* runs
+            // inside `buildServer` whatever the module's effective state is, so
+            // destructuring the gate here would stop the next start instead of
+            // stopping the routes (D-40).
+            salesChannelsService: lazyPort(ctx, 'salesChannelsService'),
+            membershipService: salesChannelMembershipPort,
+            requireAdmin,
+            resolveAdminAuditContext: (req) => ctx.cradle().adminAuditActorResolver(req),
+        });
+        // The public read of the resolved channel. It resolves nothing itself and
+        // takes no dependency, so it is registered beside the admin surface rather
+        // than in a second `ctx.routes` call.
+        await registerSalesChannelsStorefrontRoutes(app);
+    });
+}
+/**
+ * This module owns **no persisted entity**, and says so with an empty array
+ * rather than by omission (D-168).
+ *
+ * The two are not the same thing to the platform. When the package is
+ * *installed*, `src/packages/package-runtime.ts` reads `exported['entities']`
+ * and answers a missing export with `[]` — so "this module has no table" and
+ * "somebody forgot the array" arrive at the host as the same silence, and the
+ * only symptom of the second is a query against a table nobody created. The
+ * declaration is what makes the first case a statement.
+ *
+ * A first entity added here goes in this array in the same merge request, and
+ * `test/unit/packages/module-package-entity-surface.test.ts` is what says so.
+ */
+export const entities = [];
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAO5D,OAAO,EAAE,+BAA+B,EAAE,MAAM,kDAAkD,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAE5E,OAAO,EAAE,gCAAgC,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,qCAAqC,EAAE,MAAM,wBAAwB,CAAC;AA8C/E,MAAM,UAAU,cAAc,CAAC,GAAkB;IAC/C,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC;QACd;;;;;;;;;;WAUG;QACH,+BAA+B,EAAE,GAAG;aACjC,UAAU,CACT,GAAwC,EAAE,CAAC,IAAI,+BAA+B,EAAE,CACjF;aACA,SAAS,EAAE;KACf,CAAC,CAAC;IAEH,GAAG,CAAC,EAAE,CAAC,WAAW,CAChB,sBAAsB,EACtB,GAAG;SACA,UAAU,CACT,CAAC,EACC,SAAS,EACT,QAAQ,EACR,eAAe,EACf,UAAU,EACV,+BAA+B,GACX,EAAE,EAAE,CACxB,IAAI,oBAAoB,CACtB,SAAS,EACT,QAAQ;IACR,gEAAgE;IAChE,gEAAgE;IAChE,uDAAuD;IACvD,gCAAgC;IAChC,QAAQ,CAAsB,GAAG,EAAE,qBAAqB,CAAC;IACzD,sEAAsE;IACtE,+BAA+B;IAC/B,8DAA8D;IAC9D,+DAA+D;IAC/D,mEAAmE;IACnE,iEAAiE;IACjE,oEAAoE;IACpE,+DAA+D;IAC/D,QAAQ,CAAoB,GAAG,EAAE,4BAA4B,CAAC,EAC9D,eAAe;IACf,qEAAqE;IACrE,qEAAqE;IACrE,qEAAqE;IACrE,yBAAyB;IACzB,QAAQ,CAAiC,GAAG,EAAE,oBAAoB,CAAC;IACnE,oEAAoE;IACpE,+BAA+B;IAC/B,UAAU,CACX,CACJ;SACA,SAAS,EAAE,CACf,CAAC;IAEF,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,EAAE,0BAA0B,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,EAAuB,CAAC;QAEvF,MAAM,gCAAgC,CAAC,GAAG,EAAE;YAC1C,2EAA2E;YAC3E,oEAAoE;YACpE,mEAAmE;YACnE,8BAA8B;YAC9B,oBAAoB,EAAE,QAAQ,CAAuB,GAAG,EAAE,sBAAsB,CAAC;YACjF,iBAAiB,EAAE,0BAA0B;YAC7C,YAAY;YACZ,wBAAwB,EAAE,CAAC,GAAG,EAAE,EAAE,CAChC,GAAG,CAAC,MAAM,EAAuB,CAAC,uBAAuB,CAAC,GAAG,CAAC;SACjE,CAAC,CAAC;QAEH,0EAA0E;QAC1E,2EAA2E;QAC3E,sCAAsC;QACtC,MAAM,qCAAqC,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAqB,EAAE,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { FastifyInstance, FastifyRequest } from 'fastify';
+import type { AdminAuditContext, SalesChannelsService } from './services/sales-channels.service.js';
+import type { SalesChannelMembershipPort } from '@endora-commerce/platform/kernel';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+export interface SalesChannelsAdminDeps {
+    salesChannelsService: SalesChannelsService;
+    membershipService: SalesChannelMembershipPort;
+    requireAdmin: RequireAdminFactory;
+    resolveAdminAuditContext?: (req: FastifyRequest) => AdminAuditContext;
+}
+export declare function registerSalesChannelsAdminRoutes(app: FastifyInstance, deps: SalesChannelsAdminDeps): Promise<void>;
+//# sourceMappingURL=routes.admin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.admin.d.ts","sourceRoot":"","sources":["../../src/backend/routes.admin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgB,cAAc,EAAE,MAAM,SAAS,CAAC;AAW7E,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAEnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AA4D5E,MAAM,WAAW,sBAAsB;IACrC,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,iBAAiB,EAAE,0BAA0B,CAAC;IAC9C,YAAY,EAAE,mBAAmB,CAAC;IAClC,wBAAwB,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,iBAAiB,CAAC;CACvE;AAED,wBAAsB,gCAAgC,CACpD,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAoXf"}