@occluze/tether 0.6.8 → 0.7.0

package/dist/tether.search.js

@@ -1,34 +1,42 @@
-"use strict";
 (() => {
   var __defProp = Object.defineProperty;
+  var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
   var __export = (target, all) => {
     for (var name in all)
       __defProp(target, name, { get: all[name], enumerable: true });
   };
+  var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
-  // src/search.js
+  // src/search.ts
   var search_exports = {};
   __export(search_exports, {
     mountSearch: () => mountSearch
   });
 
-  // tether-core:config.js
-  var m = window.Tether.__core["config.js"];
-  var { DEFAULTS, cfg, configure, isConfigured, log, reportError, resolveConfig, toMetafieldIdentifier, warn } = m;
+  // tether-core:config.ts
+  var m = window.Tether.__core["config.ts"];
+  var [cfg, isConfigured, log, MARKET_SOURCES, parseMarkets, reportError, warn] = m;
 
-  // tether-core:client.js
-  var m2 = window.Tether.__core["client.js"];
-  var { TetherError, endpoint, gql, request, unwrap, withContext } = m2;
+  // tether-core:client.ts
+  var m2 = window.Tether.__core["client.ts"];
+  var [endpoint, gql, orNull, shaped, TetherError] = m2;
 
-  // tether-core:dom.js
-  var m3 = window.Tether.__core["dom.js"];
-  var { attr, busy, cdnUrl, emit, formatDate, formatMoney, formatPercent, get, has, hasTemplate, imageUrl, notifyLayoutChanged, parseJSONAttr, productUrl, qsa, repeat, repeatKeyed, sameImage, scoped, sel, setImage, setSelected, setStoreHtml, setText, setTextTracked, show, toAttributes, watchImages } = m3;
+  // tether-core:dom.ts
+  var m3 = window.Tether.__core["dom.ts"];
+  var [ANALYTICS_EVENTS, attr, attributesFromJson, emit, formatDate, formatMoney, get, has, hasTemplate, isOwnEvent, parseJSONAttr, productUrl, qsa, repeat, sel, setImage, setText, show] = m3;
 
-  // tether-core:mounting.js
-  var m4 = window.Tether.__core["mounting.js"];
-  var { hydrateFromPage, liveLists, liveProducts, mountProduct, mountedLists, mountedProducts, pruneLive, retryFailed, settleMarket, trackMarket, within } = m4;
+  // tether-core:mounting.ts
+  var m4 = window.Tether.__core["mounting.ts"];
+  var [liveLists, liveProducts, mountedProducts, mountProduct, pruneLive, within] = m4;
 
-  // src/search.js
+  // src/search.ts
+  var isSearchAnswer = shaped({
+    predictiveSearch: orNull({
+      products: [{ priceRange: "object" }],
+      collections: ["object"],
+      queries: [{ text: "string" }]
+    })
+  });
   var QUERY = `query TetherPredictive($q:String!,$limit:Int!){predictiveSearch(query:$q,limit:$limit,limitScope:EACH,types:[PRODUCT,COLLECTION,QUERY]){products{id handle title availableForSale featuredImage{url altText}priceRange{minVariantPrice{amount currencyCode}}}collections{handle title image{url altText}}queries{text}}}`;
   var DEFAULT_LIMIT = 6;
   var DEFAULT_MIN_CHARACTERS = 2;
@@ -51,16 +59,23 @@
   function linkOption(node, href) {
     const link = linkIn(node);
     if (!link) return;
-    link.setAttribute("href", href);
+    if (href) link.setAttribute("href", href);
     link.setAttribute("role", "option");
   }
   var SearchBox = class {
-    /**
-     * @param {HTMLElement} root
-     * @param {HTMLInputElement} input
-     * @param {HTMLElement} results
-     */
     constructor(root, input, results) {
+      __publicField(this, "root");
+      __publicField(this, "input");
+      __publicField(this, "results");
+      __publicField(this, "limit");
+      __publicField(this, "minCharacters");
+      __publicField(this, "resultsId");
+      /** Counts searches, so only the latest one renders. */
+      __publicField(this, "searchNumber", 0);
+      __publicField(this, "timer");
+      __publicField(this, "lastTerm", "");
+      /** Results per term, for typing back and forth. */
+      __publicField(this, "cache", /* @__PURE__ */ new Map());
       this.root = root;
       this.input = input;
       this.results = results;
@@ -71,10 +86,6 @@
         results.id = `${cfg.prefix}-search-${searchBoxCount}`;
       }
       this.resultsId = results.id;
-      this.searchNumber = 0;
-      this.timer = void 0;
-      this.lastTerm = "";
-      this.cache = /* @__PURE__ */ new Map();
       this.setUpAria();
       this.listen();
     }
@@ -102,17 +113,12 @@
         this.onKeydown(event);
       });
       document.addEventListener("click", (event) => {
-        if (!this.root.contains(
-          /** @type {Node | null} */
-          event.target
-        )) this.open(false);
+        if (!this.root.contains(event.target)) this.open(false);
       });
     }
