@withpotter/lib 0.13.0-next.101

package/dist/location-options.js

@@ -0,0 +1,94 @@
+"use client";
+import { useEffect, useMemo, useState } from "react";
+import { apiFetch } from "@withpotter/lib/api/core";
+import { useAuth } from "@withpotter/lib/auth-context";
+import { normalisePlace, sameCountry } from "./country-regions";
+function useLocationOptions() {
+  const { tenant } = useAuth();
+  const [locations, setLocations] = useState([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    let isMounted = true;
+    (async () => {
+      setLoading(true);
+      setError(null);
+      if (!tenant?.slug) {
+        setLocations([]);
+        setLoading(false);
+        return;
+      }
+      try {
+        let res;
+        try {
+          res = await apiFetch("/locations/hierarchy", {
+            tenantSlug: tenant.slug
+          });
+        } catch {
+          res = await apiFetch(
+            "/public/locations/hierarchy",
+            {
+              tenantSlug: tenant.slug
+            }
+          );
+        }
+        if (!isMounted) return;
+        setLocations(Array.isArray(res) ? res : []);
+      } catch {
+        if (!isMounted) return;
+        setError("Failed to load location options");
+        setLocations([]);
+      } finally {
+        if (isMounted) setLoading(false);
+      }
+    })();
+    return () => {
+      isMounted = false;
+    };
+  }, [tenant?.slug]);
+  const countries = useMemo(
+    () => locations.map((item) => item.country),
+    [locations]
+  );
+  const getStateOptionsForCountries = (selectedCountries) => {
+    const stateSet = /* @__PURE__ */ new Set();
+    for (const country of selectedCountries) {
+      const countryNode = locations.find(
+        (item) => sameCountry(item.country, country)
+      );
+      for (const stateNode of countryNode?.states || []) {
+        stateSet.add(stateNode.state);
+      }
+    }
+    return Array.from(stateSet).sort((a, b) => a.localeCompare(b));
+  };
+  const getCityOptionsForCountriesAndStates = (selectedCountries, selectedStates) => {
+    const citySet = /* @__PURE__ */ new Set();
+    for (const country of selectedCountries) {
+      const countryNode = locations.find(
+        (item) => sameCountry(item.country, country)
+      );
+      const states = countryNode?.states || [];
+      const wanted = new Set(selectedStates.map(normalisePlace));
+      const eligibleStates = selectedStates.length ? states.filter((item) => wanted.has(normalisePlace(item.state))) : states;
+      for (const stateNode of eligibleStates) {
+        for (const city of stateNode.cities) {
+          citySet.add(city);
+        }
+      }
+    }
+    return Array.from(citySet).sort((a, b) => a.localeCompare(b));
+  };
+  return {
+    locations,
+    countries,
+    loading,
+    error,
+    getStateOptionsForCountries,
+    getCityOptionsForCountriesAndStates
+  };
+}
+export {
+  useLocationOptions
+};
+//# sourceMappingURL=location-options.js.map

