@endora-commerce/mod-currencies 0.100.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
+
+# @endora-commerce/mod-currencies
+
+Currency reference data and per-channel currency configuration.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `currencies` — the identity of record in the platform's registries, in its migrations and in its setting, permission and translation codes.
+
+A module is not imported by application code. The platform discovers the extension packages an instance has installed, reads the manifest on the root subpath and composes the module from it, so installing this package and starting the instance is the whole integration.
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@endora-commerce/mod-currencies` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-currencies/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+
+## Depends on
+
+Everything below is a **peer** dependency, so the application resolves exactly one copy of each — two copies of a host or of React are a runtime failure rather than a type error. An entry marked *optional* is needed only by the layers that use it.
+
+**Endora packages**
+
+- `@endora-commerce/contracts`
+- `@endora-commerce/platform`
+
+**Third-party**
+
+- `@mikro-orm/core` ^6
+- `@mikro-orm/postgresql` ^6
+- `fastify` ^5
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `docs/` — the package’s own pages in the Endora Commerce documentation site
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-currencies
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/backend/entities/currency.entity.d.ts

@@ -0,0 +1,22 @@
+import { OptionalProps } from '@mikro-orm/core';
+/**
+ * Currency — ISO 4217 codes the platform accepts (T238 / FR-105).
+ * Exactly zero or one row has `isDefault=true`, enforced by a partial
+ * unique index in the migration.
+ */
+export declare class Currency {
+    [OptionalProps]?: 'createdAt' | 'updatedAt' | 'isDefault' | 'isActive' | 'sortOrder' | 'symbolPosition' | 'decimalPlaces';
+    code: string;
+    label: string;
+    symbol: string;
+    /** Where the symbol appears relative to the amount. Extended by feature 017. */
+    symbolPosition: 'prefix' | 'suffix';
+    /** Currency's typical fractional precision (0 for JPY, 2 for most, 3 for BHD). */
+    decimalPlaces: number;
+    isDefault: boolean;
+    isActive: boolean;
+    sortOrder: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=currency.entity.d.ts.map

package/dist/backend/entities/currency.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/currency.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,aAAa,EAAwB,MAAM,iBAAiB,CAAC;AAG9E;;;;GAIG;AACH,qBAEa,QAAQ;IACnB,CAAC,aAAa,CAAC,CAAC,EACZ,WAAW,GACX,WAAW,GACX,WAAW,GACX,UAAU,GACV,WAAW,GACX,gBAAgB,GAChB,eAAe,CAAC;IAGpB,IAAI,EAAG,MAAM,CAAC;IAGd,KAAK,EAAG,MAAM,CAAC;IAGf,MAAM,EAAG,MAAM,CAAC;IAEhB,gFAAgF;IAEhF,cAAc,EAAE,QAAQ,GAAG,QAAQ,CAAY;IAE/C,kFAAkF;IAElF,aAAa,EAAE,MAAM,CAAK;IAG1B,SAAS,EAAE,OAAO,CAAS;IAG3B,QAAQ,EAAE,OAAO,CAAQ;IAGzB,SAAS,EAAE,MAAM,CAAK;IAGtB,SAAS,EAAE,IAAI,CAAc;IAG7B,SAAS,EAAE,IAAI,CAAc;CAC9B"}

package/dist/backend/entities/currency.entity.js

@@ -0,0 +1,77 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, OptionalProps, PrimaryKey, Property } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+/**
+ * Currency — ISO 4217 codes the platform accepts (T238 / FR-105).
+ * Exactly zero or one row has `isDefault=true`, enforced by a partial
+ * unique index in the migration.
+ */
+let Currency = class Currency {
+    [OptionalProps];
+    code;
+    label;
+    symbol;
+    /** Where the symbol appears relative to the amount. Extended by feature 017. */
+    symbolPosition = 'suffix';
+    /** Currency's typical fractional precision (0 for JPY, 2 for most, 3 for BHD). */
+    decimalPlaces = 2;
+    isDefault = false;
+    isActive = true;
+    sortOrder = 0;
+    createdAt = new Date();
+    updatedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'string', length: 3 }),
+    __metadata("design:type", String)
+], Currency.prototype, "code", void 0);
+__decorate([
+    Property({ type: 'string', length: 64 }),
+    __metadata("design:type", String)
+], Currency.prototype, "label", void 0);
+__decorate([
+    Property({ type: 'string', length: 8 }),
+    __metadata("design:type", String)
+], Currency.prototype, "symbol", void 0);
+__decorate([
+    Property({ type: 'string', length: 8 }),
+    __metadata("design:type", String)
+], Currency.prototype, "symbolPosition", void 0);
+__decorate([
+    Property({ type: 'smallint' }),
+    __metadata("design:type", Number)
+], Currency.prototype, "decimalPlaces", void 0);
+__decorate([
+    Property({ type: 'boolean' }),
+    __metadata("design:type", Boolean)
+], Currency.prototype, "isDefault", void 0);
+__decorate([
+    Property({ type: 'boolean' }),
+    __metadata("design:type", Boolean)
+], Currency.prototype, "isActive", void 0);
+__decorate([
+    Property({ type: 'integer' }),
+    __metadata("design:type", Number)
+], Currency.prototype, "sortOrder", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], Currency.prototype, "createdAt", void 0);
+__decorate([
+    Property({ type: 'datetime', onUpdate: () => new Date() }),
+    __metadata("design:type", Date)
+], Currency.prototype, "updatedAt", void 0);
+Currency = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'currencies' })
+], Currency);
+export { Currency };
+//# sourceMappingURL=currency.entity.js.map

package/dist/backend/entities/currency.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/currency.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE;;;;GAIG;AAGI,IAAM,QAAQ,GAAd,MAAM,QAAQ;IACnB,CAAC,aAAa,CAAC,CAOK;IAGpB,IAAI,CAAU;IAGd,KAAK,CAAU;IAGf,MAAM,CAAU;IAEhB,gFAAgF;IAEhF,cAAc,GAAwB,QAAQ,CAAC;IAE/C,kFAAkF;IAElF,aAAa,GAAW,CAAC,CAAC;IAG1B,SAAS,GAAY,KAAK,CAAC;IAG3B,QAAQ,GAAY,IAAI,CAAC;IAGzB,SAAS,GAAW,CAAC,CAAC;IAGtB,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;IAG7B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AA9BC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;;sCAC5B;AAGd;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;uCAC1B;AAGf;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;;wCACxB;AAIhB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;;gDACO;AAI/C;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;;+CACL;AAG1B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;2CACH;AAG3B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;0CACL;AAGzB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;2CACR;AAGtB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;2CAAc;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;2CAAc;AAxClB,QAAQ;IAFpB,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;GACvB,QAAQ,CAyCpB"}

package/dist/backend/index.d.ts

@@ -0,0 +1,53 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type DictionaryReferenceRegistryPort } from '@endora-commerce/contracts';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import { type ModuleContext, type RequireAdminFactory } from '@endora-commerce/platform/kernel';
+import { CurrencyService } from './services/currency-service.js';
+import { Currency } from './entities/currency.entity.js';
+/**
+ * `currencies` — one service, where there were two (feature 072, wave 1).
+ *
+ * The module used to own no routes: `dictionaries` served
+ * `/api/v1/admin/dictionary/currencies/*` and `languages` served
+ * `/api/v1/admin/currencies/*`. Both write the same table, and **each built its
+ * own `CurrencyService` with different constructor arguments** — `dictionaries`
+ * passed the dictionary invalidator, `languages` passed `undefined`.
+ *
+ * That is not a tidiness problem. `CurrencyService.setDefault` and `.remove`
+ * call the invalidator, so the same delete performed through the second surface
+ * left `DictionaryValidator`'s cache holding a code whose row was gone — and
+ * the validator's job is to *accept or reject* codes, so the failure is a stale
+ * **accept**: the next write referencing that currency passes validation and
+ * lands a dangling reference. `test/integration/currencies/one-currency-service.test.ts`
+ * pins it.
+ *
+ * One registration removes the class of bug rather than this instance of it.
+ * The invalidator is read from the cradle at call time, because `dictionaries`
+ * builds it inside its own factory and is not converted yet; resolving it
+ * lazily is also what a port would do, so nothing here has to change again when
+ * `dictionaries` converts.
+ */
+export interface CurrenciesCradle {
+    readonly emFactory: () => EntityManager;
+    readonly requireAdmin: RequireAdminFactory;
+    readonly auditLogService: AuditPort;
+    readonly eventBus: {
+        emit: (event: string, payload: unknown) => void;
+    };
+    readonly currencyService: CurrencyService;
+    readonly currencyReferenceRegistry: DictionaryReferenceRegistryPort;
+}
+export declare function registerModule(ctx: ModuleContext): void;
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ */
+export declare const entities: (typeof Currency)[];
+//# 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,EAKL,KAAK,+BAA+B,EACrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAIjE,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,aAAa,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAC;IACvE,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,yBAAyB,EAAE,+BAA+B,CAAC;CACrE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAuGvD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,qBAEpB,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,108 @@
+import { CURRENCY_CHANGED_EVENT, } from '@endora-commerce/contracts';
+import { lazyPort, } from '@endora-commerce/platform/kernel';
+import { CurrencyService } from './services/currency-service.js';
+import { CurrencyReadService, createCurrencyAdminPort } from './services/currency-ports.js';
+import { CurrencyReferenceRegistry } from './services/currency-reference-registry.js';
+import { CurrencySeedService } from './services/currency-seed-service.js';
+import { Currency } from './entities/currency.entity.js';
+import { registerCurrencyRoutes } from './routes.js';
+export function registerModule(ctx) {
+    ctx.di.register({
+        currencyService: ctx
+            .asFunction(({ emFactory, auditLogService }) => {
+            // Announce, do not call. Whoever caches currency data subscribes and
+            // drops its own; this module does not learn who they are, which is
+            // what keeps the dependency graph acyclic and the module detachable
+            // (Constitution I).
+            const announce = async () => {
+                ctx.cradle().eventBus.emit(CURRENCY_CHANGED_EVENT, {});
+            };
+            return new CurrencyService(emFactory, announce, auditLogService, () => ctx.cradle().currencyReferenceRegistry);
+        })
+            .singleton(),
+    });
+    // ---------------------------------------------------------------------------
+    // Feature 077 (D-87 drain) — who still points at a currency?
+    //
+    // `CurrencyService.remove` used to answer that with five hand-written counts
+    // over `promotions`, `price_lists`, `dictionaries` and the kernel's channels.
+    // Three of the four named another module's table in a string, which no
+    // import-level boundary check can see. Contributors push a descriptor from
+    // their own boot hook now, and this module asks the registry instead.
+    //
+    // A plain `ctx.di.register`, not a port: a contributor resolves it from a boot
+    // hook, and a boot hook that resolved a transient gate would stop the backend
+    // from starting the moment this module was switched off. The descriptor is
+    // inert; `currencyAdminPort`, which writes currencies, is the port and does
+    // fail closed. Enumeration policy is stated at the class.
+    ctx.di.register({
+        currencyReferenceRegistry: ctx
+            .asFunction(() => new CurrencyReferenceRegistry())
+            .singleton(),
+    });
+    /**
+     * The insert `dictionaries` needs against this table. Its catalogue exists so
+     * that `countries.default_currency_code` is satisfiable on a fresh install;
+     * it used to write the 53 rows here as raw SQL from its own reconciler.
+     */
+    ctx.di.providePort('currencySeedPort', ctx
+        .asFunction(({ emFactory }) => new CurrencySeedService(emFactory))
+        .singleton());
+    // ---------------------------------------------------------------------------
+    // Feature 075, Phase P — the published surface.
+    //
+    // Six of the fifteen inbound sites read the `Currency` **entity** rather than
+    // this module's service: `dictionaries` resolving a label or validating a
+    // code. These two ports are what they and the service consumers rewire to.
+    //
+    // `currencyService` above keeps its plain `ctx.di.register`, unchanged,
+    // because retiring it is a cut and Phase P cuts nothing.
+    // ---------------------------------------------------------------------------
+    ctx.di.providePort('currencyReadPort', ctx
+        .asFunction(({ emFactory }) => new CurrencyReadService(emFactory))
+        .singleton());
+    ctx.di.providePort('currencyAdminPort', ctx
+        .asFunction(() => createCurrencyAdminPort(() => ctx.cradle().currencyService))
+        .singleton());
+    /**
+     * The admin surface for this module's own table (2026-08-29), moved here from
+     * `languages`.
+     *
+     * `ctx.routes` is what makes the module-presence gate structural: it wraps the
+     * whole registration, so every route this module ever adds is covered
+     * (Constitution XVII item 1, "never gate per handler"). `languages` had to say
+     * in a comment that the currency routes answered 503 when this module was
+     * absent, because there the gate was a property of the two ports it happened
+     * to resolve rather than of the registration.
+     *
+     * The two ports are resolved lazily and are this module's own — a
+     * self-resolution, so no boundary is crossed and the gates are the ones every
+     * other consumer already gets. Destructuring them here instead would run the
+     * gate at *registration* time, which `buildServer` performs whatever the
+     * module's effective state is, and so would stop the next start rather than
+     * the routes (D-40).
+     */
+    ctx.routes(async (app) => {
+        const { requireAdmin } = ctx.cradle();
+        await registerCurrencyRoutes(app, {
+            currencyRead: lazyPort(ctx, 'currencyReadPort'),
+            currencyAdmin: lazyPort(ctx, 'currencyAdminPort'),
+            requireAdmin,
+        });
+    });
+}
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ */
+export const entities = [
+    Currency,
+];
+//# 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":"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"}

