@endora-commerce/contracts 0.100.0

package/dist/dictionary.js

@@ -0,0 +1,297 @@
+import { z } from 'zod';
+import { isoDateTimeSchema } from './common.js';
+/**
+ * Dictionary contracts (feature 017).
+ *
+ * Single source of truth for the platform-wide registry of Countries, Currencies,
+ * and Languages, plus per-entry display-label translations and the typed
+ * cross-module DictionaryValidator port (see contracts/dictionary-validation.contract.md).
+ *
+ * Currency and Language codes follow the same regexes used by the legacy
+ * `i18n.ts` module (BCP-47 subset + ISO 4217). Country codes are ISO 3166-1
+ * alpha-2 — the convention already adopted by Address, Tax, Warehouse, and
+ * Organisation.
+ */
+const COUNTRY_CODE = z
+    .string()
+    .regex(/^[A-Z]{2}$/, 'ISO 3166-1 alpha-2 country code');
+const CURRENCY_CODE = z
+    .string()
+    .regex(/^[A-Z]{3}$/, 'ISO 4217 currency code');
+const LANGUAGE_CODE = z
+    .string()
+    .regex(/^[a-z]{2,3}(-[A-Z]{2})?$/, 'BCP-47 language tag');
+const ALPHA3_CODE = z
+    .string()
+    .regex(/^[A-Z]{3}$/, 'ISO 3166-1 alpha-3 country code');
+const NUMERIC_CODE = z
+    .string()
+    .regex(/^[0-9]{3}$/, 'ISO 3166-1 numeric country code (zero-padded)');
+const DIAL_CODE = z
+    .string()
+    .regex(/^\+\d{1,4}$/, 'International dial code prefixed with "+"');
+export const REGIONS = [
+    'Africa',
+    'Americas',
+    'Asia',
+    'Europe',
+    'Oceania',
+    'Antarctic',
+];
+export const regionSchema = z.enum(REGIONS);
+export const symbolPositionSchema = z.enum(['prefix', 'suffix']);
+export const dictionaryEntryTypeSchema = z.enum(['country', 'currency', 'language']);
+// ---------------------------------------------------------------------------
+// Country
+// ---------------------------------------------------------------------------
+export const countrySchema = z.object({
+    code: COUNTRY_CODE,
+    alpha3Code: ALPHA3_CODE,
+    numericCode: NUMERIC_CODE,
+    label: z.string().min(1).max(120),
+    region: regionSchema,
+    subregion: z.string().max(64).nullable(),
+    dialCode: DIAL_CODE.nullable(),
+    isEuMember: z.boolean(),
+    defaultCurrencyCode: CURRENCY_CODE.nullable(),
+    isActive: z.boolean(),
+    isDefault: z.boolean(),
+    sortOrder: z.number().int(),
+    createdAt: isoDateTimeSchema,
+    updatedAt: isoDateTimeSchema,
+});
+export const createCountryRequestSchema = z.object({
+    code: COUNTRY_CODE,
+    alpha3Code: ALPHA3_CODE,
+    numericCode: NUMERIC_CODE,
+    label: z.string().min(1).max(120),
+    region: regionSchema,
+    subregion: z.string().max(64).optional(),
+    dialCode: DIAL_CODE.optional(),
+    isEuMember: z.boolean().optional(),
+    defaultCurrencyCode: CURRENCY_CODE.optional(),
+    isActive: z.boolean().optional(),
+    sortOrder: z.number().int().optional(),
+});
+export const updateCountryRequestSchema = z.object({
+    alpha3Code: ALPHA3_CODE.optional(),
+    numericCode: NUMERIC_CODE.optional(),
+    label: z.string().min(1).max(120).optional(),
+    region: regionSchema.optional(),
+    subregion: z.string().max(64).nullable().optional(),
+    dialCode: DIAL_CODE.nullable().optional(),
+    isEuMember: z.boolean().optional(),
+    defaultCurrencyCode: CURRENCY_CODE.nullable().optional(),
+    isActive: z.boolean().optional(),
+    sortOrder: z.number().int().optional(),
+});
+// ---------------------------------------------------------------------------
+// Currency (extended) — backwards compatible with i18n.ts `currencySchema`
+// ---------------------------------------------------------------------------
+export const dictionaryCurrencySchema = z.object({
+    code: CURRENCY_CODE,
+    label: z.string().min(1).max(64),
+    symbol: z.string().min(1).max(8),
+    symbolPosition: symbolPositionSchema,
+    decimalPlaces: z.number().int().min(0).max(6),
+    isDefault: z.boolean(),
+    isActive: z.boolean(),
+    sortOrder: z.number().int(),
+    createdAt: isoDateTimeSchema,
+    updatedAt: isoDateTimeSchema,
+});
+export const createDictionaryCurrencyRequestSchema = z.object({
+    code: CURRENCY_CODE,
+    label: z.string().min(1).max(64),
+    symbol: z.string().min(1).max(8),
+    symbolPosition: symbolPositionSchema.optional(),
+    decimalPlaces: z.number().int().min(0).max(6).optional(),
+    isActive: z.boolean().optional(),
+    sortOrder: z.number().int().optional(),
+});
+export const updateDictionaryCurrencyRequestSchema = z.object({
+    label: z.string().min(1).max(64).optional(),
+    symbol: z.string().min(1).max(8).optional(),
+    symbolPosition: symbolPositionSchema.optional(),
+    decimalPlaces: z.number().int().min(0).max(6).optional(),
+    isActive: z.boolean().optional(),
+    sortOrder: z.number().int().optional(),
+});
+// ---------------------------------------------------------------------------
+// Language (extended) — backwards compatible with i18n.ts `languageSchema`
+// ---------------------------------------------------------------------------
+export const dictionaryLanguageSchema = z.object({
+    code: LANGUAGE_CODE,
+    label: z.string().min(1).max(64),
+    nativeLabel: z.string().min(1).max(64),
+    isRtl: z.boolean(),
+    fallbackCode: LANGUAGE_CODE.nullable(),
+    isDefault: z.boolean(),
+    isActive: z.boolean(),
+    sortOrder: z.number().int(),
+    countries: z.array(COUNTRY_CODE),
+    createdAt: isoDateTimeSchema,
+    updatedAt: isoDateTimeSchema,
+});
+export const createDictionaryLanguageRequestSchema = z.object({
+    code: LANGUAGE_CODE,
+    label: z.string().min(1).max(64),
+    nativeLabel: z.string().min(1).max(64),
+    isRtl: z.boolean().optional(),
+    fallbackCode: LANGUAGE_CODE.optional(),
+    isActive: z.boolean().optional(),
+    sortOrder: z.number().int().optional(),
+});
+export const updateDictionaryLanguageRequestSchema = z.object({
+    label: z.string().min(1).max(64).optional(),
+    nativeLabel: z.string().min(1).max(64).optional(),
+    isRtl: z.boolean().optional(),
+    fallbackCode: LANGUAGE_CODE.nullable().optional(),
+    isActive: z.boolean().optional(),
+    sortOrder: z.number().int().optional(),
+});
+// ---------------------------------------------------------------------------
+// Translations
+// ---------------------------------------------------------------------------
+export const dictionaryTranslationSchema = z.object({
+    entryType: dictionaryEntryTypeSchema,
+    entryCode: z.string().min(1).max(12),
+    languageCode: LANGUAGE_CODE,
+    label: z.string().min(1).max(160),
+    createdAt: isoDateTimeSchema,
+    updatedAt: isoDateTimeSchema,
+});
+export const upsertTranslationRequestSchema = z.object({
+    label: z.string().min(1).max(160),
+});
+// ---------------------------------------------------------------------------
+// Language ↔ Country association
+// ---------------------------------------------------------------------------
+export const languageCountrySchema = z.object({
+    languageCode: LANGUAGE_CODE,
+    countryCode: COUNTRY_CODE,
+    isPrimary: z.boolean(),
+    createdAt: isoDateTimeSchema,
+});
+export const upsertLanguageCountryRequestSchema = z.object({
+    isPrimary: z.boolean().optional(),
+});
+// ---------------------------------------------------------------------------
+// Pagination wrappers (admin list endpoints)
+// ---------------------------------------------------------------------------
+const paginationMetaSchema = z.object({
+    page: z.number().int().min(1),
+    pageSize: z.number().int().min(1).max(250),
+    total: z.number().int().min(0),
+});
+export const dictionaryCountriesPageResponseSchema = z.object({
+    data: z.array(countrySchema),
+    pagination: paginationMetaSchema,
+});
+export const dictionaryCurrenciesPageResponseSchema = z.object({
+    data: z.array(dictionaryCurrencySchema),
+    pagination: paginationMetaSchema,
+});
+export const dictionaryLanguagesPageResponseSchema = z.object({
+    data: z.array(dictionaryLanguageSchema),
+    pagination: paginationMetaSchema,
+});
+// ---------------------------------------------------------------------------
+// Storefront read facade — locale-resolved labels
+// ---------------------------------------------------------------------------
+export const resolvedCountrySchema = z.object({
+    code: COUNTRY_CODE,
+    label: z.string(),
+    alpha3Code: ALPHA3_CODE,
+    numericCode: NUMERIC_CODE,
+    region: regionSchema,
+    subregion: z.string().nullable(),
+    dialCode: z.string().nullable(),
+    isEuMember: z.boolean(),
+    defaultCurrencyCode: CURRENCY_CODE.nullable(),
+    sortOrder: z.number().int(),
+});
+export const resolvedCurrencySchema = z.object({
+    code: CURRENCY_CODE,
+    label: z.string(),
+    symbol: z.string(),
+    symbolPosition: symbolPositionSchema,
+    decimalPlaces: z.number().int().min(0).max(6),
+    sortOrder: z.number().int(),
+});
+export const resolvedLanguageSchema = z.object({
+    code: LANGUAGE_CODE,
+    label: z.string(),
+    nativeLabel: z.string(),
+    isRtl: z.boolean(),
+    fallbackCode: LANGUAGE_CODE.nullable(),
+    countries: z.array(COUNTRY_CODE),
+    sortOrder: z.number().int(),
+});
+export const dictionaryRegistryResponseSchema = z.object({
+    data: z.object({
+        countries: z.array(resolvedCountrySchema),
+        currencies: z.array(resolvedCurrencySchema),
+        languages: z.array(resolvedLanguageSchema),
+        defaults: z.object({
+            country: COUNTRY_CODE.nullable(),
+            currency: CURRENCY_CODE.nullable(),
+            language: LANGUAGE_CODE.nullable(),
+        }),
+    }),
+});
+const resolvedCountryWithFlagsSchema = resolvedCountrySchema.extend({ isActive: z.boolean() });
+const resolvedCurrencyWithFlagsSchema = resolvedCurrencySchema.extend({ isActive: z.boolean() });
+const resolvedLanguageWithFlagsSchema = resolvedLanguageSchema.extend({ isActive: z.boolean() });
+export const dictionaryByCodeResponseSchema = z.object({
+    data: z.discriminatedUnion('entryType', [
+        z.object({ entryType: z.literal('country'), entry: resolvedCountryWithFlagsSchema }),
+        z.object({ entryType: z.literal('currency'), entry: resolvedCurrencyWithFlagsSchema }),
+        z.object({ entryType: z.literal('language'), entry: resolvedLanguageWithFlagsSchema }),
+    ]),
+});
+/**
+ * Typed error thrown by the validator. Consumer modules' HTTP error handlers
+ * translate this into a 409 envelope per contracts/dictionary-validation.contract.md.
+ */
+export class DictionaryReferenceError extends Error {
+    code;
+    entryType;
+    entryCode;
+    constructor(args) {
+        super(args.message ??
+            `Dictionary ${args.entryType} ${args.entryCode} ${args.code === 'DICTIONARY_ENTRY_NOT_FOUND' ? 'is not registered.' : 'is inactive.'}`);
+        this.name = 'DictionaryReferenceError';
+        this.code = args.code;
+        this.entryType = args.entryType;
+        this.entryCode = args.entryCode;
+    }
+}
+/**
+ * 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 function dispatchValidatorMode(currentValue, incomingValue) {
+    if (!currentValue)
+        return 'create-or-change';
+    if (!incomingValue)
+        return 'unchanged';
+    return currentValue === incomingValue ? 'unchanged' : 'create-or-change';
+}
+//# sourceMappingURL=dictionary.js.map

package/dist/dictionary.js.map

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

package/dist/email-address.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The one canonical form of an e-mail address the platform stores and compares.
+ *
+ * ## The defect it ends
+ *
+ * The account table's writes folded the address to lower case and its reads did
+ * not. Postgres' `=` on `text` is case-sensitive, so a buyer who registered as
+ * `Jan.Kowalski@example.pl` had `jan.kowalski@example.pl` on record and every
+ * login attempt with the address they had typed matched no row — answered with
+ * the generic anti-enumeration `INVALID_CREDENTIALS`, which tells neither the
+ * buyer nor support what happened. Two entrances reached it: organisation
+ * registration (a public storefront path) and the member admin surface.
+ *
+ * ## The decision
+ *
+ * **Stored folded, compared folded.** RFC 5321 makes the local part technically
+ * case-sensitive; no mail provider in practice treats it that way, and the tree
+ * had already chosen to fold on write. So the reads move to meet the writes.
+ *
+ * ## Why a function here rather than a `.toLowerCase()` in the Zod schemas
+ *
+ * A transform on `customerRegistrationSchema` and its siblings would normalise
+ * only the callers that went through that particular schema. Three entrances
+ * into the same table go through none of them: federated sign-in takes the
+ * address from an OIDC claim, the admin "send a reset link" action passes an
+ * address already on record, and the invitation flow re-reads the address off
+ * its own row. The invariant belongs to whoever owns the table, so it is
+ * applied at that module's own seam — every service and port method that
+ * accepts an address folds it as its first act — and a helper is what lets the
+ * eleven of them share one spelling of "the same address".
+ *
+ * It lives in `@endora-commerce/contracts` rather than inside `customer_accounts` because
+ * `organizations` writes an invitation row keyed by the same address and has to
+ * fold it the same way; a module may not import another module's internals, and
+ * a second private copy is exactly how `foldDiacritics` came to have six.
+ *
+ * Not a port: it is pure over its argument, so it cannot answer differently
+ * depending on which modules are switched on, and a gated port answering 503
+ * `MODULE_DISABLED` to "fold this address" would be a bug rather than a safety
+ * property.
+ */
+/**
+ * Fold an e-mail address to the form the platform stores and compares.
+ *
+ * Two steps, and only two:
+ *
+ * 1. **Trim.** Surrounding whitespace is never part of an address. Zod's
+ *    `.email()` already rejects it at every HTTP entrance, so this bites only
+ *    where the address arrives from somewhere else — an identity provider's
+ *    claim, an importer, a seed.
+ * 2. **Lowercase.** The whole point: `Jan.Kowalski@Example.PL` and
+ *    `jan.kowalski@example.pl` are one account.
+ *
+ * Deliberately **not** a validator: an address that is not one comes back
+ * unchanged apart from those two steps, because rejecting it is the schema's
+ * job at the boundary and this function is also applied to addresses already
+ * persisted. And deliberately **not** a normaliser of provider-specific
+ * aliasing — Gmail's dots and `+tags` are still distinct addresses here, since
+ * collapsing them would silently merge accounts on some domains and not others.
+ */
+export declare function normalizeEmailAddress(email: string): string;
+//# sourceMappingURL=email-address.d.ts.map