-    /** @param {SearchState} state */
     setState(state) {
       this.root.setAttribute(attr("search-state"), state);
     }
-    /** @param {boolean} open */
     open(open) {
       this.root.classList.toggle("is-open", open);
       this.results.hidden = !open;
@@ -122,18 +128,13 @@
     options() {
       return qsa(this.results, '[role="option"]');
     }
-    /**
-     * @param {string} term
-     * @returns {Promise<SearchResults | null>}
-     */
     async fetchResults(term) {
       const cached = this.cache.get(term);
       if (cached) return cached;
-      const data = await gql(QUERY, { q: term, limit: this.limit });
+      const data = await gql(QUERY, { q: term, limit: this.limit }, isSearchAnswer);
       this.cache.set(term, data.predictiveSearch);
       return data.predictiveSearch;
     }
-    /** @param {string} term */
     async search(term) {
       this.searchNumber += 1;
       const searchNumber = this.searchNumber;
@@ -155,28 +156,18 @@
         reportError(error, "search");
       }
     }
-    /**
-     * @template Item
-     * @param {string} name The list attribute, e.g. `search-products`.
-     * @param {readonly Item[]} items
-     * @param {(node: HTMLElement, item: Item) => void} render
-     */
+    /** @param name The list attribute, e.g. `search-products`. */
     fillList(name, items, render) {
       qsa(this.results, sel(name)).forEach((list) => {
         repeat(list, items, render);
         show(list, items.length > 0);
       });
     }
-    /** @param {string} text */
     queryUrl(text) {
       const action = this.root.getAttribute("action") || DEFAULT_ACTION;
       const separator = action.includes("?") ? "&" : "?";
       return `${action}${separator}${this.input.name || "q"}=${encodeURIComponent(text)}`;
     }
-    /**
-     * @param {SearchResults | null} results
-     * @param {string} term
-     */
     render(results, term) {
       const products = results?.products ?? [];
       const collections = results?.collections ?? [];
@@ -201,7 +192,6 @@
       this.open(true);
       emit("search", { term, products, collections, queries }, this.root);
     }
-    /** @param {number} count */
     showCount(count) {
       qsa(this.root, sel("show")).forEach((el) => {
         const condition = get(el, "show");
@@ -213,10 +203,6 @@
         option.setAttribute("aria-selected", "false");
       });
     }
-    /**
-     * @param {HTMLElement[]} options
-     * @param {number} index
-     */
     highlight(options, index) {
       options.forEach((option2, optionIndex) => {
         option2.setAttribute("aria-selected", String(optionIndex === index));
@@ -226,7 +212,6 @@
       this.input.setAttribute("aria-activedescendant", option.id);
       option.scrollIntoView?.({ block: "nearest" });
     }
-    /** @param {KeyboardEvent} event */
     onKeydown(event) {
       const options = this.options();
       const current = options.findIndex((option) => option.getAttribute("aria-selected") === "true");
@@ -249,23 +234,14 @@
     for (const el of within(root, sel("search"))) {
       if (mounted.has(el)) continue;
       mounted.add(el);
-      const input = (
-        /** @type {HTMLInputElement | null} */
-        el.querySelector(sel("search-input")) ?? el.querySelector("input")
-      );
-      const results = (
-        /** @type {HTMLElement | null} */
-        el.querySelector(sel("search-results"))
-      );
+      const input = el.querySelector(sel("search-input")) ?? el.querySelector("input");
+      const results = el.querySelector(sel("search-results"));
       if (input && results) new SearchBox(el, input, results);
     }
   }
 
-  // src/parts/search.js
-  var { Tether } = (
-    /** @type {Window & { Tether?: { __parts: Record<string, unknown> } }} */
-    window
-  );
+  // src/parts/search.ts
+  var { Tether } = window;
   if (!Tether) throw new Error("tether.search.js runs after the Tether script, which loads it");
-  Tether.__parts["search"] = search_exports;
+  Tether.__parts.search = search_exports;
 })();

package/dist/tether.search.min.js

