@fayz-ai/plugin-financial 0.8.0 → 0.8.3

package/dist/FinancialContext.d.ts

@@ -34,6 +34,12 @@ export interface ResolvedFinancialConfig {
     entityLookups: EntityLookupMap;
     contactLookup?: EntityLookup;
     onBookingClick?: (orderId: string) => void;
+    /** Internal nav item id → access feature id, exactly as the APP declared it
+     *  (`options.navFeatureMap`; empty when the app gates nothing — the plugin
+     *  ships no defaults). Drives BOTH the sub-module link paywall
+     *  (`useModuleNavAccess`) and the matching content gate, so the two can't
+     *  drift. Unmapped ids are ungated. */
+    navFeatureMap: Record<string, string>;
 }
 export declare const FinancialContextProvider: import("react").FC<{
     config: ResolvedFinancialConfig;

package/dist/FinancialContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FinancialContext.d.ts","sourceRoot":"","sources":["../src/FinancialContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuB,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AACjI,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAM/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,OAAO,CAAA;IACpB,aAAa,EAAE,OAAO,CAAA;IACtB,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE,OAAO,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;IACd,mGAAmG;IACnG,cAAc,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,gBAAgB,CAAA;IACzB,oFAAoF;IACpF,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,qBAAqB,CAAA;IAC7B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,sBAAsB,EAAE,OAAO,CAAA;IAC/B,aAAa,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACvD,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,aAAa,EAAE,eAAe,CAAA;IAC9B,aAAa,CAAC,EAAE,YAAY,CAAA;IAC5B,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC3C;AAID,eAAO,MAAM,wBAAwB;;;;;EAAsB,CAAA;AAC3D,eAAO,MAAM,kBAAkB,+BAAgB,CAAA;AAC/C,eAAO,MAAM,oBAAoB,6BAAkB,CAAA;AACnD,eAAO,MAAM,iBAAiB,oDAAe,CAAA;AAE7C,OAAO,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"FinancialContext.d.ts","sourceRoot":"","sources":["../src/FinancialContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuB,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AACjI,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAM/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,OAAO,CAAA;IACpB,aAAa,EAAE,OAAO,CAAA;IACtB,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE,OAAO,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;IACd,mGAAmG;IACnG,cAAc,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,gBAAgB,CAAA;IACzB,oFAAoF;IACpF,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,qBAAqB,CAAA;IAC7B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,sBAAsB,EAAE,OAAO,CAAA;IAC/B,aAAa,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACvD,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,aAAa,EAAE,eAAe,CAAA;IAC9B,aAAa,CAAC,EAAE,YAAY,CAAA;IAC5B,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C;;;;2CAIuC;IACvC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC;AAID,eAAO,MAAM,wBAAwB;;;;;EAAsB,CAAA;AAC3D,eAAO,MAAM,kBAAkB,+BAAgB,CAAA;AAC/C,eAAO,MAAM,oBAAoB,6BAAkB,CAAA;AACnD,eAAO,MAAM,iBAAiB,oDAAe,CAAA;AAE7C,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/FinancialPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FinancialPage.d.ts","sourceRoot":"","sources":["../src/FinancialPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoD,MAAM,OAAO,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAG/C,OAAO,EAA4B,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAC3F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,eAAe,CAAA;AAsBzE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAA;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAqHD,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;IACrE,MAAM,EAAE,uBAAuB,CAAA;IAC/B,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IACjC,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAA;CACjC,qBAuMA"}
+{"version":3,"file":"FinancialPage.d.ts","sourceRoot":"","sources":["../src/FinancialPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoD,MAAM,OAAO,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAG/C,OAAO,EAA4B,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAC3F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,eAAe,CAAA;AAsBzE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAA;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AA6HD,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;IACrE,MAAM,EAAE,uBAAuB,CAAA;IAC/B,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IACjC,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAA;CACjC,qBA2OA"}

package/dist/components/FinancialGeneralSettings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FinancialGeneralSettings.d.ts","sourceRoot":"","sources":["../../src/components/FinancialGeneralSettings.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,wBAAgB,wBAAwB,sBAqBvC"}
+{"version":3,"file":"FinancialGeneralSettings.d.ts","sourceRoot":"","sources":["../../src/components/FinancialGeneralSettings.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAgBzB,wBAAgB,wBAAwB,sBAsBvC"}

package/dist/data/supabase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/data/supabase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AA0JpD,wBAAgB,+BAA+B,IAAI,qBAAqB,CAytBvE"}
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/data/supabase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AA0JpD,wBAAgB,+BAA+B,IAAI,qBAAqB,CA8tBvE"}

package/dist/index.cjs

@@ -273,6 +273,8 @@ function QuickTransactionForm({ open, onOpenChange, defaultType = "expense", def
   const { currency } = useFinancialConfig();
   const provider = useFinancialProvider();
   const createQuickTransaction = useFinancialStore((s) => s.createQuickTransaction);
+  const guardMovements = saas.useLimitGuard("movements_month");
+  const can = saas.usePermissionOptional();
   const [type, setType] = React17.useState(defaultType);
   const [amount, setAmount] = React17.useState(0);
   const [amountStr, setAmountStr] = React17.useState("");
@@ -358,12 +360,14 @@ function QuickTransactionForm({ open, onOpenChange, defaultType = "expense", def
   }
   const canSave = amount > 0 && !saving && (type === "transfer" ? !!accountId && !!toAccountId && accountId !== toAccountId : true);
   async function handleSave() {
+    if (!can("financial", "create")) return;
     if (!canSave) {
       if (type === "transfer" && accountId && accountId === toAccountId) {
         ui.toast.error(t2("financial.transfer.sameAccount"));
       }
       return;
     }
+    if (await guardMovements(type === "transfer" ? 2 : 1) === "blocked") return;
     setSaving(true);
     try {
       await createQuickTransaction({
@@ -378,6 +382,7 @@ function QuickTransactionForm({ open, onOpenChange, defaultType = "expense", def
         recurring: type === "transfer" ? false : recurring,
         receiptUrl: type === "transfer" ? void 0 : receiptUrl
       });
+      saas.invalidateLimit("movements_month");
       onOpenChange(false);
     } catch {
     } finally {
@@ -666,6 +671,23 @@ var STATUS_OPTIONS = [
   { value: "overdue", labelKey: "financial.invoice.statusOverdue", color: "bg-destructive-soft text-destructive-soft-foreground", icon: lucideReact.CircleAlert },
   { value: "cancelled", labelKey: "financial.invoice.statusCancelled", color: "bg-muted text-muted-foreground", icon: lucideReact.Ban }
 ];
+var isoDate = (d) => `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+function presetRange(preset) {
+  const now2 = /* @__PURE__ */ new Date();
+  switch (preset) {
+    case "thisMonth":
+      return { from: isoDate(new Date(now2.getFullYear(), now2.getMonth(), 1)), to: isoDate(new Date(now2.getFullYear(), now2.getMonth() + 1, 0)) };
+    case "lastMonth":
+      return { from: isoDate(new Date(now2.getFullYear(), now2.getMonth() - 1, 1)), to: isoDate(new Date(now2.getFullYear(), now2.getMonth(), 0)) };
+    case "last30": {
+      const from = new Date(now2);
+      from.setDate(from.getDate() - 29);
+      return { from: isoDate(from), to: isoDate(now2) };
+    }
+    case "thisYear":
+      return { from: isoDate(new Date(now2.getFullYear(), 0, 1)), to: isoDate(new Date(now2.getFullYear(), 11, 31)) };
+  }
+}
 function StatusBadge({ status }) {
   const t2 = core.useTranslation();
   const opt = STATUS_OPTIONS.find((o) => o.value === status);
@@ -729,6 +751,8 @@ function useInvoiceColumns(currency) {
 }
 function InvoiceListView({ direction, onNew, onEdit }) {
   const t2 = core.useTranslation();
+  const can = saas.usePermissionOptional();
+  const onNewGated = can("financial", "create") ? onNew : void 0;
   const { currency } = useFinancialConfig();
   const provider = useFinancialProvider();
   const invoices = useFinancialStore((s) => s.invoices);
@@ -741,6 +765,25 @@ function InvoiceListView({ direction, onNew, onEdit }) {
   const [costCenterId, setCostCenterId] = React17.useState("");
   const [accounts, setAccounts] = React17.useState([]);
   const [costCenters, setCostCenters] = React17.useState([]);
+  const [datePreset, setDatePreset] = React17.useState("all");
+  const [dateFrom, setDateFrom] = React17.useState("");
+  const [dateTo, setDateTo] = React17.useState("");
+  const dateRange = React17.useMemo(() => {
+    if (!dateFrom && !dateTo) return void 0;
+    return { from: dateFrom || "0001-01-01", to: dateTo || "9999-12-31" };
+  }, [dateFrom, dateTo]);
+  const applyPreset = (value) => {
+    setDatePreset(value);
+    if (value === "all") {
+      setDateFrom("");
+      setDateTo("");
+      return;
+    }
+    if (value === "custom") return;
+    const range = presetRange(value);
+    setDateFrom(range.from);
+    setDateTo(range.to);
+  };
   React17.useEffect(() => {
     let active = true;
     Promise.all([provider.getChartOfAccounts(), provider.getCostCenters()]).then(([accountRows, costCenterRows]) => {
@@ -762,9 +805,10 @@ function InvoiceListView({ direction, onNew, onEdit }) {
       status: statusFilter.length > 0 ? statusFilter : void 0,
       search: search || void 0,
       accountId: accountId || void 0,
-      costCenterId: costCenterId || void 0
+      costCenterId: costCenterId || void 0,
+      dateRange
     });
-  }, [direction, statusFilter, search, accountId, costCenterId]);
+  }, [direction, statusFilter, search, accountId, costCenterId, dateRange]);
   const filtered = invoices.filter((inv) => inv.direction === direction);
   const listTitle = direction === "debit" ? t2("financial.invoice.accountsPayable") : t2("financial.invoice.accountsReceivable");
   const columns = useInvoiceColumns(currency);
@@ -794,7 +838,67 @@ function InvoiceListView({ direction, onNew, onEdit }) {
         subtitle: t2("financial.invoice.invoices", { count: filtered.length })
       }
     ),
-    (accounts.length > 0 || costCenters.length > 0) && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-wrap items-end gap-3 rounded-lg border bg-muted/20 px-4 py-3", children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-wrap items-end gap-3 rounded-lg border bg-muted/20 px-4 py-3", children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("label", { className: "flex min-w-[180px] flex-col gap-1 text-xs font-medium text-muted-foreground", children: [
+        t2("financial.invoice.filterPeriod"),
+        /* @__PURE__ */ jsxRuntime.jsxs(
+          "select",
+          {
+            className: "h-9 rounded-md border bg-background px-3 text-sm text-foreground",
+            value: datePreset,
+            onChange: (event) => applyPreset(event.target.value),
+            children: [
+              /* @__PURE__ */ jsxRuntime.jsx("option", { value: "all", children: t2("financial.invoice.filterAllPeriods") }),
+              /* @__PURE__ */ jsxRuntime.jsx("option", { value: "thisMonth", children: t2("financial.invoice.filterThisMonth") }),
+              /* @__PURE__ */ jsxRuntime.jsx("option", { value: "lastMonth", children: t2("financial.invoice.filterLastMonth") }),
+              /* @__PURE__ */ jsxRuntime.jsx("option", { value: "last30", children: t2("financial.invoice.filterLast30") }),
+              /* @__PURE__ */ jsxRuntime.jsx("option", { value: "thisYear", children: t2("financial.invoice.filterThisYear") }),
+              /* @__PURE__ */ jsxRuntime.jsx("option", { value: "custom", children: t2("financial.invoice.filterCustom") })
+            ]
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsxs("label", { className: "flex flex-col gap-1 text-xs font-medium text-muted-foreground", children: [
+        t2("financial.invoice.filterFrom"),
+        /* @__PURE__ */ jsxRuntime.jsx(
+          "input",
+          {
+            type: "date",
+            className: "h-9 rounded-md border bg-background px-3 text-sm text-foreground",
+            value: dateFrom,
+            max: dateTo || void 0,
+            onChange: (event) => {
+              setDateFrom(event.target.value);
+              setDatePreset("custom");
+            }
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsxs("label", { className: "flex flex-col gap-1 text-xs font-medium text-muted-foreground", children: [
+        t2("financial.invoice.filterTo"),
+        /* @__PURE__ */ jsxRuntime.jsx(
+          "input",
+          {
+            type: "date",
+            className: "h-9 rounded-md border bg-background px-3 text-sm text-foreground",
+            value: dateTo,
+            min: dateFrom || void 0,
+            onChange: (event) => {
+              setDateTo(event.target.value);
+              setDatePreset("custom");
+            }
+          }
+        )
+      ] }),
+      (dateFrom || dateTo) && /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          className: "h-9 rounded-md px-2 text-xs font-medium text-muted-foreground hover:text-foreground",
+          onClick: () => applyPreset("all"),
+          children: t2("financial.invoice.filterClear")
+        }
+      ),
       accounts.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("label", { className: "flex min-w-[220px] flex-col gap-1 text-xs font-medium text-muted-foreground", children: [
         t2("financial.invoice.filterAccount"),
         /* @__PURE__ */ jsxRuntime.jsxs(
@@ -848,12 +952,12 @@ function InvoiceListView({ direction, onNew, onEdit }) {
         activeTag: statusFilter.length === 1 ? statusFilter[0] : void 0,
         onTagChange: (v) => setStatusFilter(v ? [v] : []),
         newLabel: t2("financial.invoice.new"),
-        onNew,
+        onNew: onNewGated,
         onRowClick: (row) => onEdit?.(row.id),
         emptyIcon: lucideReact.FileText,
         emptyMessage: t2("financial.invoice.noInvoices"),
-        emptyActionLabel: onNew ? t2("financial.invoice.createFirst") : void 0,
-        onEmptyAction: onNew
+        emptyActionLabel: onNewGated ? t2("financial.invoice.createFirst") : void 0,
+        onEmptyAction: onNewGated
       }
     ),
     filtered.length > 0 && !invoicesLoading && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-end gap-6 rounded-lg border bg-muted/30 px-5 py-3 text-sm", children: [
@@ -1193,6 +1297,8 @@ function InvoiceFormView({ direction, editId, onSaved }) {
   const hasItemLookups = itemTypes.some((tp) => config.entityLookups[tp.value]);
   const defaultItemKind = itemTypes.find((tp) => tp.value === "other")?.value ?? itemTypes.find((tp) => !config.entityLookups[tp.value])?.value ?? itemTypes[0]?.value ?? "other";
   const createInvoice = useFinancialStore((s) => s.createInvoice);
+  const guardMovements = saas.useLimitGuard("movements_month");
+  const can = saas.usePermissionOptional();
   const hasLocations = locations.length > 0;
   const isEdit = !!editId;
   const [loaded, setLoaded] = React17.useState(!editId);
@@ -1330,10 +1436,12 @@ function InvoiceFormView({ direction, editId, onSaved }) {
     setInstallments(inst);
   }
   async function handleSave() {
+    if (!isEdit && !can("financial", "create")) return;
     if (items.length === 0) {
       ui.toast.error(t2("common.formIncomplete"));
       return;
     }
+    if (!isEdit && await guardMovements(Math.max(1, installments.length)) === "blocked") return;
     setSaving(true);
     try {
       const movInputs = installments.map((inst, i) => ({
@@ -1375,6 +1483,7 @@ function InvoiceFormView({ direction, editId, onSaved }) {
           items: items.map(({ _id, ...rest }) => rest),
           installments: movInputs
         });
+        saas.invalidateLimit("movements_month");
         onSaved?.(invoice.id);
       }
     } finally {
@@ -3516,7 +3625,7 @@ function CardsView() {
                 /* @__PURE__ */ jsxRuntime.jsx("span", { children: t2("financial.cards.dueOn", { day: String(card.dueDay) }) })
               ] })
             ] }),
-            /* @__PURE__ */ jsxRuntime.jsxs(
+            /* @__PURE__ */ jsxRuntime.jsx(saas.PermissionGate, { feature: "financial", action: "create", children: /* @__PURE__ */ jsxRuntime.jsxs(
               "button",
               {
                 type: "button",
@@ -3527,7 +3636,7 @@ function CardsView() {
                   t2("financial.cards.addExpense")
                 ]
               }
-            )
+            ) })
           ] })
         ] }, card.id);
       }) })
@@ -3688,28 +3797,31 @@ function ReconciliationView() {
     ] })
   ] });
 }
+var FINANCIAL_DEFAULTS = {
+  autoInstallments: true,
+  requireDoc: false,
+  allowPartial: true,
+  requireOpening: true,
+  autoClose: false,
+  overdueAlerts: true,
+  dailySummary: false
+};
 function FinancialGeneralSettings() {
   const t2 = core.useTranslation();
+  const s = saas.useTenantPluginSettings("financial", FINANCIAL_DEFAULTS);
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-4", children: [
     /* @__PURE__ */ jsxRuntime.jsxs(saas.SettingsGroup, { title: t2("financial.settings.invoices"), description: t2("financial.settings.invoicesDesc"), children: [
-      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.autoInstallments"), description: t2("financial.settings.autoInstallmentsDesc"), checked: true, onChange: () => {
-      } }),
-      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.requireDoc"), description: t2("financial.settings.requireDocDesc"), checked: false, onChange: () => {
-      } }),
-      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.allowPartial"), description: t2("financial.settings.allowPartialDesc"), checked: true, onChange: () => {
-      } })
+      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.autoInstallments"), description: t2("financial.settings.autoInstallmentsDesc"), checked: s.get("autoInstallments"), onChange: (v) => s.set("autoInstallments", v) }),
+      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.requireDoc"), description: t2("financial.settings.requireDocDesc"), checked: s.get("requireDoc"), onChange: (v) => s.set("requireDoc", v) }),
+      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.allowPartial"), description: t2("financial.settings.allowPartialDesc"), checked: s.get("allowPartial"), onChange: (v) => s.set("allowPartial", v) })
     ] }),
     /* @__PURE__ */ jsxRuntime.jsxs(saas.SettingsGroup, { title: t2("financial.settings.cashRegister"), description: t2("financial.settings.cashRegisterDesc"), children: [
-      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.requireOpening"), description: t2("financial.settings.requireOpeningDesc"), checked: true, onChange: () => {
-      } }),
-      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.autoClose"), description: t2("financial.settings.autoCloseDesc"), checked: false, onChange: () => {
-      } })
+      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.requireOpening"), description: t2("financial.settings.requireOpeningDesc"), checked: s.get("requireOpening"), onChange: (v) => s.set("requireOpening", v) }),
+      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.autoClose"), description: t2("financial.settings.autoCloseDesc"), checked: s.get("autoClose"), onChange: (v) => s.set("autoClose", v) })
     ] }),
     /* @__PURE__ */ jsxRuntime.jsxs(saas.SettingsGroup, { title: t2("financial.settings.notifications"), description: t2("financial.settings.notificationsDesc"), children: [
-      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.overdueAlerts"), description: t2("financial.settings.overdueAlertsDesc"), checked: true, onChange: () => {
-      } }),
-      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.dailySummary"), description: t2("financial.settings.dailySummaryDesc"), checked: false, onChange: () => {
-      } })
+      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.overdueAlerts"), description: t2("financial.settings.overdueAlertsDesc"), checked: s.get("overdueAlerts"), onChange: (v) => s.set("overdueAlerts", v) }),
+      /* @__PURE__ */ jsxRuntime.jsx(saas.ToggleRow, { label: t2("financial.settings.dailySummary"), description: t2("financial.settings.dailySummaryDesc"), checked: s.get("dailySummary"), onChange: (v) => s.set("dailySummary", v) })
     ] })
   ] });
 }
@@ -3850,6 +3962,10 @@ function buildNav(config, activeView, navigate, t2) {
       ]
     });
   }
+  for (const item of items) {
+    const feature = config.navFeatureMap[item.id];
+    if (feature) item.feature = feature;
+  }
   return items;
 }
 function FinancialPage({ config, provider, store, registries }) {
@@ -3885,9 +4001,11 @@ function FinancialPage({ config, provider, store, registries }) {
     };
   }, [onboardingComplete, provider]);
   const t2 = core.useTranslation();
+  const can = saas.usePermissionOptional();
+  const canCreate = can("financial", "create");
   const intent = parseIntent(view);
   const isSettings = view === "settings";
-  const nav = buildNav(config, view, navigate, t2);
+  const nav = saas.useModuleNavAccess(buildNav(config, view, navigate, t2));
   const [quickAddOpen, setQuickAddOpen] = React17.useState(false);
   const [quickAddType, setQuickAddType] = React17.useState("expense");
   const [quickAddReceipt, setQuickAddReceipt] = React17.useState(false);
@@ -3901,12 +4019,14 @@ function FinancialPage({ config, provider, store, registries }) {
     if (!pendingQuickAdd) return;
     const req = consumeQuickAdd();
     if (!req) return;
+    if (!canCreate) return;
     setQuickAddType(req.type);
     setQuickAddReceipt(req.receipt);
     setQuickAddOpen(true);
   }, [pendingQuickAdd]);
   const quickActions = React17.useMemo(() => {
     if (config.quickAdd) return [];
+    if (!canCreate) return [];
     const actions = [];
     if (config.modules.payables) {
       actions.push({
@@ -3936,7 +4056,7 @@ function FinancialPage({ config, provider, store, registries }) {
       });
     }
     return actions;
-  }, [config.modules, config.quickAdd]);
+  }, [config.modules, config.quickAdd, canCreate, navigate, t2]);
   function handleOnboardingComplete() {
     setOnboardingComplete(true);
     try {
@@ -3980,6 +4100,11 @@ function FinancialPage({ config, provider, store, registries }) {
         return /* @__PURE__ */ jsxRuntime.jsx(SummaryView, {});
     }
   }
+  function renderGatedView() {
+    const feature = config.navFeatureMap[intent.view];
+    if (!feature) return renderView();
+    return /* @__PURE__ */ jsxRuntime.jsx(saas.EntitlementGate, { feature, fallback: /* @__PURE__ */ jsxRuntime.jsx(saas.UpgradePrompt, { feature }), children: renderView() });
+  }
   return /* @__PURE__ */ jsxRuntime.jsx(FinancialContextProvider, { config, provider, store, children: /* @__PURE__ */ jsxRuntime.jsxs(
     ui.ModulePage,
     {
@@ -3994,7 +4119,8 @@ function FinancialPage({ config, provider, store, registries }) {
         // add affordance in B2C mode. The receipt entry point lives inside the
         // sheet's "Fotografar ou anexar recibo" attachment step, so no separate
         // "Enviar recibo" button is needed here.
-        /* @__PURE__ */ jsxRuntime.jsxs(
+        // Gated on the role's `create` action so read-only members don't see it.
+        /* @__PURE__ */ jsxRuntime.jsx(saas.PermissionGate, { feature: "financial", action: "create", children: /* @__PURE__ */ jsxRuntime.jsxs(
           ui.Button,
           {
             size: "sm",
@@ -4005,7 +4131,7 @@ function FinancialPage({ config, provider, store, registries }) {
               t2("financial.quickTx.newTransaction")
             ]
           }
-        ),
+        ) }),
         /* @__PURE__ */ jsxRuntime.jsx(
           saas.ModuleActionBar,
           {
@@ -4016,7 +4142,7 @@ function FinancialPage({ config, provider, store, registries }) {
         )
       ] }),
       children: [
-        renderView(),
+        renderGatedView(),
         /* @__PURE__ */ jsxRuntime.jsx(
           QuickTransactionForm,
           {
@@ -5175,7 +5301,10 @@ function createSupabaseFinancialProvider() {
       }
       if (query.contactId) qb = qb.eq("party_id", query.contactId);
       if (query.search) qb = qb.ilike("notes", `%${query.search}%`);
-      if (query.dateRange) qb = qb.gte("created_at", query.dateRange.from).lte("created_at", query.dateRange.to);
+      if (query.dateRange) {
+        const to = query.dateRange.to.length === 10 ? `${query.dateRange.to}T23:59:59.999` : query.dateRange.to;
+        qb = qb.gte("created_at", query.dateRange.from).lte("created_at", to);
+      }
       const page = query.page ?? 1;
       const pageSize = query.pageSize ?? 50;
       qb = qb.range((page - 1) * pageSize, page * pageSize - 1).order("created_at", { ascending: false });
@@ -6412,6 +6541,16 @@ var en = {
   "financial.invoice.filterAllAccounts": "All accounts",
   "financial.invoice.filterCostCenter": "Cost center",
   "financial.invoice.filterAllCostCenters": "All cost centers",
+  "financial.invoice.filterPeriod": "Period",
+  "financial.invoice.filterAllPeriods": "All time",
+  "financial.invoice.filterThisMonth": "This month",
+  "financial.invoice.filterLastMonth": "Last month",
+  "financial.invoice.filterLast30": "Last 30 days",
+  "financial.invoice.filterThisYear": "This year",
+  "financial.invoice.filterCustom": "Custom",
+  "financial.invoice.filterFrom": "From",
+  "financial.invoice.filterTo": "To",
+  "financial.invoice.filterClear": "Clear",
   "financial.reconciliation.title": "Reconciliation",
   "financial.reconciliation.subtitle": "Match imported bank lines to your movements",
   "financial.reconciliation.pending": "{{count}} to reconcile",
@@ -6895,6 +7034,16 @@ var ptBR = {
   "financial.invoice.filterAllAccounts": "Todos os planos",
   "financial.invoice.filterCostCenter": "Centro de custo",
   "financial.invoice.filterAllCostCenters": "Todos os centros",
+  "financial.invoice.filterPeriod": "Per\xEDodo",
+  "financial.invoice.filterAllPeriods": "Todo o per\xEDodo",
+  "financial.invoice.filterThisMonth": "Este m\xEAs",
+  "financial.invoice.filterLastMonth": "M\xEAs passado",
+  "financial.invoice.filterLast30": "\xDAltimos 30 dias",
+  "financial.invoice.filterThisYear": "Este ano",
+  "financial.invoice.filterCustom": "Personalizado",
+  "financial.invoice.filterFrom": "De",
+  "financial.invoice.filterTo": "At\xE9",
+  "financial.invoice.filterClear": "Limpar",
   "financial.reconciliation.title": "Concilia\xE7\xE3o",
   "financial.reconciliation.subtitle": "Concilie as linhas importadas do banco com seus lan\xE7amentos",
   "financial.reconciliation.pending": "{{count}} para conciliar",
@@ -7364,6 +7513,15 @@ var DEFAULT_LABELS = {
   cardsReconciliation: "Reconciliation"
 };
 var DEFAULT_CURRENCY = { code: "BRL", locale: "pt-BR", symbol: "R$" };
+var FINANCIAL_NAV_FEATURES = {
+  reconciliation: "fin_reconciliation",
+  cards: "fin_cards",
+  commissions: "fin_commissions",
+  statements: "fin_statements",
+  receivables: "fin_receivables",
+  payables: "fin_payables",
+  "cash-registers": "fin_cash_registers"
+};
 var DEFAULT_ITEM_TYPES = [
   { value: "service", label: "Service", icon: "Briefcase" },
   { value: "product", label: "Product", icon: "Package" },
@@ -7394,7 +7552,8 @@ function resolveConfig(options) {
     locations: options?.locations ?? [],
     entityLookups: options?.entityLookups ?? {},
     contactLookup: options?.contactLookup,
-    onBookingClick: options?.onBookingClick
+    onBookingClick: options?.onBookingClick,
+    navFeatureMap: { ...options?.navFeatureMap }
   };
 }
 function createFinancialPlugin(options) {
@@ -7422,6 +7581,70 @@ function createFinancialPlugin(options) {
       ...config.modules.payables ? [{ id: "financial.payables", label: config.labels.payables, group: config.labels.pageTitle }] : [],
       ...config.modules.commissions ? [{ id: "financial.commissions", label: config.labels.commissions, group: config.labels.pageTitle }] : []
     ],
+    // Recurring monthly quota — counts financial movement rows created this
+    // month (invoices write one per installment; quick transactions one, or two
+    // for a transfer).
+    declaredLimits: [
+      { key: "movements_month", label: "Financial movements this month", table: "plg_financial_movements", period: "month" }
+    ],
+    queryEntities: [
+      {
+        key: "financial:invoices",
+        entity: {
+          name: "Invoice",
+          namePlural: "Invoices (receipts REC- / payables PAG-)",
+          icon: "Receipt",
+          permission: { feature: "financial", action: "read" },
+          fields: [
+            { key: "referenceNumber", label: "Reference (REC-/PAG-)", type: "text", searchable: true },
+            { key: "flow", label: "Flow (receivable/payable)", type: "text" },
+            { key: "amount", label: "Amount", type: "number" },
+            { key: "paid", label: "Paid", type: "number" },
+            { key: "balance", label: "Balance", type: "number" },
+            { key: "status", label: "Status", type: "text" },
+            { key: "createdAt", label: "Created at", type: "text" }
+          ],
+          data: {
+            table: "v_invoice_balances",
+            tenantScoped: true,
+            searchColumns: ["reference_number"]
+          }
+        }
+      },
+      {
+        key: "financial:movements",
+        entity: {
+          name: "Financial movement",
+          namePlural: "Financial movements (installment ledger)",
+          icon: "Banknote",
+          permission: { feature: "financial", action: "read" },
+          fields: [
+            { key: "direction", label: "Direction", type: "text" },
+            { key: "movementKind", label: "Kind (bill/payment)", type: "text" },
+            { key: "amount", label: "Amount", type: "number" },
+            { key: "paidAmount", label: "Paid amount", type: "number" },
+            { key: "status", label: "Status", type: "text" },
+            { key: "dueDate", label: "Due date", type: "text" },
+            { key: "paymentDate", label: "Payment date", type: "text" },
+            { key: "installmentNumber", label: "Installment", type: "number" },
+            { key: "cardInstallments", label: "Card installments", type: "number" },
+            { key: "createdAt", label: "Created at", type: "text" }
+          ],
+          data: {
+            table: "plg_financial_movements",
+            tenantScoped: true
+          }
+        }
+      }
+    ],
+    declaredRpcs: [
+      {
+        name: "agent_financial_mark_payment_received",
+        kind: "write",
+        description: "Guarded settle: invoices the order via fn_invoice_from_order (installments for credit card) and marks the receivable paid, audited with the acting user.",
+        audits: true
+      }
+    ],
     navigation: [
       {
         section: options?.navSection ?? "main",
@@ -7475,6 +7698,7 @@ function createFinancialPlugin(options) {
         description: "Creates a new invoice/payable for a contact.",
         icon: "FileText",
         mode: "persist",
+        limitKey: "movements_month",
         category: "Finance",
         parameters: {
           type: "object",
@@ -7490,6 +7714,33 @@ function createFinancialPlugin(options) {
         ],
         permission: { feature: "financial", action: "create" }
       },
+      {
+        id: "financial.mark-payment-received",
+        name: "markPaymentReceived",
+        description: 'Marks an order/appointment as paid: invoices it (with installments for credit card, e.g. "cart\xE3o 2x") and settles the receivable. Resolve the booking or order id via search tools first.',
+        icon: "BadgeDollarSign",
+        mode: "persist",
+        execution: { plane: "server", kind: "rpc", rpc: "agent_financial_mark_payment_received" },
+        category: "Finance",
+        parameters: {
+          type: "object",
+          properties: {
+            booking_id: { type: "string", description: "Appointment id (alternative to order_id)" },
+            order_id: { type: "string", description: "Order id" },
+            method: {
+              type: "string",
+              description: "Payment method",
+              enum: ["cash", "pix", "credit_card", "debit_card", "transfer"]
+            },
+            installments: { type: "number", description: 'Credit-card installments (1-12), e.g. 2 for "cart\xE3o 2x"' }
+          },
+          required: ["method"]
+        },
+        suggestions: [
+          { label: "Marcar o atendimento como pago no cart\xE3o em 2x" }
+        ],
+        permission: { feature: "financial.receivables", action: "update" }
+      },
       {
         id: "financial.list-payables",
         name: "listPayables",
@@ -7537,6 +7788,7 @@ function createFinancialPlugin(options) {
   };
 }
 
+exports.FINANCIAL_NAV_FEATURES = FINANCIAL_NAV_FEATURES;
 exports.createFinancialPlugin = createFinancialPlugin;
 exports.createMockFinancialProvider = createMockFinancialProvider;
 exports.createSafeFinancialProvider = createSafeFinancialProvider;