package/dist/backend/routes.d.ts

@@ -0,0 +1,36 @@
+import type { FastifyInstance } from 'fastify';
+import { type CurrencyAdminPort, type CurrencyReadPort } from '@endora-commerce/contracts';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+/**
+ * The currency catalogue's own admin surface (2026-08-29).
+ *
+ * These four routes were registered by `languages` until this change, over the
+ * two ports this module publishes. Nothing about that arrangement was an
+ * accident of the screen they serve: the admin currency screen is
+ * `dictionaries`' (`/api/v1/admin/dictionary/currencies`), and no caller in
+ * this repository ever reached the four routes below. So `languages` hosted
+ * another module's write surface for no reason that survives being written
+ * down, and it hosted it on `catalog:write` — the code a merchandiser holds to
+ * edit a product description, which therefore also promoted a currency to the
+ * shop's default.
+ *
+ * Two things follow from the move and are the point of it. The authority is
+ * this module's own pair, `currencies:read` / `currencies:write`. And the
+ * module-presence gate is now the **registration** seam (`ctx.routes`), which
+ * is what Constitution XVII item 1 asks for — the hand-written "these answer
+ * 503 `MODULE_DISABLED` because the ports fail closed" note the old deps block
+ * carried was a rule an author had to remember, and it is now structural.
+ * `currencies` declares `activation.nonDeactivatable`, so today the gate can
+ * never bite; that is exactly why it should not rest on anybody's memory.
+ *
+ * `GET /api/v1/i18n/config` stays with `languages`: it answers with both
+ * catalogues at once and is a public read, so it is composition rather than
+ * ownership. `languages` keeps `currencyReadPort` for it and nothing else.
+ */
+export interface CurrencyAdminRoutesDeps {
+    currencyRead: CurrencyReadPort;
+    currencyAdmin: CurrencyAdminPort;
+    requireAdmin: RequireAdminFactory;
+}
+export declare function registerCurrencyRoutes(app: FastifyInstance, deps: CurrencyAdminRoutesDeps): Promise<void>;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/backend/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAEtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,aAAa,EAAE,iBAAiB,CAAC;IACjC,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAgDf"}

