@classytic/commerce-sdk 0.1.1 → 0.2.1

package/dist/accounting/hooks/budget.d.ts

@@ -0,0 +1,39 @@
+import { Budget, BudgetSummary, CreateBudgetPayload, UpdateBudgetPayload } from "../types/index.js";
+import * as _classytic_arc_next_mutation0 from "@classytic/arc-next/mutation";
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+import * as _classytic_arc_next_query0 from "@classytic/arc-next/query";
+import * as _classytic_arc_next0 from "@classytic/arc-next";
+
+//#region src/accounting/hooks/budget.d.ts
+declare const budgetHooks: _classytic_arc_next0.CrudHooksReturn<Budget, CreateBudgetPayload, UpdateBudgetPayload>;
+declare const BUDGET_KEYS: _classytic_arc_next_query0.QueryKeys, useBudgets: {
+    (params?: Record<string, unknown>, options?: _classytic_arc_next_query0.ListQueryOptions<Budget> | undefined): _classytic_arc_next_query0.ListQueryResult<Budget>;
+    (token: string | null, params?: Record<string, unknown>, options?: _classytic_arc_next_query0.ListQueryOptions<Budget> | undefined): _classytic_arc_next_query0.ListQueryResult<Budget>;
+  }, useBudgetDetail: {
+    (id: string | null, options?: _classytic_arc_next_query0.DetailQueryOptions<Budget> | undefined): _classytic_arc_next_query0.DetailQueryResult<Budget>;
+    (id: string | null, token: string | null, options?: _classytic_arc_next_query0.DetailQueryOptions<Budget> | undefined): _classytic_arc_next_query0.DetailQueryResult<Budget>;
+  }, useBudgetActions: () => _classytic_arc_next0.CrudActions<Budget, CreateBudgetPayload, UpdateBudgetPayload>;
+/** State transitions: submit, approve, reject, close */
+declare function useBudgetStateActions(): {
+  submit: _tanstack_react_query0.UseMutateFunction<unknown, Error, string>;
+  approve: _tanstack_react_query0.UseMutateFunction<unknown, Error, string>;
+  reject: _tanstack_react_query0.UseMutateFunction<unknown, Error, {
+    id: string;
+    reason?: string;
+  }>;
+  close: _tanstack_react_query0.UseMutateFunction<unknown, Error, string>;
+  isSubmitting: boolean;
+  isApproving: boolean;
+  isRejecting: boolean;
+  isClosing: boolean;
+};
+/** Bulk create budgets */
+declare function useBudgetBulkCreate(): _classytic_arc_next_mutation0.TransitionMutationReturn<unknown, {
+  items: CreateBudgetPayload[];
+}>;
+/** Budget summary by status — unwraps `{ success, data }` envelope */
+declare function useBudgetSummary(options?: {
+  enabled?: boolean;
+}): _tanstack_react_query0.UseQueryResult<BudgetSummary | undefined, Error>;
+//#endregion
+export { BUDGET_KEYS, budgetHooks, useBudgetActions, useBudgetBulkCreate, useBudgetDetail, useBudgetStateActions, useBudgetSummary, useBudgets };

package/dist/accounting/hooks/budget.js

