@fayz-ai/storefront 0.77.0 → 0.77.5

package/dist/analytics/StorefrontAnalytics.d.ts

@@ -0,0 +1,22 @@
+import type { ResolvedStorefrontConfig } from '../document/config';
+import { useCartStore } from '../stores/cart.store';
+type CartSnapshot = ReturnType<typeof useCartStore.getState>;
+/** The ordering flow: the menu, a product, the cart, the checkout, the order. */
+export declare function isOrderingPath(path: string, menuPath: string | undefined): boolean;
+/** What a cart change was, line by line: added or removed, and how many. */
+export declare function cartChanges(prev: Pick<CartSnapshot, 'lines'>, next: Pick<CartSnapshot, 'lines'>): {
+    kind: "added" | "removed";
+    line: CartSnapshot["lines"][number];
+    quantity: number;
+}[];
+/**
+ * Mounted once by the shell. Starts the analytics client when the store
+ * configured one, and reports what no single page owns: cart changes and a
+ * shopper leaving the ordering flow for the rest of the site.
+ */
+export declare function StorefrontAnalytics({ config, path }: {
+    config: ResolvedStorefrontConfig;
+    path: string;
+}): null;
+export {};
+//# sourceMappingURL=StorefrontAnalytics.d.ts.map

package/dist/analytics/StorefrontAnalytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorefrontAnalytics.d.ts","sourceRoot":"","sources":["../../src/analytics/StorefrontAnalytics.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,EAAE,YAAY,EAA+B,MAAM,sBAAsB,CAAA;AAIhF,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAA;AAE5D,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIlF;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC;UAIrE,OAAO,GAAG,SAAS;UAAQ,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;cAAY,MAAM;IAQpG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;IAAE,MAAM,EAAE,wBAAwB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,QAoDvG"}

package/dist/analytics/bus.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The storefront's own record of what a shopper does, kept apart from any
+ * analytics vendor: components report here, and whatever is listening (the
+ * PostHog client, a test, nothing) decides what to do with it.
+ *
+ * Events reported before anyone listens are held, so the first product view of
+ * a page load is not lost while the analytics client is still loading.
+ */
+export type StorefrontEventName = 'product_viewed' | 'product_added_to_cart' | 'product_removed_from_cart' | 'cart_viewed' | 'coupon_applied' | 'checkout_started' | 'checkout_step_viewed' | 'checkout_payment_selected' | 'checkout_error' | 'checkout_completed' | 'delivery_exit';
+export type StorefrontEventProperties = Record<string, string | number | boolean | null | undefined>;
+export interface StorefrontEvent {
+    name: StorefrontEventName;
+    properties: StorefrontEventProperties;
+    at: number;
+}
+type Listener = (event: StorefrontEvent) => void;
+type Identifier = (email: string) => void;
+export declare function trackStorefront(name: StorefrontEventName, properties?: StorefrontEventProperties): void;
+export declare function onStorefrontEvent(listener: Listener): () => void;
+/**
+ * The buyer said who they are (the checkout's e-mail). Handed to the analytics
+ * client to tie this visit to the orders the server reports; never sent on as
+ * an event property.
+ */
+export declare function identifyStorefrontBuyer(email: string): void;
+export declare function setStorefrontIdentifier(fn: Identifier | null): void;
+/** When this event was last reported on this page (0 = never). */
+export declare function lastStorefrontEventAt(name: StorefrontEventName): number;
+/** Test seam: forget listeners and held events. */
+export declare function resetStorefrontEvents(): void;
+export {};
+//# sourceMappingURL=bus.d.ts.map

package/dist/analytics/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/analytics/bus.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,uBAAuB,GACvB,2BAA2B,GAC3B,aAAa,GACb,gBAAgB,GAChB,kBAAkB,GAClB,sBAAsB,GACtB,2BAA2B,GAC3B,gBAAgB,GAChB,oBAAoB,GACpB,eAAe,CAAA;AAEnB,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAEpG,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAA;IACzB,UAAU,EAAE,yBAAyB,CAAA;IACrC,EAAE,EAAE,MAAM,CAAA;CACX;AAED,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;AAChD,KAAK,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;AASzC,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,EAAE,UAAU,GAAE,yBAA8B,GAAG,IAAI,CAY3G;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAUhE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK3D;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAMnE;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAEvE;AAED,mDAAmD;AACnD,wBAAgB,qBAAqB,IAAI,IAAI,CAM5C"}

package/dist/analytics/edge.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The store's own door to PostHog, for a Worker (or any fetch-style) host.
+ *
+ * Events sent to the store's domain under `/ingest` are not dropped by ad
+ * blockers the way requests to a known analytics host are, and the store needs
+ * no PostHog setting of its own: every store forwards to the same project.
+ *
+ *   if (url.pathname.startsWith('/ingest')) return posthogProxy(request)
+ */
+export interface PostHogProxyOptions {
+    /** The path the storefront's analytics client sends to. Default `/ingest`. */
+    prefix?: string;
+    /** PostHog's region. Default `us`. */
+    region?: 'us' | 'eu';
+}
+export declare function isPostHogProxyPath(pathname: string, prefix?: string): boolean;
+export declare function posthogProxy(request: Request, options?: PostHogProxyOptions): Promise<Response>;
+//# sourceMappingURL=edge.d.ts.map