@@ -1 +1 @@
-"use strict";(()=>{var N=Object.defineProperty;var P=(s,t)=>{for(var e in t)N(s,e,{get:t[e],enumerable:!0})};var p={};P(p,{mountSearch:()=>Q});var R=window.Tether.__core["config.js"],{DEFAULTS:J,cfg:l,configure:W,isConfigured:z,log:w,reportError:b,resolveConfig:B,toMetafieldIdentifier:G,warn:X}=R;var F=window.Tether.__core["client.js"],{TetherError:tt,endpoint:et,gql:A,request:it,unwrap:st,withContext:rt}=F;var M=window.Tether.__core["dom.js"],{attr:y,busy:at,cdnUrl:ot,emit:T,formatDate:ht,formatMoney:E,formatPercent:ct,get:u,has:lt,hasTemplate:ut,imageUrl:dt,notifyLayoutChanged:mt,parseJSONAttr:ft,productUrl:S,qsa:c,repeat:x,repeatKeyed:pt,sameImage:gt,scoped:wt,sel:o,setImage:L,setSelected:bt,setStoreHtml:At,setText:C,setTextTracked:yt,show:d,toAttributes:Tt,watchImages:Et}=M;var O=window.Tether.__core["mounting.js"],{hydrateFromPage:xt,liveLists:Lt,liveProducts:Ct,mountProduct:It,mountedLists:qt,mountedProducts:Ut,pruneLive:kt,retryFailed:$t,settleMarket:_t,trackMarket:vt,within:I}=O;var j="query TetherPredictive($q:String!,$limit:Int!){predictiveSearch(query:$q,limit:$limit,limitScope:EACH,types:[PRODUCT,COLLECTION,QUERY]){products{id handle title availableForSale featuredImage{url altText}priceRange{minVariantPrice{amount currencyCode}}}collections{handle title image{url altText}}queries{text}}}",V=6,H=2,K="/search",q=new WeakSet,U=0;function k(s,t,e){return parseInt(u(s,t)||"",10)||e}var _=s=>s.tagName==="A"?s:s.querySelector("a");function m(s,t){c(s,o("search-bind")).forEach(e=>{let i=u(e,"search-bind");i==="image"?L(e,t.image?.url,t.image?.altText||t.title):(i==="title"||i==="price"||i==="text")&&t[i]!=null&&C(e,t[i])})}function $(s,t){let e=_(s);e&&(e.setAttribute("href",t),e.setAttribute("role","option"))}var f=class{constructor(t,e,i){this.root=t,this.input=e,this.results=i,this.limit=k(t,"search-limit",V),this.minCharacters=k(t,"search-min",H),i.id||(U+=1,i.id=`${l.prefix}-search-${U}`),this.resultsId=i.id,this.searchNumber=0,this.timer=void 0,this.lastTerm="",this.cache=new Map,this.setUpAria(),this.listen()}setUpAria(){this.input.setAttribute("role","combobox"),this.input.setAttribute("aria-autocomplete","list"),this.input.setAttribute("aria-controls",this.resultsId),this.input.setAttribute("aria-expanded","false"),this.input.setAttribute("autocomplete","off"),this.results.hasAttribute("role")||this.results.setAttribute("role","listbox"),this.results.hidden=!0}listen(){this.input.addEventListener("input",()=>{let t=this.input.value.trim();t!==this.lastTerm&&(this.lastTerm=t,clearTimeout(this.timer),this.timer=setTimeout(()=>void this.search(t),l.searchDelay))}),this.input.addEventListener("focus",()=>{this.input.value.trim().length>=this.minCharacters&&this.options().length&&this.open(!0)}),this.input.addEventListener("keydown",t=>{this.onKeydown(t)}),document.addEventListener("click",t=>{this.root.contains(t.target)||this.open(!1)})}setState(t){this.root.setAttribute(y("search-state"),t)}open(t){this.root.classList.toggle("is-open",t),this.results.hidden=!t,this.input.setAttribute("aria-expanded",String(t)),t||this.input.removeAttribute("aria-activedescendant")}options(){return c(this.results,'[role="option"]')}async fetchResults(t){let e=this.cache.get(t);if(e)return e;let i=await A(j,{q:t,limit:this.limit});return this.cache.set(t,i.predictiveSearch),i.predictiveSearch}async search(t){this.searchNumber+=1;let e=this.searchNumber;if(t.length<this.minCharacters){this.open(!1),this.setState("idle");return}this.setState("loading");try{let i=await this.fetchResults(t);e===this.searchNumber&&this.render(i,t)}catch(i){if(e!==this.searchNumber){w("a superseded search failed",i);return}this.setState("error"),b(i,"search")}}fillList(t,e,i){c(this.results,o(t)).forEach(a=>{x(a,e,i),d(a,e.length>0)})}queryUrl(t){let e=this.root.getAttribute("action")||K,i=e.includes("?")?"&":"?";return`${e}${i}${this.input.name||"q"}=${encodeURIComponent(t)}`}render(t,e){let i=t?.products??[],a=t?.collections??[],h=(t?.queries??[]).filter(n=>n.text.toLowerCase()!==e.toLowerCase());this.fillList("search-products",i,(n,r)=>{let D=E(r.priceRange.minVariantPrice);m(n,{title:r.title,price:D,image:r.featuredImage}),$(n,S(r.handle,r.id)),n.classList.toggle("is-sold-out",!r.availableForSale)}),this.fillList("search-collections",a,(n,r)=>{m(n,{title:r.title,image:r.image}),$(n,`${(l.collectionPath||"/collection").replace(/\/$/,"")}/${r.handle}`)}),this.fillList("search-queries",h,(n,r)=>{m(n,{text:r.text}),_(n)?.setAttribute("href",this.queryUrl(r.text))});let g=i.length+a.length+h.length;this.showCount(g),this.setState(g?"ready":"empty"),this.open(!0),T("search",{term:e,products:i,collections:a,queries:h},this.root)}showCount(t){c(this.root,o("show")).forEach(e=>{let i=u(e,"show");i==="search-empty"&&d(e,t===0),i==="search-results"&&d(e,t>0)}),this.options().forEach((e,i)=>{e.id||(e.id=`${this.resultsId}-${i}`),e.setAttribute("aria-selected","false")})}highlight(t,e){t.forEach((a,h)=>{a.setAttribute("aria-selected",String(h===e))});let i=t[e];i&&(this.input.setAttribute("aria-activedescendant",i.id),i.scrollIntoView?.({block:"nearest"}))}onKeydown(t){let e=this.options(),i=e.findIndex(a=>a.getAttribute("aria-selected")==="true");t.key==="ArrowDown"&&e.length?(t.preventDefault(),this.open(!0),this.highlight(e,(i+1)%e.length)):t.key==="ArrowUp"&&e.length?(t.preventDefault(),this.highlight(e,i<=0?e.length-1:i-1)):t.key==="Enter"&&i>=0?(t.preventDefault(),e[i]?.click()):t.key==="Escape"&&this.open(!1)}};function Q(s=document){for(let t of I(s,o("search"))){if(q.has(t))continue;q.add(t);let e=t.querySelector(o("search-input"))??t.querySelector("input"),i=t.querySelector(o("search-results"));e&&i&&new f(t,e,i)}}var{Tether:v}=window;if(!v)throw new Error("tether.search.js runs after the Tether script, which loads it");v.__parts.search=p;})();
+(()=>{var T=Object.defineProperty;var D=(i,t,e)=>t in i?T(i,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):i[t]=e;var V=(i,t)=>{for(var e in t)T(i,e,{get:t[e],enumerable:!0})};var a=(i,t,e)=>D(i,typeof t!="symbol"?t+"":t,e);var g={};V(g,{mountSearch:()=>W});var O=window.Tether.__core["config.ts"],[u,X,b,Z,tt,y,et]=O;var F=window.Tether.__core["client.ts"],[it,E,w,A,st]=F;var K=window.Tether.__core["dom.ts"],[at,I,ot,L,lt,x,m,ct,ht,ut,mt,C,h,q,l,M,v,d]=K;var Q=window.Tether.__core["mounting.ts"],[pt,ft,gt,St,Tt,R]=Q;var j=A({predictiveSearch:w({products:[{priceRange:"object"}],collections:["object"],queries:[{text:"string"}]})}),Y="query TetherPredictive($q:String!,$limit:Int!){predictiveSearch(query:$q,limit:$limit,limitScope:EACH,types:[PRODUCT,COLLECTION,QUERY]){products{id handle title availableForSale featuredImage{url altText}priceRange{minVariantPrice{amount currencyCode}}}collections{handle title image{url altText}}queries{text}}}",B=6,J=2,z="/search",N=new WeakSet,P=0;function _(i,t,e){return parseInt(m(i,t)||"",10)||e}var U=i=>i.tagName==="A"?i:i.querySelector("a");function p(i,t){h(i,l("search-bind")).forEach(e=>{let r=m(e,"search-bind");r==="image"?M(e,t.image?.url,t.image?.altText||t.title):(r==="title"||r==="price"||r==="text")&&t[r]!=null&&v(e,t[r])})}function k(i,t){let e=U(i);e&&(t&&e.setAttribute("href",t),e.setAttribute("role","option"))}var f=class{constructor(t,e,r){a(this,"root");a(this,"input");a(this,"results");a(this,"limit");a(this,"minCharacters");a(this,"resultsId");a(this,"searchNumber",0);a(this,"timer");a(this,"lastTerm","");a(this,"cache",new Map);this.root=t,this.input=e,this.results=r,this.limit=_(t,"search-limit",B),this.minCharacters=_(t,"search-min",J),r.id||(P+=1,r.id=`${u.prefix}-search-${P}`),this.resultsId=r.id,this.setUpAria(),this.listen()}setUpAria(){this.input.setAttribute("role","combobox"),this.input.setAttribute("aria-autocomplete","list"),this.input.setAttribute("aria-controls",this.resultsId),this.input.setAttribute("aria-expanded","false"),this.input.setAttribute("autocomplete","off"),this.results.hasAttribute("role")||this.results.setAttribute("role","listbox"),this.results.hidden=!0}listen(){this.input.addEventListener("input",()=>{let t=this.input.value.trim();t!==this.lastTerm&&(this.lastTerm=t,clearTimeout(this.timer),this.timer=setTimeout(()=>void this.search(t),u.searchDelay))}),this.input.addEventListener("focus",()=>{this.input.value.trim().length>=this.minCharacters&&this.options().length&&this.open(!0)}),this.input.addEventListener("keydown",t=>{this.onKeydown(t)}),document.addEventListener("click",t=>{this.root.contains(t.target)||this.open(!1)})}setState(t){this.root.setAttribute(I("search-state"),t)}open(t){this.root.classList.toggle("is-open",t),this.results.hidden=!t,this.input.setAttribute("aria-expanded",String(t)),t||this.input.removeAttribute("aria-activedescendant")}options(){return h(this.results,'[role="option"]')}async fetchResults(t){let e=this.cache.get(t);if(e)return e;let r=await E(Y,{q:t,limit:this.limit},j);return this.cache.set(t,r.predictiveSearch),r.predictiveSearch}async search(t){this.searchNumber+=1;let e=this.searchNumber;if(t.length<this.minCharacters){this.open(!1),this.setState("idle");return}this.setState("loading");try{let r=await this.fetchResults(t);e===this.searchNumber&&this.render(r,t)}catch(r){if(e!==this.searchNumber){b("a superseded search failed",r);return}this.setState("error"),y(r,"search")}}fillList(t,e,r){h(this.results,l(t)).forEach(o=>{q(o,e,r),d(o,e.length>0)})}queryUrl(t){let e=this.root.getAttribute("action")||z,r=e.includes("?")?"&":"?";return`${e}${r}${this.input.name||"q"}=${encodeURIComponent(t)}`}render(t,e){let r=t?.products??[],o=t?.collections??[],c=(t?.queries??[]).filter(n=>n.text.toLowerCase()!==e.toLowerCase());this.fillList("search-products",r,(n,s)=>{let H=x(s.priceRange.minVariantPrice);p(n,{title:s.title,price:H,image:s.featuredImage}),k(n,C(s.handle,s.id)),n.classList.toggle("is-sold-out",!s.availableForSale)}),this.fillList("search-collections",o,(n,s)=>{p(n,{title:s.title,image:s.image}),k(n,`${(u.collectionPath||"/collection").replace(/\/$/,"")}/${s.handle}`)}),this.fillList("search-queries",c,(n,s)=>{p(n,{text:s.text}),U(n)?.setAttribute("href",this.queryUrl(s.text))});let S=r.length+o.length+c.length;this.showCount(S),this.setState(S?"ready":"empty"),this.open(!0),L("search",{term:e,products:r,collections:o,queries:c},this.root)}showCount(t){h(this.root,l("show")).forEach(e=>{let r=m(e,"show");r==="search-empty"&&d(e,t===0),r==="search-results"&&d(e,t>0)}),this.options().forEach((e,r)=>{e.id||(e.id=`${this.resultsId}-${r}`),e.setAttribute("aria-selected","false")})}highlight(t,e){t.forEach((o,c)=>{o.setAttribute("aria-selected",String(c===e))});let r=t[e];r&&(this.input.setAttribute("aria-activedescendant",r.id),r.scrollIntoView?.({block:"nearest"}))}onKeydown(t){let e=this.options(),r=e.findIndex(o=>o.getAttribute("aria-selected")==="true");t.key==="ArrowDown"&&e.length?(t.preventDefault(),this.open(!0),this.highlight(e,(r+1)%e.length)):t.key==="ArrowUp"&&e.length?(t.preventDefault(),this.highlight(e,r<=0?e.length-1:r-1)):t.key==="Enter"&&r>=0?(t.preventDefault(),e[r]?.click()):t.key==="Escape"&&this.open(!1)}};function W(i=document){for(let t of R(i,l("search"))){if(N.has(t))continue;N.add(t);let e=t.querySelector(l("search-input"))??t.querySelector("input"),r=t.querySelector(l("search-results"));e&&r&&new f(t,e,r)}}var{Tether:$}=window;if(!$)throw new Error("tether.search.js runs after the Tether script, which loads it");$.__parts.search=g;})();