@@ -0,0 +1,106 @@
+"use client";
+
+import { createCrudHooks } from "../../core/react/crud.factory.js";
+import { budgetApi } from "../api/budget.js";
+import { useQuery } from "@tanstack/react-query";
+
+//#region src/accounting/hooks/budget.ts
+/**
+* Budget Hooks — CRUD + Approval Workflow (Enterprise Mode)
+*
+* CRUD (useBudgets, useBudgetDetail, useBudgetActions) via arc-next createCrudHooks.
+* State transitions + aggregates use budgetHooks.useCustomMutation for consistency.
+*/
+const budgetHooks = createCrudHooks({
+	api: budgetApi,
+	entityKey: "budgets",
+	singular: "Budget",
+	plural: "Budgets",
+	defaults: { staleTime: 300 * 1e3 }
+});
+const { KEYS: BUDGET_KEYS, useList: useBudgets, useDetail: useBudgetDetail, useActions: useBudgetActions } = budgetHooks;
+/** State transitions: submit, approve, reject, close */
+function useBudgetStateActions() {
+	const submitMutation = budgetHooks.useCustomMutation({
+		mutationFn: (id) => budgetApi.submit({
+			token: "",
+			id
+		}),
+		invalidateQueries: [BUDGET_KEYS.all],
+		messages: {
+			success: "Budget submitted for approval",
+			error: "Failed to submit budget"
+		}
+	});
+	const approveMutation = budgetHooks.useCustomMutation({
+		mutationFn: (id) => budgetApi.approve({
+			token: "",
+			id
+		}),
+		invalidateQueries: [BUDGET_KEYS.all],
+		messages: {
+			success: "Budget approved",
+			error: "Failed to approve budget"
+		}
+	});
+	const rejectMutation = budgetHooks.useCustomMutation({
+		mutationFn: ({ id, reason }) => budgetApi.reject({
+			token: "",
+			id,
+			reason
+		}),
+		invalidateQueries: [BUDGET_KEYS.all],
+		messages: {
+			success: "Budget rejected",
+			error: "Failed to reject budget"
+		}
+	});
+	const closeMutation = budgetHooks.useCustomMutation({
+		mutationFn: (id) => budgetApi.close({
+			token: "",
+			id
+		}),
+		invalidateQueries: [BUDGET_KEYS.all],
+		messages: {
+			success: "Budget closed",
+			error: "Failed to close budget"
+		}
+	});
+	return {
+		submit: submitMutation.mutate,
+		approve: approveMutation.mutate,
+		reject: rejectMutation.mutate,
+		close: closeMutation.mutate,
+		isSubmitting: submitMutation.isPending,
+		isApproving: approveMutation.isPending,
+		isRejecting: rejectMutation.isPending,
+		isClosing: closeMutation.isPending
+	};
+}
+/** Bulk create budgets */
+function useBudgetBulkCreate() {
+	return budgetHooks.useCustomMutation({
+		mutationFn: (data) => budgetApi.bulkCreate({
+			token: "",
+			data
+		}),
+		invalidateQueries: [BUDGET_KEYS.all],
+		messages: {
+			success: "Budgets created",
+			error: "Bulk create failed"
+		}
+	});
+}
+/** Budget summary by status — unwraps `{ success, data }` envelope */
+function useBudgetSummary(options) {
+	return useQuery({
+		queryKey: [...BUDGET_KEYS.all, "summary"],
+		queryFn: () => budgetApi.summary({ token: "" }),
+		select: (res) => res.data,
+		enabled: options?.enabled ?? true,
+		staleTime: 120 * 1e3
+	});
+}
+
+//#endregion
+export { BUDGET_KEYS, budgetHooks, useBudgetActions, useBudgetBulkCreate, useBudgetDetail, useBudgetStateActions, useBudgetSummary, useBudgets };

package/dist/accounting/hooks/fiscal-period.d.ts

@@ -0,0 +1,22 @@
+import { CreateFiscalPeriodPayload, FiscalPeriod, UpdateFiscalPeriodPayload } from "../types/index.js";
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+import * as _classytic_arc_next_query0 from "@classytic/arc-next/query";
+import * as _classytic_arc_next0 from "@classytic/arc-next";
+
+//#region src/accounting/hooks/fiscal-period.d.ts
+declare const fiscalPeriodHooks: _classytic_arc_next0.CrudHooksReturn<FiscalPeriod, CreateFiscalPeriodPayload, UpdateFiscalPeriodPayload>;
+declare const FISCAL_PERIOD_KEYS: _classytic_arc_next_query0.QueryKeys, useFiscalPeriods: {
+    (params?: Record<string, unknown>, options?: _classytic_arc_next_query0.ListQueryOptions<FiscalPeriod> | undefined): _classytic_arc_next_query0.ListQueryResult<FiscalPeriod>;
+    (token: string | null, params?: Record<string, unknown>, options?: _classytic_arc_next_query0.ListQueryOptions<FiscalPeriod> | undefined): _classytic_arc_next_query0.ListQueryResult<FiscalPeriod>;
+  }, useFiscalPeriodDetail: {
+    (id: string | null, options?: _classytic_arc_next_query0.DetailQueryOptions<FiscalPeriod> | undefined): _classytic_arc_next_query0.DetailQueryResult<FiscalPeriod>;
+    (id: string | null, token: string | null, options?: _classytic_arc_next_query0.DetailQueryOptions<FiscalPeriod> | undefined): _classytic_arc_next_query0.DetailQueryResult<FiscalPeriod>;
+  }, useFiscalPeriodActions: () => _classytic_arc_next0.CrudActions<FiscalPeriod, CreateFiscalPeriodPayload, UpdateFiscalPeriodPayload>;
+declare function useFiscalPeriodStateActions(): {
+  close: _tanstack_react_query0.UseMutateFunction<unknown, Error, string>;
+  reopen: _tanstack_react_query0.UseMutateFunction<unknown, Error, string>;
+  isClosing: boolean;
+  isReopening: boolean;
+};
+//#endregion
+export { FISCAL_PERIOD_KEYS, fiscalPeriodHooks, useFiscalPeriodActions, useFiscalPeriodDetail, useFiscalPeriodStateActions, useFiscalPeriods };

