@poweredbysous/storefront-all-sdk 4.9.0 → 4.10.0

package/dist/index.d.cts

@@ -3154,6 +3154,13 @@ interface paths {
          *
          *     Meilisearch unreachable answers 502 rather than an empty page, so
          *     "nothing matches" and "search is down" never look the same.
+         *
+         *     A 200 is cacheable by shared caches for a minute (``CACHE_CONTROL_OK``).
+         *     That is safe because the body is a function of the URL and the language
+         *     only: there are no authentication classes, no cookie is read or set, and
+         *     the store ids it may carry are public identifiers. Search staleness is
+         *     acceptable by contract (add-to-cart re-checks fulfilment). Anything that
+         *     is not a 200 is ``no-store`` so an outage is never replayed from a cache.
          */
         get: operations["discovery_marketplace_retrieve"];
         put?: never;
@@ -3225,6 +3232,29 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/discovery/store-routes/": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * @description Each ExploreSOUS store's brand and location slug, for its page URL.
+         *
+         *     ExploreSOUS serves a store at ``/brands/{brand_slug}/{slug}`` and resolves
+         *     both ways with this: a segment pair to the store, and an old
+         *     ``/stores/{public_id}`` link to its new address.
+         */
+        get: operations["discovery_store_routes_retrieve"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/discovery/stores/": {
         parameters: {
             query?: never;
@@ -7659,12 +7689,12 @@ interface components {
                 [key: string]: unknown;
             }[];
             /**
-             * @description How many products this category shows, descendants included.
+             * @description How many products this category's listing shows, descendants included.
              *
-             *     The listing precomputes every category's count in one pass
-             *     (``views._build_product_counts``) and passes it in context; the
-             *     fallback below is the single-object path (retrieve), which counts its
-             *     own subtree directly.
+             *     Precomputed for every category in one pass
+             *     (``views._build_product_counts``) and passed in context, on both list
+             *     and retrieve: counting here instead would count products the listing
+             *     leaves out.
              */
             readonly product_count: number;
         };
@@ -8385,6 +8415,15 @@ interface components {
         DiscoveryStoreMembership: {
             store_ids: string[];
         };
+        DiscoveryStoreRoute: {
+            public_id: string;
+            brand_slug: string | null;
+            slug: string | null;
+        };
+        /** @description Each ExploreSOUS store's ``/brands/{brand_slug}/{slug}`` address. */
+        DiscoveryStoreRoutes: {
+            stores: components["schemas"]["DiscoveryStoreRoute"][];
+        };
         /** @description One filter option, already named in the reader's language. */
         DiscoveryTag: {
             slug: string;
@@ -26995,6 +27034,61 @@ interface operations {
             };
         };
     };
+    discovery_store_routes_retrieve: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DiscoveryStoreRoutes"];
+                };
+            };
+            /** @description 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 `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"];
+                };
+            };
+        };
+    };
     discovery_stores_retrieve: {
         parameters: {
             query?: never;

package/dist/index.d.ts

@@ -3154,6 +3154,13 @@ interface paths {
          *
          *     Meilisearch unreachable answers 502 rather than an empty page, so
          *     "nothing matches" and "search is down" never look the same.
+         *
+         *     A 200 is cacheable by shared caches for a minute (``CACHE_CONTROL_OK``).
+         *     That is safe because the body is a function of the URL and the language
+         *     only: there are no authentication classes, no cookie is read or set, and
+         *     the store ids it may carry are public identifiers. Search staleness is
+         *     acceptable by contract (add-to-cart re-checks fulfilment). Anything that
+         *     is not a 200 is ``no-store`` so an outage is never replayed from a cache.
          */
         get: operations["discovery_marketplace_retrieve"];
         put?: never;
@@ -3225,6 +3232,29 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/discovery/store-routes/": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * @description Each ExploreSOUS store's brand and location slug, for its page URL.
+         *
+         *     ExploreSOUS serves a store at ``/brands/{brand_slug}/{slug}`` and resolves
+         *     both ways with this: a segment pair to the store, and an old
+         *     ``/stores/{public_id}`` link to its new address.
+         */
+        get: operations["discovery_store_routes_retrieve"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/discovery/stores/": {
         parameters: {
             query?: never;
@@ -7659,12 +7689,12 @@ interface components {
                 [key: string]: unknown;
             }[];
             /**
-             * @description How many products this category shows, descendants included.
+             * @description How many products this category's listing shows, descendants included.
              *
-             *     The listing precomputes every category's count in one pass
-             *     (``views._build_product_counts``) and passes it in context; the
-             *     fallback below is the single-object path (retrieve), which counts its
-             *     own subtree directly.
+             *     Precomputed for every category in one pass
+             *     (``views._build_product_counts``) and passed in context, on both list
+             *     and retrieve: counting here instead would count products the listing
+             *     leaves out.
              */
             readonly product_count: number;
         };
@@ -8385,6 +8415,15 @@ interface components {
         DiscoveryStoreMembership: {
             store_ids: string[];
         };
+        DiscoveryStoreRoute: {
+            public_id: string;
+            brand_slug: string | null;
+            slug: string | null;
+        };
+        /** @description Each ExploreSOUS store's ``/brands/{brand_slug}/{slug}`` address. */
+        DiscoveryStoreRoutes: {
+            stores: components["schemas"]["DiscoveryStoreRoute"][];
+        };
         /** @description One filter option, already named in the reader's language. */
         DiscoveryTag: {
             slug: string;
@@ -26995,6 +27034,61 @@ interface operations {
             };
         };
     };
+    discovery_store_routes_retrieve: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DiscoveryStoreRoutes"];
+                };
+            };
+            /** @description 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 `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"];
+                };
+            };
+        };
+    };
     discovery_stores_retrieve: {
         parameters: {
             query?: never;

package/package.json

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