@withpotter/lib 0.13.0-next.101

package/dist/editor-agent/use-converse.js

@@ -0,0 +1,130 @@
+"use client";
+import { useEffect, useRef, useState } from "react";
+import { usePathname } from "@withpotter/lib/use-pathname";
+import {
+  buildConverseRequest,
+  isMissingConversationSession,
+  streamConversation
+} from "./converse";
+import { isCompanionBusinessEnabled } from "./flag";
+function useConverse({ tenantSlug }) {
+  const pathname = usePathname();
+  const [messages, setMessages] = useState([]);
+  const [sessionId, setSessionId] = useState();
+  const [streaming, setStreaming] = useState(false);
+  const [error, setError] = useState();
+  const abortRef = useRef(null);
+  const previousPromptRef = useRef(void 0);
+  const previousPromptsRef = useRef([]);
+  useEffect(() => () => abortRef.current?.abort(), []);
+  async function send({
+    prompt,
+    selection,
+    context
+  }) {
+    const trimmed = prompt.trim();
+    if (!trimmed || streaming)
+      throw new Error("A conversation turn is already running.");
+    const userId = crypto.randomUUID();
+    const assistantId = crypto.randomUUID();
+    setMessages((current) => [
+      ...current.map((message) => ({ ...message, clarify: void 0 })),
+      { id: userId, role: "user", content: trimmed },
+      { id: assistantId, role: "assistant", content: "" }
+    ]);
+    setStreaming(true);
+    setError(void 0);
+    const controller = new AbortController();
+    abortRef.current = controller;
+    const previousPrompt = previousPromptRef.current;
+    const previousPrompts = previousPromptsRef.current;
+    const updateAssistant = (update) => {
+      setMessages(
+        (current) => current.map(
+          (message) => message.id === assistantId ? { ...message, ...update } : message
+        )
+      );
+    };
+    const onEvent = (event) => {
+      if (event.event === "narration") {
+        setMessages(
+          (current) => current.map(
+            (message) => message.id === assistantId ? { ...message, content: message.content + event.data.delta } : message
+          )
+        );
+      } else if (event.event === "domain") {
+        updateAssistant({ domain: event.data });
+      } else if (event.event === "evidence") {
+        updateAssistant({ evidence: event.data });
+      }
+    };
+    const openTurn = (activeSessionId) => streamConversation({
+      tenantSlug,
+      request: buildConverseRequest({
+        sessionId: activeSessionId,
+        prompt: trimmed,
+        previousPrompt,
+        previousPrompts,
+        selection,
+        context: activeSessionId ? void 0 : context,
+        businessEnabled: isCompanionBusinessEnabled(),
+        pathname
+      }),
+      signal: controller.signal,
+      onEvent
+    });
+    try {
+      let result;
+      try {
+        result = await openTurn(sessionId);
+      } catch (cause) {
+        if (!sessionId || !isMissingConversationSession(cause)) throw cause;
+        setSessionId(void 0);
+        result = await openTurn();
+      }
+      setSessionId(result.sessionId);
+      previousPromptRef.current = trimmed.slice(0, 4e3);
+      previousPromptsRef.current = [
+        ...previousPromptsRef.current,
+        trimmed.slice(0, 4e3)
+      ].slice(-5);
+      if (result.clarify) {
+        setMessages(
+          (current) => current.map(
+            (message) => message.id === assistantId && !message.content ? {
+              ...message,
+              content: result.clarify.question,
+              clarify: result.clarify
+            } : message
+          )
+        );
+      }
+      return result;
+    } catch (cause) {
+      const message = cause instanceof Error ? cause.message : "Conversation failed.";
+      setError(message);
+      setMessages(
+        (current) => current.filter((item) => item.id !== assistantId || item.content)
+      );
+      throw cause;
+    } finally {
+      setStreaming(false);
+      abortRef.current = null;
+    }
+  }
+  function reset() {
+    abortRef.current?.abort();
+    abortRef.current = null;
+    setSessionId(void 0);
+    previousPromptRef.current = void 0;
+    previousPromptsRef.current = [];
+    setMessages([]);
+    setError(void 0);
+    setStreaming(false);
+  }
+  return { messages, sessionId, streaming, error, send, reset };
+}
+export {
+  useConverse
+};
+//# sourceMappingURL=use-converse.js.map

