@withpotter/lib 0.13.0-next.101

package/dist/use-platform-modules.js

@@ -0,0 +1,416 @@
+"use client";
+import { useMemo } from "react";
+import { DELIVERY_NAV } from "./fulfilment-nav";
+import {
+  LayoutDashboard,
+  ShoppingCart,
+  Users,
+  BarChart3,
+  Banknote,
+  Receipt,
+  Package,
+  CalendarRange,
+  CreditCard,
+  MessageSquare,
+  Gift,
+  Star,
+  Percent,
+  Layers,
+  Boxes,
+  BookOpen,
+  Truck,
+  Clock,
+  HelpCircle
+} from "lucide-react";
+import { useCapabilities } from "./capability-context";
+const moduleCapabilities = {
+  orders: "orders",
+  customers: "customers",
+  analytics: "analytics",
+  invoices: "invoices",
+  finance: ["settlements", "payments", "invoices"],
+  inventory: "catalog",
+  collections: "catalog",
+  shipping: "shipping",
+  bookings: "bookings",
+  resources: "bookings",
+  subscriptions: "subscriptions",
+  reviews: "reviews",
+  loyalty: "loyalty",
+  discounts: "discounts",
+  giftcards: "giftcards",
+  blog: "blog"
+};
+const platformNavigation = [
+  {
+    id: "overview",
+    name: "Overview",
+    href: "/dashboard",
+    icon: LayoutDashboard
+  },
+  {
+    id: "orders",
+    name: "Orders",
+    href: "/dashboard/orders",
+    icon: ShoppingCart
+  },
+  {
+    id: "customers",
+    name: "Customers",
+    href: "/dashboard/customers",
+    icon: Users
+  },
+  {
+    id: "analytics",
+    name: "Analytics",
+    href: "/dashboard/analytics",
+    icon: BarChart3
+  },
+  {
+    // The surface is called Payments and lives at /dashboard/payments. The id
+    // stays `finance` because templates declare it in `dashboardModules` and
+    // ShellIcon maps it; only the word a merchant reads was stale here, and a
+    // template declaring this module rendered the retired noun in the sidebar.
+    id: "finance",
+    name: "Payments",
+    href: "/dashboard/payments",
+    icon: Banknote
+  },
+  {
+    id: "invoices",
+    name: "Invoices",
+    href: "/dashboard/invoices",
+    icon: Receipt
+  }
+];
+const coreModuleDefaultIcons = {
+  overview: LayoutDashboard,
+  orders: ShoppingCart,
+  inventory: Package,
+  shipping: Truck,
+  bookings: CalendarRange,
+  customers: Users,
+  subscriptions: CreditCard,
+  inquiries: MessageSquare,
+  finance: Banknote,
+  analytics: BarChart3,
+  invoices: Receipt,
+  loyalty: Gift,
+  reviews: Star,
+  discounts: Percent,
+  giftcards: Gift,
+  collections: Layers,
+  resources: Boxes,
+  blog: BookOpen,
+  hours: Clock,
+  help: HelpCircle
+};
+const coreModuleIds = /* @__PURE__ */ new Set([
+  "overview",
+  "orders",
+  "inventory",
+  "shipping",
+  "bookings",
+  "resources",
+  "calendar-sync",
+  "waitlist",
+  "inquiries",
+  "customers",
+  "invoices",
+  "loyalty",
+  "subscriptions",
+  "finance",
+  "analytics",
+  "reviews",
+  "discounts",
+  "giftcards",
+  "collections",
+  "blog",
+  "hours",
+  "help"
+]);
+const coreModuleOrder = [
+  "overview",
+  "orders",
+  "inventory",
+  "shipping",
+  "collections",
+  "discounts",
+  "giftcards",
+  "bookings",
+  "resources",
+  "calendar-sync",
+  "waitlist",
+  "inquiries",
+  "customers",
+  "reviews",
+  "blog",
+  "invoices",
+  "loyalty",
+  "subscriptions",
+  "finance",
+  "analytics",
+  "hours",
+  "help"
+];
+const universalCoreModules = [
+  {
+    id: "inventory",
+    name: "Inventory",
+    href: "/dashboard/catalog",
+    icon: Package,
+    // Any product-oriented behavior needs inventory tracking
+    requiredBehavior: ["sellable", "rentable", "ticketed", "shippable"]
+  },
+  {
+    id: "shipping",
+    name: DELIVERY_NAV.label,
+    href: "/dashboard/settings/shipping",
+    icon: Truck,
+    requiredBehavior: "shippable"
+  },
+  {
+    id: "bookings",
+    name: "Bookings",
+    href: "/dashboard/bookings",
+    icon: CalendarRange,
+    requiredBehavior: "bookable"
+  },
+  {
+    id: "resources",
+    name: "Resources",
+    href: "/dashboard/resources",
+    icon: Boxes,
+    requiredBehavior: "bookable"
+  },
+  {
+    id: "invoices",
+    name: "Invoices",
+    href: "/dashboard/invoices",
+    icon: Receipt
+  },
+  {
+    id: "subscriptions",
+    name: "Memberships",
+    href: "/dashboard/subscriptions",
+    icon: CreditCard,
+    requiredBehavior: "subscribable"
+  },
+  {
+    id: "reviews",
+    name: "Reviews",
+    href: "/dashboard/reviews",
+    icon: Star
+  },
+  {
+    // The surface is called Payments and lives at /dashboard/payments. The id
+    // stays `finance` because templates declare it in `dashboardModules` and
+    // ShellIcon maps it; only the word a merchant reads was stale here, and a
+    // template declaring this module rendered the retired noun in the sidebar.
+    id: "finance",
+    name: "Payments",
+    href: "/dashboard/payments",
+    icon: Banknote
+  },
+  {
+    id: "loyalty",
+    name: "Loyalty",
+    href: "/dashboard/loyalty",
+    icon: Gift
+  },
+  {
+    id: "analytics",
+    name: "Analytics",
+    href: "/dashboard/analytics",
+    icon: BarChart3
+  },
+  {
+    id: "discounts",
+    name: "Discounts",
+    // The tab — not the retired route, and not the hub: /dashboard/marketing
+    // reads no `view` param, so this left whoever followed it to find Discounts
+    // by hand. The sidebar dropped this row, but Settings → Business model
+    // still links a module to the surface it switches on, and that is this tab.
+    href: "/dashboard/marketing/promotions?view=discounts",
+    icon: Percent,
+    // Discounts apply to any transactional behavior
+    requiredBehavior: [
+      "sellable",
+      "bookable",
+      "rentable",
+      "ticketed",
+      "subscribable"
+    ]
+  },
+  {
+    id: "giftcards",
+    name: "Gift Cards",
+    href: "/dashboard/giftcards",
+    icon: Gift,
+    requiredBehavior: [
+      "sellable",
+      "bookable",
+      "rentable",
+      "ticketed",
+      "subscribable"
+    ]
+  },
+  {
+    id: "collections",
+    name: "Collections",
+    href: "/dashboard/collections",
+    icon: Layers,
+    // Collections group any product-like content
+    requiredBehavior: ["sellable", "rentable", "ticketed"]
+  },
+  {
+    id: "blog",
+    name: "Blog",
+    href: "/dashboard/blog",
+    icon: BookOpen,
+    // Blogging is a thing a business chooses to do, not a thing every business
+    // does. A venue that will never write a post had a Blog row in its sidebar
+    // for as long as this was ungated, because the behavior vocabulary was
+    // transactional and there was nothing for it to hang on.
+    requiredBehavior: "publishable"
+  },
+  {
+    id: "hours",
+    name: "Hours",
+    href: "/dashboard/settings/hours",
+    icon: Clock
+    // No behavior gate — hours are available to all merchants
+  },
+  {
+    id: "help",
+    name: "Help",
+    href: "/dashboard/help",
+    icon: HelpCircle
+    // No behavior gate — help is available to all merchants
+  }
+];
+function templateHasBehavior(behaviors, behavior) {
+  if (!behaviors) return false;
+  if (Array.isArray(behaviors)) {
+    return behaviors.includes(behavior);
+  }
+  if (typeof behaviors === "object") {
+    const b = behaviors;
+    const capitalized = behavior.charAt(0).toUpperCase() + behavior.slice(1);
+    const keys = [`enable${capitalized}`, `enable${capitalized}s`, behavior];
+    const behaviorToFlagMap = {
+      subscribable: [
+        "enableSubscriptions",
+        "enableSubscription",
+        "enableMemberships",
+        "enableMembership"
+      ],
+      bookable: ["enableBookings", "enableBooking", "enableReservations"],
+      sellable: ["enableOrders", "enableSelling", "sellable"]
+    };
+    const extraKeys = behaviorToFlagMap[behavior] || [];
+    const allKeys = [...keys, ...extraKeys];
+    return allKeys.some((k) => b[k] === true);
+  }
+  return false;
+}
+function usePlatformModules({
+  template,
+  dashboardState,
+  enabledBehaviors,
+  hiddenModules,
+  moduleLabels,
+  moduleOrder
+}) {
+  const capabilities = useCapabilities();
+  return useMemo(() => {
+    const coreMap = /* @__PURE__ */ new Map();
+    if (!template || dashboardState === "template-missing") {
+      platformNavigation.forEach((m) => coreMap.set(m.id, m));
+      universalCoreModules.forEach((mod) => {
+        const { requiredBehavior, ...m } = mod;
+        void requiredBehavior;
+        if (!coreMap.has(m.id)) coreMap.set(m.id, m);
+      });
+    } else {
+      const templateModules = template.dashboardModules || [];
+      const excludeIds = /* @__PURE__ */ new Set(["settings", "appearance"]);
+      const canonicalCoreHrefs = /* @__PURE__ */ new Map();
+      platformNavigation.forEach((m) => canonicalCoreHrefs.set(m.id, m.href));
+      universalCoreModules.forEach((m) => canonicalCoreHrefs.set(m.id, m.href));
+      const gatesById = /* @__PURE__ */ new Map();
+      universalCoreModules.forEach((m) => {
+        if (!m.requiredBehavior) return;
+        gatesById.set(
+          m.id,
+          Array.isArray(m.requiredBehavior) ? m.requiredBehavior : [m.requiredBehavior]
+        );
+      });
+      const passesGate = (id) => {
+        const gates = gatesById.get(id);
+        if (!gates) return true;
+        if (enabledBehaviors?.length) {
+          return gates.some((g) => enabledBehaviors.includes(g));
+        }
+        return gates.some((g) => templateHasBehavior(template.behaviors, g));
+      };
+      templateModules.forEach((m) => {
+        if (excludeIds.has(m.id)) return;
+        if (!coreModuleIds.has(m.id)) return;
+        if (!passesGate(m.id)) return;
+        const defaultIcon = coreModuleDefaultIcons[m.id];
+        const canonicalHref = canonicalCoreHrefs.get(m.id) || m.href;
+        coreMap.set(m.id, {
+          ...m,
+          href: canonicalHref,
+          ...defaultIcon ? { icon: defaultIcon } : {}
+        });
+      });
+      platformNavigation.forEach((m) => {
+        if (!coreMap.has(m.id)) coreMap.set(m.id, m);
+      });
+      universalCoreModules.forEach(({ requiredBehavior, ...m }) => {
+        void requiredBehavior;
+        if (coreMap.has(m.id)) return;
+        if (!passesGate(m.id)) return;
+        coreMap.set(m.id, m);
+      });
+    }
+    const essentialIds = /* @__PURE__ */ new Set(["overview"]);
+    const hidden = new Set(hiddenModules ?? []);
+    const labels = moduleLabels ?? {};
+    const order = moduleOrder?.length ? moduleOrder : coreModuleOrder;
+    const allowedByCapability = (id) => {
+      const required = moduleCapabilities[id];
+      if (!required) return true;
+      const gates = Array.isArray(required) ? required : [required];
+      return capabilities.hasAny(gates);
+    };
+    return {
+      coreNavigation: Array.from(coreMap.values()).filter((m) => essentialIds.has(m.id) || !hidden.has(m.id)).filter((m) => allowedByCapability(m.id)).sort((a, b) => {
+        const posA = order.indexOf(a.id);
+        const posB = order.indexOf(b.id);
+        return (posA === -1 ? 999 : posA) - (posB === -1 ? 999 : posB);
+      }).map((m) => labels[m.id] ? { ...m, name: labels[m.id] } : m)
+    };
+  }, [
+    template,
+    dashboardState,
+    enabledBehaviors,
+    hiddenModules,
+    moduleLabels,
+    moduleOrder,
+    capabilities
+  ]);
+}
+export {
+  coreModuleDefaultIcons,
+  coreModuleIds,
+  coreModuleOrder,
+  moduleCapabilities,
+  platformNavigation,
+  templateHasBehavior,
+  universalCoreModules,
+  usePlatformModules
+};
+//# sourceMappingURL=use-platform-modules.js.map