package/dist/accounting/hooks/fiscal-period.js

@@ -0,0 +1,52 @@
+"use client";
+
+import { createCrudHooks } from "../../core/react/crud.factory.js";
+import { fiscalPeriodApi } from "../api/fiscal-period.js";
+
+//#region src/accounting/hooks/fiscal-period.ts
+/**
+* Fiscal Period Hooks — CRUD + Close/Reopen
+*
+* CRUD via arc-next createCrudHooks. State transitions use useCustomMutation.
+*/
+const fiscalPeriodHooks = createCrudHooks({
+	api: fiscalPeriodApi,
+	entityKey: "fiscal-periods",
+	singular: "Fiscal Period",
+	plural: "Fiscal Periods",
+	defaults: { staleTime: 300 * 1e3 }
+});
+const { KEYS: FISCAL_PERIOD_KEYS, useList: useFiscalPeriods, useDetail: useFiscalPeriodDetail, useActions: useFiscalPeriodActions } = fiscalPeriodHooks;
+function useFiscalPeriodStateActions() {
+	const closeMutation = fiscalPeriodHooks.useCustomMutation({
+		mutationFn: (id) => fiscalPeriodApi.close({
+			token: "",
+			id
+		}),
+		invalidateQueries: [FISCAL_PERIOD_KEYS.all],
+		messages: {
+			success: "Fiscal period closed",
+			error: "Failed to close period"
+		}
+	});
+	const reopenMutation = fiscalPeriodHooks.useCustomMutation({
+		mutationFn: (id) => fiscalPeriodApi.reopen({
+			token: "",
+			id
+		}),
+		invalidateQueries: [FISCAL_PERIOD_KEYS.all],
+		messages: {
+			success: "Fiscal period reopened",
+			error: "Failed to reopen period"
+		}
+	});
+	return {
+		close: closeMutation.mutate,
+		reopen: reopenMutation.mutate,
+		isClosing: closeMutation.isPending,
+		isReopening: reopenMutation.isPending
+	};
+}
+
+//#endregion
+export { FISCAL_PERIOD_KEYS, fiscalPeriodHooks, useFiscalPeriodActions, useFiscalPeriodDetail, useFiscalPeriodStateActions, useFiscalPeriods };

package/dist/accounting/hooks/index.d.ts

@@ -0,0 +1,6 @@
+import { ACCOUNT_KEYS, ACCOUNT_TYPE_KEYS, accountHooks, useAccountActions, useAccountBulkCreate, useAccountDetail, useAccountDisable, useAccountEnable, useAccountSeed, useAccountTypes, useAccounts } from "./account.js";
+import { JOURNAL_ENTRY_KEYS, journalEntryHooks, useJournalEntries, useJournalEntryActions, useJournalEntryDetail, useJournalEntryNavigation, useJournalEntryStateActions } from "./journal-entry.js";
+import { FISCAL_PERIOD_KEYS, fiscalPeriodHooks, useFiscalPeriodActions, useFiscalPeriodDetail, useFiscalPeriodStateActions, useFiscalPeriods } from "./fiscal-period.js";
+import { POSTING_KEYS, useBackfill, useCloseDay, useDayCloseOversight, usePostingStatus, useReopenDay } from "./posting.js";
+import { REPORT_KEYS, useBalanceSheet, useBudgetVsActual, useCashFlow, useGeneralLedger, useIncomeStatement, useTrialBalance } from "./reports.js";
+import { BUDGET_KEYS, budgetHooks, useBudgetActions, useBudgetBulkCreate, useBudgetDetail, useBudgetStateActions, useBudgetSummary, useBudgets } from "./budget.js";

package/dist/accounting/hooks/journal-entry.d.ts

