@withpotter/lib 0.13.0-next.101

package/dist/intents/workflow-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/workflow-shape.ts"],"sourcesContent":["import type { FulfillmentStatus, OrderStatus } from '@withpotter/lib/api/types';\nimport { getIntentConfig } from './registry';\nimport { getAllowedOrderTransitions } from './order-transitions';\nimport {\n  resolveDeliveryAxis,\n  resolveMoneyAxis,\n  resolveNextAction,\n} from './order-progress';\nimport { resolveOrderStatusLabel } from './order-display';\nimport { firstObjectFor } from './archetype-flow';\n\n/**\n * The whole path an archetype runs, with nothing marked current.\n *\n * THE ONE PIECE OF NEW LOGIC. `order-progress.ts` answers \"where is THIS\n * order\" — it walks a path and marks one step `current`, which is the right\n * question on an order detail screen and the wrong one here. A workflow view\n * has no order in hand; it needs the same paths with no state on them.\n *\n * So this is a SPECIMEN, and everything about it is borrowed. The money lane\n * comes from `resolveMoneyAxis`, the fulfilment lane from `resolveDeliveryAxis`\n * — both handed the first state on their path purely so they will emit the\n * whole walk. The status graph comes from `getAllowedOrderTransitions`, the\n * words on the arrows from `resolveNextAction`, and every label from the\n * archetype's own `orderDisplay`. Nothing here decides anything a live order\n * does not already decide the same way, which is the point: if the drawing and\n * the order ever disagree, the drawing is lying.\n *\n * IT REPORTS WHAT IT COULD NOT DRAW rather than drawing it wrong. Three\n * archetypes carry status vocabularies that are not `OrderStatus` at all —\n * `send-invoices` (draft/sent/overdue/void), `capture-leads`\n * (new/converted/spam) and `subscriptions` (active/non_renewing/attention).\n * `getAllowedOrderTransitions` has no entry for any of them, so they fall to\n * `DEFAULT_TRANSITIONS`, which shares ZERO keys with what they actually use.\n * Walking it anyway would produce a confident graph of five stages none of\n * which that archetype has ever been in. `notes` carries the reason instead and\n * the lane is simply absent — the same argument as the tile that told every\n * storefront it had no page for products.\n */\n\nexport type StageTone = 'start' | 'live' | 'good' | 'end' | 'exit';\n\nexport interface WorkflowStage {\n  /** The status key, which is also the node id within its lane. */\n  key: string;\n  /** The archetype's own word for it. */\n  label: string;\n  tone: StageTone;\n}\n\nexport interface WorkflowEdge {\n  from: string;\n  to: string;\n  /** The button a merchant actually presses to make this move, when there is\n   *  one. Absent where the move is the customer's or the clock's. */\n  verb?: string;\n  /** An escape hatch — cancelled, refunded. Drawn quieter and downward. */\n  exit?: boolean;\n}\n\nexport interface WorkflowLane {\n  key: 'status' | 'money' | 'fulfilment';\n  /** The lane's own heading, in the archetype's words where it has one. */\n  label: string;\n  stages: WorkflowStage[];\n  edges: WorkflowEdge[];\n}\n\nexport interface WorkflowShape {\n  intentKey: string;\n  lanes: WorkflowLane[];\n  /** The first real object, so the drawing can say where it starts. */\n  start: { noun: string; cta: string; blurb: string; href: string };\n  /** What could not be drawn, and why. Rendered, never swallowed. */\n  notes: string[];\n}\n\n/**\n * Statuses that end the run rather than continue it.\n *\n * NOT `no_show`, though `take-bookings`, `event-tickets` and `rent-property`\n * all label one. It is not a member of `OrderStatus` at all, and no transition\n * map reaches it — so it is a word three archetypes have for a state the type\n * system says cannot exist. Listing it here would not draw it; it would just\n * fail to compile, which is how it was found. Recorded in the spec's drift\n * list rather than papered over with a cast.\n */\nconst EXITS: OrderStatus[] = ['cancelled', 'refunded'];\n\n/** Archetypes whose lifecycle is not an `OrderStatus` machine at all. */\nconst NOT_ORDER_SHAPED = new Set([\n  'send-invoices',\n  'capture-leads',\n  'subscriptions',\n]);\n\nfunction toneFor(key: string, index: number, lastIndex: number): StageTone {\n  if (EXITS.includes(key as OrderStatus)) return 'exit';\n  if (index === 0) return 'start';\n  if (index === lastIndex) return 'end';\n  return 'live';\n}\n\n/**\n * The status graph, walked breadth-first from `pending`.\n *\n * Breadth-first rather than a straight line because the graph genuinely\n * branches: a confirmed booking can be checked in OR completed outright, and\n * drawing only one of those would be inventing a rule the transition map does\n * not have.\n */\nfunction statusLane(\n  intentKey: string,\n  orderDisplay: ReturnType<typeof getIntentConfig> extends undefined\n    ? never\n    : NonNullable<ReturnType<typeof getIntentConfig>>['orderDisplay'],\n  canFulfill: boolean,\n): WorkflowLane {\n  const seen = new Set<OrderStatus>();\n  const order: OrderStatus[] = [];\n  /**\n   * Escape hatches are never QUEUED — walking on from `cancelled` would draw\n   * the default map's `cancelled → confirmed` back-edge as a real step — but\n   * they still have to be COLLECTED, or the lane ends up with edges pointing at\n   * stages that were never drawn. Which is exactly what shipped for an hour:\n   * the graph knew about Cancelled, the canvas had no node for it, and the\n   * layout silently dropped every edge leading there. Caught by looking at it.\n   */\n  const exitsSeen = new Set<OrderStatus>();\n  const edges: WorkflowEdge[] = [];\n  const queue: OrderStatus[] = ['pending'];\n\n  while (queue.length > 0) {\n    const current = queue.shift()!;\n    if (seen.has(current)) continue;\n    seen.add(current);\n    order.push(current);\n\n    for (const next of getAllowedOrderTransitions(current, intentKey)) {\n      // A back-edge (cancelled → confirmed exists in the default map) would\n      // draw an arrow travelling right to left under everything else. The\n      // forward walk is the story; the escape hatches are drawn as exits.\n      if (seen.has(next) && !EXITS.includes(next)) continue;\n      const exit = EXITS.includes(next);\n      const action = resolveNextAction({\n        status: current,\n        paymentStatus: 'paid',\n        fulfillmentStatus: 'fulfilled',\n        orderDisplay,\n        intentKey,\n        canFulfill,\n      });\n      edges.push({\n        from: current,\n        to: next,\n        exit,\n        // Only when the suggested next action IS this transition; otherwise the\n        // arrow would wear a verb belonging to a different move.\n        verb:\n          !exit && action.key === 'advance-status' && action.status === next\n            ? action.label\n            : undefined,\n      });\n      if (exit) exitsSeen.add(next);\n      else queue.push(next);\n    }\n  }\n\n  const forward = order.filter((s) => !EXITS.includes(s));\n  const exits = [...exitsSeen];\n  const stages = [...forward, ...exits].map((key) => ({\n    key,\n    label: resolveOrderStatusLabel(orderDisplay, key),\n    tone: toneFor(key, forward.indexOf(key), forward.length - 1),\n  }));\n\n  return {\n    key: 'status',\n    label: orderDisplay?.statusLabels ? 'Order' : 'Status',\n    stages,\n    edges,\n  };\n}\n\nexport function resolveWorkflowShape(intentKey: string): WorkflowShape | null {\n  const config = getIntentConfig(intentKey);\n  if (!config) return null;\n\n  const orderDisplay = config.orderDisplay;\n  const notes: string[] = [];\n  const lanes: WorkflowLane[] = [];\n\n  if (NOT_ORDER_SHAPED.has(intentKey)) {\n    notes.push(\n      `This one runs on its own states — ${Object.keys(\n        orderDisplay?.statusLabels ?? {},\n      )\n        .slice(0, 3)\n        .join(\n          ', ',\n        )} — which the shared transition map does not describe yet, so its stages are not drawn.`,\n    );\n  } else {\n    const canFulfill = !orderDisplay?.hideFulfillment;\n    lanes.push(statusLane(intentKey, orderDisplay, canFulfill));\n  }\n\n  /**\n   * Money is the one lane every archetype shares, and it is drawn even for the\n   * three above: an invoice and a subscription both still go unpaid → claimed →\n   * paid, whatever their own status machine calls the rest of it.\n   */\n  const money = resolveMoneyAxis('unpaid');\n  lanes.push({\n    key: 'money',\n    label: money.label,\n    stages: money.steps.map((s, i) => ({\n      key: s.key,\n      label: s.label,\n      tone: i === 0 ? 'start' : i === money.steps.length - 1 ? 'good' : 'live',\n    })),\n    edges: money.steps.slice(0, -1).map((s, i) => ({\n      from: s.key,\n      to: money.steps[i + 1].key,\n      // The only move on this lane a merchant makes. The first is the\n      // customer's; nothing on our side advances it.\n      verb: money.steps[i + 1].key === 'paid' ? 'Confirm payment' : undefined,\n    })),\n  });\n\n  /**\n   * Fulfilment, only where the archetype has one. `hideFulfillment` is the\n   * archetype saying there is nothing to hand over — a booking is attended, not\n   * shipped — and drawing an empty lane for it would be inventing a step.\n   */\n  if (!orderDisplay?.hideFulfillment) {\n    const delivery = resolveDeliveryAxis(orderDisplay, 'unfulfilled');\n    if (delivery.steps.length > 1) {\n      lanes.push({\n        key: 'fulfilment',\n        label: delivery.label,\n        stages: delivery.steps.map((s, i) => ({\n          key: s.key,\n          label: s.label,\n          tone:\n            i === 0\n              ? 'start'\n              : i === delivery.steps.length - 1\n                ? 'good'\n                : 'live',\n        })),\n        edges: delivery.steps.slice(0, -1).map((s, i) => {\n          const next = delivery.steps[i + 1];\n          const action = resolveNextAction({\n            status: 'confirmed',\n            paymentStatus: 'paid',\n            fulfillmentStatus: s.key as FulfillmentStatus,\n            orderDisplay,\n            intentKey,\n            canFulfill: true,\n          });\n          return {\n            from: s.key,\n            to: next.key,\n            verb:\n              action.key === 'fulfill' && action.fulfillmentStatus === next.key\n                ? action.label\n                : undefined,\n          };\n        }),\n      });\n    }\n  }\n\n  const first = firstObjectFor(intentKey);\n\n  return {\n    intentKey,\n    lanes,\n    start: {\n      noun: first.noun,\n      cta: first.cta,\n      blurb: first.blurb,\n      href: first.href,\n    },\n    notes,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/intents.d.ts

@@ -0,0 +1 @@
+export * from './intents/index';

package/dist/intents.js

@@ -0,0 +1 @@
+export * from './intents/index.js';

package/dist/invite-refusal.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Why an accept was refused, when the reason changes the advice.
+ *
+ * The accept screen used to fold every failure into one message: "We couldn't
+ * open this invite. The link may be incomplete. Ask for a fresh invite." For
+ * one of those failures that advice is actively wrong — a fresh invite to the
+ * same address fails in exactly the same way, because the refusal is not about
+ * the link at all. It is about who is holding it.
+ *
+ * The api binds an invite to the address it was sent to
+ * (`accept-team-invite.usecase.ts`, case-insensitive), which is the correct
+ * behaviour and is not changing. What was missing was a screen that says so.
+ */
+export type InviteRefusal = 'wrong-account' | 'needs-login' | 'unknown';
+/**
+ * `wrong-account` is matched on the message because the api has no code for it
+ * — a 400 with a sentence is all that crosses the wire. Kept to the two words
+ * that carry the meaning, so a rewording around them still lands here.
+ *
+ * Not signed in is NOT matched that way, and matching it that way is what broke
+ * the flow. `apiFetch` turns a 401 in the browser into `SessionExpiredError`,
+ * whose message is "Your session has expired" — no "401", no "unauthorized" —
+ * so every person clicking an invite from their email, which is every new
+ * joiner, since nobody is signed in when they click, fell through to the
+ * generic error: "We couldn't open this invite. Ask for a fresh invite." A
+ * fresh invite fails identically. Read the status the error carries, and the
+ * error's own name, rather than hoping a sentence keeps a substring.
+ */
+export declare function classifyInviteRefusal(error: unknown): InviteRefusal;
+/**
+ * An address shown to whoever is holding the link.
+ *
+ * The invite was emailed to this person, so the address is not news to them —
+ * but a link does travel, and a forwarded one should not hand its holder a
+ * colleague's full address to keep. Enough survives to recognise your own.
+ */
+export declare function maskEmail(email: string): string;

package/dist/invite-refusal.js

@@ -0,0 +1,26 @@
+function classifyInviteRefusal(error) {
+  if (typeof error === "object" && error !== null) {
+    const status = error.status;
+    const name = error.name;
+    if (status === 401 || name === "SessionExpiredError") return "needs-login";
+  }
+  const message = error instanceof Error ? error.message : String(error ?? "");
+  const lower = message.toLowerCase();
+  if (lower.includes("401") || lower.includes("unauthorized"))
+    return "needs-login";
+  if (lower.includes("different email")) return "wrong-account";
+  return "unknown";
+}
+function maskEmail(email) {
+  const at = email.lastIndexOf("@");
+  if (at < 1) return email;
+  const local = email.slice(0, at);
+  const domain = email.slice(at);
+  if (local.length <= 2) return `${local}${domain}`;
+  return `${local[0]}${"\u2022".repeat(Math.min(local.length - 2, 6))}${local[local.length - 1]}${domain}`;
+}
+export {
+  classifyInviteRefusal,
+  maskEmail
+};
+//# sourceMappingURL=invite-refusal.js.map

package/dist/invite-refusal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/invite-refusal.ts"],"sourcesContent":["/**\n * Why an accept was refused, when the reason changes the advice.\n *\n * The accept screen used to fold every failure into one message: \"We couldn't\n * open this invite. The link may be incomplete. Ask for a fresh invite.\" For\n * one of those failures that advice is actively wrong — a fresh invite to the\n * same address fails in exactly the same way, because the refusal is not about\n * the link at all. It is about who is holding it.\n *\n * The api binds an invite to the address it was sent to\n * (`accept-team-invite.usecase.ts`, case-insensitive), which is the correct\n * behaviour and is not changing. What was missing was a screen that says so.\n */\nexport type InviteRefusal = 'wrong-account' | 'needs-login' | 'unknown';\n\n/**\n * `wrong-account` is matched on the message because the api has no code for it\n * — a 400 with a sentence is all that crosses the wire. Kept to the two words\n * that carry the meaning, so a rewording around them still lands here.\n *\n * Not signed in is NOT matched that way, and matching it that way is what broke\n * the flow. `apiFetch` turns a 401 in the browser into `SessionExpiredError`,\n * whose message is \"Your session has expired\" — no \"401\", no \"unauthorized\" —\n * so every person clicking an invite from their email, which is every new\n * joiner, since nobody is signed in when they click, fell through to the\n * generic error: \"We couldn't open this invite. Ask for a fresh invite.\" A\n * fresh invite fails identically. Read the status the error carries, and the\n * error's own name, rather than hoping a sentence keeps a substring.\n */\nexport function classifyInviteRefusal(error: unknown): InviteRefusal {\n  if (typeof error === 'object' && error !== null) {\n    const status = (error as { status?: unknown }).status;\n    const name = (error as { name?: unknown }).name;\n    if (status === 401 || name === 'SessionExpiredError') return 'needs-login';\n  }\n\n  const message = error instanceof Error ? error.message : String(error ?? '');\n  const lower = message.toLowerCase();\n\n  if (lower.includes('401') || lower.includes('unauthorized'))\n    return 'needs-login';\n  if (lower.includes('different email')) return 'wrong-account';\n\n  return 'unknown';\n}\n\n/**\n * An address shown to whoever is holding the link.\n *\n * The invite was emailed to this person, so the address is not news to them —\n * but a link does travel, and a forwarded one should not hand its holder a\n * colleague's full address to keep. Enough survives to recognise your own.\n */\nexport function maskEmail(email: string): string {\n  const at = email.lastIndexOf('@');\n  if (at < 1) return email;\n\n  const local = email.slice(0, at);\n  const domain = email.slice(at);\n  // Two characters is the shortest local part that can be masked and still be\n  // recognisable. Below that there is nothing to hide behind, so it stays whole\n  // rather than becoming a row of dots that identifies nobody.\n  if (local.length <= 2) return `${local}${domain}`;\n\n  return `${local[0]}${'•'.repeat(Math.min(local.length - 2, 6))}${local[local.length - 1]}${domain}`;\n}\n"],"mappings":"AA6BO,SAAS,sBAAsB,OAA+B;AACnE,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,UAAM,SAAU,MAA+B;AAC/C,UAAM,OAAQ,MAA6B;AAC3C,QAAI,WAAW,OAAO,SAAS,sBAAuB,QAAO;AAAA,EAC/D;AAEA,QAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,SAAS,EAAE;AAC3E,QAAM,QAAQ,QAAQ,YAAY;AAElC,MAAI,MAAM,SAAS,KAAK,KAAK,MAAM,SAAS,cAAc;AACxD,WAAO;AACT,MAAI,MAAM,SAAS,iBAAiB,EAAG,QAAO;AAE9C,SAAO;AACT;AASO,SAAS,UAAU,OAAuB;AAC/C,QAAM,KAAK,MAAM,YAAY,GAAG;AAChC,MAAI,KAAK,EAAG,QAAO;AAEnB,QAAM,QAAQ,MAAM,MAAM,GAAG,EAAE;AAC/B,QAAM,SAAS,MAAM,MAAM,EAAE;AAI7B,MAAI,MAAM,UAAU,EAAG,QAAO,GAAG,KAAK,GAAG,MAAM;AAE/C,SAAO,GAAG,MAAM,CAAC,CAAC,GAAG,SAAI,OAAO,KAAK,IAAI,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,MAAM;AACnG;","names":[]}

package/dist/invoice-brand.d.ts

@@ -0,0 +1,28 @@
+import type { Tenant } from '@withpotter/lib/api/types';
+export interface InvoiceBrand {
+    /** The rule across the head of the sheet, and the invoice wordmark. */
+    color: string;
+    /** The fill behind the amount due. */
+    accent: string;
+}
+/** Neutral ink, for a business that has never picked a colour. */
+export declare const DEFAULT_INVOICE_BRAND: InvoiceBrand;
+export declare function isHex(value: string): boolean;
+/**
+ * The brand an invoice is drawn in.
+ *
+ * Read from the SAME `settings.colors` the storefront uses, deliberately: a
+ * business has one brand, and a second colour stored per surface is how the
+ * invoice and the shop drift apart without anyone deciding they should. The
+ * dialog that edits this says where else it shows.
+ */
+export declare function resolveInvoiceBrand(tenant: Pick<Tenant, 'settings'> | null | undefined): InvoiceBrand;
+/**
+ * Ink that can be read on a given fill.
+ *
+ * A merchant can pick any colour, and two of the three pickers in this product
+ * default to something pale — an accent used as a fill with white text on it is
+ * a figure the customer cannot read, on the one line of the document that says
+ * what they owe. Relative luminance decides, rather than a guess at the hue.
+ */
+export declare function readableOn(hex: string): string;

package/dist/invoice-brand.js

@@ -0,0 +1,33 @@
+const DEFAULT_INVOICE_BRAND = {
+  color: "#171717",
+  accent: "#f5f5f5"
+};
+const HEX = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i;
+function isHex(value) {
+  return HEX.test(value.trim());
+}
+function resolveInvoiceBrand(tenant) {
+  const colors = tenant?.settings?.colors ?? {};
+  return {
+    color: isHex(colors.primary ?? "") ? colors.primary : DEFAULT_INVOICE_BRAND.color,
+    accent: isHex(colors.accent ?? "") ? colors.accent : DEFAULT_INVOICE_BRAND.accent
+  };
+}
+function readableOn(hex) {
+  const value = hex.replace("#", "");
+  const full = value.length === 3 ? value.split("").map((c) => c + c).join("") : value;
+  if (full.length !== 6) return "#171717";
+  const channel = (start) => {
+    const v = parseInt(full.slice(start, start + 2), 16) / 255;
+    return v <= 0.03928 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4;
+  };
+  const luminance = 0.2126 * channel(0) + 0.7152 * channel(2) + 0.0722 * channel(4);
+  return luminance > 0.42 ? "#171717" : "#ffffff";
+}
+export {
+  DEFAULT_INVOICE_BRAND,
+  isHex,
+  readableOn,
+  resolveInvoiceBrand
+};
+//# sourceMappingURL=invoice-brand.js.map

package/dist/invoice-brand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/invoice-brand.ts"],"sourcesContent":["import type { Tenant } from '@withpotter/lib/api/types';\n\nexport interface InvoiceBrand {\n  /** The rule across the head of the sheet, and the invoice wordmark. */\n  color: string;\n  /** The fill behind the amount due. */\n  accent: string;\n}\n\n/** Neutral ink, for a business that has never picked a colour. */\nexport const DEFAULT_INVOICE_BRAND: InvoiceBrand = {\n  color: '#171717',\n  accent: '#f5f5f5',\n};\n\nconst HEX = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i;\n\nexport function isHex(value: string): boolean {\n  return HEX.test(value.trim());\n}\n\n/**\n * The brand an invoice is drawn in.\n *\n * Read from the SAME `settings.colors` the storefront uses, deliberately: a\n * business has one brand, and a second colour stored per surface is how the\n * invoice and the shop drift apart without anyone deciding they should. The\n * dialog that edits this says where else it shows.\n */\nexport function resolveInvoiceBrand(\n  tenant: Pick<Tenant, 'settings'> | null | undefined,\n): InvoiceBrand {\n  const colors = (tenant?.settings?.colors ?? {}) as {\n    primary?: string;\n    accent?: string;\n  };\n  return {\n    color: isHex(colors.primary ?? '')\n      ? colors.primary!\n      : DEFAULT_INVOICE_BRAND.color,\n    accent: isHex(colors.accent ?? '')\n      ? colors.accent!\n      : DEFAULT_INVOICE_BRAND.accent,\n  };\n}\n\n/**\n * Ink that can be read on a given fill.\n *\n * A merchant can pick any colour, and two of the three pickers in this product\n * default to something pale — an accent used as a fill with white text on it is\n * a figure the customer cannot read, on the one line of the document that says\n * what they owe. Relative luminance decides, rather than a guess at the hue.\n */\nexport function readableOn(hex: string): string {\n  const value = hex.replace('#', '');\n  const full =\n    value.length === 3\n      ? value\n          .split('')\n          .map((c) => c + c)\n          .join('')\n      : value;\n  if (full.length !== 6) return '#171717';\n\n  const channel = (start: number) => {\n    const v = parseInt(full.slice(start, start + 2), 16) / 255;\n    return v <= 0.03928 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4;\n  };\n  const luminance =\n    0.2126 * channel(0) + 0.7152 * channel(2) + 0.0722 * channel(4);\n  return luminance > 0.42 ? '#171717' : '#ffffff';\n}\n"],"mappings":"AAUO,MAAM,wBAAsC;AAAA,EACjD,OAAO;AAAA,EACP,QAAQ;AACV;AAEA,MAAM,MAAM;AAEL,SAAS,MAAM,OAAwB;AAC5C,SAAO,IAAI,KAAK,MAAM,KAAK,CAAC;AAC9B;AAUO,SAAS,oBACd,QACc;AACd,QAAM,SAAU,QAAQ,UAAU,UAAU,CAAC;AAI7C,SAAO;AAAA,IACL,OAAO,MAAM,OAAO,WAAW,EAAE,IAC7B,OAAO,UACP,sBAAsB;AAAA,IAC1B,QAAQ,MAAM,OAAO,UAAU,EAAE,IAC7B,OAAO,SACP,sBAAsB;AAAA,EAC5B;AACF;AAUO,SAAS,WAAW,KAAqB;AAC9C,QAAM,QAAQ,IAAI,QAAQ,KAAK,EAAE;AACjC,QAAM,OACJ,MAAM,WAAW,IACb,MACG,MAAM,EAAE,EACR,IAAI,CAAC,MAAM,IAAI,CAAC,EAChB,KAAK,EAAE,IACV;AACN,MAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,QAAM,UAAU,CAAC,UAAkB;AACjC,UAAM,IAAI,SAAS,KAAK,MAAM,OAAO,QAAQ,CAAC,GAAG,EAAE,IAAI;AACvD,WAAO,KAAK,UAAU,IAAI,UAAU,IAAI,SAAS,UAAU;AAAA,EAC7D;AACA,QAAM,YACJ,SAAS,QAAQ,CAAC,IAAI,SAAS,QAAQ,CAAC,IAAI,SAAS,QAAQ,CAAC;AAChE,SAAO,YAAY,OAAO,YAAY;AACxC;","names":[]}

package/dist/ios-navigation-context.d.ts

@@ -0,0 +1,11 @@
+type NavigationDirection = 'push' | 'pop' | 'none';
+interface IOSNavigationContextValue {
+    direction: NavigationDirection;
+    navigateTo: (href: string) => void;
+    goBack: () => void;
+}
+export declare function IOSNavigationProvider({ children, }: {
+    children: React.ReactNode;
+}): import("react").JSX.Element;
+export declare function useIOSNavigation(): IOSNavigationContextValue;
+export {};

package/dist/ios-navigation-context.js

@@ -0,0 +1,52 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useRef,
+  useState
+} from "react";
+import { useRouter } from "next/navigation";
+const IOSNavigationContext = createContext({
+  direction: "none",
+  navigateTo: () => {
+  },
+  goBack: () => {
+  }
+});
+function IOSNavigationProvider({
+  children
+}) {
+  const router = useRouter();
+  const [direction, setDirection] = useState("none");
+  const timerRef = useRef(void 0);
+  const resetDirection = useCallback(() => {
+    if (timerRef.current) clearTimeout(timerRef.current);
+    timerRef.current = setTimeout(() => {
+      setDirection("none");
+    }, 400);
+  }, []);
+  const navigateTo = useCallback(
+    (href) => {
+      setDirection("push");
+      resetDirection();
+      router.push(href);
+    },
+    [router, resetDirection]
+  );
+  const goBack = useCallback(() => {
+    setDirection("pop");
+    resetDirection();
+    router.back();
+  }, [router, resetDirection]);
+  return /* @__PURE__ */ jsx(IOSNavigationContext.Provider, { value: { direction, navigateTo, goBack }, children });
+}
+function useIOSNavigation() {
+  return useContext(IOSNavigationContext);
+}
+export {
+  IOSNavigationProvider,
+  useIOSNavigation
+};
+//# sourceMappingURL=ios-navigation-context.js.map

package/dist/ios-navigation-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ios-navigation-context.tsx"],"sourcesContent":["'use client';\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useRef,\n  useState,\n} from 'react';\nimport { useRouter } from 'next/navigation';\n\ntype NavigationDirection = 'push' | 'pop' | 'none';\n\ninterface IOSNavigationContextValue {\n  direction: NavigationDirection;\n  navigateTo: (href: string) => void;\n  goBack: () => void;\n}\n\nconst IOSNavigationContext = createContext<IOSNavigationContextValue>({\n  direction: 'none',\n  navigateTo: () => {},\n  goBack: () => {},\n});\n\nexport function IOSNavigationProvider({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  const router = useRouter();\n  const [direction, setDirection] = useState<NavigationDirection>('none');\n  const timerRef = useRef<ReturnType<typeof setTimeout>>(undefined);\n\n  const resetDirection = useCallback(() => {\n    if (timerRef.current) clearTimeout(timerRef.current);\n    timerRef.current = setTimeout(() => {\n      setDirection('none');\n    }, 400); // slightly longer than the 350ms animation\n  }, []);\n\n  const navigateTo = useCallback(\n    (href: string) => {\n      setDirection('push');\n      resetDirection();\n      router.push(href);\n    },\n    [router, resetDirection],\n  );\n\n  const goBack = useCallback(() => {\n    setDirection('pop');\n    resetDirection();\n    router.back();\n  }, [router, resetDirection]);\n\n  return (\n    <IOSNavigationContext.Provider value={{ direction, navigateTo, goBack }}>\n      {children}\n    </IOSNavigationContext.Provider>\n  );\n}\n\nexport function useIOSNavigation() {\n  return useContext(IOSNavigationContext);\n}\n"],"mappings":";AAyDI;AAvDJ;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,iBAAiB;AAU1B,MAAM,uBAAuB,cAAyC;AAAA,EACpE,WAAW;AAAA,EACX,YAAY,MAAM;AAAA,EAAC;AAAA,EACnB,QAAQ,MAAM;AAAA,EAAC;AACjB,CAAC;AAEM,SAAS,sBAAsB;AAAA,EACpC;AACF,GAEG;AACD,QAAM,SAAS,UAAU;AACzB,QAAM,CAAC,WAAW,YAAY,IAAI,SAA8B,MAAM;AACtE,QAAM,WAAW,OAAsC,MAAS;AAEhE,QAAM,iBAAiB,YAAY,MAAM;AACvC,QAAI,SAAS,QAAS,cAAa,SAAS,OAAO;AACnD,aAAS,UAAU,WAAW,MAAM;AAClC,mBAAa,MAAM;AAAA,IACrB,GAAG,GAAG;AAAA,EACR,GAAG,CAAC,CAAC;AAEL,QAAM,aAAa;AAAA,IACjB,CAAC,SAAiB;AAChB,mBAAa,MAAM;AACnB,qBAAe;AACf,aAAO,KAAK,IAAI;AAAA,IAClB;AAAA,IACA,CAAC,QAAQ,cAAc;AAAA,EACzB;AAEA,QAAM,SAAS,YAAY,MAAM;AAC/B,iBAAa,KAAK;AAClB,mBAAe;AACf,WAAO,KAAK;AAAA,EACd,GAAG,CAAC,QAAQ,cAAc,CAAC;AAE3B,SACE,oBAAC,qBAAqB,UAArB,EAA8B,OAAO,EAAE,WAAW,YAAY,OAAO,GACnE,UACH;AAEJ;AAEO,SAAS,mBAAmB;AACjC,SAAO,WAAW,oBAAoB;AACxC;","names":[]}

package/dist/legal-links.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The legal documents that are actually published, in one place.
+ *
+ * Only Terms and Privacy exist today, at these two addresses. Settings and the
+ * privacy screen used to link `/legal/terms`, `/legal/cookies`, `/legal/dpa` and
+ * `/legal/aup` on the bare domain — every one a 404. Add a document here only
+ * once its page is live, so no screen can link to something that is not there.
+ */
+export declare const TERMS_URL = "https://www.withpotter.com/terms";
+export declare const PRIVACY_URL = "https://www.withpotter.com/privacy";

package/dist/legal-links.js

@@ -0,0 +1,7 @@
+const TERMS_URL = "https://www.withpotter.com/terms";
+const PRIVACY_URL = "https://www.withpotter.com/privacy";
+export {
+  PRIVACY_URL,
+  TERMS_URL
+};
+//# sourceMappingURL=legal-links.js.map

package/dist/legal-links.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/legal-links.ts"],"sourcesContent":["/**\n * The legal documents that are actually published, in one place.\n *\n * Only Terms and Privacy exist today, at these two addresses. Settings and the\n * privacy screen used to link `/legal/terms`, `/legal/cookies`, `/legal/dpa` and\n * `/legal/aup` on the bare domain — every one a 404. Add a document here only\n * once its page is live, so no screen can link to something that is not there.\n */\nexport const TERMS_URL = 'https://www.withpotter.com/terms';\nexport const PRIVACY_URL = 'https://www.withpotter.com/privacy';\n"],"mappings":"AAQO,MAAM,YAAY;AAClB,MAAM,cAAc;","names":[]}

package/dist/letting-policy.d.ts

@@ -0,0 +1,85 @@
+/**
+ * THE POLICY, ASKED ONCE.
+ *
+ * Check-in at 2pm, out by 11am, free cancellation up to 24 hours, bookable 30
+ * days ahead: none of that is a fact about a particular property. It is how the
+ * business operates, and the item editor asked for all of it per item — so an
+ * operator with eight identical studios answered the same five questions eight
+ * times and had eight places for them to drift apart.
+ *
+ * Stored at `settings.letting`, a top level key of its own rather than a nest
+ * inside `settings.bookingSettings`. That is deliberate: the API merges tenant
+ * settings SHALLOW (`{ ...tenant.settings, ...patch }` in
+ * update-tenant-settings.usecase), so writing a nested object replaces its
+ * siblings wholesale. A sibling key cannot take the reminders and no-show
+ * policy down with it.
+ *
+ * An item may still differ — see the Booking panel's "Different for this
+ * property". These are defaults, not rules; the penthouse with a 3pm check-in
+ * is a real property and not a data-entry mistake.
+ */
+export interface LettingPolicy {
+    /** HH:mm. When the day starts for a stay. */
+    checkInTime: string;
+    /** HH:mm. When it ends. */
+    checkOutTime: string;
+    /**
+     * Hours before arrival that a free cancellation is still allowed.
+     *
+     * NOT stored under `letting`. It lives at
+     * `settings.bookingSettings.noShowPolicy.freeCancellationHours`, which is
+     * the field NoShowProtectionService reads when it works out what a
+     * cancellation costs — the only copy of this number any code consults. A
+     * second copy here would have been a third place to set one thing, and the
+     * two would have disagreed the first time somebody edited either.
+     */
+    cancellationHours: number;
+    /** How far ahead a guest may book, in days. */
+    advanceBookingDays: number;
+    /** Take part of the money up front to hold the dates. */
+    requiresDeposit: boolean;
+    /** Percentage of the total taken as that deposit. */
+    depositPercent: number;
+    /**
+     * Whether a cancellation inside the window costs the guest anything.
+     *
+     * `settings.bookingSettings.noShowPolicy.enabled`, the flag
+     * NoShowProtectionService checks before it charges for anything. It had no
+     * control anywhere in the dashboard, so the free-cancellation hours above
+     * could be set and could never take effect — and it could not be switched on
+     * by accident either, which is the only reason that was survivable: the
+     * defaults are `deposit` and `50`, so a stray toggle would have started
+     * charging real money.
+     */
+    chargeLateCancellations: boolean;
+    lateFeeType: 'percentage' | 'fixed' | 'deposit';
+    lateFeeValue: number;
+    /** No-show is the same policy's other half: booked, paid for, nobody came. */
+    chargeNoShows: boolean;
+    noShowFeeType: 'percentage' | 'fixed' | 'full' | 'deposit';
+    noShowFeeValue: number;
+    /** Minutes late before a booking may be called a no-show. */
+    gracePeriodMinutes: number;
+}
+export declare const DEFAULT_LETTING_POLICY: LettingPolicy;
+/** The shape of the two settings keys this policy is assembled from. */
+export interface LettingSettingsShape {
+    letting?: Partial<Omit<LettingPolicy, 'cancellationHours'>>;
+    bookingSettings?: {
+        noShowPolicy?: {
+            enabled?: boolean;
+            freeCancellationHours?: number;
+            lateCancellationFeeType?: 'percentage' | 'fixed' | 'deposit';
+            lateCancellationFeeValue?: number;
+            chargeNoShowFee?: boolean;
+            noShowFeeType?: 'percentage' | 'fixed' | 'full' | 'deposit';
+            noShowFeeValue?: number;
+            gracePeriodMinutes?: number;
+            [k: string]: unknown;
+        };
+        [k: string]: unknown;
+    };
+}
+export declare function coerceLettingPolicy(settings: LettingSettingsShape | undefined): LettingPolicy;
+/** Read the business policy wherever an item needs to show what it inherits. */
+export declare function useLettingPolicy(): LettingPolicy;

package/dist/letting-policy.js

@@ -0,0 +1,47 @@
+"use client";
+import { useAuth } from "@withpotter/lib/auth-context";
+const DEFAULT_LETTING_POLICY = {
+  checkInTime: "14:00",
+  checkOutTime: "11:00",
+  cancellationHours: 24,
+  advanceBookingDays: 365,
+  requiresDeposit: false,
+  depositPercent: 30,
+  chargeLateCancellations: false,
+  lateFeeType: "deposit",
+  lateFeeValue: 50,
+  chargeNoShows: false,
+  noShowFeeType: "deposit",
+  noShowFeeValue: 100,
+  gracePeriodMinutes: 15
+};
+function coerceLettingPolicy(settings) {
+  const d = DEFAULT_LETTING_POLICY;
+  const stored = settings?.letting;
+  const nsp = settings?.bookingSettings?.noShowPolicy;
+  return {
+    checkInTime: stored?.checkInTime || d.checkInTime,
+    checkOutTime: stored?.checkOutTime || d.checkOutTime,
+    cancellationHours: settings?.bookingSettings?.noShowPolicy?.freeCancellationHours ?? d.cancellationHours,
+    chargeLateCancellations: nsp?.enabled ?? d.chargeLateCancellations,
+    lateFeeType: nsp?.lateCancellationFeeType ?? d.lateFeeType,
+    lateFeeValue: nsp?.lateCancellationFeeValue ?? d.lateFeeValue,
+    chargeNoShows: nsp?.chargeNoShowFee ?? d.chargeNoShows,
+    noShowFeeType: nsp?.noShowFeeType ?? d.noShowFeeType,
+    noShowFeeValue: nsp?.noShowFeeValue ?? d.noShowFeeValue,
+    gracePeriodMinutes: nsp?.gracePeriodMinutes ?? d.gracePeriodMinutes,
+    advanceBookingDays: stored?.advanceBookingDays ?? d.advanceBookingDays,
+    requiresDeposit: stored?.requiresDeposit ?? d.requiresDeposit,
+    depositPercent: stored?.depositPercent ?? d.depositPercent
+  };
+}
+function useLettingPolicy() {
+  const { tenant } = useAuth();
+  return coerceLettingPolicy(tenant?.settings);
+}
+export {
+  DEFAULT_LETTING_POLICY,
+  coerceLettingPolicy,
+  useLettingPolicy
+};
+//# sourceMappingURL=letting-policy.js.map

package/dist/letting-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/letting-policy.ts"],"sourcesContent":["'use client';\n\nimport { useAuth } from '@withpotter/lib/auth-context';\n\n/**\n * THE POLICY, ASKED ONCE.\n *\n * Check-in at 2pm, out by 11am, free cancellation up to 24 hours, bookable 30\n * days ahead: none of that is a fact about a particular property. It is how the\n * business operates, and the item editor asked for all of it per item — so an\n * operator with eight identical studios answered the same five questions eight\n * times and had eight places for them to drift apart.\n *\n * Stored at `settings.letting`, a top level key of its own rather than a nest\n * inside `settings.bookingSettings`. That is deliberate: the API merges tenant\n * settings SHALLOW (`{ ...tenant.settings, ...patch }` in\n * update-tenant-settings.usecase), so writing a nested object replaces its\n * siblings wholesale. A sibling key cannot take the reminders and no-show\n * policy down with it.\n *\n * An item may still differ — see the Booking panel's \"Different for this\n * property\". These are defaults, not rules; the penthouse with a 3pm check-in\n * is a real property and not a data-entry mistake.\n */\nexport interface LettingPolicy {\n  /** HH:mm. When the day starts for a stay. */\n  checkInTime: string;\n  /** HH:mm. When it ends. */\n  checkOutTime: string;\n  /**\n   * Hours before arrival that a free cancellation is still allowed.\n   *\n   * NOT stored under `letting`. It lives at\n   * `settings.bookingSettings.noShowPolicy.freeCancellationHours`, which is\n   * the field NoShowProtectionService reads when it works out what a\n   * cancellation costs — the only copy of this number any code consults. A\n   * second copy here would have been a third place to set one thing, and the\n   * two would have disagreed the first time somebody edited either.\n   */\n  cancellationHours: number;\n  /** How far ahead a guest may book, in days. */\n  advanceBookingDays: number;\n  /** Take part of the money up front to hold the dates. */\n  requiresDeposit: boolean;\n  /** Percentage of the total taken as that deposit. */\n  depositPercent: number;\n\n  /**\n   * Whether a cancellation inside the window costs the guest anything.\n   *\n   * `settings.bookingSettings.noShowPolicy.enabled`, the flag\n   * NoShowProtectionService checks before it charges for anything. It had no\n   * control anywhere in the dashboard, so the free-cancellation hours above\n   * could be set and could never take effect — and it could not be switched on\n   * by accident either, which is the only reason that was survivable: the\n   * defaults are `deposit` and `50`, so a stray toggle would have started\n   * charging real money.\n   */\n  chargeLateCancellations: boolean;\n  lateFeeType: 'percentage' | 'fixed' | 'deposit';\n  lateFeeValue: number;\n  /** No-show is the same policy's other half: booked, paid for, nobody came. */\n  chargeNoShows: boolean;\n  noShowFeeType: 'percentage' | 'fixed' | 'full' | 'deposit';\n  noShowFeeValue: number;\n  /** Minutes late before a booking may be called a no-show. */\n  gracePeriodMinutes: number;\n}\n\nexport const DEFAULT_LETTING_POLICY: LettingPolicy = {\n  checkInTime: '14:00',\n  checkOutTime: '11:00',\n  cancellationHours: 24,\n  advanceBookingDays: 365,\n  requiresDeposit: false,\n  depositPercent: 30,\n  chargeLateCancellations: false,\n  lateFeeType: 'deposit',\n  lateFeeValue: 50,\n  chargeNoShows: false,\n  noShowFeeType: 'deposit',\n  noShowFeeValue: 100,\n  gracePeriodMinutes: 15,\n};\n\n/** The shape of the two settings keys this policy is assembled from. */\nexport interface LettingSettingsShape {\n  letting?: Partial<Omit<LettingPolicy, 'cancellationHours'>>;\n  bookingSettings?: {\n    noShowPolicy?: {\n      enabled?: boolean;\n      freeCancellationHours?: number;\n      lateCancellationFeeType?: 'percentage' | 'fixed' | 'deposit';\n      lateCancellationFeeValue?: number;\n      chargeNoShowFee?: boolean;\n      noShowFeeType?: 'percentage' | 'fixed' | 'full' | 'deposit';\n      noShowFeeValue?: number;\n      gracePeriodMinutes?: number;\n      [k: string]: unknown;\n    };\n    [k: string]: unknown;\n  };\n}\n\nexport function coerceLettingPolicy(\n  settings: LettingSettingsShape | undefined,\n): LettingPolicy {\n  const d = DEFAULT_LETTING_POLICY;\n  const stored = settings?.letting;\n  const nsp = settings?.bookingSettings?.noShowPolicy;\n  return {\n    checkInTime: stored?.checkInTime || d.checkInTime,\n    checkOutTime: stored?.checkOutTime || d.checkOutTime,\n    cancellationHours:\n      settings?.bookingSettings?.noShowPolicy?.freeCancellationHours ??\n      d.cancellationHours,\n    chargeLateCancellations: nsp?.enabled ?? d.chargeLateCancellations,\n    lateFeeType: nsp?.lateCancellationFeeType ?? d.lateFeeType,\n    lateFeeValue: nsp?.lateCancellationFeeValue ?? d.lateFeeValue,\n    chargeNoShows: nsp?.chargeNoShowFee ?? d.chargeNoShows,\n    noShowFeeType: nsp?.noShowFeeType ?? d.noShowFeeType,\n    noShowFeeValue: nsp?.noShowFeeValue ?? d.noShowFeeValue,\n    gracePeriodMinutes: nsp?.gracePeriodMinutes ?? d.gracePeriodMinutes,\n    advanceBookingDays: stored?.advanceBookingDays ?? d.advanceBookingDays,\n    requiresDeposit: stored?.requiresDeposit ?? d.requiresDeposit,\n    depositPercent: stored?.depositPercent ?? d.depositPercent,\n  };\n}\n\n/** Read the business policy wherever an item needs to show what it inherits. */\nexport function useLettingPolicy(): LettingPolicy {\n  const { tenant } = useAuth();\n  return coerceLettingPolicy(tenant?.settings as LettingSettingsShape);\n}\n"],"mappings":";AAEA,SAAS,eAAe;AAmEjB,MAAM,yBAAwC;AAAA,EACnD,aAAa;AAAA,EACb,cAAc;AAAA,EACd,mBAAmB;AAAA,EACnB,oBAAoB;AAAA,EACpB,iBAAiB;AAAA,EACjB,gBAAgB;AAAA,EAChB,yBAAyB;AAAA,EACzB,aAAa;AAAA,EACb,cAAc;AAAA,EACd,eAAe;AAAA,EACf,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,oBAAoB;AACtB;AAqBO,SAAS,oBACd,UACe;AACf,QAAM,IAAI;AACV,QAAM,SAAS,UAAU;AACzB,QAAM,MAAM,UAAU,iBAAiB;AACvC,SAAO;AAAA,IACL,aAAa,QAAQ,eAAe,EAAE;AAAA,IACtC,cAAc,QAAQ,gBAAgB,EAAE;AAAA,IACxC,mBACE,UAAU,iBAAiB,cAAc,yBACzC,EAAE;AAAA,IACJ,yBAAyB,KAAK,WAAW,EAAE;AAAA,IAC3C,aAAa,KAAK,2BAA2B,EAAE;AAAA,IAC/C,cAAc,KAAK,4BAA4B,EAAE;AAAA,IACjD,eAAe,KAAK,mBAAmB,EAAE;AAAA,IACzC,eAAe,KAAK,iBAAiB,EAAE;AAAA,IACvC,gBAAgB,KAAK,kBAAkB,EAAE;AAAA,IACzC,oBAAoB,KAAK,sBAAsB,EAAE;AAAA,IACjD,oBAAoB,QAAQ,sBAAsB,EAAE;AAAA,IACpD,iBAAiB,QAAQ,mBAAmB,EAAE;AAAA,IAC9C,gBAAgB,QAAQ,kBAAkB,EAAE;AAAA,EAC9C;AACF;AAGO,SAAS,mBAAkC;AAChD,QAAM,EAAE,OAAO,IAAI,QAAQ;AAC3B,SAAO,oBAAoB,QAAQ,QAAgC;AACrE;","names":[]}

package/dist/list-page-size.d.ts

@@ -0,0 +1,24 @@
+/**
+ * HOW MANY ROWS A LIST SHOWS BEFORE IT PAGES.
+ *
+ * Ten. John, 2026-09-03: *"every table on this our app should show 10 entries
+ * for default, not 20 — everywhere shows 20, it's too exhaustive, show 10."*
+ *
+ * He is right about the feeling and the reason is measurable: a twenty-row
+ * page on a 900px window puts the pager, the row count and every bulk action
+ * below the fold, so the controls that tell you where you are in a list are
+ * the ones you have to scroll to find. Ten fits a laptop with the summary band
+ * above it and the pager still on screen, which is what makes a list feel like
+ * something you are steering rather than something you are falling through.
+ *
+ * ONE CONSTANT, because the number was written out seventeen times across
+ * hooks, pages and API clients, and a default repeated seventeen times is a
+ * default that will be twenty in three of them within a year. Anything that
+ * pages a table reads this.
+ *
+ * NOT everything that says `limit: 20`. A product picker fetching twenty
+ * matches for a dropdown, a scan of recent shifts looking for a short drawer,
+ * a segment preview — those are not pages a merchant walks, and shrinking them
+ * would make a search feel broken rather than a list feel calm.
+ */
+export declare const LIST_PAGE_SIZE = 10;

package/dist/list-page-size.js

@@ -0,0 +1,5 @@
+const LIST_PAGE_SIZE = 10;
+export {
+  LIST_PAGE_SIZE
+};
+//# sourceMappingURL=list-page-size.js.map

package/dist/list-page-size.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/list-page-size.ts"],"sourcesContent":["/**\n * HOW MANY ROWS A LIST SHOWS BEFORE IT PAGES.\n *\n * Ten. John, 2026-09-03: *\"every table on this our app should show 10 entries\n * for default, not 20 — everywhere shows 20, it's too exhaustive, show 10.\"*\n *\n * He is right about the feeling and the reason is measurable: a twenty-row\n * page on a 900px window puts the pager, the row count and every bulk action\n * below the fold, so the controls that tell you where you are in a list are\n * the ones you have to scroll to find. Ten fits a laptop with the summary band\n * above it and the pager still on screen, which is what makes a list feel like\n * something you are steering rather than something you are falling through.\n *\n * ONE CONSTANT, because the number was written out seventeen times across\n * hooks, pages and API clients, and a default repeated seventeen times is a\n * default that will be twenty in three of them within a year. Anything that\n * pages a table reads this.\n *\n * NOT everything that says `limit: 20`. A product picker fetching twenty\n * matches for a dropdown, a scan of recent shifts looking for a short drawer,\n * a segment preview — those are not pages a merchant walks, and shrinking them\n * would make a search feel broken rather than a list feel calm.\n */\nexport const LIST_PAGE_SIZE = 10;\n"],"mappings":"AAuBO,MAAM,iBAAiB;","names":[]}

package/dist/live-events/sse-frames.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Pulls complete server-sent-event frames out of a growing text buffer.
+ *
+ * A frame ends at a blank line. Whatever follows the last blank line is an
+ * unfinished frame and stays in `rest` for the next chunk.
+ */
+export declare function takeFrames(buffer: string): {
+    frames: Array<{
+        event: string;
+        data: string;
+    }>;
+    rest: string;
+};
+/** React Query keys here are `['tenant', slug, name, ...]`. */
+export declare function isCommerceQueryKey(queryKey: readonly unknown[]): boolean;

package/dist/live-events/sse-frames.js

@@ -0,0 +1,37 @@
+function takeFrames(buffer) {
+  const normalised = buffer.replaceAll("\r\n", "\n");
+  const parts = normalised.split("\n\n");
+  const rest = parts.pop() ?? "";
+  const frames = [];
+  for (const part of parts) {
+    let event = "message";
+    const data = [];
+    for (const line of part.split("\n")) {
+      if (line.startsWith(":")) continue;
+      if (line.startsWith("event:")) event = line.slice(6).trim();
+      else if (line.startsWith("data:")) data.push(line.slice(5).trim());
+    }
+    frames.push({ event, data: data.join("\n") });
+  }
+  return { frames, rest };
+}
+const LIVE_KEY_PREFIXES = [
+  "order",
+  "customers",
+  "members",
+  "dashboard-",
+  "analytics",
+  "sales",
+  "transactions",
+  "activity",
+  "catalog-inventory"
+];
+function isCommerceQueryKey(queryKey) {
+  const name = queryKey[2];
+  return typeof name === "string" && LIVE_KEY_PREFIXES.some((prefix) => name.startsWith(prefix));
+}
+export {
+  isCommerceQueryKey,
+  takeFrames
+};
+//# sourceMappingURL=sse-frames.js.map

package/dist/live-events/sse-frames.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/live-events/sse-frames.ts"],"sourcesContent":["/**\n * Pulls complete server-sent-event frames out of a growing text buffer.\n *\n * A frame ends at a blank line. Whatever follows the last blank line is an\n * unfinished frame and stays in `rest` for the next chunk.\n */\nexport function takeFrames(buffer: string): {\n  frames: Array<{ event: string; data: string }>;\n  rest: string;\n} {\n  const normalised = buffer.replaceAll('\\r\\n', '\\n');\n  const parts = normalised.split('\\n\\n');\n  const rest = parts.pop() ?? '';\n  const frames: Array<{ event: string; data: string }> = [];\n\n  for (const part of parts) {\n    let event = 'message';\n    const data: string[] = [];\n\n    for (const line of part.split('\\n')) {\n      if (line.startsWith(':')) continue;\n      if (line.startsWith('event:')) event = line.slice(6).trim();\n      else if (line.startsWith('data:')) data.push(line.slice(5).trim());\n    }\n\n    frames.push({ event, data: data.join('\\n') });\n  }\n\n  return { frames, rest };\n}\n\n/** Query keys that show money, orders or customers and so go stale on a sale. */\nconst LIVE_KEY_PREFIXES = [\n  'order',\n  'customers',\n  'members',\n  'dashboard-',\n  'analytics',\n  'sales',\n  'transactions',\n  'activity',\n  'catalog-inventory',\n];\n\n/** React Query keys here are `['tenant', slug, name, ...]`. */\nexport function isCommerceQueryKey(queryKey: readonly unknown[]): boolean {\n  const name = queryKey[2];\n\n  return (\n    typeof name === 'string' &&\n    LIVE_KEY_PREFIXES.some((prefix) => name.startsWith(prefix))\n  );\n}\n"],"mappings":"AAMO,SAAS,WAAW,QAGzB;AACA,QAAM,aAAa,OAAO,WAAW,QAAQ,IAAI;AACjD,QAAM,QAAQ,WAAW,MAAM,MAAM;AACrC,QAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,QAAM,SAAiD,CAAC;AAExD,aAAW,QAAQ,OAAO;AACxB,QAAI,QAAQ;AACZ,UAAM,OAAiB,CAAC;AAExB,eAAW,QAAQ,KAAK,MAAM,IAAI,GAAG;AACnC,UAAI,KAAK,WAAW,GAAG,EAAG;AAC1B,UAAI,KAAK,WAAW,QAAQ,EAAG,SAAQ,KAAK,MAAM,CAAC,EAAE,KAAK;AAAA,eACjD,KAAK,WAAW,OAAO,EAAG,MAAK,KAAK,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC;AAAA,IACnE;AAEA,WAAO,KAAK,EAAE,OAAO,MAAM,KAAK,KAAK,IAAI,EAAE,CAAC;AAAA,EAC9C;AAEA,SAAO,EAAE,QAAQ,KAAK;AACxB;AAGA,MAAM,oBAAoB;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,SAAS,mBAAmB,UAAuC;AACxE,QAAM,OAAO,SAAS,CAAC;AAEvB,SACE,OAAO,SAAS,YAChB,kBAAkB,KAAK,CAAC,WAAW,KAAK,WAAW,MAAM,CAAC;AAE9D;","names":[]}

package/dist/location-options.d.ts

@@ -0,0 +1,16 @@
+export interface LocationStateNode {
+    state: string;
+    cities: string[];
+}
+export interface LocationCountryNode {
+    country: string;
+    states: LocationStateNode[];
+}
+export declare function useLocationOptions(): {
+    locations: LocationCountryNode[];
+    countries: string[];
+    loading: boolean;
+    error: string | null;
+    getStateOptionsForCountries: (selectedCountries: string[]) => string[];
+    getCityOptionsForCountriesAndStates: (selectedCountries: string[], selectedStates: string[]) => string[];
+};