@revenexx/node 0.0.2 → 0.1.1

package/dist/services/carts.d.ts

@@ -1,32 +1,204 @@
 import { Client } from '../client.js';
 import { Models } from '../models.js';
-import { CartIoDirection } from '../enums/cart-io-direction.js';
-import { CartIoApplyMode } from '../enums/cart-io-apply-mode.js';
-import { CartIoEntity } from '../enums/cart-io-entity.js';
-import { CartIoFormat } from '../enums/cart-io-format.js';
-import { CartItemType } from '../enums/cart-item-type.js';
-import { CartExportFormat } from '../enums/cart-export-format.js';
+import { CartStatus } from '../enums/cart-status.js';
+import { CartMergeStrategy } from '../enums/cart-merge-strategy.js';
+import { Name } from '../enums/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-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/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-status.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-name.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,54 +240,95 @@ 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 Carts {
     client: Client;
     constructor(client: Client);
     /**
-     *
-     * @param {string} params.contactId - Filter to one owning contact.
-     * @param {string} params.sessionKey - Filter to one guest session.
-     * @param {string} params.status - Filter by cart status (e.g. active).
+     * The cart index, and the route a storefront resumes a session with: `?contact_id=…` for a customer's carts, `?session_key=…` for a guest's, and `?is_current=true` alongside one of those two for the single cart carts.activate last marked — this list is the ONLY place that flag can be read back, and on its own the filter selects every current cart in the tenant. Filters are exact equality and never a search, unknown keys are dropped rather than refused, and `filter` echoes what was understood. Each row carries its own stored totals — `item_count` is the sum of the line QUANTITIES, not the number of lines — but never its lines: those are one call per cart. With no filter at all this is every cart the tenant holds, paged, which is a report rather than a session lookup.
+     *
+     * @param {string} params.id - One cart, in list form — the same row carts.get answers, but inside the page envelope.
+     * @param {string} params.name - Exact name, not a search: 'Weekly' does not find 'Weekly order'. Useful with contact_id, to resume a named cart a buyer keeps.
+     * @param {CartStatus} params.status - By lifecycle status — the abandoned queue, the ordered ones, the merged trail.
+     * @param {string} params.contactId - Every cart of one customer. With multi_cart_enabled this is a list, not a row.
+     * @param {string} params.sessionKey - Every cart of one guest session — what a storefront asks for before anybody logs in, and what carts.claim then hands over.
+     * @param {string} params.channelId - Carts opened in one sales channel.
+     * @param {string} params.currency - Carts priced in one currency.
+     * @param {boolean} params.isCurrent - The owner's current cart — the flag carts.activate sets, and the only way to read what it wrote. Pair it with contact_id or session_key; on its own it selects every current cart in the tenant.
+     * @param {number} params.itemCount - Exact total quantity. `?item_count=0` is the one that earns its place: the empty carts.
+     * @param {number} params.subtotal - Exact subtotal. Equality only — there is no range form on this route, so this finds `0` and little else.
+     * @param {string} params.abandonedAt - Exact instant, not a range. Of little use on its own; `status=abandoned` is the question people actually have.
+     * @param {string} params.orderedAt - Exact instant, not a range. `status=ordered` is usually the question.
+     * @param {string} params.orderRef - The cart behind an order number — the join order management and support both need.
+     * @param {string} params.mergedIntoCartId - Every cart that was merged INTO this one: the other half of the trail, and the answer to "what did this cart absorb".
+     * @param {string} params.createdAt - Exact instant, not a range: this matches a timestamp to the microsecond, so it is for reproducing a row, not for reporting on a day.
+     * @param {string} params.updatedAt - Exact instant, not a range. Idleness is the sweep's business, not a filter's.
      * @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}
+     * @param {string} params.order - Sort by one column: 'column' | 'column.asc' | 'column.desc'. A bare column sorts ascending. Anything else is refused with 400.
+     * @throws {RevenexxException}
      * @returns {Promise<{}>}
      */
     cartsList(params?: {
+        id?: string;
+        name?: string;
+        status?: CartStatus;
         contactId?: string;
         sessionKey?: string;
-        status?: string;
+        channelId?: string;
+        currency?: string;
+        isCurrent?: boolean;
+        itemCount?: number;
+        subtotal?: number;
+        abandonedAt?: string;
+        orderedAt?: string;
+        orderRef?: string;
+        mergedIntoCartId?: string;
+        createdAt?: string;
+        updatedAt?: string;
         limit?: number;
         offset?: number;
         order?: string;
     }): Promise<{}>;
     /**
-     *
-     * @param {string} contactId - Filter to one owning contact.
-     * @param {string} sessionKey - Filter to one guest session.
-     * @param {string} status - Filter by cart status (e.g. active).
+     * The cart index, and the route a storefront resumes a session with: `?contact_id=…` for a customer's carts, `?session_key=…` for a guest's, and `?is_current=true` alongside one of those two for the single cart carts.activate last marked — this list is the ONLY place that flag can be read back, and on its own the filter selects every current cart in the tenant. Filters are exact equality and never a search, unknown keys are dropped rather than refused, and `filter` echoes what was understood. Each row carries its own stored totals — `item_count` is the sum of the line QUANTITIES, not the number of lines — but never its lines: those are one call per cart. With no filter at all this is every cart the tenant holds, paged, which is a report rather than a session lookup.
+     *
+     * @param {string} id - One cart, in list form — the same row carts.get answers, but inside the page envelope.
+     * @param {string} name - Exact name, not a search: 'Weekly' does not find 'Weekly order'. Useful with contact_id, to resume a named cart a buyer keeps.
+     * @param {CartStatus} status - By lifecycle status — the abandoned queue, the ordered ones, the merged trail.
+     * @param {string} contactId - Every cart of one customer. With multi_cart_enabled this is a list, not a row.
+     * @param {string} sessionKey - Every cart of one guest session — what a storefront asks for before anybody logs in, and what carts.claim then hands over.
+     * @param {string} channelId - Carts opened in one sales channel.
+     * @param {string} currency - Carts priced in one currency.
+     * @param {boolean} isCurrent - The owner's current cart — the flag carts.activate sets, and the only way to read what it wrote. Pair it with contact_id or session_key; on its own it selects every current cart in the tenant.
+     * @param {number} itemCount - Exact total quantity. `?item_count=0` is the one that earns its place: the empty carts.
+     * @param {number} subtotal - Exact subtotal. Equality only — there is no range form on this route, so this finds `0` and little else.
+     * @param {string} abandonedAt - Exact instant, not a range. Of little use on its own; `status=abandoned` is the question people actually have.
+     * @param {string} orderedAt - Exact instant, not a range. `status=ordered` is usually the question.
+     * @param {string} orderRef - The cart behind an order number — the join order management and support both need.
+     * @param {string} mergedIntoCartId - Every cart that was merged INTO this one: the other half of the trail, and the answer to "what did this cart absorb".
+     * @param {string} createdAt - Exact instant, not a range: this matches a timestamp to the microsecond, so it is for reproducing a row, not for reporting on a day.
+     * @param {string} updatedAt - Exact instant, not a range. Idleness is the sweep's business, not a filter's.
      * @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}
+     * @param {string} order - Sort by one column: 'column' | 'column.asc' | 'column.desc'. A bare column sorts ascending. Anything else is refused with 400.
+     * @throws {RevenexxException}
      * @returns {Promise<{}>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    cartsList(contactId?: string, sessionKey?: string, status?: string, limit?: number, offset?: number, order?: string): Promise<{}>;
+    cartsList(id?: string, name?: string, status?: CartStatus, contactId?: string, sessionKey?: string, channelId?: string, currency?: string, isCurrent?: boolean, itemCount?: number, subtotal?: number, abandonedAt?: string, orderedAt?: string, orderRef?: string, mergedIntoCartId?: string, createdAt?: string, updatedAt?: string, limit?: number, offset?: number, order?: string): Promise<{}>;
     /**
+     * Opens an empty cart. The one thing it requires is an OWNER — `contact_id` for a signed-in customer or `session_key` for a guest, never neither: that is a database check on the table, and this route refuses it first with a 400 so the caller gets a sentence rather than a constraint name. Everything else is defaulted: the name 'Cart', currency EUR, status 'active', both totals 0. No column of a cart is unique, so one owner may hold as many carts as they like — unless the tenant's `multi_cart_enabled` is off, in which case a second ACTIVE cart for the same owner answers 409 naming the cart that already exists, because a storefront that hit that wants to fill THAT cart. Send `is_current: true` to have the new cart made current in the same call, which clears the flag on every sibling of the same owner. Lines are added afterwards, one call each or one bulk replace.
      *
-     * @param {string} params.channelId -
-     * @param {string} params.contactId - Owning customer contact.
-     * @param {string} params.currency - ISO 4217 code (default EUR).
-     * @param {boolean} params.isCurrent - Make this THE current cart of its owner.
-     * @param {string} params.marketId -
-     * @param {object} params.metadata - Free-form metadata.
-     * @param {string} params.name - Display name (default 'Cart').
-     * @param {string} params.sessionKey - Owning guest session.
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.channelId - The sales channel this cart is being opened in, as a channel of the channels app. Stored for attribution; nothing in this app reads it.
+     * @param {string} params.contactId - The customer who owns this cart, as a contact of the customers app. Send this OR session_key — a cart with neither owner is refused.
+     * @param {string} params.currency - ISO 4217 code the cart is priced in (default EUR). Lines added without a currency inherit it.
+     * @param {boolean} params.isCurrent - Make this THE current cart of its owner as it is created — the same thing carts.activate does later, and it clears the flag on every sibling cart of the same owner.
+     * @param {object} params.metadata - Free-form data the storefront hangs on the cart. Stored and returned verbatim; no key in here is read by this app, and none is indexed.
+     * @param {string} params.name - What the buyer calls this cart (default 'Cart'). An empty string is legal and lands on the default.
+     * @param {string} params.sessionKey - The guest session that owns this cart — the key the storefront already keeps in its own session or cookie. Any non-empty string is accepted; this app issues none and parses none, so the example shows a shape and not a format. Send this OR contact_id.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Cart>}
      */
     cartsCreate(params?: {
@@ -123,577 +336,286 @@ declare class Carts {
         contactId?: string;
         currency?: string;
         isCurrent?: boolean;
-        marketId?: string;
         metadata?: object;
         name?: string;
         sessionKey?: string;
     }): Promise<Models.Cart>;
     /**
+     * Opens an empty cart. The one thing it requires is an OWNER — `contact_id` for a signed-in customer or `session_key` for a guest, never neither: that is a database check on the table, and this route refuses it first with a 400 so the caller gets a sentence rather than a constraint name. Everything else is defaulted: the name 'Cart', currency EUR, status 'active', both totals 0. No column of a cart is unique, so one owner may hold as many carts as they like — unless the tenant's `multi_cart_enabled` is off, in which case a second ACTIVE cart for the same owner answers 409 naming the cart that already exists, because a storefront that hit that wants to fill THAT cart. Send `is_current: true` to have the new cart made current in the same call, which clears the flag on every sibling of the same owner. Lines are added afterwards, one call each or one bulk replace.
      *
-     * @param {string} channelId -
-     * @param {string} contactId - Owning customer contact.
-     * @param {string} currency - ISO 4217 code (default EUR).
-     * @param {boolean} isCurrent - Make this THE current cart of its owner.
-     * @param {string} marketId -
-     * @param {object} metadata - Free-form metadata.
-     * @param {string} name - Display name (default 'Cart').
-     * @param {string} sessionKey - Owning guest session.
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} channelId - The sales channel this cart is being opened in, as a channel of the channels app. Stored for attribution; nothing in this app reads it.
+     * @param {string} contactId - The customer who owns this cart, as a contact of the customers app. Send this OR session_key — a cart with neither owner is refused.
+     * @param {string} currency - ISO 4217 code the cart is priced in (default EUR). Lines added without a currency inherit it.
+     * @param {boolean} isCurrent - Make this THE current cart of its owner as it is created — the same thing carts.activate does later, and it clears the flag on every sibling cart of the same owner.
+     * @param {object} metadata - Free-form data the storefront hangs on the cart. Stored and returned verbatim; no key in here is read by this app, and none is indexed.
+     * @param {string} name - What the buyer calls this cart (default 'Cart'). An empty string is legal and lands on the default.
+     * @param {string} sessionKey - The guest session that owns this cart — the key the storefront already keeps in its own session or cookie. Any non-empty string is accepted; this app issues none and parses none, so the example shows a shape and not a format. Send this OR contact_id.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Cart>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    cartsCreate(channelId?: string, contactId?: string, currency?: string, isCurrent?: boolean, marketId?: string, metadata?: object, name?: string, sessionKey?: string): Promise<Models.Cart>;
+    cartsCreate(channelId?: string, contactId?: string, currency?: string, isCurrent?: boolean, metadata?: object, name?: string, sessionKey?: string): Promise<Models.Cart>;
     /**
+     * The login call, and the one route that turns a guest into a customer: every ACTIVE cart of one session_key is handed to a contact_id, which is what a storefront fires the moment somebody signs in with a basket already filled. There are two ways it can land, and the body picks between them. Without a target_cart_id the session carts are ADOPTED as they stand — same carts, same lines, contact_id set and session_key cleared, nothing copied and nothing closed. With a target_cart_id they are instead folded into that cart, which survives while each session cart is closed as status merged; 'adopted' and 'merged' in the answer say which of the two happened to each one. With a target cart, cart_merge_strategy decides what happens to the target's OWN lines: 'merge' keeps them and folds the session lines in, 'replace' clears them first. 'strategy' overrides it for one call (merge | replace); the answer always echoes which one ran and how many lines a replace removed.
      *
-     * @param {string} params.contactId - Contact taking ownership.
-     * @param {string} params.sessionKey - Guest session whose active carts are handed over.
+     * @param {string} params.contactId - The contact taking ownership. Every active cart of that session ends up with this contact — adopted as it stands, or folded into `target_cart_id`.
+     * @param {string} params.sessionKey - The guest session whose active carts are handed over — the key the storefront keeps in its own session or cookie and has been sending on every anonymous call. This app neither issues nor parses it, so the example shows the shape of an opaque token and not a format anything enforces.
+     * @param {CartMergeStrategy} params.strategy - Override the tenant's cart_merge_strategy for this call: 'merge' keeps the target cart's own lines, 'replace' clears them first. Omit to use the setting.
      * @param {string} params.targetCartId - Merge the session carts into this cart instead of adopting them.
-     * @throws {RevenexxAPIRevenexxException}
+     * @throws {RevenexxException}
      * @returns {Promise<{}>}
      */
     cartsClaim(params: {
         contactId: string;
         sessionKey: string;
+        strategy?: CartMergeStrategy;
         targetCartId?: string;
     }): Promise<{}>;
     /**
+     * The login call, and the one route that turns a guest into a customer: every ACTIVE cart of one session_key is handed to a contact_id, which is what a storefront fires the moment somebody signs in with a basket already filled. There are two ways it can land, and the body picks between them. Without a target_cart_id the session carts are ADOPTED as they stand — same carts, same lines, contact_id set and session_key cleared, nothing copied and nothing closed. With a target_cart_id they are instead folded into that cart, which survives while each session cart is closed as status merged; 'adopted' and 'merged' in the answer say which of the two happened to each one. With a target cart, cart_merge_strategy decides what happens to the target's OWN lines: 'merge' keeps them and folds the session lines in, 'replace' clears them first. 'strategy' overrides it for one call (merge | replace); the answer always echoes which one ran and how many lines a replace removed.
      *
-     * @param {string} contactId - Contact taking ownership.
-     * @param {string} sessionKey - Guest session whose active carts are handed over.
+     * @param {string} contactId - The contact taking ownership. Every active cart of that session ends up with this contact — adopted as it stands, or folded into `target_cart_id`.
+     * @param {string} sessionKey - The guest session whose active carts are handed over — the key the storefront keeps in its own session or cookie and has been sending on every anonymous call. This app neither issues nor parses it, so the example shows the shape of an opaque token and not a format anything enforces.
+     * @param {CartMergeStrategy} strategy - Override the tenant's cart_merge_strategy for this call: 'merge' keeps the target cart's own lines, 'replace' clears them first. Omit to use the setting.
      * @param {string} targetCartId - Merge the session carts into this cart instead of adopting them.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
-     * @deprecated Use the object parameter style method for a better developer experience.
-     */
-    cartsClaim(contactId: string, sessionKey: string, targetCartId?: string): Promise<{}>;
-    /**
-     *
-     * @param {string} params.contactId - Owner of a newly created cart.
-     * @param {string} params.csv - Raw CSV content (alternative to payload for csv profiles).
-     * @param {string} params.name - Name for a newly created cart.
-     * @param {object} params.payload - The import payload: '{cart, items}' object, or a raw JSON/CSV string in the profile's format.
-     * @param {string} params.profileId - Import profile to run; ad-hoc import when omitted.
-     * @param {string} params.sessionKey - Guest owner of a newly created cart.
-     * @param {string} params.targetCartId - Existing active cart to import into.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
-     */
-    cartsImport(params?: {
-        contactId?: string;
-        csv?: string;
-        name?: string;
-        payload?: object;
-        profileId?: string;
-        sessionKey?: string;
-        targetCartId?: string;
-    }): Promise<{}>;
-    /**
-     *
-     * @param {string} contactId - Owner of a newly created cart.
-     * @param {string} csv - Raw CSV content (alternative to payload for csv profiles).
-     * @param {string} name - Name for a newly created cart.
-     * @param {object} payload - The import payload: '{cart, items}' object, or a raw JSON/CSV string in the profile's format.
-     * @param {string} profileId - Import profile to run; ad-hoc import when omitted.
-     * @param {string} sessionKey - Guest owner of a newly created cart.
-     * @param {string} targetCartId - Existing active cart to import into.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
-     * @deprecated Use the object parameter style method for a better developer experience.
-     */
-    cartsImport(contactId?: string, csv?: string, name?: string, payload?: object, profileId?: string, sessionKey?: string, targetCartId?: string): Promise<{}>;
-    /**
-     *
-     * @throws {RevenexxAPIRevenexxException}
+     * @throws {RevenexxException}
      * @returns {Promise<{}>}
-     */
-    cartsIoProfilesList(): Promise<{}>;
-    /**
-     *
-     * @param {CartIoDirection} params.direction -
-     * @param {string} params.name -
-     * @param {CartIoApplyMode} params.applyMode - Default 'insert'.
-     * @param {CartIoEntity} params.entity - Default 'carts'.
-     * @param {CartIoFormat} params.format - Default 'json'.
-     * @param {boolean} params.isTemplate -
-     * @param {object} params.mapping - Column mapping (Baseline-IO-compatible).
-     * @param {object} params.options -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.IoProfile>}
-     */
-    cartsIoProfilesCreate(params: {
-        direction: CartIoDirection;
-        name: string;
-        applyMode?: CartIoApplyMode;
-        entity?: CartIoEntity;
-        format?: CartIoFormat;
-        isTemplate?: boolean;
-        mapping?: object;
-        options?: object;
-    }): Promise<Models.IoProfile>;
-    /**
-     *
-     * @param {CartIoDirection} direction -
-     * @param {string} name -
-     * @param {CartIoApplyMode} applyMode - Default 'insert'.
-     * @param {CartIoEntity} entity - Default 'carts'.
-     * @param {CartIoFormat} format - Default 'json'.
-     * @param {boolean} isTemplate -
-     * @param {object} mapping - Column mapping (Baseline-IO-compatible).
-     * @param {object} options -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.IoProfile>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    cartsIoProfilesCreate(direction: CartIoDirection, name: string, applyMode?: CartIoApplyMode, entity?: CartIoEntity, format?: CartIoFormat, isTemplate?: boolean, mapping?: object, options?: object): Promise<Models.IoProfile>;
-    /**
-     *
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
-     */
-    cartsIoProfilesDefaults(): Promise<{}>;
+    cartsClaim(contactId: string, sessionKey: string, strategy?: CartMergeStrategy, targetCartId?: string): Promise<{}>;
     /**
+     * Two sweeps in one pass. abandon_after_minutes marks active carts that have sat untouched past the window as abandoned (stamping abandoned_at, which nothing else in the platform ever sets — without this the abandonment funnel is empty by construction, not empty because nobody abandons carts). cart_ttl_days / guest_cart_ttl_days then DELETE carts past their retention window, line items included; both default to 0 (never), and an 'ordered' cart is never touched at any setting because it is the source record of a sale. Send dry_run to get the same counts and cart ids while writing nothing. The platform runs this per installed tenant on the schedule; it is idempotent, so calling it by hand between ticks is safe.
      *
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {boolean} params.dryRun - Report what the sweep WOULD do and write nothing. Worth doing before a first retention run: cart_ttl_days deletes carts and their lines.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CartMaintenanceResult>}
      */
-    cartsIoProfilesDelete(params: {
-        id: string;
-    }): Promise<{}>;
+    cartsMaintenanceRun(params?: {
+        dryRun?: boolean;
+    }): Promise<Models.CartMaintenanceResult>;
     /**
+     * Two sweeps in one pass. abandon_after_minutes marks active carts that have sat untouched past the window as abandoned (stamping abandoned_at, which nothing else in the platform ever sets — without this the abandonment funnel is empty by construction, not empty because nobody abandons carts). cart_ttl_days / guest_cart_ttl_days then DELETE carts past their retention window, line items included; both default to 0 (never), and an 'ordered' cart is never touched at any setting because it is the source record of a sale. Send dry_run to get the same counts and cart ids while writing nothing. The platform runs this per installed tenant on the schedule; it is idempotent, so calling it by hand between ticks is safe.
      *
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {boolean} dryRun - Report what the sweep WOULD do and write nothing. Worth doing before a first retention run: cart_ttl_days deletes carts and their lines.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CartMaintenanceResult>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    cartsIoProfilesDelete(id: string): Promise<{}>;
+    cartsMaintenanceRun(dryRun?: boolean): Promise<Models.CartMaintenanceResult>;
     /**
+     * Which of the two carts survives is the whole question, and the answer is the TARGET: the source's lines are COPIED into the target, the target keeps every line it already had, its totals are recomputed, and it is the cart the caller goes on using. Nothing is replaced and nothing is moved — the source keeps its own line rows and is closed with status 'merged' and `merged_into_cart_id` pointing at the target, so a merged cart stays readable as the record of what went where. On the way in, a plain product line with the same product/sku AND the same `unit_price` as a line already in the target adds its quantity to that line; configured and custom lines always land as new ones. Both carts must be active and must differ, and the tenant's line limits are enforced on the target as the copies land (422). Reach for carts.merge_into where the caller holds one cart id and not two.
      *
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.IoProfile>}
-     */
-    cartsIoProfilesGet(params: {
-        id: string;
-    }): Promise<Models.IoProfile>;
-    /**
-     *
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.IoProfile>}
-     * @deprecated Use the object parameter style method for a better developer experience.
-     */
-    cartsIoProfilesGet(id: string): Promise<Models.IoProfile>;
-    /**
-     *
-     * @param {string} params.id -
-     * @param {CartIoApplyMode} params.applyMode - Default 'insert'.
-     * @param {CartIoDirection} params.direction -
-     * @param {CartIoEntity} params.entity - Default 'carts'.
-     * @param {CartIoFormat} params.format - Default 'json'.
-     * @param {boolean} params.isTemplate -
-     * @param {object} params.mapping - Column mapping (Baseline-IO-compatible).
-     * @param {string} params.name -
-     * @param {object} params.options -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.IoProfile>}
-     */
-    cartsIoProfilesUpdate(params: {
-        id: string;
-        applyMode?: CartIoApplyMode;
-        direction?: CartIoDirection;
-        entity?: CartIoEntity;
-        format?: CartIoFormat;
-        isTemplate?: boolean;
-        mapping?: object;
-        name?: string;
-        options?: object;
-    }): Promise<Models.IoProfile>;
-    /**
-     *
-     * @param {string} id -
-     * @param {CartIoApplyMode} applyMode - Default 'insert'.
-     * @param {CartIoDirection} direction -
-     * @param {CartIoEntity} entity - Default 'carts'.
-     * @param {CartIoFormat} format - Default 'json'.
-     * @param {boolean} isTemplate -
-     * @param {object} mapping - Column mapping (Baseline-IO-compatible).
-     * @param {string} name -
-     * @param {object} options -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.IoProfile>}
-     * @deprecated Use the object parameter style method for a better developer experience.
-     */
-    cartsIoProfilesUpdate(id: string, applyMode?: CartIoApplyMode, direction?: CartIoDirection, entity?: CartIoEntity, format?: CartIoFormat, isTemplate?: boolean, mapping?: object, name?: string, options?: object): Promise<Models.IoProfile>;
-    /**
-     *
-     * @param {string} params.sourceCartId - Cart whose lines move into the target (becomes status merged).
-     * @param {string} params.targetCartId - Receiving cart (must be active).
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} params.sourceCartId - The cart being folded in. It must be active, and it does NOT survive as a workspace: its lines are copied into the target, it becomes status merged, and merged_into_cart_id points at the target. Its own lines stay on it as the record of what was moved.
+     * @param {string} params.targetCartId - The cart that SURVIVES. Must be active; it gains the source's lines (identical product lines at the same price adding up) and its totals are recomputed.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CartMergeResult>}
      */
     cartsMerge(params: {
         sourceCartId: string;
         targetCartId: string;
-    }): Promise<{}>;
+    }): Promise<Models.CartMergeResult>;
     /**
+     * Which of the two carts survives is the whole question, and the answer is the TARGET: the source's lines are COPIED into the target, the target keeps every line it already had, its totals are recomputed, and it is the cart the caller goes on using. Nothing is replaced and nothing is moved — the source keeps its own line rows and is closed with status 'merged' and `merged_into_cart_id` pointing at the target, so a merged cart stays readable as the record of what went where. On the way in, a plain product line with the same product/sku AND the same `unit_price` as a line already in the target adds its quantity to that line; configured and custom lines always land as new ones. Both carts must be active and must differ, and the tenant's line limits are enforced on the target as the copies land (422). Reach for carts.merge_into where the caller holds one cart id and not two.
      *
-     * @param {string} sourceCartId - Cart whose lines move into the target (becomes status merged).
-     * @param {string} targetCartId - Receiving cart (must be active).
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} sourceCartId - The cart being folded in. It must be active, and it does NOT survive as a workspace: its lines are copied into the target, it becomes status merged, and merged_into_cart_id points at the target. Its own lines stay on it as the record of what was moved.
+     * @param {string} targetCartId - The cart that SURVIVES. Must be active; it gains the source's lines (identical product lines at the same price adding up) and its totals are recomputed.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CartMergeResult>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    cartsMerge(sourceCartId: string, targetCartId: string): Promise<{}>;
-    /**
-     *
-     * @param {string} params.cartId -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
-     */
-    cartsItemsList(params: {
-        cartId: string;
-    }): Promise<{}>;
+    cartsMerge(sourceCartId: string, targetCartId: string): Promise<Models.CartMergeResult>;
     /**
+     * Discovery for the vocabulary routes: every enum this app publishes, each as its name, its title and its description and nothing else. The VALUES are deliberately not here — this is the index a client builds a menu from, and one call per vocabulary fills it. Names: io-apply-modes, io-directions, io-entities, io-formats, item-types, statuses. Fetch one with GET /carts/vocabularies/{name}; a client holding the qualified pair 'carts.<name>' builds that URL from the pair alone.
      *
-     * @param {string} cartId -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
-     * @deprecated Use the object parameter style method for a better developer experience.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CartVocabularyIndex>}
      */