@@ -0,0 +1,37 @@
+import { CreateJournalEntryPayload, JournalEntry, UpdateJournalEntryPayload } from "../types/index.js";
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+import * as _classytic_arc_next_query0 from "@classytic/arc-next/query";
+import * as _classytic_arc_next0 from "@classytic/arc-next";
+
+//#region src/accounting/hooks/journal-entry.d.ts
+declare const journalEntryHooks: _classytic_arc_next0.CrudHooksReturn<JournalEntry, CreateJournalEntryPayload, UpdateJournalEntryPayload>;
+declare const JOURNAL_ENTRY_KEYS: _classytic_arc_next_query0.QueryKeys, useJournalEntries: {
+    (params?: Record<string, unknown>, options?: _classytic_arc_next_query0.ListQueryOptions<JournalEntry> | undefined): _classytic_arc_next_query0.ListQueryResult<JournalEntry>;
+    (token: string | null, params?: Record<string, unknown>, options?: _classytic_arc_next_query0.ListQueryOptions<JournalEntry> | undefined): _classytic_arc_next_query0.ListQueryResult<JournalEntry>;
+  }, useJournalEntryDetail: {
+    (id: string | null, options?: _classytic_arc_next_query0.DetailQueryOptions<JournalEntry> | undefined): _classytic_arc_next_query0.DetailQueryResult<JournalEntry>;
+    (id: string | null, token: string | null, options?: _classytic_arc_next_query0.DetailQueryOptions<JournalEntry> | undefined): _classytic_arc_next_query0.DetailQueryResult<JournalEntry>;
+  }, useJournalEntryActions: () => _classytic_arc_next0.CrudActions<JournalEntry, CreateJournalEntryPayload, UpdateJournalEntryPayload>, useJournalEntryNavigation: () => _classytic_arc_next0.NavigateFn<JournalEntry>;
+declare function useJournalEntryStateActions(): {
+  post: _tanstack_react_query0.UseMutateFunction<unknown, Error, string>;
+  postAsync: _tanstack_react_query0.UseMutateAsyncFunction<unknown, Error, string>;
+  reverse: _tanstack_react_query0.UseMutateFunction<unknown, Error, {
+    id: string;
+    reversalDate?: string;
+  }>;
+  reverseAsync: _tanstack_react_query0.UseMutateAsyncFunction<unknown, Error, {
+    id: string;
+    reversalDate?: string;
+  }>;
+  duplicate: _tanstack_react_query0.UseMutateFunction<unknown, Error, string>;
+  duplicateAsync: _tanstack_react_query0.UseMutateAsyncFunction<unknown, Error, string>;
+  archive: _tanstack_react_query0.UseMutateFunction<unknown, Error, string>;
+  archiveAsync: _tanstack_react_query0.UseMutateAsyncFunction<unknown, Error, string>;
+  isPosting: boolean;
+  isReversing: boolean;
+  isDuplicating: boolean;
+  isArchiving: boolean;
+  isLoading: boolean;
+};
+//#endregion
+export { JOURNAL_ENTRY_KEYS, journalEntryHooks, useJournalEntries, useJournalEntryActions, useJournalEntryDetail, useJournalEntryNavigation, useJournalEntryStateActions };

package/dist/accounting/hooks/journal-entry.js

