mdd-printful-client 0.2.1

package/resources/shipping.d.mts

@@ -0,0 +1,215 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class Shipping extends APIResource {
+    /**
+     * Returns available shipping options and rates for the given list of products.
+     *
+     * **Recipient Address Requirements:**
+     *
+     * - Only `country_code` is required in the recipient object
+     * - `state_code` is only required for United States (US), Australia (AU), and
+     *   Canada (CA)
+     * - All other recipient fields are optional
+     *
+     * **Note:** Providing more address information may produce more precise results
+     * and more shipping options. While only the country code is required, including
+     * additional details like city, postal code, and state/province can help return
+     * more accurate shipping rates and additional delivery options.
+     *
+     * **Important:** Shipping rates returned by this endpoint may differ from those
+     * returned by `/orders/estimate-costs` if your store has
+     * [store shipping settings](https://www.printful.com/dashboard/settings/store-shipping)
+     * configured.
+     *
+     * The `/orders/estimate-costs` endpoint automatically applies your store's
+     * shipping settings (including shipping markup), while this endpoint applies them
+     * **only if the store shipping settings are enabled**. To ensure consistent
+     * results between both endpoints, make sure your store shipping settings are
+     * enabled and properly configured in your Printful Dashboard.
+     *
+     * @example
+     * ```ts
+     * const response = await client.shipping.calculateRates({
+     *   items: [{ quantity: 10 }],
+     *   recipient: { country_code: 'US' },
+     * });
+     * ```
+     */
+    calculateRates(params: ShippingCalculateRatesParams, options?: RequestOptions): APIPromise<ShippingCalculateRatesResponse>;
+}
+export interface ShippingCalculateRatesResponse {
+    /**
+     * Response status code `200`
+     */
+    code?: number;
+    result?: Array<ShippingCalculateRatesResponse.Result>;
+}
+export declare namespace ShippingCalculateRatesResponse {
+    /**
+     * Shipping information
+     */
+    interface Result {
+        /**
+         * Shipping method ID
+         */
+        id?: string;
+        /**
+         * Currency code in which the rate is returned
+         */
+        currency?: string;
+        /**
+         * Estimated maximum delivery date. <span style="color:orange">Warning! This value
+         * may not be present in response.</span>
+         */
+        maxDeliveryDate?: number;
+        /**
+         * Estimated maximum delivery days. <span style="color:orange">Warning! This value
+         * may not be present in response.</span>
+         */
+        maxDeliveryDays?: number;
+        /**
+         * Estimated minimum delivery date. <span style="color:orange">Warning! This value
+         * may not be present in response.</span>
+         */
+        minDeliveryDate?: number;
+        /**
+         * Estimated minimum delivery days. <span style="color:orange">Warning! This value
+         * may not be present in response.</span>
+         */
+        minDeliveryDays?: number;
+        /**
+         * Shipping method name
+         */
+        name?: string;
+        /**
+         * Shipping rate
+         */
+        rate?: string;
+    }
+}
+export interface ShippingCalculateRatesParams {
+    /**
+     * Body param: Array of order items
+     */
+    items: Array<ShippingCalculateRatesParams.Item>;
+    /**
+     * Body param: Recipient address information for shipping rate calculation.
+     *
+     * **Required fields:**
+     *
+     * - `country_code`: Always required
+     *
+     * **Conditionally required fields:**
+     *
+     * - `state_code`: Required for United States (US), Australia (AU), and Canada (CA)
+     *
+     * **Optional fields:**
+     *
+     * - All other fields are optional but providing more information may produce more
+     *   precise results and more shipping options.
+     */
+    recipient: ShippingCalculateRatesParams.Recipient;
+    /**
+     * Body param: 3 letter currency code (optional), required if the rates need to be
+     * converted to another currency instead of store default currency
+     */
+    currency?: string;
+    /**
+     * Body param: Locale in which shipping rate names will be returned. Available
+     * options: `en_US` (default), `es_ES`
+     */
+    locale?: string;
+    /**
+     * Header param: Use this to specify which store you want to use (required only for
+     * account level token).
+     *
+     * The store IDs can be retrieved with the
+     * [Get basic information about stores](#tag/Store-Information-API/operation/getStores)
+     * endpoint.
+     */
+    'X-PF-Store-Id'?: string;
+}
+export declare namespace ShippingCalculateRatesParams {
+    /**
+     * Order item information
+     */
+    interface Item {
+        /**
+         * Number of items ordered
+         */
+        quantity: number;
+        /**
+         * External Variant ID of the item ordered. See
+         * [Ecommerce Platform Sync API](#tag/Ecommerce-Platform-Sync-API).
+         * <span style="color:red">\*Required if no other IDs given</span>
+         */
+        external_variant_id?: string;
+        /**
+         * Item retail value - optional but can help to properly calculate
+         */
+        value?: string;
+        /**
+         * Catalog Variant ID of the item ordered. See [Catalog API](#tag/Catalog-API)
+         * <span style="color:red">\*Required if no other IDs given</span>
+         */
+        variant_id?: string;
+        /**
+         * Warehouse product variant ID of the item ordered. See
+         * [Warehouse Products API](#tag/Warehouse-Products-API).
+         * <span style="color:red">\*Required if no other IDs given</span>
+         */
+        warehouse_product_variant_id?: string;
+    }
+    /**
+     * Recipient address information for shipping rate calculation.
+     *
+     * **Required fields:**
+     *
+     * - `country_code`: Always required
+     *
+     * **Conditionally required fields:**
+     *
+     * - `state_code`: Required for United States (US), Australia (AU), and Canada (CA)
+     *
+     * **Optional fields:**
+     *
+     * - All other fields are optional but providing more information may produce more
+     *   precise results and more shipping options.
+     */
+    interface Recipient {
+        /**
+         * Two-letter country code (ISO 3166-1 alpha-2)
+         */
+        country_code: string;
+        /**
+         * Address line 1
+         */
+        address1?: string;
+        /**
+         * Address line 2
+         */
+        address2?: string | null;
+        /**
+         * City
+         */
+        city?: string;
+        /**
+         * Phone number
+         */
+        phone?: string | null;
+        /**
+         * State/province code. Required for United States (US), Australia (AU), and Canada
+         * (CA). For other countries, this field is optional.
+         */
+        state_code?: string | null;
+        /**
+         * ZIP or postal code
+         */
+        zip?: string | null;
+    }
+}
+export declare namespace Shipping {
+    export { type ShippingCalculateRatesResponse as ShippingCalculateRatesResponse, type ShippingCalculateRatesParams as ShippingCalculateRatesParams, };
+}
+//# sourceMappingURL=shipping.d.mts.map

