@classytic/commerce-sdk 0.1.2 → 0.2.1

package/dist/core/index.d.ts

@@ -1,166 +1,4 @@
-export { d as AggregatePaginationResponse, A as ApiResponse, B as BaseApi, f as BaseApiConfig, D as DeleteResponse, E as ExtractDoc, F as FilterOperator, K as KeysetPaginationResponse, O as OffsetPaginationResponse, P as PaginatedResponse, Q as QueryParams, R as RequestOptions, S as SortDirection, e as SortSpec, c as createCrudApi, b as isAggregatePagination, a as isKeysetPagination, i as isOffsetPagination } from '../api-factory-B_h4RKBm.js';
-
-/**
- * @classytic/commerce-sdk - API Handler
- *
- * Universal API request handler for Next.js applications.
- * Handles JSON, binary (PDF, images), CSV, and text responses.
- */
-type HttpMethod = "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
-interface ApiRequestOptions {
-    body?: unknown;
-    token?: string | null;
-    organizationId?: string | null;
-    revalidate?: number;
-    headerOptions?: Record<string, string>;
-    tags?: string[];
-    cache?: RequestCache;
-    /**
-     * Credentials mode for this specific request.
-     * Overrides SDK-level credentials config.
-     * - "include": Always send cookies
-     * - "same-origin": Only send cookies for same-origin requests
-     * - "omit": Never send cookies (pure bearer-token auth)
-     */
-    credentials?: RequestCredentials;
-}
-interface BlobResponse {
-    data: Blob;
-    response: Response;
-}
-interface TextResponse {
-    data: string;
-    response: Response;
-}
-/**
- * SDK Configuration
- */
-interface SDKConfig {
-    /** Base URL for API requests (e.g., "https://api.example.com") */
-    baseUrl: string;
-    /** Default organization ID for multi-tenant support */
-    organizationId?: string;
-    /** Function to get current auth token */
-    getToken?: () => string | null | Promise<string | null>;
-    /** Default request cache mode */
-    cache?: RequestCache;
-    /** Default headers to include in all requests (e.g., API keys, custom headers) */
-    headers?: Record<string, string>;
-    /**
-     * Default credentials mode for fetch requests.
-     * Can be overridden per-request via ApiRequestOptions.credentials
-     * - "include": Always send cookies (default for backward compatibility)
-     * - "same-origin": Only send cookies for same-origin requests
-     * - "omit": Never send cookies (use for pure bearer-token auth)
-     * @default "include"
-     */
-    credentials?: RequestCredentials;
-}
-/**
- * Custom API Error class that preserves HTTP status and response body.
- * Provides better debugging context for API failures.
- *
- * @example
- * try {
- *   await sdk.orders.create(data);
- * } catch (error) {
- *   if (error instanceof ApiError) {
- *     console.log(error.status);      // 422
- *     console.log(error.body);        // { errors: [...] }
- *     console.log(error.endpoint);    // "/api/v1/orders"
- *   }
- * }
- */
-declare class ApiError extends Error {
-    /** HTTP status code (e.g., 400, 401, 404, 500) */
-    readonly status: number;
-    /** HTTP status text (e.g., "Bad Request", "Unauthorized") */
-    readonly statusText: string;
-    /** Raw response body - JSON object, string, or null if unparseable */
-    readonly body: unknown;
-    /** The API endpoint that was called */
-    readonly endpoint: string;
-    /** The HTTP method used */
-    readonly method: HttpMethod;
-    constructor(options: {
-        message: string;
-        status: number;
-        statusText: string;
-        body: unknown;
-        endpoint: string;
-        method: HttpMethod;
-    });
-    /** Check if error is a client error (4xx) */
-    isClientError(): boolean;
-    /** Check if error is a server error (5xx) */
-    isServerError(): boolean;
-    /** Returns detailed string for logging */
-    toDetailedString(): string;
-}
-declare function setSDKConfigProvider(provider: (() => SDKConfig | null) | null): void;
-/**
- * Configure the SDK with base URL and other options
- *
- * @example
- * // Basic configuration
- * configureSDK({
- *   baseUrl: process.env.NEXT_PUBLIC_API_URL!,
- *   getToken: () => localStorage.getItem('token'),
- *   organizationId: 'org_123',
- * });
- *
- * @example
- * // With custom headers (API keys, etc.)
- * configureSDK({
- *   baseUrl: process.env.NEXT_PUBLIC_API_URL!,
- *   headers: {
- *     'x-api-key': process.env.API_KEY,
- *     'x-custom-header': 'value',
- *   },
- * });
- */
-declare function configureSDK(config: SDKConfig): void;
-/**
- * Get current SDK configuration
- */
-declare function getSDKConfig(): SDKConfig | null;
-/**
- * Get base URL from SDK config or throw if not configured
- */
-declare function getBaseUrl(): string;
-/**
- * Universal API request handler for Next.js applications
- * Handles JSON, binary (PDF, images), CSV, and text responses
- *
- * @template T - Expected response type
- * @param method - HTTP method
- * @param endpoint - API endpoint (will be appended to BASE_URL)
- * @param options - Request options
- * @param debug - Enable debug logging
- * @returns Promise resolving to the response data
- *
- * @example
- * // JSON response
- * const { success, data } = await handleApiRequest<ApiResponse<User>>('GET', '/users/me', { token });
- *
- * // Paginated response
- * const response = await handleApiRequest<PaginatedResponse<Product>>('GET', '/products?page=1');
- *
- * // Create with body
- * const result = await handleApiRequest('POST', '/orders', { token, body: orderData });
- */
-declare function handleApiRequest<T = unknown>(method: HttpMethod, endpoint: string, options?: ApiRequestOptions, debug?: boolean): Promise<T>;
-/**
- * Creates query string from parameters
- * Supports: ?field=value and arrays as field[in]=value1,value2
- *
- * @example
- * createQueryString({ page: 1, limit: 10, status: 'active' })
- * // => 'page=1&limit=10&status=active'
- *
- * createQueryString({ roles: ['admin', 'user'] })
- * // => 'roles[in]=admin,user'
- */
-declare function createQueryString<T extends Record<string, unknown>>(params?: T): string;
-
-export { ApiError, type ApiRequestOptions, type BlobResponse, type HttpMethod, type SDKConfig, type TextResponse, configureSDK, createQueryString, getBaseUrl, getSDKConfig, handleApiRequest, setSDKConfigProvider };
+import { AggregatePaginationResponse, ApiResponse, BaseApi, BaseApiConfig, DeleteResponse, ExtractDoc, FilterOperator, KeysetPaginationResponse, OffsetPaginationResponse, PaginatedResponse, PopulateOption, QueryParams, RequestOptions, SortDirection, SortSpec, createCrudApi, isAggregatePagination, isKeysetPagination, isOffsetPagination } from "./api-factory.js";
+import { ApiError, ApiRequestOptions, ArcApiError, ArcClient, ArcClientConfig, BlobResponse, HttpMethod, SDKConfig, TextResponse, configureSDK, createClient, createQueryString, getAuthContext, getBaseUrl, getSDKConfig, handleApiRequest, isArcApiError, setSDKConfigProvider } from "./api-handler.js";
+import { BaseEntity, BasePaymentMethod, PopulatedRef, StatusHistoryEntry } from "./types/shared.js";
+export { type AggregatePaginationResponse, ApiError, type ApiRequestOptions, type ApiResponse, ArcApiError, type ArcClient, type ArcClientConfig, BaseApi, type BaseApiConfig, type BaseEntity, type BasePaymentMethod, type BlobResponse, type DeleteResponse, type ExtractDoc, type FilterOperator, type HttpMethod, type KeysetPaginationResponse, type OffsetPaginationResponse, type PaginatedResponse, type PopulateOption, type PopulatedRef, type QueryParams, type RequestOptions, type SDKConfig, type SortDirection, type SortSpec, type StatusHistoryEntry, type TextResponse, configureSDK, createClient, createCrudApi, createQueryString, getAuthContext, getBaseUrl, getSDKConfig, handleApiRequest, isAggregatePagination, isArcApiError, isKeysetPagination, isOffsetPagination, setSDKConfigProvider };