@@ -0,0 +1,89 @@
+"use client";
+
+import { createCrudHooks } from "../../core/react/crud.factory.js";
+import { journalEntryApi } from "../api/journal-entry.js";
+
+//#region src/accounting/hooks/journal-entry.ts
+/**
+* Journal Entry Hooks — CRUD + state-transition actions
+*
+* State transitions hit the unified action endpoint
+* `POST /accounting/journal-entries/:id/action`. The legacy individual
+* routes (post, unpost, reverse, duplicate) were dropped in be-prod.
+*
+* `unpost` is intentionally gone — Odoo-correct semantics treat posted
+* entries as final. UI should call `reverse()` instead.
+*/
+const journalEntryHooks = createCrudHooks({
+	api: journalEntryApi,
+	entityKey: "journal-entries",
+	singular: "Journal Entry",
+	plural: "Journal Entries",
+	defaults: { staleTime: 300 * 1e3 }
+});
+const { KEYS: JOURNAL_ENTRY_KEYS, useList: useJournalEntries, useDetail: useJournalEntryDetail, useActions: useJournalEntryActions, useNavigation: useJournalEntryNavigation } = journalEntryHooks;
+function useJournalEntryStateActions() {
+	const postMutation = journalEntryHooks.useCustomMutation({
+		mutationFn: (id) => journalEntryApi.post({
+			token: "",
+			id
+		}),
+		invalidateQueries: [JOURNAL_ENTRY_KEYS.all],
+		messages: {
+			success: "Journal entry posted",
+			error: "Failed to post"
+		}
+	});
+	const reverseMutation = journalEntryHooks.useCustomMutation({
+		mutationFn: ({ id, reversalDate }) => journalEntryApi.reverse({
+			token: "",
+			id,
+			reversalDate
+		}),
+		invalidateQueries: [JOURNAL_ENTRY_KEYS.all],
+		messages: {
+			success: "Journal entry reversed (counter-entry created)",
+			error: "Failed to reverse"
+		}
+	});
+	const duplicateMutation = journalEntryHooks.useCustomMutation({
+		mutationFn: (id) => journalEntryApi.duplicate({
+			token: "",
+			id
+		}),
+		invalidateQueries: [JOURNAL_ENTRY_KEYS.all],
+		messages: {
+			success: "Journal entry duplicated",
+			error: "Failed to duplicate"
+		}
+	});
+	const archiveMutation = journalEntryHooks.useCustomMutation({
+		mutationFn: (id) => journalEntryApi.archive({
+			token: "",
+			id
+		}),
+		invalidateQueries: [JOURNAL_ENTRY_KEYS.all],
+		messages: {
+			success: "Journal entry archived",
+			error: "Failed to archive (only drafts can be archived)"
+		}
+	});
+	return {
+		post: postMutation.mutate,
+		postAsync: postMutation.mutateAsync,
+		reverse: reverseMutation.mutate,
+		reverseAsync: reverseMutation.mutateAsync,
+		duplicate: duplicateMutation.mutate,
+		duplicateAsync: duplicateMutation.mutateAsync,
+		archive: archiveMutation.mutate,
+		archiveAsync: archiveMutation.mutateAsync,
+		isPosting: postMutation.isPending,
+		isReversing: reverseMutation.isPending,
+		isDuplicating: duplicateMutation.isPending,
+		isArchiving: archiveMutation.isPending,
+		isLoading: postMutation.isPending || reverseMutation.isPending || duplicateMutation.isPending || archiveMutation.isPending
+	};
+}
+
+//#endregion
+export { JOURNAL_ENTRY_KEYS, journalEntryHooks, useJournalEntries, useJournalEntryActions, useJournalEntryDetail, useJournalEntryNavigation, useJournalEntryStateActions };

package/dist/accounting/hooks/posting.d.ts

