@fayz-ai/admin 0.61.0 → 0.63.0

package/dist/chunk-S56FQKPL.js

@@ -0,0 +1,186 @@
+import { useBillingStore, useTrial, effectivePlan } from './chunk-SGAFPNMA.js';
+import { usePermissionsStore } from './chunk-UQ2NTFQC.js';
+import { useOrganizationStore } from './chunk-YKPPCV2Z.js';
+import { invalidateCount, usePluginRuntimeOptional, getAllEntities, countByTenant } from '@fayz-ai/core';
+import { create } from 'zustand';
+import * as React from 'react';
+import { useAuthStore } from '@fayz-ai/auth';
+import { mergeLimitDeclarations, isEntitledByPlan, resolveAccess, resolveLimit } from '@fayz-ai/core/access';
+import { jsx } from 'react/jsx-runtime';
+
+var CORE_LIMIT_DECLARATIONS = [
+  { key: "users", label: "Users", table: "v_team_members" },
+  { key: "locations", label: "Companies", table: "v_units" }
+];
+function entityDerivedLimitDeclarations(entities) {
+  const out = [];
+  for (const e of entities) {
+    const def = e.entityDef;
+    if (def?.limitKey && def.data?.table) {
+      out.push({
+        key: def.limitKey,
+        label: e.labelPlural,
+        table: def.data.table,
+        kindFilter: def.data.archetypeKind
+      });
+    }
+  }
+  return out;
+}
+var registry = /* @__PURE__ */ new Map();
+function setLimitRegistry(declarations) {
+  const next = /* @__PURE__ */ new Map();
+  for (const decl of declarations) next.set(decl.key, decl);
+  registry = next;
+}
+function getLimitDeclaration(key) {
+  return registry.get(key);
+}
+var listeners = /* @__PURE__ */ new Map();
+function subscribeLimit(key, cb) {
+  let set = listeners.get(key);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    listeners.set(key, set);
+  }
+  set.add(cb);
+  return () => {
+    set?.delete(cb);
+    if (set && set.size === 0) listeners.delete(key);
+  };
+}
+function invalidateLimit(key) {
+  const decl = registry.get(key);
+  if (decl) invalidateCount(decl.table);
+  listeners.get(key)?.forEach((cb) => cb());
+}
+var useUpgradeModalStore = create((set) => ({
+  current: null,
+  open: (payload) => set({ current: payload }),
+  close: () => set({ current: null })
+}));
+var AccessContext = React.createContext(null);
+function AccessProvider({ children, limitDeclarations, trialPlanId }) {
+  const user = useAuthStore((s) => s.user);
+  const org = useOrganizationStore((s) => s.currentOrg);
+  const profile = usePermissionsStore((s) => s.currentProfile);
+  const plans = useBillingStore((s) => s.plans);
+  const runtime = usePluginRuntimeOptional();
+  const pluginLimits = runtime?.pluginLimits;
+  React.useEffect(() => {
+    setLimitRegistry(
+      mergeLimitDeclarations(
+        CORE_LIMIT_DECLARATIONS,
+        entityDerivedLimitDeclarations(getAllEntities()),
+        pluginLimits,
+        limitDeclarations
+      )
+    );
+  }, [pluginLimits, limitDeclarations]);
+  const trial = useTrial();
+  const plan = React.useMemo(
+    () => effectivePlan(org, plans, trial, trialPlanId),
+    [plans, org?.plan, trial.status, trialPlanId]
+  );
+  const session = React.useMemo(
+    () => ({ user, org, profile, plan }),
+    [user, org, profile, plan]
+  );
+  const value = React.useMemo(
+    () => ({
+      session,
+      can: (feature, action) => resolveAccess(session, feature, action),
+      entitled: (feature) => isEntitledByPlan(session.plan, feature)
+    }),
+    [session]
+  );
+  return /* @__PURE__ */ jsx(AccessContext.Provider, { value, children });
+}
+AccessProvider.displayName = "AccessProvider";
+var ALLOW_ALL = {
+  can: () => ({ allowed: true }),
+  entitled: () => true
+};
+function useAccess() {
+  const ctx = React.useContext(AccessContext);
+  if (!ctx) throw new Error("useAccess must be used inside <AccessProvider>");
+  return { can: ctx.can, entitled: ctx.entitled };
+}
+function useAccessOptional() {
+  const ctx = React.useContext(AccessContext);
+  return ctx ? { can: ctx.can, entitled: ctx.entitled } : ALLOW_ALL;
+}
+function useAccessSession() {
+  return React.useContext(AccessContext)?.session ?? null;
+}
+function resolveCap(plan, key) {
+  return plan?.entitlements?.limits?.[key];
+}
+function useLimit(key) {
+  const session = useAccessSession();
+  const tenantId = session?.org?.id;
+  const cap = resolveCap(session?.plan ?? null, key);
+  const declaration = getLimitDeclaration(key);
+  const unlimited = !declaration || cap === void 0 || cap === -1;
+  const [used, setUsed] = React.useState(0);
+  const [loading, setLoading] = React.useState(!unlimited);
+  const [version, setVersion] = React.useState(0);
+  const refresh = React.useCallback(() => setVersion((v) => v + 1), []);
+  React.useEffect(() => subscribeLimit(key, refresh), [key, refresh]);
+  React.useEffect(() => {
+    if (unlimited || !declaration || !tenantId) {
+      setUsed(0);
+      setLoading(false);
+      return;
+    }
+    let active = true;
+    setLoading(true);
+    countByTenant(declaration.table, {
+      kind: declaration.kindFilter,
+      period: declaration.period,
+      tenantId,
+      fresh: version > 0
+    }).then((n) => {
+      if (active) {
+        setUsed(n);
+        setLoading(false);
+      }
+    }).catch(() => {
+      if (active) setLoading(false);
+    });
+    return () => {
+      active = false;
+    };
+  }, [unlimited, declaration, tenantId, version]);
+  const bounds = resolveLimit({ cap, hasDeclaration: Boolean(declaration), used });
+  return { key, ...bounds, loading, refresh };
+}
+function useLimitGuard(key) {
+  const session = useAccessSession();
+  const tenantId = session?.org?.id;
+  const plan = session?.plan ?? null;
+  const openModal = useUpgradeModalStore((s) => s.open);
+  return React.useCallback(
+    async (n = 1) => {
+      const cap = resolveCap(plan, key);
+      const declaration = getLimitDeclaration(key);
+      if (!declaration || cap === void 0 || cap === -1 || !tenantId) return "ok";
+      const used = await countByTenant(declaration.table, {
+        kind: declaration.kindFilter,
+        period: declaration.period,
+        tenantId,
+        fresh: true
+      });
+      if (used + n > cap) {
+        openModal({ limitKey: key });
+        return "blocked";
+      }
+      return "ok";
+    },
+    [key, plan, tenantId, openModal]
+  );
+}
+
+export { AccessProvider, CORE_LIMIT_DECLARATIONS, entityDerivedLimitDeclarations, getLimitDeclaration, invalidateLimit, useAccess, useAccessOptional, useLimit, useLimitGuard, useUpgradeModalStore };
+//# sourceMappingURL=chunk-S56FQKPL.js.map
+//# sourceMappingURL=chunk-S56FQKPL.js.map

