@classytic/commerce-sdk 0.1.2 → 0.2.1

package/dist/transaction/hooks/transaction.d.ts

@@ -0,0 +1,106 @@
+import { CashFlowReport, CategoryReport, CreateTransactionPayload, FinancialReport, StatementResponse, Transaction, UpdateTransactionPayload } from "../types/transaction.js";
+import { CashFlowParams, CategoryParams, ReportParams, StatementParams } from "../api/transaction.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/transaction/hooks/transaction.d.ts
+declare const TRANSACTION_KEYS: {
+  all: readonly ["transactions"];
+  lists: () => readonly ["transactions", "list"];
+  list: (params: Record<string, unknown>) => readonly ["transactions", "list", Record<string, unknown>];
+  details: () => readonly ["transactions", "detail"];
+  detail: (id: string) => readonly ["transactions", "detail", string];
+  reports: () => readonly ["transactions", "reports"];
+  profitLoss: (params: ReportParams) => readonly ["transactions", "reports", "profit-loss", ReportParams];
+  cashFlow: (params: CashFlowParams) => readonly ["transactions", "reports", "cash-flow", CashFlowParams];
+  categories: (params: CategoryParams) => readonly ["transactions", "reports", "categories", CategoryParams];
+  statement: (params: StatementParams) => readonly ["transactions", "reports", "statement", StatementParams];
+};
+/**
+ * Transaction CRUD hooks using createCrudHooks factory
+ *
+ * Provides:
+ * - useTransactions: List transactions with filtering/pagination
+ * - useTransactionDetail: Get single transaction
+ * - useTransactionActions: Create, update, delete mutations
+ * - useTransactionNavigation: Navigation between transactions
+ */
+declare const transactionHooks: _classytic_arc_next0.CrudHooksReturn<Transaction, CreateTransactionPayload, UpdateTransactionPayload>;
+declare const useTransactions: {
+    (params?: Record<string, unknown>, options?: _classytic_arc_next_query0.ListQueryOptions<Transaction> | undefined): _classytic_arc_next_query0.ListQueryResult<Transaction>;
+    (token: string | null, params?: Record<string, unknown>, options?: _classytic_arc_next_query0.ListQueryOptions<Transaction> | undefined): _classytic_arc_next_query0.ListQueryResult<Transaction>;
+  }, useTransactionDetail: {
+    (id: string | null, options?: _classytic_arc_next_query0.DetailQueryOptions<Transaction> | undefined): _classytic_arc_next_query0.DetailQueryResult<Transaction>;
+    (id: string | null, token: string | null, options?: _classytic_arc_next_query0.DetailQueryOptions<Transaction> | undefined): _classytic_arc_next_query0.DetailQueryResult<Transaction>;
+  }, useTransactionActions: () => _classytic_arc_next0.CrudActions<Transaction, CreateTransactionPayload, UpdateTransactionPayload>, useTransactionNavigation: () => _classytic_arc_next0.NavigateFn<Transaction>;
+interface QueryOptions {
+  enabled?: boolean;
+  staleTime?: number;
+}
+/**
+ * Fetch Profit & Loss report
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useProfitLoss({
+ *   startDate: '2024-01-01',
+ *   endDate: '2024-12-31',
+ * });
+ *
+ * return (
+ *   <div>
+ *     <p>Income: {data?.income}</p>
+ *     <p>Expense: {data?.expense}</p>
+ *     <p>Net: {data?.net}</p>
+ *   </div>
+ * );
+ * ```
+ */
+declare function useProfitLoss(params: ReportParams, options?: QueryOptions): _tanstack_react_query0.UseQueryResult<FinancialReport, Error>;
+/**
+ * Fetch Cash Flow report (monthly trend)
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useCashFlow({ months: 6 });
+ *
+ * return (
+ *   <BarChart data={data?.months} />
+ * );
+ * ```
+ */
+declare function useCashFlow(params?: CashFlowParams, options?: QueryOptions): _tanstack_react_query0.UseQueryResult<CashFlowReport, Error>;
+/**
+ * Fetch Category breakdown report
+ *
+ * @example
+ * ```tsx
+ * // Get expense categories
+ * const { data } = useCategoryReport({ flow: 'outflow', limit: 10 });
+ *
+ * return (
+ *   <PieChart data={data?.categories} />
+ * );
+ * ```
+ */
+declare function useCategoryReport(params?: CategoryParams, options?: QueryOptions): _tanstack_react_query0.UseQueryResult<CategoryReport, Error>;
+/**
+ * Fetch Statement export (JSON format)
+ *
+ * @example
+ * ```tsx
+ * const { data } = useStatement({
+ *   startDate: '2024-01-01',
+ *   endDate: '2024-12-31',
+ *   format: 'json',
+ * });
+ *
+ * return (
+ *   <DataTable data={data?.data} />
+ * );
+ * ```
+ */
+declare function useStatement(params: StatementParams, options?: QueryOptions): _tanstack_react_query0.UseQueryResult<StatementResponse, Error>;
+//#endregion
+export { TRANSACTION_KEYS, transactionHooks, useCashFlow, useCategoryReport, useProfitLoss, useStatement, useTransactionActions, useTransactionDetail, useTransactionNavigation, useTransactions };