-    cartsItemsList(cartId: string): Promise<{}>;
+    cartsVocabulariesList(): Promise<Models.CartVocabularyIndex>;
     /**
+     * One vocabulary with its values filled in — every value permitted by the column behind it, each carrying the key the database stores, a human title, a description where one was written and the badge tone a UI should render it in, which is everything a select or a status chip needs from one call. The values are read out of the column's CHECK constraint, so the served set IS the enforced set and the two cannot drift — a value added to the constraint appears here even before anyone labels it, titled from its own key. Values come back in constraint order, which is the order a select should offer. 'closed' says the set is exhaustive, so a value outside it is stale data rather than a missing label. Names: io-apply-modes, io-directions, io-entities, io-formats, item-types, statuses.
      *
-     * @param {string} params.cartId -
-     * @param {object} params.configuration - Free-form configuration — configured lines never merge.
-     * @param {string} params.currency - Defaults to the cart's currency.
-     * @param {object} params.metadata - Free-form metadata.
-     * @param {string} params.name - Falls back to 'sku' when omitted.
-     * @param {number} params.position -
-     * @param {string} params.productId -
-     * @param {number} params.quantity - Default 1.
-     * @param {string} params.sku -
-     * @param {object} params.snapshot - Loose product snapshot at add-time (price, name, image, …).
-     * @param {number} params.taxRate -
-     * @param {CartItemType} params.type - Line type (default 'product'). Plain product lines merge by product+price; configurations always stand alone.
-     * @param {string} params.unit -
-     * @param {number} params.unitPrice - Per-unit net price — line_total is always derived.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.CartItem>}
+     * @param {Name} params.name - The vocabulary name — the part after the dot in the qualified id.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CartVocabulary>}
      */