package/resources/shipping.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipping.d.mts","sourceRoot":"","sources":["../src/resources/shipping.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,cAAc,CACZ,MAAM,EAAE,4BAA4B,EACpC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAY9C;AAED,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,MAAM,CAAC,EAAE,KAAK,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC;CACvD;AAED,yBAAiB,8BAA8B,CAAC;IAC9C;;OAEG;IACH,UAAiB,MAAM;QACrB;;WAEG;QACH,EAAE,CAAC,EAAE,MAAM,CAAC;QAEZ;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB;;;WAGG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB;;;WAGG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB;;;WAGG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB;;;WAGG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;CACF;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;;;;;;;;;;;OAeG;IACH,SAAS,EAAE,4BAA4B,CAAC,SAAS,CAAC;IAElD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,yBAAiB,4BAA4B,CAAC;IAC5C;;OAEG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;;WAIG;QACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAE7B;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf;;;WAGG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB;;;;WAIG;QACH,4BAA4B,CAAC,EAAE,MAAM,CAAC;KACvC;IAED;;;;;;;;;;;;;;;OAeG;IACH,UAAiB,SAAS;QACxB;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEzB;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEtB;;;WAGG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE3B;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,4BAA4B,IAAI,4BAA4B,GAClE,CAAC;CACH"}