package/dist/use-platform-modules.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-platform-modules.ts"],"sourcesContent":["'use client';\n\nimport { useMemo } from 'react';\nimport { DELIVERY_NAV } from './fulfilment-nav';\nimport {\n  LayoutDashboard,\n  ShoppingCart,\n  Users,\n  BarChart3,\n  Banknote,\n  Receipt,\n  Package,\n  CalendarRange,\n  CreditCard,\n  MessageSquare,\n  Gift,\n  Star,\n  Percent,\n  Layers,\n  Boxes,\n  BookOpen,\n  Truck,\n  Clock,\n  HelpCircle,\n  type LucideIcon,\n} from 'lucide-react';\nimport {\n  type TemplateConfig,\n  type DashboardModule,\n  type DashboardState,\n} from './template-context';\nimport { useCapabilities } from './capability-context';\n\n// Nav module id → capability key(s) that must be entitled for the module to\n// appear. A module absent from this map has no capability gate (always allowed,\n// e.g. overview/hours/help). Gating is permissive when the box has not published\n// a capability set (see capability-context), preserving legacy behavior.\nexport const moduleCapabilities: Record<string, string | string[]> = {\n  orders: 'orders',\n  customers: 'customers',\n  analytics: 'analytics',\n  invoices: 'invoices',\n  finance: ['settlements', 'payments', 'invoices'],\n  inventory: 'catalog',\n  collections: 'catalog',\n  shipping: 'shipping',\n  bookings: 'bookings',\n  resources: 'bookings',\n  subscriptions: 'subscriptions',\n  reviews: 'reviews',\n  loyalty: 'loyalty',\n  discounts: 'discounts',\n  giftcards: 'giftcards',\n  blog: 'blog',\n};\n\n// ============================================\n// Constants — Platform Module Definitions\n// ============================================\n\n// Platform-standard modules — always rendered regardless of template state.\n// Covers all essential merchant operations so the dashboard is never empty.\nexport const platformNavigation: DashboardModule[] = [\n  {\n    id: 'overview',\n    name: 'Overview',\n    href: '/dashboard',\n    icon: LayoutDashboard,\n  },\n  {\n    id: 'orders',\n    name: 'Orders',\n    href: '/dashboard/orders',\n    icon: ShoppingCart,\n  },\n  {\n    id: 'customers',\n    name: 'Customers',\n    href: '/dashboard/customers',\n    icon: Users,\n  },\n  {\n    id: 'analytics',\n    name: 'Analytics',\n    href: '/dashboard/analytics',\n    icon: BarChart3,\n  },\n  {\n    // The surface is called Payments and lives at /dashboard/payments. The id\n    // stays `finance` because templates declare it in `dashboardModules` and\n    // ShellIcon maps it; only the word a merchant reads was stale here, and a\n    // template declaring this module rendered the retired noun in the sidebar.\n    id: 'finance',\n    name: 'Payments',\n    href: '/dashboard/payments',\n    icon: Banknote,\n  },\n  {\n    id: 'invoices',\n    name: 'Invoices',\n    href: '/dashboard/invoices',\n    icon: Receipt,\n  },\n];\n\n// Default icons for core platform modules — ensures consistent icons\n// Templates can still override via their dashboardModules icon field\nconst coreModuleDefaultIcons: Record<string, LucideIcon> = {\n  overview: LayoutDashboard,\n  orders: ShoppingCart,\n  inventory: Package,\n  shipping: Truck,\n  bookings: CalendarRange,\n  customers: Users,\n  subscriptions: CreditCard,\n  inquiries: MessageSquare,\n  finance: Banknote,\n  analytics: BarChart3,\n  invoices: Receipt,\n  loyalty: Gift,\n  reviews: Star,\n  discounts: Percent,\n  giftcards: Gift,\n  collections: Layers,\n  resources: Boxes,\n  blog: BookOpen,\n  hours: Clock,\n  help: HelpCircle,\n};\n\n// Core module IDs — these are platform features, not content types.\n// They should NEVER depend on template dashboardModules to appear.\nconst coreModuleIds = new Set([\n  'overview',\n  'orders',\n  'inventory',\n  'shipping',\n  'bookings',\n  'resources',\n  'calendar-sync',\n  'waitlist',\n  'inquiries',\n  'customers',\n  'invoices',\n  'loyalty',\n  'subscriptions',\n  'finance',\n  'analytics',\n  'reviews',\n  'discounts',\n  'giftcards',\n  'collections',\n  'blog',\n  'hours',\n  'help',\n]);\n\n// Desired navigation order for core modules\nconst coreModuleOrder = [\n  'overview',\n  'orders',\n  'inventory',\n  'shipping',\n  'collections',\n  'discounts',\n  'giftcards',\n  'bookings',\n  'resources',\n  'calendar-sync',\n  'waitlist',\n  'inquiries',\n  'customers',\n  'reviews',\n  'blog',\n  'invoices',\n  'loyalty',\n  'subscriptions',\n  'finance',\n  'analytics',\n  'hours',\n  'help',\n];\n\n// Universal platform modules — always injected into core section.\n// Modules with `requiredBehavior` are only shown if the template declares that behavior.\n//\n// When the template is unavailable (failed to load), behavior-gated modules are shown\n// unconditionally — better to show too many operational tools than hide them and block\n// the merchant from managing inventory/bookings.\nexport const universalCoreModules: (DashboardModule & {\n  requiredBehavior?: string | string[];\n})[] = [\n  {\n    id: 'inventory',\n    name: 'Inventory',\n    href: '/dashboard/catalog',\n    icon: Package,\n    // Any product-oriented behavior needs inventory tracking\n    requiredBehavior: ['sellable', 'rentable', 'ticketed', 'shippable'],\n  },\n  {\n    id: 'shipping',\n    name: DELIVERY_NAV.label,\n    href: '/dashboard/settings/shipping',\n    icon: Truck,\n    requiredBehavior: 'shippable',\n  },\n  {\n    id: 'bookings',\n    name: 'Bookings',\n    href: '/dashboard/bookings',\n    icon: CalendarRange,\n    requiredBehavior: 'bookable',\n  },\n  {\n    id: 'resources',\n    name: 'Resources',\n    href: '/dashboard/resources',\n    icon: Boxes,\n    requiredBehavior: 'bookable',\n  },\n  {\n    id: 'invoices',\n    name: 'Invoices',\n    href: '/dashboard/invoices',\n    icon: Receipt,\n  },\n  {\n    id: 'subscriptions',\n    name: 'Memberships',\n    href: '/dashboard/subscriptions',\n    icon: CreditCard,\n    requiredBehavior: 'subscribable',\n  },\n  {\n    id: 'reviews',\n    name: 'Reviews',\n    href: '/dashboard/reviews',\n    icon: Star,\n  },\n  {\n    // The surface is called Payments and lives at /dashboard/payments. The id\n    // stays `finance` because templates declare it in `dashboardModules` and\n    // ShellIcon maps it; only the word a merchant reads was stale here, and a\n    // template declaring this module rendered the retired noun in the sidebar.\n    id: 'finance',\n    name: 'Payments',\n    href: '/dashboard/payments',\n    icon: Banknote,\n  },\n  {\n    id: 'loyalty',\n    name: 'Loyalty',\n    href: '/dashboard/loyalty',\n    icon: Gift,\n  },\n  {\n    id: 'analytics',\n    name: 'Analytics',\n    href: '/dashboard/analytics',\n    icon: BarChart3,\n  },\n  {\n    id: 'discounts',\n    name: 'Discounts',\n    // The tab — not the retired route, and not the hub: /dashboard/marketing\n    // reads no `view` param, so this left whoever followed it to find Discounts\n    // by hand. The sidebar dropped this row, but Settings → Business model\n    // still links a module to the surface it switches on, and that is this tab.\n    href: '/dashboard/marketing/promotions?view=discounts',\n    icon: Percent,\n    // Discounts apply to any transactional behavior\n    requiredBehavior: [\n      'sellable',\n      'bookable',\n      'rentable',\n      'ticketed',\n      'subscribable',\n    ],\n  },\n  {\n    id: 'giftcards',\n    name: 'Gift Cards',\n    href: '/dashboard/giftcards',\n    icon: Gift,\n    requiredBehavior: [\n      'sellable',\n      'bookable',\n      'rentable',\n      'ticketed',\n      'subscribable',\n    ],\n  },\n  {\n    id: 'collections',\n    name: 'Collections',\n    href: '/dashboard/collections',\n    icon: Layers,\n    // Collections group any product-like content\n    requiredBehavior: ['sellable', 'rentable', 'ticketed'],\n  },\n  {\n    id: 'blog',\n    name: 'Blog',\n    href: '/dashboard/blog',\n    icon: BookOpen,\n    // Blogging is a thing a business chooses to do, not a thing every business\n    // does. A venue that will never write a post had a Blog row in its sidebar\n    // for as long as this was ungated, because the behavior vocabulary was\n    // transactional and there was nothing for it to hang on.\n    requiredBehavior: 'publishable',\n  },\n  {\n    id: 'hours',\n    name: 'Hours',\n    href: '/dashboard/settings/hours',\n    icon: Clock,\n    // No behavior gate — hours are available to all merchants\n  },\n  {\n    id: 'help',\n    name: 'Help',\n    href: '/dashboard/help',\n    icon: HelpCircle,\n    // No behavior gate — help is available to all merchants\n  },\n];\n\n// ============================================\n// Behavior Checking\n// ============================================\n\n/**\n * Check if a template supports a given behavior.\n * Handles both array format ([\"subscribable\", \"sellable\"]) and\n * object format ({ enableSubscriptions: true, enableBookings: true }).\n * Object keys are matched by convention: \"subscribable\" → enableSubscriptions/enableSubscription.\n */\nfunction templateHasBehavior(behaviors: unknown, behavior: string): boolean {\n  if (!behaviors) return false;\n  // Array format: [\"subscribable\", \"sellable\", ...]\n  if (Array.isArray(behaviors)) {\n    return behaviors.includes(behavior);\n  }\n  // Object format: { enableSubscriptions: true, enableBookings: true, ... }\n  if (typeof behaviors === 'object') {\n    const b = behaviors as Record<string, unknown>;\n    const capitalized = behavior.charAt(0).toUpperCase() + behavior.slice(1);\n    const keys = [`enable${capitalized}`, `enable${capitalized}s`, behavior];\n    const behaviorToFlagMap: Record<string, string[]> = {\n      subscribable: [\n        'enableSubscriptions',\n        'enableSubscription',\n        'enableMemberships',\n        'enableMembership',\n      ],\n      bookable: ['enableBookings', 'enableBooking', 'enableReservations'],\n      sellable: ['enableOrders', 'enableSelling', 'sellable'],\n    };\n    const extraKeys = behaviorToFlagMap[behavior] || [];\n    const allKeys = [...keys, ...extraKeys];\n    return allKeys.some((k) => b[k] === true);\n  }\n  return false;\n}\n\n// ============================================\n// Hook\n// ============================================\n\ninterface UsePlatformModulesOptions {\n  /** The current tenant's resolved template config (null if unavailable) */\n  template: TemplateConfig | null;\n  /** Dashboard resilience state */\n  dashboardState: DashboardState;\n  /** Tenant's enabled behaviors — overrides template behaviors when present */\n  enabledBehaviors?: string[];\n  /** Module IDs the merchant has explicitly hidden */\n  hiddenModules?: string[];\n  /** Custom labels for sidebar modules — overrides platform default names */\n  moduleLabels?: Record<string, string>;\n  /** Merchant's custom module order — array of module IDs */\n  moduleOrder?: string[];\n}\n\ninterface UsePlatformModulesReturn {\n  /** Platform-owned operational modules — always present */\n  coreNavigation: DashboardModule[];\n}\n\n/**\n * Determines which navigation modules to display in the dashboard sidebar.\n *\n * **Platform modules** (coreNavigation) — derived from API capabilities (behaviors).\n * Always present regardless of template dashboardModules config. Behavior-gated\n * modules (Inventory, Bookings, Subscriptions) appear when the tenant has enabled\n * the relevant behavior. When the template is unavailable, ALL platform modules\n * are shown unconditionally to prevent merchants from losing access to operational tools.\n *\n * This hook is the trust boundary: template corruption can never hide operational\n * platform modules.\n */\nexport function usePlatformModules({\n  template,\n  dashboardState,\n  enabledBehaviors,\n  hiddenModules,\n  moduleLabels,\n  moduleOrder,\n}: UsePlatformModulesOptions): UsePlatformModulesReturn {\n  const capabilities = useCapabilities();\n  return useMemo(() => {\n    const coreMap = new Map<string, DashboardModule>();\n\n    // ── No template: show platform modules only ────────────────────────\n    // Merchant still has Orders, Customers, Analytics, Finance, Invoices.\n    // Behavior-gated modules (Inventory, Bookings) are shown unconditionally\n    // because we can't determine behaviors without a template — and it's better\n    // to show an empty Inventory page than to hide it entirely.\n    if (!template || dashboardState === 'template-missing') {\n      // Start with base platform modules\n      platformNavigation.forEach((m) => coreMap.set(m.id, m));\n\n      // Show ALL universal modules (skip behavior gates when template is unavailable)\n      universalCoreModules.forEach((mod) => {\n        const { requiredBehavior, ...m } = mod;\n        void requiredBehavior; // intentionally unused — skip gates when template missing\n        if (!coreMap.has(m.id)) coreMap.set(m.id, m);\n      });\n    } else {\n      // ── Template available: merge platform + template core modules ────\n      const templateModules = template.dashboardModules || [];\n\n      // Filter out settings and appearance modules (rendered separately in sidebar)\n      const excludeIds = new Set(['settings', 'appearance']);\n\n      // Build a lookup of canonical hrefs for core modules.\n      // Templates must never redirect core modules to content pages.\n      const canonicalCoreHrefs = new Map<string, string>();\n      platformNavigation.forEach((m) => canonicalCoreHrefs.set(m.id, m.href));\n      universalCoreModules.forEach((m) => canonicalCoreHrefs.set(m.id, m.href));\n\n      // Behaviour gates, keyed by module id, so a template-declared module is\n      // held to the same rule as the platform's own.\n      const gatesById = new Map<string, string[]>();\n      universalCoreModules.forEach((m) => {\n        if (!m.requiredBehavior) return;\n        gatesById.set(\n          m.id,\n          Array.isArray(m.requiredBehavior)\n            ? m.requiredBehavior\n            : [m.requiredBehavior],\n        );\n      });\n\n      const passesGate = (id: string): boolean => {\n        const gates = gatesById.get(id);\n        if (!gates) return true;\n        if (enabledBehaviors?.length) {\n          return gates.some((g) => enabledBehaviors.includes(g));\n        }\n        return gates.some((g) => templateHasBehavior(template.behaviors, g));\n      };\n\n      // Only accept template modules that match known core IDs\n      templateModules.forEach((m) => {\n        if (excludeIds.has(m.id)) return;\n        if (!coreModuleIds.has(m.id)) return;\n        // ...and that the tenant's behaviours actually allow.\n        //\n        // This branch used to skip gating entirely, which quietly undid every\n        // gate below it: web-render's BASE_DASHBOARD_MODULES declares a `blog`\n        // module for EVERY template, so blog was always inserted here first,\n        // and the gated entry in `universalCoreModules` was then skipped as a\n        // duplicate. Gating one list while another list feeds the same map\n        // ungated is not a gate.\n        if (!passesGate(m.id)) return;\n\n        // Ensure core modules always have their designated icons AND hrefs.\n        const defaultIcon = coreModuleDefaultIcons[m.id];\n        const canonicalHref = canonicalCoreHrefs.get(m.id) || m.href;\n        coreMap.set(m.id, {\n          ...m,\n          href: canonicalHref,\n          ...(defaultIcon ? { icon: defaultIcon } : {}),\n        });\n      });\n\n      // Always inject platform-standard modules (Orders, Customers, etc.)\n      platformNavigation.forEach((m) => {\n        if (!coreMap.has(m.id)) coreMap.set(m.id, m);\n      });\n\n      // Inject universal core modules, gated by behavior.\n      // When tenant has enabledBehaviors, use that. Otherwise fall back to template behaviors.\n      // requiredBehavior can be a single string or an array (match ANY).\n      universalCoreModules.forEach(({ requiredBehavior, ...m }) => {\n        void requiredBehavior; // read via `passesGate`, keyed by id\n        if (coreMap.has(m.id)) return;\n        if (!passesGate(m.id)) return;\n        coreMap.set(m.id, m);\n      });\n    }\n\n    // Apply hiddenModules filter — merchant can hide non-essential modules.\n    // Platform-essential modules (overview) are never hidden.\n    const essentialIds = new Set(['overview']);\n    const hidden = new Set(hiddenModules ?? []);\n    const labels = moduleLabels ?? {};\n    // Use merchant's custom order when set; otherwise fall back to platform default\n    const order = moduleOrder?.length ? moduleOrder : coreModuleOrder;\n\n    // Capability gate — drop modules whose backing engine the box's tier does\n    // not entitle. Applied to BOTH the template-available and template-missing\n    // branches so an un-entitled surface (e.g. Subscriptions on a basic box) is\n    // never rendered, even when the template fails to load. Permissive when the\n    // box has not published a capability set (legacy boxes show everything).\n    const allowedByCapability = (id: string): boolean => {\n      const required = moduleCapabilities[id];\n      if (!required) return true;\n      const gates = Array.isArray(required) ? required : [required];\n      return capabilities.hasAny(gates);\n    };\n\n    return {\n      coreNavigation: Array.from(coreMap.values())\n        .filter((m) => essentialIds.has(m.id) || !hidden.has(m.id))\n        .filter((m) => allowedByCapability(m.id))\n        .sort((a, b) => {\n          const posA = order.indexOf(a.id);\n          const posB = order.indexOf(b.id);\n          return (posA === -1 ? 999 : posA) - (posB === -1 ? 999 : posB);\n        })\n        .map((m) => (labels[m.id] ? { ...m, name: labels[m.id] } : m)),\n    };\n  }, [\n    template,\n    dashboardState,\n    enabledBehaviors,\n    hiddenModules,\n    moduleLabels,\n    moduleOrder,\n    capabilities,\n  ]);\n}\n\n// ============================================\n// Re-exports for features settings page\n// ============================================\n\nexport {\n  coreModuleIds,\n  coreModuleDefaultIcons,\n  coreModuleOrder,\n  templateHasBehavior,\n};\n"],"mappings":"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","names":[]}

