@revenexx/node 0.0.2 → 0.1.1

package/dist/services/products-assets.d.mts

@@ -0,0 +1,540 @@
+import { Client } from '../client.mjs';
+import { Models } from '../models.mjs';
+import { ProductsAssetsListSource } from '../enums/products-assets-list-source.mjs';
+import { AssetsSource } from '../enums/assets-source.mjs';
+import '../query.mjs';
+import '../enums/address-type-row-tone.mjs';
+import '../enums/address-type-row-create-request-tone.mjs';
+import '../enums/address-type-row-update-request-tone.mjs';
+import '../enums/approval-rule-approver-type.mjs';
+import '../enums/approval-rule-condition.mjs';
+import '../enums/approval-rule-effect.mjs';
+import '../enums/approval-rule-create-request-approver-type.mjs';
+import '../enums/approval-rule-create-request-condition.mjs';
+import '../enums/approval-rule-create-request-effect.mjs';
+import '../enums/approval-rule-update-request-approver-type.mjs';
+import '../enums/approval-rule-update-request-condition.mjs';
+import '../enums/approval-rule-update-request-effect.mjs';
+import '../enums/attribute-value-bucket.mjs';
+import '../enums/auth-mail-source.mjs';
+import '../enums/recovery-mail-source.mjs';
+import '../enums/registration-status.mjs';
+import '../enums/budget-change-reason.mjs';
+import '../enums/budget-movement-result-status.mjs';
+import '../enums/cart-status.mjs';
+import '../enums/cart-merge-strategy.mjs';
+import '../enums/cart-price-snapshot-mode.mjs';
+import '../enums/cart-io-format.mjs';
+import '../enums/cart-export-format.mjs';
+import '../enums/cart-item-type.mjs';
+import '../enums/cart-vocabulary-tone.mjs';
+import '../enums/cart-vocabulary-name.mjs';
+import '../enums/cart-vocabulary-source.mjs';
+import '../enums/cart-vocabulary-ref-name.mjs';
+import '../enums/categories-rule-match.mjs';
+import '../enums/category-rule-operator.mjs';
+import '../enums/category-rule-match.mjs';
+import '../enums/channel-status.mjs';
+import '../enums/channel-unassigned-visibility.mjs';
+import '../enums/channel-unresolved-reason.mjs';
+import '../enums/channel-context-source.mjs';
+import '../enums/channel-inactive-behavior.mjs';
+import '../enums/channel-policy-source.mjs';
+import '../enums/channel-policy-tenant-default.mjs';
+import '../enums/channel-unassigned-policy.mjs';
+import '../enums/channel-type-tone.mjs';
+import '../enums/channel-visibility-reason.mjs';
+import '../enums/channel-vocabulary-tone.mjs';
+import '../enums/channel-vocabulary-name.mjs';
+import '../enums/channel-vocabulary-source.mjs';
+import '../enums/channel-vocabulary-ref-name.mjs';
+import '../enums/contact-registration-status.mjs';
+import '../enums/contact-status.mjs';
+import '../enums/contact-activity-kind.mjs';
+import '../enums/contact-create-request-registration-status.mjs';
+import '../enums/contact-event-kind-tone.mjs';
+import '../enums/contact-event-kind-create-request-tone.mjs';
+import '../enums/contact-event-kind-update-request-tone.mjs';
+import '../enums/contact-update-request-registration-status.mjs';
+import '../enums/cost-center-budget-type.mjs';
+import '../enums/cost-center-restriction-type.mjs';
+import '../enums/cost-center-restriction-create-request-type.mjs';
+import '../enums/cost-center-restriction-update-request-type.mjs';
+import '../enums/payment-fee-type.mjs';
+import '../enums/payment-method-kind.mjs';
+import '../enums/form-status.mjs';
+import '../enums/form-submission-status.mjs';
+import '../enums/form-notify-source.mjs';
+import '../enums/form-submission-prune-request-status.mjs';
+import '../enums/forms-vocabulary-tone.mjs';
+import '../enums/forms-vocabulary-name.mjs';
+import '../enums/forms-vocabulary-summary-name.mjs';
+import '../enums/inventory-vocabulary-default-tone.mjs';
+import '../enums/inventory-vocabulary-source.mjs';
+import '../enums/cart-io-apply-mode.mjs';
+import '../enums/cart-io-direction.mjs';
+import '../enums/cart-io-entity.mjs';
+import '../enums/io-profile-resource-apply-mode.mjs';
+import '../enums/io-profile-resource-direction.mjs';
+import '../enums/lifecycle-stage-tone.mjs';
+import '../enums/lifecycle-stage-create-request-tone.mjs';
+import '../enums/lifecycle-stage-update-request-tone.mjs';
+import '../enums/location-type.mjs';
+import '../enums/market-status.mjs';
+import '../enums/market-default-locale-source.mjs';
+import '../enums/market-locale-fallback.mjs';
+import '../enums/market-locale-granularity.mjs';
+import '../enums/market-pricing-source.mjs';
+import '../enums/market-tax-basis.mjs';
+import '../enums/market-readiness-check-id.mjs';
+import '../enums/market-readiness-severity.mjs';
+import '../enums/markets-vocabulary-tone.mjs';
+import '../enums/markets-vocabulary-name.mjs';
+import '../enums/markets-vocabulary-source.mjs';
+import '../enums/markets-vocabulary-summary-name.mjs';
+import '../enums/order-fulfillment-status.mjs';
+import '../enums/order-payment-status.mjs';
+import '../enums/order-status.mjs';
+import '../enums/order-cancellation-scope.mjs';
+import '../enums/order-comment-visibility.mjs';
+import '../enums/order-item-type.mjs';
+import '../enums/order-list-kind-tone.mjs';
+import '../enums/order-list-kind-row-tone.mjs';
+import '../enums/order-list-cart-mode.mjs';
+import '../enums/order-list-vocabulary-default-tone.mjs';
+import '../enums/order-list-vocabulary-name.mjs';
+import '../enums/order-list-vocabulary-source.mjs';
+import '../enums/order-list-vocabulary-tone.mjs';
+import '../enums/order-return-status.mjs';
+import '../enums/order-return-settlement.mjs';
+import '../enums/order-return-refusal.mjs';
+import '../enums/order-vocabulary-tone.mjs';
+import '../enums/order-vocabulary-name.mjs';
+import '../enums/order-vocabulary-source.mjs';
+import '../enums/order-vocabulary-summary-name.mjs';
+import '../enums/order-resolution-stage.mjs';
+import '../enums/organization-status.mjs';
+import '../enums/page-status.mjs';
+import '../enums/pages-vocabulary-app.mjs';
+import '../enums/pages-vocabulary-tone.mjs';
+import '../enums/pages-vocabulary-name.mjs';
+import '../enums/pages-vocabulary-source.mjs';
+import '../enums/pages-vocabulary-index-app.mjs';
+import '../enums/payment-dunning-stage.mjs';
+import '../enums/payment-failure-code.mjs';
+import '../enums/payment-status.mjs';
+import '../enums/payment-term-tone.mjs';
+import '../enums/payment-term-create-request-tone.mjs';
+import '../enums/payment-term-update-request-tone.mjs';
+import '../enums/payment-vocabulary-tone.mjs';
+import '../enums/pending-approval-approver-type.mjs';
+import '../enums/pending-approval-status.mjs';
+import '../enums/price-ending-rule.mjs';
+import '../enums/price-entries-adjust-response-rounding.mjs';
+import '../enums/price-entries-adjust-response-rounding-mode.mjs';
+import '../enums/price-entries-bulk-mode.mjs';
+import '../enums/price-rounding-mode.mjs';
+import '../enums/price-entry-type.mjs';
+import '../enums/price-list-status.mjs';
+import '../enums/price-list-tax-basis.mjs';
+import '../enums/price-currency-source.mjs';
+import '../enums/price-list-tiebreak.mjs';
+import '../enums/price-tax-inclusive-default.mjs';
+import '../enums/price-tax-unresolved-reason.mjs';
+import '../enums/price-tax-market-source.mjs';
+import '../enums/price-vocabulary-tone.mjs';
+import '../enums/price-vocabulary-name.mjs';
+import '../enums/price-vocabulary-source.mjs';
+import '../enums/price-vocabulary-ref-name.mjs';
+import '../enums/product-categories-source.mjs';
+import '../enums/product-grid-column-source.mjs';
+import '../enums/product-label-source.mjs';
+import '../enums/product-label-attribute-source.mjs';
+import '../enums/products-kind.mjs';
+import '../enums/purchase-request-status.mjs';
+import '../enums/purchase-request-event-name.mjs';
+import '../enums/purchase-request-item-type.mjs';
+import '../enums/purchase-request-item-create-request-type.mjs';
+import '../enums/purchase-request-item-update-request-type.mjs';
+import '../enums/reorder-point-source.mjs';
+import '../enums/reservation-status.mjs';
+import '../enums/price-on-request-reason.mjs';
+import '../enums/price-tax-basis.mjs';
+import '../enums/price-tax-basis-source.mjs';
+import '../enums/role-catalog-response-source.mjs';
+import '../enums/segment-rule-match.mjs';
+import '../enums/segment-member-source.mjs';
+import '../enums/segment-rule-operator.mjs';
+import '../enums/segment-rule-preview-request-rule-match.mjs';
+import '../enums/segment-rule-preview-request-target.mjs';
+import '../enums/segment-rule-preview-response-rule-match.mjs';
+import '../enums/segment-rule-preview-response-target.mjs';
+import '../enums/segment-rules-target.mjs';
+import '../enums/shipping-carrier-status.mjs';
+import '../enums/shipping-method-matrix-basis.mjs';
+import '../enums/shipping-method-pricing-type.mjs';
+import '../enums/shipping-carrier-source.mjs';
+import '../enums/shipping-rate-pricing-type.mjs';
+import '../enums/shipping-tax-source.mjs';
+import '../enums/shipping-free-above-basis.mjs';
+import '../enums/shipping-rates-basis-matrix-basis-default.mjs';
+import '../enums/shipping-service-level-create-request-tone.mjs';
+import '../enums/shipping-service-level-row-tone.mjs';
+import '../enums/shipping-service-level-update-request-tone.mjs';
+import '../enums/shipping-tax-unresolved-reason.mjs';
+import '../enums/shipping-tax-market-source.mjs';
+import '../enums/shipping-tax-context-via.mjs';
+import '../enums/shipping-tracking-carrier-status.mjs';
+import '../enums/shipping-vocabulary-default-tone.mjs';
+import '../enums/shipping-vocabulary-source.mjs';
+import '../enums/shipping-vocabulary-tone.mjs';
+import '../enums/shipping-weight-unit-create-request-tone.mjs';
+import '../enums/shipping-weight-unit-row-tone.mjs';
+import '../enums/shipping-weight-unit-update-request-tone.mjs';
+import '../enums/stock-movement-type.mjs';
+import '../enums/store-asset-request-visibility.mjs';
+import '../enums/submit-item-type.mjs';
+import '../enums/submit-result-outcome.mjs';
+import '../enums/validation-failed-response-status.mjs';
+import '../enums/vocabulary-default-tone.mjs';
+import '../enums/vocabulary-source.mjs';
+import '../enums/vocabulary-tone.mjs';
+import '../enums/attribute-boolean-status.mjs';
+import '../enums/attribute-datetime-status.mjs';
+import '../enums/attribute-email-status.mjs';
+import '../enums/attribute-enum-status.mjs';
+import '../enums/attribute-float-status.mjs';
+import '../enums/attribute-integer-status.mjs';
+import '../enums/attribute-ip-status.mjs';
+import '../enums/attribute-line-status.mjs';
+import '../enums/attribute-longtext-status.mjs';
+import '../enums/attribute-mediumtext-status.mjs';
+import '../enums/attribute-point-status.mjs';
+import '../enums/attribute-polygon-status.mjs';
+import '../enums/attribute-relationship-status.mjs';
+import '../enums/attribute-string-status.mjs';
+import '../enums/attribute-text-status.mjs';
+import '../enums/attribute-url-status.mjs';
+import '../enums/attribute-varchar-status.mjs';
+import '../enums/column-boolean-status.mjs';
+import '../enums/column-datetime-status.mjs';
+import '../enums/column-email-status.mjs';
+import '../enums/column-enum-status.mjs';
+import '../enums/column-float-status.mjs';
+import '../enums/column-integer-status.mjs';
+import '../enums/column-ip-status.mjs';
+import '../enums/column-line-status.mjs';
+import '../enums/column-longtext-status.mjs';
+import '../enums/column-mediumtext-status.mjs';
+import '../enums/column-point-status.mjs';
+import '../enums/column-polygon-status.mjs';
+import '../enums/column-relationship-status.mjs';
+import '../enums/column-string-status.mjs';
+import '../enums/column-text-status.mjs';
+import '../enums/column-url-status.mjs';
+import '../enums/column-varchar-status.mjs';
+import '../enums/database-type.mjs';
+import '../enums/deployment-status.mjs';
+import '../enums/execution-status.mjs';
+import '../enums/execution-trigger.mjs';
+import '../enums/health-antivirus-status.mjs';
+import '../enums/health-status-status.mjs';
+import '../enums/index-status.mjs';
+import '../enums/message-2-status.mjs';
+
+declare class ProductsAssets {
+    client: Client;
+    constructor(client: Client);
+    /**
+     * One piece of media in the decoupled asset domain. The bytes live either in this platform's object store (`source: "storage"` with a `storage_asset_id` that survives a rename) or on somebody else's host (`source: "external"` with an `external_url`), and the database enforces the pair so neither half can be stored alone. A product points at an asset by its code through a media attribute; there is no product-to-asset link table in this app.
+     *
+     * Every column of `assets` is an exact-match query parameter, `order` sorts by one column, and `limit`/`offset` page through `page.total`. A query key that is NOT a column is dropped rather than refused, and the `filter` object echoes the ones that were understood — that echo is the only way to tell an unfiltered answer from an empty one. It reads rows exactly as they are stored: no join is resolved, no jsonb value is unpacked.
+     *
+     * Answered from the gateway's tenant cache for up to 30 minutes and dropped the moment this entity is written, because the data model changes weekly at most and every product page asks the same question.
+     *
+     * @param {number} params.limit - Page size (default 50, max 200). A larger value is clamped rather than refused.
+     * @param {number} params.offset - Row offset for pagination (default 0). Page with `page.total` and `page.hasMore`.
+     * @param {string} params.order - Sort by one column: 'column' | 'column.asc' | 'column.desc'. A bare column sorts ascending. Anything else is refused with 400.
+     * @param {string} params.id - Exact match on `id`. The row's own id, generated by the database. A client never sends one; it reads one back and uses it in the path of every later call.
+     * @param {string} params.assetFamilyId - Exact match on `asset_family_id`. The asset family this asset belongs to — which attributes it carries and how its file is named. A create falls back to the `default_asset_family` tenant setting when the body names none.
+     * @param {string} params.code - Exact match on `code`. The asset's stable identifier within its family — the value a product's media attribute stores. Unique per family.
+     * @param {ProductsAssetsListSource} params.source - Exact match on `source`. Where the bytes live: 'storage' is this platform's object store and needs `storage_asset_id`, 'external' is somebody else's host and needs `external_url`. The database enforces the pair, so neither half can be stored on its own.
+     * @param {string} params.storageAssetId - Exact match on `storage_asset_id`. The stable `ast_…` id of the storage object. It survives a rename or a folder move, which is exactly why it and not the delivery path is the identifier. Required when `source` is `storage`.
+     * @param {string} params.deliveryPath - Exact match on `delivery_path`. The path the CDN serves this asset under — the convenient value for rendering. It changes when the file is moved, so never join on it.
+     * @param {string} params.externalUrl - Exact match on `external_url`. Absolute URL of an externally hosted file. Required when `source` is `external`, and accepted only when the tenant has `allow_external_media` on and the host is on its `external_media_allowed_hosts` list — `POST /products/assets` is the only place an external URL can enter the catalog, so it is the only place those are enforced.
+     * @param {string} params.attributeValues - Exact match on `attribute_values`. Every attribute value the record carries, in ONE jsonb document — the core of an attribute-driven PIM. A record's properties are not columns here: they are rows in `attributes`, selected per family by `family_attributes`, and their values live under their attribute CODE inside this object. The whole jsonb document is compared, serialized as JSON — this is equality, not a path or containment query, and `null` cannot be matched this way. A value that does not parse as JSON is refused with 400 `invalid_value`, naming this filter, before the request reaches the data plane.
+     * @param {string} params.createdAt - Exact match on `created_at`. When the row was created. Server-set — it is not part of any request body.
+     * @param {string} params.updatedAt - Exact match on `updated_at`. When the row was last written. Server-set — it is not part of any request body.
+     * @throws {RevenexxException}
+     * @returns {Promise<{}>}
+     */
+    productsAssetsList(params?: {
+        limit?: number;
+        offset?: number;
+        order?: string;
+        id?: string;
+        assetFamilyId?: string;
+        code?: string;
+        source?: ProductsAssetsListSource;
+        storageAssetId?: string;
+        deliveryPath?: string;
+        externalUrl?: string;
+        attributeValues?: string;
+        createdAt?: string;
+        updatedAt?: string;
+    }): Promise<{}>;
+    /**
+     * One piece of media in the decoupled asset domain. The bytes live either in this platform's object store (`source: "storage"` with a `storage_asset_id` that survives a rename) or on somebody else's host (`source: "external"` with an `external_url`), and the database enforces the pair so neither half can be stored alone. A product points at an asset by its code through a media attribute; there is no product-to-asset link table in this app.
+     *
+     * Every column of `assets` is an exact-match query parameter, `order` sorts by one column, and `limit`/`offset` page through `page.total`. A query key that is NOT a column is dropped rather than refused, and the `filter` object echoes the ones that were understood — that echo is the only way to tell an unfiltered answer from an empty one. It reads rows exactly as they are stored: no join is resolved, no jsonb value is unpacked.
+     *
+     * Answered from the gateway's tenant cache for up to 30 minutes and dropped the moment this entity is written, because the data model changes weekly at most and every product page asks the same question.
+     *
+     * @param {number} limit - Page size (default 50, max 200). A larger value is clamped rather than refused.
+     * @param {number} offset - Row offset for pagination (default 0). Page with `page.total` and `page.hasMore`.
+     * @param {string} order - Sort by one column: 'column' | 'column.asc' | 'column.desc'. A bare column sorts ascending. Anything else is refused with 400.
+     * @param {string} id - Exact match on `id`. The row's own id, generated by the database. A client never sends one; it reads one back and uses it in the path of every later call.
+     * @param {string} assetFamilyId - Exact match on `asset_family_id`. The asset family this asset belongs to — which attributes it carries and how its file is named. A create falls back to the `default_asset_family` tenant setting when the body names none.
+     * @param {string} code - Exact match on `code`. The asset's stable identifier within its family — the value a product's media attribute stores. Unique per family.
+     * @param {ProductsAssetsListSource} source - Exact match on `source`. Where the bytes live: 'storage' is this platform's object store and needs `storage_asset_id`, 'external' is somebody else's host and needs `external_url`. The database enforces the pair, so neither half can be stored on its own.
+     * @param {string} storageAssetId - Exact match on `storage_asset_id`. The stable `ast_…` id of the storage object. It survives a rename or a folder move, which is exactly why it and not the delivery path is the identifier. Required when `source` is `storage`.
+     * @param {string} deliveryPath - Exact match on `delivery_path`. The path the CDN serves this asset under — the convenient value for rendering. It changes when the file is moved, so never join on it.
+     * @param {string} externalUrl - Exact match on `external_url`. Absolute URL of an externally hosted file. Required when `source` is `external`, and accepted only when the tenant has `allow_external_media` on and the host is on its `external_media_allowed_hosts` list — `POST /products/assets` is the only place an external URL can enter the catalog, so it is the only place those are enforced.
+     * @param {string} attributeValues - Exact match on `attribute_values`. Every attribute value the record carries, in ONE jsonb document — the core of an attribute-driven PIM. A record's properties are not columns here: they are rows in `attributes`, selected per family by `family_attributes`, and their values live under their attribute CODE inside this object. The whole jsonb document is compared, serialized as JSON — this is equality, not a path or containment query, and `null` cannot be matched this way. A value that does not parse as JSON is refused with 400 `invalid_value`, naming this filter, before the request reaches the data plane.
+     * @param {string} createdAt - Exact match on `created_at`. When the row was created. Server-set — it is not part of any request body.
+     * @param {string} updatedAt - Exact match on `updated_at`. When the row was last written. Server-set — it is not part of any request body.
+     * @throws {RevenexxException}
+     * @returns {Promise<{}>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    productsAssetsList(limit?: number, offset?: number, order?: string, id?: string, assetFamilyId?: string, code?: string, source?: ProductsAssetsListSource, storageAssetId?: string, deliveryPath?: string, externalUrl?: string, attributeValues?: string, createdAt?: string, updatedAt?: string): Promise<{}>;
+    /**
+     * Creates one asset and answers 201 with the stored row, including the id and the timestamps the database filled in — a client never sends an id, it reads one back and uses it in the path of every later call.
+     *
+     * One piece of media in the decoupled asset domain. The bytes live either in this platform's object store (`source: "storage"` with a `storage_asset_id` that survives a rename) or on somebody else's host (`source: "external"` with an `external_url`), and the database enforces the pair so neither half can be stored alone. A product points at an asset by its code through a media attribute; there is no product-to-asset link table in this app.
+     *
+     * `asset_family_id` and `code` are the only columns the database refuses the row without; everything else has a default or is nullable. A second row with the same `asset_family_id` and `code` answers 409. This app owns the create, because it is the only place an external URL can enter the catalog: an asset with no family falls back to the `default_asset_family` setting, and an `external` one is refused unless the tenant allows external media and the URL's host is on its allow-list.
+     *
+     * @param {string} params.assetFamilyId - The asset family this asset belongs to — which attributes it carries and how its file is named. A create falls back to the `default_asset_family` tenant setting when the body names none.
+     * @param {string} params.code - The asset's stable identifier within its family — the value a product's media attribute stores. Unique per family.
+     * @param {object} params.attributeValues - Every attribute value the record carries, in ONE jsonb document — the core of an attribute-driven PIM. A record's properties are not columns here: they are rows in `attributes`, selected per family by `family_attributes`, and their values live under their attribute CODE inside this object.
+
+Four buckets, and an attribute's own flags decide which one it writes to:
+
+  `common`                    the attribute is neither localizable nor scopable — one value, full stop.
+                              `{"common": {"net_weight": 2.4, "colour": "black"}}`
+  `locale_specific`           `localizable`: one value per language tag.
+                              `{"locale_specific": {"de_DE": {"name": "Akku-Bohrschrauber"}}}`
+  `channel_specific`          `scopable`: one value per channel.
+                              `{"channel_specific": {"b2b": {"minimum_order_quantity": 6}}}`
+  `channel_locale_specific`   both: one value per channel AND language tag.
+                              `{"channel_locale_specific": {"b2b": {"de_DE": {"description": "…"}}}}`
+
+A reader takes the most specific bucket that carries the code and falls back through locale, then channel, then `common`. `common` is always last and always consulted, because early imports wrote everything there whatever an attribute's flags said — a reader that skipped it reports an imported catalog as empty. `GET /products/attribute-schema` answers, per field, the exact path a value belongs at (`storage.path`) and that full fallback order (`from`), so no client has to re-derive any of this.
+
+The value itself is whatever the attribute's `type` implies: a string, a number, a boolean, an option CODE for a select (never its label), a list of codes for a multi-select, `{"amount": …, "unit": …}` for a measure, a list of `{"amount": …, "currency": …}` for a price, an asset code for media.
+
+Defaults to `{}`, and an empty object is a normal state — a record nobody has enriched yet. The declared type also admits an array only because every jsonb column of this app shares one mapping; an array is not meaningful here and every reader in this app treats a non-object as empty.
+
+Which attributes an asset of this family has comes from `attributes` rows with `entity_type: "asset"` and `entity_ref` equal to the family's code — alt text, copyright, an expiry date.
+     * @param {string} params.deliveryPath - The path the CDN serves this asset under — the convenient value for rendering. It changes when the file is moved, so never join on it.
+     * @param {string} params.externalUrl - Absolute URL of an externally hosted file. Required when `source` is `external`, and accepted only when the tenant has `allow_external_media` on and the host is on its `external_media_allowed_hosts` list — `POST /products/assets` is the only place an external URL can enter the catalog, so it is the only place those are enforced.
+     * @param {AssetsSource} params.source - Where the bytes live: 'storage' is this platform's object store and needs `storage_asset_id`, 'external' is somebody else's host and needs `external_url`. The database enforces the pair, so neither half can be stored on its own.
+     * @param {string} params.storageAssetId - The stable `ast_…` id of the storage object. It survives a rename or a folder move, which is exactly why it and not the delivery path is the identifier. Required when `source` is `storage`.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.Assets>}
+     */
+    productsAssetsCreate(params: {
+        assetFamilyId: string;
+        code: string;
+        attributeValues?: object;
+        deliveryPath?: string;
+        externalUrl?: string;
+        source?: AssetsSource;
+        storageAssetId?: string;
+    }): Promise<Models.Assets>;
+    /**
+     * Creates one asset and answers 201 with the stored row, including the id and the timestamps the database filled in — a client never sends an id, it reads one back and uses it in the path of every later call.
+     *
+     * One piece of media in the decoupled asset domain. The bytes live either in this platform's object store (`source: "storage"` with a `storage_asset_id` that survives a rename) or on somebody else's host (`source: "external"` with an `external_url`), and the database enforces the pair so neither half can be stored alone. A product points at an asset by its code through a media attribute; there is no product-to-asset link table in this app.
+     *
+     * `asset_family_id` and `code` are the only columns the database refuses the row without; everything else has a default or is nullable. A second row with the same `asset_family_id` and `code` answers 409. This app owns the create, because it is the only place an external URL can enter the catalog: an asset with no family falls back to the `default_asset_family` setting, and an `external` one is refused unless the tenant allows external media and the URL's host is on its allow-list.
+     *
+     * @param {string} assetFamilyId - The asset family this asset belongs to — which attributes it carries and how its file is named. A create falls back to the `default_asset_family` tenant setting when the body names none.
+     * @param {string} code - The asset's stable identifier within its family — the value a product's media attribute stores. Unique per family.
+     * @param {object} attributeValues - Every attribute value the record carries, in ONE jsonb document — the core of an attribute-driven PIM. A record's properties are not columns here: they are rows in `attributes`, selected per family by `family_attributes`, and their values live under their attribute CODE inside this object.
+
+Four buckets, and an attribute's own flags decide which one it writes to:
+
+  `common`                    the attribute is neither localizable nor scopable — one value, full stop.
+                              `{"common": {"net_weight": 2.4, "colour": "black"}}`
+  `locale_specific`           `localizable`: one value per language tag.
+                              `{"locale_specific": {"de_DE": {"name": "Akku-Bohrschrauber"}}}`
+  `channel_specific`          `scopable`: one value per channel.
+                              `{"channel_specific": {"b2b": {"minimum_order_quantity": 6}}}`
+  `channel_locale_specific`   both: one value per channel AND language tag.
+                              `{"channel_locale_specific": {"b2b": {"de_DE": {"description": "…"}}}}`
+
+A reader takes the most specific bucket that carries the code and falls back through locale, then channel, then `common`. `common` is always last and always consulted, because early imports wrote everything there whatever an attribute's flags said — a reader that skipped it reports an imported catalog as empty. `GET /products/attribute-schema` answers, per field, the exact path a value belongs at (`storage.path`) and that full fallback order (`from`), so no client has to re-derive any of this.
+
+The value itself is whatever the attribute's `type` implies: a string, a number, a boolean, an option CODE for a select (never its label), a list of codes for a multi-select, `{"amount": …, "unit": …}` for a measure, a list of `{"amount": …, "currency": …}` for a price, an asset code for media.
+
+Defaults to `{}`, and an empty object is a normal state — a record nobody has enriched yet. The declared type also admits an array only because every jsonb column of this app shares one mapping; an array is not meaningful here and every reader in this app treats a non-object as empty.
+
+Which attributes an asset of this family has comes from `attributes` rows with `entity_type: "asset"` and `entity_ref` equal to the family's code — alt text, copyright, an expiry date.
+     * @param {string} deliveryPath - The path the CDN serves this asset under — the convenient value for rendering. It changes when the file is moved, so never join on it.
+     * @param {string} externalUrl - Absolute URL of an externally hosted file. Required when `source` is `external`, and accepted only when the tenant has `allow_external_media` on and the host is on its `external_media_allowed_hosts` list — `POST /products/assets` is the only place an external URL can enter the catalog, so it is the only place those are enforced.
+     * @param {AssetsSource} source - Where the bytes live: 'storage' is this platform's object store and needs `storage_asset_id`, 'external' is somebody else's host and needs `external_url`. The database enforces the pair, so neither half can be stored on its own.
+     * @param {string} storageAssetId - The stable `ast_…` id of the storage object. It survives a rename or a folder move, which is exactly why it and not the delivery path is the identifier. Required when `source` is `storage`.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.Assets>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    productsAssetsCreate(assetFamilyId: string, code: string, attributeValues?: object, deliveryPath?: string, externalUrl?: string, source?: AssetsSource, storageAssetId?: string): Promise<Models.Assets>;
+    /**
+     * Deletes one asset by id. It is a hard delete — the row is gone, and the answer is a confirmation rather than a result to branch on.
+     *
+     * Nothing in this schema references it, so nothing else changes.
+     *
+     * An id no asset of this tenant carries answers 404; there is no 409, because every foreign key pointing at this entity resolves itself on delete rather than blocking one.
+     *
+     * @param {string} params.id - The `assets` row to address, by id. It names a row THIS TENANT holds, so no example is published — a uuid this app invented would document a call that answers 404, and a real one would be another tenant's data. Read one from `GET /v1/products/assets`. An id no asset of this tenant carries answers 404; a malformed one answers 400 before the route is reached.
+     * @throws {RevenexxException}
+     * @returns {Promise<{}>}
+     */
+    productsAssetsDelete(params: {
+        id: string;
+    }): Promise<{}>;
+    /**
+     * Deletes one asset by id. It is a hard delete — the row is gone, and the answer is a confirmation rather than a result to branch on.
+     *
+     * Nothing in this schema references it, so nothing else changes.
+     *
+     * An id no asset of this tenant carries answers 404; there is no 409, because every foreign key pointing at this entity resolves itself on delete rather than blocking one.
+     *
+     * @param {string} id - The `assets` row to address, by id. It names a row THIS TENANT holds, so no example is published — a uuid this app invented would document a call that answers 404, and a real one would be another tenant's data. Read one from `GET /v1/products/assets`. An id no asset of this tenant carries answers 404; a malformed one answers 400 before the route is reached.
+     * @throws {RevenexxException}
+     * @returns {Promise<{}>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    productsAssetsDelete(id: string): Promise<{}>;
+    /**
+     * Reads one asset by its id — the whole row, every column, as it is stored.
+     *
+     * One piece of media in the decoupled asset domain. The bytes live either in this platform's object store (`source: "storage"` with a `storage_asset_id` that survives a rename) or on somebody else's host (`source: "external"` with an `external_url`), and the database enforces the pair so neither half can be stored alone. A product points at an asset by its code through a media attribute; there is no product-to-asset link table in this app.
+     *
+     * An id no asset of this tenant carries answers 404, and so does one belonging to another tenant: row-level security makes that row invisible rather than forbidden. A malformed id answers 400 before the route is reached.
+     *
+     * Answered from the gateway's tenant cache for up to 30 minutes and dropped the moment this entity is written, because the data model changes weekly at most and every product page asks the same question.
+     *
+     * @param {string} params.id - The `assets` row to address, by id. It names a row THIS TENANT holds, so no example is published — a uuid this app invented would document a call that answers 404, and a real one would be another tenant's data. Read one from `GET /v1/products/assets`. An id no asset of this tenant carries answers 404; a malformed one answers 400 before the route is reached.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.Assets>}
+     */
+    productsAssetsGet(params: {
+        id: string;
+    }): Promise<Models.Assets>;
+    /**
+     * Reads one asset by its id — the whole row, every column, as it is stored.
+     *
+     * One piece of media in the decoupled asset domain. The bytes live either in this platform's object store (`source: "storage"` with a `storage_asset_id` that survives a rename) or on somebody else's host (`source: "external"` with an `external_url`), and the database enforces the pair so neither half can be stored alone. A product points at an asset by its code through a media attribute; there is no product-to-asset link table in this app.
+     *
+     * An id no asset of this tenant carries answers 404, and so does one belonging to another tenant: row-level security makes that row invisible rather than forbidden. A malformed id answers 400 before the route is reached.
+     *
+     * Answered from the gateway's tenant cache for up to 30 minutes and dropped the moment this entity is written, because the data model changes weekly at most and every product page asks the same question.
+     *
+     * @param {string} id - The `assets` row to address, by id. It names a row THIS TENANT holds, so no example is published — a uuid this app invented would document a call that answers 404, and a real one would be another tenant's data. Read one from `GET /v1/products/assets`. An id no asset of this tenant carries answers 404; a malformed one answers 400 before the route is reached.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.Assets>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    productsAssetsGet(id: string): Promise<Models.Assets>;
+    /**
+     * Updates one asset by id. A partial patch: the body names only the columns to change and every column it leaves out keeps its current value, so there is no read-modify-write and no way to blank a field by forgetting it.
+     *
+     * One piece of media in the decoupled asset domain. The bytes live either in this platform's object store (`source: "storage"` with a `storage_asset_id` that survives a rename) or on somebody else's host (`source: "external"` with an `external_url`), and the database enforces the pair so neither half can be stored alone. A product points at an asset by its code through a media attribute; there is no product-to-asset link table in this app.
+     *
+     * A body that names nothing writable is refused with 400 rather than answered as a no-op, an id nobody carries answers 404, and a value that collides on `asset_family_id` and `code` answers 409.
+     *
+     * @param {string} params.id - The `assets` row to address, by id. It names a row THIS TENANT holds, so no example is published — a uuid this app invented would document a call that answers 404, and a real one would be another tenant's data. Read one from `GET /v1/products/assets`. An id no asset of this tenant carries answers 404; a malformed one answers 400 before the route is reached.
+     * @param {string} params.assetFamilyId - The asset family this asset belongs to — which attributes it carries and how its file is named. A create falls back to the `default_asset_family` tenant setting when the body names none.
+     * @param {object} params.attributeValues - Every attribute value the record carries, in ONE jsonb document — the core of an attribute-driven PIM. A record's properties are not columns here: they are rows in `attributes`, selected per family by `family_attributes`, and their values live under their attribute CODE inside this object.
+
+Four buckets, and an attribute's own flags decide which one it writes to:
+
+  `common`                    the attribute is neither localizable nor scopable — one value, full stop.
+                              `{"common": {"net_weight": 2.4, "colour": "black"}}`
+  `locale_specific`           `localizable`: one value per language tag.
+                              `{"locale_specific": {"de_DE": {"name": "Akku-Bohrschrauber"}}}`
+  `channel_specific`          `scopable`: one value per channel.
+                              `{"channel_specific": {"b2b": {"minimum_order_quantity": 6}}}`
+  `channel_locale_specific`   both: one value per channel AND language tag.
+                              `{"channel_locale_specific": {"b2b": {"de_DE": {"description": "…"}}}}`
+
+A reader takes the most specific bucket that carries the code and falls back through locale, then channel, then `common`. `common` is always last and always consulted, because early imports wrote everything there whatever an attribute's flags said — a reader that skipped it reports an imported catalog as empty. `GET /products/attribute-schema` answers, per field, the exact path a value belongs at (`storage.path`) and that full fallback order (`from`), so no client has to re-derive any of this.
+
+The value itself is whatever the attribute's `type` implies: a string, a number, a boolean, an option CODE for a select (never its label), a list of codes for a multi-select, `{"amount": …, "unit": …}` for a measure, a list of `{"amount": …, "currency": …}` for a price, an asset code for media.
+
+Defaults to `{}`, and an empty object is a normal state — a record nobody has enriched yet. The declared type also admits an array only because every jsonb column of this app shares one mapping; an array is not meaningful here and every reader in this app treats a non-object as empty.
+
+Which attributes an asset of this family has comes from `attributes` rows with `entity_type: "asset"` and `entity_ref` equal to the family's code — alt text, copyright, an expiry date.
+     * @param {string} params.code - The asset's stable identifier within its family — the value a product's media attribute stores. Unique per family.
+     * @param {string} params.deliveryPath - The path the CDN serves this asset under — the convenient value for rendering. It changes when the file is moved, so never join on it.
+     * @param {string} params.externalUrl - Absolute URL of an externally hosted file. Required when `source` is `external`, and accepted only when the tenant has `allow_external_media` on and the host is on its `external_media_allowed_hosts` list — `POST /products/assets` is the only place an external URL can enter the catalog, so it is the only place those are enforced.
+     * @param {AssetsSource} params.source - Where the bytes live: 'storage' is this platform's object store and needs `storage_asset_id`, 'external' is somebody else's host and needs `external_url`. The database enforces the pair, so neither half can be stored on its own.
+     * @param {string} params.storageAssetId - The stable `ast_…` id of the storage object. It survives a rename or a folder move, which is exactly why it and not the delivery path is the identifier. Required when `source` is `storage`.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.Assets>}
+     */
+    productsAssetsUpdate(params: {
+        id: string;
+        assetFamilyId?: string;
+        attributeValues?: object;
+        code?: string;
+        deliveryPath?: string;
+        externalUrl?: string;
+        source?: AssetsSource;
+        storageAssetId?: string;
+    }): Promise<Models.Assets>;
+    /**
+     * Updates one asset by id. A partial patch: the body names only the columns to change and every column it leaves out keeps its current value, so there is no read-modify-write and no way to blank a field by forgetting it.
+     *
+     * One piece of media in the decoupled asset domain. The bytes live either in this platform's object store (`source: "storage"` with a `storage_asset_id` that survives a rename) or on somebody else's host (`source: "external"` with an `external_url`), and the database enforces the pair so neither half can be stored alone. A product points at an asset by its code through a media attribute; there is no product-to-asset link table in this app.
+     *
+     * A body that names nothing writable is refused with 400 rather than answered as a no-op, an id nobody carries answers 404, and a value that collides on `asset_family_id` and `code` answers 409.
+     *
+     * @param {string} id - The `assets` row to address, by id. It names a row THIS TENANT holds, so no example is published — a uuid this app invented would document a call that answers 404, and a real one would be another tenant's data. Read one from `GET /v1/products/assets`. An id no asset of this tenant carries answers 404; a malformed one answers 400 before the route is reached.
+     * @param {string} assetFamilyId - The asset family this asset belongs to — which attributes it carries and how its file is named. A create falls back to the `default_asset_family` tenant setting when the body names none.
+     * @param {object} attributeValues - Every attribute value the record carries, in ONE jsonb document — the core of an attribute-driven PIM. A record's properties are not columns here: they are rows in `attributes`, selected per family by `family_attributes`, and their values live under their attribute CODE inside this object.
+
+Four buckets, and an attribute's own flags decide which one it writes to:
+
+  `common`                    the attribute is neither localizable nor scopable — one value, full stop.
+                              `{"common": {"net_weight": 2.4, "colour": "black"}}`
+  `locale_specific`           `localizable`: one value per language tag.
+                              `{"locale_specific": {"de_DE": {"name": "Akku-Bohrschrauber"}}}`
+  `channel_specific`          `scopable`: one value per channel.
+                              `{"channel_specific": {"b2b": {"minimum_order_quantity": 6}}}`
+  `channel_locale_specific`   both: one value per channel AND language tag.
+                              `{"channel_locale_specific": {"b2b": {"de_DE": {"description": "…"}}}}`
+
+A reader takes the most specific bucket that carries the code and falls back through locale, then channel, then `common`. `common` is always last and always consulted, because early imports wrote everything there whatever an attribute's flags said — a reader that skipped it reports an imported catalog as empty. `GET /products/attribute-schema` answers, per field, the exact path a value belongs at (`storage.path`) and that full fallback order (`from`), so no client has to re-derive any of this.
+
+The value itself is whatever the attribute's `type` implies: a string, a number, a boolean, an option CODE for a select (never its label), a list of codes for a multi-select, `{"amount": …, "unit": …}` for a measure, a list of `{"amount": …, "currency": …}` for a price, an asset code for media.
+
+Defaults to `{}`, and an empty object is a normal state — a record nobody has enriched yet. The declared type also admits an array only because every jsonb column of this app shares one mapping; an array is not meaningful here and every reader in this app treats a non-object as empty.
+
+Which attributes an asset of this family has comes from `attributes` rows with `entity_type: "asset"` and `entity_ref` equal to the family's code — alt text, copyright, an expiry date.
+     * @param {string} code - The asset's stable identifier within its family — the value a product's media attribute stores. Unique per family.
+     * @param {string} deliveryPath - The path the CDN serves this asset under — the convenient value for rendering. It changes when the file is moved, so never join on it.
+     * @param {string} externalUrl - Absolute URL of an externally hosted file. Required when `source` is `external`, and accepted only when the tenant has `allow_external_media` on and the host is on its `external_media_allowed_hosts` list — `POST /products/assets` is the only place an external URL can enter the catalog, so it is the only place those are enforced.
+     * @param {AssetsSource} source - Where the bytes live: 'storage' is this platform's object store and needs `storage_asset_id`, 'external' is somebody else's host and needs `external_url`. The database enforces the pair, so neither half can be stored on its own.
+     * @param {string} storageAssetId - The stable `ast_…` id of the storage object. It survives a rename or a folder move, which is exactly why it and not the delivery path is the identifier. Required when `source` is `storage`.
+     * @throws {RevenexxException}
+     * @returns {Promise<Models.Assets>}
+     * @deprecated Use the object parameter style method for a better developer experience.
+     */
+    productsAssetsUpdate(id: string, assetFamilyId?: string, attributeValues?: object, code?: string, deliveryPath?: string, externalUrl?: string, source?: AssetsSource, storageAssetId?: string): Promise<Models.Assets>;
+}
+
+export { ProductsAssets };