@@ -0,0 +1,128 @@
+import { BackfillResult, DayCloseOversight, DayCloseResult, PostingStatus } from "../types/index.js";
+import { QueryObserverResult, RefetchOptions } from "../../node_modules/@tanstack/query-core/build/modern/hydration-C-jfQLut.js";
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+
+//#region src/accounting/hooks/posting.d.ts
+declare const POSTING_KEYS: {
+  all: readonly ["posting"];
+  status: readonly ["posting", "status"];
+  oversight: readonly ["posting", "oversight"];
+};
+declare function usePostingStatus(): {
+  status: PostingStatus | undefined;
+  isLoading: boolean;
+  error: Error | null;
+  refetch: (options?: RefetchOptions) => Promise<QueryObserverResult<PostingStatus | undefined, Error>>;
+};
+/**
+ * Cross-branch days-behind summary for the finance director dashboard.
+ * Polls every 60s by default — fast enough for "is X branch behind" alerts
+ * without hammering the DB.
+ */
+declare function useDayCloseOversight(opts?: {
+  pollMs?: number;
+}): {
+  oversight: DayCloseOversight | undefined;
+  isLoading: boolean;
+  error: Error | null;
+  refetch: (options?: RefetchOptions) => Promise<QueryObserverResult<DayCloseOversight | undefined, Error>>;
+};
+declare function useCloseDay(): {
+  mutate: _tanstack_react_query0.UseMutateFunction<{
+    success: boolean;
+    data: DayCloseResult;
+  }, Error, string | undefined, unknown>;
+  mutateAsync: _tanstack_react_query0.UseMutateAsyncFunction<{
+    success: boolean;
+    data: DayCloseResult;
+  }, Error, string | undefined, unknown>;
+  isPending: boolean;
+  isSuccess: boolean;
+  isError: boolean;
+  error: Error | null;
+  data: {
+    success: boolean;
+    data: DayCloseResult;
+  } | undefined;
+  reset: () => void;
+};
+/**
+ * Reopen a closed POS day. Creates a forward-correction reversal entry
+ * dated today; the original closed-day JE stays posted but marked
+ * `reversed=true`. Requires a non-empty `reason` for audit.
+ *
+ * Permission: finance_admin only (stricter than close).
+ */
+declare function useReopenDay(): {
+  mutate: _tanstack_react_query0.UseMutateFunction<{
+    success: boolean;
+    data: {
+      reopened: boolean;
+      date: string;
+      originalEntryId: string;
+      reversalEntryId: string | null;
+      reversalDate: string;
+      message: string;
+    };
+  }, Error, {
+    date: string;
+    reason: string;
+  }, unknown>;
+  mutateAsync: _tanstack_react_query0.UseMutateAsyncFunction<{
+    success: boolean;
+    data: {
+      reopened: boolean;
+      date: string;
+      originalEntryId: string;
+      reversalEntryId: string | null;
+      reversalDate: string;
+      message: string;
+    };
+  }, Error, {
+    date: string;
+    reason: string;
+  }, unknown>;
+  isPending: boolean;
+  isSuccess: boolean;
+  isError: boolean;
+  error: Error | null;
+  data: {
+    success: boolean;
+    data: {
+      reopened: boolean;
+      date: string;
+      originalEntryId: string;
+      reversalEntryId: string | null;
+      reversalDate: string;
+      message: string;
+    };
+  } | undefined;
+  reset: () => void;
+};
+declare function useBackfill(): {
+  mutate: _tanstack_react_query0.UseMutateFunction<{
+    success: boolean;
+    data: BackfillResult;
+  }, Error, {
+    startDate: string;
+    endDate: string;
+  }, unknown>;
+  mutateAsync: _tanstack_react_query0.UseMutateAsyncFunction<{
+    success: boolean;
+    data: BackfillResult;
+  }, Error, {
+    startDate: string;
+    endDate: string;
+  }, unknown>;
+  isPending: boolean;
+  isSuccess: boolean;
+  isError: boolean;
+  error: Error | null;
+  data: {
+    success: boolean;
+    data: BackfillResult;
+  } | undefined;
+  reset: () => void;
+};
+//#endregion
+export { POSTING_KEYS, useBackfill, useCloseDay, useDayCloseOversight, usePostingStatus, useReopenDay };

package/dist/accounting/hooks/posting.js

