@zappie/foundations 0.2.2 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @zappie/foundations
 
+## 0.3.1
+
+### Patch Changes
+
+- acc553a: The kit's account page and the starter's account page show a "Problem with a payment? Message Zappie" link, a WhatsApp link to Zappie support from `zappieSupportUrl`. The kit's account page takes an optional `store`, and the branch's `name`, to name them in the message. `zappieSupportUrl` takes a branch without a name, and parts left `undefined`, so it type-checks under `exactOptionalPropertyTypes`.
+
+## 0.3.0
+
+### Minor Changes
+
+- b884697: `zappieSupportUrl(context)` in `@zappie/foundations` builds a WhatsApp link to Zappie support for a shopper with a problem such as a payment. Its message starts with "Hi Zappie support," and names the store, the branch when the store has more than one, the order and the page, as the classic storefront does. `ZAPPIE_SUPPORT_WHATSAPP` in `@zappie/sdk/services` is the number it opens.
+
+### Patch Changes
+
+- Updated dependencies [b884697]
+  - @zappie/sdk@0.4.0
+
 ## 0.2.2
 
 ### Patch Changes

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import { Presentation, SwipeDirection } from './overlay/engine.js';
 import * as react from 'react';
 import { HTMLAttributes, ReactNode, ComponentType, ReactElement, KeyboardEvent as KeyboardEvent$1, ImgHTMLAttributes, ChangeEvent, ClipboardEvent } from 'react';
 import * as _zappie_sdk from '@zappie/sdk';
-import { Branch as Branch$1, CartLine, CartLineInput, CartIssue, CartFix, Quote, DeliveryAddress, MenuSchedule, CartFulfilment, OptionGroup as OptionGroup$1, Item, Money as Money$1, Choice as Choice$1, MoneyFormatOptions, PaymentMethodKind, Category, Menu, OpeningTime } from '@zappie/sdk';
+import { Branch as Branch$1, CartLine, CartLineInput, CartIssue, CartFix, Quote, DeliveryAddress, MenuSchedule, CartFulfilment, OptionGroup as OptionGroup$1, Item, Money as Money$1, Choice as Choice$1, MoneyFormatOptions, PaymentMethodKind, Category, Menu, Store, OpeningTime } from '@zappie/sdk';
 import { useCart } from '@zappie/sdk/react';
 import { C as CloseOptions, O as OverlayQuery } from './history-BlytQinP.js';
 import '@base-ui/react/dialog';