package/dist/editor-agent/use-converse.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/editor-agent/use-converse.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useRef, useState } from 'react';\nimport { usePathname } from '@withpotter/lib/use-pathname';\nimport type {\n  BusinessEvidence,\n  CompanionDomain,\n  ConversationContext,\n  ConverseEvent,\n  EditSelection,\n} from './contracts';\nimport {\n  buildConverseRequest,\n  isMissingConversationSession,\n  streamConversation,\n  type ConverseTurnResult,\n} from './converse';\nimport { isCompanionBusinessEnabled } from './flag';\n\nexport interface ConversationMessage {\n  id: string;\n  role: 'user' | 'assistant';\n  content: string;\n  domain?: { domain: CompanionDomain; label: string };\n  evidence?: BusinessEvidence;\n  clarify?: { question: string; options?: string[] };\n}\n\nexport function useConverse({ tenantSlug }: { tenantSlug: string }) {\n  const pathname = usePathname();\n  const [messages, setMessages] = useState<ConversationMessage[]>([]);\n  const [sessionId, setSessionId] = useState<string>();\n  const [streaming, setStreaming] = useState(false);\n  const [error, setError] = useState<string>();\n  const abortRef = useRef<AbortController | null>(null);\n  const previousPromptRef = useRef<string | undefined>(undefined);\n  const previousPromptsRef = useRef<string[]>([]);\n\n  useEffect(() => () => abortRef.current?.abort(), []);\n\n  async function send({\n    prompt,\n    selection,\n    context,\n  }: {\n    prompt: string;\n    selection?: EditSelection;\n    context?: ConversationContext;\n  }): Promise<ConverseTurnResult> {\n    const trimmed = prompt.trim();\n    if (!trimmed || streaming)\n      throw new Error('A conversation turn is already running.');\n    const userId = crypto.randomUUID();\n    const assistantId = crypto.randomUUID();\n    setMessages((current) => [\n      ...current.map((message) => ({ ...message, clarify: undefined })),\n      { id: userId, role: 'user', content: trimmed },\n      { id: assistantId, role: 'assistant', content: '' },\n    ]);\n    setStreaming(true);\n    setError(undefined);\n    const controller = new AbortController();\n    abortRef.current = controller;\n    const previousPrompt = previousPromptRef.current;\n    const previousPrompts = previousPromptsRef.current;\n\n    const updateAssistant = (update: Partial<ConversationMessage>) => {\n      setMessages((current) =>\n        current.map((message) =>\n          message.id === assistantId ? { ...message, ...update } : message,\n        ),\n      );\n    };\n\n    const onEvent = (event: ConverseEvent) => {\n      if (event.event === 'narration') {\n        setMessages((current) =>\n          current.map((message) =>\n            message.id === assistantId\n              ? { ...message, content: message.content + event.data.delta }\n              : message,\n          ),\n        );\n      } else if (event.event === 'domain') {\n        updateAssistant({ domain: event.data });\n      } else if (event.event === 'evidence') {\n        updateAssistant({ evidence: event.data });\n      }\n    };\n\n    const openTurn = (activeSessionId?: string) =>\n      streamConversation({\n        tenantSlug,\n        request: buildConverseRequest({\n          sessionId: activeSessionId,\n          prompt: trimmed,\n          previousPrompt,\n          previousPrompts,\n          selection,\n          context: activeSessionId ? undefined : context,\n          businessEnabled: isCompanionBusinessEnabled(),\n          pathname,\n        }),\n        signal: controller.signal,\n        onEvent,\n      });\n\n    try {\n      let result: ConverseTurnResult;\n      try {\n        result = await openTurn(sessionId);\n      } catch (cause) {\n        if (!sessionId || !isMissingConversationSession(cause)) throw cause;\n        setSessionId(undefined);\n        result = await openTurn();\n      }\n      setSessionId(result.sessionId);\n      previousPromptRef.current = trimmed.slice(0, 4000);\n      previousPromptsRef.current = [\n        ...previousPromptsRef.current,\n        trimmed.slice(0, 4000),\n      ].slice(-5);\n      if (result.clarify) {\n        setMessages((current) =>\n          current.map((message) =>\n            message.id === assistantId && !message.content\n              ? {\n                  ...message,\n                  content: result.clarify!.question,\n                  clarify: result.clarify,\n                }\n              : message,\n          ),\n        );\n      }\n      return result;\n    } catch (cause) {\n      const message =\n        cause instanceof Error ? cause.message : 'Conversation failed.';\n      setError(message);\n      setMessages((current) =>\n        current.filter((item) => item.id !== assistantId || item.content),\n      );\n      throw cause;\n    } finally {\n      setStreaming(false);\n      abortRef.current = null;\n    }\n  }\n\n  function reset() {\n    abortRef.current?.abort();\n    abortRef.current = null;\n    setSessionId(undefined);\n    previousPromptRef.current = undefined;\n    previousPromptsRef.current = [];\n    setMessages([]);\n    setError(undefined);\n    setStreaming(false);\n  }\n\n  return { messages, sessionId, streaming, error, send, reset };\n}\n"],"mappings":"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","names":[]}

package/dist/effective-module-labels.d.ts

@@ -0,0 +1,17 @@
+type Labels = Record<string, string>;
+/**
+ * The module labels this business is entitled to use.
+ *
+ * `settings.moduleLabels` mixes two things that look identical: words a
+ * merchant typed, and words the platform stamped at provisioning from
+ * whichever intent was ticked first. Switching on Rent property stamped
+ * `customers: "Guests"` onto a business that also sold food and tickets, and
+ * the shared Customers row then read "Guests" everywhere.
+ *
+ * The API no longer stamps a business with several intents. Until its stored
+ * data is cleaned, the shared modules are read as the platform default for
+ * any business running more than one intent. A business with a single intent
+ * keeps its word: a hotel that only rents rooms is right to say Guests.
+ */
+export declare function effectiveModuleLabels(settings: Record<string, unknown> | undefined): Labels | undefined;
+export {};