package/dist/backend/routes.js

@@ -0,0 +1,43 @@
+import { upsertCurrencyRequestSchema, } from '@endora-commerce/contracts';
+export async function registerCurrencyRoutes(app, deps) {
+    const { currencyRead, currencyAdmin, requireAdmin } = deps;
+    app.get('/api/v1/admin/currencies', { preHandler: requireAdmin('currencies:read') }, async () => {
+        const rows = await currencyRead.list();
+        return { data: rows.map(serializeCurrency) };
+    });
+    app.put('/api/v1/admin/currencies/:code', {
+        preHandler: requireAdmin('currencies:write'),
+        schema: { body: upsertCurrencyRequestSchema },
+    }, async (request) => {
+        const body = upsertCurrencyRequestSchema.parse(request.body);
+        const row = await currencyAdmin.upsert({
+            code: request.params.code,
+            label: body.label,
+            symbol: body.symbol,
+            ...(body.isActive !== undefined ? { isActive: body.isActive } : {}),
+            ...(body.sortOrder !== undefined ? { sortOrder: body.sortOrder } : {}),
+        });
+        return { data: serializeCurrency(row) };
+    });
+    app.post('/api/v1/admin/currencies/:code/default', { preHandler: requireAdmin('currencies:write') }, async (request) => {
+        const row = await currencyAdmin.setDefault(request.params.code);
+        return { data: serializeCurrency(row) };
+    });
+    app.delete('/api/v1/admin/currencies/:code', { preHandler: requireAdmin('currencies:write') }, async (request, reply) => {
+        await currencyAdmin.remove(request.params.code);
+        return reply.status(204).send();
+    });
+}
+function serializeCurrency(c) {
+    return {
+        code: c.code,
+        label: c.label,
+        symbol: c.symbol,
+        isDefault: c.isDefault,
+        isActive: c.isActive,
+        sortOrder: c.sortOrder,
+        createdAt: c.createdAt.toISOString(),
+        updatedAt: c.updatedAt.toISOString(),
+    };
+}
+//# sourceMappingURL=routes.js.map