package/dist/chunk-S56FQKPL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/access/limits-registry.ts","../src/access/upgrade-modal-store.ts","../src/access/context.tsx"],"names":[],"mappings":"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","file":"chunk-S56FQKPL.js","sourcesContent":["import type { LimitDeclaration, RegisteredEntity } from '@fayz-ai/core'\nimport { invalidateCount } from '@fayz-ai/core'\n\n/**\n * Module-level registry bridging React (the provider that knows the declarations)\n * and the plain `invalidateLimit(key)` function that create handlers call outside\n * any component. The AccessProvider publishes the merged declarations here on\n * mount; `useLimit`/`useLimitGuard` and `invalidateLimit` read from it.\n */\n\n/**\n * Shell built-in limit declarations. Unlike plugin/app limits (contributed via\n * `PluginManifest.declaredLimits` / `billing.limitDeclarations`), these count\n * core tenant tables that have no owning plugin: seats and units. Merged as the\n * LOWEST-priority layer by the AccessProvider, so a plugin or app may still\n * override a key (e.g. add a `kindFilter`).\n *\n * Counted through the public `v_*` bridges, not the base tables: the spine\n * moved memberships and units into schema `app`, which PostgREST cannot reach.\n */\nexport const CORE_LIMIT_DECLARATIONS: LimitDeclaration[] = [\n  { key: 'users', label: 'Users', table: 'v_team_members' },\n  { key: 'locations', label: 'Companies', table: 'v_units' },\n]\n\n/**\n * Entity-derived layer of the limit merge: any registered CRUD entity carrying\n * `limitKey` yields a declaration for free from its own data mapping (table +\n * archetype kind) — a cap without a countable binding is a dead cap. Shared by\n * the AccessProvider (live registry) and the manifest derivation (agent\n * contract), so both resolve the identical layer.\n */\nexport function entityDerivedLimitDeclarations(entities: RegisteredEntity[]): LimitDeclaration[] {\n  const out: LimitDeclaration[] = []\n  for (const e of entities) {\n    const def = e.entityDef\n    if (def?.limitKey && def.data?.table) {\n      out.push({\n        key: def.limitKey,\n        label: e.labelPlural,\n        table: def.data.table,\n        kindFilter: def.data.archetypeKind,\n      })\n    }\n  }\n  return out\n}\n\nlet registry = new Map<string, LimitDeclaration>()\n\n/** Called by AccessProvider whenever the merged limit declarations change. */\nexport function setLimitRegistry(declarations: LimitDeclaration[]): void {\n  const next = new Map<string, LimitDeclaration>()\n  for (const decl of declarations) next.set(decl.key, decl)\n  registry = next\n}\n\nexport function getLimitDeclaration(key: string): LimitDeclaration | undefined {\n  return registry.get(key)\n}\n\n// --- Invalidation pub/sub -------------------------------------------------\n// useLimit subscribes per key; invalidateLimit(key) drops the cached count for\n// the declaration's table and notifies subscribers to re-fetch.\n\nconst listeners = new Map<string, Set<() => void>>()\n\nexport function subscribeLimit(key: string, cb: () => void): () => void {\n  let set = listeners.get(key)\n  if (!set) {\n    set = new Set()\n    listeners.set(key, set)\n  }\n  set.add(cb)\n  return () => {\n    set?.delete(cb)\n    if (set && set.size === 0) listeners.delete(key)\n  }\n}\n\n/**\n * Invalidate a limit after a create/delete so its next read is fresh, then wake\n * any mounted `useLimit(key)`. Safe to call from plain handlers (no React).\n */\nexport function invalidateLimit(key: string): void {\n  const decl = registry.get(key)\n  if (decl) invalidateCount(decl.table)\n  listeners.get(key)?.forEach((cb) => cb())\n}\n","import { create } from 'zustand'\n\n/**\n * Payload describing WHY the upgrade modal opened, so the visual component (owned\n * by the shell/gates layer) can tailor its copy — a hit quantity cap\n * (`limitKey`) or a plan-gated feature (`feature`).\n */\nexport interface UpgradeModalPayload {\n  limitKey?: string\n  feature?: string\n}\n\nexport interface UpgradeModalStore {\n  /** The active payload, or null when closed. */\n  current: UpgradeModalPayload | null\n  open(payload: UpgradeModalPayload): void\n  close(): void\n}\n\n/**\n * Global, lightweight store for the single app-wide UpgradeModal. `useLimitGuard`\n * and imperative create handlers call `open(...)` when a limit blocks; the visual\n * modal (rendered once near the shell root by the gates layer) subscribes to\n * `current`. Kept as a zustand singleton so store + component share one instance.\n */\nexport const useUpgradeModalStore = create<UpgradeModalStore>((set) => ({\n  current: null,\n  open: (payload) => set({ current: payload }),\n  close: () => set({ current: null }),\n}))\n","import * as React from 'react'\nimport type { LimitDeclaration, PermissionAction, Plan } from '@fayz-ai/core'\nimport { countByTenant, usePluginRuntimeOptional, getAllEntities } from '@fayz-ai/core'\nimport { useAuthStore } from '@fayz-ai/auth'\nimport { useOrganizationStore } from '../org/store'\nimport { usePermissionsStore } from '../permissions/store'\nimport { useBillingStore } from '../billing/store'\nimport { effectivePlan, useTrial } from '../billing/trial'\nimport { mergeLimitDeclarations, resolveAccess, isEntitledByPlan, resolveLimit } from '@fayz-ai/core/access'\nimport { entityDerivedLimitDeclarations } from './limits-registry'\nimport { setLimitRegistry, getLimitDeclaration, subscribeLimit, CORE_LIMIT_DECLARATIONS } from './limits-registry'\nimport { useUpgradeModalStore } from './upgrade-modal-store'\nimport type { AccessApi, AccessDecision, AccessSession, LimitState } from './types'\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\ninterface AccessContextValue extends AccessApi {\n  session: AccessSession\n}\n\nconst AccessContext = React.createContext<AccessContextValue | null>(null)\n\n// ---------------------------------------------------------------------------\n// Provider\n// ---------------------------------------------------------------------------\n\nexport interface AccessProviderProps {\n  children: React.ReactNode\n  /**\n   * App-level limit declarations layered ON TOP of the plugins' `declaredLimits`\n   * (app wins on key collision). Sourced from `config.billing.limitDeclarations`.\n   */\n  limitDeclarations?: LimitDeclaration[]\n  /** Plan the tenant is entitled to while its trial runs. See billing/trial.ts. */\n  trialPlanId?: string\n}\n\n/**\n * Assembles the reactive {@link AccessSession} from the singleton stores and\n * exposes the composed access API (role × plan). Thin by design — mounts just\n * inside PermissionsProvider so it can reuse the live permission profile and the\n * plugin runtime. Also publishes the merged limit declarations to the module\n * registry so `invalidateLimit` works from non-React create handlers.\n */\nexport function AccessProvider({ children, limitDeclarations, trialPlanId }: AccessProviderProps) {\n  const user = useAuthStore((s) => s.user)\n  const org = useOrganizationStore((s) => s.currentOrg)\n  const profile = usePermissionsStore((s) => s.currentProfile)\n  const plans = useBillingStore((s) => s.plans)\n\n  const runtime = usePluginRuntimeOptional()\n  const pluginLimits = runtime?.pluginLimits\n\n  // Merge limit declarations by priority (later wins by key): shell built-ins\n  // (users/locations) < entity-derived < plugin `declaredLimits` < app\n  // overrides. Then publish to the module registry consumed by\n  // invalidateLimit / the limit hooks.\n  //\n  // Entity-derived: any registered CRUD entity carrying `limitKey` yields a\n  // declaration for free from its own data mapping (table + archetype kind) —\n  // this is what makes an app's `EntityDef.limitKey: 'clients'` enforceable\n  // with ZERO extra wiring (a cap without a countable binding is a dead cap).\n  React.useEffect(() => {\n    setLimitRegistry(\n      mergeLimitDeclarations(\n        CORE_LIMIT_DECLARATIONS,\n        entityDerivedLimitDeclarations(getAllEntities()),\n        pluginLimits,\n        limitDeclarations,\n      ),\n    )\n  }, [pluginLimits, limitDeclarations])\n\n  // The trial is resolved HERE and nowhere else: it changes which plan's\n  // entitlements apply, and every gate in the product already reads that. A\n  // per-feature \"…or on trial\" check would have to be repeated in the nav, the\n  // gates, the caps and the assistant, and one of them would be forgotten.\n  const trial = useTrial()\n  const plan: Plan | null = React.useMemo(\n    () => effectivePlan(org, plans, trial, trialPlanId),\n    [plans, org?.plan, trial.status, trialPlanId],\n  )\n\n  const session: AccessSession = React.useMemo(\n    () => ({ user, org, profile, plan }),\n    [user, org, profile, plan],\n  )\n\n  const value = React.useMemo<AccessContextValue>(\n    () => ({\n      session,\n      can: (feature, action) => resolveAccess(session, feature, action),\n      entitled: (feature) => isEntitledByPlan(session.plan, feature),\n    }),\n    [session],\n  )\n\n  return <AccessContext.Provider value={value}>{children}</AccessContext.Provider>\n}\nAccessProvider.displayName = 'AccessProvider'\n\n// ---------------------------------------------------------------------------\n// Hooks\n// ---------------------------------------------------------------------------\n\nconst ALLOW_ALL: AccessApi = {\n  can: () => ({ allowed: true }),\n  entitled: () => true,\n}\n\n/**\n * The composed access API. Throws outside <AccessProvider> — use\n * {@link useAccessOptional} for SDK components that must degrade gracefully.\n */\nexport function useAccess(): AccessApi {\n  const ctx = React.useContext(AccessContext)\n  if (!ctx) throw new Error('useAccess must be used inside <AccessProvider>')\n  return { can: ctx.can, entitled: ctx.entitled }\n}\n\n/**\n * Like {@link useAccess} but degrades to allow-all when no provider is mounted,\n * so components stay usable under a bare host shell (gating is an enhancement).\n */\nexport function useAccessOptional(): AccessApi {\n  const ctx = React.useContext(AccessContext)\n  return ctx ? { can: ctx.can, entitled: ctx.entitled } : ALLOW_ALL\n}\n\n/** Internal: the live session (for hooks that need tenant/plan directly). */\nfunction useAccessSession(): AccessSession | null {\n  return React.useContext(AccessContext)?.session ?? null\n}\n\n// ---------------------------------------------------------------------------\n// Limits\n// ---------------------------------------------------------------------------\n\nfunction resolveCap(plan: Plan | null, key: string): number | undefined {\n  return plan?.entitlements?.limits?.[key]\n}\n\n/**\n * Live usage of a quantity limit for the active tenant. Resolves the limit's\n * declaration (plugin manifest or app override) → a tenant-scoped `count(*)`,\n * capped by the current plan. No declaration or no cap (or `-1`) ⇒ unlimited.\n * Re-fetches when the tenant, plan cap, or an `invalidateLimit(key)` fires.\n */\nexport function useLimit(key: string): LimitState {\n  const session = useAccessSession()\n  const tenantId = session?.org?.id\n  const cap = resolveCap(session?.plan ?? null, key)\n  const declaration = getLimitDeclaration(key)\n\n  const unlimited = !declaration || cap === undefined || cap === -1\n\n  const [used, setUsed] = React.useState(0)\n  const [loading, setLoading] = React.useState(!unlimited)\n  const [version, setVersion] = React.useState(0)\n\n  const refresh = React.useCallback(() => setVersion((v) => v + 1), [])\n\n  // Wake on external invalidation (a create/delete elsewhere).\n  React.useEffect(() => subscribeLimit(key, refresh), [key, refresh])\n\n  React.useEffect(() => {\n    if (unlimited || !declaration || !tenantId) {\n      setUsed(0)\n      setLoading(false)\n      return\n    }\n    let active = true\n    setLoading(true)\n    countByTenant(declaration.table, {\n      kind: declaration.kindFilter,\n      period: declaration.period,\n      tenantId,\n      fresh: version > 0,\n    })\n      .then((n) => {\n        if (active) {\n          setUsed(n)\n          setLoading(false)\n        }\n      })\n      .catch(() => {\n        if (active) setLoading(false)\n      })\n    return () => {\n      active = false\n    }\n  }, [unlimited, declaration, tenantId, version])\n\n  const bounds = resolveLimit({ cap, hasDeclaration: Boolean(declaration), used })\n\n  return { key, ...bounds, loading, refresh }\n}\n\n/**\n * Imperative guard for create handlers: `await guard(n)` returns `'ok'` when\n * adding `n` more rows stays within the cap, or `'blocked'` (and opens the global\n * UpgradeModal) when it would exceed it. Always checks a FRESH count so it never\n * relies on stale hook state.\n */\nexport function useLimitGuard(key: string): (n?: number) => Promise<'ok' | 'blocked'> {\n  const session = useAccessSession()\n  const tenantId = session?.org?.id\n  const plan = session?.plan ?? null\n  const openModal = useUpgradeModalStore((s) => s.open)\n\n  return React.useCallback(\n    async (n = 1) => {\n      const cap = resolveCap(plan, key)\n      const declaration = getLimitDeclaration(key)\n      // Unlimited / no declaration / no tenant ⇒ never block.\n      if (!declaration || cap === undefined || cap === -1 || !tenantId) return 'ok'\n\n      const used = await countByTenant(declaration.table, {\n        kind: declaration.kindFilter,\n        period: declaration.period,\n        tenantId,\n        fresh: true,\n      })\n\n      if (used + n > cap) {\n        openModal({ limitKey: key })\n        return 'blocked'\n      }\n      return 'ok'\n    },\n    [key, plan, tenantId, openModal],\n  )\n}\n"]}