package/dist/use-staff-home.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The screen this person's shift starts on.
+ *
+ * `resolveStaffHome` is pure and wants two things — the permissions and the
+ * business's behaviours — and assembling those was written out on the dashboard
+ * home. A second caller wanted the same answer, and a second copy of the
+ * assembly is how the two would come to disagree about where somebody belongs.
+ */
+export declare function useStaffHome(): string;

package/dist/use-staff-home.js

@@ -0,0 +1,24 @@
+"use client";
+import { useMemo } from "react";
+import { useAuth } from "@withpotter/lib/auth-context";
+import { useCurrentTemplate } from "@withpotter/lib/template-context";
+import { usePermissions } from "@withpotter/lib/use-permissions";
+import { resolveEnabledBehaviors } from "@withpotter/lib/resolve-enabled-behaviors";
+import { resolveStaffHome } from "@withpotter/lib/staff-home";
+function useStaffHome() {
+  const { tenant } = useAuth();
+  const { template } = useCurrentTemplate(tenant?.templateId);
+  const { can } = usePermissions();
+  const behaviors = useMemo(
+    () => resolveEnabledBehaviors(
+      tenant?.settings,
+      template
+    ),
+    [tenant?.settings, template]
+  );
+  return useMemo(() => resolveStaffHome({ can, behaviors }), [can, behaviors]);
+}
+export {
+  useStaffHome
+};
+//# sourceMappingURL=use-staff-home.js.map

