@revenexx/node 0.0.2 → 0.1.1

package/dist/services/markets.d.ts

@@ -1,32 +1,204 @@
 import { Client } from '../client.js';
 import { Models } from '../models.js';
+import { MarketsListStatus } from '../enums/markets-list-status.js';
 import { MarketStatus } from '../enums/market-status.js';
+import { MarketsVocabularyName } from '../enums/markets-vocabulary-name.js';
 import '../query.js';
-import '../enums/address-type.js';
+import '../enums/address-type-row-tone.js';
+import '../enums/address-type-row-create-request-tone.js';
+import '../enums/address-type-row-update-request-tone.js';
+import '../enums/approval-rule-approver-type.js';
+import '../enums/approval-rule-condition.js';
+import '../enums/approval-rule-effect.js';
+import '../enums/approval-rule-create-request-approver-type.js';
+import '../enums/approval-rule-create-request-condition.js';
+import '../enums/approval-rule-create-request-effect.js';
+import '../enums/approval-rule-update-request-approver-type.js';
+import '../enums/approval-rule-update-request-condition.js';
+import '../enums/approval-rule-update-request-effect.js';
+import '../enums/assets-source.js';
+import '../enums/attribute-value-bucket.js';
+import '../enums/auth-mail-source.js';
+import '../enums/recovery-mail-source.js';
+import '../enums/registration-status.js';
+import '../enums/budget-change-reason.js';
+import '../enums/budget-movement-result-status.js';
+import '../enums/cart-status.js';
+import '../enums/cart-merge-strategy.js';
+import '../enums/cart-price-snapshot-mode.js';
+import '../enums/cart-io-format.js';
 import '../enums/cart-export-format.js';
 import '../enums/cart-item-type.js';
+import '../enums/cart-vocabulary-tone.js';
+import '../enums/cart-vocabulary-name.js';
+import '../enums/cart-vocabulary-source.js';
+import '../enums/cart-vocabulary-ref-name.js';
+import '../enums/categories-rule-match.js';
+import '../enums/category-rule-operator.js';
+import '../enums/category-rule-match.js';
 import '../enums/channel-status.js';
-import '../enums/channel-type.js';
-import '../enums/contact-role.js';
+import '../enums/channel-unassigned-visibility.js';
+import '../enums/channel-unresolved-reason.js';
+import '../enums/channel-context-source.js';
+import '../enums/channel-inactive-behavior.js';
+import '../enums/channel-policy-source.js';
+import '../enums/channel-policy-tenant-default.js';
+import '../enums/channel-unassigned-policy.js';
+import '../enums/channel-type-tone.js';
+import '../enums/channel-visibility-reason.js';
+import '../enums/channel-vocabulary-tone.js';
+import '../enums/channel-vocabulary-name.js';
+import '../enums/channel-vocabulary-source.js';
+import '../enums/channel-vocabulary-ref-name.js';
+import '../enums/contact-registration-status.js';
 import '../enums/contact-status.js';
+import '../enums/contact-activity-kind.js';
+import '../enums/contact-create-request-registration-status.js';
+import '../enums/contact-event-kind-tone.js';
+import '../enums/contact-event-kind-create-request-tone.js';
+import '../enums/contact-event-kind-update-request-tone.js';
+import '../enums/contact-update-request-registration-status.js';
+import '../enums/cost-center-budget-type.js';
+import '../enums/cost-center-restriction-type.js';
+import '../enums/cost-center-restriction-create-request-type.js';
+import '../enums/cost-center-restriction-update-request-type.js';
+import '../enums/payment-fee-type.js';
+import '../enums/payment-method-kind.js';
+import '../enums/form-status.js';
+import '../enums/form-submission-status.js';
+import '../enums/form-notify-source.js';
+import '../enums/form-submission-prune-request-status.js';
+import '../enums/forms-vocabulary-tone.js';
+import '../enums/forms-vocabulary-name.js';
+import '../enums/forms-vocabulary-summary-name.js';
+import '../enums/inventory-vocabulary-default-tone.js';
+import '../enums/inventory-vocabulary-source.js';
 import '../enums/cart-io-apply-mode.js';
 import '../enums/cart-io-direction.js';
 import '../enums/cart-io-entity.js';
-import '../enums/cart-io-format.js';
+import '../enums/io-profile-resource-apply-mode.js';
+import '../enums/io-profile-resource-direction.js';
+import '../enums/lifecycle-stage-tone.js';
+import '../enums/lifecycle-stage-create-request-tone.js';
+import '../enums/lifecycle-stage-update-request-tone.js';
 import '../enums/location-type.js';
+import '../enums/market-default-locale-source.js';
+import '../enums/market-locale-fallback.js';
+import '../enums/market-locale-granularity.js';
+import '../enums/market-pricing-source.js';
+import '../enums/market-tax-basis.js';
+import '../enums/market-readiness-check-id.js';
+import '../enums/market-readiness-severity.js';
+import '../enums/markets-vocabulary-tone.js';
+import '../enums/markets-vocabulary-source.js';
+import '../enums/markets-vocabulary-summary-name.js';
+import '../enums/order-fulfillment-status.js';
+import '../enums/order-payment-status.js';
+import '../enums/order-status.js';
+import '../enums/order-cancellation-scope.js';
 import '../enums/order-comment-visibility.js';
 import '../enums/order-item-type.js';
-import '../enums/order-list-kind.js';
-import '../enums/order-payment-status.js';
+import '../enums/order-list-kind-tone.js';
+import '../enums/order-list-kind-row-tone.js';
+import '../enums/order-list-cart-mode.js';
+import '../enums/order-list-vocabulary-default-tone.js';
+import '../enums/order-list-vocabulary-name.js';
+import '../enums/order-list-vocabulary-source.js';
+import '../enums/order-list-vocabulary-tone.js';
+import '../enums/order-return-status.js';
+import '../enums/order-return-settlement.js';
+import '../enums/order-return-refusal.js';
+import '../enums/order-vocabulary-tone.js';
+import '../enums/order-vocabulary-name.js';
+import '../enums/order-vocabulary-source.js';
+import '../enums/order-vocabulary-summary-name.js';
+import '../enums/order-resolution-stage.js';
 import '../enums/organization-status.js';
 import '../enums/page-status.js';
-import '../enums/payment-fee-type.js';
-import '../enums/payment-method-kind.js';
+import '../enums/pages-vocabulary-app.js';
+import '../enums/pages-vocabulary-tone.js';
+import '../enums/pages-vocabulary-name.js';
+import '../enums/pages-vocabulary-source.js';
+import '../enums/pages-vocabulary-index-app.js';
+import '../enums/payment-dunning-stage.js';
+import '../enums/payment-failure-code.js';
+import '../enums/payment-status.js';
+import '../enums/payment-term-tone.js';
+import '../enums/payment-term-create-request-tone.js';
+import '../enums/payment-term-update-request-tone.js';
+import '../enums/payment-vocabulary-tone.js';
+import '../enums/pending-approval-approver-type.js';
+import '../enums/pending-approval-status.js';
+import '../enums/price-ending-rule.js';
+import '../enums/price-entries-adjust-response-rounding.js';
+import '../enums/price-entries-adjust-response-rounding-mode.js';
+import '../enums/price-entries-bulk-mode.js';
+import '../enums/price-rounding-mode.js';
 import '../enums/price-entry-type.js';
 import '../enums/price-list-status.js';
+import '../enums/price-list-tax-basis.js';
+import '../enums/price-currency-source.js';
+import '../enums/price-list-tiebreak.js';
+import '../enums/price-tax-inclusive-default.js';
+import '../enums/price-tax-unresolved-reason.js';
+import '../enums/price-tax-market-source.js';
+import '../enums/price-vocabulary-tone.js';
+import '../enums/price-vocabulary-name.js';
+import '../enums/price-vocabulary-source.js';
+import '../enums/price-vocabulary-ref-name.js';
+import '../enums/product-categories-source.js';
+import '../enums/product-grid-column-source.js';
+import '../enums/product-label-source.js';
+import '../enums/product-label-attribute-source.js';
+import '../enums/products-kind.js';
+import '../enums/purchase-request-status.js';
+import '../enums/purchase-request-event-name.js';
+import '../enums/purchase-request-item-type.js';
+import '../enums/purchase-request-item-create-request-type.js';
+import '../enums/purchase-request-item-update-request-type.js';
+import '../enums/reorder-point-source.js';
+import '../enums/reservation-status.js';
+import '../enums/price-on-request-reason.js';
+import '../enums/price-tax-basis.js';
+import '../enums/price-tax-basis-source.js';
+import '../enums/role-catalog-response-source.js';
+import '../enums/segment-rule-match.js';
+import '../enums/segment-member-source.js';
+import '../enums/segment-rule-operator.js';
+import '../enums/segment-rule-preview-request-rule-match.js';
+import '../enums/segment-rule-preview-request-target.js';
+import '../enums/segment-rule-preview-response-rule-match.js';
+import '../enums/segment-rule-preview-response-target.js';
+import '../enums/segment-rules-target.js';
+import '../enums/shipping-carrier-status.js';
 import '../enums/shipping-method-matrix-basis.js';
 import '../enums/shipping-method-pricing-type.js';
+import '../enums/shipping-carrier-source.js';
+import '../enums/shipping-rate-pricing-type.js';
+import '../enums/shipping-tax-source.js';
+import '../enums/shipping-free-above-basis.js';
+import '../enums/shipping-rates-basis-matrix-basis-default.js';
+import '../enums/shipping-service-level-create-request-tone.js';
+import '../enums/shipping-service-level-row-tone.js';
+import '../enums/shipping-service-level-update-request-tone.js';
+import '../enums/shipping-tax-unresolved-reason.js';
+import '../enums/shipping-tax-market-source.js';
+import '../enums/shipping-tax-context-via.js';
+import '../enums/shipping-tracking-carrier-status.js';
+import '../enums/shipping-vocabulary-default-tone.js';
+import '../enums/shipping-vocabulary-source.js';
+import '../enums/shipping-vocabulary-tone.js';
+import '../enums/shipping-weight-unit-create-request-tone.js';
+import '../enums/shipping-weight-unit-row-tone.js';
+import '../enums/shipping-weight-unit-update-request-tone.js';
+import '../enums/stock-movement-type.js';
 import '../enums/store-asset-request-visibility.js';