package/dist/backend/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/backend/routes.ts"],"names":[],"mappings":"AACA,OAAO,EACL,2BAA2B,GAI5B,MAAM,4BAA4B,CAAC;AAmCpC,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAoB,EACpB,IAA6B;IAE7B,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAE3D,GAAG,CAAC,GAAG,CACL,0BAA0B,EAC1B,EAAE,UAAU,EAAE,YAAY,CAAC,iBAAiB,CAAC,EAAE,EAC/C,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;IAC/C,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,GAAG,CACL,gCAAgC,EAChC;QACE,UAAU,EAAE,YAAY,CAAC,kBAAkB,CAAC;QAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,2BAA2B,EAAE;KAC9C,EACD,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,MAAM,IAAI,GAAG,2BAA2B,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC;YACrC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvE,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1C,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,IAAI,CACN,wCAAwC,EACxC,EAAE,UAAU,EAAE,YAAY,CAAC,kBAAkB,CAAC,EAAE,EAChD,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChE,OAAO,EAAE,IAAI,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1C,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,MAAM,CACR,gCAAgC,EAChC,EAAE,UAAU,EAAE,YAAY,CAAC,kBAAkB,CAAC,EAAE,EAChD,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAiB;IAC1C,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE;QACpC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE;KACrC,CAAC;AACJ,CAAC"}

