@endora-commerce/contracts 0.100.0

package/dist/dictionary.d.ts

@@ -0,0 +1,580 @@
+import { z } from 'zod';
+export declare const REGIONS: readonly ["Africa", "Americas", "Asia", "Europe", "Oceania", "Antarctic"];
+export declare const regionSchema: z.ZodEnum<{
+    Africa: "Africa";
+    Americas: "Americas";
+    Asia: "Asia";
+    Europe: "Europe";
+    Oceania: "Oceania";
+    Antarctic: "Antarctic";
+}>;
+export type Region = z.infer<typeof regionSchema>;
+export declare const symbolPositionSchema: z.ZodEnum<{
+    prefix: "prefix";
+    suffix: "suffix";
+}>;
+export type SymbolPosition = z.infer<typeof symbolPositionSchema>;
+export declare const dictionaryEntryTypeSchema: z.ZodEnum<{
+    language: "language";
+    currency: "currency";
+    country: "country";
+}>;
+export type DictionaryEntryType = z.infer<typeof dictionaryEntryTypeSchema>;
+export declare const countrySchema: z.ZodObject<{
+    code: z.ZodString;
+    alpha3Code: z.ZodString;
+    numericCode: z.ZodString;
+    label: z.ZodString;
+    region: z.ZodEnum<{
+        Africa: "Africa";
+        Americas: "Americas";
+        Asia: "Asia";
+        Europe: "Europe";
+        Oceania: "Oceania";
+        Antarctic: "Antarctic";
+    }>;
+    subregion: z.ZodNullable<z.ZodString>;
+    dialCode: z.ZodNullable<z.ZodString>;
+    isEuMember: z.ZodBoolean;
+    defaultCurrencyCode: z.ZodNullable<z.ZodString>;
+    isActive: z.ZodBoolean;
+    isDefault: z.ZodBoolean;
+    sortOrder: z.ZodNumber;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type Country = z.infer<typeof countrySchema>;
+export declare const createCountryRequestSchema: z.ZodObject<{
+    code: z.ZodString;
+    alpha3Code: z.ZodString;
+    numericCode: z.ZodString;
+    label: z.ZodString;
+    region: z.ZodEnum<{
+        Africa: "Africa";
+        Americas: "Americas";
+        Asia: "Asia";
+        Europe: "Europe";
+        Oceania: "Oceania";
+        Antarctic: "Antarctic";
+    }>;
+    subregion: z.ZodOptional<z.ZodString>;
+    dialCode: z.ZodOptional<z.ZodString>;
+    isEuMember: z.ZodOptional<z.ZodBoolean>;
+    defaultCurrencyCode: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CreateCountryRequest = z.infer<typeof createCountryRequestSchema>;
+export declare const updateCountryRequestSchema: z.ZodObject<{
+    alpha3Code: z.ZodOptional<z.ZodString>;
+    numericCode: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodEnum<{
+        Africa: "Africa";
+        Americas: "Americas";
+        Asia: "Asia";
+        Europe: "Europe";
+        Oceania: "Oceania";
+        Antarctic: "Antarctic";
+    }>>;
+    subregion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dialCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isEuMember: z.ZodOptional<z.ZodBoolean>;
+    defaultCurrencyCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type UpdateCountryRequest = z.infer<typeof updateCountryRequestSchema>;
+export declare const dictionaryCurrencySchema: z.ZodObject<{
+    code: z.ZodString;
+    label: z.ZodString;
+    symbol: z.ZodString;
+    symbolPosition: z.ZodEnum<{
+        prefix: "prefix";
+        suffix: "suffix";
+    }>;
+    decimalPlaces: z.ZodNumber;
+    isDefault: z.ZodBoolean;
+    isActive: z.ZodBoolean;
+    sortOrder: z.ZodNumber;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type DictionaryCurrency = z.infer<typeof dictionaryCurrencySchema>;
+export declare const createDictionaryCurrencyRequestSchema: z.ZodObject<{
+    code: z.ZodString;
+    label: z.ZodString;
+    symbol: z.ZodString;
+    symbolPosition: z.ZodOptional<z.ZodEnum<{
+        prefix: "prefix";
+        suffix: "suffix";
+    }>>;
+    decimalPlaces: z.ZodOptional<z.ZodNumber>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CreateDictionaryCurrencyRequest = z.infer<typeof createDictionaryCurrencyRequestSchema>;
+export declare const updateDictionaryCurrencyRequestSchema: z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    symbol: z.ZodOptional<z.ZodString>;
+    symbolPosition: z.ZodOptional<z.ZodEnum<{
+        prefix: "prefix";
+        suffix: "suffix";
+    }>>;
+    decimalPlaces: z.ZodOptional<z.ZodNumber>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type UpdateDictionaryCurrencyRequest = z.infer<typeof updateDictionaryCurrencyRequestSchema>;
+export declare const dictionaryLanguageSchema: z.ZodObject<{
+    code: z.ZodString;
+    label: z.ZodString;
+    nativeLabel: z.ZodString;
+    isRtl: z.ZodBoolean;
+    fallbackCode: z.ZodNullable<z.ZodString>;
+    isDefault: z.ZodBoolean;
+    isActive: z.ZodBoolean;
+    sortOrder: z.ZodNumber;
+    countries: z.ZodArray<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type DictionaryLanguage = z.infer<typeof dictionaryLanguageSchema>;
+export declare const createDictionaryLanguageRequestSchema: z.ZodObject<{
+    code: z.ZodString;
+    label: z.ZodString;
+    nativeLabel: z.ZodString;
+    isRtl: z.ZodOptional<z.ZodBoolean>;
+    fallbackCode: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CreateDictionaryLanguageRequest = z.infer<typeof createDictionaryLanguageRequestSchema>;
+export declare const updateDictionaryLanguageRequestSchema: z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    nativeLabel: z.ZodOptional<z.ZodString>;
+    isRtl: z.ZodOptional<z.ZodBoolean>;
+    fallbackCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type UpdateDictionaryLanguageRequest = z.infer<typeof updateDictionaryLanguageRequestSchema>;
+export declare const dictionaryTranslationSchema: z.ZodObject<{
+    entryType: z.ZodEnum<{
+        language: "language";
+        currency: "currency";
+        country: "country";
+    }>;
+    entryCode: z.ZodString;
+    languageCode: z.ZodString;
+    label: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type DictionaryTranslation = z.infer<typeof dictionaryTranslationSchema>;
+export declare const upsertTranslationRequestSchema: z.ZodObject<{
+    label: z.ZodString;
+}, z.core.$strip>;
+export type UpsertTranslationRequest = z.infer<typeof upsertTranslationRequestSchema>;
+export declare const languageCountrySchema: z.ZodObject<{
+    languageCode: z.ZodString;
+    countryCode: z.ZodString;
+    isPrimary: z.ZodBoolean;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type LanguageCountry = z.infer<typeof languageCountrySchema>;
+export declare const upsertLanguageCountryRequestSchema: z.ZodObject<{
+    isPrimary: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type UpsertLanguageCountryRequest = z.infer<typeof upsertLanguageCountryRequestSchema>;
+export declare const dictionaryCountriesPageResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        alpha3Code: z.ZodString;
+        numericCode: z.ZodString;
+        label: z.ZodString;
+        region: z.ZodEnum<{
+            Africa: "Africa";
+            Americas: "Americas";
+            Asia: "Asia";
+            Europe: "Europe";
+            Oceania: "Oceania";
+            Antarctic: "Antarctic";
+        }>;
+        subregion: z.ZodNullable<z.ZodString>;
+        dialCode: z.ZodNullable<z.ZodString>;
+        isEuMember: z.ZodBoolean;
+        defaultCurrencyCode: z.ZodNullable<z.ZodString>;
+        isActive: z.ZodBoolean;
+        isDefault: z.ZodBoolean;
+        sortOrder: z.ZodNumber;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        pageSize: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type DictionaryCountriesPageResponse = z.infer<typeof dictionaryCountriesPageResponseSchema>;
+export declare const dictionaryCurrenciesPageResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+        symbol: z.ZodString;
+        symbolPosition: z.ZodEnum<{
+            prefix: "prefix";
+            suffix: "suffix";
+        }>;
+        decimalPlaces: z.ZodNumber;
+        isDefault: z.ZodBoolean;
+        isActive: z.ZodBoolean;
+        sortOrder: z.ZodNumber;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        pageSize: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type DictionaryCurrenciesPageResponse = z.infer<typeof dictionaryCurrenciesPageResponseSchema>;
+export declare const dictionaryLanguagesPageResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+        nativeLabel: z.ZodString;
+        isRtl: z.ZodBoolean;
+        fallbackCode: z.ZodNullable<z.ZodString>;
+        isDefault: z.ZodBoolean;
+        isActive: z.ZodBoolean;
+        sortOrder: z.ZodNumber;
+        countries: z.ZodArray<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        pageSize: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type DictionaryLanguagesPageResponse = z.infer<typeof dictionaryLanguagesPageResponseSchema>;
+export declare const resolvedCountrySchema: z.ZodObject<{
+    code: z.ZodString;
+    label: z.ZodString;
+    alpha3Code: z.ZodString;
+    numericCode: z.ZodString;
+    region: z.ZodEnum<{
+        Africa: "Africa";
+        Americas: "Americas";
+        Asia: "Asia";
+        Europe: "Europe";
+        Oceania: "Oceania";
+        Antarctic: "Antarctic";
+    }>;
+    subregion: z.ZodNullable<z.ZodString>;
+    dialCode: z.ZodNullable<z.ZodString>;
+    isEuMember: z.ZodBoolean;
+    defaultCurrencyCode: z.ZodNullable<z.ZodString>;
+    sortOrder: z.ZodNumber;
+}, z.core.$strip>;
+export type ResolvedCountry = z.infer<typeof resolvedCountrySchema>;
+export declare const resolvedCurrencySchema: z.ZodObject<{
+    code: z.ZodString;
+    label: z.ZodString;
+    symbol: z.ZodString;
+    symbolPosition: z.ZodEnum<{
+        prefix: "prefix";
+        suffix: "suffix";
+    }>;
+    decimalPlaces: z.ZodNumber;
+    sortOrder: z.ZodNumber;
+}, z.core.$strip>;
+export type ResolvedCurrency = z.infer<typeof resolvedCurrencySchema>;
+export declare const resolvedLanguageSchema: z.ZodObject<{
+    code: z.ZodString;
+    label: z.ZodString;
+    nativeLabel: z.ZodString;
+    isRtl: z.ZodBoolean;
+    fallbackCode: z.ZodNullable<z.ZodString>;
+    countries: z.ZodArray<z.ZodString>;
+    sortOrder: z.ZodNumber;
+}, z.core.$strip>;
+export type ResolvedLanguage = z.infer<typeof resolvedLanguageSchema>;
+export declare const dictionaryRegistryResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        countries: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            label: z.ZodString;
+            alpha3Code: z.ZodString;
+            numericCode: z.ZodString;
+            region: z.ZodEnum<{
+                Africa: "Africa";
+                Americas: "Americas";
+                Asia: "Asia";
+                Europe: "Europe";
+                Oceania: "Oceania";
+                Antarctic: "Antarctic";
+            }>;
+            subregion: z.ZodNullable<z.ZodString>;
+            dialCode: z.ZodNullable<z.ZodString>;
+            isEuMember: z.ZodBoolean;
+            defaultCurrencyCode: z.ZodNullable<z.ZodString>;
+            sortOrder: z.ZodNumber;
+        }, z.core.$strip>>;
+        currencies: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            label: z.ZodString;
+            symbol: z.ZodString;
+            symbolPosition: z.ZodEnum<{
+                prefix: "prefix";
+                suffix: "suffix";
+            }>;
+            decimalPlaces: z.ZodNumber;
+            sortOrder: z.ZodNumber;
+        }, z.core.$strip>>;
+        languages: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            label: z.ZodString;
+            nativeLabel: z.ZodString;
+            isRtl: z.ZodBoolean;
+            fallbackCode: z.ZodNullable<z.ZodString>;
+            countries: z.ZodArray<z.ZodString>;
+            sortOrder: z.ZodNumber;
+        }, z.core.$strip>>;
+        defaults: z.ZodObject<{
+            country: z.ZodNullable<z.ZodString>;
+            currency: z.ZodNullable<z.ZodString>;
+            language: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type DictionaryRegistryResponse = z.infer<typeof dictionaryRegistryResponseSchema>;
+export declare const dictionaryByCodeResponseSchema: z.ZodObject<{
+    data: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        entryType: z.ZodLiteral<"country">;
+        entry: z.ZodObject<{
+            code: z.ZodString;
+            label: z.ZodString;
+            alpha3Code: z.ZodString;
+            numericCode: z.ZodString;
+            region: z.ZodEnum<{
+                Africa: "Africa";
+                Americas: "Americas";
+                Asia: "Asia";
+                Europe: "Europe";
+                Oceania: "Oceania";
+                Antarctic: "Antarctic";
+            }>;
+            subregion: z.ZodNullable<z.ZodString>;
+            dialCode: z.ZodNullable<z.ZodString>;
+            isEuMember: z.ZodBoolean;
+            defaultCurrencyCode: z.ZodNullable<z.ZodString>;
+            sortOrder: z.ZodNumber;
+            isActive: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        entryType: z.ZodLiteral<"currency">;
+        entry: z.ZodObject<{
+            code: z.ZodString;
+            label: z.ZodString;
+            symbol: z.ZodString;
+            symbolPosition: z.ZodEnum<{
+                prefix: "prefix";
+                suffix: "suffix";
+            }>;
+            decimalPlaces: z.ZodNumber;
+            sortOrder: z.ZodNumber;
+            isActive: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        entryType: z.ZodLiteral<"language">;
+        entry: z.ZodObject<{
+            code: z.ZodString;
+            label: z.ZodString;
+            nativeLabel: z.ZodString;
+            isRtl: z.ZodBoolean;
+            fallbackCode: z.ZodNullable<z.ZodString>;
+            countries: z.ZodArray<z.ZodString>;
+            sortOrder: z.ZodNumber;
+            isActive: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>], "entryType">;
+}, z.core.$strip>;
+export type DictionaryByCodeResponse = z.infer<typeof dictionaryByCodeResponseSchema>;
+/**
+ * Write-mode dispatch for the DictionaryValidator port.
+ *
+ * - `create-or-change`: a new write OR an update that changes the field.
+ *   Both existence and active-status are required.
+ * - `unchanged`: an update that does NOT change the field. Existence is
+ *   required, active-status is NOT enforced — covers FR-016 (stored
+ *   references that go inactive must remain readable).
+ */
+export type DictionaryWriteMode = 'create-or-change' | 'unchanged';
+/**
+ * Container name: `dictionaryValidator`. Owner: `dictionaries`.
+ *
+ * Consumed by every module that accepts a country/currency/language reference
+ * on a write path — nine of them today, which is why the shape is declared
+ * here rather than in each of them: a consumer names this type and the
+ * container, never a file under `dictionaries` (Principle I).
+ *
+ * The wording used to say "wired via the composition root — consumer modules
+ * accept this port via plugin options". That stopped being true when the
+ * modules were composed by the kernel container (feature 072): the owner
+ * registers the name with `ctx.di.providePort` and each consumer resolves it
+ * with `lazyPort`.
+ *
+ * **Owner off:** the seam fails closed — resolving the port throws
+ * `ModuleDisabledError` and the call answers 503 `MODULE_DISABLED`, so a write
+ * that cannot have its country code checked is refused rather than accepted
+ * unchecked. Whether `dictionaries` has an off state at all is its manifest's
+ * `activation` to say, not this line's.
+ */
+export interface DictionaryValidator {
+    validateCountryCode(code: string, mode: DictionaryWriteMode): Promise<void>;
+    validateCurrencyCode(code: string, mode: DictionaryWriteMode): Promise<void>;
+    validateLanguageCode(code: string, mode: DictionaryWriteMode): Promise<void>;
+    /** Clear the in-process LRU. Called by every Dictionary write path. */
+    invalidate(): void;
+}
+/**
+ * Typed error thrown by the validator. Consumer modules' HTTP error handlers
+ * translate this into a 409 envelope per contracts/dictionary-validation.contract.md.
+ */
+export declare class DictionaryReferenceError extends Error {
+    readonly code: 'DICTIONARY_ENTRY_NOT_FOUND' | 'DICTIONARY_ENTRY_INACTIVE';
+    readonly entryType: DictionaryEntryType;
+    readonly entryCode: string;
+    constructor(args: {
+        code: 'DICTIONARY_ENTRY_NOT_FOUND' | 'DICTIONARY_ENTRY_INACTIVE';
+        entryType: DictionaryEntryType;
+        entryCode: string;
+        message?: string;
+    });
+}
+/**
+ * Decide which write mode a dictionary-referencing field is being validated
+ * under: `create-or-change` when the field is new or its value moved,
+ * `unchanged` when it did not.
+ *
+ * Relocated here from `dictionaries/services/dispatch-validator-mode.ts`
+ * (feature 075, Phase P) and published as a **function, not a port** — which
+ * contradicts `contracts/port-publication.md` §1.5, and the code is why. That
+ * section cites this file as the worked example of "yes, it reads state the
+ * module owns, so make it a port"; it reads nothing. It is three comparisons
+ * over its two arguments, and switching `dictionaries` off cannot change the
+ * answer, so a gated port would answer 503 to a question about two strings the
+ * caller already holds (FR-013).
+ *
+ * Five modules call it — `addresses`, `inventory`, `promotions`,
+ * `sales_channels` and `taxes` — immediately before calling the validator
+ * port, which *is* gated and *does* read state. Splitting the pure decision
+ * from the stateful validation is what lets the second fail closed without the
+ * first inventing a mode.
+ */
+export declare function dispatchValidatorMode(currentValue: string | null | undefined, incomingValue: string | null | undefined): DictionaryWriteMode;
+/**
+ * One consumer's answer about one dictionary code.
+ *
+ * The four descriptive fields are what the operator sees in the orphan report,
+ * and `ownerModuleId` is what attributes a refused delete to a module.
+ */
+export interface DictionaryReference {
+    ownerModuleId: string;
+    /** Operator-facing name of the consuming surface, e.g. `blog`. */
+    consumer: string;
+    /** The consumer's own table holding the reference. */
+    tableName: string;
+    /** The column, or the JSON path inside it, e.g. `registered_address.country`. */
+    columnName: string;
+    code: string;
+    count: number;
+    /**
+     * Whether this reference refuses the delete.
+     *
+     * `false` where the consumer's own foreign key clears the value instead
+     * (`on delete set null`) — the reference is still reported, because an
+     * operator about to blank a column wants to know, but it does not block.
+     * The decision belongs to the module that owns the referencing table, which
+     * is why it travels on the descriptor rather than in a caller's exception
+     * list.
+     */
+    blocking: boolean;
+}
+/**
+ * One contributed "who points at this dictionary entry" scanner.
+ *
+ * A module that stores a country, language or currency code registers one of
+ * these per column it stores it in, from its own `ctx.onBoot`. It queries its
+ * **own** tables and nothing else — which is the whole point: before this
+ * existed, `dictionaries`, `languages` and `currencies` each hand-wrote SQL
+ * naming twelve other modules' tables, invisible to every import-level
+ * boundary check because raw SQL names no specifier (D-87).
+ *
+ * `ownerModuleId` is required and is the whole mechanism (D-39): without it the
+ * registry could not state a policy for an absent owner at all.
+ */
+export interface DictionaryReferenceDescriptor {
+    ownerModuleId: string;
+    consumer: string;
+    tableName: string;
+    columnName: string;
+    /** See {@link DictionaryReference.blocking}. */
+    blocking: boolean;
+    /**
+     * How many of this consumer's rows reference `code`. Asked before a delete,
+     * so it must be a point query the consumer's own indexes can serve.
+     */
+    countReferences(code: string): Promise<number>;
+    /**
+     * Every code this consumer stores, with its row count. Asked by the orphan
+     * report, which is a full-table audit by nature — the caller subtracts the
+     * dictionary's own codes to find the danglers.
+     */
+    usedCodes(): Promise<ReadonlyArray<{
+        code: string;
+        count: number;
+    }>>;
+}
+/**
+ * Container name: `countryReferenceRegistry`. Owner: `dictionaries`.
+ * Container name: `languageReferenceRegistry`. Owner: `languages`.
+ * Container name: `currencyReferenceRegistry`. Owner: `currencies`.
+ *
+ * One shape, three instances — one per dictionary, each owned by the module
+ * that owns the table being pointed at. Three rather than one because the
+ * enumeration policy and the 409 belong to the owner of the entry being
+ * deleted, and because a single registry would have to live in a module that
+ * two of the three readers cannot declare without closing a manifest cycle
+ * (`dictionaries` already depends on `languages` and `currencies`).
+ *
+ * A **contribution seam**: contributors push from a boot hook and read nothing
+ * back, so the registration is a plain `ctx.di.register` rather than a
+ * `providePort` — a boot hook that resolved a gate would stop the backend from
+ * starting whenever the registry's owner was switched off. All three owners are
+ * `nonDeactivatable` today, which is why no reader here degrades.
+ *
+ * **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. If `blog` is switched off its posts
+ * still exist and still carry language codes; skipping `blog`'s descriptor
+ * would let an operator delete a language that comes back as a dangling
+ * reference the moment `blog` is switched on again — data loss caused by an
+ * action Constitution XVII promises is non-destructive and reversible. Nobody
+ * sees a descriptor; they exist to refuse a delete and to report a dangler.
+ */
+export interface DictionaryReferenceRegistryPort {
+    register(descriptor: DictionaryReferenceDescriptor): void;
+    /** The contributing module of every registered descriptor, in registration order. */
+    owners(): readonly string[];
+    /** Every reference pointing at one code, across all descriptors. Zero counts dropped. */
+    countReferences(code: string): Promise<DictionaryReference[]>;
+    /** Every code every descriptor stores, with its row count. */
+    usedCodes(): Promise<DictionaryReference[]>;
+}
+//# sourceMappingURL=dictionary.d.ts.map

package/dist/dictionary.d.ts.map

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