package/dist/use-staff-home.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-staff-home.ts"],"sourcesContent":["'use client';\n\nimport { useMemo } from 'react';\nimport { useAuth } from '@withpotter/lib/auth-context';\nimport { useCurrentTemplate } from '@withpotter/lib/template-context';\nimport { usePermissions } from '@withpotter/lib/use-permissions';\nimport { resolveEnabledBehaviors } from '@withpotter/lib/resolve-enabled-behaviors';\nimport { resolveStaffHome } from '@withpotter/lib/staff-home';\n\n/**\n * The screen this person's shift starts on.\n *\n * `resolveStaffHome` is pure and wants two things — the permissions and the\n * business's behaviours — and assembling those was written out on the dashboard\n * home. A second caller wanted the same answer, and a second copy of the\n * assembly is how the two would come to disagree about where somebody belongs.\n */\nexport function useStaffHome(): string {\n  const { tenant } = useAuth();\n  const { template } = useCurrentTemplate(tenant?.templateId);\n  const { can } = usePermissions();\n\n  const behaviors = useMemo(\n    () =>\n      resolveEnabledBehaviors(\n        tenant?.settings as Record<string, unknown> | undefined,\n        template,\n      ),\n    [tenant?.settings, template],\n  );\n\n  return useMemo(() => resolveStaffHome({ can, behaviors }), [can, behaviors]);\n}\n"],"mappings":";AAEA,SAAS,eAAe;AACxB,SAAS,eAAe;AACxB,SAAS,0BAA0B;AACnC,SAAS,sBAAsB;AAC/B,SAAS,+BAA+B;AACxC,SAAS,wBAAwB;AAU1B,SAAS,eAAuB;AACrC,QAAM,EAAE,OAAO,IAAI,QAAQ;AAC3B,QAAM,EAAE,SAAS,IAAI,mBAAmB,QAAQ,UAAU;AAC1D,QAAM,EAAE,IAAI,IAAI,eAAe;AAE/B,QAAM,YAAY;AAAA,IAChB,MACE;AAAA,MACE,QAAQ;AAAA,MACR;AAAA,IACF;AAAA,IACF,CAAC,QAAQ,UAAU,QAAQ;AAAA,EAC7B;AAEA,SAAO,QAAQ,MAAM,iBAAiB,EAAE,KAAK,UAAU,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;AAC7E;","names":[]}

