@endora-commerce/contracts 0.100.0

package/dist/credentials.js.map

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

package/dist/credit-limits.d.ts

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+/**
+ * Credit Limit module contracts (US6) — see
+ * specs/001-b2b-platform-foundation/contracts/credit_limits.contract.md.
+ */
+export declare const creditLimitReservationStatusSchema: z.ZodEnum<{
+    active: "active";
+    released: "released";
+}>;
+export type CreditLimitReservationStatus = z.infer<typeof creditLimitReservationStatusSchema>;
+export declare const creditLimitReservationReleaseReasonSchema: z.ZodEnum<{
+    invoice_paid: "invoice_paid";
+    order_cancelled: "order_cancelled";
+    admin_revocation: "admin_revocation";
+}>;
+export type CreditLimitReservationReleaseReason = z.infer<typeof creditLimitReservationReleaseReasonSchema>;
+export declare const creditLimitViewSchema: z.ZodObject<{
+    organizationId: z.ZodString;
+    grantedAmount: z.ZodNumber;
+    availableAmount: z.ZodNumber;
+    currency: z.ZodString;
+    activeReservations: z.ZodArray<z.ZodObject<{
+        orderId: z.ZodString;
+        amount: z.ZodNumber;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    grantedAt: z.ZodString;
+}, z.core.$strip>;
+export type CreditLimitView = z.infer<typeof creditLimitViewSchema>;
+export declare const grantCreditLimitRequestSchema: z.ZodObject<{
+    grantedAmount: z.ZodNumber;
+    currency: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GrantCreditLimitRequest = z.infer<typeof grantCreditLimitRequestSchema>;
+export declare const adjustCreditLimitRequestSchema: z.ZodObject<{
+    grantedAmount: z.ZodNumber;
+    reason: z.ZodOptional<z.ZodString>;
+    allowOverAllocation: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type AdjustCreditLimitRequest = z.infer<typeof adjustCreditLimitRequestSchema>;
+/**
+ * Container name: `creditLimitReadPort`. Owner: `credit_limits`.
+ *
+ * One question, asked by one consumer: `organizations` walks an ancestor chain
+ * to decide whose credit limit applies to a descendant, and the only fact it
+ * needs from this module is which links in that chain hold a row at all.
+ *
+ * It used to read the table itself — `select "organization_id" from
+ * "credit_limits" where "organization_id" in (…)`, a statement naming no import
+ * specifier, so the boundary it crossed compiled and was gated by nothing
+ * (feature 077, D-87). The signature is ids in, ids out, which is what puts it
+ * here rather than on the package's `./ports` subpath: nothing about it needs a
+ * MikroORM `EntityManager`, and D-171's test for that subpath is whether the
+ * signature stops the interface living in this package.
+ *
+ * **Owner off:** the seam fails closed — resolving this port throws
+ * `ModuleDisabledError` and the call answers 503 `MODULE_DISABLED`. That is the
+ * right answer and not a degradation to soften: an empty set here reads as
+ * "nobody in this chain has a limit", which is a plausible answer, and on a
+ * credit-check path the wrong one — it is the difference between refusing and
+ * quoting unlimited credit. Whether `credit_limits` has an off state at all is
+ * its manifest's `activation` to say, not this line's.
+ */
+export interface CreditLimitReadPort {
+    /**
+     * Which of `organizationIds` hold a credit-limit row, in no particular
+     * order. The caller supplies the chain and decides which hit is nearest.
+     *
+     * The read crosses organisation scope deliberately: the holder is by
+     * definition an ancestor outside the caller's tenant filter, so an
+     * implementation that let `@OrgScoped` narrow it would answer the empty set
+     * and inheritance would stop working with nothing to show for it.
+     *
+     * Plain ids, never the module's rows — a `CreditLimit` handed across this
+     * seam would be a managed entity the consumer could mutate and flush outside
+     * the transaction that loaded it.
+     */
+    organizationsWithLimit(organizationIds: readonly string[]): Promise<string[]>;
+}
+/**
+ * Container name: `creditLimitService`. Owner: `credit_limits`.
+ *
+ * The narrow grant/adjust seam over `credit_limits`' own registration, for a
+ * module that imports contractor credit limits from an external system: grant
+ * on first sight, adjust thereafter. `orders` resolves the same registration
+ * under its own `CreditLimitPort` (D-94.5).
+ *
+ * It was filed in the Comarch XL vendor contract module, which was its first
+ * consumer, until that module left `@endora-commerce/contracts` (feature 134,
+ * E5). The name is `credit_limits`' to publish, not a vendor's, so it stays
+ * here with the owner's other contract types.
+ */
+export interface ContractorCreditLimitPort {
+    getForOrganization(organizationId: string): Promise<{
+        grantedAmount: string;
+    } | null>;
+    grant(input: {
+        organizationId: string;
+        grantedAmount: number;
+        currency: string;
+    }): Promise<unknown>;
+    adjust(input: {
+        organizationId: string;
+        grantedAmount: number;
+        allowOverAllocation?: boolean;
+    }): Promise<{
+        ok: boolean;
+    }>;
+}
+//# sourceMappingURL=credit-limits.d.ts.map

package/dist/credit-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-limits.d.ts","sourceRoot":"","sources":["../src/credit-limits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AAEH,eAAO,MAAM,kCAAkC;;;EAAiC,CAAC;AACjF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,eAAO,MAAM,yCAAyC;;;;EAIpD,CAAC;AACH,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,yCAAyC,CACjD,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;iBAahC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,6BAA6B;;;;iBAIxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,8BAA8B;;;;iBAIzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;OAYG;IACH,sBAAsB,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC/E;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,yBAAyB;IACxC,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACtF,KAAK,CAAC,KAAK,EAAE;QACX,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrB,MAAM,CAAC,KAAK,EAAE;QACZ,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;KAC/B,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC9B"}

package/dist/credit-limits.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { isoDateTimeSchema, uuidSchema } from './common.js';
+/**
+ * Credit Limit module contracts (US6) — see
+ * specs/001-b2b-platform-foundation/contracts/credit_limits.contract.md.
+ */
+export const creditLimitReservationStatusSchema = z.enum(['active', 'released']);
+export const creditLimitReservationReleaseReasonSchema = z.enum([
+    'invoice_paid',
+    'order_cancelled',
+    'admin_revocation',
+]);
+export const creditLimitViewSchema = z.object({
+    organizationId: uuidSchema,
+    grantedAmount: z.number().finite().nonnegative(),
+    availableAmount: z.number().finite(),
+    currency: z.string().length(3),
+    activeReservations: z.array(z.object({
+        orderId: uuidSchema,
+        amount: z.number().finite(),
+        createdAt: isoDateTimeSchema,
+    })),
+    grantedAt: isoDateTimeSchema,
+});
+export const grantCreditLimitRequestSchema = z.object({
+    grantedAmount: z.number().finite().positive(),
+    currency: z.string().length(3),
+    reason: z.string().max(2000).optional(),
+});
+export const adjustCreditLimitRequestSchema = z.object({
+    grantedAmount: z.number().finite().nonnegative(),
+    reason: z.string().max(2000).optional(),
+    allowOverAllocation: z.boolean().optional(),
+});
+//# sourceMappingURL=credit-limits.js.map

package/dist/credit-limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-limits.js","sourceRoot":"","sources":["../src/credit-limits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5D;;;GAGG;AAEH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAGjF,MAAM,CAAC,MAAM,yCAAyC,GAAG,CAAC,CAAC,IAAI,CAAC;IAC9D,cAAc;IACd,iBAAiB;IACjB,kBAAkB;CACnB,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,cAAc,EAAE,UAAU;IAC1B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IAChD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9B,kBAAkB,EAAE,CAAC,CAAC,KAAK,CACzB,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,UAAU;QACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;QAC3B,SAAS,EAAE,iBAAiB;KAC7B,CAAC,CACH;IACD,SAAS,EAAE,iBAAiB;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IACvC,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC"}

package/dist/currencies.d.ts

@@ -0,0 +1,127 @@
+/**
+ * `currencies` module contracts — the in-process port surface (feature 075,
+ * Phase P).
+ *
+ * The delivery-side twin of `languages.ts`, and for the same reason:
+ * `dictionaries` hosts the admin screen over this table, so the write path
+ * crosses a boundary by design. Fifteen import sites, six of them
+ * `dictionaries` reading the `Currency` entity to resolve a label or validate
+ * a code, four of them `pim_ergonode` mapping an import's price currencies.
+ *
+ * Plain TypeScript rather than Zod: these describe in-process calls.
+ */
+/**
+ * The EventBus name `currencies` announces on after any write.
+ *
+ * A **constant, not a port** (FR-013). Whoever caches currency data
+ * subscribes; `currencies` must not know who does.
+ */
+export declare const CURRENCY_CHANGED_EVENT = "currencies.changed";
+/**
+ * A currency as it crosses a module boundary — a plain shape, never the ORM
+ * entity (FR-011). The primary key is the ISO code.
+ */
+export interface CurrencyRecord {
+    /** ISO 4217 code. The primary key. */
+    code: string;
+    label: string;
+    symbol: string;
+    symbolPosition: 'prefix' | 'suffix';
+    decimalPlaces: number;
+    isDefault: boolean;
+    isActive: boolean;
+    sortOrder: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Container name: `currencyReadPort`. Owner: `currencies`.
+ *
+ * When `currencies` is off every method fails closed. A price with no currency
+ * is not a price, so there is nothing for a caller to degrade to — and
+ * defaulting to one would silently reprice a catalogue.
+ *
+ * Whether `currencies` has an off state at all is its manifest's `activation` to
+ * say, not this line's: a module declaring `nonDeactivatable` never enters one.
+ */
+export interface CurrencyReadPort {
+    list(): Promise<CurrencyRecord[]>;
+    /** Only `isActive`, ordered by sort order then code. */
+    listActive(): Promise<CurrencyRecord[]>;
+    /** Exactly one currency is the default; `null` only before the first seed. */
+    getDefault(): Promise<CurrencyRecord | null>;
+    findByCode(code: string): Promise<CurrencyRecord | null>;
+}
+export interface CreateCurrencyInput {
+    code: string;
+    label: string;
+    symbol: string;
+    symbolPosition?: 'prefix' | 'suffix';
+    decimalPlaces?: number;
+    isActive?: boolean;
+    sortOrder?: number;
+}
+export interface UpsertCurrencyInput {
+    code: string;
+    label: string;
+    symbol: string;
+    isActive?: boolean;
+    sortOrder?: number;
+}
+export interface UpdateCurrencyInput {
+    label?: string;
+    symbol?: string;
+    symbolPosition?: 'prefix' | 'suffix';
+    decimalPlaces?: number;
+    isActive?: boolean;
+    sortOrder?: number;
+}
+/**
+ * Container name: `currencyAdminPort`. Owner: `currencies`.
+ *
+ * `upsert` is separate from `create` because `pim_ergonode` reaches it during
+ * an import: a feed naming a currency the platform does not have should add
+ * it, not fail the run. `create` refuses a duplicate, and both refuse to
+ * deactivate the default.
+ */
+export interface CurrencyAdminPort {
+    create(input: CreateCurrencyInput): Promise<CurrencyRecord>;
+    upsert(input: UpsertCurrencyInput): Promise<CurrencyRecord>;
+    update(code: string, input: UpdateCurrencyInput): Promise<CurrencyRecord>;
+    setDefault(code: string): Promise<CurrencyRecord>;
+    remove(code: string): Promise<void>;
+}
+/**
+ * One currency the platform ships a definition for, as it crosses the boundary
+ * into {@link CurrencySeedPort}.
+ *
+ * The catalogue itself is `dictionaries`' — it exists so that
+ * `countries.default_currency_code` is satisfiable on a fresh install — while
+ * the table it lands in is this module's. That split is why the seam is a port
+ * and not a shared file.
+ */
+export interface CurrencySeedRow {
+    code: string;
+    label: string;
+    symbol: string;
+    symbolPosition?: 'prefix' | 'suffix';
+    decimalPlaces?: number;
+}
+/**
+ * Container name: `currencySeedPort`. Owner: `currencies`.
+ *
+ * The seam `dictionaries`' boot reconciler used to be a raw
+ * `insert into "currencies"` — this module's table, written by another module,
+ * invisible to every import-level boundary check (D-87).
+ *
+ * Deliberately **not** `CurrencyAdminPort.create`: 53 rows land on a fresh
+ * install, and routing them through the admin write path would record 53 audit
+ * entries for something no operator did and flush once per row. Seeding is
+ * idempotent by contract — a code that already exists is left exactly as it is,
+ * operator edits included.
+ */
+export interface CurrencySeedPort {
+    /** Inserts every row whose `code` is missing. Returns how many it inserted. */
+    ensureSeeded(rows: readonly CurrencySeedRow[]): Promise<number>;
+}
+//# sourceMappingURL=currencies.d.ts.map

package/dist/currencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencies.d.ts","sourceRoot":"","sources":["../src/currencies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAClC,wDAAwD;IACxD,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACxC,8EAA8E;IAC9E,UAAU,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC7C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5D,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAClD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,YAAY,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACjE"}

package/dist/currencies.js

@@ -0,0 +1,20 @@
+/**
+ * `currencies` module contracts — the in-process port surface (feature 075,
+ * Phase P).
+ *
+ * The delivery-side twin of `languages.ts`, and for the same reason:
+ * `dictionaries` hosts the admin screen over this table, so the write path
+ * crosses a boundary by design. Fifteen import sites, six of them
+ * `dictionaries` reading the `Currency` entity to resolve a label or validate
+ * a code, four of them `pim_ergonode` mapping an import's price currencies.
+ *
+ * Plain TypeScript rather than Zod: these describe in-process calls.
+ */
+/**
+ * The EventBus name `currencies` announces on after any write.
+ *
+ * A **constant, not a port** (FR-013). Whoever caches currency data
+ * subscribes; `currencies` must not know who does.
+ */
+export const CURRENCY_CHANGED_EVENT = 'currencies.changed';
+//# sourceMappingURL=currencies.js.map

package/dist/currencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencies.js","sourceRoot":"","sources":["../src/currencies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC"}

package/dist/custom-fields.d.ts

@@ -0,0 +1,345 @@
+import { z } from 'zod';
+/**
+ * Custom Fields Layer (feature 055) — entity-agnostic runtime custom fields
+ * on core entities (Category, Order, Organization, Customer, QuoteRequest).
+ *
+ * These are the source-of-truth boundary schemas (Principle V). The per-value
+ * validator applied to host records is DERIVED at runtime from a stored
+ * definition (see backend `custom-field-value.service.ts`); the schemas here
+ * cover the definition/option admin API and the value-bag envelope.
+ */
+/** The host entity types custom fields may attach to at launch. Extensible via the backend registry. */
+export declare const supportedEntityTypeSchema: z.ZodEnum<{
+    customer: "customer";
+    category: "category";
+    order: "order";
+    product: "product";
+    organization: "organization";
+    quote_request: "quote_request";
+}>;
+export type SupportedEntityType = z.infer<typeof supportedEntityTypeSchema>;
+/** The set of runtime value types. `text` is stored as a string; `select` stores one option value; `multiselect` an array. */
+export declare const customFieldValueTypeSchema: z.ZodEnum<{
+    number: "number";
+    boolean: "boolean";
+    date: "date";
+    text: "text";
+    select: "select";
+    multiselect: "multiselect";
+}>;
+export type CustomFieldValueType = z.infer<typeof customFieldValueTypeSchema>;
+/** Per-locale label map (BCP-47-keyed). Empty is allowed when only `labelDefault` is filled. */
+export declare const localizedLabelSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+export type LocalizedLabel = z.infer<typeof localizedLabelSchema>;
+/** A select/multiselect option. `id` absent on create. */
+export declare const customFieldOptionSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    value: z.ZodString;
+    label: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    labelDefault: z.ZodString;
+    isDefault: z.ZodDefault<z.ZodBoolean>;
+    sortOrder: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type CustomFieldOptionDto = z.infer<typeof customFieldOptionSchema>;
+/** A full custom-field definition, options embedded. */
+export declare const customFieldDefinitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    entityType: z.ZodEnum<{
+        customer: "customer";
+        category: "category";
+        order: "order";
+        product: "product";
+        organization: "organization";
+        quote_request: "quote_request";
+    }>;
+    key: z.ZodString;
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+    labelDefault: z.ZodString;
+    valueType: z.ZodEnum<{
+        number: "number";
+        boolean: "boolean";
+        date: "date";
+        text: "text";
+        select: "select";
+        multiselect: "multiselect";
+    }>;
+    required: z.ZodBoolean;
+    sortOrder: z.ZodNumber;
+    config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+        label: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        labelDefault: z.ZodString;
+        isDefault: z.ZodDefault<z.ZodBoolean>;
+        sortOrder: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type CustomFieldDefinitionDto = z.infer<typeof customFieldDefinitionSchema>;
+/** Create a definition. `entityType` + `key` are immutable after create. */
+export declare const createCustomFieldDefinitionSchema: z.ZodObject<{
+    label: z.ZodRecord<z.ZodString, z.ZodString>;
+    key: z.ZodString;
+    valueType: z.ZodEnum<{
+        number: "number";
+        boolean: "boolean";
+        date: "date";
+        text: "text";
+        select: "select";
+        multiselect: "multiselect";
+    }>;
+    required: z.ZodBoolean;
+    options: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+        label: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        labelDefault: z.ZodString;
+        isDefault: z.ZodDefault<z.ZodBoolean>;
+        sortOrder: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    sortOrder: z.ZodNumber;
+    config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    labelDefault: z.ZodString;
+    entityType: z.ZodEnum<{
+        customer: "customer";
+        category: "category";
+        order: "order";
+        product: "product";
+        organization: "organization";
+        quote_request: "quote_request";
+    }>;
+}, z.core.$strip>;
+export type CreateCustomFieldDefinitionRequest = z.infer<typeof createCustomFieldDefinitionSchema>;
+/** Patch a definition. `entityType` and `key` cannot change once records may hold values. */
+export declare const updateCustomFieldDefinitionSchema: z.ZodObject<{
+    label: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    valueType: z.ZodOptional<z.ZodEnum<{
+        number: "number";
+        boolean: "boolean";
+        date: "date";
+        text: "text";
+        select: "select";
+        multiselect: "multiselect";
+    }>>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    options: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+        label: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        labelDefault: z.ZodString;
+        isDefault: z.ZodDefault<z.ZodBoolean>;
+        sortOrder: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+    config: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    labelDefault: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UpdateCustomFieldDefinitionRequest = z.infer<typeof updateCustomFieldDefinitionSchema>;
+/**
+ * One supported host entity type as served by the admin entity-types listing
+ * (feature 061 T037). `managedBy` is present only for host-managed types
+ * (e.g. `product` → catalog attributes): the generic admin UI renders those
+ * read-only and links to `managedBy.route`. Label fields are i18n keys
+ * resolved against the `custom_fields` module bundle.
+ */
+export declare const customFieldEntityTypeInfoSchema: z.ZodObject<{
+    entityType: z.ZodEnum<{
+        customer: "customer";
+        category: "category";
+        order: "order";
+        product: "product";
+        organization: "organization";
+        quote_request: "quote_request";
+    }>;
+    labelKey: z.ZodString;
+    managedBy: z.ZodOptional<z.ZodObject<{
+        moduleId: z.ZodString;
+        labelKey: z.ZodString;
+        route: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CustomFieldEntityTypeInfo = z.infer<typeof customFieldEntityTypeInfoSchema>;
+/** A validated value bag keyed by definition `key`. Values are typed by their definition's `valueType`. */
+export declare const customFieldValuesSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type CustomFieldValues = z.infer<typeof customFieldValuesSchema>;
+/** One per-field validation failure returned to the admin for per-field rendering (FR-004). */
+export declare const customFieldValidationErrorSchema: z.ZodObject<{
+    field: z.ZodString;
+    code: z.ZodEnum<{
+        wrong_type: "wrong_type";
+        missing_required: "missing_required";
+        unknown_option: "unknown_option";
+        out_of_range: "out_of_range";
+        duplicate_option: "duplicate_option";
+    }>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type CustomFieldValidationError = z.infer<typeof customFieldValidationErrorSchema>;
+/**
+ * What `CustomFieldValuePort.validateAndMerge` throws, as a **shape** rather
+ * than a constructor (feature 075, Phase C).
+ *
+ * Five host modules catch it to turn it into the 422 envelope, and each of them
+ * did it with `err instanceof CustomFieldValidationError` — which imports
+ * `custom_fields`' class and is the last thing several of their cuts would
+ * otherwise be left holding. This is D-77's remedy for
+ * `CustomFieldDefinitionError` applied to its sibling: narrow structurally, so
+ * the host names a published shape instead of a foreign constructor.
+ *
+ * The guard tests `name` and the `errors` array rather than the prototype
+ * chain, which is also what makes it survive the error crossing a package
+ * boundary once each module is its own npm package (F4).
+ */
+export interface CustomFieldValidationFailure extends Error {
+    readonly errors: readonly CustomFieldValidationError[];
+}
+export declare function isCustomFieldValidationFailure(error: unknown): error is CustomFieldValidationFailure;
+/**
+ * How a definition or option write can be refused (feature 061).
+ *
+ * Published as a union rather than a class so a host narrows the failure
+ * **structurally**. `catalog` mapped these onto its own HTTP surface by
+ * `err instanceof CustomFieldDefinitionError`, which meant importing a
+ * constructor out of another module to read a string field off it.
+ */
+export declare const CUSTOM_FIELD_DEFINITION_ERROR_CODES: readonly ["not_found", "duplicate_key", "options_required", "options_forbidden", "entity_type_unknown", "value_type_locked", "option_in_use"];
+export type CustomFieldDefinitionErrorCode = (typeof CUSTOM_FIELD_DEFINITION_ERROR_CODES)[number];
+/** A refused definition or option write, as a host outside `custom_fields` sees it. */
+export interface CustomFieldDefinitionFailure {
+    readonly name: 'CustomFieldDefinitionError';
+    readonly code: CustomFieldDefinitionErrorCode;
+    readonly message: string;
+}
+/**
+ * Whether `error` is a refused definition write, narrowed by shape.
+ *
+ * `name` and `code` together, not `name` alone: the name is what the class sets
+ * on itself and the code is what the caller branches on, so a shape carrying one
+ * without the other is not something a host can act on.
+ */
+export declare function isCustomFieldDefinitionFailure(error: unknown): error is CustomFieldDefinitionFailure;
+/** One custom-field definition, as a module outside `custom_fields` sees it. */
+export interface CustomFieldDefinitionRecord {
+    id: string;
+    entityType: SupportedEntityType;
+    key: string;
+    label: Record<string, string>;
+    labelDefault: string;
+    valueType: CustomFieldValueType;
+    required: boolean;
+    sortOrder: number;
+    config: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** One selectable option of a `select` / `multiselect` definition. */
+export interface CustomFieldOptionRecord {
+    id: string;
+    definitionId: string;
+    value: string;
+    label: Record<string, string>;
+    labelDefault: string;
+    isDefault: boolean;
+    sortOrder: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** A definition with its options — the unit the per-entity cache holds. */
+export interface CustomFieldDefinitionWithOptions {
+    readonly definition: CustomFieldDefinitionRecord;
+    readonly options: CustomFieldOptionRecord[];
+}
+/**
+ * Container name: `customFieldDefinitionReadPort`. Owner: `custom_fields`.
+ *
+ * `catalog`'s composed attribute read model is the heaviest consumer: since
+ * feature 061 the definition half of a product attribute *is* a custom-field
+ * definition, and it reads them through this one question. `product_feeds`
+ * asks the same thing of its own host.
+ *
+ * Reads ride the per-entity in-process cache (invalidated by every committed
+ * definition Command, with a 5 s TTL fallback), so this is cheap enough to
+ * call on a hot path — which is what the existing `DefinitionSource` interface
+ * was extracted for.
+ *
+ * **Owner off:** the seam fails closed — resolving this port throws
+ * `ModuleDisabledError` and the call answers 503 `MODULE_DISABLED`, so nothing
+ * half-executes. Whether `custom_fields` has an off state at all is its manifest's
+ * `activation` to say, not this line's: a module declaring
+ * `nonDeactivatable` never enters one.
+ */
+export interface CustomFieldDefinitionReadPort {
+    listForEntity(entityType: SupportedEntityType): Promise<CustomFieldDefinitionWithOptions[]>;
+    /**
+     * The same list, bypassing the per-entity cache and refreshing it for every
+     * process.
+     *
+     * A consumer composing its own rows against these definitions can observe a
+     * benign inconsistency: a just-committed definition Command may dispatch its
+     * domain event before the post-commit invalidation runs, and the invalidation
+     * is a Redis fan-out with a TTL fallback, so a second process holds a stale
+     * entry no in-process sequencing can reach. Only the consumer can *detect*
+     * that — it is the one that knows what its own rows say — and only this
+     * module may *resolve* it, because the cache is its own. So the port answers
+     * the question the consumer actually has ("give me definitions I can trust")
+     * rather than exposing an instruction about somebody else's internals.
+     *
+     * **Required, not optional**, and D-97.3 makes that a rule for every port:
+     * `lazyPort`'s proxy answers every property with a function, so
+     * `if (port.maybe)` is always true and feature detection through a port is
+     * impossible by construction. The one optional method that existed —
+     * `catalog`'s `publishInvalidate?` widening — fired its recovery branch
+     * unconditionally and turned a self-healing window into a 500.
+     */
+    listForEntityFresh(entityType: SupportedEntityType): Promise<CustomFieldDefinitionWithOptions[]>;
+    /**
+     * One definition by id, with its options, or `null`.
+     *
+     * The **committed** state, deliberately: `catalog`'s attribute Commands read
+     * it to capture an audit "before" snapshot and to feed the guards a
+     * definition change has to satisfy, and both questions are about the row as
+     * it stands rather than about anything the caller's open transaction has
+     * written. That is what makes it a read rather than a seventh member of the
+     * apply seam — handing a read an `EntityManager` re-opens a write seam to
+     * serve it (D-169).
+     *
+     * It is published here, rather than left on the apply seam it used to sit
+     * beside, because the definition service answers it with its two **managed
+     * ORM entities** while the one consumer typed the result as a record.
+     * Nothing mutated them, so the leak was latent — but that is precisely the
+     * ability D-77's first narrowing took away from every other apply-seam
+     * return, and a consumer holding a managed entity can persist a change to it
+     * on whatever transaction it happens to be holding.
+     */
+    getById(id: string): Promise<CustomFieldDefinitionWithOptions | null>;
+}
+/**
+ * Container name: `customFieldValueService`. Owner: `custom_fields`.
+ *
+ * Five host modules — `orders`, `organizations`, `customers`, `quote_requests`
+ * and `catalog` — validate their own custom-field bag through this before
+ * persisting it.
+ *
+ * It performs **no** database write and **no** audit: the host persists its own
+ * record and audits its own write (Principle XIII). This port only validates
+ * the incoming values and returns the merged bag, which is what keeps the
+ * module boundary intact (Principle I) and avoids a double audit.
+ *
+ * `validateAndMerge` throws `CustomFieldValidationError` — serialised as HTTP
+ * 422 — with the per-field errors (feature 055 FR-004). Unknown patch keys are
+ * ignored; dormant keys already in the bag are retained (FR-010).
+ *
+ * **Owner off:** the seam fails closed — resolving this port throws
+ * `ModuleDisabledError` and the call answers 503 `MODULE_DISABLED`, so nothing
+ * half-executes. Whether `custom_fields` has an off state at all is its manifest's
+ * `activation` to say, not this line's: a module declaring
+ * `nonDeactivatable` never enters one.
+ */
+export interface CustomFieldValuePort {
+    validateAndMerge(entityType: SupportedEntityType, currentBag: Record<string, unknown>, patch: Record<string, unknown> | undefined): Promise<Record<string, unknown>>;
+    /** The bag as a caller should render it: dormant keys stripped. */
+    project(entityType: SupportedEntityType, bag: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=custom-fields.d.ts.map