package/dist/backend/services/currency-ports.d.ts

@@ -0,0 +1,23 @@
+import type { CurrencyAdminPort, CurrencyReadPort, CurrencyRecord } from '@endora-commerce/contracts';
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { Currency } from '../entities/currency.entity.js';
+import type { CurrencyService } from './currency-service.js';
+/**
+ * The published face of `currencies` (feature 075, Phase P).
+ *
+ * The delivery-side twin of `languages`' ports, and the same split: six of the
+ * fifteen inbound sites read the `Currency` **entity** — `dictionaries`
+ * resolving a label or validating a code — and the rest type themselves
+ * against `CurrencyService`.
+ */
+export declare class CurrencyReadService implements CurrencyReadPort {
+    private readonly emFactory;
+    constructor(emFactory: () => EntityManager);
+    list(): Promise<CurrencyRecord[]>;
+    listActive(): Promise<CurrencyRecord[]>;
+    getDefault(): Promise<CurrencyRecord | null>;
+    findByCode(code: string): Promise<CurrencyRecord | null>;
+}
+export declare function createCurrencyAdminPort(getService: () => CurrencyService): CurrencyAdminPort;
+export declare function toCurrencyRecord(currency: Currency): CurrencyRecord;
+//# sourceMappingURL=currency-ports.d.ts.map