package/dist/types/server/src/shared/account-orders.d.ts

@@ -0,0 +1,44 @@
+/** A `MoneyV2`. */
+interface Money {
+    amount: string;
+    currencyCode: string;
+}
+export interface AccountImage {
+    url: string;
+    altText: string | null;
+}
+/** A line of an order. */
+export interface AccountOrderLine {
+    title: string | null;
+    variantTitle: string | null;
+    quantity: number;
+    image: AccountImage | null;
+}
+/** An order in the customer's list. */
+export interface AccountOrder {
+    id: string;
+    name: string | null;
+    processedAt: string | null;
+    financialStatus: string | null;
+    fulfillmentStatus: string | null;
+    statusPageUrl: string | null;
+    totalPrice: Money | null;
+    lineItems: {
+        nodes: AccountOrderLine[];
+    };
+}
+/** `missing-id` when an order has no id, which each side reports in its own error type. */
+type OrdersReading = {
+    kind: 'read';
+    orders: AccountOrder[];
+} | {
+    kind: 'missing-id';
+};
+export declare function moneyOrNull(value: unknown): Money | null;
+export declare function imageOrNull(value: unknown): AccountImage | null;
+export declare const toOrderLine: (value: unknown) => AccountOrderLine;
+/**
+ * @param value A list of orders: Shopify's `orders.nodes`, or the `orders` of the Worker's `/orders`.
+ */
+export declare function readOrders(value: unknown): OrdersReading;
+export {};