package/dist/transaction/hooks/transaction.js

@@ -0,0 +1,156 @@
+"use client";
+
+import { createCrudHooks } from "../../core/react/crud.factory.js";
+import transactionApi from "../api/transaction.js";
+import { useQuery } from "@tanstack/react-query";
+
+//#region src/transaction/hooks/transaction.ts
+/**
+* Transaction Hooks
+*
+* React hooks for transaction CRUD operations and reports.
+* Transactions are used across the system for cashflow tracking.
+*/
+const TRANSACTION_KEYS = {
+	all: ["transactions"],
+	lists: () => [...TRANSACTION_KEYS.all, "list"],
+	list: (params) => [...TRANSACTION_KEYS.lists(), params],
+	details: () => [...TRANSACTION_KEYS.all, "detail"],
+	detail: (id) => [...TRANSACTION_KEYS.details(), id],
+	reports: () => [...TRANSACTION_KEYS.all, "reports"],
+	profitLoss: (params) => [
+		...TRANSACTION_KEYS.reports(),
+		"profit-loss",
+		params
+	],
+	cashFlow: (params) => [
+		...TRANSACTION_KEYS.reports(),
+		"cash-flow",
+		params
+	],
+	categories: (params) => [
+		...TRANSACTION_KEYS.reports(),
+		"categories",
+		params
+	],
+	statement: (params) => [
+		...TRANSACTION_KEYS.reports(),
+		"statement",
+		params
+	]
+};
+/**
+* Transaction CRUD hooks using createCrudHooks factory
+*
+* Provides:
+* - useTransactions: List transactions with filtering/pagination
+* - useTransactionDetail: Get single transaction
+* - useTransactionActions: Create, update, delete mutations
+* - useTransactionNavigation: Navigation between transactions
+*/
+const transactionHooks = createCrudHooks({
+	api: transactionApi,
+	entityKey: "transactions",
+	singular: "Transaction",
+	plural: "Transactions",
+	defaults: { staleTime: 60 * 1e3 }
+});
+const { useList: useTransactions, useDetail: useTransactionDetail, useActions: useTransactionActions, useNavigation: useTransactionNavigation } = transactionHooks;
+/**
+* Fetch Profit & Loss report
+*
+* @example
+* ```tsx
+* const { data, isLoading } = useProfitLoss({
+*   startDate: '2024-01-01',
+*   endDate: '2024-12-31',
+* });
+*
+* return (
+*   <div>
+*     <p>Income: {data?.income}</p>
+*     <p>Expense: {data?.expense}</p>
+*     <p>Net: {data?.net}</p>
+*   </div>
+* );
+* ```
+*/
+function useProfitLoss(params, options = {}) {
+	return useQuery({
+		queryKey: TRANSACTION_KEYS.profitLoss(params),
+		queryFn: () => transactionApi.getProfitLoss(params),
+		enabled: options.enabled !== false,
+		staleTime: options.staleTime ?? 300 * 1e3
+	});
+}
+/**
+* Fetch Cash Flow report (monthly trend)
+*
+* @example
+* ```tsx
+* const { data, isLoading } = useCashFlow({ months: 6 });
+*
+* return (
+*   <BarChart data={data?.months} />
+* );
+* ```
+*/
+function useCashFlow(params = {}, options = {}) {
+	return useQuery({
+		queryKey: TRANSACTION_KEYS.cashFlow(params),
+		queryFn: () => transactionApi.getCashFlow(params),
+		enabled: options.enabled !== false,
+		staleTime: options.staleTime ?? 300 * 1e3
+	});
+}
+/**
+* Fetch Category breakdown report
+*
+* @example
+* ```tsx
+* // Get expense categories
+* const { data } = useCategoryReport({ flow: 'outflow', limit: 10 });
+*
+* return (
+*   <PieChart data={data?.categories} />
+* );
+* ```
+*/
+function useCategoryReport(params = {}, options = {}) {
+	return useQuery({
+		queryKey: TRANSACTION_KEYS.categories(params),
+		queryFn: () => transactionApi.getCategoryReport(params),
+		enabled: options.enabled !== false,
+		staleTime: options.staleTime ?? 300 * 1e3
+	});
+}
+/**
+* Fetch Statement export (JSON format)
+*
+* @example
+* ```tsx
+* const { data } = useStatement({
+*   startDate: '2024-01-01',
+*   endDate: '2024-12-31',
+*   format: 'json',
+* });
+*
+* return (
+*   <DataTable data={data?.data} />
+* );
+* ```
+*/
+function useStatement(params, options = {}) {
+	return useQuery({
+		queryKey: TRANSACTION_KEYS.statement(params),
+		queryFn: () => transactionApi.getStatement({
+			...params,
+			format: "json"
+		}),
+		enabled: !!params.startDate && !!params.endDate && options.enabled !== false,
+		staleTime: options.staleTime ?? 300 * 1e3
+	});
+}
+
+//#endregion
+export { TRANSACTION_KEYS, transactionHooks, useCashFlow, useCategoryReport, useProfitLoss, useStatement, useTransactionActions, useTransactionDetail, useTransactionNavigation, useTransactions };

