@withpotter/lib 0.13.0-next.101

package/dist/currency.js

@@ -0,0 +1,25 @@
+const CURRENCY_SYMBOLS = {
+  NGN: "\u20A6",
+  USD: "$",
+  EUR: "\u20AC",
+  GBP: "\xA3",
+  CAD: "C$",
+  AUD: "A$",
+  GHS: "\u20B5",
+  KES: "KSh",
+  ZAR: "R",
+  INR: "\u20B9",
+  JPY: "\xA5",
+  CNY: "\xA5",
+  BRL: "R$",
+  MXN: "$",
+  AED: "\u062F.\u0625"
+};
+function getCurrencySymbol(code) {
+  return CURRENCY_SYMBOLS[code] || code;
+}
+export {
+  CURRENCY_SYMBOLS,
+  getCurrencySymbol
+};
+//# sourceMappingURL=currency.js.map

package/dist/currency.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/currency.ts"],"sourcesContent":["/**\n * Currency formatting helpers shared across dashboard forms and hooks.\n */\n\n// Currency code to symbol mapping\nexport const CURRENCY_SYMBOLS: Record<string, string> = {\n  NGN: '₦',\n  USD: '$',\n  EUR: '€',\n  GBP: '£',\n  CAD: 'C$',\n  AUD: 'A$',\n  GHS: '₵',\n  KES: 'KSh',\n  ZAR: 'R',\n  INR: '₹',\n  JPY: '¥',\n  CNY: '¥',\n  BRL: 'R$',\n  MXN: '$',\n  AED: 'د.إ',\n};\n\nexport function getCurrencySymbol(code: string): string {\n  return CURRENCY_SYMBOLS[code] || code;\n}\n"],"mappings":"AAKO,MAAM,mBAA2C;AAAA,EACtD,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AACP;AAEO,SAAS,kBAAkB,MAAsB;AACtD,SAAO,iBAAiB,IAAI,KAAK;AACnC;","names":[]}

package/dist/customer-helpers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared customer/member helper utilities.
+ *
+ * Extracted from customers/page.tsx and customers/[customerId]/page.tsx
+ * where they were duplicated verbatim.
+ */
+import type { CustomerType } from '@withpotter/lib/api/types';
+export declare function getTypeColor(type: CustomerType): {
+    bg: string;
+    text: string;
+    dot: string;
+};
+export declare function getTypeLabel(type: CustomerType): string;
+export declare function getInitials(name: string | null | undefined): string;
+/** Light readability spacing for a phone number; unusual values pass through. */
+export declare function formatPhone(phone: string): string;
+/**
+ * A customer's display identity. Phone is first-class (it's the WhatsApp
+ * handle): many customers have no email, and "name" is often a nickname or
+ * missing — so we resolve name → phone → email → "Guest" and never show a bare
+ * "Unnamed".
+ */
+export declare function getCustomerIdentity(member: {
+    name?: string | null;
+    email?: string | null;
+    phone?: string | null;
+}): {
+    primary: string;
+    secondary: string;
+};

package/dist/customer-helpers.js

@@ -0,0 +1,66 @@
+function getTypeColor(type) {
+  const colors = {
+    registered: {
+      bg: "bg-[var(--info-bg)]",
+      text: "text-[var(--info)]",
+      dot: "bg-[var(--info)]"
+    },
+    guest: {
+      bg: "bg-[var(--success-bg)]",
+      text: "text-[var(--success)]",
+      dot: "bg-[var(--success)]"
+    },
+    subscriber: {
+      bg: "bg-[var(--accent-secondary)]",
+      text: "text-[var(--accent-primary)]",
+      dot: "bg-[var(--accent-primary)]"
+    },
+    lead: {
+      bg: "bg-[var(--warning-bg)]",
+      text: "text-[var(--warning)]",
+      dot: "bg-[var(--warning)]"
+    }
+  };
+  return colors[type] || colors.guest;
+}
+function getTypeLabel(type) {
+  const labels = {
+    registered: "Registered",
+    guest: "Guest",
+    // The mailing list. Only `subscribe-newsletter.usecase.ts` sets this type;
+    // a paying member is a `customer_subscription` and never touches it.
+    subscriber: "Newsletter",
+    lead: "Lead"
+  };
+  return labels[type] || type;
+}
+function getInitials(name) {
+  if (!name) return "?";
+  return name.split(" ").map((n) => n[0]).join("").toUpperCase().slice(0, 2);
+}
+function formatPhone(phone) {
+  const d = phone.replace(/[^\d+]/g, "");
+  const m = d.match(/^(\+?\d{1,4})?(\d{3})(\d{3})(\d{2,4})$/);
+  return m ? [m[1], m[2], m[3], m[4]].filter(Boolean).join(" ") : phone;
+}
+function getCustomerIdentity(member) {
+  const name = member.name?.trim();
+  const email = member.email?.trim();
+  const phone = member.phone?.trim();
+  if (name)
+    return {
+      primary: name,
+      secondary: email || (phone ? formatPhone(phone) : "")
+    };
+  if (phone) return { primary: formatPhone(phone), secondary: email || "" };
+  if (email) return { primary: email, secondary: "" };
+  return { primary: "Guest", secondary: "" };
+}
+export {
+  formatPhone,
+  getCustomerIdentity,
+  getInitials,
+  getTypeColor,
+  getTypeLabel
+};
+//# sourceMappingURL=customer-helpers.js.map