package/dist/use-workspace-invite.d.ts

@@ -0,0 +1,37 @@
+import type { TeamRoleResponse } from '@withpotter/lib/api/types';
+/**
+ * What the invite dialog hands its sender, beyond the email and phone the
+ * page already holds.
+ *
+ * Passed per-call rather than kept as hook state: two hooks implement the
+ * sender (this one for the sidebar, useSettingsData for the settings page)
+ * and duplicating the fields in both is how they drift.
+ */
+export interface WorkspaceInviteOptions {
+    /** The role row to invite against, when the caller just created it. */
+    roleId?: string;
+    name?: string;
+    /** Empty or absent means every location. */
+    locationIds?: string[];
+}
+/**
+ * Just enough state to invite someone to the current workspace.
+ *
+ * `useSettingsData` already does this, but it also loads org members, workspace
+ * members, deletion state and the rest of the settings page — far too much to
+ * mount in the app shell just so the sidebar can offer an invite. This is the
+ * workspace-invite slice on its own, so the same dialog can open from the
+ * sidebar without a second implementation of the invite behind it.
+ */
+export declare function useWorkspaceInvite(): {
+    roles: TeamRoleResponse[];
+    email: string;
+    setEmail: import("react").Dispatch<import("react").SetStateAction<string>>;
+    phone: string;
+    setPhone: import("react").Dispatch<import("react").SetStateAction<string>>;
+    role: string;
+    setRole: import("react").Dispatch<import("react").SetStateAction<string>>;
+    invite: (opts?: WorkspaceInviteOptions) => Promise<import("@withpotter/hooks").WorkspaceMember | undefined>;
+    inviting: boolean;
+    error: string | null;
+};