package/dist/effective-module-labels.js

@@ -0,0 +1,14 @@
+const SHARED_MODULES = ["customers"];
+function effectiveModuleLabels(settings) {
+  const labels = settings?.moduleLabels;
+  if (!labels) return labels;
+  const intents = settings?.selectedIntents;
+  if (!Array.isArray(intents) || new Set(intents).size < 2) return labels;
+  const kept = { ...labels };
+  for (const key of SHARED_MODULES) delete kept[key];
+  return kept;
+}
+export {
+  effectiveModuleLabels
+};
+//# sourceMappingURL=effective-module-labels.js.map

package/dist/effective-module-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/effective-module-labels.ts"],"sourcesContent":["type Labels = Record<string, string>;\n\n/**\n * Modules every intent shares, so no single intent has the standing to name\n * them. Customers is one directory for the whole business: a person who bought\n * a ticket and a pizza is one customer.\n */\nconst SHARED_MODULES = ['customers'] as const;\n\n/**\n * The module labels this business is entitled to use.\n *\n * `settings.moduleLabels` mixes two things that look identical: words a\n * merchant typed, and words the platform stamped at provisioning from\n * whichever intent was ticked first. Switching on Rent property stamped\n * `customers: \"Guests\"` onto a business that also sold food and tickets, and\n * the shared Customers row then read \"Guests\" everywhere.\n *\n * The API no longer stamps a business with several intents. Until its stored\n * data is cleaned, the shared modules are read as the platform default for\n * any business running more than one intent. A business with a single intent\n * keeps its word: a hotel that only rents rooms is right to say Guests.\n */\nexport function effectiveModuleLabels(\n  settings: Record<string, unknown> | undefined,\n): Labels | undefined {\n  const labels = settings?.moduleLabels as Labels | undefined;\n  if (!labels) return labels;\n\n  const intents = settings?.selectedIntents;\n  if (!Array.isArray(intents) || new Set(intents).size < 2) return labels;\n\n  const kept = { ...labels };\n  for (const key of SHARED_MODULES) delete kept[key];\n  return kept;\n}\n"],"mappings":"AAOA,MAAM,iBAAiB,CAAC,WAAW;AAgB5B,SAAS,sBACd,UACoB;AACpB,QAAM,SAAS,UAAU;AACzB,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,UAAU,UAAU;AAC1B,MAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,IAAI,IAAI,OAAO,EAAE,OAAO,EAAG,QAAO;AAEjE,QAAM,OAAO,EAAE,GAAG,OAAO;AACzB,aAAW,OAAO,eAAgB,QAAO,KAAK,GAAG;AACjD,SAAO;AACT;","names":[]}

package/dist/embedded-frame.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The name given to the `<iframe>` that shows a dashboard page inside another
+ * page (the Workspace settings modal). A frame's `window.name` survives
+ * navigation inside it, so a link clicked in the frame is still known to be
+ * embedded on the next page, which a query string would not be.
+ */
+export declare const EMBED_FRAME_NAME = "box-embedded-frame";
+/** True when this document is the framed copy of a dashboard page. */
+export declare function isEmbeddedFrame(): boolean;
+/**
+ * `isEmbeddedFrame` as a hook. The server snapshot is `false`, so the first
+ * paint matches the server's markup and the framed copy switches over as soon
+ * as it hydrates.
+ */
+export declare function useEmbeddedFrame(): boolean;
+/** Posted to the parent page when Escape is pressed inside the framed copy. */
+export declare const EMBED_CLOSE_MESSAGE = "box:close-embedded-frame";
+/**
+ * Posted to the framed copy to move it to another settings page. The frame
+ * boots once and then navigates client-side, instead of the parent remounting
+ * the whole dashboard in a new frame for every section.
+ */
+export declare const EMBED_NAVIGATE_MESSAGE = "box:embedded-navigate";
+/**
+ * Posted by the framed copy to the parent once it has hydrated, and again each
+ * time its path changes (a link clicked inside it, a tab, a drill-in), so the
+ * window's rail and title follow the page rather than the last button pressed.
+ * The first one doubles as "ready": `onLoad` fires before hydration.
+ */
+export declare const EMBED_PATH_MESSAGE = "box:embedded-path";

package/dist/embedded-frame.js

@@ -0,0 +1,23 @@
+"use client";
+import { useSyncExternalStore } from "react";
+const EMBED_FRAME_NAME = "box-embedded-frame";
+function isEmbeddedFrame() {
+  return typeof window !== "undefined" && window.name === EMBED_FRAME_NAME;
+}
+const subscribe = () => () => {
+};
+function useEmbeddedFrame() {
+  return useSyncExternalStore(subscribe, isEmbeddedFrame, () => false);
+}
+const EMBED_CLOSE_MESSAGE = "box:close-embedded-frame";
+const EMBED_NAVIGATE_MESSAGE = "box:embedded-navigate";
+const EMBED_PATH_MESSAGE = "box:embedded-path";
+export {
+  EMBED_CLOSE_MESSAGE,
+  EMBED_FRAME_NAME,
+  EMBED_NAVIGATE_MESSAGE,
+  EMBED_PATH_MESSAGE,
+  isEmbeddedFrame,
+  useEmbeddedFrame
+};
+//# sourceMappingURL=embedded-frame.js.map