package/dist/core/index.js

@@ -1,5 +1,4 @@
-import '../chunk-PYYLHUV6.js';
-export { BaseApi, createCrudApi, isAggregatePagination, isKeysetPagination, isOffsetPagination } from '../chunk-QCTXAMLA.js';
-export { ApiError, configureSDK, createQueryString, getBaseUrl, getSDKConfig, handleApiRequest, setSDKConfigProvider } from '../chunk-IHCBBLLW.js';
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+import { ApiError, ArcApiError, configureSDK, createClient, createQueryString, getAuthContext, getBaseUrl, getSDKConfig, handleApiRequest, isArcApiError, setSDKConfigProvider } from "./api-handler.js";
+import { BaseApi, createCrudApi, isAggregatePagination, isKeysetPagination, isOffsetPagination } from "./api-factory.js";
+
+export { ApiError, ArcApiError, BaseApi, configureSDK, createClient, createCrudApi, createQueryString, getAuthContext, getBaseUrl, getSDKConfig, handleApiRequest, isAggregatePagination, isArcApiError, isKeysetPagination, isOffsetPagination, setSDKConfigProvider };

package/dist/core/prefetch.d.ts

@@ -0,0 +1,2 @@
+import { CrudPrefetcher, PrefetchDetailOptions, PrefetchOptions, createCrudPrefetcher, dehydrate } from "@classytic/arc-next/prefetch";
+export { type CrudPrefetcher, type PrefetchDetailOptions, type PrefetchOptions, createCrudPrefetcher, dehydrate };