-    cartsItemsCreate(params: {
-        cartId: string;
-        configuration?: object;
-        currency?: string;
-        metadata?: object;
-        name?: string;
-        position?: number;
-        productId?: string;
-        quantity?: number;
-        sku?: string;
-        snapshot?: object;
-        taxRate?: number;
-        type?: CartItemType;
-        unit?: string;
-        unitPrice?: number;
-    }): Promise<Models.CartItem>;
+    cartsVocabulariesGet(params: {
+        name: Name;
+    }): Promise<Models.CartVocabulary>;
     /**
+     * One vocabulary with its values filled in — every value permitted by the column behind it, each carrying the key the database stores, a human title, a description where one was written and the badge tone a UI should render it in, which is everything a select or a status chip needs from one call. The values are read out of the column's CHECK constraint, so the served set IS the enforced set and the two cannot drift — a value added to the constraint appears here even before anyone labels it, titled from its own key. Values come back in constraint order, which is the order a select should offer. 'closed' says the set is exhaustive, so a value outside it is stale data rather than a missing label. Names: io-apply-modes, io-directions, io-entities, io-formats, item-types, statuses.
      *
-     * @param {string} cartId -
-     * @param {object} configuration - Free-form configuration — configured lines never merge.
-     * @param {string} currency - Defaults to the cart's currency.
-     * @param {object} metadata - Free-form metadata.
-     * @param {string} name - Falls back to 'sku' when omitted.
-     * @param {number} position -
-     * @param {string} productId -
-     * @param {number} quantity - Default 1.
-     * @param {string} sku -
-     * @param {object} snapshot - Loose product snapshot at add-time (price, name, image, …).
-     * @param {number} taxRate -
-     * @param {CartItemType} type - Line type (default 'product'). Plain product lines merge by product+price; configurations always stand alone.
-     * @param {string} unit -
-     * @param {number} unitPrice - Per-unit net price — line_total is always derived.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.CartItem>}
+     * @param {Name} name - The vocabulary name — the part after the dot in the qualified id.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CartVocabulary>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    cartsItemsCreate(cartId: string, configuration?: object, currency?: string, metadata?: object, name?: string, position?: number, productId?: string, quantity?: number, sku?: string, snapshot?: object, taxRate?: number, type?: CartItemType, unit?: string, unitPrice?: number): Promise<Models.CartItem>;
+    cartsVocabulariesGet(name: Name): Promise<Models.CartVocabulary>;
     /**
+     * Removes the cart row and, through the `on delete cascade` on `cart_items.cart_id`, every line in it. There is no soft delete and no undo. One status is protected and it is protected permanently: an 'ordered' cart is the source record of a sale — the order carries its id in `cart_id` and the order.placed event records it — so this route refuses it with 400 and there is no flag, no force and no lifecycle route that makes it deletable. Do not go looking for one. 'active', 'abandoned' and 'merged' are all deletable, which is deliberate and is the same set the cart-maintenance sweep removes on a retention window: clearing out abandoned guest carts is the main thing anyone deletes a cart for, and a merged cart's lines were COPIED into the target, which still holds them. What the delete does NOT take with it is the trail: `merged_into_cart_id` is a plain uuid column and not a foreign key, so deleting a cart that other carts were merged INTO leaves those carts pointing at a row that no longer exists, and nothing refuses the delete or clears the pointer — the retention sweep does the same, so this is a property of the column and not of this route. For a cart a buyer simply walked away from, carts.abandon keeps the row and the funnel; for deleting on a retention window, the cart-maintenance sweep does it per market and can be asked first with `dry_run`.
      *
-     * @param {string} params.cartId -
-     * @param {Models.CartItemCreateRequest[]} params.items - The complete new item set (set semantics).
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
-     */
-    cartsItemsReplace(params: {
-        cartId: string;
-        items: Models.CartItemCreateRequest[];
-    }): Promise<{}>;
-    /**
-     *
-     * @param {string} cartId -
-     * @param {Models.CartItemCreateRequest[]} items - The complete new item set (set semantics).
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
-     * @deprecated Use the object parameter style method for a better developer experience.
-     */
-    cartsItemsReplace(cartId: string, items: Models.CartItemCreateRequest[]): Promise<{}>;
-    /**
-     *
-     * @param {string} params.cartId -
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
-     */
-    cartsItemsDelete(params: {
-        cartId: string;
-        id: string;
-    }): Promise<{}>;
-    /**
-     *
-     * @param {string} cartId -
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
-     * @deprecated Use the object parameter style method for a better developer experience.
-     */
-    cartsItemsDelete(cartId: string, id: string): Promise<{}>;
-    /**
-     *
-     * @param {string} params.cartId -
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.CartItem>}
-     */
-    cartsItemsGet(params: {
-        cartId: string;
-        id: string;
-    }): Promise<Models.CartItem>;
-    /**
-     *
-     * @param {string} cartId -
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.CartItem>}
-     * @deprecated Use the object parameter style method for a better developer experience.
-     */
-    cartsItemsGet(cartId: string, id: string): Promise<Models.CartItem>;
-    /**
-     *
-     * @param {string} params.cartId -
-     * @param {string} params.id -
-     * @param {object} params.configuration - Free-form configuration — configured lines never merge.
-     * @param {string} params.currency - Defaults to the cart's currency.
-     * @param {object} params.metadata - Free-form metadata.
-     * @param {string} params.name - Falls back to 'sku' when omitted.
-     * @param {number} params.position -
-     * @param {string} params.productId -
-     * @param {number} params.quantity - Default 1.
-     * @param {string} params.sku -
-     * @param {object} params.snapshot - Loose product snapshot at add-time (price, name, image, …).
-     * @param {number} params.taxRate -
-     * @param {CartItemType} params.type - Line type (default 'product'). Plain product lines merge by product+price; configurations always stand alone.
-     * @param {string} params.unit -
-     * @param {number} params.unitPrice - Per-unit net price — line_total is always derived.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.CartItem>}
-     */
-    cartsItemsUpdate(params: {
-        cartId: string;
-        id: string;
-        configuration?: object;
-        currency?: string;
-        metadata?: object;
-        name?: string;
-        position?: number;
-        productId?: string;
-        quantity?: number;
-        sku?: string;
-        snapshot?: object;
-        taxRate?: number;
-        type?: CartItemType;
-        unit?: string;
-        unitPrice?: number;
-    }): Promise<Models.CartItem>;
-    /**
-     *
-     * @param {string} cartId -
-     * @param {string} id -
-     * @param {object} configuration - Free-form configuration — configured lines never merge.
-     * @param {string} currency - Defaults to the cart's currency.
-     * @param {object} metadata - Free-form metadata.
-     * @param {string} name - Falls back to 'sku' when omitted.
-     * @param {number} position -
-     * @param {string} productId -
-     * @param {number} quantity - Default 1.
-     * @param {string} sku -
-     * @param {object} snapshot - Loose product snapshot at add-time (price, name, image, …).
-     * @param {number} taxRate -
-     * @param {CartItemType} type - Line type (default 'product'). Plain product lines merge by product+price; configurations always stand alone.
-     * @param {string} unit -
-     * @param {number} unitPrice - Per-unit net price — line_total is always derived.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.CartItem>}
-     * @deprecated Use the object parameter style method for a better developer experience.
-     */
-    cartsItemsUpdate(cartId: string, id: string, configuration?: object, currency?: string, metadata?: object, name?: string, position?: number, productId?: string, quantity?: number, sku?: string, snapshot?: object, taxRate?: number, type?: CartItemType, unit?: string, unitPrice?: number): Promise<Models.CartItem>;
-    /**
-     *
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @throws {RevenexxException}
      * @returns {Promise<{}>}
      */
     cartsDelete(params: {
         id: string;
     }): Promise<{}>;
     /**
+     * Removes the cart row and, through the `on delete cascade` on `cart_items.cart_id`, every line in it. There is no soft delete and no undo. One status is protected and it is protected permanently: an 'ordered' cart is the source record of a sale — the order carries its id in `cart_id` and the order.placed event records it — so this route refuses it with 400 and there is no flag, no force and no lifecycle route that makes it deletable. Do not go looking for one. 'active', 'abandoned' and 'merged' are all deletable, which is deliberate and is the same set the cart-maintenance sweep removes on a retention window: clearing out abandoned guest carts is the main thing anyone deletes a cart for, and a merged cart's lines were COPIED into the target, which still holds them. What the delete does NOT take with it is the trail: `merged_into_cart_id` is a plain uuid column and not a foreign key, so deleting a cart that other carts were merged INTO leaves those carts pointing at a row that no longer exists, and nothing refuses the delete or clears the pointer — the retention sweep does the same, so this is a property of the column and not of this route. For a cart a buyer simply walked away from, carts.abandon keeps the row and the funnel; for deleting on a retention window, the cart-maintenance sweep does it per market and can be asked first with `dry_run`.
      *
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @throws {RevenexxException}
      * @returns {Promise<{}>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     cartsDelete(id: string): Promise<{}>;
     /**
+     * One cart with its owner, its totals and its lifecycle stamps — and none of its lines: those are a separate call (`GET /carts/{cart_id}/items`), because a cart row is small and a filled cart is not. The two totals are derived and stored, never taken from a caller: `item_count` is the sum of the line QUANTITIES rather than the number of lines (two lines of five pieces answer 10, not 2) and `subtotal` the sum of the line totals, net of shipping and tax; both are recomputed after every line write. `status` says what may still be done — only an 'active' cart accepts a write of any kind, 'abandoned' is the one reversible ending, and a 'merged' cart carries `merged_into_cart_id`, which is the trail to the cart its lines were copied into.
      *
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Cart>}
      */
     cartsGet(params: {
         id: string;
     }): Promise<Models.Cart>;
     /**
+     * One cart with its owner, its totals and its lifecycle stamps — and none of its lines: those are a separate call (`GET /carts/{cart_id}/items`), because a cart row is small and a filled cart is not. The two totals are derived and stored, never taken from a caller: `item_count` is the sum of the line QUANTITIES rather than the number of lines (two lines of five pieces answer 10, not 2) and `subtotal` the sum of the line totals, net of shipping and tax; both are recomputed after every line write. `status` says what may still be done — only an 'active' cart accepts a write of any kind, 'abandoned' is the one reversible ending, and a 'merged' cart carries `merged_into_cart_id`, which is the trail to the cart its lines were copied into.
      *
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Cart>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     cartsGet(id: string): Promise<Models.Cart>;
     /**
+     * The four columns a cart's own editing screen owns, and only those: `name`, `currency`, `channel_id` and `metadata`. Everything else about a cart is either derived or a lifecycle move, and both are deliberately out of reach here — `item_count` and `subtotal` are recomputed from the lines, `status` travels through the action routes (activate, abandon, reopen, order, merge) so that every transition is guarded, and `market_id` is the platform's scope on the row rather than a column this app writes. A payload carrying none of the four answers 400 rather than storing nothing quietly, so a caller never believes an ignored field was saved. The owner is not updatable either: a guest cart becomes a customer's through carts.claim.
      *
-     * @param {string} params.id -
-     * @param {string} params.channelId -
-     * @param {string} params.currency - ISO 4217 code.
-     * @param {string} params.marketId -
-     * @param {object} params.metadata - Free-form metadata.
-     * @param {string} params.name -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @param {string} params.channelId - Move the cart to another sales channel.
+     * @param {string} params.currency - ISO 4217 code. Changes what NEW lines inherit; lines already in the cart keep the currency they were added with.
+     * @param {object} params.metadata - Free-form data the storefront hangs on the cart. Stored and returned verbatim; no key in here is read by this app, and none is indexed.
+     * @param {string} params.name - Rename the cart. Unlike on create, this is written verbatim — `null` and `''` are refused by the database.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Cart>}
      */
     cartsUpdate(params: {
         id: string;
         channelId?: string;
         currency?: string;
-        marketId?: string;
         metadata?: object;
         name?: string;
     }): Promise<Models.Cart>;
     /**
+     * The four columns a cart's own editing screen owns, and only those: `name`, `currency`, `channel_id` and `metadata`. Everything else about a cart is either derived or a lifecycle move, and both are deliberately out of reach here — `item_count` and `subtotal` are recomputed from the lines, `status` travels through the action routes (activate, abandon, reopen, order, merge) so that every transition is guarded, and `market_id` is the platform's scope on the row rather than a column this app writes. A payload carrying none of the four answers 400 rather than storing nothing quietly, so a caller never believes an ignored field was saved. The owner is not updatable either: a guest cart becomes a customer's through carts.claim.
      *
-     * @param {string} id -
-     * @param {string} channelId -
-     * @param {string} currency - ISO 4217 code.
-     * @param {string} marketId -
-     * @param {object} metadata - Free-form metadata.
-     * @param {string} name -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @param {string} channelId - Move the cart to another sales channel.
+     * @param {string} currency - ISO 4217 code. Changes what NEW lines inherit; lines already in the cart keep the currency they were added with.
+     * @param {object} metadata - Free-form data the storefront hangs on the cart. Stored and returned verbatim; no key in here is read by this app, and none is indexed.
+     * @param {string} name - Rename the cart. Unlike on create, this is written verbatim — `null` and `''` are refused by the database.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Cart>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    cartsUpdate(id: string, channelId?: string, currency?: string, marketId?: string, metadata?: object, name?: string): Promise<Models.Cart>;
+    cartsUpdate(id: string, channelId?: string, currency?: string, metadata?: object, name?: string): Promise<Models.Cart>;
     /**
+     * The by-hand half of the abandonment funnel: an active cart becomes 'abandoned', `abandoned_at` is stamped, and `is_current` is cleared — so its owner is left with no current cart until another one is activated. Nothing else in the platform writes `abandoned_at`; the only other writer is the cart-maintenance sweep, which does exactly this once a cart has sat untouched past the market's `abandon_after_minutes`. This is the one reversible ending: the lines are untouched throughout and carts.reopen takes the cart back. Only an active cart can be abandoned — an ordered or merged cart is already finished and answers 400 naming the status it actually holds.
      *
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Cart>}
      */
     cartsAbandon(params: {
         id: string;
     }): Promise<Models.Cart>;
     /**
+     * The by-hand half of the abandonment funnel: an active cart becomes 'abandoned', `abandoned_at` is stamped, and `is_current` is cleared — so its owner is left with no current cart until another one is activated. Nothing else in the platform writes `abandoned_at`; the only other writer is the cart-maintenance sweep, which does exactly this once a cart has sat untouched past the market's `abandon_after_minutes`. This is the one reversible ending: the lines are untouched throughout and carts.reopen takes the cart back. Only an active cart can be abandoned — an ordered or merged cart is already finished and answers 400 naming the status it actually holds.
      *
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Cart>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     cartsAbandon(id: string): Promise<Models.Cart>;
     /**
+     * Activate writes exactly one thing: `is_current` on this cart, cleared on every other cart of the same owner (the same contact_id, or the same session_key). It does NOT change the status — an active cart stays active, and only an active cart may be made current. Read it back with `GET /carts?is_current=true` plus the owner: that filter is the only way to see what this route wrote, and a storefront resuming a session is its main caller. The flag is cleared again by abandoning, ordering or merging the cart, so an owner can legitimately have no current cart at all.
      *
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Cart>}
      */
     cartsActivate(params: {
         id: string;
     }): Promise<Models.Cart>;
     /**
+     * Activate writes exactly one thing: `is_current` on this cart, cleared on every other cart of the same owner (the same contact_id, or the same session_key). It does NOT change the status — an active cart stays active, and only an active cart may be made current. Read it back with `GET /carts?is_current=true` plus the owner: that filter is the only way to see what this route wrote, and a storefront resuming a session is its main caller. The flag is cleared again by abandoning, ordering or merging the cart, so an owner can legitimately have no current cart at all.
      *
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Cart>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
     cartsActivate(id: string): Promise<Models.Cart>;
     /**
+     * Identical to carts.merge, with the SOURCE taken from the path — which is what makes the merge reachable from anything holding one cart and only one: a Cockpit row action, a detail page, a storefront session. The cart in the path is therefore the one that ends: its lines are copied into the `target_cart_id` named in the body, that target keeps its own lines and survives, and the path cart is closed with status 'merged' and `merged_into_cart_id` pointing at it. Getting the two the wrong way round is the mistake this route exists to make hard, so read the path id as "the cart I am giving away". Both carts must be active and must differ.
      *
-     * @param {string} params.id -
-     * @param {CartExportFormat} params.format - Ad-hoc export format (only without profile_id).
-     * @param {string} params.profileId - Export profile to run; ad-hoc JSON/CSV export when omitted.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} params.id - The SOURCE cart — the one whose lines move and which becomes status merged.
+     * @param {string} params.targetCartId - Receiving cart (must be active). The cart in the path is the source and becomes status merged.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CartMergeResult>}
      */