package/dist/use-workspace-invite.js

@@ -0,0 +1,69 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { useAuth } from "./auth-context";
+import { teamApi } from "./api";
+import { completeFlow } from "@withpotter/components/feedback/flow-completion";
+import { asList } from "@withpotter/lib/utils";
+function useWorkspaceInvite() {
+  const { tenant } = useAuth();
+  const queryClient = useQueryClient();
+  const [email, setEmail] = useState("");
+  const [phone, setPhone] = useState("");
+  const [role, setRole] = useState("staff");
+  const [inviting, setInviting] = useState(false);
+  const [error, setError] = useState(null);
+  const { data: rolesData } = useQuery({
+    queryKey: ["team-roles", tenant?.slug],
+    queryFn: () => teamApi.listRoles(tenant.slug).catch(() => []),
+    enabled: !!tenant?.slug,
+    staleTime: 5 * 6e4
+  });
+  const roles = asList(rolesData);
+  const invite = useCallback(
+    async (opts) => {
+      if (!email.trim() || !tenant?.slug) return;
+      setInviting(true);
+      setError(null);
+      try {
+        const roleId = opts?.roleId ?? roles.find((r) => r.id === role)?.id ?? void 0;
+        const invited = await teamApi.invite(tenant.slug, {
+          email: email.trim(),
+          name: opts?.name?.trim() || void 0,
+          phoneNumber: phone.trim() || void 0,
+          ...roleId ? { roleId } : { role },
+          ...opts?.locationIds?.length ? { locationIds: opts.locationIds } : {}
+        });
+        setEmail("");
+        setPhone("");
+        await queryClient.invalidateQueries({
+          queryKey: ["team-members", tenant.slug]
+        });
+        completeFlow("team.invite");
+        return invited;
+      } catch (err) {
+        setError(err instanceof Error ? err.message : "Failed to send invite");
+        throw err;
+      } finally {
+        setInviting(false);
+      }
+    },
+    [email, phone, role, roles, tenant?.slug, queryClient]
+  );
+  return {
+    roles,
+    email,
+    setEmail,
+    phone,
+    setPhone,
+    role,
+    setRole,
+    invite,
+    inviting,
+    error
+  };
+}
+export {
+  useWorkspaceInvite
+};
+//# sourceMappingURL=use-workspace-invite.js.map