package/dist/core/prefetch.js

@@ -0,0 +1,3 @@
+import { createCrudPrefetcher, dehydrate } from "@classytic/arc-next/prefetch";
+
+export { createCrudPrefetcher, dehydrate };

package/dist/core/react/crud.factory.d.ts

@@ -0,0 +1,3 @@
+import { CallOptions, CrudActions, CrudApi, CrudHooksConfig, CrudHooksReturn, DeleteParams, MutationParams, NavigateFn, NavigationOptions, UpdateParams, configureNavigation, createCrudHooks } from "@classytic/arc-next/hooks";
+import { DetailQueryOptions as DetailOptions, ListQueryOptions as ListOptions } from "@classytic/arc-next/query";
+export { type CallOptions, type CrudActions, type CrudApi, type CrudHooksConfig, type CrudHooksReturn, type DeleteParams, type DetailOptions, type ListOptions, type MutationParams, type NavigateFn, type NavigationOptions, type UpdateParams, configureNavigation, createCrudHooks };

package/dist/core/react/crud.factory.js

@@ -0,0 +1,5 @@
+"use client";
+
+import { configureNavigation, createCrudHooks } from "@classytic/arc-next/hooks";
+
+export { configureNavigation, createCrudHooks };

package/dist/core/react/index.d.ts