package/dist/analytics/edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.d.ts","sourceRoot":"","sources":["../../src/analytics/edge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sCAAsC;IACtC,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CACrB;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAY,GAAG,OAAO,CAEhF;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAwBzG"}

package/dist/analytics/identity.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Who a buyer is, to analytics, without telling analytics who they are.
+ *
+ * `store:<store id>:<sha-256 of the lower-cased e-mail>`. The server computes
+ * the same string for the orders it reports (shop migration 0146), which is how
+ * a visit and its order meet in one person. The store id keeps one e-mail at two
+ * restaurants as two people: every store's buyers stay that store's.
+ */
+export declare function storeBuyerId(storeId: string, email: string): Promise<string | null>;
+//# sourceMappingURL=identity.d.ts.map

package/dist/analytics/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/analytics/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQzF"}

package/dist/analytics/index.d.ts

@@ -0,0 +1,5 @@
+export { trackStorefront, onStorefrontEvent, identifyStorefrontBuyer, type StorefrontEvent, type StorefrontEventName, type StorefrontEventProperties, } from './bus';
+export { storeBuyerId } from './identity';
+export { startStorefrontPostHog, type StorefrontAnalyticsConfig, type StorefrontPostHogConfig } from './posthog';
+export { StorefrontAnalytics, isOrderingPath, cartChanges } from './StorefrontAnalytics';
+//# sourceMappingURL=index.d.ts.map

package/dist/analytics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,sBAAsB,EAAE,KAAK,yBAAyB,EAAE,KAAK,uBAAuB,EAAE,MAAM,WAAW,CAAA;AAChH,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/analytics/posthog.d.ts

@@ -0,0 +1,31 @@
+export interface StorefrontPostHogConfig {
+    /** The project token (`phc_…`). Public by design: it can only send events. */
+    key: string;
+    /** The store this site sells for (its tenant id). Every event is grouped under it. */
+    storeId: string;
+    /** Where the client sends. Default `/ingest`, the store's own proxy (see `posthogProxy`). */
+    apiHost?: string;
+    /** The PostHog app, for links the toolbar opens. Default `https://us.posthog.com`. */
+    uiHost?: string;
+    /** Session replay. Default on; inputs are always masked. */
+    replay?: boolean;
+}
+export interface StorefrontAnalyticsConfig {
+    posthog?: StorefrontPostHogConfig;
+}
+interface StartContext {
+    storeName: string;
+    commerceMode: string;
+}
+/**
+ * Loads PostHog once per page, in the browser only, off the first paint.
+ *
+ * The store is attached to every event in `before_send` rather than with
+ * `posthog.group()`: `group()` turns on person processing for every anonymous
+ * visitor, and across hundreds of stores that is the difference between paying
+ * for buyers and paying for every passer-by. Only a buyer who reaches the
+ * checkout becomes a person (`identify` with the store-scoped buyer id).
+ */
+export declare function startStorefrontPostHog(config: StorefrontPostHogConfig, context: StartContext): Promise<void> | null;
+export {};
+//# sourceMappingURL=posthog.d.ts.map

package/dist/analytics/posthog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog.d.ts","sourceRoot":"","sources":["../../src/analytics/posthog.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAA;IACX,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAA;IACf,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,uBAAuB,CAAA;CAClC;AAED,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;CACrB;AAID;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,uBAAuB,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAkCnH"}

package/dist/app/createStorefrontApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createStorefrontApp.d.ts","sourceRoot":"","sources":["../../src/app/createStorefrontApp.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAA;AAMxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAM1D,OAAO,KAAK,EAAE,gBAAgB,EAA4B,MAAM,oBAAoB,CAAA;AACpF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAU3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAmKlD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAIzE;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,CAEhF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA8CpE;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;gFACgF;AAChF,wBAAgB,eAAe,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAE,oBAAyB,qBAcxF;AAgDD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAiBjF;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,gBAAgB,CAAA;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,UAAU,CAAC,EAAE,oBAAoB,CAAA;IACjC,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;CACxC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,KAAK,CAAC,aAAa,CAgBtF"}
+{"version":3,"file":"createStorefrontApp.d.ts","sourceRoot":"","sources":["../../src/app/createStorefrontApp.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAA;AAOxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAM1D,OAAO,KAAK,EAAE,gBAAgB,EAA4B,MAAM,oBAAoB,CAAA;AACpF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAU3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAmKlD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAIzE;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,CAEhF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA8CpE;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;gFACgF;AAChF,wBAAgB,eAAe,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,GAAE,oBAAyB,qBAcxF;AAiDD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAiBjF;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,gBAAgB,CAAA;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,UAAU,CAAC,EAAE,oBAAoB,CAAA;IACjC,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;CACxC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,KAAK,CAAC,aAAa,CAgBtF"}

package/dist/app/router.d.ts

@@ -35,8 +35,8 @@ export interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorEle
  * explicit targets are still handed to the browser.
  */
 export declare function Link({ to, children, onClick, target, ...rest }: LinkProps): React.DetailedReactHTMLElement<{
-    style?: React.CSSProperties | undefined;
     prefix?: string | undefined | undefined;
+    style?: React.CSSProperties | undefined;
     slot?: string | undefined | undefined;
     title?: string | undefined | undefined;
     download?: any;