@withpotter/lib 0.13.0-next.101

package/dist/use-business-locations.js

@@ -0,0 +1,71 @@
+"use client";
+import { useCallback, useMemo } from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useAuth } from "./auth-context";
+import { businessLocationsApi } from "./api";
+import { isServiceMissing } from "./api/service-missing";
+import { asList } from "@withpotter/lib/utils";
+function useBusinessLocations({ enabled = true } = {}) {
+  const { tenant } = useAuth();
+  const queryClient = useQueryClient();
+  const slug = tenant?.slug;
+  const { data, isLoading, error } = useQuery({
+    queryKey: ["business-locations", slug],
+    queryFn: () => businessLocationsApi.list(slug),
+    // `enabled` is for surfaces that mount everywhere but are rarely opened:
+    // the invite dialog lives in the sidebar footer on every route, and
+    // fetching locations on every page load to fill a picker almost nobody
+    // opens is a request the app doesn't need.
+    enabled: !!slug && enabled,
+    staleTime: 5 * 6e4
+  });
+  const locations = useMemo(() => asList(data), [data]);
+  const invalidate = useCallback(
+    () => queryClient.invalidateQueries({ queryKey: ["business-locations", slug] }),
+    [queryClient, slug]
+  );
+  const create = useMutation({
+    mutationFn: (payload) => businessLocationsApi.create(slug, payload),
+    onSuccess: invalidate
+  });
+  const update = useMutation({
+    mutationFn: ({
+      id,
+      ...payload
+    }) => businessLocationsApi.update(slug, id, payload),
+    onSuccess: invalidate
+  });
+  const archive = useMutation({
+    mutationFn: (id) => businessLocationsApi.archive(slug, id),
+    onSuccess: invalidate,
+    // Archiving rehomes staff who worked only there, so the team list is stale
+    // the moment this succeeds.
+    onSettled: () => queryClient.invalidateQueries({ queryKey: ["team-members", slug] })
+  });
+  const unavailable = isServiceMissing(error);
+  return {
+    locations,
+    loading: isLoading,
+    error: error instanceof Error && !unavailable ? error.message : null,
+    /** The backend has no locations service. Not an error; see above. */
+    unavailable,
+    /** True once a second location exists. See the note above. */
+    isMultiSite: locations.length > 1,
+    defaultLocation: locations.find((l) => l.isDefault) ?? locations[0] ?? null,
+    create,
+    update,
+    archive
+  };
+}
+function describeScope(locationIds, locations) {
+  if (!locationIds || locationIds.length === 0) return "All locations";
+  const names = locationIds.map((id) => locations.find((l) => l.id === id)?.name).filter((name) => !!name);
+  if (names.length === 0) return "All locations";
+  if (names.length <= 2) return names.join(" and ");
+  return `${names[0]}, ${names[1]} and ${names.length - 2} more`;
+}
+export {
+  describeScope,
+  useBusinessLocations
+};
+//# sourceMappingURL=use-business-locations.js.map

package/dist/use-business-locations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-business-locations.ts"],"sourcesContent":["'use client';\n\nimport { useCallback, useMemo } from 'react';\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';\nimport { useAuth } from './auth-context';\nimport { businessLocationsApi } from './api';\nimport { isServiceMissing } from './api/service-missing';\nimport { asList } from '@withpotter/lib/utils';\nimport type {\n  BusinessLocation,\n  CreateBusinessLocationData,\n  UpdateBusinessLocationData,\n} from '@withpotter/lib/api/types';\n\n/**\n * The business's physical locations, shared by the settings page and the\n * invite dialog.\n *\n * `isMultiSite` is the important one. Almost every merchant runs a single\n * place, and a \"Works at\" picker on their invite form is a field with one\n * possible answer — pure tax on the common case. Surfaces gate on this flag\n * rather than counting the array themselves, so they can't disagree about\n * when the concept is worth showing.\n */\nexport function useBusinessLocations({ enabled = true } = {}) {\n  const { tenant } = useAuth();\n  const queryClient = useQueryClient();\n  const slug = tenant?.slug;\n\n  const { data, isLoading, error } = useQuery({\n    queryKey: ['business-locations', slug],\n    queryFn: () => businessLocationsApi.list(slug!),\n    // `enabled` is for surfaces that mount everywhere but are rarely opened:\n    // the invite dialog lives in the sidebar footer on every route, and\n    // fetching locations on every page load to fill a picker almost nobody\n    // opens is a request the app doesn't need.\n    enabled: !!slug && enabled,\n    staleTime: 5 * 60_000,\n  });\n\n  // This hook mounts inside the invite dialog, which the sidebar can open on\n  // any route. A 200 carrying something other than an array would otherwise\n  // reach `.map` in the shell — the exact shape that white-screened every page\n  // when the members list did it.\n  const locations = useMemo(() => asList<BusinessLocation>(data), [data]);\n\n  const invalidate = useCallback(\n    () =>\n      queryClient.invalidateQueries({ queryKey: ['business-locations', slug] }),\n    [queryClient, slug],\n  );\n\n  const create = useMutation({\n    mutationFn: (payload: CreateBusinessLocationData) =>\n      businessLocationsApi.create(slug!, payload),\n    onSuccess: invalidate,\n  });\n\n  const update = useMutation({\n    mutationFn: ({\n      id,\n      ...payload\n    }: UpdateBusinessLocationData & { id: string }) =>\n      businessLocationsApi.update(slug!, id, payload),\n    onSuccess: invalidate,\n  });\n\n  const archive = useMutation({\n    mutationFn: (id: string) => businessLocationsApi.archive(slug!, id),\n    onSuccess: invalidate,\n    // Archiving rehomes staff who worked only there, so the team list is stale\n    // the moment this succeeds.\n    onSettled: () =>\n      queryClient.invalidateQueries({ queryKey: ['team-members', slug] }),\n  });\n\n  // A 404 on the list is not a failure to report: the backend this account\n  // runs on has no locations service, and the proxy says so as \"Invalid API\n  // path\". That is an address, not a sentence a merchant can act on, so it is\n  // carried as a flag and each page says it in its own words. Everything else\n  // (network, 5xx, a refusal) is still an error and still shown.\n  const unavailable = isServiceMissing(error);\n\n  return {\n    locations,\n    loading: isLoading,\n    error: error instanceof Error && !unavailable ? error.message : null,\n    /** The backend has no locations service. Not an error; see above. */\n    unavailable,\n    /** True once a second location exists. See the note above. */\n    isMultiSite: locations.length > 1,\n    defaultLocation: locations.find((l) => l.isDefault) ?? locations[0] ?? null,\n    create,\n    update,\n    archive,\n  };\n}\n\n/**\n * Render a member's scope as one line.\n *\n * An empty list means every location, which is the state owners and every\n * single-site member are in — so this must never render as \"none\".\n */\nexport function describeScope(\n  locationIds: string[] | undefined,\n  locations: BusinessLocation[],\n): string {\n  if (!locationIds || locationIds.length === 0) return 'All locations';\n  const names = locationIds\n    .map((id) => locations.find((l) => l.id === id)?.name)\n    .filter((name): name is string => !!name);\n  if (names.length === 0) return 'All locations';\n  if (names.length <= 2) return names.join(' and ');\n  return `${names[0]}, ${names[1]} and ${names.length - 2} more`;\n}\n"],"mappings":";AAEA,SAAS,aAAa,eAAe;AACrC,SAAS,aAAa,UAAU,sBAAsB;AACtD,SAAS,eAAe;AACxB,SAAS,4BAA4B;AACrC,SAAS,wBAAwB;AACjC,SAAS,cAAc;AAiBhB,SAAS,qBAAqB,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG;AAC5D,QAAM,EAAE,OAAO,IAAI,QAAQ;AAC3B,QAAM,cAAc,eAAe;AACnC,QAAM,OAAO,QAAQ;AAErB,QAAM,EAAE,MAAM,WAAW,MAAM,IAAI,SAAS;AAAA,IAC1C,UAAU,CAAC,sBAAsB,IAAI;AAAA,IACrC,SAAS,MAAM,qBAAqB,KAAK,IAAK;AAAA;AAAA;AAAA;AAAA;AAAA,IAK9C,SAAS,CAAC,CAAC,QAAQ;AAAA,IACnB,WAAW,IAAI;AAAA,EACjB,CAAC;AAMD,QAAM,YAAY,QAAQ,MAAM,OAAyB,IAAI,GAAG,CAAC,IAAI,CAAC;AAEtE,QAAM,aAAa;AAAA,IACjB,MACE,YAAY,kBAAkB,EAAE,UAAU,CAAC,sBAAsB,IAAI,EAAE,CAAC;AAAA,IAC1E,CAAC,aAAa,IAAI;AAAA,EACpB;AAEA,QAAM,SAAS,YAAY;AAAA,IACzB,YAAY,CAAC,YACX,qBAAqB,OAAO,MAAO,OAAO;AAAA,IAC5C,WAAW;AAAA,EACb,CAAC;AAED,QAAM,SAAS,YAAY;AAAA,IACzB,YAAY,CAAC;AAAA,MACX;AAAA,MACA,GAAG;AAAA,IACL,MACE,qBAAqB,OAAO,MAAO,IAAI,OAAO;AAAA,IAChD,WAAW;AAAA,EACb,CAAC;AAED,QAAM,UAAU,YAAY;AAAA,IAC1B,YAAY,CAAC,OAAe,qBAAqB,QAAQ,MAAO,EAAE;AAAA,IAClE,WAAW;AAAA;AAAA;AAAA,IAGX,WAAW,MACT,YAAY,kBAAkB,EAAE,UAAU,CAAC,gBAAgB,IAAI,EAAE,CAAC;AAAA,EACtE,CAAC;AAOD,QAAM,cAAc,iBAAiB,KAAK;AAE1C,SAAO;AAAA,IACL;AAAA,IACA,SAAS;AAAA,IACT,OAAO,iBAAiB,SAAS,CAAC,cAAc,MAAM,UAAU;AAAA;AAAA,IAEhE;AAAA;AAAA,IAEA,aAAa,UAAU,SAAS;AAAA,IAChC,iBAAiB,UAAU,KAAK,CAAC,MAAM,EAAE,SAAS,KAAK,UAAU,CAAC,KAAK;AAAA,IACvE;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAQO,SAAS,cACd,aACA,WACQ;AACR,MAAI,CAAC,eAAe,YAAY,WAAW,EAAG,QAAO;AACrD,QAAM,QAAQ,YACX,IAAI,CAAC,OAAO,UAAU,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EACpD,OAAO,CAAC,SAAyB,CAAC,CAAC,IAAI;AAC1C,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,MAAI,MAAM,UAAU,EAAG,QAAO,MAAM,KAAK,OAAO;AAChD,SAAO,GAAG,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,QAAQ,MAAM,SAAS,CAAC;AACzD;","names":[]}