@@ -0,0 +1,4 @@
+import { CacheUtils, CreateDetailQueryOptions, CreateListQueryOptions, DEFAULT_QUERY_CONFIG, DetailQueryResult, InfiniteListQueryResult, ListQueryResult, PaginationData, QueryConfig, QueryKeys, RequestPassthrough, createCacheUtils, createDetailQuery, createListQuery, createQueryKeys, getItemId, updateListCache, useDetailQuery, useInfiniteListQuery, useListQuery } from "./query.factory.js";
+import { CreateOptimisticMutationConfig, MutationCallbacks, MutationMessages, MutationWithOptimisticConfig, MutationWithTransitionConfig, QUERY_CONFIGS, ToastHandler, TransitionMutationReturn, configureToast, createMessage, createOptimisticMutation, getToastHandler, useMutationWithOptimistic, useMutationWithTransition } from "./mutation.factory.js";
+import { CallOptions, CrudActions, CrudApi, CrudHooksConfig, CrudHooksReturn, DeleteParams, DetailOptions, ListOptions, MutationParams, NavigateFn, NavigationOptions, UpdateParams, configureNavigation, createCrudHooks } from "./crud.factory.js";
+export { type CacheUtils, type CallOptions, type CreateDetailQueryOptions, type CreateListQueryOptions, type CreateOptimisticMutationConfig, type CrudActions, type CrudApi, type CrudHooksConfig, type CrudHooksReturn, DEFAULT_QUERY_CONFIG, type DeleteParams, type DetailOptions, type DetailQueryResult, type InfiniteListQueryResult, type ListOptions, type ListQueryResult, type MutationCallbacks, type MutationMessages, type MutationParams, type MutationWithOptimisticConfig, type MutationWithTransitionConfig, type NavigateFn, type NavigationOptions, type PaginationData, QUERY_CONFIGS, type QueryConfig, type QueryKeys, type RequestPassthrough, type ToastHandler, type TransitionMutationReturn, type UpdateParams, configureNavigation, configureToast, createCacheUtils, createCrudHooks, createDetailQuery, createListQuery, createMessage, createOptimisticMutation, createQueryKeys, getItemId, getToastHandler, updateListCache, useDetailQuery, useInfiniteListQuery, useListQuery, useMutationWithOptimistic, useMutationWithTransition };

package/dist/core/react/index.js

@@ -0,0 +1,7 @@
+"use client";
+
+import { QUERY_CONFIGS, configureToast, createMessage, createOptimisticMutation, getToastHandler, useMutationWithOptimistic, useMutationWithTransition } from "./mutation.factory.js";
+import { configureNavigation, createCrudHooks } from "./crud.factory.js";
+import { DEFAULT_QUERY_CONFIG, createCacheUtils, createDetailQuery, createListQuery, createQueryKeys, getItemId, updateListCache, useDetailQuery, useInfiniteListQuery, useListQuery } from "./query.factory.js";
+
+export { DEFAULT_QUERY_CONFIG, QUERY_CONFIGS, configureNavigation, configureToast, createCacheUtils, createCrudHooks, createDetailQuery, createListQuery, createMessage, createOptimisticMutation, createQueryKeys, getItemId, getToastHandler, updateListCache, useDetailQuery, useInfiniteListQuery, useListQuery, useMutationWithOptimistic, useMutationWithTransition };

package/dist/core/react/mutation.factory.d.ts

@@ -0,0 +1,9 @@
+import { ToastHandler, ToastHandler as ToastHandler$1 } from "@classytic/arc-next/client";
+import { CreateOptimisticMutationConfig, MutationCallbacks, MutationMessages, OptimisticMutationConfig as MutationWithOptimisticConfig, QUERY_CONFIGS, TransitionMutationConfig as MutationWithTransitionConfig, TransitionMutationReturn, createOptimisticMutation, useMutationWithOptimistic, useMutationWithTransition } from "@classytic/arc-next/mutation";
+
+//#region src/core/react/mutation.factory.d.ts
+declare function configureToast$1(handler: ToastHandler): void;
+declare function getToastHandler(): ToastHandler;
+declare const createMessage: <T>(fn: T) => T;
+//#endregion
+export { type CreateOptimisticMutationConfig, type MutationCallbacks, type MutationMessages, type MutationWithOptimisticConfig, type MutationWithTransitionConfig, QUERY_CONFIGS, type ToastHandler$1 as ToastHandler, type TransitionMutationReturn, configureToast$1 as configureToast, createMessage, createOptimisticMutation, getToastHandler, useMutationWithOptimistic, useMutationWithTransition };