package/dist/embedded-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/embedded-frame.ts"],"sourcesContent":["'use client';\n\nimport { useSyncExternalStore } from 'react';\n\n/**\n * The name given to the `<iframe>` that shows a dashboard page inside another\n * page (the Workspace settings modal). A frame's `window.name` survives\n * navigation inside it, so a link clicked in the frame is still known to be\n * embedded on the next page, which a query string would not be.\n */\nexport const EMBED_FRAME_NAME = 'box-embedded-frame';\n\n/** True when this document is the framed copy of a dashboard page. */\nexport function isEmbeddedFrame(): boolean {\n  return typeof window !== 'undefined' && window.name === EMBED_FRAME_NAME;\n}\n\nconst subscribe = () => () => {};\n\n/**\n * `isEmbeddedFrame` as a hook. The server snapshot is `false`, so the first\n * paint matches the server's markup and the framed copy switches over as soon\n * as it hydrates.\n */\nexport function useEmbeddedFrame(): boolean {\n  return useSyncExternalStore(subscribe, isEmbeddedFrame, () => false);\n}\n\n/** Posted to the parent page when Escape is pressed inside the framed copy. */\nexport const EMBED_CLOSE_MESSAGE = 'box:close-embedded-frame';\n\n/**\n * Posted to the framed copy to move it to another settings page. The frame\n * boots once and then navigates client-side, instead of the parent remounting\n * the whole dashboard in a new frame for every section.\n */\nexport const EMBED_NAVIGATE_MESSAGE = 'box:embedded-navigate';\n\n/**\n * Posted by the framed copy to the parent once it has hydrated, and again each\n * time its path changes (a link clicked inside it, a tab, a drill-in), so the\n * window's rail and title follow the page rather than the last button pressed.\n * The first one doubles as \"ready\": `onLoad` fires before hydration.\n */\nexport const EMBED_PATH_MESSAGE = 'box:embedded-path';\n"],"mappings":";AAEA,SAAS,4BAA4B;AAQ9B,MAAM,mBAAmB;AAGzB,SAAS,kBAA2B;AACzC,SAAO,OAAO,WAAW,eAAe,OAAO,SAAS;AAC1D;AAEA,MAAM,YAAY,MAAM,MAAM;AAAC;AAOxB,SAAS,mBAA4B;AAC1C,SAAO,qBAAqB,WAAW,iBAAiB,MAAM,KAAK;AACrE;AAGO,MAAM,sBAAsB;AAO5B,MAAM,yBAAyB;AAQ/B,MAAM,qBAAqB;","names":[]}

package/dist/empty-state-copy.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Industry-aware empty state copy.
+ *
+ * Maps module + industry key to contextual empty state strings.
+ * Falls back to generic copy when the industry key is unknown or null.
+ *
+ * Usage:
+ *   const copy = getEmptyStateCopy('orders', industryKey);
+ *   <TableEmptyState title={copy.title} description={copy.description} />
+ */
+export interface EmptyStateCopy {
+    title: string;
+    description: string;
+}
+/**
+ * Get contextual empty state copy for a module + industry combination.
+ *
+ * @param moduleId  Platform module identifier (e.g. 'inventory', 'orders', 'bookings')
+ * @param industryKey  Tenant's industry key (e.g. 'beauty', 'hospitality') or null
+ * @returns { title, description } — always returns a value (falls back to generic copy)
+ */
+export declare function getEmptyStateCopy(moduleId: string, industryKey: string | null): EmptyStateCopy;
+/**
+ * Get the filtered empty state copy — used when search/filters are active.
+ * This is not industry-specific since "try adjusting your search" is universal.
+ */
+export declare function getFilteredEmptyStateCopy(moduleId: string): EmptyStateCopy;

package/dist/empty-state-copy.js