package/dist/backend/services/currency-ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-ports.d.ts","sourceRoot":"","sources":["../../../src/backend/services/currency-ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,aAAa;IAErD,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IASjC,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IASvC,UAAU,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK5C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CAI/D;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,eAAe,GAAG,iBAAiB,CAgB5F;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAanE"}

package/dist/backend/services/currency-ports.js

@@ -0,0 +1,63 @@
+import { Currency } from '../entities/currency.entity.js';
+/**
+ * The published face of `currencies` (feature 075, Phase P).
+ *
+ * The delivery-side twin of `languages`' ports, and the same split: six of the
+ * fifteen inbound sites read the `Currency` **entity** — `dictionaries`
+ * resolving a label or validating a code — and the rest type themselves
+ * against `CurrencyService`.
+ */
+export class CurrencyReadService {
+    emFactory;
+    constructor(emFactory) {
+        this.emFactory = emFactory;
+    }
+    async list() {
+        const rows = await this.emFactory().find(Currency, {}, { orderBy: { sortOrder: 'asc', code: 'asc' } });
+        return rows.map(toCurrencyRecord);
+    }
+    async listActive() {
+        const rows = await this.emFactory().find(Currency, { isActive: true }, { orderBy: { sortOrder: 'asc', code: 'asc' } });
+        return rows.map(toCurrencyRecord);
+    }
+    async getDefault() {
+        const row = await this.emFactory().findOne(Currency, { isDefault: true });
+        return row ? toCurrencyRecord(row) : null;
+    }
+    async findByCode(code) {
+        const row = await this.emFactory().findOne(Currency, { code });
+        return row ? toCurrencyRecord(row) : null;
+    }
+}
+export function createCurrencyAdminPort(getService) {
+    return {
+        async create(input) {
+            return toCurrencyRecord(await getService().create(input));
+        },
+        async upsert(input) {
+            return toCurrencyRecord(await getService().upsert(input));
+        },
+        async update(code, input) {
+            return toCurrencyRecord(await getService().update(code, input));
+        },
+        async setDefault(code) {
+            return toCurrencyRecord(await getService().setDefault(code));
+        },
+        remove: (code) => getService().remove(code),
+    };
+}
+export function toCurrencyRecord(currency) {
+    return {
+        code: currency.code,
+        label: currency.label,
+        symbol: currency.symbol,
+        symbolPosition: currency.symbolPosition,
+        decimalPlaces: currency.decimalPlaces,
+        isDefault: currency.isDefault,
+        isActive: currency.isActive,
+        sortOrder: currency.sortOrder,
+        createdAt: currency.createdAt,
+        updatedAt: currency.updatedAt,
+    };
+}
+//# sourceMappingURL=currency-ports.js.map

package/dist/backend/services/currency-ports.js.map

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

package/dist/backend/services/currency-reference-registry.d.ts

@@ -0,0 +1,30 @@
+import type { DictionaryReference, DictionaryReferenceDescriptor, DictionaryReferenceRegistryPort } from '@endora-commerce/contracts';
+/**
+ * In-process registry of "who still points at this currency code" descriptors
+ * (feature 077, D-87 drain).
+ *
+ * Registered under `currencyReferenceRegistry` and contributed to from other modules'
+ * boot hooks. This module consults it before deleting a currency, and
+ * `dictionaries` consults it to build the orphan report.
+ *
+ * **Enumeration policy: honoured while the contributing module is absent.**
+ * D-39's default is to skip, and honouring needs a written reason: this is
+ * referential integrity, not a surface. A switched-off module still owns the
+ * rows that carry the code, so skipping its descriptor would let an operator
+ * delete a currency that comes back as a dangling reference the moment the module
+ * is switched on again — data loss caused by an action Constitution XVII
+ * promises is non-destructive and reversible.
+ *
+ * `ownerModuleId` is recorded on every descriptor even though this registry
+ * does not filter on it, because the alternative is a registry that could not
+ * express the decision either way, and because it attributes a 409 to a module.
+ */
+export declare class CurrencyReferenceRegistry implements DictionaryReferenceRegistryPort {
+    private readonly descriptors;
+    register(descriptor: DictionaryReferenceDescriptor): void;
+    /** The contributing module of every registered descriptor, in registration order. */
+    owners(): readonly string[];
+    countReferences(code: string): Promise<DictionaryReference[]>;
+    usedCodes(): Promise<DictionaryReference[]>;
+}
+//# sourceMappingURL=currency-reference-registry.d.ts.map