package/dist/core/react/mutation.factory.js

@@ -0,0 +1,21 @@
+"use client";
+
+import { QUERY_CONFIGS, configureToast, createOptimisticMutation, useMutationWithOptimistic, useMutationWithTransition } from "@classytic/arc-next/mutation";
+
+//#region src/core/react/mutation.factory.ts
+let _toastHandler = null;
+const noopToast = {
+	success: () => {},
+	error: () => {}
+};
+function configureToast$1(handler) {
+	_toastHandler = handler;
+	configureToast(handler);
+}
+function getToastHandler() {
+	return _toastHandler ?? noopToast;
+}
+const createMessage = (fn) => fn;
+
+//#endregion
+export { QUERY_CONFIGS, configureToast$1 as configureToast, createMessage, createOptimisticMutation, getToastHandler, useMutationWithOptimistic, useMutationWithTransition };

package/dist/core/react/query.factory.d.ts

@@ -0,0 +1,12 @@
+import { CacheUtils, CreateDetailQueryConfig as CreateDetailQueryOptions, CreateListQueryConfig as CreateListQueryOptions, DEFAULT_QUERY_CONFIG, DetailQueryResult, InfiniteListQueryResult, ListQueryResult, PaginationData, QueryKeys, RequestPassthrough, createCacheUtils, createDetailQuery, createListQuery, createQueryKeys, getItemId, updateListCache, useDetailQuery, useInfiniteListQuery, useListQuery } from "@classytic/arc-next/query";
+
+//#region src/core/react/query.factory.d.ts
+interface QueryConfig {
+  staleTime?: number;
+  gcTime?: number;
+  refetchOnWindowFocus?: boolean;
+  structuralSharing?: boolean;
+  retry?: number;
+}
+//#endregion
+export { type CacheUtils, type CreateDetailQueryOptions, type CreateListQueryOptions, DEFAULT_QUERY_CONFIG, type DetailQueryResult, type InfiniteListQueryResult, type ListQueryResult, type PaginationData, QueryConfig, type QueryKeys, type RequestPassthrough, createCacheUtils, createDetailQuery, createListQuery, createQueryKeys, getItemId, updateListCache, useDetailQuery, useInfiniteListQuery, useListQuery };

package/dist/core/react/query.factory.js

@@ -0,0 +1,5 @@
+"use client";
+
+import { DEFAULT_QUERY_CONFIG, createCacheUtils, createDetailQuery, createListQuery, createQueryKeys, getItemId, updateListCache, useDetailQuery, useInfiniteListQuery, useListQuery } from "@classytic/arc-next/query";
+
+export { DEFAULT_QUERY_CONFIG, createCacheUtils, createDetailQuery, createListQuery, createQueryKeys, getItemId, updateListCache, useDetailQuery, useInfiniteListQuery, useListQuery };

package/dist/core/server-context.d.ts

@@ -0,0 +1,6 @@
+import { SDKConfig } from "./api-handler.js";
+
+//#region src/core/server-context.d.ts
+declare function runWithSDKConfig<T>(config: SDKConfig, fn: () => T): T;
+//#endregion
+export { runWithSDKConfig };

package/dist/core/server-context.js

@@ -0,0 +1,12 @@
+import { setSDKConfigProvider } from "./api-handler.js";
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/core/server-context.ts
+const configStore = new AsyncLocalStorage();
+setSDKConfigProvider(() => configStore.getStore());
+function runWithSDKConfig(config, fn) {
+	return configStore.run(config, fn);
+}
+
+//#endregion
+export { runWithSDKConfig };

package/dist/core/types/shared.d.ts

