@augno/sdk 0.13.4 → 0.14.0

package/resources/catalog/products.js

@@ -1,177 +1,6 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Products = void 0;
-const resource_1 = require("../../core/resource.js");
-const path_1 = require("../../internal/utils/path.js");
-/**
- * List and manage products.
- */
-class Products extends resource_1.APIResource {
-    /**
-     * Returns a paginated list of products for the target account, newest first.
-     *
-     * Only products of type `sale` are listed — service, shipping, credit, return, and
-     * tax products are excluded and must be retrieved by ID. A request made by a
-     * customer-portal buyer always returns portal-visible products only, and its
-     * `customer_ids` filter is replaced with the buyer's own account, so the results
-     * reflect what that account is entitled to buy.
-     *
-     * The `q` search term is matched against the SKU and description of each product's
-     * item; when it is supplied, products whose SKU matches are returned ahead of the
-     * rest.
-     *
-     * This endpoint requires the permissions: `items:read`, `customers:read`,
-     * `suppliers:read`.
-     *
-     * @example
-     * ```ts
-     * const listProduct = await client.catalog.products.list();
-     * ```
-     */
-    list(query = {}, options) {
-        return this._client.get('/v1/catalog/products', { query, ...options });
-    }
-    /**
-     * Returns a product by ID.
-     *
-     * This endpoint requires the permissions: `items:read`, `customers:read`,
-     * `suppliers:read`.
-     *
-     * @example
-     * ```ts
-     * const product = await client.catalog.products.retrieve(
-     *   'pd_07oe0r7adh2w',
-     * );
-     * ```
-     */
-    retrieve(id, query = {}, options) {
-        return this._client.get((0, path_1.path) `/v1/catalog/products/${id}`, { query, ...options });
-    }
-    /**
-     * Creates a product and its backing inventory item.
-     *
-     * The new item starts with zero on-hand inventory, and its pricing defaults to
-     * zero rates in the category's base unit unless `unit_price` or `unit_cost` is
-     * provided.
-     *
-     * Only products of type `sale` appear in the product list and export; products
-     * created with any other type are still usable on orders and invoices but must be
-     * retrieved by ID.
-     *
-     * This endpoint requires the permission: `items:create`.
-     *
-     * @example
-     * ```ts
-     * const product = await client.catalog.products.create({
-     *   category_id: 'ic_d06g9c6yc9ck',
-     *   sku: 'ALM-2024-1001',
-     *   type: 'sale',
-     *   attribute_ids: ['at_rf1w295jt5ia'],
-     *   description:
-     *     'Wireless barcode scanner with charging cradle',
-     *   notes:
-     *     'Ships with a 2-year warranty; register for extended coverage.',
-     *   portal_visibility: 'visible',
-     *   product_line_id: 'pdln_k9bnlgvxhxjh',
-     *   unit_cost: {
-     *     value: '112.00',
-     *     numerator_unit_id: 'un_82bd37dae5po',
-     *     denominator_unit_id: 'un_82bd37dae5po',
-     *   },
-     *   unit_price: {
-     *     value: '199.00',
-     *     numerator_unit_id: 'un_82bd37dae5po',
-     *     denominator_unit_id: 'un_82bd37dae5po',
-     *   },
-     * });
-     * ```
-     */
-    create(params, options) {
-        const { include, ...body } = params;
-        return this._client.post('/v1/catalog/products', { query: { include }, body, ...options });
-    }
-    /**
-     * Partially updates a product.
-     *
-     * `sku`, `description`, `notes`, and `unit_price` all live on the product's
-     * backing item and are written there, so the change is visible on the item as
-     * well. The product line is reassigned through its own endpoint, and the product
-     * type cannot be changed after creation.
-     *
-     * This endpoint requires the permission: `items:update`.
-     *
-     * @example
-     * ```ts
-     * const product = await client.catalog.products.update(
-     *   'pd_07oe0r7adh2w',
-     *   {
-     *     description:
-     *       'Wireless barcode scanner with charging cradle (v2)',
-     *     notes:
-     *       'Firmware 2.1 improves Bluetooth pairing reliability.',
-     *     portal_visibility: 'visible',
-     *     sku: 'SKU-002',
-     *     unit_price: {
-     *       value: '219.00',
-     *       numerator_unit_id: 'un_82bd37dae5po',
-     *       denominator_unit_id: 'un_82bd37dae5po',
-     *     },
-     *   },
-     * );
-     * ```
-     */
-    update(id, params = {}, options) {
-        const { include, ...body } = params ?? {};
-        return this._client.patch((0, path_1.path) `/v1/catalog/products/${id}`, { query: { include }, body, ...options });
-    }
-    /**
-     * Soft-deletes a product and returns it as it stood at deletion.
-     *
-     * Deletion marks the product's backing item as deleted, so the item and its
-     * inventory drop out of catalog and inventory listings too. Deleting the same
-     * product again returns an error saying it has already been deleted.
-     *
-     * This endpoint requires the permission: `items:delete`.
-     *
-     * @example
-     * ```ts
-     * const product = await client.catalog.products.delete(
-     *   'pd_07oe0r7adh2w',
-     * );
-     * ```
-     */
-    delete(id, params = {}, options) {
-        const { include } = params ?? {};
-        return this._client.delete((0, path_1.path) `/v1/catalog/products/${id}`, { query: { include }, ...options });
-    }
-    /**
-     * Moves a product to a different product line.
-     *
-     * The target product line must be one your account owns or a shared system line;
-     * anything else fails as not found. Because customer accounts are granted access
-     * to whole product lines, moving a product changes which buyers can see and order
-     * it in the customer portal, and which default commission and freight policies
-     * apply to it.
-     *
-     * This endpoint requires the permission: `items:update`.
-     *
-     * @example
-     * ```ts
-     * const product =
-     *   await client.catalog.products.changeProductLine(
-     *     'pdln_k9bnlgvxhxjh',
-     *     { id: 'pd_07oe0r7adh2w' },
-     *   );
-     * ```
-     */
-    changeProductLine(productLineID, params, options) {
-        const { id, include } = params;
-        return this._client.put((0, path_1.path) `/v1/catalog/products/${id}/product-line/${productLineID}`, {
-            query: { include },
-            ...options,
-        });
-    }
-}
-exports.Products = Products;
+const tslib_1 = require("../../internal/tslib.js");
+tslib_1.__exportStar(require("./products/index.js"), exports);
 //# sourceMappingURL=products.js.map