@@ -959,6 +959,26 @@ type ContactLink = {
  * @returns The contact links in that order, or none.
  */
 declare function contactLinks(branch: Pick<Branch$1, "phone" | "socialLinks">): ContactLink[];
+/** What a message to Zappie support names. Each part is optional. */
+type ZappieSupportContext = {
+    /** The store. The message names the branch only when the store has more than one. */
+    store?: Partial<Pick<Store, "name" | "slug" | "branches">> | undefined;
+    /** The shopper's branch. */
+    branch?: Partial<Pick<Branch$1, "name">> | undefined;
+    /** The reference of the order the shopper needs help with. */
+    order?: string | undefined;
+    /** The address of the page the shopper is on. */
+    page?: string | undefined;
+};
+/**
+ * A WhatsApp link to Zappie support, for a shopper with a problem such as a payment. The message
+ * starts with "Hi Zappie support," and names the store, branch, order and page it is given, so
+ * support can find them.
+ *
+ * @param context - The store, branch, order and page to name.
+ * @returns A `https://wa.me/` link to Zappie support with the message filled in.
+ */
+declare function zappieSupportUrl({ store, branch, order, page, }?: ZappieSupportContext): string;
 
 /**
  * Parse a zero-padded HH:mm or HH:mm:ss wall-clock value without applying a time zone.
@@ -1040,5 +1060,5 @@ declare const OpenStatus: react.ForwardRefExoticComponent<Omit<react.AllHTMLAttr
 /** The installed @zappie/foundations version. */
 declare const FOUNDATIONS_VERSION: string;
 
-export { Account, AccountNotConfiguredError, Address, Branch, BranchMap, Cart, Choice, DeliveryMap, FOUNDATIONS_VERSION, Fulfilment, Image, ItemForm, Money, OpenStatus, OptionGroup, Otp, Overlay, PartProps, PaymentMethods, Quantity, Schedule, Search, Totals, canOrderAhead, contactLinks, createSearchIndex, deferred, formatOpeningHours, formatWallClock, getOpenStatus, parseWallClock, scheduleSlots, useControllableState, useIntentPreload, useOverlay };
-export type { ActiveGroup, AddressState, AddressSuggestion, BranchMapLoadErrorState, BranchMapProps, ContactLink, Customer, Deferred, DeferredIdleOptions, DeferredProps, DeliveryMapProps, ImageProps, IntentPreloadHandlers, ItemFormContext, ItemFormInvalidGroup, ItemFormProps, MapLoadErrorState, PaymentMethod, QuantityProps, QuantityState, ScheduleSlot, ScheduleState, SearchResult, SearchSource, SearchState, SignInOptions, TotalsState };
+export { Account, AccountNotConfiguredError, Address, Branch, BranchMap, Cart, Choice, DeliveryMap, FOUNDATIONS_VERSION, Fulfilment, Image, ItemForm, Money, OpenStatus, OptionGroup, Otp, Overlay, PartProps, PaymentMethods, Quantity, Schedule, Search, Totals, canOrderAhead, contactLinks, createSearchIndex, deferred, formatOpeningHours, formatWallClock, getOpenStatus, parseWallClock, scheduleSlots, useControllableState, useIntentPreload, useOverlay, zappieSupportUrl };
+export type { ActiveGroup, AddressState, AddressSuggestion, BranchMapLoadErrorState, BranchMapProps, ContactLink, Customer, Deferred, DeferredIdleOptions, DeferredProps, DeliveryMapProps, ImageProps, IntentPreloadHandlers, ItemFormContext, ItemFormInvalidGroup, ItemFormProps, MapLoadErrorState, PaymentMethod, QuantityProps, QuantityState, ScheduleSlot, ScheduleState, SearchResult, SearchSource, SearchState, SignInOptions, TotalsState, ZappieSupportContext };

package/dist/index.js

@@ -18,7 +18,7 @@ import { Otp } from "./otp/input.js";
 import { Overlay, useOverlay } from "./overlay/react.js";
 import { PaymentMethods } from "./payment/methods.js";
 import { createSearchIndex, Search } from "./search/index.js";
-import { contactLinks } from "./status/contact.js";
+import { contactLinks, zappieSupportUrl } from "./status/contact.js";
 import {
   canOrderAhead,
   formatOpeningHours,
@@ -58,6 +58,7 @@ export {
   scheduleSlots,
   useControllableState,
   useIntentPreload,
-  useOverlay
+  useOverlay,
+  zappieSupportUrl
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "mappings": ";;;AACA,SAAS,uBAAuB;AAIhC,SAAS,SAAS,iCAAiC;AAEnD,SAAS,WAAW,mBAAmB;AAOvC,SAAS,MAAM,cAAc;AAE7B,SAAS,UAAU,wBAAwB;AAO3C,SAAS,eAAe;AAKxB,SAAS,cAAc;AACvB,SAAS,UAAU,qBAAqB;AAExC,SAAS,kBAAkB;AAE3B,SAAS,4BAA4B;AACrC,cAAc;AACd,SAAS,aAAa;AAEtB,SAAS,aAAa;AACtB,SAAS,WAAW;AACpB,SAAS,SAAS,kBAAkB;AACpC,SAAS,sBAAsB;AAE/B,SAAS,mBAAmB,cAAc;AAE1C,SAAS,oBAAoB;AAE7B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAjDpB,IAAM,sBAA8B;",
+  "mappings": ";;;AACA,SAAS,uBAAuB;AAIhC,SAAS,SAAS,iCAAiC;AAEnD,SAAS,WAAW,mBAAmB;AAOvC,SAAS,MAAM,cAAc;AAE7B,SAAS,UAAU,wBAAwB;AAO3C,SAAS,eAAe;AAKxB,SAAS,cAAc;AACvB,SAAS,UAAU,qBAAqB;AAExC,SAAS,kBAAkB;AAE3B,SAAS,4BAA4B;AACrC,cAAc;AACd,SAAS,aAAa;AAEtB,SAAS,aAAa;AACtB,SAAS,WAAW;AACpB,SAAS,SAAS,kBAAkB;AACpC,SAAS,sBAAsB;AAE/B,SAAS,mBAAmB,cAAc;AAE1C,SAAS,cAAc,wBAAwB;AAE/C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAjDpB,IAAM,sBAA8B;",
   "names": []
 }

package/dist/status/contact.js

@@ -1,4 +1,5 @@
 // src/status/contact.ts
+import { ZAPPIE_SUPPORT_WHATSAPP } from "@zappie/sdk/services";
 function contactLinks(branch) {
   const links = [];
   const phone = branch.phone?.replace(/[^\d+]/g, "");
@@ -13,7 +14,29 @@ function contactLinks(branch) {
   }
   return links;
 }
+function zappieSupportUrl({
+  store,
+  branch,
+  order,
+  page
+} = {}) {
+  const name = branch?.name;
+  const details = [
+    store?.name && `Business: ${store.name}${store.slug ? ` (@${store.slug})` : ""}`,
+    (store?.branches?.length ?? 0) > 1 && name && `Branch: ${name.charAt(0).toUpperCase()}${name.slice(1)}`,
+    order && `Order: ${order}`,
+    page && `Page: ${page}`
+  ].filter(Boolean);
+  const message = [
+    "Hi Zappie support,",
+    ...details.length ? ["", ...details] : [],
+    "",
+    "I need help with:"
+  ].join("\n");
+  return `https://wa.me/${ZAPPIE_SUPPORT_WHATSAPP}?text=${encodeURIComponent(message)}`;
+}
 export {
-  contactLinks
+  contactLinks,
+  zappieSupportUrl
 };
 //# sourceMappingURL=contact.js.map

package/dist/status/contact.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/status/contact.ts"],
-  "mappings": ";AAcO,SAAS,aACd,QACe;AACf,QAAM,QAAuB,CAAC;AAC9B,QAAM,QAAQ,OAAO,OAAO,QAAQ,WAAW,EAAE;AACjD,MAAI,SAAS,KAAK,KAAK,KAAK,GAAG;AAC7B,UAAM,KAAK,EAAE,MAAM,SAAS,OAAO,QAAQ,MAAM,OAAO,KAAK,GAAG,CAAC;AAAA,EACnE;AACA,QAAM,UAAU,OAAO,aAAa;AAAA,IAClC,CAAC,SAAS,KAAK,KAAK,YAAY,MAAM;AAAA,EACxC;AACA,MAAI,SAAS;AACX,UAAM,KAAK,EAAE,MAAM,WAAW,OAAO,kBAAkB,MAAM,QAAQ,IAAI,CAAC;AAAA,EAC5E;AACA,SAAO;AACT;",
+  "mappings": ";AACA,SAAS,+BAA+B;AAcjC,SAAS,aACd,QACe;AACf,QAAM,QAAuB,CAAC;AAC9B,QAAM,QAAQ,OAAO,OAAO,QAAQ,WAAW,EAAE;AACjD,MAAI,SAAS,KAAK,KAAK,KAAK,GAAG;AAC7B,UAAM,KAAK,EAAE,MAAM,SAAS,OAAO,QAAQ,MAAM,OAAO,KAAK,GAAG,CAAC;AAAA,EACnE;AACA,QAAM,UAAU,OAAO,aAAa;AAAA,IAClC,CAAC,SAAS,KAAK,KAAK,YAAY,MAAM;AAAA,EACxC;AACA,MAAI,SAAS;AACX,UAAM,KAAK,EAAE,MAAM,WAAW,OAAO,kBAAkB,MAAM,QAAQ,IAAI,CAAC;AAAA,EAC5E;AACA,SAAO;AACT;AAsBO,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,IAA0B,CAAC,GAAW;AACpC,QAAM,OAAO,QAAQ;AACrB,QAAM,UAAU;AAAA,IACd,OAAO,QACL,aAAa,MAAM,IAAI,GAAG,MAAM,OAAO,MAAM,MAAM,IAAI,MAAM,EAAE;AAAA,KAChE,OAAO,UAAU,UAAU,KAAK,KAC/B,QACA,WAAW,KAAK,OAAO,CAAC,EAAE,YAAY,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC;AAAA,IACzD,SAAS,UAAU,KAAK;AAAA,IACxB,QAAQ,SAAS,IAAI;AAAA,EACvB,EAAE,OAAO,OAAO;AAChB,QAAM,UAAU;AAAA,IACd;AAAA,IACA,GAAI,QAAQ,SAAS,CAAC,IAAI,GAAG,OAAO,IAAI,CAAC;AAAA,IACzC;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACX,SAAO,iBAAiB,uBAAuB,SAAS,mBAAmB,OAAO,CAAC;AACrF;",
   "names": []
 }

package/dist/version.js

@@ -1,5 +1,5 @@
 // src/version.ts
-var PACKAGE_VERSION = true ? "0.2.2" : "0.0.0-development";
+var PACKAGE_VERSION = true ? "0.3.1" : "0.0.0-development";
 export {
   PACKAGE_VERSION
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zappie/foundations",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "UI-less React primitives for Zappie storefronts: behaviour, state and accessibility without styles.",
   "type": "module",
   "sideEffects": false,
@@ -33,7 +33,7 @@
   "dependencies": {
     "@base-ui/react": "^1.9.0",
     "@googlemaps/markerclusterer": "^2.6.2",
-    "@zappie/sdk": "^0.3.0"
+    "@zappie/sdk": "^0.4.0"
   },
   "peerDependencies": {
     "react": "^18.2.0 || ^19.0.0",