@@ -0,0 +1,167 @@
+const INDUSTRY_COPY = {
+  retail: {
+    inventory: {
+      title: "No products yet",
+      description: "Add your first product to start selling."
+    },
+    orders: {
+      title: "No orders yet",
+      description: "Orders will appear here when customers purchase your products."
+    }
+  },
+  beauty: {
+    inventory: {
+      title: "No services yet",
+      description: "Add your first service to start taking appointments."
+    },
+    orders: {
+      title: "No orders yet",
+      description: "Orders will show up when clients book your services."
+    },
+    bookings: {
+      title: "No appointments yet",
+      description: "Appointments will appear when clients book with you."
+    }
+  },
+  wellness: {
+    inventory: {
+      title: "No treatments yet",
+      description: "Add your first treatment to start taking appointments."
+    },
+    orders: {
+      title: "No orders yet",
+      description: "Orders will show up when clients book your services."
+    },
+    bookings: {
+      title: "No appointments yet",
+      description: "Appointments will appear when clients book with you."
+    }
+  },
+  hospitality: {
+    inventory: {
+      title: "No properties listed yet",
+      description: "Add your first property to start accepting reservations."
+    },
+    orders: {
+      title: "No orders yet",
+      description: "Orders will appear when guests complete their bookings."
+    },
+    bookings: {
+      title: "No reservations yet",
+      description: "Reservations will appear when guests book your property."
+    }
+  },
+  events: {
+    inventory: {
+      title: "No events yet",
+      description: "Create your first event to start selling tickets."
+    },
+    orders: {
+      title: "No orders yet",
+      description: "Orders will appear when attendees purchase tickets."
+    },
+    bookings: {
+      title: "No ticket orders yet",
+      description: "Ticket orders will appear when attendees buy tickets to your events."
+    },
+    customers: {
+      title: "No attendees yet",
+      description: "Your attendee list will grow as people purchase tickets to your events."
+    }
+  },
+  food: {
+    inventory: {
+      title: "No menu items yet",
+      description: "Add your first item to build your menu."
+    },
+    orders: {
+      title: "No orders yet",
+      description: "Orders will appear when customers place their first order."
+    }
+  },
+  fitness: {
+    inventory: {
+      title: "No classes yet",
+      description: "Add your first class to start accepting sign-ups."
+    },
+    orders: {
+      title: "No orders yet",
+      description: "Orders will appear when members sign up for classes."
+    },
+    bookings: {
+      title: "No sessions yet",
+      description: "Sessions will appear when members book a class."
+    }
+  },
+  professional: {
+    inventory: {
+      title: "No services yet",
+      description: "Add your first service to start taking appointments."
+    },
+    orders: {
+      title: "No orders yet",
+      description: "Orders will show up when clients book your services."
+    },
+    bookings: {
+      title: "No appointments yet",
+      description: "Appointments will appear when clients book with you."
+    }
+  },
+  creative: {
+    inventory: {
+      title: "No packages yet",
+      description: "Add your first package to start booking clients."
+    },
+    orders: {
+      title: "No orders yet",
+      description: "Orders will appear when clients purchase your work."
+    },
+    bookings: {
+      title: "No bookings yet",
+      description: "Bookings will appear when clients schedule sessions."
+    }
+  }
+};
+const DEFAULT_COPY = {
+  inventory: {
+    title: "No products found",
+    description: "Add products to get started."
+  },
+  orders: {
+    title: "No orders found",
+    description: "Orders will appear here when customers make purchases."
+  },
+  bookings: {
+    title: "No bookings found",
+    description: "Bookings will appear here when customers book with you."
+  },
+  customers: {
+    title: "No customers yet",
+    description: "Customers will appear here as they sign up or make purchases."
+  },
+  reviews: {
+    title: "No reviews yet",
+    description: "Reviews will appear here when customers leave feedback."
+  }
+};
+function getEmptyStateCopy(moduleId, industryKey) {
+  if (industryKey && INDUSTRY_COPY[industryKey]?.[moduleId]) {
+    return INDUSTRY_COPY[industryKey][moduleId];
+  }
+  return DEFAULT_COPY[moduleId] ?? {
+    title: "Nothing here yet",
+    description: "Content will appear here as it is created."
+  };
+}
+function getFilteredEmptyStateCopy(moduleId) {
+  const moduleName = moduleId === "inventory" ? "items" : moduleId;
+  return {
+    title: `No ${moduleName} found`,
+    description: "Try adjusting your search or filters."
+  };
+}
+export {
+  getEmptyStateCopy,
+  getFilteredEmptyStateCopy
+};
+//# sourceMappingURL=empty-state-copy.js.map