package/resources/shipping.d.ts

@@ -0,0 +1,215 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Shipping extends APIResource {
+    /**
+     * Returns available shipping options and rates for the given list of products.
+     *
+     * **Recipient Address Requirements:**
+     *
+     * - Only `country_code` is required in the recipient object
+     * - `state_code` is only required for United States (US), Australia (AU), and
+     *   Canada (CA)
+     * - All other recipient fields are optional
+     *
+     * **Note:** Providing more address information may produce more precise results
+     * and more shipping options. While only the country code is required, including
+     * additional details like city, postal code, and state/province can help return
+     * more accurate shipping rates and additional delivery options.
+     *
+     * **Important:** Shipping rates returned by this endpoint may differ from those
+     * returned by `/orders/estimate-costs` if your store has
+     * [store shipping settings](https://www.printful.com/dashboard/settings/store-shipping)
+     * configured.
+     *
+     * The `/orders/estimate-costs` endpoint automatically applies your store's
+     * shipping settings (including shipping markup), while this endpoint applies them
+     * **only if the store shipping settings are enabled**. To ensure consistent
+     * results between both endpoints, make sure your store shipping settings are
+     * enabled and properly configured in your Printful Dashboard.
+     *
+     * @example
+     * ```ts
+     * const response = await client.shipping.calculateRates({
+     *   items: [{ quantity: 10 }],
+     *   recipient: { country_code: 'US' },
+     * });
+     * ```
+     */
+    calculateRates(params: ShippingCalculateRatesParams, options?: RequestOptions): APIPromise<ShippingCalculateRatesResponse>;
+}
+export interface ShippingCalculateRatesResponse {
+    /**
+     * Response status code `200`
+     */
+    code?: number;
+    result?: Array<ShippingCalculateRatesResponse.Result>;
+}
+export declare namespace ShippingCalculateRatesResponse {
+    /**
+     * Shipping information
+     */
+    interface Result {
+        /**
+         * Shipping method ID
+         */
+        id?: string;
+        /**
+         * Currency code in which the rate is returned
+         */
+        currency?: string;
+        /**
+         * Estimated maximum delivery date. <span style="color:orange">Warning! This value
+         * may not be present in response.</span>
+         */
+        maxDeliveryDate?: number;
+        /**
+         * Estimated maximum delivery days. <span style="color:orange">Warning! This value
+         * may not be present in response.</span>
+         */
+        maxDeliveryDays?: number;
+        /**
+         * Estimated minimum delivery date. <span style="color:orange">Warning! This value
+         * may not be present in response.</span>
+         */
+        minDeliveryDate?: number;
+        /**
+         * Estimated minimum delivery days. <span style="color:orange">Warning! This value
+         * may not be present in response.</span>
+         */
+        minDeliveryDays?: number;
+        /**
+         * Shipping method name
+         */
+        name?: string;
+        /**
+         * Shipping rate
+         */
+        rate?: string;
+    }
+}
+export interface ShippingCalculateRatesParams {
+    /**
+     * Body param: Array of order items
+     */
+    items: Array<ShippingCalculateRatesParams.Item>;
+    /**
+     * Body param: Recipient address information for shipping rate calculation.
+     *
+     * **Required fields:**
+     *
+     * - `country_code`: Always required
+     *
+     * **Conditionally required fields:**
+     *
+     * - `state_code`: Required for United States (US), Australia (AU), and Canada (CA)
+     *
+     * **Optional fields:**
+     *
+     * - All other fields are optional but providing more information may produce more
+     *   precise results and more shipping options.
+     */
+    recipient: ShippingCalculateRatesParams.Recipient;
+    /**
+     * Body param: 3 letter currency code (optional), required if the rates need to be
+     * converted to another currency instead of store default currency
+     */
+    currency?: string;
+    /**
+     * Body param: Locale in which shipping rate names will be returned. Available
+     * options: `en_US` (default), `es_ES`
+     */
+    locale?: string;
+    /**
+     * Header param: Use this to specify which store you want to use (required only for
+     * account level token).
+     *
+     * The store IDs can be retrieved with the
+     * [Get basic information about stores](#tag/Store-Information-API/operation/getStores)
+     * endpoint.
+     */
+    'X-PF-Store-Id'?: string;
+}
+export declare namespace ShippingCalculateRatesParams {
+    /**
+     * Order item information
+     */
+    interface Item {
+        /**
+         * Number of items ordered
+         */
+        quantity: number;
+        /**
+         * External Variant ID of the item ordered. See
+         * [Ecommerce Platform Sync API](#tag/Ecommerce-Platform-Sync-API).
+         * <span style="color:red">\*Required if no other IDs given</span>
+         */
+        external_variant_id?: string;
+        /**
+         * Item retail value - optional but can help to properly calculate
+         */
+        value?: string;
+        /**
+         * Catalog Variant ID of the item ordered. See [Catalog API](#tag/Catalog-API)
+         * <span style="color:red">\*Required if no other IDs given</span>
+         */
+        variant_id?: string;
+        /**
+         * Warehouse product variant ID of the item ordered. See
+         * [Warehouse Products API](#tag/Warehouse-Products-API).
+         * <span style="color:red">\*Required if no other IDs given</span>
+         */
+        warehouse_product_variant_id?: string;
+    }
+    /**
+     * Recipient address information for shipping rate calculation.
+     *
+     * **Required fields:**
+     *
+     * - `country_code`: Always required
+     *
+     * **Conditionally required fields:**
+     *
+     * - `state_code`: Required for United States (US), Australia (AU), and Canada (CA)
+     *
+     * **Optional fields:**
+     *
+     * - All other fields are optional but providing more information may produce more
+     *   precise results and more shipping options.
+     */
+    interface Recipient {
+        /**
+         * Two-letter country code (ISO 3166-1 alpha-2)
+         */
+        country_code: string;
+        /**
+         * Address line 1
+         */
+        address1?: string;
+        /**
+         * Address line 2
+         */
+        address2?: string | null;
+        /**
+         * City
+         */
+        city?: string;
+        /**
+         * Phone number
+         */
+        phone?: string | null;
+        /**
+         * State/province code. Required for United States (US), Australia (AU), and Canada
+         * (CA). For other countries, this field is optional.
+         */
+        state_code?: string | null;
+        /**
+         * ZIP or postal code
+         */
+        zip?: string | null;
+    }
+}
+export declare namespace Shipping {
+    export { type ShippingCalculateRatesResponse as ShippingCalculateRatesResponse, type ShippingCalculateRatesParams as ShippingCalculateRatesParams, };
+}
+//# sourceMappingURL=shipping.d.ts.map