package/dist/email-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-address.d.ts","sourceRoot":"","sources":["../src/email-address.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/email-address.js

@@ -0,0 +1,64 @@
+/**
+ * The one canonical form of an e-mail address the platform stores and compares.
+ *
+ * ## The defect it ends
+ *
+ * The account table's writes folded the address to lower case and its reads did
+ * not. Postgres' `=` on `text` is case-sensitive, so a buyer who registered as
+ * `Jan.Kowalski@example.pl` had `jan.kowalski@example.pl` on record and every
+ * login attempt with the address they had typed matched no row — answered with
+ * the generic anti-enumeration `INVALID_CREDENTIALS`, which tells neither the
+ * buyer nor support what happened. Two entrances reached it: organisation
+ * registration (a public storefront path) and the member admin surface.
+ *
+ * ## The decision
+ *
+ * **Stored folded, compared folded.** RFC 5321 makes the local part technically
+ * case-sensitive; no mail provider in practice treats it that way, and the tree
+ * had already chosen to fold on write. So the reads move to meet the writes.
+ *
+ * ## Why a function here rather than a `.toLowerCase()` in the Zod schemas
+ *
+ * A transform on `customerRegistrationSchema` and its siblings would normalise
+ * only the callers that went through that particular schema. Three entrances
+ * into the same table go through none of them: federated sign-in takes the
+ * address from an OIDC claim, the admin "send a reset link" action passes an
+ * address already on record, and the invitation flow re-reads the address off
+ * its own row. The invariant belongs to whoever owns the table, so it is
+ * applied at that module's own seam — every service and port method that
+ * accepts an address folds it as its first act — and a helper is what lets the
+ * eleven of them share one spelling of "the same address".
+ *
+ * It lives in `@endora-commerce/contracts` rather than inside `customer_accounts` because
+ * `organizations` writes an invitation row keyed by the same address and has to
+ * fold it the same way; a module may not import another module's internals, and
+ * a second private copy is exactly how `foldDiacritics` came to have six.
+ *
+ * Not a port: it is pure over its argument, so it cannot answer differently
+ * depending on which modules are switched on, and a gated port answering 503
+ * `MODULE_DISABLED` to "fold this address" would be a bug rather than a safety
+ * property.
+ */
+/**
+ * Fold an e-mail address to the form the platform stores and compares.
+ *
+ * Two steps, and only two:
+ *
+ * 1. **Trim.** Surrounding whitespace is never part of an address. Zod's
+ *    `.email()` already rejects it at every HTTP entrance, so this bites only
+ *    where the address arrives from somewhere else — an identity provider's
+ *    claim, an importer, a seed.
+ * 2. **Lowercase.** The whole point: `Jan.Kowalski@Example.PL` and
+ *    `jan.kowalski@example.pl` are one account.
+ *
+ * Deliberately **not** a validator: an address that is not one comes back
+ * unchanged apart from those two steps, because rejecting it is the schema's
+ * job at the boundary and this function is also applied to addresses already
+ * persisted. And deliberately **not** a normaliser of provider-specific
+ * aliasing — Gmail's dots and `+tags` are still distinct addresses here, since
+ * collapsing them would silently merge accounts on some domains and not others.
+ */
+export function normalizeEmailAddress(email) {
+    return email.trim().toLowerCase();
+}
+//# sourceMappingURL=email-address.js.map