@@ -0,0 +1,29 @@
+//#region src/core/types/shared.d.ts
+/**
+ * Shared Types
+ *
+ * Common type patterns used across multiple domain modules.
+ * Import from '@classytic/commerce-sdk/core' or '@classytic/commerce-sdk'.
+ */
+/** Common fields on all MongoDB documents */
+interface BaseEntity {
+  _id: string;
+  createdAt: string;
+  updatedAt: string;
+}
+/** Populated reference — can be an ID string or an expanded object */
+type PopulatedRef<T = {
+  _id: string;
+  name: string;
+}> = string | T;
+/** Generic status history entry (Transfer, Purchase, Order, etc.) */
+interface StatusHistoryEntry<TStatus extends string = string> {
+  status: TStatus;
+  timestamp: string;
+  actor?: PopulatedRef;
+  notes?: string;
+}
+/** Base payment methods common to Bangladesh market */
+type BasePaymentMethod = 'cash' | 'bkash' | 'nagad' | 'rocket' | 'bank_transfer' | 'card';
+//#endregion
+export { BaseEntity, BasePaymentMethod, PopulatedRef, StatusHistoryEntry };

package/dist/finance/api/finance.d.ts

@@ -0,0 +1,22 @@
+import { ApiResponse, BaseApi } from "../../core/api-factory.js";
+import { FinanceStatement, FinanceStatementParams, FinanceSummary, FinanceSummaryParams } from "../types/finance.js";
+
+//#region src/finance/api/finance.d.ts
+declare class FinanceApi extends BaseApi {
+  constructor();
+  /** GET /finance/statements */
+  getStatements({
+    params
+  }: {
+    params: FinanceStatementParams;
+  }): Promise<ApiResponse<FinanceStatement[]>>;
+  /** GET /finance/summary */
+  getSummary({
+    params
+  }: {
+    params: FinanceSummaryParams;
+  }): Promise<ApiResponse<FinanceSummary>>;
+}
+declare const financeApi: FinanceApi;
+//#endregion
+export { FinanceApi, financeApi };

package/dist/finance/api/finance.js

@@ -0,0 +1,29 @@
+import { BaseApi } from "../../core/api-factory.js";
+
+//#region src/finance/api/finance.ts
+/**
+* Finance API — Statements and summaries
+*
+* Endpoints:
+* - GET /finance/statements — Export statements (CSV/JSON)
+* - GET /finance/summary    — Dashboard summary with breakdowns
+*
+* Roles: admin, superadmin, finance-admin, finance-manager
+*/
+var FinanceApi = class extends BaseApi {
+	constructor() {
+		super("finance");
+	}
+	/** GET /finance/statements */
+	async getStatements({ params }) {
+		return this.request("GET", `${this.baseUrl}/statements`, { params });
+	}
+	/** GET /finance/summary */
+	async getSummary({ params }) {
+		return this.request("GET", `${this.baseUrl}/summary`, { params });
+	}
+};
+const financeApi = new FinanceApi();
+
+//#endregion
+export { FinanceApi, financeApi };

package/dist/finance/api/index.d.ts

@@ -0,0 +1 @@
+import { FinanceApi, financeApi } from "./finance.js";

package/dist/finance/hooks/finance.d.ts

@@ -0,0 +1,32 @@
+import { QueryKeys } from "../../core/react/query.factory.js";
+import { FinanceStatement, FinanceStatementParams, FinanceSummary, FinanceSummaryParams } from "../types/finance.js";
+
+//#region src/finance/hooks/finance.d.ts
+declare const FINANCE_KEYS: QueryKeys;
+interface QueryOptions {
+  enabled?: boolean;
+  staleTime?: number;
+}
+interface UseFinanceStatementsReturn {
+  statements: FinanceStatement[];
+  isLoading: boolean;
+  isFetching: boolean;
+  error: Error | null;
+  refetch: () => void;
+}
+interface UseFinanceSummaryReturn {
+  summary: FinanceSummary | null;
+  totals: FinanceSummary["totals"] | null;
+  byMethod: FinanceSummary["byMethod"];
+  byDay: FinanceSummary["byDay"];
+  isLoading: boolean;
+  isFetching: boolean;
+  error: Error | null;
+  refetch: () => void;
+}
+/** Fetch finance statements for a date range */
+declare function useFinanceStatements(params: FinanceStatementParams, options?: QueryOptions): UseFinanceStatementsReturn;
+/** Fetch finance summary with breakdowns */
+declare function useFinanceSummary(params: FinanceSummaryParams, options?: QueryOptions): UseFinanceSummaryReturn;
+//#endregion
+export { FINANCE_KEYS, UseFinanceStatementsReturn, UseFinanceSummaryReturn, useFinanceStatements, useFinanceSummary };