package/resources/shipping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipping.d.ts","sourceRoot":"","sources":["../src/resources/shipping.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,cAAc,CACZ,MAAM,EAAE,4BAA4B,EACpC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAY9C;AAED,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,MAAM,CAAC,EAAE,KAAK,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC;CACvD;AAED,yBAAiB,8BAA8B,CAAC;IAC9C;;OAEG;IACH,UAAiB,MAAM;QACrB;;WAEG;QACH,EAAE,CAAC,EAAE,MAAM,CAAC;QAEZ;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB;;;WAGG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB;;;WAGG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB;;;WAGG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB;;;WAGG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;CACF;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;;;;;;;;;;;OAeG;IACH,SAAS,EAAE,4BAA4B,CAAC,SAAS,CAAC;IAElD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,yBAAiB,4BAA4B,CAAC;IAC5C;;OAEG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;;WAIG;QACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAE7B;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf;;;WAGG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB;;;;WAIG;QACH,4BAA4B,CAAC,EAAE,MAAM,CAAC;KACvC;IAED;;;;;;;;;;;;;;;OAeG;IACH,UAAiB,SAAS;QACxB;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEzB;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEtB;;;WAGG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE3B;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,4BAA4B,IAAI,4BAA4B,GAClE,CAAC;CACH"}