package/dist/transaction/index.d.ts

@@ -1,104 +1,4 @@
-import { o as Transaction, C as CreateTransactionPayload, U as UpdateTransactionPayload, F as FinancialReport, q as CashFlowReport, r as CategoryReport, s as StatementResponse } from '../transaction-dL3WW-er.js';
-export { a as PaymentGatewayType, p as PaymentIntent, P as PaymentMethod, S as StatementRow, i as TaxType, e as TransactionCategory, f as TransactionCategoryType, l as TransactionCommission, T as TransactionFlow, b as TransactionFlowType, k as TransactionGateway, h as TransactionPaymentDetails, n as TransactionReconciliation, g as TransactionSplitPayment, c as TransactionStatus, d as TransactionStatusType, j as TransactionTaxDetails, t as TransactionType, m as TransactionWebhook } from '../transaction-dL3WW-er.js';
-import { R as ReportParams, C as CashFlowParams, a as CategoryParams, S as StatementParams } from '../transaction-Bf6WjYCh.js';
-export { T as TransactionApi, t as transactionApi, t as transactionApiDefault } from '../transaction-Bf6WjYCh.js';
-import * as _tanstack_react_query from '@tanstack/react-query';
-import { b as CrudHooksReturn, L as ListOptions, l as ListQueryResult, D as DetailOptions, m as DetailQueryResult, d as CrudActions, N as NavigateFn } from '../crud.factory-DyKaPHcU.js';
-import '../api-factory-B_h4RKBm.js';
-
-declare const TRANSACTION_KEYS: {
-    all: readonly ["transactions"];
-    lists: () => readonly ["transactions", "list"];
-    list: (params: Record<string, unknown>) => readonly ["transactions", "list", Record<string, unknown>];
-    details: () => readonly ["transactions", "detail"];
-    detail: (id: string) => readonly ["transactions", "detail", string];
-    reports: () => readonly ["transactions", "reports"];
-    profitLoss: (params: ReportParams) => readonly ["transactions", "reports", "profit-loss", ReportParams];
-    cashFlow: (params: CashFlowParams) => readonly ["transactions", "reports", "cash-flow", CashFlowParams];
-    categories: (params: CategoryParams) => readonly ["transactions", "reports", "categories", CategoryParams];
-    statement: (params: StatementParams) => readonly ["transactions", "reports", "statement", StatementParams];
-};
-/**
- * Transaction CRUD hooks using createCrudHooks factory
- *
- * Provides:
- * - useTransactions: List transactions with filtering/pagination
- * - useTransactionDetail: Get single transaction
- * - useTransactionActions: Create, update, delete mutations
- * - useTransactionNavigation: Navigation between transactions
- */
-declare const transactionHooks: CrudHooksReturn<Transaction, CreateTransactionPayload, UpdateTransactionPayload>;
-declare const useTransactions: (token: string | null, params?: Record<string, unknown>, options?: ListOptions) => ListQueryResult<Transaction>;
-declare const useTransactionDetail: (id: string | null, token: string | null, options?: DetailOptions) => DetailQueryResult<Transaction>;
-declare const useTransactionActions: () => CrudActions<CreateTransactionPayload, UpdateTransactionPayload>;
-declare const useTransactionNavigation: () => NavigateFn<Transaction>;
-interface QueryOptions {
-    enabled?: boolean;
-    staleTime?: number;
-}
-/**
- * Fetch Profit & Loss report
- *
- * @example
- * ```tsx
- * const { data, isLoading } = useProfitLoss({
- *   startDate: '2024-01-01',
- *   endDate: '2024-12-31',
- * });
- *
- * return (
- *   <div>
- *     <p>Income: {data?.income}</p>
- *     <p>Expense: {data?.expense}</p>
- *     <p>Net: {data?.net}</p>
- *   </div>
- * );
- * ```
- */
-declare function useProfitLoss(params: ReportParams, options?: QueryOptions): _tanstack_react_query.UseQueryResult<FinancialReport, Error>;
-/**
- * Fetch Cash Flow report (monthly trend)
- *
- * @example
- * ```tsx
- * const { data, isLoading } = useCashFlow({ months: 6 });
- *
- * return (
- *   <BarChart data={data?.months} />
- * );
- * ```
- */
-declare function useCashFlow(params?: CashFlowParams, options?: QueryOptions): _tanstack_react_query.UseQueryResult<CashFlowReport, Error>;
-/**
- * Fetch Category breakdown report
- *
- * @example
- * ```tsx
- * // Get expense categories
- * const { data } = useCategoryReport({ flow: 'outflow', limit: 10 });
- *
- * return (
- *   <PieChart data={data?.categories} />
- * );
- * ```
- */
-declare function useCategoryReport(params?: CategoryParams, options?: QueryOptions): _tanstack_react_query.UseQueryResult<CategoryReport, Error>;
-/**
- * Fetch Statement export (JSON format)
- *
- * @example
- * ```tsx
- * const { data } = useStatement({
- *   startDate: '2024-01-01',
- *   endDate: '2024-12-31',
- *   format: 'json',
- * });
- *
- * return (
- *   <DataTable data={data?.data} />
- * );
- * ```
- */
-declare function useStatement(params: StatementParams, options?: QueryOptions): _tanstack_react_query.UseQueryResult<StatementResponse, Error>;
-
-export { CashFlowParams, CashFlowReport, CategoryParams, CategoryReport, CreateTransactionPayload, FinancialReport, ReportParams, StatementParams, StatementResponse, TRANSACTION_KEYS, Transaction, UpdateTransactionPayload, transactionHooks, useCashFlow, useCategoryReport, useProfitLoss, useStatement, useTransactionActions, useTransactionDetail, useTransactionNavigation, useTransactions };
+import { CashFlowReport, CategoryReport, CreateTransactionPayload, FinancialReport, PaymentGatewayType, PaymentIntent, PaymentMethod, StatementResponse, StatementRow, TaxType, Transaction, TransactionCategory, TransactionCategoryType, TransactionCommission, TransactionFlow, TransactionFlowType, TransactionGateway, TransactionPaymentDetails, TransactionReconciliation, TransactionSplitPayment, TransactionStatus, TransactionStatusType, TransactionTaxDetails, TransactionType, TransactionWebhook, UpdateTransactionPayload } from "./types/transaction.js";
+import { CashFlowParams, CategoryParams, ReportParams, StatementParams, TransactionApi, transactionApi } from "./api/transaction.js";
+import { TRANSACTION_KEYS, transactionHooks, useCashFlow, useCategoryReport, useProfitLoss, useStatement, useTransactionActions, useTransactionDetail, useTransactionNavigation, useTransactions } from "./hooks/transaction.js";
+export { CashFlowParams, CashFlowReport, CategoryParams, CategoryReport, CreateTransactionPayload, FinancialReport, PaymentGatewayType, PaymentIntent, PaymentMethod, ReportParams, StatementParams, StatementResponse, StatementRow, TRANSACTION_KEYS, TaxType, Transaction, TransactionApi, TransactionCategory, TransactionCategoryType, TransactionCommission, TransactionFlow, TransactionFlowType, TransactionGateway, TransactionPaymentDetails, TransactionReconciliation, TransactionSplitPayment, TransactionStatus, TransactionStatusType, TransactionTaxDetails, TransactionType, TransactionWebhook, UpdateTransactionPayload, transactionApi, transactionApi as transactionApiDefault, transactionHooks, useCashFlow, useCategoryReport, useProfitLoss, useStatement, useTransactionActions, useTransactionDetail, useTransactionNavigation, useTransactions };