+import '../enums/submit-item-type.js';
+import '../enums/submit-result-outcome.js';
+import '../enums/validation-failed-response-status.js';
+import '../enums/vocabulary-default-tone.js';
+import '../enums/vocabulary-source.js';
+import '../enums/vocabulary-tone.js';
 import '../enums/attribute-boolean-status.js';
 import '../enums/attribute-datetime-status.js';
 import '../enums/attribute-email-status.js';
@@ -68,44 +240,77 @@ import '../enums/execution-trigger.js';
 import '../enums/health-antivirus-status.js';
 import '../enums/health-status-status.js';
 import '../enums/index-status.js';
-import '../enums/message-status.js';
+import '../enums/message-2-status.js';
 
 declare class Markets {
     client: Client;
     constructor(client: Client);
     /**
+     * Every column is an exact-match filter and they combine with AND (?code=northwind); each one is declared as a query parameter above. A `?column=value` this entity does not have is DROPPED rather than refused — the call answers 200 with the unfiltered list — and `filter` echoes what was actually applied, which is the only way to tell that apart from a filter that matched nothing.
      *
-     * @param {number} params.limit - Page size (default 50, max 200).
-     * @param {number} params.offset - Row offset for pagination (default 0).
-     * @param {string} params.order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} params.id - Exact match on `id`. Primary key. Note that OTHER apps do not store this: the market scope dimension is keyed on `code` (manifest `provides_scopes.slug_source = markets.code`), so a row elsewhere that is "in this market" carries the code, not this uuid. It is the item routes and /context that want this value.
+     * @param {string} params.code - Exact match on `code`. Market code, unique per tenant, and the single most load-bearing string in this app: it IS the market scope slug. The Entity Scoping Engine publishes it as the `market` dimension (`scope_context.market` in the JWT), and every other commerce app — products, prices, orders, customers — stores THIS value to say which market a row belongs to. Renaming it re-keys that scope for everyone, so treat it as permanent. Accepted in place of the uuid on /readiness, /clone, /backfill and /make-default — but not on the item routes or /context, which take a uuid only.
+     * @param {string} params.name - Exact match on `name`. Display name, in the operator's own language. Cockpit copy only — nothing resolves a market by it.
+     * @param {string} params.labels - Exact match on `labels`. Exact whole-document equality on the jsonb: the value is a whole JSON document and has to match every key, so this is not a path or a containment query. Key order and whitespace are irrelevant — the comparison is semantic. A value that does not parse as JSON is refused with 400 `invalid_value` rather than answered with zero rows. Localized display names for storefronts, keyed by locale: a flat {locale: label} map, one level deep, string values. WHICH key to write is not free — GET /markets/{id}/context returns `locale_policy`, whose `write` is the key this tenant keys by (a full locale under regional granularity, a bare language under language granularity) and whose `read` is the order to try. Null means nothing is translated and `name` is all there is.
+     * @param {string} params.currency - Exact match on `currency`. Base currency this market quotes in — ISO 4217, and schema.json's own default is 'EUR'. This is the single currency prices are STATED in; the currencies collection under the market is the wider set it accepts. A base currency missing from that collection is a blocking readiness failure.
+     * @param {MarketsListStatus} params.status - Exact match on `status`. Default 'active'. Only an active market serves a storefront; 'inactive' keeps the market and all its configuration but takes it out of service. Readiness reports an active market that cannot trade as `serving: true, ready: false` — live and broken.
+     * @param {boolean} params.isDefault - Exact match on `is_default`. The tenant default market — what a call naming no market falls back to. Exactly one market holds it; move it with POST /markets/{id}/make-default rather than by writing this flag, which does not demote the market that currently holds it.
+     * @param {number} params.position - Exact match on `position`. Sort position among the tenant's markets, ascending, default 0. Presentation only — it decides the order the Cockpit and a market picker list them in, and nothing resolves a market by it.
+     * @param {string} params.createdAt - Exact match on `created_at`. When the market row was inserted. Set by the database; never writable.
+     * @param {string} params.updatedAt - Exact match on `updated_at`. When the market row was last written. Set by the database on every update; never writable.
+     * @param {number} params.limit - Page size (default 50, max 200). Out of range is CLAMPED, not refused — ?limit=999 answers 200 with 200 rows, and `page.limit` says so.
+     * @param {number} params.offset - Row offset for pagination (default 0). A negative offset is clamped to 0 rather than refused.
+     * @param {string} params.order - Sort as 'column' | 'column.asc' | 'column.desc'. The direction is lower case, and the column has to exist: id, code, name, labels, currency, status, is_default, position, created_at, updated_at.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketList>}
      */
     marketsList(params?: {
+        id?: string;
+        code?: string;
+        name?: string;
+        labels?: string;
+        currency?: string;
+        status?: MarketsListStatus;
+        isDefault?: boolean;
+        position?: number;
+        createdAt?: string;
+        updatedAt?: string;
         limit?: number;
         offset?: number;
         order?: string;
-    }): Promise<{}>;
+    }): Promise<Models.MarketList>;
     /**
+     * Every column is an exact-match filter and they combine with AND (?code=northwind); each one is declared as a query parameter above. A `?column=value` this entity does not have is DROPPED rather than refused — the call answers 200 with the unfiltered list — and `filter` echoes what was actually applied, which is the only way to tell that apart from a filter that matched nothing.
      *
-     * @param {number} limit - Page size (default 50, max 200).
-     * @param {number} offset - Row offset for pagination (default 0).
-     * @param {string} order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} id - Exact match on `id`. Primary key. Note that OTHER apps do not store this: the market scope dimension is keyed on `code` (manifest `provides_scopes.slug_source = markets.code`), so a row elsewhere that is "in this market" carries the code, not this uuid. It is the item routes and /context that want this value.
+     * @param {string} code - Exact match on `code`. Market code, unique per tenant, and the single most load-bearing string in this app: it IS the market scope slug. The Entity Scoping Engine publishes it as the `market` dimension (`scope_context.market` in the JWT), and every other commerce app — products, prices, orders, customers — stores THIS value to say which market a row belongs to. Renaming it re-keys that scope for everyone, so treat it as permanent. Accepted in place of the uuid on /readiness, /clone, /backfill and /make-default — but not on the item routes or /context, which take a uuid only.
+     * @param {string} name - Exact match on `name`. Display name, in the operator's own language. Cockpit copy only — nothing resolves a market by it.
+     * @param {string} labels - Exact match on `labels`. Exact whole-document equality on the jsonb: the value is a whole JSON document and has to match every key, so this is not a path or a containment query. Key order and whitespace are irrelevant — the comparison is semantic. A value that does not parse as JSON is refused with 400 `invalid_value` rather than answered with zero rows. Localized display names for storefronts, keyed by locale: a flat {locale: label} map, one level deep, string values. WHICH key to write is not free — GET /markets/{id}/context returns `locale_policy`, whose `write` is the key this tenant keys by (a full locale under regional granularity, a bare language under language granularity) and whose `read` is the order to try. Null means nothing is translated and `name` is all there is.
+     * @param {string} currency - Exact match on `currency`. Base currency this market quotes in — ISO 4217, and schema.json's own default is 'EUR'. This is the single currency prices are STATED in; the currencies collection under the market is the wider set it accepts. A base currency missing from that collection is a blocking readiness failure.
+     * @param {MarketsListStatus} status - Exact match on `status`. Default 'active'. Only an active market serves a storefront; 'inactive' keeps the market and all its configuration but takes it out of service. Readiness reports an active market that cannot trade as `serving: true, ready: false` — live and broken.
+     * @param {boolean} isDefault - Exact match on `is_default`. The tenant default market — what a call naming no market falls back to. Exactly one market holds it; move it with POST /markets/{id}/make-default rather than by writing this flag, which does not demote the market that currently holds it.
+     * @param {number} position - Exact match on `position`. Sort position among the tenant's markets, ascending, default 0. Presentation only — it decides the order the Cockpit and a market picker list them in, and nothing resolves a market by it.
+     * @param {string} createdAt - Exact match on `created_at`. When the market row was inserted. Set by the database; never writable.
+     * @param {string} updatedAt - Exact match on `updated_at`. When the market row was last written. Set by the database on every update; never writable.
+     * @param {number} limit - Page size (default 50, max 200). Out of range is CLAMPED, not refused — ?limit=999 answers 200 with 200 rows, and `page.limit` says so.
+     * @param {number} offset - Row offset for pagination (default 0). A negative offset is clamped to 0 rather than refused.
+     * @param {string} order - Sort as 'column' | 'column.asc' | 'column.desc'. The direction is lower case, and the column has to exist: id, code, name, labels, currency, status, is_default, position, created_at, updated_at.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketList>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    marketsList(limit?: number, offset?: number, order?: string): Promise<{}>;
+    marketsList(id?: string, code?: string, name?: string, labels?: string, currency?: string, status?: MarketsListStatus, isDefault?: boolean, position?: number, createdAt?: string, updatedAt?: string, limit?: number, offset?: number, order?: string): Promise<Models.MarketList>;
     /**
+     * A market needs a 'code' and a 'name' — currency defaults to EUR, status to active. To get a market that can actually trade, clone an existing one instead: POST /markets/{id}/clone.
      *
-     * @param {string} params.code - Market code (unique per tenant).
-     * @param {string} params.name -
-     * @param {string} params.currency - ISO 4217 code (default 'EUR').
-     * @param {boolean} params.isDefault -
-     * @param {object} params.labels - Localized display names ({locale: label}).
-     * @param {number} params.position - Sort position (default 0).
-     * @param {MarketStatus} params.status - Default 'active'.
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.code - Market code, unique per tenant, and the single most load-bearing string in this app: it IS the market scope slug. The Entity Scoping Engine publishes it as the `market` dimension (`scope_context.market` in the JWT), and every other commerce app — products, prices, orders, customers — stores THIS value to say which market a row belongs to. Renaming it re-keys that scope for everyone, so treat it as permanent. Accepted in place of the uuid on /readiness, /clone, /backfill and /make-default — but not on the item routes or /context, which take a uuid only.
+     * @param {string} params.name - Display name, in the operator's own language. Cockpit copy only — nothing resolves a market by it.
+     * @param {string} params.currency - Base currency this market quotes in — ISO 4217, and schema.json's own default is 'EUR'. This is the single currency prices are STATED in; the currencies collection under the market is the wider set it accepts. A base currency missing from that collection is a blocking readiness failure.
+     * @param {boolean} params.isDefault - The tenant default market — what a call naming no market falls back to. Exactly one market holds it; move it with POST /markets/{id}/make-default rather than by writing this flag, which does not demote the market that currently holds it.
+     * @param {object} params.labels - Localized display names for storefronts, keyed by locale: a flat {locale: label} map, one level deep, string values. WHICH key to write is not free — GET /markets/{id}/context returns `locale_policy`, whose `write` is the key this tenant keys by (a full locale under regional granularity, a bare language under language granularity) and whose `read` is the order to try. Null means nothing is translated and `name` is all there is.
+     * @param {number} params.position - Sort position among the tenant's markets, ascending, default 0. Presentation only — it decides the order the Cockpit and a market picker list them in, and nothing resolves a market by it.
+     * @param {MarketStatus} params.status - Default 'active'. Only an active market serves a storefront; 'inactive' keeps the market and all its configuration but takes it out of service. Readiness reports an active market that cannot trade as `serving: true, ready: false` — live and broken.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Market>}
      */
     marketsCreate(params: {
@@ -118,64 +323,103 @@ declare class Markets {
         status?: MarketStatus;
     }): Promise<Models.Market>;
     /**
+     * A market needs a 'code' and a 'name' — currency defaults to EUR, status to active. To get a market that can actually trade, clone an existing one instead: POST /markets/{id}/clone.
      *
-     * @param {string} code - Market code (unique per tenant).
-     * @param {string} name -
-     * @param {string} currency - ISO 4217 code (default 'EUR').
-     * @param {boolean} isDefault -
-     * @param {object} labels - Localized display names ({locale: label}).
-     * @param {number} position - Sort position (default 0).
-     * @param {MarketStatus} status - Default 'active'.
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} code - Market code, unique per tenant, and the single most load-bearing string in this app: it IS the market scope slug. The Entity Scoping Engine publishes it as the `market` dimension (`scope_context.market` in the JWT), and every other commerce app — products, prices, orders, customers — stores THIS value to say which market a row belongs to. Renaming it re-keys that scope for everyone, so treat it as permanent. Accepted in place of the uuid on /readiness, /clone, /backfill and /make-default — but not on the item routes or /context, which take a uuid only.
+     * @param {string} name - Display name, in the operator's own language. Cockpit copy only — nothing resolves a market by it.
+     * @param {string} currency - Base currency this market quotes in — ISO 4217, and schema.json's own default is 'EUR'. This is the single currency prices are STATED in; the currencies collection under the market is the wider set it accepts. A base currency missing from that collection is a blocking readiness failure.
+     * @param {boolean} isDefault - The tenant default market — what a call naming no market falls back to. Exactly one market holds it; move it with POST /markets/{id}/make-default rather than by writing this flag, which does not demote the market that currently holds it.
+     * @param {object} labels - Localized display names for storefronts, keyed by locale: a flat {locale: label} map, one level deep, string values. WHICH key to write is not free — GET /markets/{id}/context returns `locale_policy`, whose `write` is the key this tenant keys by (a full locale under regional granularity, a bare language under language granularity) and whose `read` is the order to try. Null means nothing is translated and `name` is all there is.
+     * @param {number} position - Sort position among the tenant's markets, ascending, default 0. Presentation only — it decides the order the Cockpit and a market picker list them in, and nothing resolves a market by it.
+     * @param {MarketStatus} status - Default 'active'. Only an active market serves a storefront; 'inactive' keeps the market and all its configuration but takes it out of service. Readiness reports an active market that cannot trade as `serving: true, ready: false` — live and broken.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Market>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     marketsCreate(code: string, name: string, currency?: string, isDefault?: boolean, labels?: object, position?: number, status?: MarketStatus): Promise<Models.Market>;
     /**
+     * How this tenant keys its translations, resolved for a surface that stands in no market at all. The Cockpit edits a tenant BASELINE when no market is selected, and a baseline value has to be readable by every market — so the locale set answered here is the UNION of every market's locales, each one already resolved to the key it is written under, not one market's list and not a pair of setting names to re-implement. Each entry names the markets that asked for that locale: an editor listing six inputs without saying who needs them invites translations nobody will ever read. Write/read keys follow the same two settings as the per-market answer, so a baseline and a market value can never be keyed differently.
+     *
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.TenantLocalePolicy>}
+     */
+    marketsLocalePolicy(): Promise<Models.TenantLocalePolicy>;
+    /**
+     * Every closed value set this app owns, listed by name with its title and its description but WITHOUT its values — enough to build a menu of them, and a name to fetch one by when a select box actually needs the values. Static per app version; nothing about a tenant changes it. It reads no table and takes no parameter, so 200 is the only answer it has beyond the gateway's own.
+     *
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketsVocabularyIndex>}
+     */
+    marketsVocabularies(): Promise<Models.MarketsVocabularyIndex>;
+    /**
+     * One value set in full: every value the column may hold, in the order it may hold them, with the copy and the badge tone a client renders each one as. The values are not kept in a list beside the database, they are parsed out of the CHECK constraint in this app's own schema.json — so the set served here IS the set enforced on a write, and a select box built from it cannot offer a value the write would then refuse. A name outside the declared enum is a 404 rather than an empty list — an empty vocabulary and an unknown one mean different things to a select box.
      *
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {MarketsVocabularyName} params.name - Which vocabulary to read. The enum is exhaustive — these are every value set this app owns, and anything else is a 404.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketsVocabulary>}
+     */
+    marketsVocabulary(params: {
+        name: MarketsVocabularyName;
+    }): Promise<Models.MarketsVocabulary>;
+    /**
+     * One value set in full: every value the column may hold, in the order it may hold them, with the copy and the badge tone a client renders each one as. The values are not kept in a list beside the database, they are parsed out of the CHECK constraint in this app's own schema.json — so the set served here IS the set enforced on a write, and a select box built from it cannot offer a value the write would then refuse. A name outside the declared enum is a 404 rather than an empty list — an empty vocabulary and an unknown one mean different things to a select box.
+     *
+     * @param {MarketsVocabularyName} name - Which vocabulary to read. The enum is exhaustive — these are every value set this app owns, and anything else is a 404.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketsVocabulary>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    marketsVocabulary(name: MarketsVocabularyName): Promise<Models.MarketsVocabulary>;
+    /**
+     * Deleting a market takes its locales, currencies and tax classes with it: all three carry an ON DELETE CASCADE onto markets.id, so this is never refused for having children.
+     *
+     * @param {string} params.id - The market, by its primary key. A uuid — this route does not resolve a market code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketDeleted>}
      */
     marketsDelete(params: {
         id: string;
-    }): Promise<{}>;
+    }): Promise<Models.MarketDeleted>;
     /**
+     * Deleting a market takes its locales, currencies and tax classes with it: all three carry an ON DELETE CASCADE onto markets.id, so this is never refused for having children.
      *
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} id - The market, by its primary key. A uuid — this route does not resolve a market code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketDeleted>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    marketsDelete(id: string): Promise<{}>;
+    marketsDelete(id: string): Promise<Models.MarketDeleted>;
     /**
+     * Resolved by uuid only — unlike /readiness, /clone, /backfill and /make-default, a market CODE here is a 400 rather than a lookup.
      *
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.id - The market, by its primary key. A uuid — this route does not resolve a market code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Market>}
      */
     marketsGet(params: {
         id: string;
     }): Promise<Models.Market>;
     /**
+     * Resolved by uuid only — unlike /readiness, /clone, /backfill and /make-default, a market CODE here is a 400 rather than a lookup.
      *
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} id - The market, by its primary key. A uuid — this route does not resolve a market code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Market>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     marketsGet(id: string): Promise<Models.Market>;
     /**
+     * Partial: omitted fields keep their value.
      *
-     * @param {string} params.id -
-     * @param {string} params.code - Market code (unique per tenant).
-     * @param {string} params.currency - ISO 4217 code (default 'EUR').
-     * @param {boolean} params.isDefault -
-     * @param {object} params.labels - Localized display names ({locale: label}).
-     * @param {string} params.name -
-     * @param {number} params.position - Sort position (default 0).
-     * @param {MarketStatus} params.status - Default 'active'.
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.id - The market, by its primary key. A uuid — this route does not resolve a market code, so a segment that will not cast is a 400 before any row is read.
+     * @param {string} params.code - Market code, unique per tenant, and the single most load-bearing string in this app: it IS the market scope slug. The Entity Scoping Engine publishes it as the `market` dimension (`scope_context.market` in the JWT), and every other commerce app — products, prices, orders, customers — stores THIS value to say which market a row belongs to. Renaming it re-keys that scope for everyone, so treat it as permanent. Accepted in place of the uuid on /readiness, /clone, /backfill and /make-default — but not on the item routes or /context, which take a uuid only.
+     * @param {string} params.currency - Base currency this market quotes in — ISO 4217, and schema.json's own default is 'EUR'. This is the single currency prices are STATED in; the currencies collection under the market is the wider set it accepts. A base currency missing from that collection is a blocking readiness failure.
+     * @param {boolean} params.isDefault - The tenant default market — what a call naming no market falls back to. Exactly one market holds it; move it with POST /markets/{id}/make-default rather than by writing this flag, which does not demote the market that currently holds it.
+     * @param {object} params.labels - Localized display names for storefronts, keyed by locale: a flat {locale: label} map, one level deep, string values. WHICH key to write is not free — GET /markets/{id}/context returns `locale_policy`, whose `write` is the key this tenant keys by (a full locale under regional granularity, a bare language under language granularity) and whose `read` is the order to try. Null means nothing is translated and `name` is all there is.
+     * @param {string} params.name - Display name, in the operator's own language. Cockpit copy only — nothing resolves a market by it.
+     * @param {number} params.position - Sort position among the tenant's markets, ascending, default 0. Presentation only — it decides the order the Cockpit and a market picker list them in, and nothing resolves a market by it.
+     * @param {MarketStatus} params.status - Default 'active'. Only an active market serves a storefront; 'inactive' keeps the market and all its configuration but takes it out of service. Readiness reports an active market that cannot trade as `serving: true, ready: false` — live and broken.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Market>}
      */
     marketsUpdate(params: {
@@ -189,70 +433,203 @@ declare class Markets {
         status?: MarketStatus;
     }): Promise<Models.Market>;
     /**
+     * Partial: omitted fields keep their value.
      *
-     * @param {string} id -
-     * @param {string} code - Market code (unique per tenant).
-     * @param {string} currency - ISO 4217 code (default 'EUR').
-     * @param {boolean} isDefault -
-     * @param {object} labels - Localized display names ({locale: label}).
-     * @param {string} name -
-     * @param {number} position - Sort position (default 0).
-     * @param {MarketStatus} status - Default 'active'.
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} id - The market, by its primary key. A uuid — this route does not resolve a market code, so a segment that will not cast is a 400 before any row is read.
+     * @param {string} code - Market code, unique per tenant, and the single most load-bearing string in this app: it IS the market scope slug. The Entity Scoping Engine publishes it as the `market` dimension (`scope_context.market` in the JWT), and every other commerce app — products, prices, orders, customers — stores THIS value to say which market a row belongs to. Renaming it re-keys that scope for everyone, so treat it as permanent. Accepted in place of the uuid on /readiness, /clone, /backfill and /make-default — but not on the item routes or /context, which take a uuid only.
+     * @param {string} currency - Base currency this market quotes in — ISO 4217, and schema.json's own default is 'EUR'. This is the single currency prices are STATED in; the currencies collection under the market is the wider set it accepts. A base currency missing from that collection is a blocking readiness failure.
+     * @param {boolean} isDefault - The tenant default market — what a call naming no market falls back to. Exactly one market holds it; move it with POST /markets/{id}/make-default rather than by writing this flag, which does not demote the market that currently holds it.
+     * @param {object} labels - Localized display names for storefronts, keyed by locale: a flat {locale: label} map, one level deep, string values. WHICH key to write is not free — GET /markets/{id}/context returns `locale_policy`, whose `write` is the key this tenant keys by (a full locale under regional granularity, a bare language under language granularity) and whose `read` is the order to try. Null means nothing is translated and `name` is all there is.
+     * @param {string} name - Display name, in the operator's own language. Cockpit copy only — nothing resolves a market by it.
+     * @param {number} position - Sort position among the tenant's markets, ascending, default 0. Presentation only — it decides the order the Cockpit and a market picker list them in, and nothing resolves a market by it.
+     * @param {MarketStatus} status - Default 'active'. Only an active market serves a storefront; 'inactive' keeps the market and all its configuration but takes it out of service. Readiness reports an active market that cannot trade as `serving: true, ready: false` — live and broken.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Market>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     marketsUpdate(id: string, code?: string, currency?: string, isDefault?: boolean, labels?: object, name?: string, position?: number, status?: MarketStatus): Promise<Models.Market>;
     /**
+     * Repairs the market in the path out of a source market that is already right. The two are compared by CODE, collection by collection, and only the codes this market does not already carry are added — so a locale, a currency or a tax class it already holds is left exactly as the merchant left it, rate included, and is never overwritten. Both the path id and `source` are resolved by uuid OR by market code. Idempotent: running it twice adds nothing the second time.
      *
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.id - The market being REPAIRED — a uuid or a market code.
+     * @param {string} params.source - The market to copy the missing pieces FROM — a uuid or a market code. Must not be the market in the path. Pick a market that is already right; nothing about it is changed.
+     * @param {boolean} params.currencies - Take the source's traded currencies for codes this market does not already carry. Default true.
+     * @param {boolean} params.locales - Take the source's locales for codes this market does not already carry. Default true.
+     * @param {boolean} params.taxClasses - Take the source's tax classes for codes this market does not already carry. An existing code keeps ITS rate — a backfill never re-rates a class the merchant already set. Default true.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketBackfillResult>}
+     */
+    marketsBackfill(params: {
+        id: string;
+        source: string;
+        currencies?: boolean;
+        locales?: boolean;
+        taxClasses?: boolean;
+    }): Promise<Models.MarketBackfillResult>;
+    /**
+     * Repairs the market in the path out of a source market that is already right. The two are compared by CODE, collection by collection, and only the codes this market does not already carry are added — so a locale, a currency or a tax class it already holds is left exactly as the merchant left it, rate included, and is never overwritten. Both the path id and `source` are resolved by uuid OR by market code. Idempotent: running it twice adds nothing the second time.
+     *
+     * @param {string} id - The market being REPAIRED — a uuid or a market code.
+     * @param {string} source - The market to copy the missing pieces FROM — a uuid or a market code. Must not be the market in the path. Pick a market that is already right; nothing about it is changed.
+     * @param {boolean} currencies - Take the source's traded currencies for codes this market does not already carry. Default true.
+     * @param {boolean} locales - Take the source's locales for codes this market does not already carry. Default true.
+     * @param {boolean} taxClasses - Take the source's tax classes for codes this market does not already carry. An existing code keeps ITS rate — a backfill never re-rates a class the merchant already set. Default true.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketBackfillResult>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    marketsBackfill(id: string, source: string, currencies?: boolean, locales?: boolean, taxClasses?: boolean): Promise<Models.MarketBackfillResult>;
+    /**
+     * Creates a NEW market out of an existing one, taking its locales, its traded currencies and its tax classes with it in a single call. That is the difference between this and POST /markets: a plain create leaves a row that cannot serve anybody, while what comes back here is a market with a language to render in, a currency to price in and a rate to tax with. The path id is the SOURCE market, resolved by uuid OR by market code.
+     *
+     * @param {string} params.id - The SOURCE market to copy — a uuid or a market code.
+     * @param {string} params.code - Code of the NEW market (unique per tenant).
+     * @param {boolean} params.copyCurrencies - Copy the source's traded currencies. Default true. The new market's own base currency is registered and marked default either way.
+     * @param {boolean} params.copyLocales - Copy the source's locales. Default true. False leaves the new market with no language of its own, so the tenant fallback_locale is seeded instead — it is never left with none.
+     * @param {boolean} params.copyTaxClasses - Copy the source's tax classes, rates and all. Default true. False leaves the market unable to tax anything, which readiness reports as blocking.
+     * @param {string} params.currency - Base currency of the new market (ISO 4217). Defaults to the source market's, and is registered and marked default on the new one either way.
+     * @param {string} params.name - Display name of the new market. Defaults to its code.
+     * @param {MarketStatus} params.status - Status of the new market. Defaults to 'active'; clone it 'inactive' to build it out before it serves anyone.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketCloneResult>}
+     */
+    marketsClone(params: {
+        id: string;
+        code: string;
+        copyCurrencies?: boolean;
+        copyLocales?: boolean;
+        copyTaxClasses?: boolean;
+        currency?: string;
+        name?: string;
+        status?: MarketStatus;
+    }): Promise<Models.MarketCloneResult>;
+    /**
+     * Creates a NEW market out of an existing one, taking its locales, its traded currencies and its tax classes with it in a single call. That is the difference between this and POST /markets: a plain create leaves a row that cannot serve anybody, while what comes back here is a market with a language to render in, a currency to price in and a rate to tax with. The path id is the SOURCE market, resolved by uuid OR by market code.
+     *
+     * @param {string} id - The SOURCE market to copy — a uuid or a market code.
+     * @param {string} code - Code of the NEW market (unique per tenant).
+     * @param {boolean} copyCurrencies - Copy the source's traded currencies. Default true. The new market's own base currency is registered and marked default either way.
+     * @param {boolean} copyLocales - Copy the source's locales. Default true. False leaves the new market with no language of its own, so the tenant fallback_locale is seeded instead — it is never left with none.
+     * @param {boolean} copyTaxClasses - Copy the source's tax classes, rates and all. Default true. False leaves the market unable to tax anything, which readiness reports as blocking.
+     * @param {string} currency - Base currency of the new market (ISO 4217). Defaults to the source market's, and is registered and marked default on the new one either way.
+     * @param {string} name - Display name of the new market. Defaults to its code.
+     * @param {MarketStatus} status - Status of the new market. Defaults to 'active'; clone it 'inactive' to build it out before it serves anyone.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketCloneResult>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    marketsClone(id: string, code: string, copyCurrencies?: boolean, copyLocales?: boolean, copyTaxClasses?: boolean, currency?: string, name?: string, status?: MarketStatus): Promise<Models.MarketCloneResult>;
+    /**
+     * The storefront bootstrap: everything a frontend needs to render one market, resolved server-side so no client re-derives it — the market row, its locales, the currencies it trades in and its tax classes; WHICH locale to actually render in and where that answer came from; which key to read and write a translation under; whether the prices it will be handed are gross or net; and whether any of it is trustworthy. One call rather than five, and — more to the point — one place the resolution rules live, instead of a slightly different copy of them in every storefront. This one resolves the market by id only: unlike /readiness, /clone and /backfill, a market CODE here is a 400, not a lookup.
+     *
+     * @param {string} params.id - The market. A uuid — this route does not accept a market code.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketContext>}
      */
     marketsContext(params: {
         id: string;
     }): Promise<Models.MarketContext>;
     /**
+     * The storefront bootstrap: everything a frontend needs to render one market, resolved server-side so no client re-derives it — the market row, its locales, the currencies it trades in and its tax classes; WHICH locale to actually render in and where that answer came from; which key to read and write a translation under; whether the prices it will be handed are gross or net; and whether any of it is trustworthy. One call rather than five, and — more to the point — one place the resolution rules live, instead of a slightly different copy of them in every storefront. This one resolves the market by id only: unlike /readiness, /clone and /backfill, a market CODE here is a 400, not a lookup.
      *
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} id - The market. A uuid — this route does not accept a market code.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketContext>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     marketsContext(id: string): Promise<Models.MarketContext>;
     /**
+     * A tenant has ONE default market: it is what every call naming none falls back to. Moving the flag from a client was promote-then-demote, two PATCHes that leave two defaults when the second does not land and none when the first does. This is the one call instead — it promotes the market in the path and demotes whoever held the flag in the same operation, writing once per row that was actually wrong and not touching the rest. Accepts an id or a market CODE. Answers the market plus the codes it demoted; repeating the call writes nothing.
      *
-     * @param {string} params.marketId -
-     * @param {number} params.limit - Page size (default 50, max 200).
-     * @param {number} params.offset - Row offset for pagination (default 0).
-     * @param {string} params.order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} params.id - The market to promote — a uuid or a market code.
+     * @param {object} params.data - Request body
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketMakeDefaultResponse>}
+     */
+    marketsMakeDefault(params: {
+        id: string;
+        data: object;
+    }): Promise<Models.MarketMakeDefaultResponse>;
+    /**
+     * A tenant has ONE default market: it is what every call naming none falls back to. Moving the flag from a client was promote-then-demote, two PATCHes that leave two defaults when the second does not land and none when the first does. This is the one call instead — it promotes the market in the path and demotes whoever held the flag in the same operation, writing once per row that was actually wrong and not touching the rest. Accepts an id or a market CODE. Answers the market plus the codes it demoted; repeating the call writes nothing.
+     *
+     * @param {string} id - The market to promote — a uuid or a market code.
+     * @param {object} data - Request body
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketMakeDefaultResponse>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    marketsMakeDefault(id: string, data: object): Promise<Models.MarketMakeDefaultResponse>;
+    /**
+     * Whether this market can actually trade, and if not, what is missing. Every check runs on every call and comes back with its own severity, so the answer is a diagnosis rather than a yes or a no: a market with no currency registered has nothing to price in and a market with no tax class has nothing to tax with, and both of those fail BLOCKING, which is what turns `ready` false. A check that is merely degraded — no locale of its own, while the tenant declares a fallback_locale that covers for it — fails as a warning and leaves the market serviceable. Resolves the market by uuid OR by market code.
+     *
+     * @param {string} params.id - The market — a uuid or a market code.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketReadinessReport>}
+     */
+    marketsReadiness(params: {
+        id: string;
+    }): Promise<Models.MarketReadinessReport>;
+    /**
+     * Whether this market can actually trade, and if not, what is missing. Every check runs on every call and comes back with its own severity, so the answer is a diagnosis rather than a yes or a no: a market with no currency registered has nothing to price in and a market with no tax class has nothing to tax with, and both of those fail BLOCKING, which is what turns `ready` false. A check that is merely degraded — no locale of its own, while the tenant declares a fallback_locale that covers for it — fails as a warning and leaves the market serviceable. Resolves the market by uuid OR by market code.
+     *
+     * @param {string} id - The market — a uuid or a market code.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketReadinessReport>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    marketsReadiness(id: string): Promise<Models.MarketReadinessReport>;
+    /**
+     * Every column is an exact-match filter and they combine with AND (?code=EUR); each one is declared as a query parameter above. A `?column=value` this entity does not have is DROPPED rather than refused — the call answers 200 with the unfiltered list — and `filter` echoes what was actually applied, which is the only way to tell that apart from a filter that matched nothing. `market_id` is not among them: the owning market comes from the path and overwrites anything the query says. An unknown but well-formed market lists empty rather than 404 — the parent is filtered on, not verified.
+     *
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.id - Exact match on `id`. Primary key of this currency registration. The currency is named by `code` everywhere else.
+     * @param {string} params.code - Exact match on `code`. ISO 4217 code, unique per market — one entry in the set of currencies this market TRADES in, as opposed to the single base currency on the market row that its prices are quoted in. The base currency must appear here or the market cannot serve; clone and backfill register it for you.
+     * @param {boolean} params.isDefault - Exact match on `is_default`. The currency offered first to a buyer who states no preference. At most one per market, and it should be the market's base currency — readiness reports it as a warning when it is not.
+     * @param {number} params.position - Exact match on `position`. Sort position among this market's currencies, ascending, default 0 — the order a currency switcher lists them in.
+     * @param {string} params.createdAt - Exact match on `created_at`. When the currency was registered on this market. Set by the database; never writable.
+     * @param {number} params.limit - Page size (default 50, max 200). Out of range is CLAMPED, not refused — ?limit=999 answers 200 with 200 rows, and `page.limit` says so.
+     * @param {number} params.offset - Row offset for pagination (default 0). A negative offset is clamped to 0 rather than refused.
+     * @param {string} params.order - Sort as 'column' | 'column.asc' | 'column.desc'. The direction is lower case, and the column has to exist: id, market_id, code, is_default, position, created_at.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketCurrencyList>}
      */
     marketsCurrenciesList(params: {
         marketId: string;
+        id?: string;
+        code?: string;
+        isDefault?: boolean;
+        position?: number;
+        createdAt?: string;
         limit?: number;
         offset?: number;
         order?: string;
-    }): Promise<{}>;
+    }): Promise<Models.MarketCurrencyList>;
     /**
+     * Every column is an exact-match filter and they combine with AND (?code=EUR); each one is declared as a query parameter above. A `?column=value` this entity does not have is DROPPED rather than refused — the call answers 200 with the unfiltered list — and `filter` echoes what was actually applied, which is the only way to tell that apart from a filter that matched nothing. `market_id` is not among them: the owning market comes from the path and overwrites anything the query says. An unknown but well-formed market lists empty rather than 404 — the parent is filtered on, not verified.
      *
-     * @param {string} marketId -
-     * @param {number} limit - Page size (default 50, max 200).
-     * @param {number} offset - Row offset for pagination (default 0).
-     * @param {string} order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} id - Exact match on `id`. Primary key of this currency registration. The currency is named by `code` everywhere else.
+     * @param {string} code - Exact match on `code`. ISO 4217 code, unique per market — one entry in the set of currencies this market TRADES in, as opposed to the single base currency on the market row that its prices are quoted in. The base currency must appear here or the market cannot serve; clone and backfill register it for you.
+     * @param {boolean} isDefault - Exact match on `is_default`. The currency offered first to a buyer who states no preference. At most one per market, and it should be the market's base currency — readiness reports it as a warning when it is not.
+     * @param {number} position - Exact match on `position`. Sort position among this market's currencies, ascending, default 0 — the order a currency switcher lists them in.
+     * @param {string} createdAt - Exact match on `created_at`. When the currency was registered on this market. Set by the database; never writable.
+     * @param {number} limit - Page size (default 50, max 200). Out of range is CLAMPED, not refused — ?limit=999 answers 200 with 200 rows, and `page.limit` says so.
+     * @param {number} offset - Row offset for pagination (default 0). A negative offset is clamped to 0 rather than refused.
+     * @param {string} order - Sort as 'column' | 'column.asc' | 'column.desc'. The direction is lower case, and the column has to exist: id, market_id, code, is_default, position, created_at.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketCurrencyList>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    marketsCurrenciesList(marketId: string, limit?: number, offset?: number, order?: string): Promise<{}>;
+    marketsCurrenciesList(marketId: string, id?: string, code?: string, isDefault?: boolean, position?: number, createdAt?: string, limit?: number, offset?: number, order?: string): Promise<Models.MarketCurrencyList>;
     /**
+     * The owning market comes from the path and overrides anything in the body.
      *
-     * @param {string} params.marketId -
-     * @param {string} params.code - ISO 4217 code, e.g. EUR (unique per market).
-     * @param {boolean} params.isDefault -
-     * @param {number} params.position - Sort position (default 0).
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.code - ISO 4217 code, unique per market — one entry in the set of currencies this market TRADES in, as opposed to the single base currency on the market row that its prices are quoted in. The base currency must appear here or the market cannot serve; clone and backfill register it for you.
+     * @param {boolean} params.isDefault - The currency offered first to a buyer who states no preference. At most one per market, and it should be the market's base currency — readiness reports it as a warning when it is not.
+     * @param {number} params.position - Sort position among this market's currencies, ascending, default 0 — the order a currency switcher lists them in.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketCurrency>}
      */
     marketsCurrenciesCreate(params: {
@@ -262,41 +639,45 @@ declare class Markets {
         position?: number;
     }): Promise<Models.MarketCurrency>;
     /**
+     * The owning market comes from the path and overrides anything in the body.
      *
-     * @param {string} marketId -
-     * @param {string} code - ISO 4217 code, e.g. EUR (unique per market).
-     * @param {boolean} isDefault -
-     * @param {number} position - Sort position (default 0).
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} code - ISO 4217 code, unique per market — one entry in the set of currencies this market TRADES in, as opposed to the single base currency on the market row that its prices are quoted in. The base currency must appear here or the market cannot serve; clone and backfill register it for you.
+     * @param {boolean} isDefault - The currency offered first to a buyer who states no preference. At most one per market, and it should be the market's base currency — readiness reports it as a warning when it is not.
+     * @param {number} position - Sort position among this market's currencies, ascending, default 0 — the order a currency switcher lists them in.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketCurrency>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     marketsCurrenciesCreate(marketId: string, code: string, isDefault?: boolean, position?: number): Promise<Models.MarketCurrency>;
     /**
+     * Scoped to the market in the path — a row belonging to another market is a 404 here, and is never deleted.
      *
-     * @param {string} params.marketId -
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.id - The currency of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketCurrencyDeleted>}
      */
     marketsCurrenciesDelete(params: {
         marketId: string;
         id: string;
-    }): Promise<{}>;
+    }): Promise<Models.MarketCurrencyDeleted>;
     /**
+     * Scoped to the market in the path — a row belonging to another market is a 404 here, and is never deleted.
      *
-     * @param {string} marketId -
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} id - The currency of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketCurrencyDeleted>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    marketsCurrenciesDelete(marketId: string, id: string): Promise<{}>;
+    marketsCurrenciesDelete(marketId: string, id: string): Promise<Models.MarketCurrencyDeleted>;
     /**
+     * Scoped strictly to the market in the path: a row belonging to another market is a 404 here, never a 200.
      *
-     * @param {string} params.marketId -
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.id - The currency of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketCurrency>}
      */
     marketsCurrenciesGet(params: {
@@ -304,22 +685,24 @@ declare class Markets {
         id: string;
     }): Promise<Models.MarketCurrency>;
     /**
+     * Scoped strictly to the market in the path: a row belonging to another market is a 404 here, never a 200.
      *
-     * @param {string} marketId -
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} id - The currency of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketCurrency>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     marketsCurrenciesGet(marketId: string, id: string): Promise<Models.MarketCurrency>;
     /**
+     * Partial: omitted fields keep their value.
      *
-     * @param {string} params.marketId -
-     * @param {string} params.id -
-     * @param {string} params.code - ISO 4217 code, e.g. EUR (unique per market).
-     * @param {boolean} params.isDefault -
-     * @param {number} params.position - Sort position (default 0).
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.id - The currency of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @param {string} params.code - ISO 4217 code, unique per market — one entry in the set of currencies this market TRADES in, as opposed to the single base currency on the market row that its prices are quoted in. The base currency must appear here or the market cannot serve; clone and backfill register it for you.
+     * @param {boolean} params.isDefault - The currency offered first to a buyer who states no preference. At most one per market, and it should be the market's base currency — readiness reports it as a warning when it is not.
+     * @param {number} params.position - Sort position among this market's currencies, ascending, default 0 — the order a currency switcher lists them in.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketCurrency>}
      */
     marketsCurrenciesUpdate(params: {
@@ -330,52 +713,77 @@ declare class Markets {
         position?: number;
     }): Promise<Models.MarketCurrency>;
     /**
+     * Partial: omitted fields keep their value.
      *
-     * @param {string} marketId -
-     * @param {string} id -
-     * @param {string} code - ISO 4217 code, e.g. EUR (unique per market).
-     * @param {boolean} isDefault -
-     * @param {number} position - Sort position (default 0).
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} id - The currency of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @param {string} code - ISO 4217 code, unique per market — one entry in the set of currencies this market TRADES in, as opposed to the single base currency on the market row that its prices are quoted in. The base currency must appear here or the market cannot serve; clone and backfill register it for you.
+     * @param {boolean} isDefault - The currency offered first to a buyer who states no preference. At most one per market, and it should be the market's base currency — readiness reports it as a warning when it is not.
+     * @param {number} position - Sort position among this market's currencies, ascending, default 0 — the order a currency switcher lists them in.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketCurrency>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     marketsCurrenciesUpdate(marketId: string, id: string, code?: string, isDefault?: boolean, position?: number): Promise<Models.MarketCurrency>;
     /**
+     * Every column is an exact-match filter and they combine with AND (?code=de-DE); each one is declared as a query parameter above. A `?column=value` this entity does not have is DROPPED rather than refused — the call answers 200 with the unfiltered list — and `filter` echoes what was actually applied, which is the only way to tell that apart from a filter that matched nothing. `market_id` is not among them: the owning market comes from the path and overwrites anything the query says. An unknown but well-formed market lists empty rather than 404 — the parent is filtered on, not verified.
      *
-     * @param {string} params.marketId -
-     * @param {number} params.limit - Page size (default 50, max 200).
-     * @param {number} params.offset - Row offset for pagination (default 0).
-     * @param {string} params.order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.id - Exact match on `id`. Primary key of this locale registration. The locale is named by `code` everywhere else.
+     * @param {string} params.code - Exact match on `code`. Locale code, language-COUNTRY — the language a storefront renders this market in, and the key a translation is stored under. Unique per market. The app's own seeded value is the tenant's `fallback_locale` setting, whose declared default is de-DE.
+     * @param {string} params.language - Exact match on `language`. ISO 639-1 language code — the language half of `code`, stored separately so a client can group markets by language without parsing.
+     * @param {string} params.country - Exact match on `country`. ISO 3166-1 alpha-2 country code — the region half of `code`. It is a spelling of the language, not a shipping destination: a market may register de-AT without trading in Austria.
+     * @param {boolean} params.isDefault - Exact match on `is_default`. The locale a storefront renders this market in when the request asks for none. At most one per market; where none carries the flag the first by position is used, and `default_locale.source` on the context says which of the two happened.
+     * @param {number} params.position - Exact match on `position`. Sort position among this market's locales, ascending, default 0 — and the tie-break that picks a default when no locale is flagged.
+     * @param {string} params.createdAt - Exact match on `created_at`. When the locale was registered on this market. Set by the database; never writable.
+     * @param {number} params.limit - Page size (default 50, max 200). Out of range is CLAMPED, not refused — ?limit=999 answers 200 with 200 rows, and `page.limit` says so.
+     * @param {number} params.offset - Row offset for pagination (default 0). A negative offset is clamped to 0 rather than refused.
+     * @param {string} params.order - Sort as 'column' | 'column.asc' | 'column.desc'. The direction is lower case, and the column has to exist: id, market_id, code, language, country, is_default, position, created_at.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketLocaleList>}
      */
     marketsLocalesList(params: {
         marketId: string;
+        id?: string;
+        code?: string;
+        language?: string;
+        country?: string;
+        isDefault?: boolean;
+        position?: number;
+        createdAt?: string;
         limit?: number;
         offset?: number;
         order?: string;
-    }): Promise<{}>;
+    }): Promise<Models.MarketLocaleList>;
     /**
+     * Every column is an exact-match filter and they combine with AND (?code=de-DE); each one is declared as a query parameter above. A `?column=value` this entity does not have is DROPPED rather than refused — the call answers 200 with the unfiltered list — and `filter` echoes what was actually applied, which is the only way to tell that apart from a filter that matched nothing. `market_id` is not among them: the owning market comes from the path and overwrites anything the query says. An unknown but well-formed market lists empty rather than 404 — the parent is filtered on, not verified.
      *
-     * @param {string} marketId -
-     * @param {number} limit - Page size (default 50, max 200).
-     * @param {number} offset - Row offset for pagination (default 0).
-     * @param {string} order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} id - Exact match on `id`. Primary key of this locale registration. The locale is named by `code` everywhere else.
+     * @param {string} code - Exact match on `code`. Locale code, language-COUNTRY — the language a storefront renders this market in, and the key a translation is stored under. Unique per market. The app's own seeded value is the tenant's `fallback_locale` setting, whose declared default is de-DE.
+     * @param {string} language - Exact match on `language`. ISO 639-1 language code — the language half of `code`, stored separately so a client can group markets by language without parsing.
+     * @param {string} country - Exact match on `country`. ISO 3166-1 alpha-2 country code — the region half of `code`. It is a spelling of the language, not a shipping destination: a market may register de-AT without trading in Austria.
+     * @param {boolean} isDefault - Exact match on `is_default`. The locale a storefront renders this market in when the request asks for none. At most one per market; where none carries the flag the first by position is used, and `default_locale.source` on the context says which of the two happened.
+     * @param {number} position - Exact match on `position`. Sort position among this market's locales, ascending, default 0 — and the tie-break that picks a default when no locale is flagged.
+     * @param {string} createdAt - Exact match on `created_at`. When the locale was registered on this market. Set by the database; never writable.
+     * @param {number} limit - Page size (default 50, max 200). Out of range is CLAMPED, not refused — ?limit=999 answers 200 with 200 rows, and `page.limit` says so.
+     * @param {number} offset - Row offset for pagination (default 0). A negative offset is clamped to 0 rather than refused.
+     * @param {string} order - Sort as 'column' | 'column.asc' | 'column.desc'. The direction is lower case, and the column has to exist: id, market_id, code, language, country, is_default, position, created_at.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketLocaleList>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    marketsLocalesList(marketId: string, limit?: number, offset?: number, order?: string): Promise<{}>;
+    marketsLocalesList(marketId: string, id?: string, code?: string, language?: string, country?: string, isDefault?: boolean, position?: number, createdAt?: string, limit?: number, offset?: number, order?: string): Promise<Models.MarketLocaleList>;
     /**
+     * The owning market comes from the path and overrides anything in the body.
      *
-     * @param {string} params.marketId -
-     * @param {string} params.code - Locale code, e.g. 'de-DE' (unique per market).
-     * @param {string} params.country - ISO 3166-1 alpha-2 country code.
-     * @param {string} params.language - ISO 639-1 language code.
-     * @param {boolean} params.isDefault -
-     * @param {number} params.position - Sort position (default 0).
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.code - Locale code, language-COUNTRY — the language a storefront renders this market in, and the key a translation is stored under. Unique per market. The app's own seeded value is the tenant's `fallback_locale` setting, whose declared default is de-DE.
+     * @param {string} params.country - ISO 3166-1 alpha-2 country code — the region half of `code`. It is a spelling of the language, not a shipping destination: a market may register de-AT without trading in Austria.
+     * @param {string} params.language - ISO 639-1 language code — the language half of `code`, stored separately so a client can group markets by language without parsing.
+     * @param {boolean} params.isDefault - The locale a storefront renders this market in when the request asks for none. At most one per market; where none carries the flag the first by position is used, and `default_locale.source` on the context says which of the two happened.
+     * @param {number} params.position - Sort position among this market's locales, ascending, default 0 — and the tie-break that picks a default when no locale is flagged.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketLocale>}
      */
     marketsLocalesCreate(params: {
@@ -387,43 +795,47 @@ declare class Markets {
         position?: number;
     }): Promise<Models.MarketLocale>;
     /**
+     * The owning market comes from the path and overrides anything in the body.
      *
-     * @param {string} marketId -
-     * @param {string} code - Locale code, e.g. 'de-DE' (unique per market).
-     * @param {string} country - ISO 3166-1 alpha-2 country code.
-     * @param {string} language - ISO 639-1 language code.
-     * @param {boolean} isDefault -
-     * @param {number} position - Sort position (default 0).
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} code - Locale code, language-COUNTRY — the language a storefront renders this market in, and the key a translation is stored under. Unique per market. The app's own seeded value is the tenant's `fallback_locale` setting, whose declared default is de-DE.
+     * @param {string} country - ISO 3166-1 alpha-2 country code — the region half of `code`. It is a spelling of the language, not a shipping destination: a market may register de-AT without trading in Austria.
+     * @param {string} language - ISO 639-1 language code — the language half of `code`, stored separately so a client can group markets by language without parsing.
+     * @param {boolean} isDefault - The locale a storefront renders this market in when the request asks for none. At most one per market; where none carries the flag the first by position is used, and `default_locale.source` on the context says which of the two happened.
+     * @param {number} position - Sort position among this market's locales, ascending, default 0 — and the tie-break that picks a default when no locale is flagged.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketLocale>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     marketsLocalesCreate(marketId: string, code: string, country: string, language: string, isDefault?: boolean, position?: number): Promise<Models.MarketLocale>;
     /**
+     * Scoped to the market in the path — a row belonging to another market is a 404 here, and is never deleted.
      *
-     * @param {string} params.marketId -
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.id - The locale of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketLocaleDeleted>}
      */
     marketsLocalesDelete(params: {
         marketId: string;
         id: string;
-    }): Promise<{}>;
+    }): Promise<Models.MarketLocaleDeleted>;
     /**
+     * Scoped to the market in the path — a row belonging to another market is a 404 here, and is never deleted.
      *
-     * @param {string} marketId -
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} id - The locale of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketLocaleDeleted>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    marketsLocalesDelete(marketId: string, id: string): Promise<{}>;
+    marketsLocalesDelete(marketId: string, id: string): Promise<Models.MarketLocaleDeleted>;
     /**
+     * Scoped strictly to the market in the path: a row belonging to another market is a 404 here, never a 200.
      *
-     * @param {string} params.marketId -
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.id - The locale of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketLocale>}
      */
     marketsLocalesGet(params: {
@@ -431,24 +843,26 @@ declare class Markets {
         id: string;
     }): Promise<Models.MarketLocale>;
     /**
+     * Scoped strictly to the market in the path: a row belonging to another market is a 404 here, never a 200.
      *
-     * @param {string} marketId -
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} id - The locale of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketLocale>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     marketsLocalesGet(marketId: string, id: string): Promise<Models.MarketLocale>;
     /**
+     * Partial: omitted fields keep their value.
      *
-     * @param {string} params.marketId -
-     * @param {string} params.id -
-     * @param {string} params.code - Locale code, e.g. 'de-DE' (unique per market).
-     * @param {string} params.country - ISO 3166-1 alpha-2 country code.
-     * @param {boolean} params.isDefault -
-     * @param {string} params.language - ISO 639-1 language code.
-     * @param {number} params.position - Sort position (default 0).
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.id - The locale of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @param {string} params.code - Locale code, language-COUNTRY — the language a storefront renders this market in, and the key a translation is stored under. Unique per market. The app's own seeded value is the tenant's `fallback_locale` setting, whose declared default is de-DE.
+     * @param {string} params.country - ISO 3166-1 alpha-2 country code — the region half of `code`. It is a spelling of the language, not a shipping destination: a market may register de-AT without trading in Austria.
+     * @param {boolean} params.isDefault - The locale a storefront renders this market in when the request asks for none. At most one per market; where none carries the flag the first by position is used, and `default_locale.source` on the context says which of the two happened.
+     * @param {string} params.language - ISO 639-1 language code — the language half of `code`, stored separately so a client can group markets by language without parsing.
+     * @param {number} params.position - Sort position among this market's locales, ascending, default 0 — and the tie-break that picks a default when no locale is flagged.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketLocale>}
      */
     marketsLocalesUpdate(params: {
@@ -461,55 +875,86 @@ declare class Markets {
         position?: number;
     }): Promise<Models.MarketLocale>;
     /**
+     * Partial: omitted fields keep their value.
      *
-     * @param {string} marketId -
-     * @param {string} id -
-     * @param {string} code - Locale code, e.g. 'de-DE' (unique per market).
-     * @param {string} country - ISO 3166-1 alpha-2 country code.
-     * @param {boolean} isDefault -
-     * @param {string} language - ISO 639-1 language code.
-     * @param {number} position - Sort position (default 0).
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} id - The locale of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @param {string} code - Locale code, language-COUNTRY — the language a storefront renders this market in, and the key a translation is stored under. Unique per market. The app's own seeded value is the tenant's `fallback_locale` setting, whose declared default is de-DE.
+     * @param {string} country - ISO 3166-1 alpha-2 country code — the region half of `code`. It is a spelling of the language, not a shipping destination: a market may register de-AT without trading in Austria.
+     * @param {boolean} isDefault - The locale a storefront renders this market in when the request asks for none. At most one per market; where none carries the flag the first by position is used, and `default_locale.source` on the context says which of the two happened.
+     * @param {string} language - ISO 639-1 language code — the language half of `code`, stored separately so a client can group markets by language without parsing.
+     * @param {number} position - Sort position among this market's locales, ascending, default 0 — and the tie-break that picks a default when no locale is flagged.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketLocale>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     marketsLocalesUpdate(marketId: string, id: string, code?: string, country?: string, isDefault?: boolean, language?: string, position?: number): Promise<Models.MarketLocale>;
     /**
+     * Every column is an exact-match filter and they combine with AND (?code=standard); each one is declared as a query parameter above. A `?column=value` this entity does not have is DROPPED rather than refused — the call answers 200 with the unfiltered list — and `filter` echoes what was actually applied, which is the only way to tell that apart from a filter that matched nothing. `market_id` is not among them: the owning market comes from the path and overwrites anything the query says. An unknown but well-formed market lists empty rather than 404 — the parent is filtered on, not verified.
      *
-     * @param {string} params.marketId -
-     * @param {number} params.limit - Page size (default 50, max 200).
-     * @param {number} params.offset - Row offset for pagination (default 0).
-     * @param {string} params.order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.id - Exact match on `id`. Primary key of this tax class. The class is named by `code` everywhere else, including by other apps.
+     * @param {string} params.code - Exact match on `code`. Tax class code, unique per market — the rate bucket a product or a shipping method is assigned to ('standard', 'reduced', 'zero'). Other apps name a class by THIS and by nothing else: there is no foreign key behind it and there cannot be (ADR-0055), which is why the delete route asks the shipping app what still points at the code before removing it.
+     * @param {string} params.name - Exact match on `name`. Display name of the rate bucket, in the operator's own language.
+     * @param {string} params.labels - Exact match on `labels`. Exact whole-document equality on the jsonb: the value is a whole JSON document and has to match every key, so this is not a path or a containment query. Key order and whitespace are irrelevant — the comparison is semantic. A value that does not parse as JSON is refused with 400 `invalid_value` rather than answered with zero rows. Localized display names for storefronts and invoices, keyed by locale: a flat {locale: label} map, one level deep, string values. The key to write is the `locale_policy.write` from GET /markets/{id}/context, exactly as for a market's labels. Null means nothing is translated and `name` is all there is.
+     * @param {number} params.rate - Exact match on `rate`. Tax rate in PERCENT, 0–100 (default 0) — 20 means 20 %, not 0.2. Whether a stored price already contains it is a separate question, answered per market by `pricing.tax_basis` on the context.
+     * @param {boolean} params.isDefault - Exact match on `is_default`. The class applied to a line that names none. At most one per market. A market that stores GROSS prices and marks no default cannot break those prices back down into net, which is why readiness turns that combination from a warning into a blocking failure.
+     * @param {number} params.position - Exact match on `position`. Sort position among this market's tax classes, ascending, default 0 — and the tie-break that picks a class when none is flagged default.
+     * @param {string} params.createdAt - Exact match on `created_at`. When the tax class was created on this market. Set by the database; never writable.
+     * @param {string} params.updatedAt - Exact match on `updated_at`. When the tax class was last written. Set by the database on every update; never writable.
+     * @param {number} params.limit - Page size (default 50, max 200). Out of range is CLAMPED, not refused — ?limit=999 answers 200 with 200 rows, and `page.limit` says so.
+     * @param {number} params.offset - Row offset for pagination (default 0). A negative offset is clamped to 0 rather than refused.
+     * @param {string} params.order - Sort as 'column' | 'column.asc' | 'column.desc'. The direction is lower case, and the column has to exist: id, market_id, code, name, labels, rate, is_default, position, created_at, updated_at.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketTaxClassList>}
      */
     marketsTaxClassesList(params: {
         marketId: string;
+        id?: string;
+        code?: string;
+        name?: string;
+        labels?: string;
+        rate?: number;
+        isDefault?: boolean;
+        position?: number;
+        createdAt?: string;
+        updatedAt?: string;
         limit?: number;
         offset?: number;
         order?: string;
-    }): Promise<{}>;
+    }): Promise<Models.MarketTaxClassList>;
     /**
+     * Every column is an exact-match filter and they combine with AND (?code=standard); each one is declared as a query parameter above. A `?column=value` this entity does not have is DROPPED rather than refused — the call answers 200 with the unfiltered list — and `filter` echoes what was actually applied, which is the only way to tell that apart from a filter that matched nothing. `market_id` is not among them: the owning market comes from the path and overwrites anything the query says. An unknown but well-formed market lists empty rather than 404 — the parent is filtered on, not verified.
      *
-     * @param {string} marketId -
-     * @param {number} limit - Page size (default 50, max 200).
-     * @param {number} offset - Row offset for pagination (default 0).
-     * @param {string} order - Sort as 'column.asc' | 'column.desc', e.g. 'created_at.desc'.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} id - Exact match on `id`. Primary key of this tax class. The class is named by `code` everywhere else, including by other apps.
+     * @param {string} code - Exact match on `code`. Tax class code, unique per market — the rate bucket a product or a shipping method is assigned to ('standard', 'reduced', 'zero'). Other apps name a class by THIS and by nothing else: there is no foreign key behind it and there cannot be (ADR-0055), which is why the delete route asks the shipping app what still points at the code before removing it.
+     * @param {string} name - Exact match on `name`. Display name of the rate bucket, in the operator's own language.
+     * @param {string} labels - Exact match on `labels`. Exact whole-document equality on the jsonb: the value is a whole JSON document and has to match every key, so this is not a path or a containment query. Key order and whitespace are irrelevant — the comparison is semantic. A value that does not parse as JSON is refused with 400 `invalid_value` rather than answered with zero rows. Localized display names for storefronts and invoices, keyed by locale: a flat {locale: label} map, one level deep, string values. The key to write is the `locale_policy.write` from GET /markets/{id}/context, exactly as for a market's labels. Null means nothing is translated and `name` is all there is.
+     * @param {number} rate - Exact match on `rate`. Tax rate in PERCENT, 0–100 (default 0) — 20 means 20 %, not 0.2. Whether a stored price already contains it is a separate question, answered per market by `pricing.tax_basis` on the context.
+     * @param {boolean} isDefault - Exact match on `is_default`. The class applied to a line that names none. At most one per market. A market that stores GROSS prices and marks no default cannot break those prices back down into net, which is why readiness turns that combination from a warning into a blocking failure.
+     * @param {number} position - Exact match on `position`. Sort position among this market's tax classes, ascending, default 0 — and the tie-break that picks a class when none is flagged default.
+     * @param {string} createdAt - Exact match on `created_at`. When the tax class was created on this market. Set by the database; never writable.
+     * @param {string} updatedAt - Exact match on `updated_at`. When the tax class was last written. Set by the database on every update; never writable.
+     * @param {number} limit - Page size (default 50, max 200). Out of range is CLAMPED, not refused — ?limit=999 answers 200 with 200 rows, and `page.limit` says so.
+     * @param {number} offset - Row offset for pagination (default 0). A negative offset is clamped to 0 rather than refused.
+     * @param {string} order - Sort as 'column' | 'column.asc' | 'column.desc'. The direction is lower case, and the column has to exist: id, market_id, code, name, labels, rate, is_default, position, created_at, updated_at.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketTaxClassList>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    marketsTaxClassesList(marketId: string, limit?: number, offset?: number, order?: string): Promise<{}>;
+    marketsTaxClassesList(marketId: string, id?: string, code?: string, name?: string, labels?: string, rate?: number, isDefault?: boolean, position?: number, createdAt?: string, updatedAt?: string, limit?: number, offset?: number, order?: string): Promise<Models.MarketTaxClassList>;
     /**
+     * The owning market comes from the path and overrides anything in the body.
      *
-     * @param {string} params.marketId -
-     * @param {string} params.code - Tax class code (unique per market).
-     * @param {string} params.name -
-     * @param {boolean} params.isDefault -
-     * @param {object} params.labels - Localized display names ({locale: label}).
-     * @param {number} params.position - Sort position (default 0).
-     * @param {number} params.rate - Tax rate in percent, 0–100 (default 0).
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.code - Tax class code, unique per market — the rate bucket a product or a shipping method is assigned to ('standard', 'reduced', 'zero'). Other apps name a class by THIS and by nothing else: there is no foreign key behind it and there cannot be (ADR-0055), which is why the delete route asks the shipping app what still points at the code before removing it.
+     * @param {string} params.name - Display name of the rate bucket, in the operator's own language.
+     * @param {boolean} params.isDefault - The class applied to a line that names none. At most one per market. A market that stores GROSS prices and marks no default cannot break those prices back down into net, which is why readiness turns that combination from a warning into a blocking failure.
+     * @param {object} params.labels - Localized display names for storefronts and invoices, keyed by locale: a flat {locale: label} map, one level deep, string values. The key to write is the `locale_policy.write` from GET /markets/{id}/context, exactly as for a market's labels. Null means nothing is translated and `name` is all there is.
+     * @param {number} params.position - Sort position among this market's tax classes, ascending, default 0 — and the tie-break that picks a class when none is flagged default.
+     * @param {number} params.rate - Tax rate in PERCENT, 0–100 (default 0) — 20 means 20 %, not 0.2. Whether a stored price already contains it is a separate question, answered per market by `pricing.tax_basis` on the context.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketTaxClass>}
      */
     marketsTaxClassesCreate(params: {
@@ -522,44 +967,48 @@ declare class Markets {
         rate?: number;
     }): Promise<Models.MarketTaxClass>;
     /**
+     * The owning market comes from the path and overrides anything in the body.
      *
-     * @param {string} marketId -
-     * @param {string} code - Tax class code (unique per market).
-     * @param {string} name -
-     * @param {boolean} isDefault -
-     * @param {object} labels - Localized display names ({locale: label}).
-     * @param {number} position - Sort position (default 0).
-     * @param {number} rate - Tax rate in percent, 0–100 (default 0).
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} code - Tax class code, unique per market — the rate bucket a product or a shipping method is assigned to ('standard', 'reduced', 'zero'). Other apps name a class by THIS and by nothing else: there is no foreign key behind it and there cannot be (ADR-0055), which is why the delete route asks the shipping app what still points at the code before removing it.
+     * @param {string} name - Display name of the rate bucket, in the operator's own language.
+     * @param {boolean} isDefault - The class applied to a line that names none. At most one per market. A market that stores GROSS prices and marks no default cannot break those prices back down into net, which is why readiness turns that combination from a warning into a blocking failure.
+     * @param {object} labels - Localized display names for storefronts and invoices, keyed by locale: a flat {locale: label} map, one level deep, string values. The key to write is the `locale_policy.write` from GET /markets/{id}/context, exactly as for a market's labels. Null means nothing is translated and `name` is all there is.
+     * @param {number} position - Sort position among this market's tax classes, ascending, default 0 — and the tie-break that picks a class when none is flagged default.
+     * @param {number} rate - Tax rate in PERCENT, 0–100 (default 0) — 20 means 20 %, not 0.2. Whether a stored price already contains it is a separate question, answered per market by `pricing.tax_basis` on the context.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketTaxClass>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     marketsTaxClassesCreate(marketId: string, code: string, name: string, isDefault?: boolean, labels?: object, position?: number, rate?: number): Promise<Models.MarketTaxClass>;
     /**
+     * Refused with a 409 for as long as another app still points at this tax class by its code. A tax class is the source of record for a rate, and other apps name it by CODE with no foreign key behind it — a cross-app FK is what ADR-0055 forbids. So this asks the shipping app what still uses the code (shipping.tax-classes.usage) and answers 409 with the count and the first few names rather than leaving methods quoting a rate nobody defines. The check FAILS OPEN: a tenant without the shipping app, or an unreachable one, deletes as before, and the answer says which happened in 'usage_checked'. Matched on the code, which is shared across markets — the refusal message says so.
      *
-     * @param {string} params.marketId -
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.id - The tax class of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketTaxClassDeleted>}
      */
     marketsTaxClassesDelete(params: {
         marketId: string;
         id: string;
-    }): Promise<{}>;
+    }): Promise<Models.MarketTaxClassDeleted>;
     /**
+     * Refused with a 409 for as long as another app still points at this tax class by its code. A tax class is the source of record for a rate, and other apps name it by CODE with no foreign key behind it — a cross-app FK is what ADR-0055 forbids. So this asks the shipping app what still uses the code (shipping.tax-classes.usage) and answers 409 with the count and the first few names rather than leaving methods quoting a rate nobody defines. The check FAILS OPEN: a tenant without the shipping app, or an unreachable one, deletes as before, and the answer says which happened in 'usage_checked'. Matched on the code, which is shared across markets — the refusal message says so.
      *
-     * @param {string} marketId -
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} id - The tax class of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.MarketTaxClassDeleted>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    marketsTaxClassesDelete(marketId: string, id: string): Promise<{}>;
+    marketsTaxClassesDelete(marketId: string, id: string): Promise<Models.MarketTaxClassDeleted>;
     /**
+     * Scoped strictly to the market in the path: a row belonging to another market is a 404 here, never a 200.
      *
-     * @param {string} params.marketId -
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.id - The tax class of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketTaxClass>}
      */
     marketsTaxClassesGet(params: {
@@ -567,25 +1016,27 @@ declare class Markets {
         id: string;
     }): Promise<Models.MarketTaxClass>;
     /**
+     * Scoped strictly to the market in the path: a row belonging to another market is a 404 here, never a 200.
      *
-     * @param {string} marketId -
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} id - The tax class of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketTaxClass>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     marketsTaxClassesGet(marketId: string, id: string): Promise<Models.MarketTaxClass>;
     /**
+     * Partial: omitted fields keep their value.
      *
-     * @param {string} params.marketId -
-     * @param {string} params.id -
-     * @param {string} params.code - Tax class code (unique per market).
-     * @param {boolean} params.isDefault -
-     * @param {object} params.labels - Localized display names ({locale: label}).
-     * @param {string} params.name -
-     * @param {number} params.position - Sort position (default 0).
-     * @param {number} params.rate - Tax rate in percent, 0–100 (default 0).
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} params.id - The tax class of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @param {string} params.code - Tax class code, unique per market — the rate bucket a product or a shipping method is assigned to ('standard', 'reduced', 'zero'). Other apps name a class by THIS and by nothing else: there is no foreign key behind it and there cannot be (ADR-0055), which is why the delete route asks the shipping app what still points at the code before removing it.
+     * @param {boolean} params.isDefault - The class applied to a line that names none. At most one per market. A market that stores GROSS prices and marks no default cannot break those prices back down into net, which is why readiness turns that combination from a warning into a blocking failure.
+     * @param {object} params.labels - Localized display names for storefronts and invoices, keyed by locale: a flat {locale: label} map, one level deep, string values. The key to write is the `locale_policy.write` from GET /markets/{id}/context, exactly as for a market's labels. Null means nothing is translated and `name` is all there is.
+     * @param {string} params.name - Display name of the rate bucket, in the operator's own language.
+     * @param {number} params.position - Sort position among this market's tax classes, ascending, default 0 — and the tie-break that picks a class when none is flagged default.
+     * @param {number} params.rate - Tax rate in PERCENT, 0–100 (default 0) — 20 means 20 %, not 0.2. Whether a stored price already contains it is a separate question, answered per market by `pricing.tax_basis` on the context.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketTaxClass>}
      */
     marketsTaxClassesUpdate(params: {
@@ -599,16 +1050,17 @@ declare class Markets {
         rate?: number;
     }): Promise<Models.MarketTaxClass>;
     /**
+     * Partial: omitted fields keep their value.
      *
-     * @param {string} marketId -
-     * @param {string} id -
-     * @param {string} code - Tax class code (unique per market).
-     * @param {boolean} isDefault -
-     * @param {object} labels - Localized display names ({locale: label}).
-     * @param {string} name -
-     * @param {number} position - Sort position (default 0).
-     * @param {number} rate - Tax rate in percent, 0–100 (default 0).
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} marketId - The owning market. A uuid — this route does not accept a market code. An unknown market lists empty rather than 404.
+     * @param {string} id - The tax class of a market, by its primary key. A uuid — this route does not resolve a code, so a segment that will not cast is a 400 before any row is read.
+     * @param {string} code - Tax class code, unique per market — the rate bucket a product or a shipping method is assigned to ('standard', 'reduced', 'zero'). Other apps name a class by THIS and by nothing else: there is no foreign key behind it and there cannot be (ADR-0055), which is why the delete route asks the shipping app what still points at the code before removing it.
+     * @param {boolean} isDefault - The class applied to a line that names none. At most one per market. A market that stores GROSS prices and marks no default cannot break those prices back down into net, which is why readiness turns that combination from a warning into a blocking failure.
+     * @param {object} labels - Localized display names for storefronts and invoices, keyed by locale: a flat {locale: label} map, one level deep, string values. The key to write is the `locale_policy.write` from GET /markets/{id}/context, exactly as for a market's labels. Null means nothing is translated and `name` is all there is.
+     * @param {string} name - Display name of the rate bucket, in the operator's own language.
+     * @param {number} position - Sort position among this market's tax classes, ascending, default 0 — and the tie-break that picks a class when none is flagged default.
+     * @param {number} rate - Tax rate in PERCENT, 0–100 (default 0) — 20 means 20 %, not 0.2. Whether a stored price already contains it is a separate question, answered per market by `pricing.tax_basis` on the context.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.MarketTaxClass>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */