@poweredbysous/storefront-admin-sdk 4.5.0 → 4.6.0

package/dist/index.d.cts

@@ -2876,6 +2876,28 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/products/{id}/orderable-dates/": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * @description The dates this product can be ordered for, within the location's
+         *     pre-order horizon, as the cart's ``fulfilment-dates`` lists them for
+         *     a basket holding only this product's line, so the storefront can tell
+         *     a customer when a product it hides for their date is available.
+         */
+        get: operations["products_orderable_dates_retrieve"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/products/{id}/suggestions/": {
         parameters: {
             query?: never;
@@ -4423,6 +4445,8 @@ interface components {
             /** @description Whether any of the company's stores ships nationwide. */
             is_enabled: boolean;
         };
+        /** @enum {unknown} */
+        NullEnum: null;
         /** @description Render-ready open/closed badge — see ``availability.get_open_status``. */
         OpenStatus: {
             open: boolean;
@@ -5585,6 +5609,19 @@ interface components {
             /** Format: date-time */
             readonly updated_at: string;
         };
+        /**
+         * @description The dates one product can be ordered for, within the location's
+         *     pre-order horizon (``ProductViewSet.orderable_dates``).
+         */
+        ProductFulfilmentDates: {
+            dates: string[];
+            reason: (components["schemas"]["ProductFulfilmentDatesReasonEnum"] | components["schemas"]["NullEnum"]) | null;
+        };
+        /**
+         * @description * `no_dates` - no_dates
+         * @enum {string}
+         */
+        ProductFulfilmentDatesReasonEnum: "no_dates";
         ProductImage: {
             readonly id: number;
             /** Format: uri */
@@ -20184,6 +20221,8 @@ interface operations {
             query?: {
                 /** @description Delivery destination country as ISO 3166-1 alpha-2 (e.g. NL, BE), used with latitude and longitude. A nationwide carrier that declares per-country service areas only offers its products once the country is known. Case-insensitive; any other value is treated as no country. */
                 country?: string;
+                /** @description The pickup or delivery date the customer has chosen (YYYY-MM-DD). Lists only the products that can be ordered today for that date by their own dates: weekly days, included and excluded dates, and order-until. Whether the store is open that day is the time-slots endpoint's answer, not this filter's. An unreadable value is ignored. */
+                handover_date?: string;
                 /** @description Sort order for products. Use '-popularity' for most popular first. */
                 ordering?: "-popularity" | "-position" | "position";
                 /** @description A page number within the paginated result set. */
@@ -20420,6 +20459,91 @@ interface operations {
             };
         };
     };
+    products_orderable_dates_retrieve: {
+        parameters: {
+            query: {
+                /** @description For type=delivery: the customer's delivery types in order of preference, comma-separated (local_delivery, nationwide_delivery). The product's schedule follows the first of them it offers, the type its cart line would get; without one it follows the delivery types the product offers. */
+                fulfillment_types?: string;
+                /** @description Pickup location id, as the pickup time-slots endpoint takes it. Defaults to the store's active pickup location. */
+                location?: number;
+                /** @description Fulfilment type the dates are for. */
+                type: "delivery" | "pickup";
+                /** @description Language override for translated content. The primary mechanism is the `Accept-Language` header; this query parameter is an override for widget embedding where merchants cannot control browser headers. Defaults to `en`. */
+                lang?: string;
+            };
+            header?: never;
+            path: {
+                /** @description A unique integer value identifying this product. */
+                id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductFulfilmentDates"];
+                };
+            };
+            /** @description Possible error codes: `VALIDATION_ERROR`. Retryable: no. Possible error codes include `VALIDATION_ERROR`. Use `x-error-codes` for machine-readable retryability metadata. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIErrorEnvelope"];
+                };
+            };
+            /** @description Possible error codes include `UNAUTHORIZED`. Use `x-error-codes` for machine-readable retryability metadata. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIErrorEnvelope"];
+                };
+            };
+            /** @description Possible error codes include `FORBIDDEN`. Use `x-error-codes` for machine-readable retryability metadata. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIErrorEnvelope"];
+                };
+            };
+            /** @description Possible error codes: `NOT_FOUND`, `LOCATION_NOT_FOUND`. Retryable: no. Possible error codes include `NOT_FOUND`. Use `x-error-codes` for machine-readable retryability metadata. Possible error codes include `PRODUCT_NOT_FOUND`. Use `x-error-codes` for machine-readable retryability metadata. Possible error codes include `LOCATION_NOT_FOUND`. Use `x-error-codes` for machine-readable retryability metadata. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIErrorEnvelope"];
+                };
+            };
+            /** @description Possible error codes include `RATE_LIMITED`. Use `x-error-codes` for machine-readable retryability metadata. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIErrorEnvelope"];
+                };
+            };
+            /** @description Possible error codes include `INTERNAL_ERROR`. Use `x-error-codes` for machine-readable retryability metadata. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIErrorEnvelope"];
+                };
+            };
+        };
+    };
     products_suggestions_list: {
         parameters: {
             query?: {

package/dist/index.d.ts

@@ -2876,6 +2876,28 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/products/{id}/orderable-dates/": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * @description The dates this product can be ordered for, within the location's
+         *     pre-order horizon, as the cart's ``fulfilment-dates`` lists them for
+         *     a basket holding only this product's line, so the storefront can tell
+         *     a customer when a product it hides for their date is available.
+         */
+        get: operations["products_orderable_dates_retrieve"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/products/{id}/suggestions/": {
         parameters: {
             query?: never;
@@ -4423,6 +4445,8 @@ interface components {
             /** @description Whether any of the company's stores ships nationwide. */
             is_enabled: boolean;
         };
+        /** @enum {unknown} */
+        NullEnum: null;
         /** @description Render-ready open/closed badge — see ``availability.get_open_status``. */
         OpenStatus: {
             open: boolean;
@@ -5585,6 +5609,19 @@ interface components {
             /** Format: date-time */
             readonly updated_at: string;
         };
+        /**
+         * @description The dates one product can be ordered for, within the location's
+         *     pre-order horizon (``ProductViewSet.orderable_dates``).
+         */
+        ProductFulfilmentDates: {
+            dates: string[];
+            reason: (components["schemas"]["ProductFulfilmentDatesReasonEnum"] | components["schemas"]["NullEnum"]) | null;
+        };
+        /**
+         * @description * `no_dates` - no_dates
+         * @enum {string}
+         */
+        ProductFulfilmentDatesReasonEnum: "no_dates";
         ProductImage: {
             readonly id: number;
             /** Format: uri */
@@ -20184,6 +20221,8 @@ interface operations {
             query?: {
                 /** @description Delivery destination country as ISO 3166-1 alpha-2 (e.g. NL, BE), used with latitude and longitude. A nationwide carrier that declares per-country service areas only offers its products once the country is known. Case-insensitive; any other value is treated as no country. */
                 country?: string;
+                /** @description The pickup or delivery date the customer has chosen (YYYY-MM-DD). Lists only the products that can be ordered today for that date by their own dates: weekly days, included and excluded dates, and order-until. Whether the store is open that day is the time-slots endpoint's answer, not this filter's. An unreadable value is ignored. */
+                handover_date?: string;
                 /** @description Sort order for products. Use '-popularity' for most popular first. */
                 ordering?: "-popularity" | "-position" | "position";
                 /** @description A page number within the paginated result set. */
@@ -20420,6 +20459,91 @@ interface operations {
             };
         };
     };
+    products_orderable_dates_retrieve: {
+        parameters: {
+            query: {
+                /** @description For type=delivery: the customer's delivery types in order of preference, comma-separated (local_delivery, nationwide_delivery). The product's schedule follows the first of them it offers, the type its cart line would get; without one it follows the delivery types the product offers. */
+                fulfillment_types?: string;
+                /** @description Pickup location id, as the pickup time-slots endpoint takes it. Defaults to the store's active pickup location. */
+                location?: number;
+                /** @description Fulfilment type the dates are for. */
+                type: "delivery" | "pickup";
+                /** @description Language override for translated content. The primary mechanism is the `Accept-Language` header; this query parameter is an override for widget embedding where merchants cannot control browser headers. Defaults to `en`. */
+                lang?: string;
+            };
+            header?: never;
+            path: {
+                /** @description A unique integer value identifying this product. */
+                id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductFulfilmentDates"];
+                };
+            };
+            /** @description Possible error codes: `VALIDATION_ERROR`. Retryable: no. Possible error codes include `VALIDATION_ERROR`. Use `x-error-codes` for machine-readable retryability metadata. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIErrorEnvelope"];
+                };
+            };
+            /** @description Possible error codes include `UNAUTHORIZED`. Use `x-error-codes` for machine-readable retryability metadata. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIErrorEnvelope"];
+                };
+            };
+            /** @description Possible error codes include `FORBIDDEN`. Use `x-error-codes` for machine-readable retryability metadata. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIErrorEnvelope"];
+                };
+            };
+            /** @description Possible error codes: `NOT_FOUND`, `LOCATION_NOT_FOUND`. Retryable: no. Possible error codes include `NOT_FOUND`. Use `x-error-codes` for machine-readable retryability metadata. Possible error codes include `PRODUCT_NOT_FOUND`. Use `x-error-codes` for machine-readable retryability metadata. Possible error codes include `LOCATION_NOT_FOUND`. Use `x-error-codes` for machine-readable retryability metadata. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIErrorEnvelope"];
+                };
+            };
+            /** @description Possible error codes include `RATE_LIMITED`. Use `x-error-codes` for machine-readable retryability metadata. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIErrorEnvelope"];
+                };
+            };
+            /** @description Possible error codes include `INTERNAL_ERROR`. Use `x-error-codes` for machine-readable retryability metadata. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["APIErrorEnvelope"];
+                };
+            };
+        };
+    };
     products_suggestions_list: {
         parameters: {
             query?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poweredbysous/storefront-admin-sdk",
-  "version": "4.5.0",
+  "version": "4.6.0",
   "description": "Type-safe TypeScript SDK for SOUS Storefront Backend admin endpoints",
   "license": "UNLICENSED",
   "private": false,