@final-commerce/command-frame 0.7.0-staging.6 → 0.7.0-staging.8

package/dist/CommonTypes.d.ts

@@ -116,6 +116,21 @@ export interface CFContextRender {
     stationName: string | null;
     outletId: string | null;
     outletName: string | null;
+    /**
+     * IANA zone the SHOP keeps, resolved as the outlet's own zone, else the
+     * company's — never the device's. A booking is stored as an instant, so which
+     * hour and which DAY it reads as is decided entirely by the zone it is printed
+     * in, and the screen's own machine is the one zone that is certainly wrong: a
+     * 17:00 Monday appointment in Vancouver is 21:30 for a till in St John's, and
+     * for some viewers it lands on Tuesday. Without this an app cannot label a
+     * slot or an appointment honestly — it can only guess, and it guesses wrong
+     * for every business that does not sit in the same zone as its screen.
+     *
+     * `null` when neither the outlet nor the company has one configured. Say so
+     * rather than falling back to the device: a missing timezone is a setup
+     * problem, and printing the machine's clock hides it.
+     */
+    timeZone: string | null;
     buildId: string | null;
     buildName: string | null;
     buildVersion: string | null;

package/dist/actions/get-context/mock.js

@@ -11,6 +11,10 @@ export const mockGetContext = () => {
         stationName: MOCK_STATION.name,
         outletId: MOCK_OUTLET.id,
         outletName: MOCK_OUTLET.name || null,
+        // Deliberately NOT the developer's own zone: an app that quietly formats with
+        // the machine's clock looks correct in preview and is wrong on every till that
+        // sits in a different city. Here it cannot look correct by accident.
+        timeZone: "America/Vancouver",
         buildId: "mock_build_id",
         buildName: "Mock Build",
         buildVersion: "1.0.0-mock",

package/dist/actions/get-refund-plan/types.d.ts

@@ -18,11 +18,14 @@ export interface GetRefundPlanParams {
      * nothing staged, no `allocation` comes back.
      */
     items?: {
-        /** `internalId` / `variantId` for a product, `customSaleId`, cart-fee id, or tip `transactionId`. */
+        /**
+         * `internalId` / `variantId` for a product, `customSaleId`, cart-fee id, tip
+         * `transactionId`, or a booking's own `internalId` on `order.reservations[]`.
+         */
         itemKey: string;
         quantity: number;
         /** Optional hint; inferred from the order when omitted. */
-        type?: 'product' | 'customSale' | 'fee' | 'tip';
+        type?: 'product' | 'customSale' | 'fee' | 'tip' | 'reservation';
     }[];
 }
 export interface RefundPlanSource {

package/dist/actions/get-remaining-refundable-quantities/mock.js

@@ -6,6 +6,7 @@ export const mockGetRemainingRefundableQuantities = async (_params) => {
         customSales: {},
         cartFees: {},
         tips: {},
+        reservations: {},
         timestamp: new Date().toISOString(),
     };
 };

package/dist/actions/get-remaining-refundable-quantities/types.d.ts

@@ -18,6 +18,14 @@ export interface GetRemainingRefundableQuantitiesResponse {
      * 0/1 semantics: `1` = still refundable, `0` = already refunded.
      */
     tips: Record<string, number>;
+    /**
+     * Remaining refundable bookings, keyed by `order.reservations[].internalId` —
+     * the same key `processPartialRefund` takes for `type: 'reservation'` items.
+     * A service is sold as a reservation rather than a line item, so without this
+     * map a refund screen can show everything on the order EXCEPT the appointment.
+     * 0/1 semantics: `1` = still refundable, `0` = already refunded.
+     */
+    reservations: Record<string, number>;
     timestamp: string;
 }
 export type GetRemainingRefundableQuantities = (params?: GetRemainingRefundableQuantitiesParams) => Promise<GetRemainingRefundableQuantitiesResponse>;

package/dist/actions/process-partial-refund/types.d.ts

@@ -131,10 +131,10 @@ export interface ProcessPartialRefundParams {
     };
     /** Optional items to refund. */
     items?: {
-        /** internalId or variantId or customSaleId. */
+        /** internalId or variantId, customSaleId, or a booking's own internalId. */
         itemKey: string;
         quantity: number;
-        type?: 'product' | 'customSale' | 'fee' | 'tip';
+        type?: 'product' | 'customSale' | 'fee' | 'tip' | 'reservation';
         /**
          * Per-item stock disposition for a refunded **product** line — the
          * headless equivalent of the old refund popup's per-row restock/damaged

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@final-commerce/command-frame",
-  "version": "0.7.0-staging.6",
+  "version": "0.7.0-staging.8",
   "description": "Commands Frame library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",