@pfm-platform/expenses-data-access 0.1.1

package/dist/index.cjs

@@ -0,0 +1,118 @@
+'use strict';
+
+var reactQuery = require('@tanstack/react-query');
+var shared = require('@pfm-platform/shared');
+var axios = require('axios');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var axios__default = /*#__PURE__*/_interopDefault(axios);
+
+// src/queries/useExpenses.ts
+var api = axios__default.default.create({
+  baseURL: "/api",
+  headers: {
+    "Content-Type": "application/json"
+  }
+});
+
+// src/keys.ts
+var expenseKeys = {
+  all: ["expenses"],
+  lists: () => [...expenseKeys.all, "list"],
+  list: (userId, filters) => [...expenseKeys.lists(), userId, filters]
+};
+
+// src/queries/useExpenses.ts
+function useExpenses({ userId, filters }, options) {
+  return reactQuery.useQuery({
+    queryKey: expenseKeys.list(userId, filters),
+    queryFn: async () => {
+      let validatedFilters = filters;
+      if (filters) {
+        validatedFilters = shared.ExpenseSearchParamsSchema.parse(filters);
+      }
+      const params = new URLSearchParams();
+      if (validatedFilters?.begin_on) {
+        params.append("begin_on", validatedFilters.begin_on);
+      }
+      if (validatedFilters?.end_on) {
+        params.append("end_on", validatedFilters.end_on);
+      }
+      if (validatedFilters?.threshold !== void 0) {
+        params.append("threshold", validatedFilters.threshold.toString());
+      }
+      const queryString = params.toString();
+      const url = `/users/${userId}/expenses${queryString ? `?${queryString}` : ""}`;
+      const response = await api.get(url);
+      const validated = shared.ExpensesResponseSchema.parse(response.data);
+      return validated.expenses;
+    },
+    staleTime: 1e3 * 60 * 5,
+    // 5 minutes (aggregated data, moderate update frequency)
+    ...options
+  });
+}
+function useCreateExpense(options) {
+  const queryClient = reactQuery.useQueryClient();
+  const { mode } = shared.useAppMode();
+  return reactQuery.useMutation({
+    mutationFn: async ({ userId, data }) => {
+      const schema = mode === "admin" ? shared.ExpenseCreateSchemaAdmin : shared.ExpenseCreateSchemaUser;
+      const validated = schema.parse(data);
+      const response = await api.post(`/users/${userId}/expenses`, validated);
+      return shared.ExpenseSchema.parse(response.data);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({
+        queryKey: expenseKeys.list(userId)
+      });
+    },
+    ...options
+  });
+}
+function useUpdateExpense(options) {
+  const queryClient = reactQuery.useQueryClient();
+  const { mode } = shared.useAppMode();
+  return reactQuery.useMutation({
+    mutationFn: async ({ userId, tag, data }) => {
+      const schema = mode === "admin" ? shared.ExpenseUpdateSchemaAdmin : shared.ExpenseUpdateSchemaUser;
+      const validated = schema.parse(data);
+      const response = await api.put(
+        `/users/${userId}/expenses/${encodeURIComponent(tag)}`,
+        validated
+      );
+      return shared.ExpenseSchema.parse(response.data);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({
+        queryKey: expenseKeys.list(userId)
+      });
+    },
+    ...options
+  });
+}
+function useDeleteExpense(options) {
+  const queryClient = reactQuery.useQueryClient();
+  return reactQuery.useMutation({
+    mutationFn: async ({ userId, tag }) => {
+      const validated = shared.ExpenseDeleteSchema.parse({ tag });
+      await api.delete(`/users/${userId}/expenses/${encodeURIComponent(validated.tag)}`);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({
+        queryKey: expenseKeys.list(userId)
+      });
+    },
+    ...options
+  });
+}
+
+exports.api = api;
+exports.expenseKeys = expenseKeys;
+exports.useCreateExpense = useCreateExpense;
+exports.useDeleteExpense = useDeleteExpense;
+exports.useExpenses = useExpenses;
+exports.useUpdateExpense = useUpdateExpense;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/keys.ts","../src/queries/useExpenses.ts","../src/mutations/useCreateExpense.ts","../src/mutations/useUpdateExpense.ts","../src/mutations/useDeleteExpense.ts"],"names":["axios","useQuery","ExpenseSearchParamsSchema","ExpensesResponseSchema","useQueryClient","useAppMode","useMutation","ExpenseCreateSchemaAdmin","ExpenseCreateSchemaUser","ExpenseSchema","ExpenseUpdateSchemaAdmin","ExpenseUpdateSchemaUser","ExpenseDeleteSchema"],"mappings":"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","file":"index.cjs","sourcesContent":["import axios from 'axios';\n\n/**\n * Axios instance for Expenses API\n * Base URL configured through environment variables or defaults to relative path\n */\nexport const api = axios.create({\n  baseURL: '/api',\n  headers: {\n    'Content-Type': 'application/json',\n  },\n});\n","export const expenseKeys = {\n  all: ['expenses'] as const,\n  lists: () => [...expenseKeys.all, 'list'] as const,\n  list: (\n    userId: string,\n    filters?: { begin_on?: string; end_on?: string; threshold?: number }\n  ) => [...expenseKeys.lists(), userId, filters] as const,\n};\n","import { useQuery } from '@tanstack/react-query';\nimport type { UseQueryOptions } from '@tanstack/react-query';\nimport {\n  ExpensesResponseSchema,\n  ExpenseSearchParamsSchema,\n  type Expense,\n  type ExpenseSearchParams,\n} from '@pfm-platform/shared';\nimport { api } from '../client';\nimport { expenseKeys } from '../keys';\n\ninterface UseExpensesParams {\n  userId: string;\n  filters?: ExpenseSearchParams;\n}\n\n/**\n * Fetch expenses for a user with optional filters\n *\n * @param params - User ID and optional filters (begin_on, end_on, threshold)\n * @param options - Additional useQuery options\n * @returns Query result with expenses array\n */\nexport function useExpenses(\n  { userId, filters }: UseExpensesParams,\n  options?: Omit<UseQueryOptions<Expense[]>, 'queryKey' | 'queryFn'>\n) {\n  return useQuery({\n    queryKey: expenseKeys.list(userId, filters),\n    queryFn: async () => {\n      // Validate filters if provided\n      let validatedFilters = filters;\n      if (filters) {\n        validatedFilters = ExpenseSearchParamsSchema.parse(filters);\n      }\n\n      const params = new URLSearchParams();\n\n      if (validatedFilters?.begin_on) {\n        params.append('begin_on', validatedFilters.begin_on);\n      }\n      if (validatedFilters?.end_on) {\n        params.append('end_on', validatedFilters.end_on);\n      }\n      if (validatedFilters?.threshold !== undefined) {\n        params.append('threshold', validatedFilters.threshold.toString());\n      }\n\n      const queryString = params.toString();\n      const url = `/users/${userId}/expenses${queryString ? `?${queryString}` : ''}`;\n\n      const response = await api.get(url);\n      const validated = ExpensesResponseSchema.parse(response.data);\n      return validated.expenses;\n    },\n    staleTime: 1000 * 60 * 5, // 5 minutes (aggregated data, moderate update frequency)\n    ...options,\n  });\n}\n","import {\n  useMutation,\n  useQueryClient,\n  type UseMutationOptions,\n} from '@tanstack/react-query';\nimport {\n  ExpenseCreateSchemaAdmin,\n  ExpenseCreateSchemaUser,\n  ExpenseSchema,\n  useAppMode,\n  type Expense,\n} from '@pfm-platform/shared';\nimport { api } from '../client';\nimport { expenseKeys } from '../keys';\n\n/**\n * Expense create data interface\n */\nexport interface ExpenseCreate {\n  tag: string;\n  amount: string;\n}\n\n/**\n * Parameters for useCreateExpense mutation\n */\nexport interface CreateExpenseParams {\n  userId: string;\n  data: ExpenseCreate;\n}\n\n/**\n * Mutation hook for creating a new expense\n *\n * Creates an expense record manually for testing purposes.\n * Uses mode switching for validation:\n * - Admin mode: Allows manual expense creation for test data\n * - User mode: Blocked (expenses are computed from transactions)\n *\n * @example\n * ```tsx\n * const createExpense = useCreateExpense();\n *\n * createExpense.mutate({\n *   userId: 'user123',\n *   data: {\n *     tag: 'groceries',\n *     amount: '123.45'\n *   }\n * });\n * ```\n */\nexport function useCreateExpense(\n  options?: Omit<UseMutationOptions<Expense, Error, CreateExpenseParams>, 'mutationFn'>\n) {\n  const queryClient = useQueryClient();\n  const { mode } = useAppMode();\n\n  return useMutation({\n    mutationFn: async ({ userId, data }: CreateExpenseParams) => {\n      // Select schema based on mode\n      const schema =\n        mode === 'admin'\n          ? ExpenseCreateSchemaAdmin\n          : ExpenseCreateSchemaUser;\n\n      // Validate expense data\n      const validated = schema.parse(data);\n\n      // POST to create new expense\n      const response = await api.post(`/users/${userId}/expenses`, validated);\n\n      // Return created expense\n      return ExpenseSchema.parse(response.data);\n    },\n    onSuccess: (_, { userId }) => {\n      // Invalidate expenses query to refetch updated list\n      queryClient.invalidateQueries({\n        queryKey: expenseKeys.list(userId),\n      });\n    },\n    ...options,\n  });\n}\n","import {\n  useMutation,\n  useQueryClient,\n  type UseMutationOptions,\n} from '@tanstack/react-query';\nimport {\n  ExpenseUpdateSchemaAdmin,\n  ExpenseUpdateSchemaUser,\n  ExpenseSchema,\n  useAppMode,\n  type Expense,\n} from '@pfm-platform/shared';\nimport { api } from '../client';\nimport { expenseKeys } from '../keys';\n\n/**\n * Expense update data interface\n */\nexport interface ExpenseUpdate {\n  amount?: string;\n}\n\n/**\n * Parameters for useUpdateExpense mutation\n */\nexport interface UpdateExpenseParams {\n  userId: string;\n  tag: string;\n  data: ExpenseUpdate;\n}\n\n/**\n * Mutation hook for updating an expense\n *\n * Updates expense fields for testing purposes.\n * Uses mode switching for validation:\n * - Admin mode: Allows updating expenses for test scenarios\n * - User mode: Blocked (expenses are computed from transactions)\n *\n * @example\n * ```tsx\n * const updateExpense = useUpdateExpense();\n *\n * updateExpense.mutate({\n *   userId: 'user123',\n *   tag: 'groceries',\n *   data: {\n *     amount: '200.00'\n *   }\n * });\n * ```\n */\nexport function useUpdateExpense(\n  options?: Omit<UseMutationOptions<Expense, Error, UpdateExpenseParams>, 'mutationFn'>\n) {\n  const queryClient = useQueryClient();\n  const { mode } = useAppMode();\n\n  return useMutation({\n    mutationFn: async ({ userId, tag, data }: UpdateExpenseParams) => {\n      // Select schema based on mode\n      const schema =\n        mode === 'admin'\n          ? ExpenseUpdateSchemaAdmin\n          : ExpenseUpdateSchemaUser;\n\n      // Validate expense update data\n      const validated = schema.parse(data);\n\n      // PUT to update expense\n      const response = await api.put(\n        `/users/${userId}/expenses/${encodeURIComponent(tag)}`,\n        validated\n      );\n\n      // Return updated expense\n      return ExpenseSchema.parse(response.data);\n    },\n    onSuccess: (_, { userId }) => {\n      // Invalidate expenses query to refetch updated list\n      queryClient.invalidateQueries({\n        queryKey: expenseKeys.list(userId),\n      });\n    },\n    ...options,\n  });\n}\n","import {\n  useMutation,\n  useQueryClient,\n  type UseMutationOptions,\n} from '@tanstack/react-query';\nimport { ExpenseDeleteSchema } from '@pfm-platform/shared';\nimport { api } from '../client';\nimport { expenseKeys } from '../keys';\n\n/**\n * Parameters for useDeleteExpense mutation\n */\nexport interface DeleteExpenseParams {\n  userId: string;\n  tag: string;\n}\n\n/**\n * Mutation hook for deleting an expense\n *\n * Deletes an expense record from the system.\n * Available in both admin and user modes (for test data cleanup).\n *\n * @example\n * ```tsx\n * const deleteExpense = useDeleteExpense();\n *\n * deleteExpense.mutate({\n *   userId: 'user123',\n *   tag: 'groceries'\n * });\n * ```\n */\nexport function useDeleteExpense(\n  options?: Omit<UseMutationOptions<void, Error, DeleteExpenseParams>, 'mutationFn'>\n) {\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn: async ({ userId, tag }: DeleteExpenseParams) => {\n      // Validate expense tag\n      const validated = ExpenseDeleteSchema.parse({ tag });\n\n      // DELETE expense\n      await api.delete(`/users/${userId}/expenses/${encodeURIComponent(validated.tag)}`);\n    },\n    onSuccess: (_, { userId }) => {\n      // Invalidate expenses query to refetch updated list\n      queryClient.invalidateQueries({\n        queryKey: expenseKeys.list(userId),\n      });\n    },\n    ...options,\n  });\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,147 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { ExpenseSearchParams, Expense } from '@pfm-platform/shared';
+import * as axios from 'axios';
+
+interface UseExpensesParams {
+    userId: string;
+    filters?: ExpenseSearchParams;
+}
+/**
+ * Fetch expenses for a user with optional filters
+ *
+ * @param params - User ID and optional filters (begin_on, end_on, threshold)
+ * @param options - Additional useQuery options
+ * @returns Query result with expenses array
+ */
+declare function useExpenses({ userId, filters }: UseExpensesParams, options?: Omit<UseQueryOptions<Expense[]>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<{
+    tag: string;
+    amount: string;
+}[], Error>;
+
+/**
+ * Expense create data interface
+ */
+interface ExpenseCreate {
+    tag: string;
+    amount: string;
+}
+/**
+ * Parameters for useCreateExpense mutation
+ */
+interface CreateExpenseParams {
+    userId: string;
+    data: ExpenseCreate;
+}
+/**
+ * Mutation hook for creating a new expense
+ *
+ * Creates an expense record manually for testing purposes.
+ * Uses mode switching for validation:
+ * - Admin mode: Allows manual expense creation for test data
+ * - User mode: Blocked (expenses are computed from transactions)
+ *
+ * @example
+ * ```tsx
+ * const createExpense = useCreateExpense();
+ *
+ * createExpense.mutate({
+ *   userId: 'user123',
+ *   data: {
+ *     tag: 'groceries',
+ *     amount: '123.45'
+ *   }
+ * });
+ * ```
+ */
+declare function useCreateExpense(options?: Omit<UseMutationOptions<Expense, Error, CreateExpenseParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    tag: string;
+    amount: string;
+}, Error, CreateExpenseParams, unknown>;
+
+/**
+ * Expense update data interface
+ */
+interface ExpenseUpdate {
+    amount?: string;
+}
+/**
+ * Parameters for useUpdateExpense mutation
+ */
+interface UpdateExpenseParams {
+    userId: string;
+    tag: string;
+    data: ExpenseUpdate;
+}
+/**
+ * Mutation hook for updating an expense
+ *
+ * Updates expense fields for testing purposes.
+ * Uses mode switching for validation:
+ * - Admin mode: Allows updating expenses for test scenarios
+ * - User mode: Blocked (expenses are computed from transactions)
+ *
+ * @example
+ * ```tsx
+ * const updateExpense = useUpdateExpense();
+ *
+ * updateExpense.mutate({
+ *   userId: 'user123',
+ *   tag: 'groceries',
+ *   data: {
+ *     amount: '200.00'
+ *   }
+ * });
+ * ```
+ */
+declare function useUpdateExpense(options?: Omit<UseMutationOptions<Expense, Error, UpdateExpenseParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    tag: string;
+    amount: string;
+}, Error, UpdateExpenseParams, unknown>;
+
+/**
+ * Parameters for useDeleteExpense mutation
+ */
+interface DeleteExpenseParams {
+    userId: string;
+    tag: string;
+}
+/**
+ * Mutation hook for deleting an expense
+ *
+ * Deletes an expense record from the system.
+ * Available in both admin and user modes (for test data cleanup).
+ *
+ * @example
+ * ```tsx
+ * const deleteExpense = useDeleteExpense();
+ *
+ * deleteExpense.mutate({
+ *   userId: 'user123',
+ *   tag: 'groceries'
+ * });
+ * ```
+ */
+declare function useDeleteExpense(options?: Omit<UseMutationOptions<void, Error, DeleteExpenseParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<void, Error, DeleteExpenseParams, unknown>;
+
+declare const expenseKeys: {
+    all: readonly ["expenses"];
+    lists: () => readonly ["expenses", "list"];
+    list: (userId: string, filters?: {
+        begin_on?: string;
+        end_on?: string;
+        threshold?: number;
+    }) => readonly ["expenses", "list", string, {
+        begin_on?: string;
+        end_on?: string;
+        threshold?: number;
+    } | undefined];
+};
+
+/**
+ * Axios instance for Expenses API
+ * Base URL configured through environment variables or defaults to relative path
+ */
+declare const api: axios.AxiosInstance;
+
+export { type CreateExpenseParams, type DeleteExpenseParams, type ExpenseCreate, type ExpenseUpdate, type UpdateExpenseParams, api, expenseKeys, useCreateExpense, useDeleteExpense, useExpenses, useUpdateExpense };

package/dist/index.d.ts

@@ -0,0 +1,147 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { ExpenseSearchParams, Expense } from '@pfm-platform/shared';
+import * as axios from 'axios';
+
+interface UseExpensesParams {
+    userId: string;
+    filters?: ExpenseSearchParams;
+}
+/**
+ * Fetch expenses for a user with optional filters
+ *
+ * @param params - User ID and optional filters (begin_on, end_on, threshold)
+ * @param options - Additional useQuery options
+ * @returns Query result with expenses array
+ */
+declare function useExpenses({ userId, filters }: UseExpensesParams, options?: Omit<UseQueryOptions<Expense[]>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<{
+    tag: string;
+    amount: string;
+}[], Error>;
+
+/**
+ * Expense create data interface
+ */
+interface ExpenseCreate {
+    tag: string;
+    amount: string;
+}
+/**
+ * Parameters for useCreateExpense mutation
+ */
+interface CreateExpenseParams {
+    userId: string;
+    data: ExpenseCreate;
+}
+/**
+ * Mutation hook for creating a new expense
+ *
+ * Creates an expense record manually for testing purposes.
+ * Uses mode switching for validation:
+ * - Admin mode: Allows manual expense creation for test data
+ * - User mode: Blocked (expenses are computed from transactions)
+ *
+ * @example
+ * ```tsx
+ * const createExpense = useCreateExpense();
+ *
+ * createExpense.mutate({
+ *   userId: 'user123',
+ *   data: {
+ *     tag: 'groceries',
+ *     amount: '123.45'
+ *   }
+ * });
+ * ```
+ */
+declare function useCreateExpense(options?: Omit<UseMutationOptions<Expense, Error, CreateExpenseParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    tag: string;
+    amount: string;
+}, Error, CreateExpenseParams, unknown>;
+
+/**
+ * Expense update data interface
+ */
+interface ExpenseUpdate {
+    amount?: string;
+}
+/**
+ * Parameters for useUpdateExpense mutation
+ */
+interface UpdateExpenseParams {
+    userId: string;
+    tag: string;
+    data: ExpenseUpdate;
+}
+/**
+ * Mutation hook for updating an expense
+ *
+ * Updates expense fields for testing purposes.
+ * Uses mode switching for validation:
+ * - Admin mode: Allows updating expenses for test scenarios
+ * - User mode: Blocked (expenses are computed from transactions)
+ *
+ * @example
+ * ```tsx
+ * const updateExpense = useUpdateExpense();
+ *
+ * updateExpense.mutate({
+ *   userId: 'user123',
+ *   tag: 'groceries',
+ *   data: {
+ *     amount: '200.00'
+ *   }
+ * });
+ * ```
+ */
+declare function useUpdateExpense(options?: Omit<UseMutationOptions<Expense, Error, UpdateExpenseParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    tag: string;
+    amount: string;
+}, Error, UpdateExpenseParams, unknown>;
+
+/**
+ * Parameters for useDeleteExpense mutation
+ */
+interface DeleteExpenseParams {
+    userId: string;
+    tag: string;
+}
+/**
+ * Mutation hook for deleting an expense
+ *
+ * Deletes an expense record from the system.
+ * Available in both admin and user modes (for test data cleanup).
+ *
+ * @example
+ * ```tsx
+ * const deleteExpense = useDeleteExpense();
+ *
+ * deleteExpense.mutate({
+ *   userId: 'user123',
+ *   tag: 'groceries'
+ * });
+ * ```
+ */
+declare function useDeleteExpense(options?: Omit<UseMutationOptions<void, Error, DeleteExpenseParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<void, Error, DeleteExpenseParams, unknown>;
+
+declare const expenseKeys: {
+    all: readonly ["expenses"];
+    lists: () => readonly ["expenses", "list"];
+    list: (userId: string, filters?: {
+        begin_on?: string;
+        end_on?: string;
+        threshold?: number;
+    }) => readonly ["expenses", "list", string, {
+        begin_on?: string;
+        end_on?: string;
+        threshold?: number;
+    } | undefined];
+};
+
+/**
+ * Axios instance for Expenses API
+ * Base URL configured through environment variables or defaults to relative path
+ */
+declare const api: axios.AxiosInstance;
+
+export { type CreateExpenseParams, type DeleteExpenseParams, type ExpenseCreate, type ExpenseUpdate, type UpdateExpenseParams, api, expenseKeys, useCreateExpense, useDeleteExpense, useExpenses, useUpdateExpense };

package/dist/index.js

@@ -0,0 +1,107 @@
+import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
+import { ExpenseSearchParamsSchema, ExpensesResponseSchema, useAppMode, ExpenseCreateSchemaAdmin, ExpenseCreateSchemaUser, ExpenseSchema, ExpenseUpdateSchemaAdmin, ExpenseUpdateSchemaUser, ExpenseDeleteSchema } from '@pfm-platform/shared';
+import axios from 'axios';
+
+// src/queries/useExpenses.ts
+var api = axios.create({
+  baseURL: "/api",
+  headers: {
+    "Content-Type": "application/json"
+  }
+});
+
+// src/keys.ts
+var expenseKeys = {
+  all: ["expenses"],
+  lists: () => [...expenseKeys.all, "list"],
+  list: (userId, filters) => [...expenseKeys.lists(), userId, filters]
+};
+
+// src/queries/useExpenses.ts
+function useExpenses({ userId, filters }, options) {
+  return useQuery({
+    queryKey: expenseKeys.list(userId, filters),
+    queryFn: async () => {
+      let validatedFilters = filters;
+      if (filters) {
+        validatedFilters = ExpenseSearchParamsSchema.parse(filters);
+      }
+      const params = new URLSearchParams();
+      if (validatedFilters?.begin_on) {
+        params.append("begin_on", validatedFilters.begin_on);
+      }
+      if (validatedFilters?.end_on) {
+        params.append("end_on", validatedFilters.end_on);
+      }
+      if (validatedFilters?.threshold !== void 0) {
+        params.append("threshold", validatedFilters.threshold.toString());
+      }
+      const queryString = params.toString();
+      const url = `/users/${userId}/expenses${queryString ? `?${queryString}` : ""}`;
+      const response = await api.get(url);
+      const validated = ExpensesResponseSchema.parse(response.data);
+      return validated.expenses;
+    },
+    staleTime: 1e3 * 60 * 5,
+    // 5 minutes (aggregated data, moderate update frequency)
+    ...options
+  });
+}
+function useCreateExpense(options) {
+  const queryClient = useQueryClient();
+  const { mode } = useAppMode();
+  return useMutation({
+    mutationFn: async ({ userId, data }) => {
+      const schema = mode === "admin" ? ExpenseCreateSchemaAdmin : ExpenseCreateSchemaUser;
+      const validated = schema.parse(data);
+      const response = await api.post(`/users/${userId}/expenses`, validated);
+      return ExpenseSchema.parse(response.data);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({
+        queryKey: expenseKeys.list(userId)
+      });
+    },
+    ...options
+  });
+}
+function useUpdateExpense(options) {
+  const queryClient = useQueryClient();
+  const { mode } = useAppMode();
+  return useMutation({
+    mutationFn: async ({ userId, tag, data }) => {
+      const schema = mode === "admin" ? ExpenseUpdateSchemaAdmin : ExpenseUpdateSchemaUser;
+      const validated = schema.parse(data);
+      const response = await api.put(
+        `/users/${userId}/expenses/${encodeURIComponent(tag)}`,
+        validated
+      );
+      return ExpenseSchema.parse(response.data);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({
+        queryKey: expenseKeys.list(userId)
+      });
+    },
+    ...options
+  });
+}
+function useDeleteExpense(options) {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: async ({ userId, tag }) => {
+      const validated = ExpenseDeleteSchema.parse({ tag });
+      await api.delete(`/users/${userId}/expenses/${encodeURIComponent(validated.tag)}`);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({
+        queryKey: expenseKeys.list(userId)
+      });
+    },
+    ...options
+  });
+}
+
+export { api, expenseKeys, useCreateExpense, useDeleteExpense, useExpenses, useUpdateExpense };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/keys.ts","../src/queries/useExpenses.ts","../src/mutations/useCreateExpense.ts","../src/mutations/useUpdateExpense.ts","../src/mutations/useDeleteExpense.ts"],"names":["useQueryClient","useAppMode","useMutation","ExpenseSchema"],"mappings":"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","file":"index.js","sourcesContent":["import axios from 'axios';\n\n/**\n * Axios instance for Expenses API\n * Base URL configured through environment variables or defaults to relative path\n */\nexport const api = axios.create({\n  baseURL: '/api',\n  headers: {\n    'Content-Type': 'application/json',\n  },\n});\n","export const expenseKeys = {\n  all: ['expenses'] as const,\n  lists: () => [...expenseKeys.all, 'list'] as const,\n  list: (\n    userId: string,\n    filters?: { begin_on?: string; end_on?: string; threshold?: number }\n  ) => [...expenseKeys.lists(), userId, filters] as const,\n};\n","import { useQuery } from '@tanstack/react-query';\nimport type { UseQueryOptions } from '@tanstack/react-query';\nimport {\n  ExpensesResponseSchema,\n  ExpenseSearchParamsSchema,\n  type Expense,\n  type ExpenseSearchParams,\n} from '@pfm-platform/shared';\nimport { api } from '../client';\nimport { expenseKeys } from '../keys';\n\ninterface UseExpensesParams {\n  userId: string;\n  filters?: ExpenseSearchParams;\n}\n\n/**\n * Fetch expenses for a user with optional filters\n *\n * @param params - User ID and optional filters (begin_on, end_on, threshold)\n * @param options - Additional useQuery options\n * @returns Query result with expenses array\n */\nexport function useExpenses(\n  { userId, filters }: UseExpensesParams,\n  options?: Omit<UseQueryOptions<Expense[]>, 'queryKey' | 'queryFn'>\n) {\n  return useQuery({\n    queryKey: expenseKeys.list(userId, filters),\n    queryFn: async () => {\n      // Validate filters if provided\n      let validatedFilters = filters;\n      if (filters) {\n        validatedFilters = ExpenseSearchParamsSchema.parse(filters);\n      }\n\n      const params = new URLSearchParams();\n\n      if (validatedFilters?.begin_on) {\n        params.append('begin_on', validatedFilters.begin_on);\n      }\n      if (validatedFilters?.end_on) {\n        params.append('end_on', validatedFilters.end_on);\n      }\n      if (validatedFilters?.threshold !== undefined) {\n        params.append('threshold', validatedFilters.threshold.toString());\n      }\n\n      const queryString = params.toString();\n      const url = `/users/${userId}/expenses${queryString ? `?${queryString}` : ''}`;\n\n      const response = await api.get(url);\n      const validated = ExpensesResponseSchema.parse(response.data);\n      return validated.expenses;\n    },\n    staleTime: 1000 * 60 * 5, // 5 minutes (aggregated data, moderate update frequency)\n    ...options,\n  });\n}\n","import {\n  useMutation,\n  useQueryClient,\n  type UseMutationOptions,\n} from '@tanstack/react-query';\nimport {\n  ExpenseCreateSchemaAdmin,\n  ExpenseCreateSchemaUser,\n  ExpenseSchema,\n  useAppMode,\n  type Expense,\n} from '@pfm-platform/shared';\nimport { api } from '../client';\nimport { expenseKeys } from '../keys';\n\n/**\n * Expense create data interface\n */\nexport interface ExpenseCreate {\n  tag: string;\n  amount: string;\n}\n\n/**\n * Parameters for useCreateExpense mutation\n */\nexport interface CreateExpenseParams {\n  userId: string;\n  data: ExpenseCreate;\n}\n\n/**\n * Mutation hook for creating a new expense\n *\n * Creates an expense record manually for testing purposes.\n * Uses mode switching for validation:\n * - Admin mode: Allows manual expense creation for test data\n * - User mode: Blocked (expenses are computed from transactions)\n *\n * @example\n * ```tsx\n * const createExpense = useCreateExpense();\n *\n * createExpense.mutate({\n *   userId: 'user123',\n *   data: {\n *     tag: 'groceries',\n *     amount: '123.45'\n *   }\n * });\n * ```\n */\nexport function useCreateExpense(\n  options?: Omit<UseMutationOptions<Expense, Error, CreateExpenseParams>, 'mutationFn'>\n) {\n  const queryClient = useQueryClient();\n  const { mode } = useAppMode();\n\n  return useMutation({\n    mutationFn: async ({ userId, data }: CreateExpenseParams) => {\n      // Select schema based on mode\n      const schema =\n        mode === 'admin'\n          ? ExpenseCreateSchemaAdmin\n          : ExpenseCreateSchemaUser;\n\n      // Validate expense data\n      const validated = schema.parse(data);\n\n      // POST to create new expense\n      const response = await api.post(`/users/${userId}/expenses`, validated);\n\n      // Return created expense\n      return ExpenseSchema.parse(response.data);\n    },\n    onSuccess: (_, { userId }) => {\n      // Invalidate expenses query to refetch updated list\n      queryClient.invalidateQueries({\n        queryKey: expenseKeys.list(userId),\n      });\n    },\n    ...options,\n  });\n}\n","import {\n  useMutation,\n  useQueryClient,\n  type UseMutationOptions,\n} from '@tanstack/react-query';\nimport {\n  ExpenseUpdateSchemaAdmin,\n  ExpenseUpdateSchemaUser,\n  ExpenseSchema,\n  useAppMode,\n  type Expense,\n} from '@pfm-platform/shared';\nimport { api } from '../client';\nimport { expenseKeys } from '../keys';\n\n/**\n * Expense update data interface\n */\nexport interface ExpenseUpdate {\n  amount?: string;\n}\n\n/**\n * Parameters for useUpdateExpense mutation\n */\nexport interface UpdateExpenseParams {\n  userId: string;\n  tag: string;\n  data: ExpenseUpdate;\n}\n\n/**\n * Mutation hook for updating an expense\n *\n * Updates expense fields for testing purposes.\n * Uses mode switching for validation:\n * - Admin mode: Allows updating expenses for test scenarios\n * - User mode: Blocked (expenses are computed from transactions)\n *\n * @example\n * ```tsx\n * const updateExpense = useUpdateExpense();\n *\n * updateExpense.mutate({\n *   userId: 'user123',\n *   tag: 'groceries',\n *   data: {\n *     amount: '200.00'\n *   }\n * });\n * ```\n */\nexport function useUpdateExpense(\n  options?: Omit<UseMutationOptions<Expense, Error, UpdateExpenseParams>, 'mutationFn'>\n) {\n  const queryClient = useQueryClient();\n  const { mode } = useAppMode();\n\n  return useMutation({\n    mutationFn: async ({ userId, tag, data }: UpdateExpenseParams) => {\n      // Select schema based on mode\n      const schema =\n        mode === 'admin'\n          ? ExpenseUpdateSchemaAdmin\n          : ExpenseUpdateSchemaUser;\n\n      // Validate expense update data\n      const validated = schema.parse(data);\n\n      // PUT to update expense\n      const response = await api.put(\n        `/users/${userId}/expenses/${encodeURIComponent(tag)}`,\n        validated\n      );\n\n      // Return updated expense\n      return ExpenseSchema.parse(response.data);\n    },\n    onSuccess: (_, { userId }) => {\n      // Invalidate expenses query to refetch updated list\n      queryClient.invalidateQueries({\n        queryKey: expenseKeys.list(userId),\n      });\n    },\n    ...options,\n  });\n}\n","import {\n  useMutation,\n  useQueryClient,\n  type UseMutationOptions,\n} from '@tanstack/react-query';\nimport { ExpenseDeleteSchema } from '@pfm-platform/shared';\nimport { api } from '../client';\nimport { expenseKeys } from '../keys';\n\n/**\n * Parameters for useDeleteExpense mutation\n */\nexport interface DeleteExpenseParams {\n  userId: string;\n  tag: string;\n}\n\n/**\n * Mutation hook for deleting an expense\n *\n * Deletes an expense record from the system.\n * Available in both admin and user modes (for test data cleanup).\n *\n * @example\n * ```tsx\n * const deleteExpense = useDeleteExpense();\n *\n * deleteExpense.mutate({\n *   userId: 'user123',\n *   tag: 'groceries'\n * });\n * ```\n */\nexport function useDeleteExpense(\n  options?: Omit<UseMutationOptions<void, Error, DeleteExpenseParams>, 'mutationFn'>\n) {\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn: async ({ userId, tag }: DeleteExpenseParams) => {\n      // Validate expense tag\n      const validated = ExpenseDeleteSchema.parse({ tag });\n\n      // DELETE expense\n      await api.delete(`/users/${userId}/expenses/${encodeURIComponent(validated.tag)}`);\n    },\n    onSuccess: (_, { userId }) => {\n      // Invalidate expenses query to refetch updated list\n      queryClient.invalidateQueries({\n        queryKey: expenseKeys.list(userId),\n      });\n    },\n    ...options,\n  });\n}\n"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@pfm-platform/expenses-data-access",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "dependencies": {
+    "axios": "^1.13.2",
+    "zod": "4.1.12",
+    "@pfm-platform/shared": "0.0.1"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@vitejs/plugin-react": "^5.1.1",
+    "@vitest/coverage-v8": "^4.0.9",
+    "jsdom": "^27.2.0",
+    "react-dom": "19.2.0",
+    "typescript": "5.9.3",
+    "vitest": "4.0.9"
+  },
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "description": "Personal Finance Management - EXPENSES data-access layer",
+  "keywords": [
+    "pfm",
+    "finance",
+    "expenses",
+    "data-access",
+    "react",
+    "typescript"
+  ],
+  "author": "Lenny Miller",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lennylmiller/pfm-research",
+    "directory": "packages/expenses/data-access"
+  },
+  "bugs": "https://github.com/lennylmiller/pfm-research/issues",
+  "homepage": "https://github.com/lennylmiller/pfm-research#readme",
+  "peerDependencies": {
+    "@tanstack/react-query": "5.90.9",
+    "react": "19.2.0"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean"
+  }
+}