package/dist/empty-state-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/empty-state-copy.ts"],"sourcesContent":["/**\n * Industry-aware empty state copy.\n *\n * Maps module + industry key to contextual empty state strings.\n * Falls back to generic copy when the industry key is unknown or null.\n *\n * Usage:\n *   const copy = getEmptyStateCopy('orders', industryKey);\n *   <TableEmptyState title={copy.title} description={copy.description} />\n */\n\nexport interface EmptyStateCopy {\n  title: string;\n  description: string;\n}\n\ntype ModuleCopyMap = Record<string, EmptyStateCopy>;\n\nconst INDUSTRY_COPY: Record<string, ModuleCopyMap> = {\n  retail: {\n    inventory: {\n      title: 'No products yet',\n      description: 'Add your first product to start selling.',\n    },\n    orders: {\n      title: 'No orders yet',\n      description:\n        'Orders will appear here when customers purchase your products.',\n    },\n  },\n  beauty: {\n    inventory: {\n      title: 'No services yet',\n      description: 'Add your first service to start taking appointments.',\n    },\n    orders: {\n      title: 'No orders yet',\n      description: 'Orders will show up when clients book your services.',\n    },\n    bookings: {\n      title: 'No appointments yet',\n      description: 'Appointments will appear when clients book with you.',\n    },\n  },\n  wellness: {\n    inventory: {\n      title: 'No treatments yet',\n      description: 'Add your first treatment to start taking appointments.',\n    },\n    orders: {\n      title: 'No orders yet',\n      description: 'Orders will show up when clients book your services.',\n    },\n    bookings: {\n      title: 'No appointments yet',\n      description: 'Appointments will appear when clients book with you.',\n    },\n  },\n  hospitality: {\n    inventory: {\n      title: 'No properties listed yet',\n      description: 'Add your first property to start accepting reservations.',\n    },\n    orders: {\n      title: 'No orders yet',\n      description: 'Orders will appear when guests complete their bookings.',\n    },\n    bookings: {\n      title: 'No reservations yet',\n      description: 'Reservations will appear when guests book your property.',\n    },\n  },\n  events: {\n    inventory: {\n      title: 'No events yet',\n      description: 'Create your first event to start selling tickets.',\n    },\n    orders: {\n      title: 'No orders yet',\n      description: 'Orders will appear when attendees purchase tickets.',\n    },\n    bookings: {\n      title: 'No ticket orders yet',\n      description:\n        'Ticket orders will appear when attendees buy tickets to your events.',\n    },\n    customers: {\n      title: 'No attendees yet',\n      description:\n        'Your attendee list will grow as people purchase tickets to your events.',\n    },\n  },\n  food: {\n    inventory: {\n      title: 'No menu items yet',\n      description: 'Add your first item to build your menu.',\n    },\n    orders: {\n      title: 'No orders yet',\n      description: 'Orders will appear when customers place their first order.',\n    },\n  },\n  fitness: {\n    inventory: {\n      title: 'No classes yet',\n      description: 'Add your first class to start accepting sign-ups.',\n    },\n    orders: {\n      title: 'No orders yet',\n      description: 'Orders will appear when members sign up for classes.',\n    },\n    bookings: {\n      title: 'No sessions yet',\n      description: 'Sessions will appear when members book a class.',\n    },\n  },\n  professional: {\n    inventory: {\n      title: 'No services yet',\n      description: 'Add your first service to start taking appointments.',\n    },\n    orders: {\n      title: 'No orders yet',\n      description: 'Orders will show up when clients book your services.',\n    },\n    bookings: {\n      title: 'No appointments yet',\n      description: 'Appointments will appear when clients book with you.',\n    },\n  },\n  creative: {\n    inventory: {\n      title: 'No packages yet',\n      description: 'Add your first package to start booking clients.',\n    },\n    orders: {\n      title: 'No orders yet',\n      description: 'Orders will appear when clients purchase your work.',\n    },\n    bookings: {\n      title: 'No bookings yet',\n      description: 'Bookings will appear when clients schedule sessions.',\n    },\n  },\n};\n\nconst DEFAULT_COPY: ModuleCopyMap = {\n  inventory: {\n    title: 'No products found',\n    description: 'Add products to get started.',\n  },\n  orders: {\n    title: 'No orders found',\n    description: 'Orders will appear here when customers make purchases.',\n  },\n  bookings: {\n    title: 'No bookings found',\n    description: 'Bookings will appear here when customers book with you.',\n  },\n  customers: {\n    title: 'No customers yet',\n    description:\n      'Customers will appear here as they sign up or make purchases.',\n  },\n  reviews: {\n    title: 'No reviews yet',\n    description: 'Reviews will appear here when customers leave feedback.',\n  },\n};\n\n/**\n * Get contextual empty state copy for a module + industry combination.\n *\n * @param moduleId  Platform module identifier (e.g. 'inventory', 'orders', 'bookings')\n * @param industryKey  Tenant's industry key (e.g. 'beauty', 'hospitality') or null\n * @returns { title, description } — always returns a value (falls back to generic copy)\n */\nexport function getEmptyStateCopy(\n  moduleId: string,\n  industryKey: string | null,\n): EmptyStateCopy {\n  if (industryKey && INDUSTRY_COPY[industryKey]?.[moduleId]) {\n    return INDUSTRY_COPY[industryKey][moduleId];\n  }\n  return (\n    DEFAULT_COPY[moduleId] ?? {\n      title: 'Nothing here yet',\n      description: 'Content will appear here as it is created.',\n    }\n  );\n}\n\n/**\n * Get the filtered empty state copy — used when search/filters are active.\n * This is not industry-specific since \"try adjusting your search\" is universal.\n */\nexport function getFilteredEmptyStateCopy(moduleId: string): EmptyStateCopy {\n  const moduleName = moduleId === 'inventory' ? 'items' : moduleId;\n  return {\n    title: `No ${moduleName} found`,\n    description: 'Try adjusting your search or filters.',\n  };\n}\n"],"mappings":"AAkBA,MAAM,gBAA+C;AAAA,EACnD,QAAQ;AAAA,IACN,WAAW;AAAA,MACT,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,QAAQ;AAAA,MACN,OAAO;AAAA,MACP,aACE;AAAA,IACJ;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,WAAW;AAAA,MACT,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,QAAQ;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,UAAU;AAAA,MACR,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,UAAU;AAAA,IACR,WAAW;AAAA,MACT,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,QAAQ;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,UAAU;AAAA,MACR,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,aAAa;AAAA,IACX,WAAW;AAAA,MACT,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,QAAQ;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,UAAU;AAAA,MACR,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,WAAW;AAAA,MACT,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,QAAQ;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,UAAU;AAAA,MACR,OAAO;AAAA,MACP,aACE;AAAA,IACJ;AAAA,IACA,WAAW;AAAA,MACT,OAAO;AAAA,MACP,aACE;AAAA,IACJ;AAAA,EACF;AAAA,EACA,MAAM;AAAA,IACJ,WAAW;AAAA,MACT,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,QAAQ;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,SAAS;AAAA,IACP,WAAW;AAAA,MACT,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,QAAQ;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,UAAU;AAAA,MACR,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,cAAc;AAAA,IACZ,WAAW;AAAA,MACT,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,QAAQ;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,UAAU;AAAA,MACR,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,UAAU;AAAA,IACR,WAAW;AAAA,MACT,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,QAAQ;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,UAAU;AAAA,MACR,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,EACF;AACF;AAEA,MAAM,eAA8B;AAAA,EAClC,WAAW;AAAA,IACT,OAAO;AAAA,IACP,aAAa;AAAA,EACf;AAAA,EACA,QAAQ;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,EACf;AAAA,EACA,UAAU;AAAA,IACR,OAAO;AAAA,IACP,aAAa;AAAA,EACf;AAAA,EACA,WAAW;AAAA,IACT,OAAO;AAAA,IACP,aACE;AAAA,EACJ;AAAA,EACA,SAAS;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,EACf;AACF;AASO,SAAS,kBACd,UACA,aACgB;AAChB,MAAI,eAAe,cAAc,WAAW,IAAI,QAAQ,GAAG;AACzD,WAAO,cAAc,WAAW,EAAE,QAAQ;AAAA,EAC5C;AACA,SACE,aAAa,QAAQ,KAAK;AAAA,IACxB,OAAO;AAAA,IACP,aAAa;AAAA,EACf;AAEJ;AAMO,SAAS,0BAA0B,UAAkC;AAC1E,QAAM,aAAa,aAAa,cAAc,UAAU;AACxD,SAAO;AAAA,IACL,OAAO,MAAM,UAAU;AAAA,IACvB,aAAa;AAAA,EACf;AACF;","names":[]}