package/dist/chunk-SGAFPNMA.js

@@ -0,0 +1,75 @@
+import { useOrganizationStore } from './chunk-YKPPCV2Z.js';
+import { create } from 'zustand';
+import * as React from 'react';
+
+var initialState = {
+  subscription: null,
+  invoices: [],
+  plans: [],
+  loading: false,
+  checkout: null
+};
+var useBillingStore = create((set) => ({
+  ...initialState,
+  setSubscription: (subscription) => set({ subscription }),
+  setInvoices: (invoices) => set({ invoices }),
+  setPlans: (plans) => set({ plans }),
+  setLoading: (loading) => set({ loading }),
+  setCheckout: (checkout) => set({ checkout }),
+  reset: () => set(initialState)
+}));
+var NO_TRIAL = { status: "none", daysLeft: 0, endingSoon: false };
+var DAY_MS = 864e5;
+function resolveTrial(org, paidPlanIds2, now = Date.now()) {
+  if (!org?.trialEndsAt) return NO_TRIAL;
+  if (org.plan && paidPlanIds2.has(org.plan)) return NO_TRIAL;
+  const ends = Date.parse(org.trialEndsAt);
+  if (Number.isNaN(ends)) return NO_TRIAL;
+  const remaining = ends - now;
+  if (remaining <= 0) return { status: "expired", endsAt: org.trialEndsAt, daysLeft: 0, endingSoon: false };
+  const daysLeft = Math.ceil(remaining / DAY_MS);
+  return {
+    status: "active",
+    endsAt: org.trialEndsAt,
+    daysLeft,
+    endingSoon: remaining <= 2 * DAY_MS
+  };
+}
+function effectivePlan(org, plans, trial, trialPlanId) {
+  if (trial.status === "active") {
+    const named2 = trialPlanId ? plans.find((p) => p.id === trialPlanId) : void 0;
+    if (named2) return named2;
+    const paid = plans.filter((p) => p.price > 0);
+    if (paid.length) return paid.reduce((best, p) => p.price > best.price ? p : best);
+  }
+  if (plans.length === 0) return null;
+  const named = org?.plan ? plans.find((p) => p.id === org.plan) : void 0;
+  if (named) return named;
+  const floor = plans.reduce((cheapest, p) => p.price < cheapest.price ? p : cheapest);
+  if (org?.plan) {
+    console.warn(
+      `[billing] tenant plan "${org.plan}" n\xE3o existe neste cat\xE1logo (${plans.map((p) => p.id).join(", ")}) \u2014 aplicando o piso "${floor.id}"`
+    );
+  }
+  return floor;
+}
+function paidPlanIds(plans) {
+  return new Set(plans.filter((p) => p.price > 0).map((p) => p.id));
+}
+function useTrial() {
+  const org = useOrganizationStore((s) => s.currentOrg);
+  const plans = useBillingStore((s) => s.plans);
+  const [now, setNow] = React.useState(() => Date.now());
+  React.useEffect(() => {
+    const id = window.setInterval(() => setNow(Date.now()), 36e5);
+    return () => window.clearInterval(id);
+  }, []);
+  return React.useMemo(
+    () => resolveTrial(org, paidPlanIds(plans), now),
+    [org?.plan, org?.trialEndsAt, plans, now]
+  );
+}
+
+export { NO_TRIAL, effectivePlan, paidPlanIds, resolveTrial, useBillingStore, useTrial };
+//# sourceMappingURL=chunk-SGAFPNMA.js.map
+//# sourceMappingURL=chunk-SGAFPNMA.js.map