package/dist/finance/hooks/finance.js

@@ -0,0 +1,66 @@
+"use client";
+
+import { createQueryKeys } from "../../core/react/query.factory.js";
+import { financeApi } from "../api/finance.js";
+import { useQuery } from "@tanstack/react-query";
+
+//#region src/finance/hooks/finance.ts
+/**
+* Finance Hooks — Statements and summaries
+*/
+const FINANCE_KEYS = createQueryKeys("finance");
+const financeKeys = {
+	...FINANCE_KEYS,
+	statements: (params) => [
+		...FINANCE_KEYS.all,
+		"statements",
+		params
+	],
+	summary: (params) => [
+		...FINANCE_KEYS.all,
+		"summary",
+		params
+	]
+};
+/** Fetch finance statements for a date range */
+function useFinanceStatements(params, options = {}) {
+	const { data, isLoading, isFetching, error, refetch } = useQuery({
+		queryKey: financeKeys.statements(params),
+		queryFn: async () => {
+			return (await financeApi.getStatements({ params })).data ?? [];
+		},
+		enabled: !!params.startDate && !!params.endDate && options.enabled !== false,
+		staleTime: options.staleTime ?? 120 * 1e3
+	});
+	return {
+		statements: data || [],
+		isLoading,
+		isFetching,
+		error,
+		refetch
+	};
+}
+/** Fetch finance summary with breakdowns */
+function useFinanceSummary(params, options = {}) {
+	const { data, isLoading, isFetching, error, refetch } = useQuery({
+		queryKey: financeKeys.summary(params),
+		queryFn: async () => {
+			return (await financeApi.getSummary({ params })).data ?? null;
+		},
+		enabled: !!params.startDate && !!params.endDate && options.enabled !== false,
+		staleTime: options.staleTime ?? 120 * 1e3
+	});
+	return {
+		summary: data ?? null,
+		totals: data?.totals ?? null,
+		byMethod: data?.byMethod ?? [],
+		byDay: data?.byDay ?? [],
+		isLoading,
+		isFetching,
+		error,
+		refetch
+	};
+}
+
+//#endregion
+export { FINANCE_KEYS, useFinanceStatements, useFinanceSummary };

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

@@ -0,0 +1 @@
+import { FINANCE_KEYS, UseFinanceStatementsReturn, UseFinanceSummaryReturn, useFinanceStatements, useFinanceSummary } from "./finance.js";

package/dist/finance/index.d.ts