package/dist/transaction/index.js

@@ -1,8 +1,5 @@
-"use client";
-export { TRANSACTION_KEYS, TransactionApi, TransactionCategory, TransactionFlow, TransactionStatus, TransactionType, transactionApi, transaction_default as transactionApiDefault, transactionHooks, useCashFlow, useCategoryReport, useProfitLoss, useStatement, useTransactionActions, useTransactionDetail, useTransactionNavigation, useTransactions } from '../chunk-AQAISI4F.js';
-import '../chunk-QCTXAMLA.js';
-import '../chunk-B6MPVOV7.js';
-import '../chunk-U3XT35GZ.js';
-import '../chunk-IHCBBLLW.js';
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+import { TransactionCategory, TransactionFlow, TransactionStatus, TransactionType } from "./types/transaction.js";
+import transactionApi, { TransactionApi } from "./api/transaction.js";
+import { TRANSACTION_KEYS, transactionHooks, useCashFlow, useCategoryReport, useProfitLoss, useStatement, useTransactionActions, useTransactionDetail, useTransactionNavigation, useTransactions } from "./hooks/transaction.js";
+
+export { TRANSACTION_KEYS, TransactionApi, TransactionCategory, TransactionFlow, TransactionStatus, TransactionType, transactionApi, transactionApi as transactionApiDefault, transactionHooks, useCashFlow, useCategoryReport, useProfitLoss, useStatement, useTransactionActions, useTransactionDetail, useTransactionNavigation, useTransactions };