package/dist/customer-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/customer-helpers.ts"],"sourcesContent":["/**\n * Shared customer/member helper utilities.\n *\n * Extracted from customers/page.tsx and customers/[customerId]/page.tsx\n * where they were duplicated verbatim.\n */\nimport type { CustomerType } from '@withpotter/lib/api/types';\n\nexport function getTypeColor(type: CustomerType) {\n  const colors: Record<\n    CustomerType,\n    { bg: string; text: string; dot: string }\n  > = {\n    registered: {\n      bg: 'bg-[var(--info-bg)]',\n      text: 'text-[var(--info)]',\n      dot: 'bg-[var(--info)]',\n    },\n    guest: {\n      bg: 'bg-[var(--success-bg)]',\n      text: 'text-[var(--success)]',\n      dot: 'bg-[var(--success)]',\n    },\n    subscriber: {\n      bg: 'bg-[var(--accent-secondary)]',\n      text: 'text-[var(--accent-primary)]',\n      dot: 'bg-[var(--accent-primary)]',\n    },\n    lead: {\n      bg: 'bg-[var(--warning-bg)]',\n      text: 'text-[var(--warning)]',\n      dot: 'bg-[var(--warning)]',\n    },\n  };\n  return colors[type] || colors.guest;\n}\n\nexport function getTypeLabel(type: CustomerType): string {\n  const labels: Record<CustomerType, string> = {\n    registered: 'Registered',\n    guest: 'Guest',\n    // The mailing list. Only `subscribe-newsletter.usecase.ts` sets this type;\n    // a paying member is a `customer_subscription` and never touches it.\n    subscriber: 'Newsletter',\n    lead: 'Lead',\n  };\n  return labels[type] || type;\n}\n\nexport function getInitials(name: string | null | undefined): string {\n  if (!name) return '?';\n  return name\n    .split(' ')\n    .map((n) => n[0])\n    .join('')\n    .toUpperCase()\n    .slice(0, 2);\n}\n\n/** Light readability spacing for a phone number; unusual values pass through. */\nexport function formatPhone(phone: string): string {\n  const d = phone.replace(/[^\\d+]/g, '');\n  const m = d.match(/^(\\+?\\d{1,4})?(\\d{3})(\\d{3})(\\d{2,4})$/);\n  return m ? [m[1], m[2], m[3], m[4]].filter(Boolean).join(' ') : phone;\n}\n\n/**\n * A customer's display identity. Phone is first-class (it's the WhatsApp\n * handle): many customers have no email, and \"name\" is often a nickname or\n * missing — so we resolve name → phone → email → \"Guest\" and never show a bare\n * \"Unnamed\".\n */\nexport function getCustomerIdentity(member: {\n  name?: string | null;\n  email?: string | null;\n  phone?: string | null;\n}): { primary: string; secondary: string } {\n  const name = member.name?.trim();\n  const email = member.email?.trim();\n  const phone = member.phone?.trim();\n  if (name)\n    return {\n      primary: name,\n      secondary: email || (phone ? formatPhone(phone) : ''),\n    };\n  if (phone) return { primary: formatPhone(phone), secondary: email || '' };\n  if (email) return { primary: email, secondary: '' };\n  return { primary: 'Guest', secondary: '' };\n}\n"],"mappings":"AAQO,SAAS,aAAa,MAAoB;AAC/C,QAAM,SAGF;AAAA,IACF,YAAY;AAAA,MACV,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,KAAK;AAAA,IACP;AAAA,IACA,OAAO;AAAA,MACL,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,KAAK;AAAA,IACP;AAAA,IACA,YAAY;AAAA,MACV,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,KAAK;AAAA,IACP;AAAA,IACA,MAAM;AAAA,MACJ,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,KAAK;AAAA,IACP;AAAA,EACF;AACA,SAAO,OAAO,IAAI,KAAK,OAAO;AAChC;AAEO,SAAS,aAAa,MAA4B;AACvD,QAAM,SAAuC;AAAA,IAC3C,YAAY;AAAA,IACZ,OAAO;AAAA;AAAA;AAAA,IAGP,YAAY;AAAA,IACZ,MAAM;AAAA,EACR;AACA,SAAO,OAAO,IAAI,KAAK;AACzB;AAEO,SAAS,YAAY,MAAyC;AACnE,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,KACJ,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EACf,KAAK,EAAE,EACP,YAAY,EACZ,MAAM,GAAG,CAAC;AACf;AAGO,SAAS,YAAY,OAAuB;AACjD,QAAM,IAAI,MAAM,QAAQ,WAAW,EAAE;AACrC,QAAM,IAAI,EAAE,MAAM,wCAAwC;AAC1D,SAAO,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG,IAAI;AAClE;AAQO,SAAS,oBAAoB,QAIO;AACzC,QAAM,OAAO,OAAO,MAAM,KAAK;AAC/B,QAAM,QAAQ,OAAO,OAAO,KAAK;AACjC,QAAM,QAAQ,OAAO,OAAO,KAAK;AACjC,MAAI;AACF,WAAO;AAAA,MACL,SAAS;AAAA,MACT,WAAW,UAAU,QAAQ,YAAY,KAAK,IAAI;AAAA,IACpD;AACF,MAAI,MAAO,QAAO,EAAE,SAAS,YAAY,KAAK,GAAG,WAAW,SAAS,GAAG;AACxE,MAAI,MAAO,QAAO,EAAE,SAAS,OAAO,WAAW,GAAG;AAClD,SAAO,EAAE,SAAS,SAAS,WAAW,GAAG;AAC3C;","names":[]}

package/dist/customer-stage.d.ts

@@ -0,0 +1,125 @@
+import type { Member, SegmentFilters } from '@withpotter/lib/api/types';
+/**
+ * Where a customer stands with the business, computed rather than stored.
+ *
+ * The table used to spend its most scannable column on `type` — Subscriber,
+ * Registered, Guest, Lead — which mixes account state with funnel stage and,
+ * more to the point, never changes based on anything the customer does. A
+ * merchant scanning that column learns how somebody signed up, not who is
+ * worth a phone call this week.
+ *
+ * Square ships two of these as smart groups before a merchant configures
+ * anything (Regulars: three visits in six months; Lapsed: a former regular
+ * gone six weeks), and Shopify leads its customer record with an RFM group.
+ * Both platforms answer "who is slipping away" on the surface. This is that
+ * answer, derived from the two fields every row already carries.
+ *
+ * `status` is taken on this entity (active/suspended/pending/deleted), so the
+ * word here is `stage` — which the domain expiry timeline already uses for the
+ * same shape of idea, down to `lost` being its final value.
+ */
+export type CustomerStage = 'prospect' | 'new' | 'regular' | 'at-risk' | 'lost';
+/**
+ * Thresholds, in days, gathered here because they are the whole opinion.
+ *
+ * REGULAR_ORDERS/REGULAR_WINDOW are Square's definition of a regular. QUIET is
+ * their six-week lapse trigger. GONE is the point past which we stop calling it
+ * a lapse and call it lost.
+ */
+export declare const STAGE_THRESHOLDS: {
+    readonly REGULAR_ORDERS: 3;
+    readonly REGULAR_WINDOW: 180;
+    readonly QUIET: 42;
+    readonly GONE: 180;
+};
+/**
+ * First match wins, and the order is the argument.
+ *
+ * "Lost" outranks "at risk" because a merchant chasing a win-back list wants
+ * the six-week group, not everybody who ever bought once. "At risk" outranks
+ * "regular" for the same reason it does at Square: somebody who was a regular
+ * and has gone quiet is the single most actionable row in the book, and if
+ * `regular` were checked first they would hide inside it until they were lost.
+ */
+export declare function customerStage(member: Pick<Member, 'totalOrders' | 'lastOrderAt'>, now?: number): CustomerStage;
+export interface StageMeta {
+    /** The merchant-facing word. Deliberately not a phrase. */
+    label: string;
+    /** What earns a row this stage, for the filter panel and the chip tooltip. */
+    hint: string;
+}
+/**
+ * Only `at-risk` carries colour.
+ *
+ * The old `type` column rendered four values in four brand colours, which made
+ * a table of ordinary customers look like a table of alerts. A stage is a fact
+ * about almost every row; the exception is the one that wants a phone call.
+ */
+export declare const STAGE_META: Record<CustomerStage, StageMeta>;
+/** Rail order: the arc from never-bought to gone, so the row reads left to right. */
+export declare const STAGE_ORDER: CustomerStage[];
+/**
+ * Whether a stage means anything for this business at all.
+ *
+ * VERIFIED in potter-api: `totalOrders`, `totalSpent` and `lastOrderAt` are
+ * incremented in exactly one place — the order-payment handler. No booking,
+ * enquiry or subscription path touches them. So for a club, a salon or a
+ * clinic, whose customers only ever book, every one of those three fields is
+ * permanently zero and every customer would compute as "Prospect": a rail
+ * reading `Prospect 46 · New 0 · Regular 0 · At risk 0 · Lost 0`, which is not
+ * a lie the merchant can even detect.
+ *
+ * `SegmentFilters` has no booking-shaped field either, so this cannot be fixed
+ * on the client — the counts come from the database and the database is only
+ * counting orders. Until Member carries a transaction-wide `lastActivityAt`,
+ * the honest move is to not show the column rather than to show a wrong one.
+ *
+ * Keyed on capability rather than on any named vertical: a business that can
+ * take an order or raise an invoice gets stages, whatever trade it is in.
+ */
+export declare function stagesApply(behaviors: readonly string[]): boolean;
+/**
+ * Whether this business records money against a customer at all.
+ *
+ * The same fact `stagesApply` turns on, named for the other thing it decides.
+ * `totalSpent`, `totalOrders` and `lastOrderAt` are written in exactly one
+ * place — the order-payment handler — so for a club or a clinic whose customers
+ * only book, all three are permanently zero. That makes a segment's value ₦0
+ * for every segment, which is not an amount, it is an absence wearing an
+ * amount. One predicate rather than two, because it is one question asked by
+ * two screens.
+ */
+export declare function customerSpendRecorded(behaviors: readonly string[]): boolean;
+/**
+ * The same five stages, written in the language saved segments already speak.
+ *
+ * This is the difference between a chip rail that is honest and one that is
+ * decorative. Computing a stage from a loaded row (above) labels the rows on
+ * the page correctly and can say nothing true about the ones on page 2 — so a
+ * count beside the chip would be a count of twenty rows dressed as a count of
+ * the book. `SegmentFilters` already carries `minOrders`, `maxOrders`,
+ * `lastOrderBefore` and `lastOrderAfter`, and `/crm/segments/preview` already
+ * counts against them, so every stage is expressible as a real query the
+ * database answers.
+ *
+ * It also means there is ONE mechanism here, not two: a built-in stage and a
+ * merchant's saved segment are the same kind of object, and the rail can show
+ * them side by side without the code branching on which is which.
+ */
+export declare function stageFilters(stage: CustomerStage, now?: number): SegmentFilters;
+/**
+ * Whether this person can actually be sent anything.
+ *
+ * The customers list exists partly to pick a broadcast audience — the bulk bar
+ * offers WhatsApp, and the segment banner offers it to a whole segment — but
+ * the table gave no way to see who consents until after the rows were selected
+ * and the composer reported the shortfall. `source` was occupying the column
+ * that should have been answering this.
+ */
+export interface Reach {
+    email: boolean;
+    whatsapp: boolean;
+    /** Short label for the cell: the channels, or why there are none. */
+    label: string;
+}
+export declare function customerReach(member: Pick<Member, 'email' | 'phone' | 'acceptsMarketing'>): Reach;

package/dist/customer-stage.js

@@ -0,0 +1,113 @@
+import { BOX_HIDE_WHATSAPP } from "./box-channels";
+const STAGE_THRESHOLDS = {
+  REGULAR_ORDERS: 3,
+  REGULAR_WINDOW: 180,
+  QUIET: 42,
+  GONE: 180
+};
+const DAY = 24 * 60 * 60 * 1e3;
+function daysSince(iso, now) {
+  if (!iso) return null;
+  const then = new Date(iso).getTime();
+  if (Number.isNaN(then)) return null;
+  return Math.floor((now - then) / DAY);
+}
+function customerStage(member, now = Date.now()) {
+  const orders = member.totalOrders ?? 0;
+  if (orders === 0) return "prospect";
+  const quiet = daysSince(member.lastOrderAt, now);
+  if (quiet === null) return "new";
+  if (quiet > STAGE_THRESHOLDS.GONE) return "lost";
+  if (orders >= STAGE_THRESHOLDS.REGULAR_ORDERS) {
+    return quiet > STAGE_THRESHOLDS.QUIET ? "at-risk" : "regular";
+  }
+  return "new";
+}
+const STAGE_META = {
+  prospect: {
+    label: "Prospect",
+    hint: "Has not ordered yet"
+  },
+  new: {
+    label: "New",
+    hint: "Fewer than 3 orders, seen in the last 6 months"
+  },
+  regular: {
+    label: "Regular",
+    hint: "3 or more orders, seen in the last 6 weeks"
+  },
+  "at-risk": {
+    label: "At risk",
+    hint: "Was a regular, nothing for 6 weeks"
+  },
+  lost: {
+    label: "Lost",
+    hint: "Nothing for 6 months"
+  }
+};
+const STAGE_ORDER = [
+  "prospect",
+  "new",
+  "regular",
+  "at-risk",
+  "lost"
+];
+function stagesApply(behaviors) {
+  return customerSpendRecorded(behaviors);
+}
+function customerSpendRecorded(behaviors) {
+  return behaviors.includes("sellable") || behaviors.includes("billable");
+}
+function stageFilters(stage, now = Date.now()) {
+  const at = (daysAgo) => new Date(now - daysAgo * DAY).toISOString();
+  const quiet = at(STAGE_THRESHOLDS.QUIET);
+  const gone = at(STAGE_THRESHOLDS.GONE);
+  switch (stage) {
+    case "prospect":
+      return { maxOrders: 0 };
+    case "new":
+      return {
+        minOrders: 1,
+        maxOrders: STAGE_THRESHOLDS.REGULAR_ORDERS - 1,
+        lastOrderAfter: gone
+      };
+    case "regular":
+      return {
+        minOrders: STAGE_THRESHOLDS.REGULAR_ORDERS,
+        lastOrderAfter: quiet
+      };
+    case "at-risk":
+      return {
+        minOrders: STAGE_THRESHOLDS.REGULAR_ORDERS,
+        lastOrderBefore: quiet,
+        lastOrderAfter: gone
+      };
+    case "lost":
+      return { minOrders: 1, lastOrderBefore: gone };
+  }
+}
+function customerReach(member) {
+  if (!member.acceptsMarketing) {
+    return { email: false, whatsapp: false, label: "No consent" };
+  }
+  const email = Boolean(member.email);
+  const whatsapp = Boolean(member.phone) && !BOX_HIDE_WHATSAPP;
+  if (!email && !whatsapp) {
+    return { email, whatsapp, label: "No contact" };
+  }
+  const channels = [email && "Email", whatsapp && "WhatsApp"].filter(
+    Boolean
+  );
+  return { email, whatsapp, label: channels.join(" \xB7 ") };
+}
+export {
+  STAGE_META,
+  STAGE_ORDER,
+  STAGE_THRESHOLDS,
+  customerReach,
+  customerSpendRecorded,
+  customerStage,
+  stageFilters,
+  stagesApply
+};
+//# sourceMappingURL=customer-stage.js.map

package/dist/customer-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/customer-stage.ts"],"sourcesContent":["import type { Member, SegmentFilters } from '@withpotter/lib/api/types';\nimport { BOX_HIDE_WHATSAPP } from './box-channels';\n\n/**\n * Where a customer stands with the business, computed rather than stored.\n *\n * The table used to spend its most scannable column on `type` — Subscriber,\n * Registered, Guest, Lead — which mixes account state with funnel stage and,\n * more to the point, never changes based on anything the customer does. A\n * merchant scanning that column learns how somebody signed up, not who is\n * worth a phone call this week.\n *\n * Square ships two of these as smart groups before a merchant configures\n * anything (Regulars: three visits in six months; Lapsed: a former regular\n * gone six weeks), and Shopify leads its customer record with an RFM group.\n * Both platforms answer \"who is slipping away\" on the surface. This is that\n * answer, derived from the two fields every row already carries.\n *\n * `status` is taken on this entity (active/suspended/pending/deleted), so the\n * word here is `stage` — which the domain expiry timeline already uses for the\n * same shape of idea, down to `lost` being its final value.\n */\nexport type CustomerStage = 'prospect' | 'new' | 'regular' | 'at-risk' | 'lost';\n\n/**\n * Thresholds, in days, gathered here because they are the whole opinion.\n *\n * REGULAR_ORDERS/REGULAR_WINDOW are Square's definition of a regular. QUIET is\n * their six-week lapse trigger. GONE is the point past which we stop calling it\n * a lapse and call it lost.\n */\nexport const STAGE_THRESHOLDS = {\n  REGULAR_ORDERS: 3,\n  REGULAR_WINDOW: 180,\n  QUIET: 42,\n  GONE: 180,\n} as const;\n\nconst DAY = 24 * 60 * 60 * 1000;\n\nfunction daysSince(iso: string | null | undefined, now: number): number | null {\n  if (!iso) return null;\n  const then = new Date(iso).getTime();\n  if (Number.isNaN(then)) return null;\n  return Math.floor((now - then) / DAY);\n}\n\n/**\n * First match wins, and the order is the argument.\n *\n * \"Lost\" outranks \"at risk\" because a merchant chasing a win-back list wants\n * the six-week group, not everybody who ever bought once. \"At risk\" outranks\n * \"regular\" for the same reason it does at Square: somebody who was a regular\n * and has gone quiet is the single most actionable row in the book, and if\n * `regular` were checked first they would hide inside it until they were lost.\n */\nexport function customerStage(\n  member: Pick<Member, 'totalOrders' | 'lastOrderAt'>,\n  now: number = Date.now(),\n): CustomerStage {\n  const orders = member.totalOrders ?? 0;\n  if (orders === 0) return 'prospect';\n\n  const quiet = daysSince(member.lastOrderAt, now);\n  // Ordered, but we have no date for it. Treat the order as the evidence and\n  // let the row sit in `new` rather than inventing a lapse we cannot support.\n  if (quiet === null) return 'new';\n\n  if (quiet > STAGE_THRESHOLDS.GONE) return 'lost';\n  if (orders >= STAGE_THRESHOLDS.REGULAR_ORDERS) {\n    return quiet > STAGE_THRESHOLDS.QUIET ? 'at-risk' : 'regular';\n  }\n  return 'new';\n}\n\nexport interface StageMeta {\n  /** The merchant-facing word. Deliberately not a phrase. */\n  label: string;\n  /** What earns a row this stage, for the filter panel and the chip tooltip. */\n  hint: string;\n}\n\n/**\n * Only `at-risk` carries colour.\n *\n * The old `type` column rendered four values in four brand colours, which made\n * a table of ordinary customers look like a table of alerts. A stage is a fact\n * about almost every row; the exception is the one that wants a phone call.\n */\nexport const STAGE_META: Record<CustomerStage, StageMeta> = {\n  prospect: {\n    label: 'Prospect',\n    hint: 'Has not ordered yet',\n  },\n  new: {\n    label: 'New',\n    hint: 'Fewer than 3 orders, seen in the last 6 months',\n  },\n  regular: {\n    label: 'Regular',\n    hint: '3 or more orders, seen in the last 6 weeks',\n  },\n  'at-risk': {\n    label: 'At risk',\n    hint: 'Was a regular, nothing for 6 weeks',\n  },\n  lost: {\n    label: 'Lost',\n    hint: 'Nothing for 6 months',\n  },\n};\n\n/** Rail order: the arc from never-bought to gone, so the row reads left to right. */\nexport const STAGE_ORDER: CustomerStage[] = [\n  'prospect',\n  'new',\n  'regular',\n  'at-risk',\n  'lost',\n];\n\n/**\n * Whether a stage means anything for this business at all.\n *\n * VERIFIED in potter-api: `totalOrders`, `totalSpent` and `lastOrderAt` are\n * incremented in exactly one place — the order-payment handler. No booking,\n * enquiry or subscription path touches them. So for a club, a salon or a\n * clinic, whose customers only ever book, every one of those three fields is\n * permanently zero and every customer would compute as \"Prospect\": a rail\n * reading `Prospect 46 · New 0 · Regular 0 · At risk 0 · Lost 0`, which is not\n * a lie the merchant can even detect.\n *\n * `SegmentFilters` has no booking-shaped field either, so this cannot be fixed\n * on the client — the counts come from the database and the database is only\n * counting orders. Until Member carries a transaction-wide `lastActivityAt`,\n * the honest move is to not show the column rather than to show a wrong one.\n *\n * Keyed on capability rather than on any named vertical: a business that can\n * take an order or raise an invoice gets stages, whatever trade it is in.\n */\nexport function stagesApply(behaviors: readonly string[]): boolean {\n  return customerSpendRecorded(behaviors);\n}\n\n/**\n * Whether this business records money against a customer at all.\n *\n * The same fact `stagesApply` turns on, named for the other thing it decides.\n * `totalSpent`, `totalOrders` and `lastOrderAt` are written in exactly one\n * place — the order-payment handler — so for a club or a clinic whose customers\n * only book, all three are permanently zero. That makes a segment's value ₦0\n * for every segment, which is not an amount, it is an absence wearing an\n * amount. One predicate rather than two, because it is one question asked by\n * two screens.\n */\nexport function customerSpendRecorded(behaviors: readonly string[]): boolean {\n  return behaviors.includes('sellable') || behaviors.includes('billable');\n}\n\n// ── Stages as queries ───────────────────────────────────────────────────────\n\n/**\n * The same five stages, written in the language saved segments already speak.\n *\n * This is the difference between a chip rail that is honest and one that is\n * decorative. Computing a stage from a loaded row (above) labels the rows on\n * the page correctly and can say nothing true about the ones on page 2 — so a\n * count beside the chip would be a count of twenty rows dressed as a count of\n * the book. `SegmentFilters` already carries `minOrders`, `maxOrders`,\n * `lastOrderBefore` and `lastOrderAfter`, and `/crm/segments/preview` already\n * counts against them, so every stage is expressible as a real query the\n * database answers.\n *\n * It also means there is ONE mechanism here, not two: a built-in stage and a\n * merchant's saved segment are the same kind of object, and the rail can show\n * them side by side without the code branching on which is which.\n */\nexport function stageFilters(\n  stage: CustomerStage,\n  now: number = Date.now(),\n): SegmentFilters {\n  const at = (daysAgo: number) => new Date(now - daysAgo * DAY).toISOString();\n  const quiet = at(STAGE_THRESHOLDS.QUIET);\n  const gone = at(STAGE_THRESHOLDS.GONE);\n\n  switch (stage) {\n    case 'prospect':\n      return { maxOrders: 0 };\n    case 'new':\n      // Fewer than three orders, and not yet gone quiet enough to be lost.\n      return {\n        minOrders: 1,\n        maxOrders: STAGE_THRESHOLDS.REGULAR_ORDERS - 1,\n        lastOrderAfter: gone,\n      };\n    case 'regular':\n      return {\n        minOrders: STAGE_THRESHOLDS.REGULAR_ORDERS,\n        lastOrderAfter: quiet,\n      };\n    case 'at-risk':\n      // Was a regular, has gone quiet, but is not yet written off — the band\n      // between the two thresholds, which is the only group here that is worth\n      // interrupting someone's day over.\n      return {\n        minOrders: STAGE_THRESHOLDS.REGULAR_ORDERS,\n        lastOrderBefore: quiet,\n        lastOrderAfter: gone,\n      };\n    case 'lost':\n      return { minOrders: 1, lastOrderBefore: gone };\n  }\n}\n\n// ── Reachability ────────────────────────────────────────────────────────────\n\n/**\n * Whether this person can actually be sent anything.\n *\n * The customers list exists partly to pick a broadcast audience — the bulk bar\n * offers WhatsApp, and the segment banner offers it to a whole segment — but\n * the table gave no way to see who consents until after the rows were selected\n * and the composer reported the shortfall. `source` was occupying the column\n * that should have been answering this.\n */\nexport interface Reach {\n  email: boolean;\n  whatsapp: boolean;\n  /** Short label for the cell: the channels, or why there are none. */\n  label: string;\n}\n\nexport function customerReach(\n  member: Pick<Member, 'email' | 'phone' | 'acceptsMarketing'>,\n): Reach {\n  // Consent is one flag over both channels, so a withheld consent is the whole\n  // answer — say that rather than listing addresses nothing may be sent to.\n  if (!member.acceptsMarketing) {\n    return { email: false, whatsapp: false, label: 'No consent' };\n  }\n  const email = Boolean(member.email);\n  // A box that sends by email alone has no WhatsApp to reach anyone on.\n  const whatsapp = Boolean(member.phone) && !BOX_HIDE_WHATSAPP;\n  if (!email && !whatsapp) {\n    return { email, whatsapp, label: 'No contact' };\n  }\n  const channels = [email && 'Email', whatsapp && 'WhatsApp'].filter(\n    Boolean,\n  ) as string[];\n  return { email, whatsapp, label: channels.join(' · ') };\n}\n"],"mappings":"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","names":[]}

package/dist/dashboard-destinations.d.ts

@@ -0,0 +1,5 @@
+export interface DashboardDestination {
+    value: string;
+    label: string;
+}
+export declare const dashboardDestinations: DashboardDestination[];

package/dist/dashboard-destinations.js

@@ -0,0 +1,29 @@
+import { ACCOUNT_GROUPS, BUSINESS_GROUPS } from "@withpotter/components/sidebar/config";
+import {
+  platformNavigation,
+  universalCoreModules
+} from "./use-platform-modules";
+const settingsDestinations = [...BUSINESS_GROUPS, ...ACCOUNT_GROUPS].flatMap(
+  (group) => group.items.flatMap((item) => [
+    { value: item.href, label: item.name },
+    ...(item.match ?? []).map((route) => ({
+      value: route,
+      label: `${item.name} (${route.split("/").at(-1)?.replaceAll("-", " ")})`
+    }))
+  ])
+);
+const dashboardDestinations = Array.from(
+  new Map(
+    [
+      ...[...platformNavigation, ...universalCoreModules].map((module) => ({
+        value: module.href.split("?")[0],
+        label: module.name
+      })),
+      ...settingsDestinations
+    ].map((destination) => [destination.value, destination])
+  ).values()
+).sort((first, second) => first.label.localeCompare(second.label));
+export {
+  dashboardDestinations
+};
+//# sourceMappingURL=dashboard-destinations.js.map

package/dist/dashboard-destinations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dashboard-destinations.ts"],"sourcesContent":["import { ACCOUNT_GROUPS, BUSINESS_GROUPS } from '@withpotter/components/sidebar/config';\nimport {\n  platformNavigation,\n  universalCoreModules,\n} from './use-platform-modules';\n\nexport interface DashboardDestination {\n  value: string;\n  label: string;\n}\n\nconst settingsDestinations = [...BUSINESS_GROUPS, ...ACCOUNT_GROUPS].flatMap(\n  (group) =>\n    group.items.flatMap((item) => [\n      { value: item.href, label: item.name },\n      ...(item.match ?? []).map((route) => ({\n        value: route,\n        label: `${item.name} (${route.split('/').at(-1)?.replaceAll('-', ' ')})`,\n      })),\n    ]),\n);\n\nexport const dashboardDestinations: DashboardDestination[] = Array.from(\n  new Map(\n    [\n      ...[...platformNavigation, ...universalCoreModules].map((module) => ({\n        value: module.href.split('?')[0],\n        label: module.name,\n      })),\n      ...settingsDestinations,\n    ].map((destination) => [destination.value, destination] as const),\n  ).values(),\n).sort((first, second) => first.label.localeCompare(second.label));\n"],"mappings":"AAAA,SAAS,gBAAgB,uBAAuB;AAChD;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAOP,MAAM,uBAAuB,CAAC,GAAG,iBAAiB,GAAG,cAAc,EAAE;AAAA,EACnE,CAAC,UACC,MAAM,MAAM,QAAQ,CAAC,SAAS;AAAA,IAC5B,EAAE,OAAO,KAAK,MAAM,OAAO,KAAK,KAAK;AAAA,IACrC,IAAI,KAAK,SAAS,CAAC,GAAG,IAAI,CAAC,WAAW;AAAA,MACpC,OAAO;AAAA,MACP,OAAO,GAAG,KAAK,IAAI,KAAK,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,WAAW,KAAK,GAAG,CAAC;AAAA,IACvE,EAAE;AAAA,EACJ,CAAC;AACL;AAEO,MAAM,wBAAgD,MAAM;AAAA,EACjE,IAAI;AAAA,IACF;AAAA,MACE,GAAG,CAAC,GAAG,oBAAoB,GAAG,oBAAoB,EAAE,IAAI,CAAC,YAAY;AAAA,QACnE,OAAO,OAAO,KAAK,MAAM,GAAG,EAAE,CAAC;AAAA,QAC/B,OAAO,OAAO;AAAA,MAChB,EAAE;AAAA,MACF,GAAG;AAAA,IACL,EAAE,IAAI,CAAC,gBAAgB,CAAC,YAAY,OAAO,WAAW,CAAU;AAAA,EAClE,EAAE,OAAO;AACX,EAAE,KAAK,CAAC,OAAO,WAAW,MAAM,MAAM,cAAc,OAAO,KAAK,CAAC;","names":[]}

package/dist/demo-content-mock.d.ts

@@ -0,0 +1,22 @@
+import type { DemoContentAvailability, DemoContentClient, DemoContentStatus } from './api/demo-content';
+/**
+ * A stand-in server for the demo-content screens: tests, and previewing the
+ * screens with no backend. It holds the state the real one would, and moves a
+ * job along each time the status is read.
+ */
+export interface MockDemoOptions {
+    status?: DemoContentStatus;
+    availability?: DemoContentAvailability;
+    /** Reads before a started job finishes. */
+    stepsPerJob?: number;
+    /** Make the next calls to these fail with the server's message. */
+    failNext?: Partial<Record<keyof DemoContentClient, string>>;
+}
+export declare function createMockDemoClient(options?: MockDemoOptions): {
+    client: DemoContentClient;
+    calls: {
+        name: string;
+        args: unknown;
+    }[];
+    setStatus: (s: DemoContentStatus) => DemoContentStatus;
+};

package/dist/demo-content-mock.js

@@ -0,0 +1,70 @@
+function createMockDemoClient(options = {}) {
+  let status = options.status ?? { state: "none" };
+  const stepsPerJob = options.stepsPerJob ?? 3;
+  const failNext = { ...options.failNext ?? {} };
+  let step = 0;
+  let nextJob = 1;
+  const calls = [];
+  const maybeFail = (name) => {
+    const message = failNext[name];
+    if (message) {
+      delete failNext[name];
+      throw new Error(message);
+    }
+  };
+  const client = {
+    async status() {
+      calls.push({ name: "status", args: void 0 });
+      maybeFail("status");
+      if (status.state === "applying" || status.state === "clearing") {
+        step += 1;
+        if (step >= stepsPerJob) {
+          status = status.state === "applying" ? {
+            state: "applied",
+            pack: status.pack,
+            counts: { products: 12, collections: 3, pages: 4, media: 20 },
+            finishedAt: (/* @__PURE__ */ new Date()).toISOString()
+          } : { state: "none", finishedAt: (/* @__PURE__ */ new Date()).toISOString() };
+        } else {
+          status = {
+            ...status,
+            progress: { phase: "products", done: step, total: stepsPerJob }
+          };
+        }
+      }
+      return status;
+    },
+    async available() {
+      calls.push({ name: "available", args: void 0 });
+      maybeFail("available");
+      return options.availability ?? { available: true };
+    },
+    async apply(input) {
+      calls.push({ name: "apply", args: input });
+      maybeFail("apply");
+      step = 0;
+      status = {
+        state: "applying",
+        pack: { id: "pack", template: "demo", version: "1", audience: "all", hash: "h" },
+        progress: { phase: "media", done: 0, total: stepsPerJob },
+        startedAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      return { jobId: `job-${nextJob++}` };
+    },
+    async clear(args) {
+      calls.push({ name: "clear", args });
+      maybeFail("clear");
+      step = 0;
+      status = { ...status, state: "clearing", progress: { phase: "products", done: 0, total: stepsPerJob } };
+    },
+    async adopt(input) {
+      calls.push({ name: "adopt", args: input });
+      maybeFail("adopt");
+    }
+  };
+  return { client, calls, setStatus: (s) => status = s };
+}
+export {
+  createMockDemoClient
+};
+//# sourceMappingURL=demo-content-mock.js.map

package/dist/demo-content-mock.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/demo-content-mock.ts"],"sourcesContent":["import type {\n  DemoContentAvailability,\n  DemoContentClient,\n  DemoContentStatus,\n} from './api/demo-content';\n\n/**\n * A stand-in server for the demo-content screens: tests, and previewing the\n * screens with no backend. It holds the state the real one would, and moves a\n * job along each time the status is read.\n */\nexport interface MockDemoOptions {\n  status?: DemoContentStatus;\n  availability?: DemoContentAvailability;\n  /** Reads before a started job finishes. */\n  stepsPerJob?: number;\n  /** Make the next calls to these fail with the server's message. */\n  failNext?: Partial<Record<keyof DemoContentClient, string>>;\n}\n\nexport function createMockDemoClient(options: MockDemoOptions = {}) {\n  let status: DemoContentStatus = options.status ?? { state: 'none' };\n  const stepsPerJob = options.stepsPerJob ?? 3;\n  const failNext = { ...(options.failNext ?? {}) };\n  let step = 0;\n  let nextJob = 1;\n  const calls: { name: string; args: unknown }[] = [];\n\n  const maybeFail = (name: keyof DemoContentClient) => {\n    const message = failNext[name];\n    if (message) {\n      delete failNext[name];\n      throw new Error(message);\n    }\n  };\n\n  const client: DemoContentClient = {\n    async status() {\n      calls.push({ name: 'status', args: undefined });\n      maybeFail('status');\n      if (status.state === 'applying' || status.state === 'clearing') {\n        step += 1;\n        if (step >= stepsPerJob) {\n          status =\n            status.state === 'applying'\n              ? {\n                  state: 'applied',\n                  pack: status.pack,\n                  counts: { products: 12, collections: 3, pages: 4, media: 20 },\n                  finishedAt: new Date().toISOString(),\n                }\n              : { state: 'none', finishedAt: new Date().toISOString() };\n        } else {\n          status = {\n            ...status,\n            progress: { phase: 'products', done: step, total: stepsPerJob },\n          };\n        }\n      }\n      return status;\n    },\n    async available() {\n      calls.push({ name: 'available', args: undefined });\n      maybeFail('available');\n      return options.availability ?? { available: true };\n    },\n    async apply(input) {\n      calls.push({ name: 'apply', args: input });\n      maybeFail('apply');\n      step = 0;\n      status = {\n        state: 'applying',\n        pack: { id: 'pack', template: 'demo', version: '1', audience: 'all', hash: 'h' },\n        progress: { phase: 'media', done: 0, total: stepsPerJob },\n        startedAt: new Date().toISOString(),\n      };\n      return { jobId: `job-${nextJob++}` };\n    },\n    async clear(args) {\n      calls.push({ name: 'clear', args });\n      maybeFail('clear');\n      step = 0;\n      status = { ...status, state: 'clearing', progress: { phase: 'products', done: 0, total: stepsPerJob } };\n    },\n    async adopt(input) {\n      calls.push({ name: 'adopt', args: input });\n      maybeFail('adopt');\n    },\n  };\n  return { client, calls, setStatus: (s: DemoContentStatus) => (status = s) };\n}\n"],"mappings":"AAoBO,SAAS,qBAAqB,UAA2B,CAAC,GAAG;AAClE,MAAI,SAA4B,QAAQ,UAAU,EAAE,OAAO,OAAO;AAClE,QAAM,cAAc,QAAQ,eAAe;AAC3C,QAAM,WAAW,EAAE,GAAI,QAAQ,YAAY,CAAC,EAAG;AAC/C,MAAI,OAAO;AACX,MAAI,UAAU;AACd,QAAM,QAA2C,CAAC;AAElD,QAAM,YAAY,CAAC,SAAkC;AACnD,UAAM,UAAU,SAAS,IAAI;AAC7B,QAAI,SAAS;AACX,aAAO,SAAS,IAAI;AACpB,YAAM,IAAI,MAAM,OAAO;AAAA,IACzB;AAAA,EACF;AAEA,QAAM,SAA4B;AAAA,IAChC,MAAM,SAAS;AACb,YAAM,KAAK,EAAE,MAAM,UAAU,MAAM,OAAU,CAAC;AAC9C,gBAAU,QAAQ;AAClB,UAAI,OAAO,UAAU,cAAc,OAAO,UAAU,YAAY;AAC9D,gBAAQ;AACR,YAAI,QAAQ,aAAa;AACvB,mBACE,OAAO,UAAU,aACb;AAAA,YACE,OAAO;AAAA,YACP,MAAM,OAAO;AAAA,YACb,QAAQ,EAAE,UAAU,IAAI,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG;AAAA,YAC5D,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,UACrC,IACA,EAAE,OAAO,QAAQ,aAAY,oBAAI,KAAK,GAAE,YAAY,EAAE;AAAA,QAC9D,OAAO;AACL,mBAAS;AAAA,YACP,GAAG;AAAA,YACH,UAAU,EAAE,OAAO,YAAY,MAAM,MAAM,OAAO,YAAY;AAAA,UAChE;AAAA,QACF;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA,IACA,MAAM,YAAY;AAChB,YAAM,KAAK,EAAE,MAAM,aAAa,MAAM,OAAU,CAAC;AACjD,gBAAU,WAAW;AACrB,aAAO,QAAQ,gBAAgB,EAAE,WAAW,KAAK;AAAA,IACnD;AAAA,IACA,MAAM,MAAM,OAAO;AACjB,YAAM,KAAK,EAAE,MAAM,SAAS,MAAM,MAAM,CAAC;AACzC,gBAAU,OAAO;AACjB,aAAO;AACP,eAAS;AAAA,QACP,OAAO;AAAA,QACP,MAAM,EAAE,IAAI,QAAQ,UAAU,QAAQ,SAAS,KAAK,UAAU,OAAO,MAAM,IAAI;AAAA,QAC/E,UAAU,EAAE,OAAO,SAAS,MAAM,GAAG,OAAO,YAAY;AAAA,QACxD,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MACpC;AACA,aAAO,EAAE,OAAO,OAAO,SAAS,GAAG;AAAA,IACrC;AAAA,IACA,MAAM,MAAM,MAAM;AAChB,YAAM,KAAK,EAAE,MAAM,SAAS,KAAK,CAAC;AAClC,gBAAU,OAAO;AACjB,aAAO;AACP,eAAS,EAAE,GAAG,QAAQ,OAAO,YAAY,UAAU,EAAE,OAAO,YAAY,MAAM,GAAG,OAAO,YAAY,EAAE;AAAA,IACxG;AAAA,IACA,MAAM,MAAM,OAAO;AACjB,YAAM,KAAK,EAAE,MAAM,SAAS,MAAM,MAAM,CAAC;AACzC,gBAAU,OAAO;AAAA,IACnB;AAAA,EACF;AACA,SAAO,EAAE,QAAQ,OAAO,WAAW,CAAC,MAA0B,SAAS,EAAG;AAC5E;","names":[]}

package/dist/demo-content-poller.d.ts

@@ -0,0 +1,33 @@
+import type { DemoContentStatus } from './api/demo-content';
+/**
+ * Keeps asking the server how a demo-content job is going until it stops.
+ *
+ * No React in it, and the clock and the tab are handed in, so a test moves time
+ * by hand. The rules:
+ *
+ * - Asks once straight away, which is also what picks up a job that was
+ *   running when the page was closed and opened again.
+ * - Keeps asking only while the job is running (`applying` or `clearing`).
+ * - A hidden tab stops asking and asks once when it is shown again.
+ * - Requests never overlap; the next is timed from the end of the last.
+ * - A failed ask is not the end of the job: it backs off and tries again, and
+ *   reports the error without losing the last good answer.
+ */
+export interface DemoPollEnv {
+    isVisible: () => boolean;
+    onVisibilityChange: (listener: () => void) => () => void;
+    setTimer: (run: () => void, ms: number) => unknown;
+    clearTimer: (timer: unknown) => void;
+}
+export declare function browserDemoPollEnv(): DemoPollEnv;
+export interface DemoPollHandlers {
+    read: () => Promise<DemoContentStatus>;
+    onStatus: (status: DemoContentStatus) => void;
+    onError: (error: unknown) => void;
+}
+export interface DemoPoller {
+    /** Ask now (after the merchant starts or clears), then keep going while busy. */
+    refresh: () => void;
+    stop: () => void;
+}
+export declare function startDemoPoller(handlers: DemoPollHandlers, env?: DemoPollEnv): DemoPoller;