package/dist/use-currency.d.ts

@@ -0,0 +1,12 @@
+/**
+ * What this workspace trades in.
+ *
+ * Reactive, unlike `getActiveCurrency()` — a component that reads this
+ * re-renders when the workspace changes, which the module-level value cannot
+ * make it do. Reach for it when a figure is on screen before its own data
+ * loads; everywhere else `formatCurrency(amount)` already picks it up.
+ *
+ * Not where the value is SET for the app — `AuthProvider` does that once, so a
+ * plain function with no hook available still formats correctly.
+ */
+export declare function useCurrency(): string;

package/dist/use-currency.js

@@ -0,0 +1,16 @@
+"use client";
+import { useEffect } from "react";
+import { useAuth } from "./auth-context";
+import { getActiveCurrency, setActiveCurrency } from "./utils";
+function useCurrency() {
+  const { tenant } = useAuth();
+  const currency = tenant?.settings?.currency;
+  useEffect(() => {
+    setActiveCurrency(currency);
+  }, [currency]);
+  return currency?.toUpperCase() || getActiveCurrency();
+}
+export {
+  useCurrency
+};
+//# sourceMappingURL=use-currency.js.map

package/dist/use-currency.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-currency.ts"],"sourcesContent":["'use client';\n\nimport { useEffect } from 'react';\nimport { useAuth } from './auth-context';\nimport { getActiveCurrency, setActiveCurrency } from './utils';\n\n/**\n * What this workspace trades in.\n *\n * Reactive, unlike `getActiveCurrency()` — a component that reads this\n * re-renders when the workspace changes, which the module-level value cannot\n * make it do. Reach for it when a figure is on screen before its own data\n * loads; everywhere else `formatCurrency(amount)` already picks it up.\n *\n * Not where the value is SET for the app — `AuthProvider` does that once, so a\n * plain function with no hook available still formats correctly.\n */\nexport function useCurrency(): string {\n  const { tenant } = useAuth();\n  const currency = tenant?.settings?.currency as string | undefined;\n\n  // Keeps the module value in step for callers that cannot use a hook, in case\n  // this hook runs before the provider's own effect on a given mount order.\n  useEffect(() => {\n    setActiveCurrency(currency);\n  }, [currency]);\n\n  return currency?.toUpperCase() || getActiveCurrency();\n}\n"],"mappings":";AAEA,SAAS,iBAAiB;AAC1B,SAAS,eAAe;AACxB,SAAS,mBAAmB,yBAAyB;AAa9C,SAAS,cAAsB;AACpC,QAAM,EAAE,OAAO,IAAI,QAAQ;AAC3B,QAAM,WAAW,QAAQ,UAAU;AAInC,YAAU,MAAM;AACd,sBAAkB,QAAQ;AAAA,EAC5B,GAAG,CAAC,QAAQ,CAAC;AAEb,SAAO,UAAU,YAAY,KAAK,kBAAkB;AACtD;","names":[]}

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

@@ -0,0 +1,12 @@
+/**
+ * What a list says when it has nothing in it.
+ *
+ * A composed route declares its own, because the industry copy is for the
+ * business as a whole: a restaurant that also sold tickets read "Create your
+ * first event to start selling tickets" over its own menu.
+ */
+export declare function useEmptyStateCopy(moduleId: string): import("./empty-state-copy").EmptyStateCopy | {
+    declared: boolean;
+    title: string;
+    description: string;
+};

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

@@ -0,0 +1,13 @@
+"use client";
+import { getEmptyStateCopy } from "./empty-state-copy";
+import { useScopeLabels } from "./intents/intent-scope";
+import { useIndustryKey } from "./use-industry-key";
+function useEmptyStateCopy(moduleId) {
+  const industryKey = useIndustryKey();
+  const declared = useScopeLabels()?.empty;
+  return declared ? { ...declared, declared: true } : getEmptyStateCopy(moduleId, industryKey);
+}
+export {
+  useEmptyStateCopy
+};
+//# sourceMappingURL=use-empty-state-copy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-empty-state-copy.ts"],"sourcesContent":["'use client';\n\nimport { getEmptyStateCopy } from './empty-state-copy';\nimport { useScopeLabels } from './intents/intent-scope';\nimport { useIndustryKey } from './use-industry-key';\n\n/**\n * What a list says when it has nothing in it.\n *\n * A composed route declares its own, because the industry copy is for the\n * business as a whole: a restaurant that also sold tickets read \"Create your\n * first event to start selling tickets\" over its own menu.\n */\nexport function useEmptyStateCopy(moduleId: string) {\n  const industryKey = useIndustryKey();\n  const declared = useScopeLabels()?.empty;\n  return declared\n    ? { ...declared, declared: true }\n    : getEmptyStateCopy(moduleId, industryKey);\n}\n"],"mappings":";AAEA,SAAS,yBAAyB;AAClC,SAAS,sBAAsB;AAC/B,SAAS,sBAAsB;AASxB,SAAS,kBAAkB,UAAkB;AAClD,QAAM,cAAc,eAAe;AACnC,QAAM,WAAW,eAAe,GAAG;AACnC,SAAO,WACH,EAAE,GAAG,UAAU,UAAU,KAAK,IAC9B,kBAAkB,UAAU,WAAW;AAC7C;","names":[]}

package/dist/use-geo-cities.d.ts

@@ -0,0 +1 @@
+export declare function useGeoCities(country: string, states: string[]): string[];

package/dist/use-geo-cities.js

@@ -0,0 +1,42 @@
+"use client";
+import { useEffect, useState } from "react";
+import { apiFetch } from "@withpotter/lib/api/core";
+import { useAuth } from "@withpotter/lib/auth-context";
+import { countryCodeOf } from "./country-regions";
+const NONE = [];
+function useGeoCities(country, states) {
+  const { tenant } = useAuth();
+  const [cities, setCities] = useState([]);
+  const wanted = states.join("|");
+  const code = countryCodeOf(country);
+  const slug = tenant?.slug;
+  const asks = Boolean(slug && code && wanted);
+  useEffect(() => {
+    if (!slug || !code || !wanted) return;
+    const names = wanted.split("|");
+    let current = true;
+    void Promise.allSettled(
+      names.map(
+        (state) => apiFetch(
+          `/geo/cities?country=${encodeURIComponent(code)}&state=${encodeURIComponent(state)}`,
+          { tenantSlug: slug }
+        )
+      )
+    ).then((answers) => {
+      if (!current) return;
+      setCities(
+        answers.flatMap(
+          (answer) => answer.status === "fulfilled" && Array.isArray(answer.value) ? answer.value : []
+        )
+      );
+    });
+    return () => {
+      current = false;
+    };
+  }, [code, wanted, slug]);
+  return asks ? cities : NONE;
+}
+export {
+  useGeoCities
+};
+//# sourceMappingURL=use-geo-cities.js.map

package/dist/use-geo-cities.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-geo-cities.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useState } from 'react';\nimport { apiFetch } from '@withpotter/lib/api/core';\nimport { useAuth } from '@withpotter/lib/auth-context';\nimport { countryCodeOf } from './country-regions';\n\n/**\n * The standard cities of the states a zone names, from the Box's geo data (`/geo/cities`), for a country the\n * data covers. The business's own locations only ever add to these. A state the data does not know, or a\n * country it does not cover, gives none, and a failed call never stops the form: the business's own cities\n * still show.\n */\nconst NONE: string[] = [];\n\nexport function useGeoCities(country: string, states: string[]): string[] {\n  const { tenant } = useAuth();\n  const [cities, setCities] = useState<string[]>([]);\n  // The states are read by their text, so a new array with the same states does not ask again.\n  const wanted = states.join('|');\n\n  const code = countryCodeOf(country);\n  const slug = tenant?.slug;\n  const asks = Boolean(slug && code && wanted);\n\n  useEffect(() => {\n    if (!slug || !code || !wanted) return;\n\n    const names = wanted.split('|');\n\n    let current = true;\n\n    void Promise.allSettled(\n      names.map((state) =>\n        apiFetch<string[]>(\n          `/geo/cities?country=${encodeURIComponent(code)}&state=${encodeURIComponent(state)}`,\n          { tenantSlug: slug },\n        ),\n      ),\n    ).then((answers) => {\n      if (!current) return;\n\n      setCities(\n        answers.flatMap((answer) =>\n          answer.status === 'fulfilled' && Array.isArray(answer.value)\n            ? answer.value\n            : [],\n        ),\n      );\n    });\n\n    return () => {\n      current = false;\n    };\n  }, [code, wanted, slug]);\n\n  // Nothing is asked for a country the data does not cover, or before a state is chosen.\n  return asks ? cities : NONE;\n}\n"],"mappings":";AAEA,SAAS,WAAW,gBAAgB;AACpC,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAQ9B,MAAM,OAAiB,CAAC;AAEjB,SAAS,aAAa,SAAiB,QAA4B;AACxE,QAAM,EAAE,OAAO,IAAI,QAAQ;AAC3B,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAmB,CAAC,CAAC;AAEjD,QAAM,SAAS,OAAO,KAAK,GAAG;AAE9B,QAAM,OAAO,cAAc,OAAO;AAClC,QAAM,OAAO,QAAQ;AACrB,QAAM,OAAO,QAAQ,QAAQ,QAAQ,MAAM;AAE3C,YAAU,MAAM;AACd,QAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAQ;AAE/B,UAAM,QAAQ,OAAO,MAAM,GAAG;AAE9B,QAAI,UAAU;AAEd,SAAK,QAAQ;AAAA,MACX,MAAM;AAAA,QAAI,CAAC,UACT;AAAA,UACE,uBAAuB,mBAAmB,IAAI,CAAC,UAAU,mBAAmB,KAAK,CAAC;AAAA,UAClF,EAAE,YAAY,KAAK;AAAA,QACrB;AAAA,MACF;AAAA,IACF,EAAE,KAAK,CAAC,YAAY;AAClB,UAAI,CAAC,QAAS;AAEd;AAAA,QACE,QAAQ;AAAA,UAAQ,CAAC,WACf,OAAO,WAAW,eAAe,MAAM,QAAQ,OAAO,KAAK,IACvD,OAAO,QACP,CAAC;AAAA,QACP;AAAA,MACF;AAAA,IACF,CAAC;AAED,WAAO,MAAM;AACX,gBAAU;AAAA,IACZ;AAAA,EACF,GAAG,CAAC,MAAM,QAAQ,IAAI,CAAC;AAGvB,SAAO,OAAO,SAAS;AACzB;","names":[]}

package/dist/use-has-hardware.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Does this business own any machines?
+ *
+ * Its own hook rather than another field on `useDashboardData`, which is a
+ * 562-line god-hook on a shrinking ledger — a feature that adds a line to it
+ * every time one ships is the reason it got that big. This belongs with
+ * hardware.
+ *
+ * Shares `useApiQuery`'s cache key with the Hardware screen and the orders
+ * filter panel, so a merchant who visits both pays for one request rather than
+ * three.
+ */
+export declare function useHasHardware(): boolean;

package/dist/use-has-hardware.js

@@ -0,0 +1,14 @@
+"use client";
+import { useApiQuery } from "@withpotter/hooks/use-api-query";
+import { businessDevicesApi } from "@withpotter/lib/api/business-devices";
+function useHasHardware() {
+  const { data } = useApiQuery(
+    ["business-devices"],
+    (slug) => businessDevicesApi.list(slug)
+  );
+  return (data?.devices?.length ?? 0) > 0;
+}
+export {
+  useHasHardware
+};
+//# sourceMappingURL=use-has-hardware.js.map

package/dist/use-has-hardware.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-has-hardware.ts"],"sourcesContent":["'use client';\n\nimport { useApiQuery } from '@withpotter/hooks/use-api-query';\nimport { businessDevicesApi } from '@withpotter/lib/api/business-devices';\nimport type { BusinessDevice } from '@withpotter/lib/api/types';\n\n/**\n * Does this business own any machines?\n *\n * Its own hook rather than another field on `useDashboardData`, which is a\n * 562-line god-hook on a shrinking ledger — a feature that adds a line to it\n * every time one ships is the reason it got that big. This belongs with\n * hardware.\n *\n * Shares `useApiQuery`'s cache key with the Hardware screen and the orders\n * filter panel, so a merchant who visits both pays for one request rather than\n * three.\n */\nexport function useHasHardware(): boolean {\n  const { data } = useApiQuery<{ devices: BusinessDevice[] }>(\n    ['business-devices'],\n    (slug) => businessDevicesApi.list(slug),\n  );\n  return (data?.devices?.length ?? 0) > 0;\n}\n"],"mappings":";AAEA,SAAS,mBAAmB;AAC5B,SAAS,0BAA0B;AAe5B,SAAS,iBAA0B;AACxC,QAAM,EAAE,KAAK,IAAI;AAAA,IACf,CAAC,kBAAkB;AAAA,IACnB,CAAC,SAAS,mBAAmB,KAAK,IAAI;AAAA,EACxC;AACA,UAAQ,MAAM,SAAS,UAAU,KAAK;AACxC;","names":[]}

package/dist/use-industry-key.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Returns the resolved industry key for the current tenant.
+ *
+ * Resolution order:
+ *   1. tenant.industryKey (first-class column) — unless it's a stale default
+ *   2. Intent-based inference (selectedIntents → industry key)
+ *   3. tenant.settings.industryProfile (legacy JSONB field)
+ *   4. null (no industry context — all UI falls back to generic copy)
+ */
+export declare function useIndustryKey(): string | null;

package/dist/use-industry-key.js

@@ -0,0 +1,16 @@
+import { useAuth } from "./auth-context";
+function useIndustryKey() {
+  const { tenant } = useAuth();
+  if (!tenant) return null;
+  const settings = tenant.settings;
+  if (tenant.industryKey && tenant.industryKey !== "hospitality") {
+    return tenant.industryKey;
+  }
+  const intents = settings?.selectedIntents;
+  if (intents?.includes("event-tickets")) return "events";
+  return tenant.industryKey ?? settings?.industryProfile ?? null;
+}
+export {
+  useIndustryKey
+};
+//# sourceMappingURL=use-industry-key.js.map

package/dist/use-industry-key.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-industry-key.ts"],"sourcesContent":["import { useAuth } from './auth-context';\n\n/**\n * Returns the resolved industry key for the current tenant.\n *\n * Resolution order:\n *   1. tenant.industryKey (first-class column) — unless it's a stale default\n *   2. Intent-based inference (selectedIntents → industry key)\n *   3. tenant.settings.industryProfile (legacy JSONB field)\n *   4. null (no industry context — all UI falls back to generic copy)\n */\nexport function useIndustryKey(): string | null {\n  const { tenant } = useAuth();\n  if (!tenant) return null;\n\n  const settings = tenant.settings as Record<string, unknown> | undefined;\n\n  // If tenant has an explicit, non-default industryKey, trust it\n  if (tenant.industryKey && tenant.industryKey !== 'hospitality') {\n    return tenant.industryKey;\n  }\n\n  // Resolve from selected intents — overrides stale industryKey for tenants\n  // provisioned before dedicated industry configs existed\n  const intents = settings?.selectedIntents as string[] | undefined;\n  if (intents?.includes('event-tickets')) return 'events';\n\n  // Fall through to whatever was persisted\n  return (\n    tenant.industryKey ??\n    (settings?.industryProfile as string | undefined) ??\n    null\n  );\n}\n"],"mappings":"AAAA,SAAS,eAAe;AAWjB,SAAS,iBAAgC;AAC9C,QAAM,EAAE,OAAO,IAAI,QAAQ;AAC3B,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,WAAW,OAAO;AAGxB,MAAI,OAAO,eAAe,OAAO,gBAAgB,eAAe;AAC9D,WAAO,OAAO;AAAA,EAChB;AAIA,QAAM,UAAU,UAAU;AAC1B,MAAI,SAAS,SAAS,eAAe,EAAG,QAAO;AAG/C,SACE,OAAO,eACN,UAAU,mBACX;AAEJ;","names":[]}

package/dist/use-item-links.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Where the item screens send the merchant.
+ *
+ * A screen mounted by an intent's route sends them to that intent's own list
+ * and create screens. Anywhere else it is the shared catalogue, as it always
+ * was. A record opens at its list's address plus its id (`detail`), which the
+ * intent's rewrite serves with the one real page; links that do not know the
+ * intent keep using the shared `/dashboard/catalog/<id>`, which still works.
+ */
+export declare function useItemLinks(legacyIntent?: string): {
+    list: string;
+    create: string;
+    orders: string;
+    bookings: string;
+    invoices: string;
+    resources: string;
+    detail: (id: string) => string;
+    orderDetail: (id: string) => string;
+    bookingDetail: (id: string) => string;
+};

package/dist/use-item-links.js

@@ -0,0 +1,30 @@
+"use client";
+import { useMemo } from "react";
+import { useScopeLabels } from "./intents/intent-scope";
+function useItemLinks(legacyIntent) {
+  const links = useScopeLabels()?.links;
+  const list = links?.list ?? "/dashboard/catalog";
+  const create = links?.create ?? "/dashboard/catalog/new";
+  const orders = links?.orders ?? (legacyIntent ? `/dashboard/orders?intent=${legacyIntent}` : "/dashboard/orders");
+  const bookings = links?.bookings ?? "/dashboard/bookings";
+  const invoices = links?.invoices ?? "/dashboard/invoices";
+  const resources = links?.resources ?? "/dashboard/resources";
+  return useMemo(
+    () => ({
+      list,
+      create,
+      orders,
+      bookings,
+      invoices,
+      resources,
+      detail: (id) => `${list}/${id}`,
+      orderDetail: (id) => `${orders}/${id}`,
+      bookingDetail: (id) => `${bookings}/${id}`
+    }),
+    [list, create, orders, bookings, invoices, resources]
+  );
+}
+export {
+  useItemLinks
+};
+//# sourceMappingURL=use-item-links.js.map

package/dist/use-item-links.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-item-links.ts"],"sourcesContent":["'use client';\n\nimport { useMemo } from 'react';\nimport { useScopeLabels } from './intents/intent-scope';\n\n/**\n * Where the item screens send the merchant.\n *\n * A screen mounted by an intent's route sends them to that intent's own list\n * and create screens. Anywhere else it is the shared catalogue, as it always\n * was. A record opens at its list's address plus its id (`detail`), which the\n * intent's rewrite serves with the one real page; links that do not know the\n * intent keep using the shared `/dashboard/catalog/<id>`, which still works.\n */\nexport function useItemLinks(legacyIntent?: string) {\n  const links = useScopeLabels()?.links;\n  const list = links?.list ?? '/dashboard/catalog';\n  const create = links?.create ?? '/dashboard/catalog/new';\n  const orders =\n    links?.orders ??\n    (legacyIntent\n      ? `/dashboard/orders?intent=${legacyIntent}`\n      : '/dashboard/orders');\n  const bookings = links?.bookings ?? '/dashboard/bookings';\n  const invoices = links?.invoices ?? '/dashboard/invoices';\n  const resources = links?.resources ?? '/dashboard/resources';\n  return useMemo(\n    () => ({\n      list,\n      create,\n      orders,\n      bookings,\n      invoices,\n      resources,\n      detail: (id: string) => `${list}/${id}`,\n      orderDetail: (id: string) => `${orders}/${id}`,\n      bookingDetail: (id: string) => `${bookings}/${id}`,\n    }),\n    [list, create, orders, bookings, invoices, resources],\n  );\n}\n"],"mappings":";AAEA,SAAS,eAAe;AACxB,SAAS,sBAAsB;AAWxB,SAAS,aAAa,cAAuB;AAClD,QAAM,QAAQ,eAAe,GAAG;AAChC,QAAM,OAAO,OAAO,QAAQ;AAC5B,QAAM,SAAS,OAAO,UAAU;AAChC,QAAM,SACJ,OAAO,WACN,eACG,4BAA4B,YAAY,KACxC;AACN,QAAM,WAAW,OAAO,YAAY;AACpC,QAAM,WAAW,OAAO,YAAY;AACpC,QAAM,YAAY,OAAO,aAAa;AACtC,SAAO;AAAA,IACL,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ,CAAC,OAAe,GAAG,IAAI,IAAI,EAAE;AAAA,MACrC,aAAa,CAAC,OAAe,GAAG,MAAM,IAAI,EAAE;AAAA,MAC5C,eAAe,CAAC,OAAe,GAAG,QAAQ,IAAI,EAAE;AAAA,IAClD;AAAA,IACA,CAAC,MAAM,QAAQ,QAAQ,UAAU,UAAU,SAAS;AAAA,EACtD;AACF;","names":[]}

package/dist/use-job-roles.d.ts

@@ -0,0 +1,21 @@
+import { type JobRole } from './team-roles';
+import { type TeamRoleResponse } from './api';
+/**
+ * Offers the job-shaped roles that make sense for THIS business, and turns the
+ * one that gets picked into a real `team_roles` row the api can be invited
+ * against.
+ *
+ * Presets are a UI layer over the api's existing roles table, not a parallel
+ * store: picking "Front desk" either matches a role the workspace already has
+ * or creates it once, and from then on it's an ordinary editable role. That
+ * keeps the roles manager and the permission catalog the source of truth for
+ * anyone who outgrows the presets.
+ */
+export declare function useJobRoles(workspaceRoles: TeamRoleResponse[]): {
+    roles: JobRole[];
+    areas: import("./team-roles").PermissionArea[];
+    behaviors: import("./template-types").ContentBehavior[];
+    resolveRoleId: (role: JobRole) => Promise<string>;
+    grantMoney: (memberId: string) => Promise<void>;
+    createCustomRole: (name: string, permissions: Record<string, boolean>) => Promise<string>;
+};

package/dist/use-job-roles.js

@@ -0,0 +1,76 @@
+"use client";
+import { useCallback, useMemo } from "react";
+import { useAuth } from "./auth-context";
+import { useCurrentTemplate } from "./template-context";
+import { resolveEnabledBehaviors } from "./resolve-enabled-behaviors";
+import {
+  builtInRoleKey,
+  permissionsForRole,
+  resolveAreas,
+  resolveJobRoles
+} from "./team-roles";
+import { teamApi } from "./api";
+function useJobRoles(workspaceRoles) {
+  const { tenant } = useAuth();
+  const slug = tenant?.slug;
+  const { template } = useCurrentTemplate(tenant?.templateId);
+  const tenantSettings = tenant?.settings;
+  const behaviors = useMemo(
+    () => resolveEnabledBehaviors(tenantSettings, template),
+    [tenantSettings, template]
+  );
+  const roles = useMemo(() => resolveJobRoles(behaviors), [behaviors]);
+  const resolveRoleId = useCallback(
+    async (role) => {
+      if (!slug) throw new Error("No business selected");
+      const permissions = permissionsForRole(role);
+      const existing = workspaceRoles.find(
+        (r) => r.systemKey !== "owner" && r.name.trim().toLowerCase() === role.name.toLowerCase()
+      );
+      if (existing) return existing.id;
+      const builtIn = builtInRoleKey(role.name);
+      if (builtIn) return builtIn;
+      const created = await teamApi.createRole(slug, {
+        name: role.name,
+        description: role.description,
+        permissions
+      });
+      return created.id;
+    },
+    [slug, workspaceRoles]
+  );
+  const grantMoney = useCallback(
+    async (memberId) => {
+      if (!slug) return;
+      await teamApi.updateMemberPermissions(slug, memberId, {
+        canViewFinance: true,
+        canManageFinance: true
+      });
+    },
+    [slug]
+  );
+  const createCustomRole = useCallback(
+    async (name, permissions) => {
+      if (!slug) throw new Error("No business selected");
+      const created = await teamApi.createRole(slug, {
+        name,
+        permissions
+      });
+      return created.id;
+    },
+    [slug]
+  );
+  const areas = useMemo(() => resolveAreas(behaviors), [behaviors]);
+  return {
+    roles,
+    areas,
+    behaviors,
+    resolveRoleId,
+    grantMoney,
+    createCustomRole
+  };
+}
+export {
+  useJobRoles
+};
+//# sourceMappingURL=use-job-roles.js.map

package/dist/use-job-roles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-job-roles.ts"],"sourcesContent":["'use client';\n\nimport { useCallback, useMemo } from 'react';\nimport { useAuth } from './auth-context';\nimport { useCurrentTemplate } from './template-context';\nimport { resolveEnabledBehaviors } from './resolve-enabled-behaviors';\nimport {\n  builtInRoleKey,\n  permissionsForRole,\n  resolveAreas,\n  resolveJobRoles,\n  type JobRole,\n} from './team-roles';\nimport { teamApi, type TeamRoleResponse } from './api';\n\n/**\n * Offers the job-shaped roles that make sense for THIS business, and turns the\n * one that gets picked into a real `team_roles` row the api can be invited\n * against.\n *\n * Presets are a UI layer over the api's existing roles table, not a parallel\n * store: picking \"Front desk\" either matches a role the workspace already has\n * or creates it once, and from then on it's an ordinary editable role. That\n * keeps the roles manager and the permission catalog the source of truth for\n * anyone who outgrows the presets.\n */\nexport function useJobRoles(workspaceRoles: TeamRoleResponse[]) {\n  const { tenant } = useAuth();\n  // Hoisted: an optional-chained dep (`tenant?.slug`) is an expression the\n  // React Compiler can't preserve memoization across.\n  const slug = tenant?.slug;\n  const { template } = useCurrentTemplate(tenant?.templateId);\n\n  const tenantSettings = tenant?.settings as\n    | Record<string, unknown>\n    | undefined;\n\n  const behaviors = useMemo(\n    () => resolveEnabledBehaviors(tenantSettings, template),\n    [tenantSettings, template],\n  );\n\n  const roles = useMemo(() => resolveJobRoles(behaviors), [behaviors]);\n\n  /**\n   * Find-or-create the api role for a preset and return its id. A preset named\n   * like a built-in role (Staff) returns that built-in's key, not a row id.\n   *\n   * Matched by name because that's what the merchant sees and edits; a role\n   * they've since renamed should not silently spawn a duplicate on the next\n   * invite. Owner is never a candidate — it isn't assignable.\n   *\n   * The row is always written money-free. A role is shared by everyone holding\n   * it, so baking one person's money grant into it would hand payouts to the\n   * next person given the same job. Money is applied per-member instead\n   * (`grantMoney` below).\n   */\n  const resolveRoleId = useCallback(\n    async (role: JobRole) => {\n      if (!slug) throw new Error('No business selected');\n      const permissions = permissionsForRole(role);\n\n      const existing = workspaceRoles.find(\n        (r) =>\n          r.systemKey !== 'owner' &&\n          r.name.trim().toLowerCase() === role.name.toLowerCase(),\n      );\n      if (existing) return existing.id;\n\n      // The api already has this job as a built-in role and refuses a custom\n      // role under its name. Invite against the built-in one by name.\n      const builtIn = builtInRoleKey(role.name);\n      if (builtIn) return builtIn;\n\n      const created = await teamApi.createRole(slug, {\n        name: role.name,\n        description: role.description,\n        permissions,\n      });\n      return created.id;\n    },\n    [slug, workspaceRoles],\n  );\n\n  /** Layer the money grant onto one member, on top of whatever role they hold. */\n  const grantMoney = useCallback(\n    async (memberId: string) => {\n      if (!slug) return;\n      await teamApi.updateMemberPermissions(slug, memberId, {\n        canViewFinance: true,\n        canManageFinance: true,\n      });\n    },\n    [slug],\n  );\n\n  /**\n   * Create a role the owner defined themselves. Custom roles are ordinary\n   * `team_roles` rows (isSystem false), so they show up in the roles manager\n   * and can be edited or reused for the next person like any preset.\n   */\n  const createCustomRole = useCallback(\n    async (name: string, permissions: Record<string, boolean>) => {\n      if (!slug) throw new Error('No business selected');\n      const created = await teamApi.createRole(slug, {\n        name,\n        permissions,\n      });\n      return created.id;\n    },\n    [slug],\n  );\n\n  /** Areas worth offering for this business, for the access matrix. */\n  const areas = useMemo(() => resolveAreas(behaviors), [behaviors]);\n\n  return {\n    roles,\n    areas,\n    behaviors,\n    resolveRoleId,\n    grantMoney,\n    createCustomRole,\n  };\n}\n"],"mappings":";AAEA,SAAS,aAAa,eAAe;AACrC,SAAS,eAAe;AACxB,SAAS,0BAA0B;AACnC,SAAS,+BAA+B;AACxC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,eAAsC;AAaxC,SAAS,YAAY,gBAAoC;AAC9D,QAAM,EAAE,OAAO,IAAI,QAAQ;AAG3B,QAAM,OAAO,QAAQ;AACrB,QAAM,EAAE,SAAS,IAAI,mBAAmB,QAAQ,UAAU;AAE1D,QAAM,iBAAiB,QAAQ;AAI/B,QAAM,YAAY;AAAA,IAChB,MAAM,wBAAwB,gBAAgB,QAAQ;AAAA,IACtD,CAAC,gBAAgB,QAAQ;AAAA,EAC3B;AAEA,QAAM,QAAQ,QAAQ,MAAM,gBAAgB,SAAS,GAAG,CAAC,SAAS,CAAC;AAenE,QAAM,gBAAgB;AAAA,IACpB,OAAO,SAAkB;AACvB,UAAI,CAAC,KAAM,OAAM,IAAI,MAAM,sBAAsB;AACjD,YAAM,cAAc,mBAAmB,IAAI;AAE3C,YAAM,WAAW,eAAe;AAAA,QAC9B,CAAC,MACC,EAAE,cAAc,WAChB,EAAE,KAAK,KAAK,EAAE,YAAY,MAAM,KAAK,KAAK,YAAY;AAAA,MAC1D;AACA,UAAI,SAAU,QAAO,SAAS;AAI9B,YAAM,UAAU,eAAe,KAAK,IAAI;AACxC,UAAI,QAAS,QAAO;AAEpB,YAAM,UAAU,MAAM,QAAQ,WAAW,MAAM;AAAA,QAC7C,MAAM,KAAK;AAAA,QACX,aAAa,KAAK;AAAA,QAClB;AAAA,MACF,CAAC;AACD,aAAO,QAAQ;AAAA,IACjB;AAAA,IACA,CAAC,MAAM,cAAc;AAAA,EACvB;AAGA,QAAM,aAAa;AAAA,IACjB,OAAO,aAAqB;AAC1B,UAAI,CAAC,KAAM;AACX,YAAM,QAAQ,wBAAwB,MAAM,UAAU;AAAA,QACpD,gBAAgB;AAAA,QAChB,kBAAkB;AAAA,MACpB,CAAC;AAAA,IACH;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AAOA,QAAM,mBAAmB;AAAA,IACvB,OAAO,MAAc,gBAAyC;AAC5D,UAAI,CAAC,KAAM,OAAM,IAAI,MAAM,sBAAsB;AACjD,YAAM,UAAU,MAAM,QAAQ,WAAW,MAAM;AAAA,QAC7C;AAAA,QACA;AAAA,MACF,CAAC;AACD,aAAO,QAAQ;AAAA,IACjB;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AAGA,QAAM,QAAQ,QAAQ,MAAM,aAAa,SAAS,GAAG,CAAC,SAAS,CAAC;AAEhE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/use-merchant-plan.d.ts

@@ -0,0 +1,36 @@
+import { type ReactNode } from 'react';
+import type { DisplaySettings } from './pricing-plans-types';
+/**
+ * The merchant's plan, the public plans and the admin's display switches,
+ * shared by every place that shows them (Plan page, locked card, Home card,
+ * menu link, onboarding). An engine without plans answers 404 and every one
+ * of those places stays hidden: nothing here ever blocks the dashboard.
+ */
+export declare const MERCHANT_PLANS_KEY: string[];
+export declare const MY_PLAN_KEY: string[];
+export declare function useMerchantPlans(): import("@tanstack/react-query").UseQueryResult<NoInfer<import("./pricing-plans-types").MerchantPlans>, Error>;
+export declare function useMyPlan(): import("@tanstack/react-query").UseQueryResult<NoInfer<import("./subscription-billing-api").MerchantSubscription>, Error>;
+/** The display switches; null until known, so nothing flashes on. */
+export declare function usePlanDisplay(): DisplaySettings | null;
+/**
+ * The currency to price plans in: the wallet's (with its exponent) when
+ * billing knows it, else the business's own setting, else none (every
+ * currency is shown).
+ */
+export declare function usePlanCurrency(): {
+    currency: string | null;
+    exponent: number | null;
+};
+/**
+ * A feature the API refused on this page with 402 `feature_not_in_plan`.
+ * Cleared when the merchant moves to another page.
+ */
+export declare function useApiLockedFeature(pathname: string): string | null;
+/**
+ * With the locked-feature card switched off, a page the plan leaves out is
+ * dropped from the menu instead: the box's capability set is narrowed to the
+ * plan, which the menu and the page guard already read.
+ */
+export declare function PlanCapabilityProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/use-merchant-plan.js

@@ -0,0 +1,78 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { useQuery } from "@tanstack/react-query";
+import { FEATURE_LOCKED_EVENT } from "./api/feature-locked";
+import { useAuth } from "./auth-context";
+import { CapabilityProvider, useCapabilities } from "./capability-context";
+import { planCapabilityKeys } from "./plan-access";
+import { subscriptionBillingApi } from "./subscription-billing-api";
+const MERCHANT_PLANS_KEY = ["pricing", "plans"];
+const MY_PLAN_KEY = ["pricing", "subscription"];
+const STALE = 5 * 6e4;
+function useMerchantPlans() {
+  const { tenant } = useAuth();
+  return useQuery({
+    queryKey: MERCHANT_PLANS_KEY,
+    queryFn: subscriptionBillingApi.plans,
+    enabled: Boolean(tenant),
+    staleTime: STALE,
+    retry: false
+  });
+}
+function useMyPlan() {
+  const { tenant } = useAuth();
+  return useQuery({
+    queryKey: MY_PLAN_KEY,
+    queryFn: subscriptionBillingApi.mine,
+    enabled: Boolean(tenant),
+    staleTime: STALE,
+    retry: false
+  });
+}
+function usePlanDisplay() {
+  return useMerchantPlans().data?.display ?? null;
+}
+function usePlanCurrency() {
+  const { tenant } = useAuth();
+  const billing = useMyPlan().data?.billing;
+  if (billing?.enabled && billing.plan) {
+    return { currency: billing.plan.currency, exponent: billing.plan.exponent };
+  }
+  const setting = tenant?.settings?.currency;
+  return {
+    currency: typeof setting === "string" && setting.trim() ? setting.trim().toUpperCase() : null,
+    exponent: null
+  };
+}
+function useApiLockedFeature(pathname) {
+  const [locked, setLocked] = useState(null);
+  useEffect(() => {
+    const onLocked = (event) => {
+      const feature = event.detail?.feature;
+      if (feature) setLocked({ path: pathname, feature });
+    };
+    window.addEventListener(FEATURE_LOCKED_EVENT, onLocked);
+    return () => window.removeEventListener(FEATURE_LOCKED_EVENT, onLocked);
+  }, [pathname]);
+  return locked?.path === pathname ? locked.feature : null;
+}
+function PlanCapabilityProvider({ children }) {
+  const box = useCapabilities();
+  const display = usePlanDisplay();
+  const features = useMyPlan().data?.features;
+  const keys = display && !display.lockedFeature ? planCapabilityKeys(features, box) : null;
+  const value = keys ?? (box.known ? box.keys : null);
+  return /* @__PURE__ */ jsx(CapabilityProvider, { value, children });
+}
+export {
+  MERCHANT_PLANS_KEY,
+  MY_PLAN_KEY,
+  PlanCapabilityProvider,
+  useApiLockedFeature,
+  useMerchantPlans,
+  useMyPlan,
+  usePlanCurrency,
+  usePlanDisplay
+};
+//# sourceMappingURL=use-merchant-plan.js.map

package/dist/use-merchant-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-merchant-plan.tsx"],"sourcesContent":["'use client';\n\nimport { useEffect, useState, type ReactNode } from 'react';\nimport { useQuery } from '@tanstack/react-query';\nimport { FEATURE_LOCKED_EVENT } from './api/feature-locked';\nimport { useAuth } from './auth-context';\nimport { CapabilityProvider, useCapabilities } from './capability-context';\nimport { planCapabilityKeys } from './plan-access';\nimport type { DisplaySettings } from './pricing-plans-types';\nimport { subscriptionBillingApi } from './subscription-billing-api';\n\n/**\n * The merchant's plan, the public plans and the admin's display switches,\n * shared by every place that shows them (Plan page, locked card, Home card,\n * menu link, onboarding). An engine without plans answers 404 and every one\n * of those places stays hidden: nothing here ever blocks the dashboard.\n */\nexport const MERCHANT_PLANS_KEY = ['pricing', 'plans'];\nexport const MY_PLAN_KEY = ['pricing', 'subscription'];\n\nconst STALE = 5 * 60_000;\n\nexport function useMerchantPlans() {\n  const { tenant } = useAuth();\n\n  return useQuery({\n    queryKey: MERCHANT_PLANS_KEY,\n    queryFn: subscriptionBillingApi.plans,\n    enabled: Boolean(tenant),\n    staleTime: STALE,\n    retry: false,\n  });\n}\n\nexport function useMyPlan() {\n  const { tenant } = useAuth();\n\n  return useQuery({\n    queryKey: MY_PLAN_KEY,\n    queryFn: subscriptionBillingApi.mine,\n    enabled: Boolean(tenant),\n    staleTime: STALE,\n    retry: false,\n  });\n}\n\n/** The display switches; null until known, so nothing flashes on. */\nexport function usePlanDisplay(): DisplaySettings | null {\n  return useMerchantPlans().data?.display ?? null;\n}\n\n/**\n * The currency to price plans in: the wallet's (with its exponent) when\n * billing knows it, else the business's own setting, else none (every\n * currency is shown).\n */\nexport function usePlanCurrency(): { currency: string | null; exponent: number | null } {\n  const { tenant } = useAuth();\n  const billing = useMyPlan().data?.billing;\n\n  if (billing?.enabled && billing.plan) {\n    return { currency: billing.plan.currency, exponent: billing.plan.exponent };\n  }\n\n  const setting = (tenant?.settings as Record<string, unknown> | undefined)?.currency;\n\n  return {\n    currency: typeof setting === 'string' && setting.trim() ? setting.trim().toUpperCase() : null,\n    exponent: null,\n  };\n}\n\n/**\n * A feature the API refused on this page with 402 `feature_not_in_plan`.\n * Cleared when the merchant moves to another page.\n */\nexport function useApiLockedFeature(pathname: string): string | null {\n  const [locked, setLocked] = useState<{ path: string; feature: string } | null>(null);\n\n  useEffect(() => {\n    const onLocked = (event: Event) => {\n      const feature = (event as CustomEvent<{ feature?: string }>).detail?.feature;\n\n      if (feature) setLocked({ path: pathname, feature });\n    };\n\n    window.addEventListener(FEATURE_LOCKED_EVENT, onLocked);\n\n    return () => window.removeEventListener(FEATURE_LOCKED_EVENT, onLocked);\n  }, [pathname]);\n\n  return locked?.path === pathname ? locked.feature : null;\n}\n\n/**\n * With the locked-feature card switched off, a page the plan leaves out is\n * dropped from the menu instead: the box's capability set is narrowed to the\n * plan, which the menu and the page guard already read.\n */\nexport function PlanCapabilityProvider({ children }: { children: ReactNode }) {\n  const box = useCapabilities();\n  const display = usePlanDisplay();\n  const features = useMyPlan().data?.features;\n  const keys = display && !display.lockedFeature ? planCapabilityKeys(features, box) : null;\n\n  // Always mounted, so the dashboard is not rebuilt when the plan arrives.\n  const value = keys ?? (box.known ? box.keys : null);\n\n  return <CapabilityProvider value={value}>{children}</CapabilityProvider>;\n}\n"],"mappings":";AA4GS;AA1GT,SAAS,WAAW,gBAAgC;AACpD,SAAS,gBAAgB;AACzB,SAAS,4BAA4B;AACrC,SAAS,eAAe;AACxB,SAAS,oBAAoB,uBAAuB;AACpD,SAAS,0BAA0B;AAEnC,SAAS,8BAA8B;AAQhC,MAAM,qBAAqB,CAAC,WAAW,OAAO;AAC9C,MAAM,cAAc,CAAC,WAAW,cAAc;AAErD,MAAM,QAAQ,IAAI;AAEX,SAAS,mBAAmB;AACjC,QAAM,EAAE,OAAO,IAAI,QAAQ;AAE3B,SAAO,SAAS;AAAA,IACd,UAAU;AAAA,IACV,SAAS,uBAAuB;AAAA,IAChC,SAAS,QAAQ,MAAM;AAAA,IACvB,WAAW;AAAA,IACX,OAAO;AAAA,EACT,CAAC;AACH;AAEO,SAAS,YAAY;AAC1B,QAAM,EAAE,OAAO,IAAI,QAAQ;AAE3B,SAAO,SAAS;AAAA,IACd,UAAU;AAAA,IACV,SAAS,uBAAuB;AAAA,IAChC,SAAS,QAAQ,MAAM;AAAA,IACvB,WAAW;AAAA,IACX,OAAO;AAAA,EACT,CAAC;AACH;AAGO,SAAS,iBAAyC;AACvD,SAAO,iBAAiB,EAAE,MAAM,WAAW;AAC7C;AAOO,SAAS,kBAAwE;AACtF,QAAM,EAAE,OAAO,IAAI,QAAQ;AAC3B,QAAM,UAAU,UAAU,EAAE,MAAM;AAElC,MAAI,SAAS,WAAW,QAAQ,MAAM;AACpC,WAAO,EAAE,UAAU,QAAQ,KAAK,UAAU,UAAU,QAAQ,KAAK,SAAS;AAAA,EAC5E;AAEA,QAAM,UAAW,QAAQ,UAAkD;AAE3E,SAAO;AAAA,IACL,UAAU,OAAO,YAAY,YAAY,QAAQ,KAAK,IAAI,QAAQ,KAAK,EAAE,YAAY,IAAI;AAAA,IACzF,UAAU;AAAA,EACZ;AACF;AAMO,SAAS,oBAAoB,UAAiC;AACnE,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAmD,IAAI;AAEnF,YAAU,MAAM;AACd,UAAM,WAAW,CAAC,UAAiB;AACjC,YAAM,UAAW,MAA4C,QAAQ;AAErE,UAAI,QAAS,WAAU,EAAE,MAAM,UAAU,QAAQ,CAAC;AAAA,IACpD;AAEA,WAAO,iBAAiB,sBAAsB,QAAQ;AAEtD,WAAO,MAAM,OAAO,oBAAoB,sBAAsB,QAAQ;AAAA,EACxE,GAAG,CAAC,QAAQ,CAAC;AAEb,SAAO,QAAQ,SAAS,WAAW,OAAO,UAAU;AACtD;AAOO,SAAS,uBAAuB,EAAE,SAAS,GAA4B;AAC5E,QAAM,MAAM,gBAAgB;AAC5B,QAAM,UAAU,eAAe;AAC/B,QAAM,WAAW,UAAU,EAAE,MAAM;AACnC,QAAM,OAAO,WAAW,CAAC,QAAQ,gBAAgB,mBAAmB,UAAU,GAAG,IAAI;AAGrF,QAAM,QAAQ,SAAS,IAAI,QAAQ,IAAI,OAAO;AAE9C,SAAO,oBAAC,sBAAmB,OAAe,UAAS;AACrD;","names":[]}

package/dist/use-module-label.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns the resolved label for a platform module, respecting the merchant's
+ * custom label overrides stored in `settings.moduleLabels`.
+ *
+ * Precedence (high → low):
+ *   merchant custom label (settings.moduleLabels)
+ *   → fallback (platform default passed by the caller)
+ *
+ * Usage:
+ *   const title = useModuleLabel('inventory', 'Inventory');
+ */
+export declare function useModuleLabel(moduleId: string, fallback: string): string;

package/dist/use-module-label.js

@@ -0,0 +1,13 @@
+import { useAuth } from "./auth-context";
+import { effectiveModuleLabels } from "./effective-module-labels";
+function useModuleLabel(moduleId, fallback) {
+  const { tenant } = useAuth();
+  const moduleLabels = effectiveModuleLabels(
+    tenant?.settings
+  );
+  return moduleLabels?.[moduleId] ?? fallback;
+}
+export {
+  useModuleLabel
+};
+//# sourceMappingURL=use-module-label.js.map

package/dist/use-module-label.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-module-label.ts"],"sourcesContent":["import { useAuth } from './auth-context';\nimport { effectiveModuleLabels } from './effective-module-labels';\n\n/**\n * Returns the resolved label for a platform module, respecting the merchant's\n * custom label overrides stored in `settings.moduleLabels`.\n *\n * Precedence (high → low):\n *   merchant custom label (settings.moduleLabels)\n *   → fallback (platform default passed by the caller)\n *\n * Usage:\n *   const title = useModuleLabel('inventory', 'Inventory');\n */\nexport function useModuleLabel(moduleId: string, fallback: string): string {\n  const { tenant } = useAuth();\n  const moduleLabels = effectiveModuleLabels(\n    tenant?.settings as Record<string, unknown> | undefined,\n  );\n  return moduleLabels?.[moduleId] ?? fallback;\n}\n"],"mappings":"AAAA,SAAS,eAAe;AACxB,SAAS,6BAA6B;AAa/B,SAAS,eAAe,UAAkB,UAA0B;AACzE,QAAM,EAAE,OAAO,IAAI,QAAQ;AAC3B,QAAM,eAAe;AAAA,IACnB,QAAQ;AAAA,EACV;AACA,SAAO,eAAe,QAAQ,KAAK;AACrC;","names":[]}

package/dist/use-money-visibility.d.ts

@@ -0,0 +1,14 @@
+import { type MoneyVisibility } from './money-visibility';
+/**
+ * Whether this person is allowed to see money.
+ *
+ * Every currency figure in the dashboard asks this rather than calling
+ * `can('canViewFinance')` directly, and that indirection is what let the
+ * amounts/earnings split land in one file instead of a sweep across every
+ * screen that renders a naira sign. See `money-visibility.ts` for where the
+ * line falls and why.
+ */
+export declare function useMoneyVisibility(): MoneyVisibility & {
+    loading: boolean;
+};
+export type { MoneyVisibility };