package/dist/types/server/src/shared/account-routes.d.ts

@@ -0,0 +1,153 @@
+/**
+ * The Worker's routes for the customer account operations, the contract between the browser's account part and the
+ * Worker: what the browser sends for each operation, and which method and path it has under `/_tether/account`. The
+ * operations themselves (their documents and input checks) run only in the Worker, in `account/operations.ts`.
+ */
+export type SubscriptionAction = 'pause' | 'resume' | 'skip' | 'unskip' | 'cancel';
+/** Shopify's `CustomerAddressInput` fields; the Worker keeps only these, with bounded lengths. */
+export interface AddressFields {
+    firstName?: string;
+    lastName?: string;
+    company?: string;
+    address1?: string;
+    address2?: string;
+    city?: string;
+    zip?: string;
+    zoneCode?: string;
+    /** Two letters. */
+    countryCode?: string;
+    phoneNumber?: string;
+}
+export interface ReturnLine {
+    lineItemId: string;
+    quantity: number;
+    reasonId?: string;
+    note?: string;
+}
+/** What the browser sends for each operation. Ids are gids, or the number at their end. */
+export interface OperationInputs {
+    order: {
+        id: string | number;
+    };
+    addresses: Record<string, never>;
+    subscriptions: Record<string, never>;
+    profile: {
+        firstName?: string | undefined;
+        lastName?: string | undefined;
+    };
+    /** Without `id`, a new address; without fields, only makes the address the default. */
+    saveAddress: {
+        id?: string | undefined;
+        address: AddressFields | null;
+        isDefault?: boolean | undefined;
+    };
+    deleteAddress: {
+        id: string;
+    };
+    subscription: {
+        id: string | number;
+        action: SubscriptionAction;
+    };
+    requestReturn: {
+        orderId: string | number;
+        lines: ReturnLine[];
+    };
+}
+export type OperationName = keyof OperationInputs;
+/**
+ * Each operation's input fields as they reach the Worker: from a browser, a page script or anyone else, so each value
+ * is unchecked until the operation checks it.
+ */
+export type UncheckedInputs = {
+    [Name in OperationName]: {
+        readonly [Field in keyof OperationInputs[Name]]?: unknown;
+    };
+};
+/** One operation a Worker request asks for, with the fields its route reads, each one unchecked. */
+export interface OperationCall {
+    name: OperationName;
+    input: Readonly<Record<string, unknown>>;
+}
+export declare const OPERATION_ROUTES: {
+    order: {
+        name: "order";
+        method: "GET";
+        path: string;
+        fields: {
+            id: true;
+        };
+    };
+    addresses: {
+        name: "addresses";
+        method: "GET";
+        path: string;
+        fields: {};
+    };
+    subscriptions: {
+        name: "subscriptions";
+        method: "GET";
+        path: string;
+        fields: {};
+    };
+    profile: {
+        name: "profile";
+        method: "POST";
+        path: string;
+        fields: {
+            firstName: true;
+            lastName: true;
+        };
+    };
+    saveAddress: {
+        name: "saveAddress";
+        method: "POST";
+        path: string;
+        fields: {
+            id: true;
+            address: true;
+            isDefault: true;
+        };
+    };
+    deleteAddress: {
+        name: "deleteAddress";
+        method: "POST";
+        path: string;
+        fields: {
+            id: true;
+        };
+    };
+    subscription: {
+        name: "subscription";
+        method: "POST";
+        path: string;
+        fields: {
+            id: true;
+            action: true;
+        };
+    };
+    requestReturn: {
+        name: "requestReturn";
+        method: "POST";
+        path: string;
+        fields: {
+            orderId: true;
+            lines: true;
+        };
+    };
+};
+/**
+ * The operation a Worker request asks for, with its input read from the query string or the body.
+ *
+ * @param path The path under `/_tether/account`.
+ * @param body The JSON body of a POST; `{}` for a GET.
+ * @returns `null` when no operation has this method and path.
+ */
+export declare function operationCall(method: string, path: string, url: URL, body: Record<string, unknown>): OperationCall | null;
+/**
+ * The method and path (with its query string, for a GET) the browser requests an operation with. A POST sends the
+ * input as its JSON body.
+ */
+export declare function operationRequest<Name extends OperationName>(name: Name, input: OperationInputs[Name]): {
+    method: 'GET' | 'POST';
+    path: string;
+};