package/dist/backend/services/currency-reference-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-reference-registry.d.ts","sourceRoot":"","sources":["../../../src/backend/services/currency-reference-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,+BAA+B,EAChC,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,yBAA0B,YAAW,+BAA+B;IAC/E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IAEnE,QAAQ,CAAC,UAAU,EAAE,6BAA6B,GAAG,IAAI;IAMzD,qFAAqF;IACrF,MAAM,IAAI,SAAS,MAAM,EAAE;IAIrB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAS7D,SAAS,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAQlD"}

package/dist/backend/services/currency-reference-registry.js

@@ -0,0 +1,54 @@
+/**
+ * In-process registry of "who still points at this currency code" descriptors
+ * (feature 077, D-87 drain).
+ *
+ * Registered under `currencyReferenceRegistry` and contributed to from other modules'
+ * boot hooks. This module consults it before deleting a currency, and
+ * `dictionaries` consults it to build the orphan report.
+ *
+ * **Enumeration policy: honoured while the contributing module is absent.**
+ * D-39's default is to skip, and honouring needs a written reason: this is
+ * referential integrity, not a surface. A switched-off module still owns the
+ * rows that carry the code, so skipping its descriptor would let an operator
+ * delete a currency that comes back as a dangling reference the moment the module
+ * is switched on again — data loss caused by an action Constitution XVII
+ * promises is non-destructive and reversible.
+ *
+ * `ownerModuleId` is recorded on every descriptor even though this registry
+ * does not filter on it, because the alternative is a registry that could not
+ * express the decision either way, and because it attributes a 409 to a module.
+ */
+export class CurrencyReferenceRegistry {
+    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 countReferences(code) {
+        const counts = await Promise.all(this.descriptors.map(async (d) => ({ descriptor: d, count: await d.countReferences(code) })));
+        return counts
+            .filter((row) => row.count > 0)
+            .map(({ descriptor, count }) => describe(descriptor, code, count));
+    }
+    async usedCodes() {
+        const perDescriptor = await Promise.all(this.descriptors.map(async (d) => ({ descriptor: d, rows: await d.usedCodes() })));
+        return perDescriptor.flatMap(({ descriptor, rows }) => rows.map((row) => describe(descriptor, row.code, row.count)));
+    }
+}
+function describe(descriptor, code, count) {
+    return {
+        ownerModuleId: descriptor.ownerModuleId,
+        consumer: descriptor.consumer,
+        tableName: descriptor.tableName,
+        columnName: descriptor.columnName,
+        code,
+        count,
+        blocking: descriptor.blocking,
+    };
+}
+//# sourceMappingURL=currency-reference-registry.js.map

package/dist/backend/services/currency-reference-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-reference-registry.js","sourceRoot":"","sources":["../../../src/backend/services/currency-reference-registry.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,yBAAyB;IACnB,WAAW,GAAoC,EAAE,CAAC;IAEnE,QAAQ,CAAC,UAAyC;QAChD,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,IAAY;QAChC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAC7F,CAAC;QACF,OAAO,MAAM;aACV,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;aAC9B,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAClF,CAAC;QACF,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,CACpD,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAC7D,CAAC;IACJ,CAAC;CACF;AAED,SAAS,QAAQ,CACf,UAAyC,EACzC,IAAY,EACZ,KAAa;IAEb,OAAO;QACL,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,IAAI;QACJ,KAAK;QACL,QAAQ,EAAE,UAAU,CAAC,QAAQ;KAC9B,CAAC;AACJ,CAAC"}