package/dist/location-options.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/location-options.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useMemo, useState } from 'react';\nimport { apiFetch } from '@withpotter/lib/api/core';\nimport { useAuth } from '@withpotter/lib/auth-context';\nimport { normalisePlace, sameCountry } from './country-regions';\n\nexport interface LocationStateNode {\n  state: string;\n  cities: string[];\n}\n\nexport interface LocationCountryNode {\n  country: string;\n  states: LocationStateNode[];\n}\n\nexport function useLocationOptions() {\n  const { tenant } = useAuth();\n  const [locations, setLocations] = useState<LocationCountryNode[]>([]);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<string | null>(null);\n\n  useEffect(() => {\n    let isMounted = true;\n    (async () => {\n      setLoading(true);\n      setError(null);\n      if (!tenant?.slug) {\n        setLocations([]);\n        setLoading(false);\n        return;\n      }\n      try {\n        let res: LocationCountryNode[];\n        try {\n          res = await apiFetch<LocationCountryNode[]>('/locations/hierarchy', {\n            tenantSlug: tenant.slug,\n          });\n        } catch {\n          // Backward-compat for environments still on older public route.\n          res = await apiFetch<LocationCountryNode[]>(\n            '/public/locations/hierarchy',\n            {\n              tenantSlug: tenant.slug,\n            },\n          );\n        }\n        if (!isMounted) return;\n        setLocations(Array.isArray(res) ? res : []);\n      } catch {\n        if (!isMounted) return;\n        setError('Failed to load location options');\n        setLocations([]);\n      } finally {\n        if (isMounted) setLoading(false);\n      }\n    })();\n\n    return () => {\n      isMounted = false;\n    };\n  }, [tenant?.slug]);\n\n  const countries = useMemo(\n    () => locations.map((item) => item.country),\n    [locations],\n  );\n\n  const getStateOptionsForCountries = (\n    selectedCountries: string[],\n  ): string[] => {\n    const stateSet = new Set<string>();\n    for (const country of selectedCountries) {\n      const countryNode = locations.find((item) =>\n        sameCountry(item.country, country),\n      );\n      for (const stateNode of countryNode?.states || []) {\n        stateSet.add(stateNode.state);\n      }\n    }\n    return Array.from(stateSet).sort((a, b) => a.localeCompare(b));\n  };\n\n  const getCityOptionsForCountriesAndStates = (\n    selectedCountries: string[],\n    selectedStates: string[],\n  ): string[] => {\n    const citySet = new Set<string>();\n    for (const country of selectedCountries) {\n      const countryNode = locations.find((item) =>\n        sameCountry(item.country, country),\n      );\n      const states = countryNode?.states || [];\n      const wanted = new Set(selectedStates.map(normalisePlace));\n      const eligibleStates = selectedStates.length\n        ? states.filter((item) => wanted.has(normalisePlace(item.state)))\n        : states;\n\n      for (const stateNode of eligibleStates) {\n        for (const city of stateNode.cities) {\n          citySet.add(city);\n        }\n      }\n    }\n    return Array.from(citySet).sort((a, b) => a.localeCompare(b));\n  };\n\n  return {\n    locations,\n    countries,\n    loading,\n    error,\n    getStateOptionsForCountries,\n    getCityOptionsForCountriesAndStates,\n  };\n}\n"],"mappings":";AAEA,SAAS,WAAW,SAAS,gBAAgB;AAC7C,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,gBAAgB,mBAAmB;AAYrC,SAAS,qBAAqB;AACnC,QAAM,EAAE,OAAO,IAAI,QAAQ;AAC3B,QAAM,CAAC,WAAW,YAAY,IAAI,SAAgC,CAAC,CAAC;AACpE,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,IAAI;AAC3C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAwB,IAAI;AAEtD,YAAU,MAAM;AACd,QAAI,YAAY;AAChB,KAAC,YAAY;AACX,iBAAW,IAAI;AACf,eAAS,IAAI;AACb,UAAI,CAAC,QAAQ,MAAM;AACjB,qBAAa,CAAC,CAAC;AACf,mBAAW,KAAK;AAChB;AAAA,MACF;AACA,UAAI;AACF,YAAI;AACJ,YAAI;AACF,gBAAM,MAAM,SAAgC,wBAAwB;AAAA,YAClE,YAAY,OAAO;AAAA,UACrB,CAAC;AAAA,QACH,QAAQ;AAEN,gBAAM,MAAM;AAAA,YACV;AAAA,YACA;AAAA,cACE,YAAY,OAAO;AAAA,YACrB;AAAA,UACF;AAAA,QACF;AACA,YAAI,CAAC,UAAW;AAChB,qBAAa,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,CAAC;AAAA,MAC5C,QAAQ;AACN,YAAI,CAAC,UAAW;AAChB,iBAAS,iCAAiC;AAC1C,qBAAa,CAAC,CAAC;AAAA,MACjB,UAAE;AACA,YAAI,UAAW,YAAW,KAAK;AAAA,MACjC;AAAA,IACF,GAAG;AAEH,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,QAAQ,IAAI,CAAC;AAEjB,QAAM,YAAY;AAAA,IAChB,MAAM,UAAU,IAAI,CAAC,SAAS,KAAK,OAAO;AAAA,IAC1C,CAAC,SAAS;AAAA,EACZ;AAEA,QAAM,8BAA8B,CAClC,sBACa;AACb,UAAM,WAAW,oBAAI,IAAY;AACjC,eAAW,WAAW,mBAAmB;AACvC,YAAM,cAAc,UAAU;AAAA,QAAK,CAAC,SAClC,YAAY,KAAK,SAAS,OAAO;AAAA,MACnC;AACA,iBAAW,aAAa,aAAa,UAAU,CAAC,GAAG;AACjD,iBAAS,IAAI,UAAU,KAAK;AAAA,MAC9B;AAAA,IACF;AACA,WAAO,MAAM,KAAK,QAAQ,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAAA,EAC/D;AAEA,QAAM,sCAAsC,CAC1C,mBACA,mBACa;AACb,UAAM,UAAU,oBAAI,IAAY;AAChC,eAAW,WAAW,mBAAmB;AACvC,YAAM,cAAc,UAAU;AAAA,QAAK,CAAC,SAClC,YAAY,KAAK,SAAS,OAAO;AAAA,MACnC;AACA,YAAM,SAAS,aAAa,UAAU,CAAC;AACvC,YAAM,SAAS,IAAI,IAAI,eAAe,IAAI,cAAc,CAAC;AACzD,YAAM,iBAAiB,eAAe,SAClC,OAAO,OAAO,CAAC,SAAS,OAAO,IAAI,eAAe,KAAK,KAAK,CAAC,CAAC,IAC9D;AAEJ,iBAAW,aAAa,gBAAgB;AACtC,mBAAW,QAAQ,UAAU,QAAQ;AACnC,kBAAQ,IAAI,IAAI;AAAA,QAClB;AAAA,MACF;AAAA,IACF;AACA,WAAO,MAAM,KAAK,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAAA,EAC9D;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/location-scope-context.d.ts

@@ -0,0 +1,47 @@
+import { type ReactNode } from 'react';
+import type { BusinessLocation } from './api/types';
+interface LocationScope {
+    locations: BusinessLocation[];
+    /** True once a second branch exists. Nothing about branches shows before. */
+    isMultiSite: boolean;
+    /** The branch being viewed, or **null for all of them**. */
+    activeLocationId: string | null;
+    setActiveLocationId: (id: string | null) => void;
+    /** The active branch's name, or null while viewing everything. */
+    activeLocationName: string | null;
+    /**
+     * What to send as a `locationIds` filter. Undefined when viewing
+     * everything, which is the shape the API treats as "no restriction" — the
+     * same convention the member scope uses, where no assignment means all.
+     */
+    locationFilter: string[] | undefined;
+}
+/**
+ * Which branch the dashboard is currently looking at.
+ *
+ * Separate from the member's ASSIGNED scope, which the API enforces and a
+ * staff member cannot widen. This is the view: an owner who works everywhere
+ * picking one branch to read today. The two meet at the API, which intersects
+ * whatever this sends with what the caller is allowed to see.
+ *
+ * The choice is remembered per workspace, because "which branch am I running
+ * today" survives a reload and must not carry across businesses.
+ *
+ * localStorage is read through `useSyncExternalStore` rather than restored in
+ * an effect. An effect would set state during the first commit — a cascading
+ * render React now warns about — and would flash "All locations" before
+ * settling on the remembered branch. This gives the server a clean null and
+ * the client the stored value in one pass.
+ */
+export declare function LocationScopeProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Read the current branch view.
+ *
+ * Safe outside the provider: surfaces that render before it mounts get "all
+ * locations" rather than throwing, because a missing switcher must never be
+ * the reason a page shows nothing.
+ */
+export declare function useLocationScope(): LocationScope;
+export {};

package/dist/location-scope-context.js

@@ -0,0 +1,85 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useMemo,
+  useSyncExternalStore
+} from "react";
+import { useAuth } from "./auth-context";
+import { useBusinessLocations } from "./use-business-locations";
+const LocationScopeContext = createContext(null);
+const STORAGE_KEY = "pb_active_location";
+const CHANGE_EVENT = "pb:location-scope";
+function subscribe(onChange) {
+  window.addEventListener("storage", onChange);
+  window.addEventListener(CHANGE_EVENT, onChange);
+  return () => {
+    window.removeEventListener("storage", onChange);
+    window.removeEventListener(CHANGE_EVENT, onChange);
+  };
+}
+function readStored(key) {
+  if (!key) return null;
+  try {
+    return window.localStorage.getItem(key);
+  } catch {
+    return null;
+  }
+}
+function LocationScopeProvider({ children }) {
+  const { tenant } = useAuth();
+  const { locations, isMultiSite } = useBusinessLocations();
+  const storageKey = tenant?.slug ? `${STORAGE_KEY}:${tenant.slug}` : null;
+  const stored = useSyncExternalStore(
+    subscribe,
+    () => readStored(storageKey),
+    () => null
+  );
+  const activeLocationId = useMemo(() => {
+    if (!stored || locations.length === 0) return stored;
+    return locations.some((l) => l.id === stored) ? stored : null;
+  }, [stored, locations]);
+  const setActiveLocationId = useCallback(
+    (id) => {
+      if (!storageKey) return;
+      try {
+        if (id) window.localStorage.setItem(storageKey, id);
+        else window.localStorage.removeItem(storageKey);
+      } catch {
+      }
+      window.dispatchEvent(new Event(CHANGE_EVENT));
+    },
+    [storageKey]
+  );
+  const value = useMemo(
+    () => ({
+      locations,
+      isMultiSite,
+      activeLocationId,
+      setActiveLocationId,
+      activeLocationName: locations.find((l) => l.id === activeLocationId)?.name ?? null,
+      locationFilter: activeLocationId ? [activeLocationId] : void 0
+    }),
+    [locations, isMultiSite, activeLocationId, setActiveLocationId]
+  );
+  return /* @__PURE__ */ jsx(LocationScopeContext.Provider, { value, children });
+}
+function useLocationScope() {
+  const ctx = useContext(LocationScopeContext);
+  return ctx ?? {
+    locations: [],
+    isMultiSite: false,
+    activeLocationId: null,
+    setActiveLocationId: () => {
+    },
+    activeLocationName: null,
+    locationFilter: void 0
+  };
+}
+export {
+  LocationScopeProvider,
+  useLocationScope
+};
+//# sourceMappingURL=location-scope-context.js.map

package/dist/location-scope-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/location-scope-context.tsx"],"sourcesContent":["'use client';\n\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n  useSyncExternalStore,\n  type ReactNode,\n} from 'react';\nimport { useAuth } from './auth-context';\nimport { useBusinessLocations } from './use-business-locations';\nimport type { BusinessLocation } from './api/types';\n\ninterface LocationScope {\n  locations: BusinessLocation[];\n  /** True once a second branch exists. Nothing about branches shows before. */\n  isMultiSite: boolean;\n  /** The branch being viewed, or **null for all of them**. */\n  activeLocationId: string | null;\n  setActiveLocationId: (id: string | null) => void;\n  /** The active branch's name, or null while viewing everything. */\n  activeLocationName: string | null;\n  /**\n   * What to send as a `locationIds` filter. Undefined when viewing\n   * everything, which is the shape the API treats as \"no restriction\" — the\n   * same convention the member scope uses, where no assignment means all.\n   */\n  locationFilter: string[] | undefined;\n}\n\nconst LocationScopeContext = createContext<LocationScope | null>(null);\n\nconst STORAGE_KEY = 'pb_active_location';\n/** Same-tab writes don't fire `storage`, so the setter announces its own. */\nconst CHANGE_EVENT = 'pb:location-scope';\n\nfunction subscribe(onChange: () => void) {\n  window.addEventListener('storage', onChange);\n  window.addEventListener(CHANGE_EVENT, onChange);\n  return () => {\n    window.removeEventListener('storage', onChange);\n    window.removeEventListener(CHANGE_EVENT, onChange);\n  };\n}\n\nfunction readStored(key: string | null): string | null {\n  if (!key) return null;\n  try {\n    return window.localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Which branch the dashboard is currently looking at.\n *\n * Separate from the member's ASSIGNED scope, which the API enforces and a\n * staff member cannot widen. This is the view: an owner who works everywhere\n * picking one branch to read today. The two meet at the API, which intersects\n * whatever this sends with what the caller is allowed to see.\n *\n * The choice is remembered per workspace, because \"which branch am I running\n * today\" survives a reload and must not carry across businesses.\n *\n * localStorage is read through `useSyncExternalStore` rather than restored in\n * an effect. An effect would set state during the first commit — a cascading\n * render React now warns about — and would flash \"All locations\" before\n * settling on the remembered branch. This gives the server a clean null and\n * the client the stored value in one pass.\n */\nexport function LocationScopeProvider({ children }: { children: ReactNode }) {\n  const { tenant } = useAuth();\n  const { locations, isMultiSite } = useBusinessLocations();\n\n  const storageKey = tenant?.slug ? `${STORAGE_KEY}:${tenant.slug}` : null;\n\n  const stored = useSyncExternalStore(\n    subscribe,\n    () => readStored(storageKey),\n    () => null,\n  );\n\n  // A remembered branch that has since been closed would filter every list to\n  // nothing with no visible reason, so it is dropped on read rather than\n  // corrected in an effect. Until the locations arrive, the stored value\n  // stands: treating \"not loaded yet\" as \"not found\" would reset the choice\n  // on every reload.\n  const activeLocationId = useMemo(() => {\n    if (!stored || locations.length === 0) return stored;\n    return locations.some((l) => l.id === stored) ? stored : null;\n  }, [stored, locations]);\n\n  const setActiveLocationId = useCallback(\n    (id: string | null) => {\n      if (!storageKey) return;\n      try {\n        if (id) window.localStorage.setItem(storageKey, id);\n        else window.localStorage.removeItem(storageKey);\n      } catch {\n        // A private-mode browser refusing storage is not a reason to fail the\n        // switch; the event below still moves the UI, it just won't persist.\n      }\n      window.dispatchEvent(new Event(CHANGE_EVENT));\n    },\n    [storageKey],\n  );\n\n  const value = useMemo<LocationScope>(\n    () => ({\n      locations,\n      isMultiSite,\n      activeLocationId,\n      setActiveLocationId,\n      activeLocationName:\n        locations.find((l) => l.id === activeLocationId)?.name ?? null,\n      locationFilter: activeLocationId ? [activeLocationId] : undefined,\n    }),\n    [locations, isMultiSite, activeLocationId, setActiveLocationId],\n  );\n\n  return (\n    <LocationScopeContext.Provider value={value}>\n      {children}\n    </LocationScopeContext.Provider>\n  );\n}\n\n/**\n * Read the current branch view.\n *\n * Safe outside the provider: surfaces that render before it mounts get \"all\n * locations\" rather than throwing, because a missing switcher must never be\n * the reason a page shows nothing.\n */\nexport function useLocationScope(): LocationScope {\n  const ctx = useContext(LocationScopeContext);\n  return (\n    ctx ?? {\n      locations: [],\n      isMultiSite: false,\n      activeLocationId: null,\n      setActiveLocationId: () => {},\n      activeLocationName: null,\n      locationFilter: undefined,\n    }\n  );\n}\n"],"mappings":";AA2HI;AAzHJ;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,eAAe;AACxB,SAAS,4BAA4B;AAoBrC,MAAM,uBAAuB,cAAoC,IAAI;AAErE,MAAM,cAAc;AAEpB,MAAM,eAAe;AAErB,SAAS,UAAU,UAAsB;AACvC,SAAO,iBAAiB,WAAW,QAAQ;AAC3C,SAAO,iBAAiB,cAAc,QAAQ;AAC9C,SAAO,MAAM;AACX,WAAO,oBAAoB,WAAW,QAAQ;AAC9C,WAAO,oBAAoB,cAAc,QAAQ;AAAA,EACnD;AACF;AAEA,SAAS,WAAW,KAAmC;AACrD,MAAI,CAAC,IAAK,QAAO;AACjB,MAAI;AACF,WAAO,OAAO,aAAa,QAAQ,GAAG;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAmBO,SAAS,sBAAsB,EAAE,SAAS,GAA4B;AAC3E,QAAM,EAAE,OAAO,IAAI,QAAQ;AAC3B,QAAM,EAAE,WAAW,YAAY,IAAI,qBAAqB;AAExD,QAAM,aAAa,QAAQ,OAAO,GAAG,WAAW,IAAI,OAAO,IAAI,KAAK;AAEpE,QAAM,SAAS;AAAA,IACb;AAAA,IACA,MAAM,WAAW,UAAU;AAAA,IAC3B,MAAM;AAAA,EACR;AAOA,QAAM,mBAAmB,QAAQ,MAAM;AACrC,QAAI,CAAC,UAAU,UAAU,WAAW,EAAG,QAAO;AAC9C,WAAO,UAAU,KAAK,CAAC,MAAM,EAAE,OAAO,MAAM,IAAI,SAAS;AAAA,EAC3D,GAAG,CAAC,QAAQ,SAAS,CAAC;AAEtB,QAAM,sBAAsB;AAAA,IAC1B,CAAC,OAAsB;AACrB,UAAI,CAAC,WAAY;AACjB,UAAI;AACF,YAAI,GAAI,QAAO,aAAa,QAAQ,YAAY,EAAE;AAAA,YAC7C,QAAO,aAAa,WAAW,UAAU;AAAA,MAChD,QAAQ;AAAA,MAGR;AACA,aAAO,cAAc,IAAI,MAAM,YAAY,CAAC;AAAA,IAC9C;AAAA,IACA,CAAC,UAAU;AAAA,EACb;AAEA,QAAM,QAAQ;AAAA,IACZ,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,oBACE,UAAU,KAAK,CAAC,MAAM,EAAE,OAAO,gBAAgB,GAAG,QAAQ;AAAA,MAC5D,gBAAgB,mBAAmB,CAAC,gBAAgB,IAAI;AAAA,IAC1D;AAAA,IACA,CAAC,WAAW,aAAa,kBAAkB,mBAAmB;AAAA,EAChE;AAEA,SACE,oBAAC,qBAAqB,UAArB,EAA8B,OAC5B,UACH;AAEJ;AASO,SAAS,mBAAkC;AAChD,QAAM,MAAM,WAAW,oBAAoB;AAC3C,SACE,OAAO;AAAA,IACL,WAAW,CAAC;AAAA,IACZ,aAAa;AAAA,IACb,kBAAkB;AAAA,IAClB,qBAAqB,MAAM;AAAA,IAAC;AAAA,IAC5B,oBAAoB;AAAA,IACpB,gBAAgB;AAAA,EAClB;AAEJ;","names":[]}

package/dist/media-service.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Media Service - Handles image uploads via Box API proxy.
+ *
+ * Uploads are sent to `/api/proxy/media/upload`, where the backend handles
+ * storage + Cloudinary integration and usage metering.
+ */
+export declare const CLOUDINARY_CONFIG: {
+    cloudName: string;
+    uploadPreset: string;
+};
+export declare const isCloudinaryEnabled: boolean;
+export declare const CLOUDINARY_TRANSFORMS: {
+    thumbnail: string;
+    preview: string;
+    product: string;
+    hero: string;
+    full: string;
+};
+/**
+ * Build Cloudinary URL with transformations
+ */
+export declare function buildCloudinaryUrl(publicId: string, transform?: keyof typeof CLOUDINARY_TRANSFORMS | string): string;
+/**
+ * Derive a favicon URL from a logo URL.
+ *
+ * If the logo is hosted on Cloudinary (`res.cloudinary.com/<cloud>/image/upload/...`),
+ * we inject a square padded transform so any logo shape (wide wordmark, tall mark)
+ * renders cleanly at 32×32 in a browser tab. If the URL is not Cloudinary we return
+ * it as-is — browsers will still accept it and downscale.
+ *
+ * The transform replaces any existing transform segment immediately after `/upload/`,
+ * so calling this on an already-derived favicon URL is idempotent.
+ */
+export declare function deriveFaviconUrl(logoUrl: string | undefined | null): string | undefined;
+/**
+ * Compress and resize image to prevent browser crashes from large base64 strings
+ * Used as fallback when Cloudinary is not configured
+ */
+export declare function compressImage(file: File, maxWidth?: number, maxHeight?: number, quality?: number): Promise<string>;
+/**
+ * Upload image result type
+ */
+export interface UploadResult {
+    url: string;
+    publicId?: string;
+    width?: number;
+    height?: number;
+    resourceType?: 'image' | 'video';
+    duration?: number;
+    thumbnail?: string;
+    format?: string;
+    isCloudinary: boolean;
+}
+/**
+ * Upload image via Box API proxy.
+ */
+export declare function uploadImage(file: File): Promise<UploadResult>;
+/**
+ * Upload image with progress tracking
+ */
+export declare function uploadImageWithProgress(file: File, onProgress?: (progress: number) => void): Promise<UploadResult>;
+export declare class UploadHttpError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+/** Say what went wrong: only a dropped connection is the merchant's to fix. */
+export declare function voiceUploadProblem(error: unknown): string;
+export declare function uploadImageWithAutoCompress(file: File, onProgress?: (progress: number) => void): Promise<UploadResult>;
+/**
+ * Send a recorded voice note to the same media endpoint images use.
+ *
+ * A Blob is not a File, and the proxy reads a filename off the multipart part
+ * to infer an extension, so the container has to be named rather than left to
+ * whatever `blob` defaults to. The mimetype is the recorder's own — it varies
+ * by browser (webm/opus on Chrome, mp4 on Safari) and the API matches on the
+ * base type with parameters stripped.
+ */
+export declare function uploadAudio(blob: Blob, mimeType: string): Promise<UploadResult>;
+/**
+ * Open Cloudinary Upload Widget
+ * Requires the Cloudinary widget script to be loaded
+ */
+export interface CloudinaryWidgetOptions {
+    onSuccess: (result: UploadResult) => void;
+    onError?: (error: Error) => void;
+    maxFiles?: number;
+    resourceType?: 'image' | 'video' | 'auto';
+    cropping?: boolean;
+    croppingAspectRatio?: number;
+    showAdvancedOptions?: boolean;
+    sources?: ('local' | 'url' | 'camera')[];
+}
+export declare function openCloudinaryWidget(options: CloudinaryWidgetOptions): void;
+/**
+ * Script tag for Cloudinary widget - add to page if using widget
+ */
+export declare const CLOUDINARY_WIDGET_SCRIPT = "https://widget.cloudinary.com/v2.0/global/all.js";

package/dist/media-service.js

@@ -0,0 +1,282 @@
+import { BRAND_PRIMARY } from "@withpotter/lib/brand";
+const CLOUDINARY_CONFIG = {
+  cloudName: process.env.NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME || "",
+  uploadPreset: process.env.NEXT_PUBLIC_CLOUDINARY_UPLOAD_PRESET || ""
+};
+const isCloudinaryEnabled = Boolean(CLOUDINARY_CONFIG.cloudName);
+const CLOUDINARY_TRANSFORMS = {
+  thumbnail: "w_200,h_200,c_fill,q_auto",
+  preview: "w_400,h_400,c_limit,q_auto",
+  product: "w_800,h_800,c_limit,q_auto",
+  hero: "w_1920,h_1080,c_fill,q_auto",
+  full: "q_auto"
+};
+function buildCloudinaryUrl(publicId, transform = "preview") {
+  if (!CLOUDINARY_CONFIG.cloudName) return publicId;
+  const transformation = CLOUDINARY_TRANSFORMS[transform] || transform;
+  return `https://res.cloudinary.com/${CLOUDINARY_CONFIG.cloudName}/image/upload/${transformation}/${publicId}`;
+}
+function deriveFaviconUrl(logoUrl) {
+  if (!logoUrl) return void 0;
+  const cloudinaryPattern = /^(https?:\/\/res\.cloudinary\.com\/[^/]+\/image\/upload\/)([^/]+\/)?(.+)$/;
+  const match = logoUrl.match(cloudinaryPattern);
+  if (!match) return logoUrl;
+  const [, prefix, maybeTransform, rest] = match;
+  const transformSegment = maybeTransform ?? "";
+  const isVersion = /^v\d+\/$/.test(transformSegment);
+  const assetPath = isVersion ? `${transformSegment}${rest}` : rest;
+  const faviconTransform = "w_180,h_180,c_pad,b_transparent,f_png,q_auto";
+  return `${prefix}${faviconTransform}/${assetPath}`;
+}
+async function compressImage(file, maxWidth = 1200, maxHeight = 1200, quality = 0.8) {
+  return new Promise((resolve, reject) => {
+    const img = document.createElement("img");
+    const canvas = document.createElement("canvas");
+    const ctx = canvas.getContext("2d");
+    img.onload = () => {
+      URL.revokeObjectURL(img.src);
+      let { width, height } = img;
+      if (width > maxWidth || height > maxHeight) {
+        const ratio = Math.min(maxWidth / width, maxHeight / height);
+        width = Math.round(width * ratio);
+        height = Math.round(height * ratio);
+      }
+      canvas.width = width;
+      canvas.height = height;
+      if (!ctx) {
+        reject(new Error("Could not get canvas context"));
+        return;
+      }
+      ctx.drawImage(img, 0, 0, width, height);
+      const mimeType = file.type === "image/png" ? "image/png" : "image/jpeg";
+      const dataUrl = canvas.toDataURL(mimeType, quality);
+      resolve(dataUrl);
+    };
+    img.onerror = () => {
+      URL.revokeObjectURL(img.src);
+      reject(new Error("Failed to load image"));
+    };
+    img.src = URL.createObjectURL(file);
+  });
+}
+function getStoredTenantSlug() {
+  if (typeof window === "undefined") {
+    return "";
+  }
+  const directKeys = ["pb_current_tenant", "currentWorkspace"];
+  for (const key of directKeys) {
+    const value = localStorage.getItem(key)?.trim();
+    if (value) {
+      return value;
+    }
+  }
+  const tenantJson = localStorage.getItem("tenant");
+  if (tenantJson) {
+    try {
+      const tenant = JSON.parse(tenantJson);
+      if (tenant.slug?.trim()) {
+        return tenant.slug.trim();
+      }
+    } catch {
+    }
+  }
+  return "";
+}
+async function uploadImage(file) {
+  return uploadViaApi(file);
+}
+function uploadViaApi(file, onProgress) {
+  return new Promise((resolve, reject) => {
+    const formData = new FormData();
+    formData.append("file", file);
+    const tenantSlug = getStoredTenantSlug();
+    const xhr = new XMLHttpRequest();
+    xhr.upload.addEventListener("progress", (event) => {
+      if (event.lengthComputable && onProgress) {
+        const progress = Math.round(event.loaded / event.total * 100);
+        onProgress(progress);
+      }
+    });
+    xhr.addEventListener("load", () => {
+      if (xhr.status >= 200 && xhr.status < 300) {
+        try {
+          const data = JSON.parse(xhr.responseText);
+          resolve({
+            url: data.url,
+            publicId: data.publicId,
+            width: data.width,
+            height: data.height,
+            resourceType: data.resourceType,
+            duration: data.duration,
+            thumbnail: data.thumbnail,
+            isCloudinary: true
+          });
+        } catch {
+          reject(new Error("Failed to parse upload response"));
+        }
+      } else {
+        let message = `Upload failed: ${xhr.status}`;
+        try {
+          const err = JSON.parse(xhr.responseText);
+          if (err?.message) message = err.message;
+        } catch {
+        }
+        reject(new UploadHttpError(xhr.status, message));
+      }
+    });
+    xhr.addEventListener("error", () => {
+      reject(new UploadHttpError(0, "Upload failed - network error"));
+    });
+    xhr.open("POST", "/api/proxy/media/upload");
+    if (tenantSlug) {
+      xhr.setRequestHeader("x-tenant-slug", tenantSlug);
+    }
+    xhr.send(formData);
+  });
+}
+async function uploadImageWithProgress(file, onProgress) {
+  return uploadViaApi(file, onProgress);
+}
+class UploadHttpError extends Error {
+  constructor(status, message) {
+    super(message);
+    this.status = status;
+    this.name = "UploadHttpError";
+  }
+  status;
+}
+function voiceUploadProblem(error) {
+  if (error instanceof UploadHttpError) {
+    if (error.status === 0) return "Check your connection and try again.";
+    if (error.status === 413) return "The recording is too long. Try a shorter one.";
+    if (error.status === 401 || error.status === 403)
+      return "Your session ended. Sign in again and retry.";
+    return `The upload was refused (${error.status}). Try again, or type your message instead.`;
+  }
+  return "Check your connection and try again.";
+}
+async function uploadImageWithAutoCompress(file, onProgress) {
+  if (!file.type.startsWith("image/")) {
+    return uploadViaApi(file, onProgress);
+  }
+  const steps = [
+    [1600, 0.85],
+    [1280, 0.78],
+    [1024, 0.72],
+    [800, 0.65]
+  ];
+  const skipFirstCompress = file.size <= 5e5;
+  let lastError;
+  for (let index = 0; index < steps.length; index += 1) {
+    let candidate = file;
+    if (!(skipFirstCompress && index === 0)) {
+      try {
+        const [maxDimension, quality] = steps[index];
+        const dataUrl = await compressImage(
+          file,
+          maxDimension,
+          maxDimension,
+          quality
+        );
+        const blob = await (await fetch(dataUrl)).blob();
+        candidate = new File([blob], file.name, { type: "image/jpeg" });
+      } catch {
+        candidate = file;
+      }
+    }
+    try {
+      return await uploadViaApi(candidate, onProgress);
+    } catch (error) {
+      lastError = error;
+      if (error instanceof UploadHttpError && error.status === 413) continue;
+      throw error;
+    }
+  }
+  if (lastError instanceof UploadHttpError && lastError.status === 413) {
+    throw new UploadHttpError(
+      413,
+      "Image is too large to upload, even after compressing. Try a smaller photo or one with lower resolution."
+    );
+  }
+  throw lastError ?? new Error("Upload failed");
+}
+async function uploadAudio(blob, mimeType) {
+  const ext = mimeType.includes("mp4") ? "m4a" : mimeType.includes("ogg") ? "ogg" : "webm";
+  const baseType = mimeType.split(";")[0].trim() || "audio/webm";
+  const file = new File([blob], `voice-note.${ext}`, { type: baseType });
+  return uploadViaApi(file);
+}
+function openCloudinaryWidget(options) {
+  const cloudinary = window.cloudinary;
+  if (!cloudinary || !isCloudinaryEnabled) {
+    options.onError?.(new Error("Cloudinary widget not available"));
+    return;
+  }
+  const widget = cloudinary.createUploadWidget(
+    {
+      cloudName: CLOUDINARY_CONFIG.cloudName,
+      uploadPreset: CLOUDINARY_CONFIG.uploadPreset,
+      sources: options.sources || ["local", "url", "camera"],
+      multiple: (options.maxFiles || 1) > 1,
+      maxFiles: options.maxFiles || 1,
+      resourceType: options.resourceType || "image",
+      cropping: options.cropping ?? true,
+      croppingAspectRatio: options.croppingAspectRatio,
+      showAdvancedOptions: options.showAdvancedOptions ?? false,
+      styles: {
+        palette: {
+          window: "#FFFFFF",
+          windowBorder: "#90A0B3",
+          tabIcon: BRAND_PRIMARY,
+          menuIcons: "#5A616A",
+          textDark: "#000000",
+          textLight: "#FFFFFF",
+          link: BRAND_PRIMARY,
+          action: BRAND_PRIMARY,
+          inactiveTabIcon: "#0E2F5A",
+          error: "#F44235",
+          inProgress: BRAND_PRIMARY,
+          complete: "#20B832",
+          sourceBg: "#F4F5F5"
+        }
+      }
+    },
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    (error, result) => {
+      if (error) {
+        options.onError?.(error);
+        return;
+      }
+      if (result.event === "success") {
+        options.onSuccess({
+          url: result.info.secure_url,
+          publicId: result.info.public_id,
+          width: result.info.width,
+          height: result.info.height,
+          format: result.info.format,
+          isCloudinary: true
+        });
+        widget.close();
+      }
+    }
+  );
+  widget.open();
+}
+const CLOUDINARY_WIDGET_SCRIPT = "https://widget.cloudinary.com/v2.0/global/all.js";
+export {
+  CLOUDINARY_CONFIG,
+  CLOUDINARY_TRANSFORMS,
+  CLOUDINARY_WIDGET_SCRIPT,
+  UploadHttpError,
+  buildCloudinaryUrl,
+  compressImage,
+  deriveFaviconUrl,
+  isCloudinaryEnabled,
+  openCloudinaryWidget,
+  uploadAudio,
+  uploadImage,
+  uploadImageWithAutoCompress,
+  uploadImageWithProgress,
+  voiceUploadProblem
+};
+//# sourceMappingURL=media-service.js.map