-    cartsExport(params: {
+    cartsMergeInto(params: {
         id: string;
-        format?: CartExportFormat;
-        profileId?: string;
-    }): Promise<{}>;
+        targetCartId: string;
+    }): Promise<Models.CartMergeResult>;
     /**
+     * Identical to carts.merge, with the SOURCE taken from the path — which is what makes the merge reachable from anything holding one cart and only one: a Cockpit row action, a detail page, a storefront session. The cart in the path is therefore the one that ends: its lines are copied into the `target_cart_id` named in the body, that target keeps its own lines and survives, and the path cart is closed with status 'merged' and `merged_into_cart_id` pointing at it. Getting the two the wrong way round is the mistake this route exists to make hard, so read the path id as "the cart I am giving away". Both carts must be active and must differ.
      *
-     * @param {string} id -
-     * @param {CartExportFormat} format - Ad-hoc export format (only without profile_id).
-     * @param {string} profileId - Export profile to run; ad-hoc JSON/CSV export when omitted.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<{}>}
+     * @param {string} id - The SOURCE cart — the one whose lines move and which becomes status merged.
+     * @param {string} targetCartId - Receiving cart (must be active). The cart in the path is the source and becomes status merged.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CartMergeResult>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    cartsExport(id: string, format?: CartExportFormat, profileId?: string): Promise<{}>;
+    cartsMergeInto(id: string, targetCartId: string): Promise<Models.CartMergeResult>;
     /**
+     * The hand-over to order management, and the end of the cart as a workspace: an ACTIVE cart becomes 'ordered', ordered_at is stamped, and the order_ref the call carries — order management's own number for the order this cart became — is stored on the cart, which is what lets anyone filter their way from an order number back to the cart behind it. Nothing moves out of 'ordered' afterwards, and no route will delete it. The conversion applies the two tenant decisions a cart cannot make for itself. price_snapshot_mode (snapshot | live) settles which of a line's two prices is charged — the snapshot the buyer was shown, or the current unit_price — and the cart's subtotal is rewritten to match, so cart and order can never disagree; 'pricing' reports the mode, the lines it rewrote and the subtotal on both sides. convert_reserves_stock (never | request | require) decides whether inventories is asked to hold the lines; at 'require' a refusal answers 409 and the cart stays active and unchanged. The reservation is attempted BEFORE anything is written.
      *
-     * @param {string} params.id -
-     * @param {string} params.orderRef - External order reference from order management.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.Cart>}
+     * @param {string} params.id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @param {string} params.orderRef - The order number this cart becomes, in order management's own numbering. Stored on the cart — filtering on it is how anyone gets from an order back to the cart behind it — and it is also the reference the stock reservation is booked under. Omit it and the cart id is used for the reservation instead.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CartConversion>}
      */
     cartsOrder(params: {
         id: string;
         orderRef?: string;
-    }): Promise<Models.Cart>;
+    }): Promise<Models.CartConversion>;
     /**
+     * The hand-over to order management, and the end of the cart as a workspace: an ACTIVE cart becomes 'ordered', ordered_at is stamped, and the order_ref the call carries — order management's own number for the order this cart became — is stored on the cart, which is what lets anyone filter their way from an order number back to the cart behind it. Nothing moves out of 'ordered' afterwards, and no route will delete it. The conversion applies the two tenant decisions a cart cannot make for itself. price_snapshot_mode (snapshot | live) settles which of a line's two prices is charged — the snapshot the buyer was shown, or the current unit_price — and the cart's subtotal is rewritten to match, so cart and order can never disagree; 'pricing' reports the mode, the lines it rewrote and the subtotal on both sides. convert_reserves_stock (never | request | require) decides whether inventories is asked to hold the lines; at 'require' a refusal answers 409 and the cart stays active and unchanged. The reservation is attempted BEFORE anything is written.
      *
-     * @param {string} id -
-     * @param {string} orderRef - External order reference from order management.
-     * @throws {RevenexxAPIRevenexxException}
-     * @returns {Promise<Models.Cart>}
+     * @param {string} id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @param {string} orderRef - The order number this cart becomes, in order management's own numbering. Stored on the cart — filtering on it is how anyone gets from an order back to the cart behind it — and it is also the reference the stock reservation is booked under. Omit it and the cart id is used for the reservation instead.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.CartConversion>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */
-    cartsOrder(id: string, orderRef?: string): Promise<Models.Cart>;
+    cartsOrder(id: string, orderRef?: string): Promise<Models.CartConversion>;
     /**
+     * Takes an abandoned cart back to 'active' with its lines exactly as they were — what a storefront calls when a buyer follows a recovery mail, and the way out of the 400 a write gets on a cart the maintenance sweep closed while nobody was looking. It also CLEARS `abandoned_at`, so a cart that was abandoned and reopened leaves nothing behind in the funnel: the funnel counts carts that are still abandoned, not carts that ever were. It does not restore `is_current` — a reopened cart is active but not current until carts.activate says so. Only an abandoned cart may be reopened; 'ordered' and 'merged' are final and answer 400 naming the status the cart holds.
      *
-     * @param {string} params.id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} params.id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Cart>}
      */
     cartsReopen(params: {
         id: string;
     }): Promise<Models.Cart>;
     /**
+     * Takes an abandoned cart back to 'active' with its lines exactly as they were — what a storefront calls when a buyer follows a recovery mail, and the way out of the 400 a write gets on a cart the maintenance sweep closed while nobody was looking. It also CLEARS `abandoned_at`, so a cart that was abandoned and reopened leaves nothing behind in the funnel: the funnel counts carts that are still abandoned, not carts that ever were. It does not restore `is_current` — a reopened cart is active but not current until carts.activate says so. Only an abandoned cart may be reopened; 'ordered' and 'merged' are final and answer 400 naming the status the cart holds.
      *
-     * @param {string} id -
-     * @throws {RevenexxAPIRevenexxException}
+     * @param {string} id - The cart, by its id — the `id` every cart answer carries. A uuid: the data plane casts the segment, so a code or a slug is refused before the cart is looked up.
+     * @throws {RevenexxException}
      * @returns {Promise<Models.Cart>}
      * @deprecated Use the object parameter style method for a better developer experience.
      */