package/resources/shipping.js

@@ -0,0 +1,56 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Shipping = void 0;
+const resource_1 = require("../core/resource.js");
+const headers_1 = require("../internal/headers.js");
+class Shipping extends resource_1.APIResource {
+    /**
+     * Returns available shipping options and rates for the given list of products.
+     *
+     * **Recipient Address Requirements:**
+     *
+     * - Only `country_code` is required in the recipient object
+     * - `state_code` is only required for United States (US), Australia (AU), and
+     *   Canada (CA)
+     * - All other recipient fields are optional
+     *
+     * **Note:** Providing more address information may produce more precise results
+     * and more shipping options. While only the country code is required, including
+     * additional details like city, postal code, and state/province can help return
+     * more accurate shipping rates and additional delivery options.
+     *
+     * **Important:** Shipping rates returned by this endpoint may differ from those
+     * returned by `/orders/estimate-costs` if your store has
+     * [store shipping settings](https://www.printful.com/dashboard/settings/store-shipping)
+     * configured.
+     *
+     * The `/orders/estimate-costs` endpoint automatically applies your store's
+     * shipping settings (including shipping markup), while this endpoint applies them
+     * **only if the store shipping settings are enabled**. To ensure consistent
+     * results between both endpoints, make sure your store shipping settings are
+     * enabled and properly configured in your Printful Dashboard.
+     *
+     * @example
+     * ```ts
+     * const response = await client.shipping.calculateRates({
+     *   items: [{ quantity: 10 }],
+     *   recipient: { country_code: 'US' },
+     * });
+     * ```
+     */
+    calculateRates(params, options) {
+        const { 'X-PF-Store-Id': xPfStoreID, ...body } = params;
+        return this._client.post('/shipping/rates', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(xPfStoreID != null ? { 'X-PF-Store-Id': xPfStoreID } : undefined) },
+                options?.headers,
+            ]),
+            __security: {},
+        });
+    }
+}
+exports.Shipping = Shipping;
+//# sourceMappingURL=shipping.js.map

package/resources/shipping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipping.js","sourceRoot":"","sources":["../src/resources/shipping.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,oDAAmD;AAGnD,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,cAAc,CACZ,MAAoC,EACpC,OAAwB;QAExB,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE;YAC1C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACzE,OAAO,EAAE,OAAO;aACjB,CAAC;YACF,UAAU,EAAE,EAAE;SACf,CAAC,CAAC;IACL,CAAC;CACF;AAlDD,4BAkDC"}

package/resources/shipping.mjs

@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+export class Shipping extends APIResource {
+    /**
+     * Returns available shipping options and rates for the given list of products.
+     *
+     * **Recipient Address Requirements:**
+     *
+     * - Only `country_code` is required in the recipient object
+     * - `state_code` is only required for United States (US), Australia (AU), and
+     *   Canada (CA)
+     * - All other recipient fields are optional
+     *
+     * **Note:** Providing more address information may produce more precise results
+     * and more shipping options. While only the country code is required, including
+     * additional details like city, postal code, and state/province can help return
+     * more accurate shipping rates and additional delivery options.
+     *
+     * **Important:** Shipping rates returned by this endpoint may differ from those
+     * returned by `/orders/estimate-costs` if your store has
+     * [store shipping settings](https://www.printful.com/dashboard/settings/store-shipping)
+     * configured.
+     *
+     * The `/orders/estimate-costs` endpoint automatically applies your store's
+     * shipping settings (including shipping markup), while this endpoint applies them
+     * **only if the store shipping settings are enabled**. To ensure consistent
+     * results between both endpoints, make sure your store shipping settings are
+     * enabled and properly configured in your Printful Dashboard.
+     *
+     * @example
+     * ```ts
+     * const response = await client.shipping.calculateRates({
+     *   items: [{ quantity: 10 }],
+     *   recipient: { country_code: 'US' },
+     * });
+     * ```
+     */
+    calculateRates(params, options) {
+        const { 'X-PF-Store-Id': xPfStoreID, ...body } = params;
+        return this._client.post('/shipping/rates', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(xPfStoreID != null ? { 'X-PF-Store-Id': xPfStoreID } : undefined) },
+                options?.headers,
+            ]),
+            __security: {},
+        });
+    }
+}
+//# sourceMappingURL=shipping.mjs.map