package/dist/end-session.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Everything that makes this browser believe it is signed in.
+ *
+ * Extracted from `auth-context`'s `logout` so a second caller can end a session
+ * without re-typing the key list — and every key list that gets re-typed drifts.
+ * There is already one narrower copy inside auth-context (`clearStoredAuth`,
+ * used on the dead-session path) which misses the workspace cache and the
+ * onboarding draft; it is left alone here rather than silently widened, because
+ * what a dead session should clear is a separate question from what a
+ * deliberate sign-out clears.
+ *
+ * `pb_last_account` and `pb_last_workspace` deliberately survive: they hold no
+ * token, and they are what lets /login greet a returning owner by name.
+ */
+export declare function clearSession(): void;
+/**
+ * Drop the server cookie too, then clear locally.
+ *
+ * The fetch is best-effort on purpose: the cookie expires on its own, and a
+ * network failure must not leave somebody stuck in a session they have asked
+ * to leave.
+ */
+export declare function endSession(): Promise<void>;

package/dist/end-session.js

@@ -0,0 +1,30 @@
+import { getApiUrl } from "@withpotter/lib/api/core";
+import { clearOnboardingDraft } from "@withpotter/lib/onboarding-draft";
+function clearSession() {
+  localStorage.removeItem("pb_token");
+  localStorage.removeItem("pb_user");
+  localStorage.removeItem("pb_account_id");
+  localStorage.removeItem("userEmail");
+  localStorage.removeItem("organizationId");
+  localStorage.removeItem("workspaces");
+  localStorage.removeItem("pb_workspaces_cache");
+  localStorage.removeItem("currentWorkspace");
+  localStorage.removeItem("pb_current_tenant");
+  localStorage.removeItem("tenant");
+  clearOnboardingDraft();
+}
+async function endSession() {
+  try {
+    await fetch(`${getApiUrl()}/accounts/logout`, {
+      method: "POST",
+      credentials: "include"
+    });
+  } catch {
+  }
+  clearSession();
+}
+export {
+  clearSession,
+  endSession
+};
+//# sourceMappingURL=end-session.js.map

