@poweredbysous/storefront-sdk 3.4.0 → 3.5.0

package/dist/index.d.cts

@@ -2756,6 +2756,7 @@ interface components {
              * @description Last computed full shipping estimate (before delivery fee split). NULL means no estimate has been computed — which is not the same as an estimate of zero, and must never be read as free delivery.
              */
             estimated_shipping_cost?: string | null;
+            readonly delivery_address: components["schemas"]["CartDeliveryAddress"] | null;
             readonly service_fees: {
                 /**
                  * Format: decimal
@@ -2778,10 +2779,13 @@ interface components {
                 }[];
             };
             /**
-             * @description Return cart_total + customer shipping portion + service fees.
+             * @description What checkout will charge for this basket, before gift cards and
+             *     Zeemijlen: the items, surcharges, delivery fee and service fee, less
+             *     discounts. Leaves out only a delivery fee not priced yet, which
+             *     ``service_fees.estimated`` says.
              *
-             *     Uses the service_fees and shipping_estimate already computed
-             *     by this serializer (which include pass-through splits).
+             *     Totalled by ``order_total_before_points``, the formula checkout
+             *     totals with, so the cart total is the checkout total.
              */
             readonly estimated_total: string;
             /**
@@ -2801,6 +2805,24 @@ interface components {
             /** Format: date-time */
             expires_at: string;
         };
+        /**
+         * @description Where the shopper wants delivery, as the shipping estimate reads it.
+         *
+         *     Given with the fulfilment choice, before the first item, so every cart
+         *     response carries the delivery fee checkout will charge (price
+         *     transparency). The same fields a cart GET takes as query parameters.
+         */
+        CartDeliveryAddress: {
+            /** Format: decimal */
+            latitude: string;
+            /** Format: decimal */
+            longitude: string;
+            postal_code?: string;
+            address_street?: string;
+            address_city?: string;
+            /** @description ISO 3166-1 alpha-2, case-insensitive. A nationwide carrier prices by country, so it is enough without a street and city; a live courier quote needs all three. */
+            address_country?: string;
+        };
         /** @description Validates a single cart item for eligibility checks. */
         CartItem: {
             product_id: number;
@@ -4069,6 +4091,8 @@ interface components {
             fulfillment_type?: components["schemas"]["FulfillmentTypeEnum"];
             /** Format: date */
             fulfillment_date?: string;
+            /** @description The shopper's delivery address. Stored on the cart so every cart response prices the delivery fee; null forgets it, and leaving it out keeps the one already given. */
+            delivery_address?: components["schemas"]["CartDeliveryAddress"] | null;
         };
         /** @description Validates the request body for updating a line item quantity. */
         PatchedUpdateItemQuantityInput: {
@@ -6088,7 +6112,7 @@ interface operations {
                 address_country?: string;
                 /** @description Delivery destination street line. Required together with address_city and address_country to trigger a live shipping quote (e.g. from Uber Direct); without all three the shipping_estimate group will report cost_known=false. */
                 address_street?: string;
-                /** @description Delivery destination latitude. When paired with longitude, enables a per-group shipping estimate in the response. */
+                /** @description Delivery destination latitude. When paired with longitude, enables a per-group shipping estimate in the response. Ignored, like every address parameter here, once the cart holds a `delivery_address` from the fulfilment PATCH. */
                 latitude?: number;
                 /** @description Delivery destination longitude. */
                 longitude?: number;

package/dist/index.d.ts

@@ -2756,6 +2756,7 @@ interface components {
              * @description Last computed full shipping estimate (before delivery fee split). NULL means no estimate has been computed — which is not the same as an estimate of zero, and must never be read as free delivery.
              */
             estimated_shipping_cost?: string | null;
+            readonly delivery_address: components["schemas"]["CartDeliveryAddress"] | null;
             readonly service_fees: {
                 /**
                  * Format: decimal
@@ -2778,10 +2779,13 @@ interface components {
                 }[];
             };
             /**
-             * @description Return cart_total + customer shipping portion + service fees.
+             * @description What checkout will charge for this basket, before gift cards and
+             *     Zeemijlen: the items, surcharges, delivery fee and service fee, less
+             *     discounts. Leaves out only a delivery fee not priced yet, which
+             *     ``service_fees.estimated`` says.
              *
-             *     Uses the service_fees and shipping_estimate already computed
-             *     by this serializer (which include pass-through splits).
+             *     Totalled by ``order_total_before_points``, the formula checkout
+             *     totals with, so the cart total is the checkout total.
              */
             readonly estimated_total: string;
             /**
@@ -2801,6 +2805,24 @@ interface components {
             /** Format: date-time */
             expires_at: string;
         };
+        /**
+         * @description Where the shopper wants delivery, as the shipping estimate reads it.
+         *
+         *     Given with the fulfilment choice, before the first item, so every cart
+         *     response carries the delivery fee checkout will charge (price
+         *     transparency). The same fields a cart GET takes as query parameters.
+         */
+        CartDeliveryAddress: {
+            /** Format: decimal */
+            latitude: string;
+            /** Format: decimal */
+            longitude: string;
+            postal_code?: string;
+            address_street?: string;
+            address_city?: string;
+            /** @description ISO 3166-1 alpha-2, case-insensitive. A nationwide carrier prices by country, so it is enough without a street and city; a live courier quote needs all three. */
+            address_country?: string;
+        };
         /** @description Validates a single cart item for eligibility checks. */
         CartItem: {
             product_id: number;
@@ -4069,6 +4091,8 @@ interface components {
             fulfillment_type?: components["schemas"]["FulfillmentTypeEnum"];
             /** Format: date */
             fulfillment_date?: string;
+            /** @description The shopper's delivery address. Stored on the cart so every cart response prices the delivery fee; null forgets it, and leaving it out keeps the one already given. */
+            delivery_address?: components["schemas"]["CartDeliveryAddress"] | null;
         };
         /** @description Validates the request body for updating a line item quantity. */
         PatchedUpdateItemQuantityInput: {
@@ -6088,7 +6112,7 @@ interface operations {
                 address_country?: string;
                 /** @description Delivery destination street line. Required together with address_city and address_country to trigger a live shipping quote (e.g. from Uber Direct); without all three the shipping_estimate group will report cost_known=false. */
                 address_street?: string;
-                /** @description Delivery destination latitude. When paired with longitude, enables a per-group shipping estimate in the response. */
+                /** @description Delivery destination latitude. When paired with longitude, enables a per-group shipping estimate in the response. Ignored, like every address parameter here, once the cart holds a `delivery_address` from the fulfilment PATCH. */
                 latitude?: number;
                 /** @description Delivery destination longitude. */
                 longitude?: number;

package/package.json

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