package/resources/shipping.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipping.mjs","sourceRoot":"","sources":["../src/resources/shipping.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAE;AAGvB,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,cAAc,CACZ,MAAoC,EACpC,OAAwB;QAExB,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE;YAC1C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACzE,OAAO,EAAE,OAAO;aACjB,CAAC;YACF,UAAU,EAAE,EAAE;SACf,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources/store/index.d.mts

@@ -0,0 +1,4 @@
+export { Products, type ProductCreateResponse, type ProductRetrieveResponse, type ProductUpdateResponse, type ProductListResponse, type ProductDeleteResponse, type ProductCreateVariantResponse, type ProductCreateParams, type ProductRetrieveParams, type ProductUpdateParams, type ProductListParams, type ProductDeleteParams, type ProductCreateVariantParams, } from "./products.mjs";
+export { Store, type StoreRetrieveResponse, type StoreListResponse, type StoreUpdatePackingSlipResponse, type StoreUpdatePackingSlipParams, } from "./store.mjs";
+export { Variants, type VariantRetrieveResponse, type VariantUpdateResponse, type VariantDeleteResponse, type VariantRetrieveParams, type VariantUpdateParams, type VariantDeleteParams, } from "./variants.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/store/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/store/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC;OACM,EACL,KAAK,EACL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,GAClC;OACM,EACL,QAAQ,EACR,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB"}

package/resources/store/index.d.ts

@@ -0,0 +1,4 @@
+export { Products, type ProductCreateResponse, type ProductRetrieveResponse, type ProductUpdateResponse, type ProductListResponse, type ProductDeleteResponse, type ProductCreateVariantResponse, type ProductCreateParams, type ProductRetrieveParams, type ProductUpdateParams, type ProductListParams, type ProductDeleteParams, type ProductCreateVariantParams, } from "./products.js";
+export { Store, type StoreRetrieveResponse, type StoreListResponse, type StoreUpdatePackingSlipResponse, type StoreUpdatePackingSlipParams, } from "./store.js";
+export { Variants, type VariantRetrieveResponse, type VariantUpdateResponse, type VariantDeleteResponse, type VariantRetrieveParams, type VariantUpdateParams, type VariantDeleteParams, } from "./variants.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/store/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC;OACM,EACL,KAAK,EACL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,GAClC;OACM,EACL,QAAQ,EACR,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB"}

package/resources/store/index.js

@@ -0,0 +1,11 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Variants = exports.Store = exports.Products = void 0;
+var products_1 = require("./products.js");
+Object.defineProperty(exports, "Products", { enumerable: true, get: function () { return products_1.Products; } });
+var store_1 = require("./store.js");
+Object.defineProperty(exports, "Store", { enumerable: true, get: function () { return store_1.Store; } });
+var variants_1 = require("./variants.js");
+Object.defineProperty(exports, "Variants", { enumerable: true, get: function () { return variants_1.Variants; } });
+//# sourceMappingURL=index.js.map

package/resources/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/store/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,0CAcoB;AAblB,oGAAA,QAAQ,OAAA;AAcV,oCAMiB;AALf,8FAAA,KAAK,OAAA;AAMP,0CAQoB;AAPlB,oGAAA,QAAQ,OAAA"}

package/resources/store/index.mjs

@@ -0,0 +1,5 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Products, } from "./products.mjs";
+export { Store, } from "./store.mjs";
+export { Variants, } from "./variants.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/store/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/store/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,QAAQ,GAaT;OACM,EACL,KAAK,GAKN;OACM,EACL,QAAQ,GAOT"}