package/dist/types/server/src/shared/api-versions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The Shopify API versions Tether is built and smoke-tested against, for the browser script and the Worker alike. The
+ * three APIs are versioned separately, so each has its own constant even while they hold the same quarter. A new
+ * version must pass `npm run smoke` on both the pinned version and the next one.
+ */
+/** A dated, quarterly version such as `2026-07`. */
+export type ApiVersion = `${number}-${'01' | '04' | '07' | '10'}`;
+/** The Storefront API: products, carts, cart buyer identity. */
+export declare const STOREFRONT_API_VERSION: ApiVersion;
+/** The Customer Account API: the logged-in customer's orders, addresses and subscriptions. */
+export declare const CUSTOMER_ACCOUNT_API_VERSION: ApiVersion;
+/** The Admin API the sync reads products with. */
+export declare const ADMIN_API_VERSION: ApiVersion;

package/dist/types/server/src/shared/error-message.d.ts

@@ -0,0 +1,2 @@
+/** The text of anything thrown: an `Error`'s message, or the value itself written as text. */
+export declare function messageOf(error: unknown): string;

package/dist/types/server/src/shared/json.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Reading JSON that arrives from outside (Shopify's answers, a Worker request body) field by field, for the browser
+ * script and the Worker alike. Every reader takes `unknown`, so a missing or mistyped field is `undefined`, never a
+ * crash.
+ */
+/** A plain object, as parsed JSON holds it. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** The field `key` of `value`, or `undefined` when `value` is not a plain object. */
+export declare function field(value: unknown, key: string): unknown;
+/** The value when it is an array, else an empty list. */
+export declare function asList(value: unknown): unknown[];
+/** A non-empty string, or `null`: Shopify sends `""` and `null` alike for an unset text field. */
+export declare function textOrNull(value: unknown): string | null;
+export declare const numberOrNull: (value: unknown) => number | null;
+/** A count Shopify always sends; 0 for an answer without it. */
+export declare const countOrZero: (value: unknown) => number;
+export declare const listOf: <T>(value: unknown, read: (item: unknown) => T) => T[];
+/**
+ * @param connection A GraphQL connection: `{ nodes: [...] }`.
+ */
+export declare const nodesOf: <T>(connection: unknown, read: (item: unknown) => T) => {
+    nodes: T[];
+};
+/** The non-empty strings of a list. */
+export declare const textList: (value: unknown) => string[];

package/dist/types/server/src/shared/market-codes.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Country and language codes as Shopify takes them, parsed the same way in the browser and the Worker: anything that
+ * isn't a code is dropped rather than repaired.
+ */
+/** An ISO 3166-1 alpha-2 code, upper case. */
+export type CountryCode = string & {
+    readonly __brand: 'CountryCode';
+};
+/** A Shopify `LanguageCode` value. */
+export type LanguageCode = string & {
+    readonly __brand: 'LanguageCode';
+};
+/** @returns `'de'` → `'DE'`; `null` for anything that is not a country code. */
+export declare function toCountry(value: unknown): CountryCode | null;
+/** @returns `'de-DE'` → `'DE'`, `'pt-BR'` → `'PT_BR'`, `'en'` → `'EN'`; `null` otherwise. */
+export declare function toLanguage(value: unknown): LanguageCode | null;

package/dist/types/src/account/addresses-view.d.ts

@@ -0,0 +1,5 @@
+import type { CustomerAddress } from './page-answers.js';
+/** @returns The address with this id in the list shown last. */
+export declare const shownAddress: (id: string) => CustomerAddress | undefined;
+/** Loads and renders the addresses. A failure is reported and shows `addresses-error`, never "no addresses yet". */
+export declare function renderAddresses(root: ParentNode): Promise<void>;

package/dist/types/src/account/answers.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The Worker's account answers as typed values. The Worker passes on what Shopify answers to its fixed documents, and
+ * each answer is read once, field by field. Every field a document selects is kept. One that is missing or of another
+ * type reads as `null` (a list as empty, a count as 0): a page with one blank field is better than no page. The ids
+ * the pages act on are required, and an answer without one is an error. This module reads what the account part
+ * shows (the customer, their orders through the reader the Worker shares, Shopify's `userErrors`); page-answers.ts
+ * reads the account pages' answers.
+ */
+import { TetherError } from '../client.js';
+import type { UserError } from '../client.js';
+import type { AccountOrder } from '../../server/src/shared/account-orders.js';
+/** The logged-in customer. */
+export interface AccountCustomer {
+    /** The customer's gid; left out when the Worker's `/me` doesn't send it. */
+    id?: string;
+    firstName: string | null;
+    lastName: string | null;
+    displayName: string | null;
+    emailAddress: {
+        emailAddress: string;
+    } | null;
+    defaultAddress: {
+        formatted: string[];
+    } | null;
+}
+export declare const unexpected: (what: string) => TetherError;
+/**
+ * @param what Named in the error.
+ * @throws {TetherError} Without an id.
+ */
+export declare function requiredId(value: unknown, what: string): string;
+/** @param value The `customer` of the Worker's `/me`, which flattens the email and the default address. */
+export declare function toAccountCustomer(value: unknown): AccountCustomer;
+/**
+ * @param value The `orders` of the Worker's `/orders`.
+ * @throws {TetherError} For an order without an id.
+ */
+export declare function toAccountOrders(value: unknown): AccountOrder[];
+/** @param value Shopify's `userErrors`, as Shopify or the Worker sends them. */
+export declare const toUserErrors: (value: unknown) => UserError[];

package/dist/types/src/account/markup.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shows or hides each `name` element whose value is one of `conditions`' keys; other values are left alone.
+ *
+ * @param name `show`, `order-show`, `address-show`…
+ */
+export declare function showIn(root: ParentNode, name: string, conditions: Readonly<Record<string, boolean>>): void;
+/**
+ * @param row A copy of a repeater's template.
+ * @returns The `name` elements in `row`, and `row` itself when it carries `name`.
+ */
+export declare const bindsIn: (row: HTMLElement, name: string) => HTMLElement[];
+/** @returns A Shopify enum as text: `PARTIALLY_FULFILLED` → `partially fulfilled`. */
+export declare const enumText: (value: string | null | undefined) => string;
+/** @returns Shopify's formatted address on one line. */
+export declare const addressText: (address: {
+    formatted?: string[] | null;
+} | null | undefined) => string;
+/** A bind's value, looked up by the attribute's text: only the table's own keys, never `constructor` and the like. */
+export declare const ownValue: <T>(values: Readonly<Record<string, T>>, key: string) => T | undefined;

package/dist/types/src/account/operations.d.ts

@@ -0,0 +1,41 @@
+import type { AddressFields, ReturnLine, SubscriptionAction } from '../../server/src/shared/account-routes.js';
+export type { AddressFields, ReturnLine };
+import type { AccountAddress, CustomerAddress, OpenedReturn, OrderDetail, Profile, SubscriptionChange, SubscriptionContract } from './page-answers.js';
+import type { ServerAnswer, ServerRequest } from './server-client.js';
+import type { AccountCustomer } from './answers.js';
+/** The account part's session, shared so both parts act as one customer. */
+interface PagesContext {
+    serverFetch: (path: string, request?: ServerRequest) => Promise<ServerAnswer>;
+    customer: () => Promise<AccountCustomer | null>;
+    bindCustomer: (root: ParentNode) => Promise<void>;
+    /** Forgets the cached customer after a change of their data. */
+    reset: () => void;
+}
+/** Called by the account part once, when it loads this part. */
+export declare function setup(shared: PagesContext): void;
+/** @throws {Error} Before `setup`: this part is only ever loaded by the account part, which calls it first. */
+export declare function pagesContext(): PagesContext;
+/**
+ * One of the customer's orders, in full (lines, totals, addresses, fulfillments, returns).
+ *
+ * @param id A gid or the numeric order id.
+ * @returns `null` when the customer has no such order.
+ */
+export declare function order(id: string | number): Promise<OrderDetail | null>;
+export declare function updateProfile({ firstName, lastName, }?: {
+    firstName?: string;
+    lastName?: string;
+}): Promise<Profile>;
+/** @returns The customer's addresses, the default one marked `isDefault`. */
+export declare function addresses(): Promise<CustomerAddress[]>;
+/** Creates an address, or updates the one with `id`; without fields, only makes it the default. */
+export declare function saveAddress(address: AddressFields | null, { id, isDefault }?: {
+    id?: string | undefined;
+    isDefault?: boolean;
+}): Promise<AccountAddress>;
+/** @returns The deleted address's id. */
+export declare function deleteAddress(id: string): Promise<string>;
+export declare function subscriptions(): Promise<SubscriptionContract[]>;
+/** @returns The changed contract or billing cycle. */
+export declare function subscriptionAction(id: string | number, action: SubscriptionAction): Promise<SubscriptionChange>;
+export declare function requestReturn(orderId: string | number, lines: ReturnLine[]): Promise<OpenedReturn>;

package/dist/types/src/account/order-lines.d.ts

@@ -0,0 +1,13 @@
+import type { AccountOrderLine } from '../../server/src/shared/account-orders.js';
+import type { OrderDetailLine } from './page-answers.js';
+/** A line of the order list, or of the order page, which has the fields after `image` too. */
+type OrderLine = AccountOrderLine & Partial<Pick<OrderDetailLine, 'id' | 'name' | 'sku' | 'price' | 'totalPrice' | 'suggestedReturnReasonDefinitions'>>;
+/** Line id → how many of it can still be returned. */
+type Returnable = ReadonlyMap<string, number>;
+/**
+ * Renders `lines` into a `tether-order-lines` repeater.
+ *
+ * @param returns `null` for the order list.
+ */
+export declare function fillLines(box: HTMLElement, lines: readonly OrderLine[], returns: Returnable | null): void;
+export {};

package/dist/types/src/account/order-list.d.ts

@@ -0,0 +1,12 @@
+import type { AccountOrder } from '../../server/src/shared/account-orders.js';
+/** How many orders `orders()` answers, and a `tether-orders` list shows, without being told. */
+export declare const DEFAULT_ORDER_COUNT = 10;
+/** The most orders one request asks for: the Worker answers no more. */
+export declare const MAX_ORDER_COUNT = 50;
+/** @returns True for a number of orders one request can ask for: a whole number from 1 to `MAX_ORDER_COUNT`. */
+export declare const isOrderCount: (value: unknown) => value is number;
+/**
+ * Fills every `tether-orders` list in `root`. A failure is reported and leaves the lists empty, without claiming the
+ * customer has no orders.
+ */
+export declare function renderOrderList(root: ParentNode, loadOrders: (first: number) => Promise<AccountOrder[]>): Promise<void>;