@zappie/sdk 0.2.1 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @zappie/sdk
 
+## 0.4.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.
+
+## 0.3.0
+
+### Minor Changes
+
+- e0b5464: `checkoutUrl(path, environment)` and `appUrl(path, environment)` in the new `@zappie/sdk/services` entry build a URL on Zappie's checkout or app, for production or staging, such as the new home of an old payment or pay-point link. A path that could leave that service throws. `no-offsite-navigation` accepts both, as it accepts `safeRedirect`, and `no-direct-api` points a written-out checkout address to `checkoutUrl`.
+
 ## 0.2.1
 
 ### Patch Changes

package/dist/debug.js

@@ -1,5 +1,5 @@
 // src/debug.ts
-var VERSION = true ? "0.2.1" : "0.0.0-development";
+var VERSION = true ? "0.4.0" : "0.0.0-development";
 function installDebug(client) {
   if (typeof window === "undefined" || client.mode !== "test") {
     return;

package/dist/index.js

@@ -10,7 +10,7 @@ import { ZappieError, isZappieError } from "./errors.js";
 export * from "./models.js";
 import { format, money } from "./money.js";
 import { RestTransport } from "./transport/rest.js";
-var VERSION = true ? "0.2.1" : "0.0.0-development";
+var VERSION = true ? "0.4.0" : "0.0.0-development";
 export {
   API_VERSION,
   RestTransport,

package/dist/services/index.d.ts

@@ -0,0 +1,23 @@
+/** The Zappie environment a service URL points at. */
+type ZappieEnvironment = "production" | "staging";
+/**
+ * Build a URL on Zappie's checkout, such as an old payment link's new home.
+ *
+ * @param path - The checkout path, starting with one slash, such as `/pay/cs_123`.
+ * @param environment - `staging` for a test host. Defaults to `production`.
+ * @returns The absolute checkout URL. A path that could leave checkout throws a TypeError.
+ */
+declare const checkoutUrl: (path: string, environment?: ZappieEnvironment) => string;
+/**
+ * Build a URL on the Zappie app, which serves in-venue pages such as pay points and reservations.
+ *
+ * @param path - The app path, starting with one slash, such as `/pay-point/pp1`.
+ * @param environment - `staging` for a test host. Defaults to `production`.
+ * @returns The absolute app URL. A path that could leave the app throws a TypeError.
+ */
+declare const appUrl: (path: string, environment?: ZappieEnvironment) => string;
+/** Zappie's support WhatsApp number, the same one the classic storefront opens. */
+declare const ZAPPIE_SUPPORT_WHATSAPP = "15558956471";
+
+export { ZAPPIE_SUPPORT_WHATSAPP, appUrl, checkoutUrl };
+export type { ZappieEnvironment };

package/dist/services/index.js

@@ -0,0 +1,26 @@
+// src/services/index.ts
+var ORIGINS = {
+  checkout: {
+    production: "https://checkout.zappie.ai",
+    staging: "https://checkout.stg.zappie.ai"
+  },
+  app: {
+    production: "https://app.zappie.ai",
+    staging: "https://app.stg.zappie.ai"
+  }
+};
+var serviceUrl = (service, path, environment) => {
+  if (environment !== "production" && environment !== "staging" || !/^\/(?!\/)[^\u0000- \u007f\\]*$/u.test(path)) {
+    throw new TypeError("Pass a path that starts with one slash");
+  }
+  return ORIGINS[service][environment] + path;
+};
+var checkoutUrl = (path, environment = "production") => serviceUrl("checkout", path, environment);
+var appUrl = (path, environment = "production") => serviceUrl("app", path, environment);
+var ZAPPIE_SUPPORT_WHATSAPP = "15558956471";
+export {
+  ZAPPIE_SUPPORT_WHATSAPP,
+  appUrl,
+  checkoutUrl
+};
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/services/index.ts"],
+  "mappings": ";AAIA,IAAM,UAAU;AAAA,EACd,UAAU;AAAA,IACR,YAAY;AAAA,IACZ,SAAS;AAAA,EACX;AAAA,EACA,KAAK;AAAA,IACH,YAAY;AAAA,IACZ,SAAS;AAAA,EACX;AACF;AAGA,IAAM,aAAa,CACjB,SACA,MACA,gBACW;AACX,MACG,gBAAgB,gBAAgB,gBAAgB,aACjD,CAAC,kCAAkC,KAAK,IAAI,GAC5C;AACA,UAAM,IAAI,UAAU,wCAAwC;AAAA,EAC9D;AACA,SAAO,QAAQ,OAAO,EAAE,WAAW,IAAI;AACzC;AASO,IAAM,cAAc,CACzB,MACA,cAAiC,iBACtB,WAAW,YAAY,MAAM,WAAW;AAS9C,IAAM,SAAS,CACpB,MACA,cAAiC,iBACtB,WAAW,OAAO,MAAM,WAAW;AAGzC,IAAM,0BAA0B;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zappie/sdk",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Typed, framework-agnostic client for Zappie menus, carts, checkout, auth and events.",
   "type": "module",
   "sideEffects": false,
@@ -33,6 +33,10 @@
       "types": "./dist/redirect/index.d.ts",
       "import": "./dist/redirect/index.js"
     },
+    "./services": {
+      "types": "./dist/services/index.d.ts",
+      "import": "./dist/services/index.js"
+    },
     "./testing": {
       "types": "./dist/testing/index.d.ts",
       "import": "./dist/testing/index.js"
@@ -144,7 +148,7 @@
     "vite": "8.3.5"
   },
   "scripts": {
-    "build": "tsup && tsup --config tsup.checkout.config.ts && tsup --config tsup.checkout-defaults.config.ts && tsup --config tsup.customer.config.ts && tsup --config tsup.places.config.ts && tsup --config tsup.url.config.ts && tsup --config tsup.redirect.config.ts && tsup --config tsup.visits.config.ts && tsup --config tsup.pricing.config.ts && tsup --config tsup.site-config.config.ts && tsup --config tsup.template.config.ts && node ../../scripts/release-packages/build-modules.mjs --no-sources-content --unmapped=studio/index.js --unmapped=testing/index.js --unmapped=vite/index.js",
+    "build": "tsup && tsup --config tsup.checkout.config.ts && tsup --config tsup.checkout-defaults.config.ts && tsup --config tsup.customer.config.ts && tsup --config tsup.places.config.ts && tsup --config tsup.url.config.ts && tsup --config tsup.redirect.config.ts && tsup --config tsup.services.config.ts && tsup --config tsup.visits.config.ts && tsup --config tsup.pricing.config.ts && tsup --config tsup.site-config.config.ts && tsup --config tsup.template.config.ts && node ../../scripts/release-packages/build-modules.mjs --no-sources-content --unmapped=studio/index.js --unmapped=testing/index.js --unmapped=vite/index.js",
     "test": "vitest run --root ../.. packages/sdk/test",
     "size": "node ../../scripts/release-packages/size-sdk.mjs && size-limit"
   }