package/resources/catalog/products.js.map

@@ -1 +1 @@
-{"version":3,"file":"products.js","sourceRoot":"","sources":["../../src/resources/catalog/products.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAOlD,uDAAiD;AAEjD;;GAEG;AACH,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,CAAC,QAA8C,EAAE,EAAE,OAAwB;QAC7E,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,QAAQ,CACN,EAAU,EACV,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,wBAAwB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,MAAM,CAAC,MAA2B,EAAE,OAAwB;QAC1D,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,MAAM,CACJ,EAAU,EACV,SAAiD,EAAE,EACnD,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,wBAAwB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxG,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CACJ,EAAU,EACV,SAAiD,EAAE,EACnD,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,wBAAwB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAAiB,CACf,aAAqB,EACrB,MAAsC,EACtC,OAAwB;QAExB,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,wBAAwB,EAAE,iBAAiB,aAAa,EAAE,EAAE;YACtF,KAAK,EAAE,EAAE,OAAO,EAAE;YAClB,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF;AA1LD,4BA0LC"}
+{"version":3,"file":"products.js","sourceRoot":"","sources":["../../src/resources/catalog/products.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8DAAiC"}

package/resources/catalog/products.mjs

@@ -1,173 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-import { APIResource } from "../../core/resource.mjs";
-import { path } from "../../internal/utils/path.mjs";
-/**
- * List and manage products.
- */
-export class Products extends APIResource {
-    /**
-     * Returns a paginated list of products for the target account, newest first.
-     *
-     * Only products of type `sale` are listed — service, shipping, credit, return, and
-     * tax products are excluded and must be retrieved by ID. A request made by a
-     * customer-portal buyer always returns portal-visible products only, and its
-     * `customer_ids` filter is replaced with the buyer's own account, so the results
-     * reflect what that account is entitled to buy.
-     *
-     * The `q` search term is matched against the SKU and description of each product's
-     * item; when it is supplied, products whose SKU matches are returned ahead of the
-     * rest.
-     *
-     * This endpoint requires the permissions: `items:read`, `customers:read`,
-     * `suppliers:read`.
-     *
-     * @example
-     * ```ts
-     * const listProduct = await client.catalog.products.list();
-     * ```
-     */
-    list(query = {}, options) {
-        return this._client.get('/v1/catalog/products', { query, ...options });
-    }
-    /**
-     * Returns a product by ID.
-     *
-     * This endpoint requires the permissions: `items:read`, `customers:read`,
-     * `suppliers:read`.
-     *
-     * @example
-     * ```ts
-     * const product = await client.catalog.products.retrieve(
-     *   'pd_07oe0r7adh2w',
-     * );
-     * ```
-     */
-    retrieve(id, query = {}, options) {
-        return this._client.get(path `/v1/catalog/products/${id}`, { query, ...options });
-    }
-    /**
-     * Creates a product and its backing inventory item.
-     *
-     * The new item starts with zero on-hand inventory, and its pricing defaults to
-     * zero rates in the category's base unit unless `unit_price` or `unit_cost` is
-     * provided.
-     *
-     * Only products of type `sale` appear in the product list and export; products
-     * created with any other type are still usable on orders and invoices but must be
-     * retrieved by ID.
-     *
-     * This endpoint requires the permission: `items:create`.
-     *
-     * @example
-     * ```ts
-     * const product = await client.catalog.products.create({
-     *   category_id: 'ic_d06g9c6yc9ck',
-     *   sku: 'ALM-2024-1001',
-     *   type: 'sale',
-     *   attribute_ids: ['at_rf1w295jt5ia'],
-     *   description:
-     *     'Wireless barcode scanner with charging cradle',
-     *   notes:
-     *     'Ships with a 2-year warranty; register for extended coverage.',
-     *   portal_visibility: 'visible',
-     *   product_line_id: 'pdln_k9bnlgvxhxjh',
-     *   unit_cost: {
-     *     value: '112.00',
-     *     numerator_unit_id: 'un_82bd37dae5po',
-     *     denominator_unit_id: 'un_82bd37dae5po',
-     *   },
-     *   unit_price: {
-     *     value: '199.00',
-     *     numerator_unit_id: 'un_82bd37dae5po',
-     *     denominator_unit_id: 'un_82bd37dae5po',
-     *   },
-     * });
-     * ```
-     */
-    create(params, options) {
-        const { include, ...body } = params;
-        return this._client.post('/v1/catalog/products', { query: { include }, body, ...options });
-    }
-    /**
-     * Partially updates a product.
-     *
-     * `sku`, `description`, `notes`, and `unit_price` all live on the product's
-     * backing item and are written there, so the change is visible on the item as
-     * well. The product line is reassigned through its own endpoint, and the product
-     * type cannot be changed after creation.
-     *
-     * This endpoint requires the permission: `items:update`.
-     *
-     * @example
-     * ```ts
-     * const product = await client.catalog.products.update(
-     *   'pd_07oe0r7adh2w',
-     *   {
-     *     description:
-     *       'Wireless barcode scanner with charging cradle (v2)',
-     *     notes:
-     *       'Firmware 2.1 improves Bluetooth pairing reliability.',
-     *     portal_visibility: 'visible',
-     *     sku: 'SKU-002',
-     *     unit_price: {
-     *       value: '219.00',
-     *       numerator_unit_id: 'un_82bd37dae5po',
-     *       denominator_unit_id: 'un_82bd37dae5po',
-     *     },
-     *   },
-     * );
-     * ```
-     */
-    update(id, params = {}, options) {
-        const { include, ...body } = params ?? {};
-        return this._client.patch(path `/v1/catalog/products/${id}`, { query: { include }, body, ...options });
-    }
-    /**
-     * Soft-deletes a product and returns it as it stood at deletion.
-     *
-     * Deletion marks the product's backing item as deleted, so the item and its
-     * inventory drop out of catalog and inventory listings too. Deleting the same
-     * product again returns an error saying it has already been deleted.
-     *
-     * This endpoint requires the permission: `items:delete`.
-     *
-     * @example
-     * ```ts
-     * const product = await client.catalog.products.delete(
-     *   'pd_07oe0r7adh2w',
-     * );
-     * ```
-     */
-    delete(id, params = {}, options) {
-        const { include } = params ?? {};
-        return this._client.delete(path `/v1/catalog/products/${id}`, { query: { include }, ...options });
-    }
-    /**
-     * Moves a product to a different product line.
-     *
-     * The target product line must be one your account owns or a shared system line;
-     * anything else fails as not found. Because customer accounts are granted access
-     * to whole product lines, moving a product changes which buyers can see and order
-     * it in the customer portal, and which default commission and freight policies
-     * apply to it.
-     *
-     * This endpoint requires the permission: `items:update`.
-     *
-     * @example
-     * ```ts
-     * const product =
-     *   await client.catalog.products.changeProductLine(
-     *     'pdln_k9bnlgvxhxjh',
-     *     { id: 'pd_07oe0r7adh2w' },
-     *   );
-     * ```
-     */
-    changeProductLine(productLineID, params, options) {
-        const { id, include } = params;
-        return this._client.put(path `/v1/catalog/products/${id}/product-line/${productLineID}`, {
-            query: { include },
-            ...options,
-        });
-    }
-}
+export * from "./products/index.mjs";
 //# sourceMappingURL=products.mjs.map

package/resources/catalog/products.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"products.mjs","sourceRoot":"","sources":["../../src/resources/catalog/products.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAOf,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,CAAC,QAA8C,EAAE,EAAE,OAAwB;QAC7E,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,QAAQ,CACN,EAAU,EACV,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,wBAAwB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,MAAM,CAAC,MAA2B,EAAE,OAAwB;QAC1D,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,MAAM,CACJ,EAAU,EACV,SAAiD,EAAE,EACnD,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,wBAAwB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxG,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CACJ,EAAU,EACV,SAAiD,EAAE,EACnD,OAAwB;QAExB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,wBAAwB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAAiB,CACf,aAAqB,EACrB,MAAsC,EACtC,OAAwB;QAExB,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,wBAAwB,EAAE,iBAAiB,aAAa,EAAE,EAAE;YACtF,KAAK,EAAE,EAAE,OAAO,EAAE;YAClB,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"products.mjs","sourceRoot":"","sources":["../../src/resources/catalog/products.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/catalog/properties/actions.d.mts

@@ -0,0 +1,86 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as JobsAPI from "../../core/jobs.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+/**
+ * List and manage properties and their attributes.
+ */
+export declare class Actions extends APIResource {
+    /**
+     * Creates or updates multiple properties and their attributes for the account,
+     * matched by name (case-insensitive), then writes asynchronously — 202 with a job
+     * to poll.
+     *
+     * @example
+     * ```ts
+     * const job =
+     *   await client.catalog.properties.actions.bulkUpsert({
+     *     properties: [
+     *       {
+     *         name: 'Color',
+     *         attributes: [{ value: 'Premium', color: 'red' }],
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    bulkUpsert(body: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job>;
+}
+/**
+ * carries the properties to bulk upsert
+ */
+export interface BulkUpsertPropertiesRequest {
+    /**
+     * Properties to create or update, matched by name (case-insensitive) within the
+     * account.
+     */
+    properties: Array<UpsertPropertyInput>;
+}
+/**
+ * carries one attribute under a bulk-upserted property
+ */
+export interface UpsertPropertyAttributeInput {
+    /**
+     * The selectable value this attribute represents, such as `Red`.
+     *
+     * Must be unique across all attributes in the account, not just within the
+     * property. Leading and trailing whitespace is trimmed.
+     */
+    value: string;
+    /**
+     * Swatch color used to display this attribute in the UI.
+     *
+     * When omitted, one of the nine named colors is assigned. Ignored for a value the
+     * property already defines.
+     */
+    color?: 'blue' | 'brown' | 'default' | 'gray' | 'green' | 'orange' | 'pink' | 'purple' | 'red' | 'yellow';
+}
+/**
+ * carries one property in a bulk upsert
+ */
+export interface UpsertPropertyInput {
+    /**
+     * The selectable values to define under this property, in the order they should be
+     * arranged.
+     *
+     * Additive — values the property already defines are left as they stand, and none
+     * are removed. New values are appended after the existing ones.
+     */
+    attributes: Array<UpsertPropertyAttributeInput>;
+    /**
+     * Display name of the property, used to match existing properties within the
+     * account.
+     */
+    name: string;
+}
+export interface ActionBulkUpsertParams {
+    /**
+     * Properties to create or update, matched by name (case-insensitive) within the
+     * account.
+     */
+    properties: Array<UpsertPropertyInput>;
+}
+export declare namespace Actions {
+    export { type BulkUpsertPropertiesRequest as BulkUpsertPropertiesRequest, type UpsertPropertyAttributeInput as UpsertPropertyAttributeInput, type UpsertPropertyInput as UpsertPropertyInput, type ActionBulkUpsertParams as ActionBulkUpsertParams, };
+}
+//# sourceMappingURL=actions.d.mts.map

package/resources/catalog/properties/actions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.mts","sourceRoot":"","sources":["../../../src/resources/catalog/properties/actions.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,OAAO;OACZ,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC;CAG5F;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,UAAU,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;CAC3G;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,UAAU,EAAE,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAEhD;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,UAAU,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;CACxC;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,4BAA4B,IAAI,4BAA4B,EACjE,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/catalog/properties/actions.d.ts

@@ -0,0 +1,86 @@
+import { APIResource } from "../../../core/resource.js";
+import * as JobsAPI from "../../core/jobs.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * List and manage properties and their attributes.
+ */
+export declare class Actions extends APIResource {
+    /**
+     * Creates or updates multiple properties and their attributes for the account,
+     * matched by name (case-insensitive), then writes asynchronously — 202 with a job
+     * to poll.
+     *
+     * @example
+     * ```ts
+     * const job =
+     *   await client.catalog.properties.actions.bulkUpsert({
+     *     properties: [
+     *       {
+     *         name: 'Color',
+     *         attributes: [{ value: 'Premium', color: 'red' }],
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    bulkUpsert(body: ActionBulkUpsertParams, options?: RequestOptions): APIPromise<JobsAPI.Job>;
+}
+/**
+ * carries the properties to bulk upsert
+ */
+export interface BulkUpsertPropertiesRequest {
+    /**
+     * Properties to create or update, matched by name (case-insensitive) within the
+     * account.
+     */
+    properties: Array<UpsertPropertyInput>;
+}
+/**
+ * carries one attribute under a bulk-upserted property
+ */
+export interface UpsertPropertyAttributeInput {
+    /**
+     * The selectable value this attribute represents, such as `Red`.
+     *
+     * Must be unique across all attributes in the account, not just within the
+     * property. Leading and trailing whitespace is trimmed.
+     */
+    value: string;
+    /**
+     * Swatch color used to display this attribute in the UI.
+     *
+     * When omitted, one of the nine named colors is assigned. Ignored for a value the
+     * property already defines.
+     */
+    color?: 'blue' | 'brown' | 'default' | 'gray' | 'green' | 'orange' | 'pink' | 'purple' | 'red' | 'yellow';
+}
+/**
+ * carries one property in a bulk upsert
+ */
+export interface UpsertPropertyInput {
+    /**
+     * The selectable values to define under this property, in the order they should be
+     * arranged.
+     *
+     * Additive — values the property already defines are left as they stand, and none
+     * are removed. New values are appended after the existing ones.
+     */
+    attributes: Array<UpsertPropertyAttributeInput>;
+    /**
+     * Display name of the property, used to match existing properties within the
+     * account.
+     */
+    name: string;
+}
+export interface ActionBulkUpsertParams {
+    /**
+     * Properties to create or update, matched by name (case-insensitive) within the
+     * account.
+     */
+    properties: Array<UpsertPropertyInput>;
+}
+export declare namespace Actions {
+    export { type BulkUpsertPropertiesRequest as BulkUpsertPropertiesRequest, type UpsertPropertyAttributeInput as UpsertPropertyAttributeInput, type UpsertPropertyInput as UpsertPropertyInput, type ActionBulkUpsertParams as ActionBulkUpsertParams, };
+}
+//# sourceMappingURL=actions.d.ts.map

package/resources/catalog/properties/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/resources/catalog/properties/actions.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,OAAO;OACZ,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC;CAG5F;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,UAAU,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;CAC3G;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,UAAU,EAAE,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAEhD;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,UAAU,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;CACxC;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,4BAA4B,IAAI,4BAA4B,EACjE,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/catalog/properties/actions.js

@@ -0,0 +1,33 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Actions = void 0;
+const resource_1 = require("../../../core/resource.js");
+/**
+ * List and manage properties and their attributes.
+ */
+class Actions extends resource_1.APIResource {
+    /**
+     * Creates or updates multiple properties and their attributes for the account,
+     * matched by name (case-insensitive), then writes asynchronously — 202 with a job
+     * to poll.
+     *
+     * @example
+     * ```ts
+     * const job =
+     *   await client.catalog.properties.actions.bulkUpsert({
+     *     properties: [
+     *       {
+     *         name: 'Color',
+     *         attributes: [{ value: 'Premium', color: 'red' }],
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    bulkUpsert(body, options) {
+        return this._client.post('/v1/catalog/properties/actions/bulk-upsert', { body, ...options });
+    }
+}
+exports.Actions = Actions;
+//# sourceMappingURL=actions.js.map

package/resources/catalog/properties/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../src/resources/catalog/properties/actions.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAKrD;;GAEG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CAAC,IAA4B,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;CACF;AAtBD,0BAsBC"}

package/resources/catalog/properties/actions.mjs

@@ -0,0 +1,29 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+/**
+ * List and manage properties and their attributes.
+ */
+export class Actions extends APIResource {
+    /**
+     * Creates or updates multiple properties and their attributes for the account,
+     * matched by name (case-insensitive), then writes asynchronously — 202 with a job
+     * to poll.
+     *
+     * @example
+     * ```ts
+     * const job =
+     *   await client.catalog.properties.actions.bulkUpsert({
+     *     properties: [
+     *       {
+     *         name: 'Color',
+     *         attributes: [{ value: 'Premium', color: 'red' }],
+     *       },
+     *     ],
+     *   });
+     * ```
+     */
+    bulkUpsert(body, options) {
+        return this._client.post('/v1/catalog/properties/actions/bulk-upsert', { body, ...options });
+    }
+}
+//# sourceMappingURL=actions.mjs.map

package/resources/catalog/properties/actions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.mjs","sourceRoot":"","sources":["../../../src/resources/catalog/properties/actions.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAKtB;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CAAC,IAA4B,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;CACF"}

package/resources/catalog/properties/index.d.mts

@@ -1,3 +1,4 @@
+export { Actions, type BulkUpsertPropertiesRequest, type UpsertPropertyAttributeInput, type UpsertPropertyInput, type ActionBulkUpsertParams, } from "./actions.mjs";
 export { Attributes, type CreateAttributeRequest, type UpdateAttributeRequest, type AttributeDeleteResponse, type AttributeListParams, type AttributeRetrieveParams, type AttributeCreateParams, type AttributeUpdateParams, type AttributeDeleteParams, } from "./attributes.mjs";
 export { Properties, type Attribute, type CreatePropertyRequest, type ListAttribute, type ListProperty, type Property, type UpdatePropertyRequest, type PropertyDeleteResponse, type PropertyListParams, type PropertyRetrieveParams, type PropertyCreateParams, type PropertyUpdateParams, } from "./properties.mjs";
 //# sourceMappingURL=index.d.mts.map

package/resources/catalog/properties/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/resources/catalog/properties/index.ts"],"names":[],"mappings":"OAEO,EACL,UAAU,EACV,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B;OACM,EACL,UAAU,EACV,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/resources/catalog/properties/index.ts"],"names":[],"mappings":"OAEO,EACL,OAAO,EACP,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EACL,UAAU,EACV,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B;OACM,EACL,UAAU,EACV,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B"}

package/resources/catalog/properties/index.d.ts

@@ -1,3 +1,4 @@
+export { Actions, type BulkUpsertPropertiesRequest, type UpsertPropertyAttributeInput, type UpsertPropertyInput, type ActionBulkUpsertParams, } from "./actions.js";
 export { Attributes, type CreateAttributeRequest, type UpdateAttributeRequest, type AttributeDeleteResponse, type AttributeListParams, type AttributeRetrieveParams, type AttributeCreateParams, type AttributeUpdateParams, type AttributeDeleteParams, } from "./attributes.js";
 export { Properties, type Attribute, type CreatePropertyRequest, type ListAttribute, type ListProperty, type Property, type UpdatePropertyRequest, type PropertyDeleteResponse, type PropertyListParams, type PropertyRetrieveParams, type PropertyCreateParams, type PropertyUpdateParams, } from "./properties.js";
 //# sourceMappingURL=index.d.ts.map

package/resources/catalog/properties/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/catalog/properties/index.ts"],"names":[],"mappings":"OAEO,EACL,UAAU,EACV,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B;OACM,EACL,UAAU,EACV,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/catalog/properties/index.ts"],"names":[],"mappings":"OAEO,EACL,OAAO,EACP,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EACL,UAAU,EACV,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B;OACM,EACL,UAAU,EACV,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B"}

package/resources/catalog/properties/index.js

@@ -1,7 +1,9 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Properties = exports.Attributes = void 0;
+exports.Properties = exports.Attributes = exports.Actions = void 0;
+var actions_1 = require("./actions.js");
+Object.defineProperty(exports, "Actions", { enumerable: true, get: function () { return actions_1.Actions; } });
 var attributes_1 = require("./attributes.js");
 Object.defineProperty(exports, "Attributes", { enumerable: true, get: function () { return attributes_1.Attributes; } });
 var properties_1 = require("./properties.js");

package/resources/catalog/properties/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/catalog/properties/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8CAUsB;AATpB,wGAAA,UAAU,OAAA;AAUZ,8CAasB;AAZpB,wGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/catalog/properties/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wCAMmB;AALjB,kGAAA,OAAO,OAAA;AAMT,8CAUsB;AATpB,wGAAA,UAAU,OAAA;AAUZ,8CAasB;AAZpB,wGAAA,UAAU,OAAA"}