@@ -0,0 +1,119 @@
+"use client";
+
+import { useMutationWithTransition } from "../../core/react/mutation.factory.js";
+import { backfillPostings, closeDay, getDayCloseOversight, getPostingStatus, reopenDay } from "../api/posting.js";
+import { JOURNAL_ENTRY_KEYS } from "./journal-entry.js";
+import { useQuery } from "@tanstack/react-query";
+
+//#region src/accounting/hooks/posting.ts
+/**
+* Posting Hooks — Day Close, Reopen, Backfill, Status, Oversight
+*/
+const POSTING_KEYS = {
+	all: ["posting"],
+	status: ["posting", "status"],
+	oversight: ["posting", "oversight"]
+};
+function usePostingStatus() {
+	const { data, isLoading, error, refetch } = useQuery({
+		queryKey: POSTING_KEYS.status,
+		queryFn: () => getPostingStatus({ token: "" }),
+		select: (res) => res.data,
+		staleTime: 30 * 1e3
+	});
+	return {
+		status: data,
+		isLoading,
+		error,
+		refetch
+	};
+}
+/**
+* Cross-branch days-behind summary for the finance director dashboard.
+* Polls every 60s by default — fast enough for "is X branch behind" alerts
+* without hammering the DB.
+*/
+function useDayCloseOversight(opts = {}) {
+	const { data, isLoading, error, refetch } = useQuery({
+		queryKey: POSTING_KEYS.oversight,
+		queryFn: () => getDayCloseOversight({ token: "" }),
+		select: (res) => res.data,
+		staleTime: 30 * 1e3,
+		refetchInterval: opts.pollMs ?? 6e4
+	});
+	return {
+		oversight: data,
+		isLoading,
+		error,
+		refetch
+	};
+}
+function useCloseDay() {
+	return useMutationWithTransition({
+		mutationFn: (date) => closeDay({
+			token: "",
+			date
+		}),
+		invalidateQueries: [
+			POSTING_KEYS.status,
+			POSTING_KEYS.oversight,
+			JOURNAL_ENTRY_KEYS.all
+		],
+		messages: {
+			success: (res) => {
+				const data = res.data;
+				return data.posted ? `Day closed — ${data.date}` : data.message || "No transactions to post";
+			},
+			error: "Failed to close day"
+		}
+	});
+}
+/**
+* Reopen a closed POS day. Creates a forward-correction reversal entry
+* dated today; the original closed-day JE stays posted but marked
+* `reversed=true`. Requires a non-empty `reason` for audit.
+*
+* Permission: finance_admin only (stricter than close).
+*/
+function useReopenDay() {
+	return useMutationWithTransition({
+		mutationFn: ({ date, reason }) => reopenDay({
+			token: "",
+			date,
+			reason
+		}),
+		invalidateQueries: [
+			POSTING_KEYS.status,
+			POSTING_KEYS.oversight,
+			JOURNAL_ENTRY_KEYS.all
+		],
+		messages: {
+			success: (res) => res.data.message || "Day reopened",
+			error: "Failed to reopen day"
+		}
+	});
+}
+function useBackfill() {
+	return useMutationWithTransition({
+		mutationFn: ({ startDate, endDate }) => backfillPostings({
+			token: "",
+			startDate,
+			endDate
+		}),
+		invalidateQueries: [
+			POSTING_KEYS.status,
+			POSTING_KEYS.oversight,
+			JOURNAL_ENTRY_KEYS.all
+		],
+		messages: {
+			success: (res) => {
+				const summary = res.data.summary;
+				return `Backfill complete: ${summary.posted} posted, ${summary.skipped} skipped (${summary.processed} days)`;
+			},
+			error: "Backfill failed"
+		}
+	});
+}
+
+//#endregion
+export { POSTING_KEYS, useBackfill, useCloseDay, useDayCloseOversight, usePostingStatus, useReopenDay };

package/dist/accounting/hooks/reports.d.ts

@@ -0,0 +1,32 @@
+import { BalanceSheetReport, BudgetVsActualReport, CashFlowReport, GeneralLedgerReport, IncomeStatementReport, ReportDateParams, TrialBalanceReport } from "../types/index.js";
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+
+//#region src/accounting/hooks/reports.d.ts
+declare const REPORT_KEYS: {
+  all: readonly ["accounting-reports"];
+  trialBalance: (params: ReportDateParams) => readonly ["accounting-reports", "trial-balance", ReportDateParams];
+  balanceSheet: (params: ReportDateParams) => readonly ["accounting-reports", "balance-sheet", ReportDateParams];
+  incomeStatement: (params: ReportDateParams) => readonly ["accounting-reports", "income-statement", ReportDateParams];
+  generalLedger: (params: ReportDateParams, accountId?: string) => readonly ["accounting-reports", "general-ledger", ReportDateParams, string | undefined];
+  cashFlow: (params: ReportDateParams) => readonly ["accounting-reports", "cash-flow", ReportDateParams];
+};
+declare function useTrialBalance(params: ReportDateParams, options?: {
+  enabled?: boolean;
+}): _tanstack_react_query0.UseQueryResult<TrialBalanceReport, Error>;
+declare function useBalanceSheet(params: ReportDateParams, options?: {
+  enabled?: boolean;
+}): _tanstack_react_query0.UseQueryResult<BalanceSheetReport, Error>;
+declare function useIncomeStatement(params: ReportDateParams, options?: {
+  enabled?: boolean;
+}): _tanstack_react_query0.UseQueryResult<IncomeStatementReport, Error>;
+declare function useGeneralLedger(params: ReportDateParams, accountId?: string, options?: {
+  enabled?: boolean;
+}): _tanstack_react_query0.UseQueryResult<GeneralLedgerReport, Error>;
+declare function useCashFlow(params: ReportDateParams, options?: {
+  enabled?: boolean;
+}): _tanstack_react_query0.UseQueryResult<CashFlowReport, Error>;
+declare function useBudgetVsActual(params: ReportDateParams, options?: {
+  enabled?: boolean;
+}): _tanstack_react_query0.UseQueryResult<BudgetVsActualReport, Error>;
+//#endregion
+export { REPORT_KEYS, useBalanceSheet, useBudgetVsActual, useCashFlow, useGeneralLedger, useIncomeStatement, useTrialBalance };