@endora-commerce/contracts 0.100.0

package/dist/errors.d.ts

@@ -0,0 +1,455 @@
+import { z } from 'zod';
+/**
+ * Central catalog of API error codes — see specs/001-b2b-platform-foundation/contracts/README.md.
+ *
+ * Every non-2xx response SHOULD use one of these codes. The list grows as modules are added;
+ * new codes MUST be screaming-snake-case and documented in the relevant contract file.
+ */
+export declare const ERROR_CODES: {
+    readonly VALIDATION_FAILED: "VALIDATION_FAILED";
+    readonly INTERNAL: "INTERNAL";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly FORBIDDEN: "FORBIDDEN";
+    readonly RATE_LIMITED: "RATE_LIMITED";
+    readonly VERSION_CONFLICT: "VERSION_CONFLICT";
+    readonly FILTER_NOT_ALLOWED: "FILTER_NOT_ALLOWED";
+    readonly PRODUCT_NOT_FOUND: "PRODUCT_NOT_FOUND";
+    readonly PRICE_ORDERING_UNAVAILABLE: "PRICE_ORDERING_UNAVAILABLE";
+    readonly PRICE_RANGE_INVALID: "PRICE_RANGE_INVALID";
+    readonly PRODUCT_ARCHIVED: "PRODUCT_ARCHIVED";
+    readonly PRODUCT_DELETE_BLOCKED: "PRODUCT_DELETE_BLOCKED";
+    readonly SKU_ALREADY_EXISTS: "SKU_ALREADY_EXISTS";
+    readonly VARIANT_COMBINATION_EXISTS: "VARIANT_COMBINATION_EXISTS";
+    readonly VARIANT_AXIS_MISSING: "VARIANT_AXIS_MISSING";
+    readonly ATTRIBUTE_VALUE_REJECTED: "ATTRIBUTE_VALUE_REJECTED";
+    readonly FIELD_IMMUTABLE: "FIELD_IMMUTABLE";
+    readonly ATTRIBUTE_SET_CODE_TAKEN: "ATTRIBUTE_SET_CODE_TAKEN";
+    readonly ATTRIBUTE_SET_IN_USE: "ATTRIBUTE_SET_IN_USE";
+    readonly SYSTEM_ATTRIBUTE_SET_IMMUTABLE: "SYSTEM_ATTRIBUTE_SET_IMMUTABLE";
+    readonly ATTRIBUTE_SET_NOT_FOUND: "ATTRIBUTE_SET_NOT_FOUND";
+    readonly ATTRIBUTE_NOT_FOUND: "ATTRIBUTE_NOT_FOUND";
+    readonly GALLERY_LABEL_ALREADY_TAKEN: "GALLERY_LABEL_ALREADY_TAKEN";
+    readonly GALLERY_LABEL_LIMIT_EXCEEDED: "GALLERY_LABEL_LIMIT_EXCEEDED";
+    readonly ASSET_KIND_NOT_SUPPORTED: "ASSET_KIND_NOT_SUPPORTED";
+    readonly ATTACHMENT_TYPE_IN_USE: "ATTACHMENT_TYPE_IN_USE";
+    readonly ATTACHMENT_TYPE_CODE_TAKEN: "ATTACHMENT_TYPE_CODE_TAKEN";
+    readonly ATTACHMENT_TYPE_NOT_FOUND: "ATTACHMENT_TYPE_NOT_FOUND";
+    readonly ATTACHMENT_NOT_FOUND: "ATTACHMENT_NOT_FOUND";
+    readonly GALLERY_ITEM_NOT_FOUND: "GALLERY_ITEM_NOT_FOUND";
+    readonly PACKAGING_UNIT_NOT_FOUND: "PACKAGING_UNIT_NOT_FOUND";
+    readonly PACKAGING_UNIT_NAME_CONFLICT: "PACKAGING_UNIT_NAME_CONFLICT";
+    readonly PACKAGING_UNIT_NOT_SUPPORTED_FOR_TYPE: "PACKAGING_UNIT_NOT_SUPPORTED_FOR_TYPE";
+    readonly SELF_LINK_NOT_ALLOWED: "SELF_LINK_NOT_ALLOWED";
+    readonly LINK_ALREADY_EXISTS: "LINK_ALREADY_EXISTS";
+    readonly TARGET_PRODUCT_NOT_FOUND: "TARGET_PRODUCT_NOT_FOUND";
+    readonly PRODUCT_LINK_NOT_FOUND: "PRODUCT_LINK_NOT_FOUND";
+    readonly PRODUCT_TYPE_MISMATCH: "PRODUCT_TYPE_MISMATCH";
+    readonly NESTED_COMPOSITE_NOT_ALLOWED: "NESTED_COMPOSITE_NOT_ALLOWED";
+    readonly INVALID_QUANTITY_RANGE: "INVALID_QUANTITY_RANGE";
+    readonly OPTION_ALREADY_EXISTS: "OPTION_ALREADY_EXISTS";
+    readonly GROUPED_ITEM_NOT_FOUND: "GROUPED_ITEM_NOT_FOUND";
+    readonly BUNDLE_SLOT_NOT_FOUND: "BUNDLE_SLOT_NOT_FOUND";
+    readonly BUNDLE_SLOT_OPTION_NOT_FOUND: "BUNDLE_SLOT_OPTION_NOT_FOUND";
+    readonly MIN_NOT_MET: "MIN_NOT_MET";
+    readonly MAX_EXCEEDED: "MAX_EXCEEDED";
+    readonly UNKNOWN_OPTION: "UNKNOWN_OPTION";
+    readonly RFQ_NOT_DRAFT: "RFQ_NOT_DRAFT";
+    readonly RFQ_EMPTY: "RFQ_EMPTY";
+    readonly RFQ_NOT_QUOTED: "RFQ_NOT_QUOTED";
+    readonly RFQ_NOT_ACCEPTED: "RFQ_NOT_ACCEPTED";
+    readonly RFQ_NOT_NEW: "RFQ_NOT_NEW";
+    readonly RFQ_ALREADY_CLAIMED: "RFQ_ALREADY_CLAIMED";
+    readonly RFQ_EXPIRED: "RFQ_EXPIRED";
+    readonly QUOTE_INCOMPLETE: "QUOTE_INCOMPLETE";
+    readonly QUOTE_VALIDITY_ENDED: "QUOTE_VALIDITY_ENDED";
+    readonly SHOPPING_LIST_CANNOT_DELETE_DEFAULT: "SHOPPING_LIST_CANNOT_DELETE_DEFAULT";
+    readonly SHOPPING_LIST_CANNOT_DELETE_LAST: "SHOPPING_LIST_CANNOT_DELETE_LAST";
+    readonly ORGANIZATION_TAX_ID_EXISTS: "ORGANIZATION_TAX_ID_EXISTS";
+    readonly ORGANIZATION_HAS_CHILDREN: "ORGANIZATION_HAS_CHILDREN";
+    readonly ORGANIZATION_TREE_INVALID: "ORGANIZATION_TREE_INVALID";
+    readonly EMAIL_ALREADY_REGISTERED: "EMAIL_ALREADY_REGISTERED";
+    readonly EMAIL_ALREADY_IN_ORGANIZATION: "EMAIL_ALREADY_IN_ORGANIZATION";
+    readonly EMAIL_BELONGS_TO_ANOTHER_ORGANIZATION: "EMAIL_BELONGS_TO_ANOTHER_ORGANIZATION";
+    readonly TERMS_VERSION_STALE: "TERMS_VERSION_STALE";
+    readonly TOKEN_INVALID_OR_EXPIRED: "TOKEN_INVALID_OR_EXPIRED";
+    readonly INVALID_CREDENTIALS: "INVALID_CREDENTIALS";
+    readonly CURRENT_PASSWORD_INVALID: "CURRENT_PASSWORD_INVALID";
+    readonly TWO_FACTOR_REQUIRED: "TWO_FACTOR_REQUIRED";
+    readonly TWO_FACTOR_REQUIRED_BY_ROLE: "TWO_FACTOR_REQUIRED_BY_ROLE";
+    readonly CANNOT_REMOVE_LAST_ADMIN: "CANNOT_REMOVE_LAST_ADMIN";
+    readonly CANNOT_DEMOTE_LAST_ADMIN: "CANNOT_DEMOTE_LAST_ADMIN";
+    readonly CANNOT_REVOKE_LAST_ADMIN_INVITE: "CANNOT_REVOKE_LAST_ADMIN_INVITE";
+    readonly ADDRESS_IN_USE: "ADDRESS_IN_USE";
+    readonly ADDRESS_NOT_OWNED: "ADDRESS_NOT_OWNED";
+    readonly REGISTRATION_REQUIRES_ORGANIZATION: "REGISTRATION_REQUIRES_ORGANIZATION";
+    readonly ACCOUNT_BLOCKED: "ACCOUNT_BLOCKED";
+    readonly CUSTOMER_NOT_FOUND: "CUSTOMER_NOT_FOUND";
+    readonly CUSTOMER_ADDRESS_NOT_FOUND: "CUSTOMER_ADDRESS_NOT_FOUND";
+    readonly CUSTOMER_ALREADY_DELETED: "CUSTOMER_ALREADY_DELETED";
+    readonly CUSTOMER_NOT_DELETED: "CUSTOMER_NOT_DELETED";
+    readonly CUSTOMER_RESTORE_WINDOW_ELAPSED: "CUSTOMER_RESTORE_WINDOW_ELAPSED";
+    readonly ORG_OWNER_DEPLETION: "ORG_OWNER_DEPLETION";
+    readonly CART_EMPTY: "CART_EMPTY";
+    readonly CART_LINE_CAP_EXCEEDED: "CART_LINE_CAP_EXCEEDED";
+    readonly CART_COUPON_REJECTED: "CART_COUPON_REJECTED";
+    readonly STOCK_UNAVAILABLE: "STOCK_UNAVAILABLE";
+    readonly PROMOTION_INVALID: "PROMOTION_INVALID";
+    readonly ORGANIZATION_SUSPENDED: "ORGANIZATION_SUSPENDED";
+    readonly ORDER_NOT_FOUND: "ORDER_NOT_FOUND";
+    readonly ORDER_NOT_CANCELLABLE: "ORDER_NOT_CANCELLABLE";
+    readonly INVOICE_NOT_READY: "INVOICE_NOT_READY";
+    readonly INVOICE_NUMBER_PATTERN_COLLIDES: "INVOICE_NUMBER_PATTERN_COLLIDES";
+    readonly INVOICE_NUMBER_ALREADY_ISSUED: "INVOICE_NUMBER_ALREADY_ISSUED";
+    readonly INVALID_TRANSITION: "INVALID_TRANSITION";
+    readonly CREDIT_LIMIT_NOT_GRANTED: "CREDIT_LIMIT_NOT_GRANTED";
+    readonly CREDIT_LIMIT_ALREADY_GRANTED: "CREDIT_LIMIT_ALREADY_GRANTED";
+    readonly LIMIT_INSUFFICIENT: "LIMIT_INSUFFICIENT";
+    readonly CURRENCY_MISMATCH: "CURRENCY_MISMATCH";
+    readonly ADJUSTMENT_BELOW_ACTIVE: "ADJUSTMENT_BELOW_ACTIVE";
+    readonly ACTIVE_RESERVATIONS_EXIST: "ACTIVE_RESERVATIONS_EXIST";
+    readonly ALREADY_SUBSCRIBED: "ALREADY_SUBSCRIBED";
+    readonly PRODUCT_IN_STOCK: "PRODUCT_IN_STOCK";
+    readonly API_KEY_OUT_OF_SCOPE: "API_KEY_OUT_OF_SCOPE";
+    readonly WEBHOOK_DELIVERY_NOT_REPLAYABLE: "WEBHOOK_DELIVERY_NOT_REPLAYABLE";
+    readonly API_KEY_NOT_BOUND: "API_KEY_NOT_BOUND";
+    readonly API_KEY_CHANNEL_MISMATCH: "API_KEY_CHANNEL_MISMATCH";
+    readonly IDEMPOTENCY_KEY_REQUIRED: "IDEMPOTENCY_KEY_REQUIRED";
+    readonly IDEMPOTENCY_KEY_REUSED: "IDEMPOTENCY_KEY_REUSED";
+    readonly SKU_NOT_IN_ASSORTMENT: "SKU_NOT_IN_ASSORTMENT";
+    readonly PRICE_UNAVAILABLE: "PRICE_UNAVAILABLE";
+    readonly ADMIN_ROLE_CODE_TAKEN: "ADMIN_ROLE_CODE_TAKEN";
+    readonly ADMIN_ROLE_IN_USE: "ADMIN_ROLE_IN_USE";
+    readonly SETTING_NOT_REGISTERED: "SETTING_NOT_REGISTERED";
+    readonly SETTING_OUT_OF_SCOPE_FOR_CHANNEL: "SETTING_OUT_OF_SCOPE_FOR_CHANNEL";
+    readonly SETTING_VALUE_SHAPE_MISMATCH: "SETTING_VALUE_SHAPE_MISMATCH";
+    readonly SETTING_EMPTY_SUBSET: "SETTING_EMPTY_SUBSET";
+    readonly SETTING_GROUP_PROTECTED: "SETTING_GROUP_PROTECTED";
+    readonly SETTING_GROUP_NOT_FOUND: "SETTING_GROUP_NOT_FOUND";
+    readonly SETTING_CODE_CONFLICT: "SETTING_CODE_CONFLICT";
+    readonly SETTING_GROUP_CODE_CONFLICT: "SETTING_GROUP_CODE_CONFLICT";
+    readonly SETTING_BREAKING_CHANGE_REJECTED: "SETTING_BREAKING_CHANGE_REJECTED";
+    readonly SETTING_SECRET_KEY_MISSING: "SETTING_SECRET_KEY_MISSING";
+    readonly ASSISTANT_DISABLED: "ASSISTANT_DISABLED";
+    readonly ASSISTANT_NOT_CONFIGURED: "ASSISTANT_NOT_CONFIGURED";
+    readonly PROMPT_REQUEST_INVALID_STATE: "PROMPT_REQUEST_INVALID_STATE";
+    readonly PROMPT_PLAN_EXPIRED: "PROMPT_PLAN_EXPIRED";
+    readonly PROMPT_PERMISSION_REVOKED: "PROMPT_PERMISSION_REVOKED";
+    readonly PROMPT_REQUEST_IN_FLIGHT: "PROMPT_REQUEST_IN_FLIGHT";
+    readonly QUERY_TOO_SHORT: "QUERY_TOO_SHORT";
+    readonly QUERY_TOO_LONG: "QUERY_TOO_LONG";
+    readonly LIMIT_OUT_OF_RANGE: "LIMIT_OUT_OF_RANGE";
+    readonly SEARCH_BACKEND_UNAVAILABLE: "SEARCH_BACKEND_UNAVAILABLE";
+    readonly PHRASE_REQUIRED: "PHRASE_REQUIRED";
+    readonly PHRASE_TOO_LONG: "PHRASE_TOO_LONG";
+    readonly RESULT_COUNT_INVALID: "RESULT_COUNT_INVALID";
+    readonly LLM_CONFIG_INCOMPLETE: "LLM_CONFIG_INCOMPLETE";
+    readonly UNKNOWN_SALES_CHANNEL: "UNKNOWN_SALES_CHANNEL";
+    readonly INACTIVE_SALES_CHANNEL: "INACTIVE_SALES_CHANNEL";
+    readonly MISSING_SALES_CHANNEL_CONTEXT: "MISSING_SALES_CHANNEL_CONTEXT";
+    readonly DUPLICATE_SALES_CHANNEL_CODE: "DUPLICATE_SALES_CHANNEL_CODE";
+    readonly UNKNOWN_LANGUAGE_CODE: "UNKNOWN_LANGUAGE_CODE";
+    readonly UNKNOWN_CURRENCY_CODE: "UNKNOWN_CURRENCY_CODE";
+    readonly CANNOT_MODIFY_SYSTEM_DEFAULT: "CANNOT_MODIFY_SYSTEM_DEFAULT";
+    readonly SALES_CHANNEL_HAS_ATTRIBUTIONS: "SALES_CHANNEL_HAS_ATTRIBUTIONS";
+    readonly ENTITY_WOULD_HAVE_ZERO_CHANNELS: "ENTITY_WOULD_HAVE_ZERO_CHANNELS";
+    readonly STALE_SALES_CHANNEL_WRITE: "STALE_SALES_CHANNEL_WRITE";
+    readonly SALES_CHANNEL_ATTRIBUTION_IMMUTABLE: "SALES_CHANNEL_ATTRIBUTION_IMMUTABLE";
+    readonly SALES_CHANNEL_CODE_IMMUTABLE: "SALES_CHANNEL_CODE_IMMUTABLE";
+    readonly COMPARISON_FULL: "COMPARISON_FULL";
+    readonly COMPARISON_NOT_FOUND: "COMPARISON_NOT_FOUND";
+    readonly COMPARISON_EMPTY: "COMPARISON_EMPTY";
+    readonly PRODUCT_NOT_IN_COMPARISON: "PRODUCT_NOT_IN_COMPARISON";
+    readonly PDF_GENERATION_FAILED: "PDF_GENERATION_FAILED";
+    readonly WAREHOUSE_NOT_FOUND: "WAREHOUSE_NOT_FOUND";
+    readonly WAREHOUSE_CODE_TAKEN: "WAREHOUSE_CODE_TAKEN";
+    readonly WAREHOUSE_INVALID_CODE: "WAREHOUSE_INVALID_CODE";
+    readonly WAREHOUSE_CANNOT_DELETE_DEFAULT: "WAREHOUSE_CANNOT_DELETE_DEFAULT";
+    readonly WAREHOUSE_IS_DEFAULT_FOR_CHANNELS: "WAREHOUSE_IS_DEFAULT_FOR_CHANNELS";
+    readonly WAREHOUSE_HAS_STOCK: "WAREHOUSE_HAS_STOCK";
+    readonly CHANNEL_NO_WAREHOUSES: "CHANNEL_NO_WAREHOUSES";
+    readonly CHANNEL_WAREHOUSE_NOT_FOUND: "CHANNEL_WAREHOUSE_NOT_FOUND";
+    readonly STOCK_LEVEL_NOT_FOUND: "STOCK_LEVEL_NOT_FOUND";
+    readonly THRESHOLDS_INVALID: "THRESHOLDS_INVALID";
+    readonly PRODUCT_UNMANAGED_STOCK: "PRODUCT_UNMANAGED_STOCK";
+    readonly AVAILABILITY_NOTIFICATION_NOT_FOUND: "AVAILABILITY_NOTIFICATION_NOT_FOUND";
+    readonly STOCK_IMPORT_INVALID_FILE: "STOCK_IMPORT_INVALID_FILE";
+    readonly ASSET_NOT_FOUND: "ASSET_NOT_FOUND";
+    readonly ASSET_REFERENCED: "ASSET_REFERENCED";
+    readonly ASSET_FOLDER_NOT_FOUND: "ASSET_FOLDER_NOT_FOUND";
+    readonly ASSET_FOLDER_NOT_EMPTY: "ASSET_FOLDER_NOT_EMPTY";
+    readonly ASSET_FOLDER_NAME_CONFLICT: "ASSET_FOLDER_NAME_CONFLICT";
+    readonly ASSET_FOLDER_CYCLE: "ASSET_FOLDER_CYCLE";
+    readonly ASSET_UPLOAD_NO_FILE: "ASSET_UPLOAD_NO_FILE";
+    readonly ASSET_UPLOAD_TYPE_NOT_ALLOWED: "ASSET_UPLOAD_TYPE_NOT_ALLOWED";
+    readonly ASSET_UPLOAD_TOO_LARGE: "ASSET_UPLOAD_TOO_LARGE";
+    readonly ASSET_STORAGE_UNAVAILABLE: "ASSET_STORAGE_UNAVAILABLE";
+    readonly ASSET_STORAGE_MISCONFIGURED: "ASSET_STORAGE_MISCONFIGURED";
+    readonly ASSET_LEGACY_LOCATOR_CANNOT_HARDEN: "ASSET_LEGACY_LOCATOR_CANNOT_HARDEN";
+    readonly ASSET_FILE_MISSING: "ASSET_FILE_MISSING";
+    readonly ASSET_GONE: "ASSET_GONE";
+    readonly ASSET_ACCESS_DENIED: "ASSET_ACCESS_DENIED";
+    readonly CMS_PAGE_NOT_FOUND: "CMS_PAGE_NOT_FOUND";
+    readonly CMS_BLOCK_NOT_FOUND: "CMS_BLOCK_NOT_FOUND";
+    readonly CMS_TEMPLATE_NOT_FOUND: "CMS_TEMPLATE_NOT_FOUND";
+    readonly CMS_HOOK_NOT_FOUND: "CMS_HOOK_NOT_FOUND";
+    readonly CMS_SLUG_CONFLICT: "CMS_SLUG_CONFLICT";
+    readonly CMS_SLUG_RESERVED: "CMS_SLUG_RESERVED";
+    readonly CMS_CODE_CONFLICT: "CMS_CODE_CONFLICT";
+    readonly CMS_REFERENCED: "CMS_REFERENCED";
+    readonly CMS_HOOK_SYSTEM_PROTECTED: "CMS_HOOK_SYSTEM_PROTECTED";
+    readonly CMS_LANGUAGE_NOT_IN_CHANNEL_SCOPE: "CMS_LANGUAGE_NOT_IN_CHANNEL_SCOPE";
+    readonly CMS_SCHEMA_UPGRADE_FAILED: "CMS_SCHEMA_UPGRADE_FAILED";
+    readonly MEGAMENU_NOT_FOUND: "MEGAMENU_NOT_FOUND";
+    readonly MEGAMENU_HAS_ACTIVE_BINDINGS: "MEGAMENU_HAS_ACTIVE_BINDINGS";
+    readonly MEGAMENU_EMPTY_TREE: "MEGAMENU_EMPTY_TREE";
+    readonly MEGAMENU_BINDING_NOT_FOUND: "MEGAMENU_BINDING_NOT_FOUND";
+    readonly MEGAMENU_BINDING_ALREADY_EXISTS: "MEGAMENU_BINDING_ALREADY_EXISTS";
+    readonly MEGAMENU_LANGUAGE_NOT_IN_CHANNEL_SCOPE: "MEGAMENU_LANGUAGE_NOT_IN_CHANNEL_SCOPE";
+    readonly MEGAMENU_TARGET_OUT_OF_SCOPE: "MEGAMENU_TARGET_OUT_OF_SCOPE";
+    readonly MEGAMENU_ASSET_KIND_MISMATCH: "MEGAMENU_ASSET_KIND_MISMATCH";
+    readonly MEGAMENU_REFERENCED: "MEGAMENU_REFERENCED";
+    readonly MEGAMENU_DEPTH_EXCEEDED: "MEGAMENU_DEPTH_EXCEEDED";
+    readonly BLOG_SLUG_INVALID: "BLOG_SLUG_INVALID";
+    readonly BLOG_SLUG_TAKEN: "BLOG_SLUG_TAKEN";
+    readonly BLOG_POST_NOT_FOUND: "BLOG_POST_NOT_FOUND";
+    readonly BLOG_POST_NO_CHANNEL: "BLOG_POST_NO_CHANNEL";
+    readonly BLOG_POST_NO_LANGUAGE: "BLOG_POST_NO_LANGUAGE";
+    readonly BLOG_CATEGORY_NOT_FOUND: "BLOG_CATEGORY_NOT_FOUND";
+    readonly BLOG_CATEGORY_NO_CHANNEL: "BLOG_CATEGORY_NO_CHANNEL";
+    readonly BLOG_CATEGORY_CYCLE: "BLOG_CATEGORY_CYCLE";
+    readonly BLOG_CATEGORY_PROTECTED: "BLOG_CATEGORY_PROTECTED";
+    readonly BLOG_CATEGORY_IN_USE: "BLOG_CATEGORY_IN_USE";
+    readonly BLOG_CATEGORY_HAS_CHILDREN: "BLOG_CATEGORY_HAS_CHILDREN";
+    readonly BLOG_TAG_NOT_FOUND: "BLOG_TAG_NOT_FOUND";
+    readonly BLOG_TAG_CODE_TAKEN: "BLOG_TAG_CODE_TAKEN";
+    readonly BLOG_TAG_IN_USE: "BLOG_TAG_IN_USE";
+    readonly BLOG_URL_PREFIX_INVALID: "BLOG_URL_PREFIX_INVALID";
+    readonly BLOG_URL_PREFIX_RESERVED: "BLOG_URL_PREFIX_RESERVED";
+    readonly BLOG_DISABLED: "BLOG_DISABLED";
+    readonly BLOG_ASSET_KIND_MISMATCH: "BLOG_ASSET_KIND_MISMATCH";
+    readonly BLOG_RELATED_POST_SELF_REFERENCE: "BLOG_RELATED_POST_SELF_REFERENCE";
+    readonly ADMIN_ROLE_PROTECTED: "ADMIN_ROLE_PROTECTED";
+    readonly DICTIONARY_ENTRY_NOT_FOUND: "DICTIONARY_ENTRY_NOT_FOUND";
+    readonly DICTIONARY_ENTRY_INACTIVE: "DICTIONARY_ENTRY_INACTIVE";
+    readonly DICTIONARY_ENTRY_HAS_DEPENDENTS: "DICTIONARY_ENTRY_HAS_DEPENDENTS";
+    readonly DICTIONARY_LAST_ACTIVE_ENTRY: "DICTIONARY_LAST_ACTIVE_ENTRY";
+    readonly DICTIONARY_DEFAULT_CANNOT_BE_DEACTIVATED: "DICTIONARY_DEFAULT_CANNOT_BE_DEACTIVATED";
+    readonly DICTIONARY_FALLBACK_CYCLE: "DICTIONARY_FALLBACK_CYCLE";
+    readonly DICTIONARY_CODE_IMMUTABLE: "DICTIONARY_CODE_IMMUTABLE";
+    readonly DICTIONARY_TRANSLATION_LANGUAGE_INACTIVE: "DICTIONARY_TRANSLATION_LANGUAGE_INACTIVE";
+    readonly MODULE_DISABLED: "MODULE_DISABLED";
+    /** No manifest and no registry row answer to this module id. */
+    readonly MODULE_NOT_FOUND: "MODULE_NOT_FOUND";
+    /**
+     * The module declared itself non-deactivatable, or declares no activation
+     * control at all — either way there is nothing an operator may switch.
+     */
+    readonly MODULE_NOT_DEACTIVATABLE: "MODULE_NOT_DEACTIVATABLE";
+    /**
+     * An ordinary settings write targeted a module's activation control. The
+     * audited `module.activation.set` Command is the only door (FR-007, FR-009).
+     */
+    readonly MODULE_ACTIVATION_PROTECTED: "MODULE_ACTIVATION_PROTECTED";
+    /**
+     * Deactivating a module other effectively-present modules depend on
+     * (FR-008). Distinct from `MODULE_NOT_DEACTIVATABLE`, which says there is
+     * nothing to switch *ever*: this one is a "not in this order" with a remedy —
+     * `details.blockedBy` names the modules to switch off first.
+     */
+    readonly MODULE_DEPENDENTS_PRESENT: "MODULE_DEPENDENTS_PRESENT";
+    /**
+     * Activating a module whose own dependencies are not effectively present
+     * (FR-008, the symmetric direction). `details.missing` names them.
+     */
+    readonly MODULE_DEPENDENCIES_ABSENT: "MODULE_DEPENDENCIES_ABSENT";
+    /**
+     * A configuration write targeted a module that is not effectively present.
+     * Reads still show the stored value; writes are refused (FR-033).
+     */
+    readonly MODULE_SETTING_READ_ONLY: "MODULE_SETTING_READ_ONLY";
+    /**
+     * The owning module declared this individual email non-deactivatable —
+     * it is required to create an account or to get back into one. Deliberately
+     * the twin of `MODULE_NOT_DEACTIVATABLE`, one granularity down: same 409,
+     * same "there is nothing here to switch, ever", same carried reason.
+     */
+    readonly TRANSACTIONAL_EMAIL_NOT_DEACTIVATABLE: "TRANSACTIONAL_EMAIL_NOT_DEACTIVATABLE";
+    readonly BULK_TOO_LARGE: "BULK_TOO_LARGE";
+    readonly ATTRIBUTE_NOT_MASS_EDITABLE: "ATTRIBUTE_NOT_MASS_EDITABLE";
+    readonly SELECTION_TOO_LARGE: "SELECTION_TOO_LARGE";
+    readonly MFA_INVALID_CODE: "MFA_INVALID_CODE";
+    readonly MFA_INVALID_CHALLENGE: "MFA_INVALID_CHALLENGE";
+    readonly MFA_TOO_MANY_ATTEMPTS: "MFA_TOO_MANY_ATTEMPTS";
+    readonly MFA_WRONG_SURFACE: "MFA_WRONG_SURFACE";
+    readonly MFA_ALREADY_ENROLLED: "MFA_ALREADY_ENROLLED";
+    readonly MFA_NO_PENDING_ENROLMENT: "MFA_NO_PENDING_ENROLMENT";
+    readonly MFA_NO_ACTIVE_ENROLMENT: "MFA_NO_ACTIVE_ENROLMENT";
+    readonly MFA_REAUTH_REQUIRED: "MFA_REAUTH_REQUIRED";
+    readonly MFA_NOT_ENABLED: "MFA_NOT_ENABLED";
+    readonly MFA_SOCIAL_LAST_CREDENTIAL: "MFA_SOCIAL_LAST_CREDENTIAL";
+    readonly CUSTOM_FIELD_NOT_FOUND: "CUSTOM_FIELD_NOT_FOUND";
+    readonly CUSTOM_FIELD_KEY_CONFLICT: "CUSTOM_FIELD_KEY_CONFLICT";
+    readonly CUSTOM_FIELD_DEFINITION_INVALID: "CUSTOM_FIELD_DEFINITION_INVALID";
+    readonly CUSTOM_FIELD_VALUE_INVALID: "CUSTOM_FIELD_VALUE_INVALID";
+    readonly CUSTOM_FIELD_HOST_MANAGED: "CUSTOM_FIELD_HOST_MANAGED";
+    readonly CREDENTIAL_NOT_FOUND: "CREDENTIAL_NOT_FOUND";
+    readonly CREDENTIAL_CODE_TAKEN: "CREDENTIAL_CODE_TAKEN";
+    readonly CREDENTIAL_TYPE_UNKNOWN: "CREDENTIAL_TYPE_UNKNOWN";
+    readonly CREDENTIAL_VALIDATION_FAILED: "CREDENTIAL_VALIDATION_FAILED";
+    readonly CREDENTIAL_IN_USE: "CREDENTIAL_IN_USE";
+    readonly CREDENTIAL_TYPE_IMMUTABLE: "CREDENTIAL_TYPE_IMMUTABLE";
+    readonly PRODUCT_FEED_DISABLED: "PRODUCT_FEED_DISABLED";
+    readonly PRODUCT_FEED_TEMPLATE_UNBOUND: "PRODUCT_FEED_TEMPLATE_UNBOUND";
+    /**
+     * A template write refused on a state the operator can see and act on: it is
+     * a system template, it is still used by a feed, or its name is taken.
+     * `details.reason` carries which one, from `PRODUCT_FEED_ERROR_CODES`.
+     */
+    readonly PRODUCT_FEED_TEMPLATE_CONFLICT: "PRODUCT_FEED_TEMPLATE_CONFLICT";
+    /**
+     * The write is understood, allowed and refused only until the operator has
+     * seen its consequence — removing a field the provider's shipped template
+     * marks required (FR-074). It is deliberately neither a validation failure
+     * (the request is valid) nor a hard block (re-sending with
+     * `?acknowledgeWarnings=true` performs it); `details.warnings` carries what
+     * the operator has to be told first.
+     */
+    readonly PRODUCT_FEED_CONFIRMATION_REQUIRED: "PRODUCT_FEED_CONFIRMATION_REQUIRED";
+    /**
+     * A taxonomy revision write refused on a state the operator can see and act
+     * on: the mechanism is switched off, a check for that provider is already
+     * running, the impact figure they acknowledged no longer matches, or the
+     * revision is already the one in force. `details.reason` carries which one,
+     * from `PRODUCT_FEED_ERROR_CODES` (feature 067, FR-087, FR-095, FR-096).
+     */
+    readonly PRODUCT_FEED_TAXONOMY_CONFLICT: "PRODUCT_FEED_TAXONOMY_CONFLICT";
+    /**
+     * A price binding named a price list that does not exist. Named after the
+     * resource rather than the module (admin-api.md § Price bindings): the caller
+     * supplied a `priceListId`, and a bare `NOT_FOUND` on a request carrying three
+     * identifiers says nothing about which one was wrong.
+     */
+    readonly PRICE_LIST_NOT_FOUND: "PRICE_LIST_NOT_FOUND";
+    /** Another PIM connector is operator-active; activation refused (FR-003). */
+    readonly PIM_CONNECTOR_ALREADY_ACTIVE: "PIM_CONNECTOR_ALREADY_ACTIVE";
+    /** Another invoice-ledger vendor is operator-active; activation refused. */
+    readonly INVOICE_LEDGER_VENDOR_ALREADY_ACTIVE: "INVOICE_LEDGER_VENDOR_ALREADY_ACTIVE";
+    /** Required Infakt (or vendor) credentials are missing for this delivery. */
+    readonly INVOICE_LEDGER_CREDENTIALS_MISSING: "INVOICE_LEDGER_CREDENTIALS_MISSING";
+    /** Delivery is succeeded or otherwise not eligible for operator retry. */
+    readonly INVOICE_LEDGER_DELIVERY_NOT_RETRYABLE: "INVOICE_LEDGER_DELIVERY_NOT_RETRYABLE";
+    /** Another ERP connector is operator-active; activation refused (FR-006). */
+    readonly ERP_CONNECTOR_ALREADY_ACTIVE: "ERP_CONNECTOR_ALREADY_ACTIVE";
+    /** The order owes nothing — already paid, deferred to credit, or refunded. */
+    readonly PAYMENT_NOT_DUE: "PAYMENT_NOT_DUE";
+    /** The order's lifecycle is over, so no payment can be started against it. */
+    readonly PAYMENT_ORDER_CLOSED: "PAYMENT_ORDER_CLOSED";
+    /**
+     * The money is still owed and the order is open; the shop cannot start a
+     * session because the method it was placed with is gone. Named for the
+     * adapter and not the method, because `PAYMENT_METHOD_*` is the family
+     * `payment_methods` would reach for and D-182 routes a contested code to
+     * neither claimant.
+     */
+    readonly PAYMENT_ADAPTER_UNAVAILABLE: "PAYMENT_ADAPTER_UNAVAILABLE";
+};
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+/**
+ * The shape of every error code on the wire — the platform's own and a
+ * module's alike (`specs/090-module-owned-error-codes/`, `contracts/error-code-declaration.md` §1.1).
+ *
+ * SCREAMING_SNAKE_CASE, and it is the one grammar three separate things agree
+ * on: `ERROR_CODES`' own members, a module's `errorCodes` manifest declaration,
+ * and the `errors.<CODE>` key the sentence is written under.
+ */
+export declare const errorCodeRe: RegExp;
+declare const moduleErrorCodeBrand: unique symbol;
+/**
+ * An error code declared by a module rather than enumerated by the platform.
+ *
+ * `ERROR_CODES` stays closed and stays the vocabulary of the codes **this
+ * repository's** modules declare (`error-code-declaration.md` §5). A module
+ * written outside this repository has no way into it, so its codes need a type
+ * of their own — and D-182's amendment of 2026-08-28 rules that the type is
+ * **branded**, produced only by {@link defineModuleErrorCodes}:
+ *
+ * > *"the stranger gets the protection our own core modules already have: a typo
+ * > at a raise site is a compile error rather than a code that travels the whole
+ * > path and renders raw to an operator with nothing reporting it."*
+ *
+ * **What the brand buys, exactly**, because it is easy to over-read. It bites on
+ * *assignability*: a bare `'ACME_TYPO'` is assignable to neither `ErrorCode` nor
+ * this type, so `new HttpError(400, 'ACME_TYPO', …)` does not compile. It does
+ * **not** bite on *comparability*, which is the `===` at a reading site —
+ * measured on TypeScript 5.9: with `code: ErrorCode | ModuleErrorCode`, both
+ * `code === 'ACME_TYPO'` and `code === 'PRDUCT_NOT_FOUND'` compile, where the
+ * second is a type error today against the closed enumeration. That is the cost
+ * `research.md` §7 records and `plan.md` Q3 leaves open; the brand does not pay
+ * it. And it says nothing at all about a code declared and never translated
+ * (the reconciliation) or about two modules claiming one code (the collision
+ * rule) — two things the same amendment is careful to spell out.
+ */
+export type ModuleErrorCode = string & {
+    readonly [moduleErrorCodeBrand]: 'module-error-code';
+};
+/**
+ * The authoring shape for a module's own error codes.
+ *
+ * ```ts
+ * export const acmeErrorCodes = defineModuleErrorCodes([
+ *   'ACME_SYNC_NOT_CONFIGURED',
+ *   'ACME_SYNC_REJECTED',
+ * ]);
+ *
+ * throw new HttpError(409, acmeErrorCodes.ACME_SYNC_REJECTED, 'Sync rejected.');
+ * ```
+ *
+ * The returned object's keys are the codes, so a typo at a raise site is a
+ * property that does not exist; its values carry the brand, so a bare string
+ * literal cannot stand in for one. Declaring the code in the manifest
+ * (`errorCodes: [{ code: 'ACME_SYNC_REJECTED' }]`) is a separate act and remains
+ * what routes the sentence — this helper decides nothing about routing.
+ *
+ * Two refusals, both at import time on the author's own machine, neither needing
+ * an instance: a code that is not SCREAMING_SNAKE_CASE, and the same code twice.
+ * The second matters because the return value is an object, where a duplicate
+ * collapses silently into one key.
+ */
+export declare function defineModuleErrorCodes<const Codes extends readonly string[]>(codes: Codes): {
+    readonly [Code in Codes[number]]: ModuleErrorCode;
+};
+export declare const errorDetailSchema: z.ZodObject<{
+    path: z.ZodString;
+    issue: z.ZodString;
+}, z.core.$strip>;
+export declare const errorEnvelopeSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        code: z.ZodString & z.ZodType<ErrorCode | ModuleErrorCode, string, z.core.$ZodTypeInternals<ErrorCode | ModuleErrorCode, string>>;
+        message: z.ZodString;
+        details: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            issue: z.ZodString;
+        }, z.core.$strip>>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+        requestId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ErrorEnvelope = z.infer<typeof errorEnvelopeSchema>;
+/**
+ * `MODULE_DISABLED` names the module it refused for (issue #161).
+ *
+ * The refusal is raised in one place — the kernel's `ModuleDisabledError` — and
+ * carried the module id on the error object only. The envelope replaces an
+ * operator-visible message with the registered sentence for its **code**, and
+ * `MODULE_DISABLED` is one code for every gated port in the platform, so the
+ * wire carried "Module Disabled." and the one fact the operator needs to act —
+ * which module to look at — never left the process. It is published here rather
+ * than left implicit because it is a wire shape: a client may read it, and the
+ * sentence interpolates `{module}` out of it.
+ */
+export declare const moduleDisabledDetailsSchema: z.ZodObject<{
+    module: z.ZodString;
+}, z.core.$strip>;
+export type ModuleDisabledDetails = z.infer<typeof moduleDisabledDetailsSchema>;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4TtB,gEAAgE;;IAEhE;;;OAGG;;IAEH;;;OAGG;;IAEH;;;;;OAKG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAIH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkDH;;;;OAIG;;IAEH;;;;;;;OAOG;;IAEH;;;;;;OAMG;;IAGH;;;;;OAKG;;IAIH,6EAA6E;;IAI7E,4EAA4E;;IAE5E,6EAA6E;;IAE7E,0EAA0E;;IAM1E,6EAA6E;;IAQ7E,8EAA8E;;IAE9E,8EAA8E;;IAE9E;;;;;;OAMG;;CAEK,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,QAAsB,CAAC;AAE/C,OAAO,CAAC,MAAM,oBAAoB,EAAE,OAAO,MAAM,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG;IACrC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,mBAAmB,CAAC;CACtD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,CAAC,KAAK,SAAS,SAAS,MAAM,EAAE,EAC1E,KAAK,EAAE,KAAK,GACX;IAAE,QAAQ,EAAE,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,eAAe;CAAE,CAoBvD;AAED,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;iBA0B9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B;;iBAGtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}