@@ -1,81 +1,4 @@
-import { b as FinanceStatementParams, h as FinanceSummaryParams, a as FinanceStatement, g as FinanceSummary } from '../finance-BJdfKRw0.js';
-export { F as FinanceApi, e as FinanceByDay, d as FinanceByMethod, c as FinanceTotals, f as financeApi } from '../finance-BJdfKRw0.js';
-import '../api-factory-B_h4RKBm.js';
-
-declare const FINANCE_KEYS: {
-    all: readonly ["finance"];
-    statements: () => readonly ["finance", "statements"];
-    statementList: (params: FinanceStatementParams) => readonly ["finance", "statements", FinanceStatementParams];
-    summary: () => readonly ["finance", "summary"];
-    summaryData: (params: FinanceSummaryParams) => readonly ["finance", "summary", FinanceSummaryParams];
-};
-interface QueryOptions {
-    enabled?: boolean;
-    staleTime?: number;
-}
-interface UseFinanceStatementsReturn {
-    statements: FinanceStatement[];
-    isLoading: boolean;
-    isFetching: boolean;
-    error: Error | null;
-    refetch: () => void;
-}
-interface UseFinanceSummaryReturn {
-    summary: FinanceSummary | null;
-    totals: FinanceSummary["totals"] | null;
-    byMethod: FinanceSummary["byMethod"];
-    byDay: FinanceSummary["byDay"];
-    isLoading: boolean;
-    isFetching: boolean;
-    error: Error | null;
-    refetch: () => void;
-}
-/**
- * Fetch finance statements for a date range
- *
- * @param token - Auth token (admin/finance roles)
- * @param params - Query parameters (startDate, endDate required)
- * @param options - Query options
- *
- * @example
- * ```tsx
- * function StatementTable() {
- *   const { statements, isLoading } = useFinanceStatements(token, {
- *     startDate: '2024-01-01T00:00:00Z',
- *     endDate: '2024-01-31T23:59:59Z',
- *     branchId: selectedBranch,
- *   });
- *
- *   return <DataTable data={statements} loading={isLoading} />;
- * }
- * ```
- */
-declare function useFinanceStatements(token: string, params: FinanceStatementParams, options?: QueryOptions): UseFinanceStatementsReturn;
-/**
- * Fetch finance summary with breakdowns
- *
- * @param token - Auth token (admin/finance roles)
- * @param params - Query parameters (startDate, endDate required)
- * @param options - Query options
- *
- * @example
- * ```tsx
- * function FinanceDashboard() {
- *   const { totals, byMethod, byDay, isLoading } = useFinanceSummary(token, {
- *     startDate: '2024-01-01T00:00:00Z',
- *     endDate: '2024-01-31T23:59:59Z',
- *   });
- *
- *   return (
- *     <>
- *       <SummaryCards totals={totals} />
- *       <MethodBreakdown data={byMethod} />
- *       <DailyChart data={byDay} />
- *     </>
- *   );
- * }
- * ```
- */
-declare function useFinanceSummary(token: string, params: FinanceSummaryParams, options?: QueryOptions): UseFinanceSummaryReturn;
-
-export { FINANCE_KEYS, FinanceStatement, FinanceStatementParams, FinanceSummary, FinanceSummaryParams, type UseFinanceStatementsReturn, type UseFinanceSummaryReturn, useFinanceStatements, useFinanceSummary };
+import { FinanceByDay, FinanceByMethod, FinanceStatement, FinanceStatementParams, FinanceSummary, FinanceSummaryParams, FinanceTotals } from "./types/finance.js";
+import { FinanceApi, financeApi } from "./api/finance.js";
+import { FINANCE_KEYS, UseFinanceStatementsReturn, UseFinanceSummaryReturn, useFinanceStatements, useFinanceSummary } from "./hooks/finance.js";
+export { FINANCE_KEYS, FinanceApi, FinanceByDay, FinanceByMethod, FinanceStatement, FinanceStatementParams, FinanceSummary, FinanceSummaryParams, FinanceTotals, UseFinanceStatementsReturn, UseFinanceSummaryReturn, financeApi, useFinanceStatements, useFinanceSummary };

package/dist/finance/index.js

@@ -1,5 +1,4 @@
-"use client";
-export { FINANCE_KEYS, FinanceApi, financeApi, useFinanceStatements, useFinanceSummary } from '../chunk-N43VE355.js';
-import '../chunk-IHCBBLLW.js';
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+import { FinanceApi, financeApi } from "./api/finance.js";
+import { FINANCE_KEYS, useFinanceStatements, useFinanceSummary } from "./hooks/finance.js";
+
+export { FINANCE_KEYS, FinanceApi, financeApi, useFinanceStatements, useFinanceSummary };