package/dist/use-workspace-invite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-workspace-invite.ts"],"sourcesContent":["'use client';\n\nimport { useCallback, useState } from 'react';\nimport { useQuery, useQueryClient } from '@tanstack/react-query';\nimport { useAuth } from './auth-context';\nimport { teamApi } from './api';\nimport { completeFlow } from '@withpotter/components/feedback/flow-completion';\nimport { asList } from '@withpotter/lib/utils';\nimport type { TeamRoleResponse } from '@withpotter/lib/api/types';\n\n/**\n * What the invite dialog hands its sender, beyond the email and phone the\n * page already holds.\n *\n * Passed per-call rather than kept as hook state: two hooks implement the\n * sender (this one for the sidebar, useSettingsData for the settings page)\n * and duplicating the fields in both is how they drift.\n */\nexport interface WorkspaceInviteOptions {\n  /** The role row to invite against, when the caller just created it. */\n  roleId?: string;\n  name?: string;\n  /** Empty or absent means every location. */\n  locationIds?: string[];\n}\n\n/**\n * Just enough state to invite someone to the current workspace.\n *\n * `useSettingsData` already does this, but it also loads org members, workspace\n * members, deletion state and the rest of the settings page — far too much to\n * mount in the app shell just so the sidebar can offer an invite. This is the\n * workspace-invite slice on its own, so the same dialog can open from the\n * sidebar without a second implementation of the invite behind it.\n */\nexport function useWorkspaceInvite() {\n  const { tenant } = useAuth();\n  const queryClient = useQueryClient();\n  const [email, setEmail] = useState('');\n  const [phone, setPhone] = useState('');\n  const [role, setRole] = useState('staff');\n  const [inviting, setInviting] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n\n  const { data: rolesData } = useQuery({\n    queryKey: ['team-roles', tenant?.slug],\n    queryFn: () => teamApi.listRoles(tenant!.slug).catch(() => []),\n    enabled: !!tenant?.slug,\n    staleTime: 5 * 60_000,\n  });\n  // This hook runs inside the sidebar footer, so a non-array here reaches the\n  // shell the same way the members list did. `roles.find` throws just as\n  // readily as `.filter`.\n  const roles = asList<TeamRoleResponse>(rolesData);\n\n  const invite = useCallback(\n    async (opts?: WorkspaceInviteOptions) => {\n      if (!email.trim() || !tenant?.slug) return;\n      setInviting(true);\n      setError(null);\n      try {\n        const roleId =\n          opts?.roleId ?? roles.find((r) => r.id === role)?.id ?? undefined;\n        const invited = await teamApi.invite(tenant.slug, {\n          email: email.trim(),\n          name: opts?.name?.trim() || undefined,\n          phoneNumber: phone.trim() || undefined,\n          ...(roleId ? { roleId } : { role }),\n          ...(opts?.locationIds?.length\n            ? { locationIds: opts.locationIds }\n            : {}),\n        });\n        setEmail('');\n        setPhone('');\n        // The footer's avatar stack reads this list, so it has to re-fetch for\n        // the new person to show up without a reload.\n        await queryClient.invalidateQueries({\n          queryKey: ['team-members', tenant.slug],\n        });\n        completeFlow('team.invite');\n        return invited;\n      } catch (err) {\n        // Recorded for this hook's own consumers, then re-thrown so the dialog\n        // can show the real reason instead of guessing. See the note on\n        // useSettingsData.handleWsInvite.\n        setError(err instanceof Error ? err.message : 'Failed to send invite');\n        throw err;\n      } finally {\n        setInviting(false);\n      }\n    },\n    [email, phone, role, roles, tenant?.slug, queryClient],\n  );\n\n  return {\n    roles,\n    email,\n    setEmail,\n    phone,\n    setPhone,\n    role,\n    setRole,\n    invite,\n    inviting,\n    error,\n  };\n}\n"],"mappings":";AAEA,SAAS,aAAa,gBAAgB;AACtC,SAAS,UAAU,sBAAsB;AACzC,SAAS,eAAe;AACxB,SAAS,eAAe;AACxB,SAAS,oBAAoB;AAC7B,SAAS,cAAc;AA4BhB,SAAS,qBAAqB;AACnC,QAAM,EAAE,OAAO,IAAI,QAAQ;AAC3B,QAAM,cAAc,eAAe;AACnC,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,EAAE;AACrC,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,EAAE;AACrC,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,OAAO;AACxC,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,KAAK;AAC9C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAwB,IAAI;AAEtD,QAAM,EAAE,MAAM,UAAU,IAAI,SAAS;AAAA,IACnC,UAAU,CAAC,cAAc,QAAQ,IAAI;AAAA,IACrC,SAAS,MAAM,QAAQ,UAAU,OAAQ,IAAI,EAAE,MAAM,MAAM,CAAC,CAAC;AAAA,IAC7D,SAAS,CAAC,CAAC,QAAQ;AAAA,IACnB,WAAW,IAAI;AAAA,EACjB,CAAC;AAID,QAAM,QAAQ,OAAyB,SAAS;AAEhD,QAAM,SAAS;AAAA,IACb,OAAO,SAAkC;AACvC,UAAI,CAAC,MAAM,KAAK,KAAK,CAAC,QAAQ,KAAM;AACpC,kBAAY,IAAI;AAChB,eAAS,IAAI;AACb,UAAI;AACF,cAAM,SACJ,MAAM,UAAU,MAAM,KAAK,CAAC,MAAM,EAAE,OAAO,IAAI,GAAG,MAAM;AAC1D,cAAM,UAAU,MAAM,QAAQ,OAAO,OAAO,MAAM;AAAA,UAChD,OAAO,MAAM,KAAK;AAAA,UAClB,MAAM,MAAM,MAAM,KAAK,KAAK;AAAA,UAC5B,aAAa,MAAM,KAAK,KAAK;AAAA,UAC7B,GAAI,SAAS,EAAE,OAAO,IAAI,EAAE,KAAK;AAAA,UACjC,GAAI,MAAM,aAAa,SACnB,EAAE,aAAa,KAAK,YAAY,IAChC,CAAC;AAAA,QACP,CAAC;AACD,iBAAS,EAAE;AACX,iBAAS,EAAE;AAGX,cAAM,YAAY,kBAAkB;AAAA,UAClC,UAAU,CAAC,gBAAgB,OAAO,IAAI;AAAA,QACxC,CAAC;AACD,qBAAa,aAAa;AAC1B,eAAO;AAAA,MACT,SAAS,KAAK;AAIZ,iBAAS,eAAe,QAAQ,IAAI,UAAU,uBAAuB;AACrE,cAAM;AAAA,MACR,UAAE;AACA,oBAAY,KAAK;AAAA,MACnB;AAAA,IACF;AAAA,IACA,CAAC,OAAO,OAAO,MAAM,OAAO,QAAQ,MAAM,WAAW;AAAA,EACvD;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}