package/dist/chunk-SGAFPNMA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/billing/store.ts","../src/billing/trial.ts"],"names":["paidPlanIds","named"],"mappings":"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","file":"chunk-SGAFPNMA.js","sourcesContent":["import { create } from 'zustand'\nimport type { Plan, BillingCheckoutFn } from '@fayz-ai/core'\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface Subscription {\n  id: string\n  orgId: string\n  planId: string\n  status: 'active' | 'trialing' | 'past_due' | 'canceled' | 'incomplete'\n  currentPeriodStart: string\n  currentPeriodEnd: string\n  cancelAtPeriodEnd?: boolean\n  stripeSubscriptionId?: string\n}\n\nexport interface Invoice {\n  id: string\n  orgId: string\n  amount: number\n  currency: string\n  status: 'paid' | 'open' | 'void' | 'uncollectible'\n  pdfUrl?: string\n  createdAt: string\n}\n\nexport interface BillingState {\n  subscription: Subscription | null\n  invoices: Invoice[]\n  plans: Plan[]\n  loading: boolean\n  /** Payment-gateway seam seeded from `config.billing.onCheckout` (see core\n   *  BillingConfig). When set, the Subscription page routes plan changes through\n   *  it instead of writing `plan` straight onto the org. */\n  checkout: BillingCheckoutFn | null\n}\n\n// ---------------------------------------------------------------------------\n// Store\n// ---------------------------------------------------------------------------\n\nexport interface BillingStore extends BillingState {\n  setSubscription: (subscription: Subscription | null) => void\n  setInvoices: (invoices: Invoice[]) => void\n  setPlans: (plans: Plan[]) => void\n  setLoading: (loading: boolean) => void\n  setCheckout: (checkout: BillingCheckoutFn | null) => void\n  reset: () => void\n}\n\nconst initialState: BillingState = {\n  subscription: null,\n  invoices: [],\n  plans: [],\n  loading: false,\n  checkout: null,\n}\n\nexport const useBillingStore = create<BillingStore>((set) => ({\n  ...initialState,\n  setSubscription: (subscription) => set({ subscription }),\n  setInvoices: (invoices) => set({ invoices }),\n  setPlans: (plans) => set({ plans }),\n  setLoading: (loading) => set({ loading }),\n  setCheckout: (checkout) => set({ checkout }),\n  reset: () => set(initialState),\n}))\n","import * as React from 'react'\nimport type { Organization, Plan } from '@fayz-ai/core'\nimport { useOrganizationStore } from '../org/store'\nimport { useBillingStore } from './store'\n\n/**\n * The free trial, as one derived fact.\n *\n * A trial is not a fourth plan or a state machine — it is a WINDOW during which\n * a tenant on the free plan is entitled to a paid one. Modelling it that way is\n * what keeps it out of every gate in the product: the access provider resolves\n * the effective plan once, and the nav crowns, the entitlement gates, the limit\n * caps and the assistant's lock all follow without knowing a trial exists.\n *\n * `trialEndsAt` is written by the database when the tenant is created (see\n * migration 147) and is never written by the client — a trial the browser could\n * extend is not a trial. A tenant with no `trialEndsAt` predates the column and\n * is left alone: status `none`, plan exactly as stored.\n */\n\nexport type TrialStatus = 'none' | 'active' | 'expired'\n\nexport interface TrialState {\n  status: TrialStatus\n  /** ISO date the window closes. */\n  endsAt?: string\n  /** Whole days remaining, floored at 0. `0` on the last day, not a negative. */\n  daysLeft: number\n  /** The last 48 hours, when the banner stops being informational. */\n  endingSoon: boolean\n}\n\nexport const NO_TRIAL: TrialState = { status: 'none', daysLeft: 0, endingSoon: false }\n\nconst DAY_MS = 86_400_000\n\n/** Pure — the part worth testing, and it needs neither React nor a clock. */\nexport function resolveTrial(\n  org: Pick<Organization, 'plan' | 'trialEndsAt'> | null | undefined,\n  paidPlanIds: ReadonlySet<string>,\n  now: number = Date.now(),\n): TrialState {\n  if (!org?.trialEndsAt) return NO_TRIAL\n  // Somebody who is paying is not on a trial, whatever the column still says.\n  if (org.plan && paidPlanIds.has(org.plan)) return NO_TRIAL\n\n  const ends = Date.parse(org.trialEndsAt)\n  if (Number.isNaN(ends)) return NO_TRIAL\n\n  const remaining = ends - now\n  if (remaining <= 0) return { status: 'expired', endsAt: org.trialEndsAt, daysLeft: 0, endingSoon: false }\n\n  const daysLeft = Math.ceil(remaining / DAY_MS)\n  return {\n    status: 'active',\n    endsAt: org.trialEndsAt,\n    daysLeft,\n    endingSoon: remaining <= 2 * DAY_MS,\n  }\n}\n\n/**\n * The plan whose entitlements apply RIGHT NOW.\n *\n * During the trial that is the trial plan — by default the most expensive one\n * configured, because the point of a trial is to be worth losing. After it, the\n * tenant's own plan, which for a free tenant is the free one: that fall is the\n * paywall, and it needs no separate enforcement path.\n *\n * ── Por que um plano desconhecido cai no piso, e não em `null` ──────────────\n * A frase acima (\"essa queda é o paywall\") só era verdade quando o id gravado\n * em `tenants.plan` existia no catálogo do app. Quando não existia — o\n * ChefControl vendia `starter/professional/enterprise` enquanto o pool grava\n * `free/pro/business` — isto devolvia `null`, e `null` não é \"sem plano\": é SEM\n * TETO. `resolveLimit` lê teto ausente como ilimitado e `isEntitledByPlan` só\n * nega com um `false` explícito. O resultado é que vencer o trial LIBERAVA em\n * vez de travar, que é o oposto do paywall.\n *\n * Então um id que o catálogo não conhece cai no plano mais barato — o piso é a\n * resposta segura para \"não sei em que plano esta conta está\". `null` fica\n * reservado para o único caso em que ilimitado é a leitura certa: o app que não\n * vende plano nenhum e portanto não tem o que travar.\n */\nexport function effectivePlan(\n  org: Pick<Organization, 'plan'> | null | undefined,\n  plans: Plan[],\n  trial: TrialState,\n  trialPlanId?: string,\n): Plan | null {\n  if (trial.status === 'active') {\n    const named = trialPlanId ? plans.find((p) => p.id === trialPlanId) : undefined\n    if (named) return named\n    const paid = plans.filter((p) => p.price > 0)\n    if (paid.length) return paid.reduce((best, p) => (p.price > best.price ? p : best))\n  }\n  if (plans.length === 0) return null\n\n  const named = org?.plan ? plans.find((p) => p.id === org.plan) : undefined\n  if (named) return named\n\n  const floor = plans.reduce((cheapest, p) => (p.price < cheapest.price ? p : cheapest))\n  if (org?.plan) {\n    // Avisa alto: é um defeito de dados (catálogo e pool discordando), e quem\n    // vê primeiro é quem estiver com o console aberto.\n    console.warn(\n      `[billing] tenant plan \"${org.plan}\" não existe neste catálogo (${plans.map((p) => p.id).join(', ')}) — aplicando o piso \"${floor.id}\"`,\n    )\n  }\n  return floor\n}\n\n/** Ids of the plans somebody actually pays for. */\nexport function paidPlanIds(plans: Plan[]): Set<string> {\n  return new Set(plans.filter((p) => p.price > 0).map((p) => p.id))\n}\n\n/**\n * Live trial state for the current workspace.\n *\n * Ticks once an hour rather than on a timer per second: nothing on screen\n * counts down in real time, and a banner that says \"2 days left\" only has to be\n * right the next time somebody looks at it.\n */\nexport function useTrial(): TrialState {\n  const org = useOrganizationStore((s) => s.currentOrg)\n  const plans = useBillingStore((s) => s.plans)\n  const [now, setNow] = React.useState(() => Date.now())\n\n  React.useEffect(() => {\n    const id = window.setInterval(() => setNow(Date.now()), 3_600_000)\n    return () => window.clearInterval(id)\n  }, [])\n\n  return React.useMemo(\n    () => resolveTrial(org, paidPlanIds(plans), now),\n    [org?.plan, org?.trialEndsAt, plans, now],\n  )\n}\n"]}