package/dist/email-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-address.js","sourceRoot":"","sources":["../src/email-address.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC"}

package/dist/email.d.ts

@@ -0,0 +1,175 @@
+import { z } from 'zod';
+/**
+ * The `email` module's published contract (D-59, issue #114; extended by
+ * feature 075's Phase P).
+ *
+ * `email` owns no route, no entity and no worker: it is two registrations —
+ * the platform's outbound transport, and the durable record of what became of
+ * each message that left through it.
+ *
+ * The delivery recorder lives here rather than in the module because a second
+ * module reads it: `transactional_emails` decides `suppressed` above the
+ * transport and records that decision itself, so the shape is a boundary and
+ * not an internal. Feature 075 FR-001 — a type-only reach into another
+ * module's `services/` is still a reach.
+ *
+ * `EmailMailerPort` joins it for the same reason at a larger scale:
+ * thirty-two import sites across eight modules named `Mailer` /
+ * `MailerSendInput` at `email/services/mailer.ts`, which makes it the single
+ * largest contract in the sweep and the one with the smallest surface — two
+ * shapes and one method.
+ */
+/** What became of one outbound message. */
+export declare const emailDeliveryStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    sent: "sent";
+    suppressed: "suppressed";
+}>;
+export type EmailDeliveryStatus = z.infer<typeof emailDeliveryStatusSchema>;
+/**
+ * Why a recorded message did not go out; absent for a delivered one.
+ *
+ * The split down the middle is the load-bearing part: the first two are the
+ * platform deliberately not sending, the last three are a message that was
+ * meant to go out and did not. An operator reading the record has to be able to
+ * tell a configuration from an outage, and since feature 074 shipped per-e-mail
+ * deactivation, "not sent" stopped being the same as "broken".
+ */
+export declare const emailDeliveryReasonSchema: z.ZodEnum<{
+    deactivated: "deactivated";
+    no_transport: "no_transport";
+    no_definition: "no_definition";
+    duplicate_message_id: "duplicate_message_id";
+    transport_error: "transport_error";
+}>;
+export type EmailDeliveryReason = z.infer<typeof emailDeliveryReasonSchema>;
+export interface EmailDeliveryRecordInput {
+    messageId: string;
+    recipient: string;
+    kind: string;
+    status: EmailDeliveryStatus;
+    reason?: EmailDeliveryReason;
+    detail?: string;
+    subject?: string;
+    salesChannelId?: string | null;
+    documentType?: string;
+    documentId?: string;
+    context?: Record<string, unknown>;
+}
+/**
+ * Container name: `emailDeliveryRecorder`. Owner: `email`.
+ *
+ * **Never throws.** That is the contract, not an implementation detail: every
+ * caller reaches this after a message has already been handed to a transport or
+ * already been suppressed, so a failure here can only lose the record — it must
+ * never be able to lose, or appear to lose, the send. A caller therefore needs
+ * no `catch`, which is also what keeps a bare one from growing around a port.
+ *
+ * Answers the row id, or `null` when the row could not be written.
+ *
+ * **Owner off:** there is no such state, and that is why the name is an
+ * ordinary `ctx.di.register` rather than a `providePort` — `email` declares
+ * `activation.nonDeactivatable` (074, C3), so a gate over this registration
+ * could never close, and the never-throws promise above would be the first
+ * thing it broke. Publication and gating are separate questions;
+ * `paymentOrderStatusRegistry` is the other name published over a plain
+ * registration for the same kind of reason.
+ */
+export interface EmailDeliveryRecorder {
+    record(input: EmailDeliveryRecordInput): Promise<string | null>;
+}
+export interface EmailAttachment {
+    filename: string;
+    content: Uint8Array;
+    contentType?: string;
+}
+export interface EmailMailerSendInput {
+    /** Stable id, idempotency key for retries. Every send is idempotent on it. */
+    messageId: string;
+    to: string;
+    subject: string;
+    /** Plain-text body (always present; the readable alternative for HTML mail). */
+    text: string;
+    /** Optional HTML body (feature 047). When present, sent as multipart alternative. */
+    html?: string;
+    /** Optional binary attachments (feature 047 invoices — PDF delivery). */
+    attachments?: EmailAttachment[];
+    /**
+     * What this message is — the transactional-email code, or a legacy in-code
+     * builder's own name for it (D-59). Absent, the delivery record falls back to
+     * `meta.kind`, which every in-code builder in the tree already carries.
+     */
+    kind?: string;
+    /**
+     * The business document this message delivers, when it delivers one (D-59).
+     * An invoice e-mail is the case the ruling was written for: the record has to
+     * be findable by the document an operator is asked about, not only by a
+     * recipient and a message id.
+     */
+    document?: {
+        type: string;
+        id: string;
+    };
+    /** The channel the message was rendered for, or `null` for the platform-wide one. */
+    salesChannelId?: string | null;
+    /** Optional structured payload retained alongside the email for audit. */
+    meta?: Record<string, unknown>;
+}
+/**
+ * Why a transport did not send a message it was handed, without failing (D-59).
+ *
+ * Today there is one: a driver that deduplicates on `messageId` and has already
+ * accepted this one. The union exists so a second reason arrives as a value the
+ * delivery record already knows how to hold, rather than as a boolean nobody
+ * can interpret.
+ */
+export type EmailMailerSuppressionReason = 'duplicate_message_id';
+/**
+ * What one transport call did with one message (D-59, issue #114).
+ *
+ * `send` answered `void`, so the layer that actually hands a message to SMTP
+ * was the one layer in the send path with nothing to say — while
+ * `TransactionalSendOutcome` and `OrderEmailResult`, computed above it, both
+ * distinguish a delivered message from a suppressed one. That is the gap this
+ * type closes, and the delivery record is what makes the answer outlive a log
+ * rotation.
+ *
+ * **A transport failure still throws.** Unchanged deliberately: every caller
+ * already contains its own send failure after a committed write, and turning
+ * the throw into a value would silently retire those tolerances. So this union
+ * enumerates the ways a message can fail to go out *without* an error, exactly
+ * as `TransactionalSendOutcome` does one layer up.
+ */
+export type EmailMailerSendOutcome = 
+/** Handed to the transport. */
+{
+    status: 'sent';
+}
+/** The transport deliberately did not send it. */
+ | {
+    status: 'suppressed';
+    reason: EmailMailerSuppressionReason;
+};
+/**
+ * Container name: `emailMailer`. Owner: `email`.
+ *
+ * **Registered with `ctx.di.register`, not `providePort`, and that is
+ * deliberate.** `email`'s manifest declares it non-deactivatable — it is the
+ * transport every message leaves through, and a business configures a driver
+ * rather than switching the transport off — so a gate on its effective state
+ * could never close. Feature 075 does not change that registration; a port
+ * whose gate is unreachable would advertise a failure mode the platform cannot
+ * produce. (`auth` is also non-deactivatable and does use `providePort`; the
+ * two differ because `auth` had already made that call for `requireAdmin`, and
+ * one answer per module beats one answer per repository.)
+ *
+ * The driver decision — SMTP when the environment configures one, console
+ * otherwise — belongs to the module and is not part of this contract, and
+ * neither does the delivery record: `EmailDeliveryRecorder` above is a
+ * separate registration because `transactional_emails` writes to it without
+ * going through the transport at all.
+ */
+export interface EmailMailerPort {
+    send(input: EmailMailerSendInput): Promise<EmailMailerSendOutcome>;
+}
+//# sourceMappingURL=email.d.ts.map

package/dist/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../src/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,2CAA2C;AAC3C,eAAO,MAAM,yBAAyB;;;;EAA2C,CAAC;AAClF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB;;;;;;EAWpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACjE;AAOD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,qFAAqF;IACrF,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,sBAAsB;AAChC,+BAA+B;AAC7B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE;AACpB,kDAAkD;GAChD;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,4BAA4B,CAAA;CAAE,CAAC;AAEnE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpE"}