package/dist/end-session.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/end-session.ts"],"sourcesContent":["import { getApiUrl } from '@withpotter/lib/api/core';\nimport { clearOnboardingDraft } from '@withpotter/lib/onboarding-draft';\n\n/**\n * Everything that makes this browser believe it is signed in.\n *\n * Extracted from `auth-context`'s `logout` so a second caller can end a session\n * without re-typing the key list — and every key list that gets re-typed drifts.\n * There is already one narrower copy inside auth-context (`clearStoredAuth`,\n * used on the dead-session path) which misses the workspace cache and the\n * onboarding draft; it is left alone here rather than silently widened, because\n * what a dead session should clear is a separate question from what a\n * deliberate sign-out clears.\n *\n * `pb_last_account` and `pb_last_workspace` deliberately survive: they hold no\n * token, and they are what lets /login greet a returning owner by name.\n */\nexport function clearSession(): void {\n  localStorage.removeItem('pb_token');\n  localStorage.removeItem('pb_user');\n  localStorage.removeItem('pb_account_id');\n  localStorage.removeItem('userEmail');\n  localStorage.removeItem('organizationId');\n  localStorage.removeItem('workspaces');\n  // Its twin: leaving the full cache behind lets the next account on this\n  // device fall back to the previous owner's businesses if the API is down.\n  localStorage.removeItem('pb_workspaces_cache');\n  localStorage.removeItem('currentWorkspace');\n  localStorage.removeItem('pb_current_tenant');\n  localStorage.removeItem('tenant');\n  // sessionStorage outlives a logout in the same tab, so an abandoned\n  // onboarding draft would otherwise greet whoever signs in next with the\n  // previous person's business name and address already filled in.\n  clearOnboardingDraft();\n}\n\n/**\n * Drop the server cookie too, then clear locally.\n *\n * The fetch is best-effort on purpose: the cookie expires on its own, and a\n * network failure must not leave somebody stuck in a session they have asked\n * to leave.\n */\nexport async function endSession(): Promise<void> {\n  try {\n    await fetch(`${getApiUrl()}/accounts/logout`, {\n      method: 'POST',\n      credentials: 'include',\n    });\n  } catch {\n    // Best-effort — the cookie will expire on its own (7d).\n  }\n  clearSession();\n}\n"],"mappings":"AAAA,SAAS,iBAAiB;AAC1B,SAAS,4BAA4B;AAgB9B,SAAS,eAAqB;AACnC,eAAa,WAAW,UAAU;AAClC,eAAa,WAAW,SAAS;AACjC,eAAa,WAAW,eAAe;AACvC,eAAa,WAAW,WAAW;AACnC,eAAa,WAAW,gBAAgB;AACxC,eAAa,WAAW,YAAY;AAGpC,eAAa,WAAW,qBAAqB;AAC7C,eAAa,WAAW,kBAAkB;AAC1C,eAAa,WAAW,mBAAmB;AAC3C,eAAa,WAAW,QAAQ;AAIhC,uBAAqB;AACvB;AASA,eAAsB,aAA4B;AAChD,MAAI;AACF,UAAM,MAAM,GAAG,UAAU,CAAC,oBAAoB;AAAA,MAC5C,QAAQ;AAAA,MACR,aAAa;AAAA,IACf,CAAC;AAAA,EACH,QAAQ;AAAA,EAER;AACA,eAAa;AACf;","names":[]}

package/dist/file-intake.d.ts

@@ -0,0 +1,65 @@
+/**
+ * One answer to "can this file come in, and what is it?".
+ *
+ * Before this, every picker screened its own files: `MAX_SIZE_MB = 10` was
+ * declared separately in logo-field and image-field, the catalog importer
+ * capped at 5MB, and each one worded the refusal differently ("Image must be
+ * under 10MB", "Please select an image file", "That file is over 5MB"). Type
+ * checks were `file.type.startsWith('image/')` even where `accept` listed four
+ * extensions, so a .tiff passed the check and failed at the server instead.
+ *
+ * The screening is here so a limit is one edit and a refusal reads the same
+ * everywhere. Dropzone calls it for you; a surface that opens its own picker
+ * (a logo field, a paste handler) should call `screenFiles` directly rather
+ * than re-typing the two `if`s.
+ */
+export type FileKind = 'image' | 'video' | 'audio' | 'pdf' | 'archive' | 'sheet' | 'doc' | 'font' | 'link' | 'file';
+/** The default ceiling for an image field. Storage plans start at 500MB. */
+export declare const DEFAULT_MAX_SIZE_MB = 10;
+export declare function extensionOf(name: string): string;
+/**
+ * What kind of thing this is, for the leading icon on a row. Reads the MIME
+ * type first and falls back to the extension, because a file dragged in from
+ * some sources arrives with an empty `type`.
+ */
+export declare function fileKind(input: {
+    name?: string | null;
+    type?: string | null;
+}): FileKind;
+/** Does this file satisfy an `accept` string? Empty accept means anything. */
+export declare function matchesAccept(file: {
+    name: string;
+    type?: string;
+}, accept?: string): boolean;
+/**
+ * "PNG, JPG or WEBP" from an accept string, so the frame can state what it
+ * takes instead of leaving the merchant to find out by being refused.
+ */
+export declare function describeAccept(accept?: string): string | null;
+/** The line under a dropzone label: what it takes and how big. */
+export declare function intakeHint(accept?: string, maxSizeMb?: number): string | null;
+export type RejectionReason = 'type' | 'size' | 'count';
+export interface Rejection {
+    file: File;
+    reason: RejectionReason;
+}
+export interface IntakeLimits {
+    accept?: string;
+    maxSizeMb?: number;
+    /** Total this surface can hold, counting what it already has. */
+    maxFiles?: number;
+    /** How many are already in, so `maxFiles` counts the whole set. */
+    currentCount?: number;
+}
+export interface IntakeResult {
+    accepted: File[];
+    rejected: Rejection[];
+    /** Ready-to-render refusal, or null when everything came in. */
+    message: string | null;
+}
+/**
+ * Screen a batch against the surface's limits. Nothing throws and nothing is
+ * silently dropped: whatever is refused comes back with a sentence saying why,
+ * because a picker that just ignores a file looks broken.
+ */
+export declare function screenFiles(files: File[], limits?: IntakeLimits): IntakeResult;