package/dist/{chunk-OD7P4L3D.js → chunk-SOKCLVM4.js}

@@ -63,12 +63,12 @@ function useRecordVisit(entrada) {
 }
 function useOpenRecent() {
   return useCallback((r) => {
-    void import('./entity-routes-LXOBW5IB.js').then(({ openEntity }) => {
+    void import('./entity-routes-PGU7EHAD.js').then(({ openEntity }) => {
       openEntity(r.id, r.archetype, r.archetypeKind, void 0, r.entityKey);
     });
   }, []);
 }
 
 export { clearRecentRecords, listRecentRecords, rememberVisit, subscribeRecentRecords, useOpenRecent, useRecentRecords, useRecordVisit };
-//# sourceMappingURL=chunk-OD7P4L3D.js.map
-//# sourceMappingURL=chunk-OD7P4L3D.js.map
+//# sourceMappingURL=chunk-SOKCLVM4.js.map
+//# sourceMappingURL=chunk-SOKCLVM4.js.map

package/dist/{chunk-OD7P4L3D.js.map → chunk-SOKCLVM4.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/lib/recent-records.ts","../src/hooks/useRecentRecords.ts"],"names":[],"mappings":"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","file":"chunk-OD7P4L3D.js","sourcesContent":["/**\n * O que a pessoa abriu por último.\n *\n * ── por que no navegador, e não no banco ────────────────────────────────\n *\n * Isto é conveniência de quem está olhando, não informação da empresa. Uma\n * tabela custaria migração, RLS, escrita a cada navegação e uma pergunta que\n * ninguém faz (\"o que o Julio andou abrindo?\" é vigilância, não produto).\n *\n * O preço é que a lista não atravessa máquinas: quem abre no notebook não vê\n * no celular. É o preço certo — a alternativa é gravar a pegada de navegação\n * de cada vendedor num servidor para resolver um atalho.\n *\n * ── por que a TELA registra, e não o clique ─────────────────────────────\n *\n * `openEntity` parece o lugar óbvio (é a porta de todo registro), e não é: o\n * CRM navega por rota interna própria e nunca passa por lá, então metade das\n * visitas sumiria. Pior, um clique que cai numa rota quebrada contaria como\n * visita — e a lista de \"recentes\" passaria a guardar justamente os lugares\n * onde a pessoa NÃO conseguiu chegar.\n *\n * Visita é a tela de detalhe ter renderizado com o registro carregado. É lá\n * também que o NOME existe: `openEntity` só recebe o id, e uma lista de\n * recentes mostrando UUID não serve para nada.\n */\n\n/** Um registro aberto. `href` é resolvido na gravação, não na leitura — a rota\n *  de hoje é a que funcionava quando a pessoa esteve lá. */\nexport interface RecentRecord {\n  /** `${kind}:${id}` — um lead e uma empresa podem repetir id entre tabelas. */\n  uid: string\n  id: string\n  /** `lead`, `company`, `quote`… o que a tela chama de si mesma. */\n  kind: string\n  /** Rótulo do grupo, já traduzido pela tela que gravou. */\n  kindLabel: string\n  label: string\n  subtitle?: string\n  /** Quando foi aberto (epoch ms). */\n  at: number\n  /** Para reabrir: os mesmos argumentos que a paleta passa a `openEntity`. */\n  archetype?: string\n  archetypeKind?: string\n  entityKey?: string\n}\n\nconst CHAVE = 'fayz.recent-records.v1'\n\n/** Vinte. O suficiente para \"aquele que eu vi agora há pouco\" e pouco o\n *  bastante para a lista continuar sendo uma lista, e não um histórico que\n *  ninguém lê. */\nconst MAXIMO = 20\n\nconst ouvintes = new Set<() => void>()\nlet cache: RecentRecord[] | null = null\n\n/** Toda leitura e escrita passa por aqui.\n *\n *  `localStorage` não é garantido: janela anônima, site data bloqueado,\n *  captura de miniatura. Ele lança na hora do acesso, não na hora do uso — e\n *  uma exceção aqui derrubaria a tela inteira por causa de um atalho. */\nfunction ler(): RecentRecord[] {\n  if (cache) return cache\n  try {\n    const cru = localStorage.getItem(CHAVE)\n    const dados = cru ? JSON.parse(cru) : []\n    cache = Array.isArray(dados) ? dados.filter((x) => x && typeof x.id === 'string' && typeof x.label === 'string') : []\n  } catch {\n    cache = []\n  }\n  return cache\n}\n\nfunction gravar(lista: RecentRecord[]): void {\n  cache = lista\n  try {\n    localStorage.setItem(CHAVE, JSON.stringify(lista))\n  } catch {\n    // Cota estourada ou armazenamento bloqueado. A lista em memória continua\n    // valendo para esta sessão; perder o atalho é melhor que perder a tela.\n  }\n  for (const f of ouvintes) f()\n}\n\n/** Marca um registro como visto agora. Idempotente: reabrir sobe a entrada em\n *  vez de duplicá-la, porque \"os últimos 20 que abri\" são vinte REGISTROS, não\n *  vinte aberturas do mesmo. */\nexport function rememberVisit(entrada: Omit<RecentRecord, 'uid' | 'at'>): void {\n  if (!entrada.id || !entrada.label?.trim()) return\n  const uid = `${entrada.kind}:${entrada.id}`\n  const nova: RecentRecord = { ...entrada, label: entrada.label.trim(), uid, at: Date.now() }\n  const resto = ler().filter((x) => x.uid !== uid)\n  gravar([nova, ...resto].slice(0, MAXIMO))\n}\n\n/** A lista, mais recente primeiro. */\nexport function listRecentRecords(): RecentRecord[] {\n  return ler()\n}\n\nexport function clearRecentRecords(): void {\n  gravar([])\n}\n\nexport function subscribeRecentRecords(f: () => void): () => void {\n  ouvintes.add(f)\n  return () => { ouvintes.delete(f) }\n}\n","import { useCallback, useEffect, useSyncExternalStore } from 'react'\nimport {\n  listRecentRecords, rememberVisit, subscribeRecentRecords,\n  type RecentRecord,\n} from '../lib/recent-records'\n\n/** A lista de visitados, que se atualiza sozinha quando outra tela grava. */\nexport function useRecentRecords(): RecentRecord[] {\n  return useSyncExternalStore(\n    subscribeRecentRecords,\n    listRecentRecords,\n    // No servidor não há `localStorage`. Devolver a mesma referência vazia\n    // importa: um array novo a cada chamada faz o React re-renderizar para\n    // sempre.\n    () => VAZIO,\n  )\n}\n\nconst VAZIO: RecentRecord[] = []\n\n/**\n * Registra a visita quando a tela de detalhe terminou de carregar.\n *\n * Recebe `null` enquanto o registro não chegou — e é justamente esse o\n * contrato: gravar antes do nome existir poria um UUID na lista, e gravar uma\n * tela que falhou em carregar poria na lista de \"recentes\" um lugar onde a\n * pessoa não conseguiu entrar.\n */\nexport function useRecordVisit(entrada: Omit<RecentRecord, 'uid' | 'at'> | null): void {\n  const { id, kind, label } = entrada ?? {}\n  // As dependências são os CAMPOS, não o objeto: a tela monta um literal novo\n  // a cada render, e um objeto como dependência regravaria a visita em todo\n  // ciclo — subindo a entrada, notificando os ouvintes e re-renderizando quem\n  // a escuta, para sempre.\n  useEffect(() => {\n    if (!entrada || !id || !label) return\n    rememberVisit(entrada)\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [id, kind, label])\n}\n\n/** Reabrir um item da lista. */\nexport function useOpenRecent(): (r: RecentRecord) => void {\n  return useCallback((r: RecentRecord) => {\n    // Importado aqui para não puxar o roteador em quem só quer LER a lista.\n    void import('../lib/entity-routes').then(({ openEntity }) => {\n      openEntity(r.id, r.archetype, r.archetypeKind, undefined, r.entityKey)\n    })\n  }, [])\n}\n\nexport type { RecentRecord }\n"]}
+{"version":3,"sources":["../src/lib/recent-records.ts","../src/hooks/useRecentRecords.ts"],"names":[],"mappings":"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","file":"chunk-SOKCLVM4.js","sourcesContent":["/**\n * O que a pessoa abriu por último.\n *\n * ── por que no navegador, e não no banco ────────────────────────────────\n *\n * Isto é conveniência de quem está olhando, não informação da empresa. Uma\n * tabela custaria migração, RLS, escrita a cada navegação e uma pergunta que\n * ninguém faz (\"o que o Julio andou abrindo?\" é vigilância, não produto).\n *\n * O preço é que a lista não atravessa máquinas: quem abre no notebook não vê\n * no celular. É o preço certo — a alternativa é gravar a pegada de navegação\n * de cada vendedor num servidor para resolver um atalho.\n *\n * ── por que a TELA registra, e não o clique ─────────────────────────────\n *\n * `openEntity` parece o lugar óbvio (é a porta de todo registro), e não é: o\n * CRM navega por rota interna própria e nunca passa por lá, então metade das\n * visitas sumiria. Pior, um clique que cai numa rota quebrada contaria como\n * visita — e a lista de \"recentes\" passaria a guardar justamente os lugares\n * onde a pessoa NÃO conseguiu chegar.\n *\n * Visita é a tela de detalhe ter renderizado com o registro carregado. É lá\n * também que o NOME existe: `openEntity` só recebe o id, e uma lista de\n * recentes mostrando UUID não serve para nada.\n */\n\n/** Um registro aberto. `href` é resolvido na gravação, não na leitura — a rota\n *  de hoje é a que funcionava quando a pessoa esteve lá. */\nexport interface RecentRecord {\n  /** `${kind}:${id}` — um lead e uma empresa podem repetir id entre tabelas. */\n  uid: string\n  id: string\n  /** `lead`, `company`, `quote`… o que a tela chama de si mesma. */\n  kind: string\n  /** Rótulo do grupo, já traduzido pela tela que gravou. */\n  kindLabel: string\n  label: string\n  subtitle?: string\n  /** Quando foi aberto (epoch ms). */\n  at: number\n  /** Para reabrir: os mesmos argumentos que a paleta passa a `openEntity`. */\n  archetype?: string\n  archetypeKind?: string\n  entityKey?: string\n}\n\nconst CHAVE = 'fayz.recent-records.v1'\n\n/** Vinte. O suficiente para \"aquele que eu vi agora há pouco\" e pouco o\n *  bastante para a lista continuar sendo uma lista, e não um histórico que\n *  ninguém lê. */\nconst MAXIMO = 20\n\nconst ouvintes = new Set<() => void>()\nlet cache: RecentRecord[] | null = null\n\n/** Toda leitura e escrita passa por aqui.\n *\n *  `localStorage` não é garantido: janela anônima, site data bloqueado,\n *  captura de miniatura. Ele lança na hora do acesso, não na hora do uso — e\n *  uma exceção aqui derrubaria a tela inteira por causa de um atalho. */\nfunction ler(): RecentRecord[] {\n  if (cache) return cache\n  try {\n    const cru = localStorage.getItem(CHAVE)\n    const dados = cru ? JSON.parse(cru) : []\n    cache = Array.isArray(dados) ? dados.filter((x) => x && typeof x.id === 'string' && typeof x.label === 'string') : []\n  } catch {\n    cache = []\n  }\n  return cache\n}\n\nfunction gravar(lista: RecentRecord[]): void {\n  cache = lista\n  try {\n    localStorage.setItem(CHAVE, JSON.stringify(lista))\n  } catch {\n    // Cota estourada ou armazenamento bloqueado. A lista em memória continua\n    // valendo para esta sessão; perder o atalho é melhor que perder a tela.\n  }\n  for (const f of ouvintes) f()\n}\n\n/** Marca um registro como visto agora. Idempotente: reabrir sobe a entrada em\n *  vez de duplicá-la, porque \"os últimos 20 que abri\" são vinte REGISTROS, não\n *  vinte aberturas do mesmo. */\nexport function rememberVisit(entrada: Omit<RecentRecord, 'uid' | 'at'>): void {\n  if (!entrada.id || !entrada.label?.trim()) return\n  const uid = `${entrada.kind}:${entrada.id}`\n  const nova: RecentRecord = { ...entrada, label: entrada.label.trim(), uid, at: Date.now() }\n  const resto = ler().filter((x) => x.uid !== uid)\n  gravar([nova, ...resto].slice(0, MAXIMO))\n}\n\n/** A lista, mais recente primeiro. */\nexport function listRecentRecords(): RecentRecord[] {\n  return ler()\n}\n\nexport function clearRecentRecords(): void {\n  gravar([])\n}\n\nexport function subscribeRecentRecords(f: () => void): () => void {\n  ouvintes.add(f)\n  return () => { ouvintes.delete(f) }\n}\n","import { useCallback, useEffect, useSyncExternalStore } from 'react'\nimport {\n  listRecentRecords, rememberVisit, subscribeRecentRecords,\n  type RecentRecord,\n} from '../lib/recent-records'\n\n/** A lista de visitados, que se atualiza sozinha quando outra tela grava. */\nexport function useRecentRecords(): RecentRecord[] {\n  return useSyncExternalStore(\n    subscribeRecentRecords,\n    listRecentRecords,\n    // No servidor não há `localStorage`. Devolver a mesma referência vazia\n    // importa: um array novo a cada chamada faz o React re-renderizar para\n    // sempre.\n    () => VAZIO,\n  )\n}\n\nconst VAZIO: RecentRecord[] = []\n\n/**\n * Registra a visita quando a tela de detalhe terminou de carregar.\n *\n * Recebe `null` enquanto o registro não chegou — e é justamente esse o\n * contrato: gravar antes do nome existir poria um UUID na lista, e gravar uma\n * tela que falhou em carregar poria na lista de \"recentes\" um lugar onde a\n * pessoa não conseguiu entrar.\n */\nexport function useRecordVisit(entrada: Omit<RecentRecord, 'uid' | 'at'> | null): void {\n  const { id, kind, label } = entrada ?? {}\n  // As dependências são os CAMPOS, não o objeto: a tela monta um literal novo\n  // a cada render, e um objeto como dependência regravaria a visita em todo\n  // ciclo — subindo a entrada, notificando os ouvintes e re-renderizando quem\n  // a escuta, para sempre.\n  useEffect(() => {\n    if (!entrada || !id || !label) return\n    rememberVisit(entrada)\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [id, kind, label])\n}\n\n/** Reabrir um item da lista. */\nexport function useOpenRecent(): (r: RecentRecord) => void {\n  return useCallback((r: RecentRecord) => {\n    // Importado aqui para não puxar o roteador em quem só quer LER a lista.\n    void import('../lib/entity-routes').then(({ openEntity }) => {\n      openEntity(r.id, r.archetype, r.archetypeKind, undefined, r.entityKey)\n    })\n  }, [])\n}\n\nexport type { RecentRecord }\n"]}

package/dist/chunk-TL42NKTH.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-TL42NKTH.js.map
+//# sourceMappingURL=chunk-TL42NKTH.js.map

package/dist/chunk-TL42NKTH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-TL42NKTH.js"}