npm - @pfm-platform/budgets-data-access - Versions diffs - 0.1.1 - Mend

@pfm-platform/budgets-data-access 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.cjs ADDED Viewed

@@ -0,0 +1,144 @@
+'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/useBudgets.ts
+// src/keys.ts
+var budgetKeys = {
+  all: ["budgets"],
+  lists: () => [...budgetKeys.all, "list"],
+  list: (userId, filters) => [...budgetKeys.lists(), userId, filters ?? {}],
+  details: () => [...budgetKeys.all, "detail"],
+  detail: (userId, budgetId) => [...budgetKeys.details(), userId, budgetId]
+};
+var api = axios__default.default.create({
+  baseURL: "/api",
+  headers: {
+    "Content-Type": "application/json"
+  },
+  timeout: 1e4
+});
+api.interceptors.request.use(
+  (config) => {
+    const token = localStorage.getItem("auth_token");
+    if (token) {
+      config.headers.Authorization = `Bearer ${token}`;
+    }
+    return config;
+  },
+  (error) => Promise.reject(error)
+);
+api.interceptors.response.use(
+  (response) => response,
+  (error) => {
+    if (error.response?.status === 401) {
+      localStorage.removeItem("auth_token");
+      window.location.href = "/login";
+    }
+    return Promise.reject(error);
+  }
+);
+// src/queries/useBudgets.ts
+function useBudgets(params, options) {
+  const { userId, filters = {} } = params;
+  return reactQuery.useQuery({
+    queryKey: budgetKeys.list(userId, filters),
+    queryFn: async () => {
+      const queryParams = new URLSearchParams();
+      if (filters.start_date) {
+        queryParams.append("start_date", filters.start_date);
+      }
+      if (filters.end_date) {
+        queryParams.append("end_date", filters.end_date);
+      }
+      const queryString = queryParams.toString();
+      const url = `/users/${userId}/budgets${queryString ? `?${queryString}` : ""}`;
+      const response = await api.get(url);
+      return shared.BudgetsResponseSchema.parse(response.data);
+    },
+    staleTime: 1e3 * 60 * 5,
+    // 5 minutes - budgets change less frequently than transactions
+    ...options
+  });
+}
+function useBudget(params, options) {
+  const { userId, budgetId } = params;
+  return reactQuery.useQuery({
+    queryKey: budgetKeys.detail(userId, budgetId),
+    queryFn: async () => {
+      const response = await api.get(`/users/${userId}/budgets/${budgetId}`);
+      return shared.BudgetSchema.parse(response.data);
+    },
+    staleTime: 1e3 * 60 * 5,
+    // 5 minutes
+    ...options
+  });
+}
+function useCreateBudget(options) {
+  const queryClient = reactQuery.useQueryClient();
+  return reactQuery.useMutation({
+    mutationFn: async ({ userId, data }) => {
+      const validated = shared.BudgetCreateSchema.parse(data);
+      const response = await api.post(`/users/${userId}/budgets`, {
+        budget: validated
+      });
+      return shared.BudgetSchema.parse(response.data);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({ queryKey: budgetKeys.lists() });
+    },
+    ...options
+  });
+}
+function useUpdateBudget(options) {
+  const queryClient = reactQuery.useQueryClient();
+  return reactQuery.useMutation({
+    mutationFn: async ({ userId, budgetId, data }) => {
+      const validated = shared.BudgetUpdateSchema.parse(data);
+      const response = await api.put(`/users/${userId}/budgets/${budgetId}`, {
+        budget: validated
+      });
+      return shared.BudgetSchema.parse(response.data);
+    },
+    onSuccess: (_, { userId, budgetId }) => {
+      queryClient.invalidateQueries({ queryKey: budgetKeys.lists() });
+      queryClient.invalidateQueries({
+        queryKey: budgetKeys.detail(userId, budgetId)
+      });
+    },
+    ...options
+  });
+}
+function useDeleteBudget(options) {
+  const queryClient = reactQuery.useQueryClient();
+  return reactQuery.useMutation({
+    mutationFn: async ({ userId, budgetId }) => {
+      await api.delete(`/users/${userId}/budgets/${budgetId}`);
+    },
+    onSuccess: (_, { userId, budgetId }) => {
+      queryClient.invalidateQueries({ queryKey: budgetKeys.lists() });
+      queryClient.invalidateQueries({
+        queryKey: budgetKeys.detail(userId, budgetId)
+      });
+    },
+    ...options
+  });
+}
+exports.api = api;
+exports.budgetKeys = budgetKeys;
+exports.useBudget = useBudget;
+exports.useBudgets = useBudgets;
+exports.useCreateBudget = useCreateBudget;
+exports.useDeleteBudget = useDeleteBudget;
+exports.useUpdateBudget = useUpdateBudget;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/keys.ts","../src/client.ts","../src/queries/useBudgets.ts","../src/queries/useBudget.ts","../src/mutations/useCreateBudget.ts","../src/mutations/useUpdateBudget.ts","../src/mutations/useDeleteBudget.ts"],"names":["axios","useQuery","BudgetsResponseSchema","BudgetSchema","useQueryClient","useMutation","BudgetCreateSchema","BudgetUpdateSchema"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Query key factory for Budget domain\n * Hierarchical structure for efficient cache invalidation\n */\n\nexport interface BudgetDateRangeFilters {\n start_date?: string; // RFC 3339 format\n end_date?: string; // RFC 3339 format\n}\n\nexport const budgetKeys = {\n all: ['budgets'] as const,\n lists: () => [...budgetKeys.all, 'list'] as const,\n list: (userId: string, filters?: BudgetDateRangeFilters) =>\n [...budgetKeys.lists(), userId, filters ?? {}] as const,\n details: () => [...budgetKeys.all, 'detail'] as const,\n detail: (userId: string, budgetId: number) =>\n [...budgetKeys.details(), userId, budgetId] as const,\n};\n","/**\n * Axios client for Budget API calls\n * Reuses pattern from accounts/transactions data-access\n */\n\nimport axios from 'axios';\n\nexport const api = axios.create({\n baseURL: '/api',\n headers: {\n 'Content-Type': 'application/json',\n },\n timeout: 10000,\n});\n\n// Request interceptor - Add auth token\napi.interceptors.request.use(\n (config) => {\n const token = localStorage.getItem('auth_token');\n if (token) {\n config.headers.Authorization = `Bearer ${token}`;\n }\n return config;\n },\n (error) => Promise.reject(error)\n);\n\n// Response interceptor - Handle 401 unauthorized\napi.interceptors.response.use(\n (response) => response,\n (error) => {\n if (error.response?.status === 401) {\n // Clear token and redirect to login\n localStorage.removeItem('auth_token');\n window.location.href = '/login';\n }\n return Promise.reject(error);\n }\n);\n","/**\n * Query hook for fetching budgets list\n * Legacy API: GET /users/{userId}/budgets\n * Optional filters: start_date, end_date (RFC 3339 format)\n */\n\nimport { useQuery, UseQueryOptions } from '@tanstack/react-query';\nimport { BudgetsResponseSchema, BudgetsResponse } from '@pfm-platform/shared';\nimport { budgetKeys, BudgetDateRangeFilters } from '../keys';\nimport { api } from '../client';\n\nexport interface UseBudgetsParams {\n userId: string;\n filters?: BudgetDateRangeFilters;\n}\n\n/**\n * Fetch budgets with optional date range filters\n * Uses Zod validation to ensure API response matches expected schema\n *\n * @param params - Query parameters with userId and optional date range filters\n * @param options - TanStack Query options\n * @returns Query result with validated budgets data\n *\n * @example\n * ```tsx\n * // Fetch all budgets\n * function BudgetsList() {\n * const { data, isLoading } = useBudgets({ userId: 'user123' });\n *\n * return (\n * <ul>\n * {data?.budgets.map(budget => (\n * <li key={budget.id}>{budget.name}</li>\n * ))}\n * </ul>\n * );\n * }\n *\n * // Fetch budgets for specific date range\n * function MonthBudgets() {\n * const { data } = useBudgets({\n * userId: 'user123',\n * filters: {\n * start_date: '2025-01-01T00:00:00Z',\n * end_date: '2025-01-31T23:59:59Z',\n * }\n * });\n *\n * return <BudgetList budgets={data?.budgets} />;\n * }\n * ```\n */\nexport function useBudgets(\n params: UseBudgetsParams,\n options?: Omit<UseQueryOptions<BudgetsResponse>, 'queryKey' | 'queryFn'>\n) {\n const { userId, filters = {} } = params;\n\n return useQuery({\n queryKey: budgetKeys.list(userId, filters),\n queryFn: async () => {\n // Build query parameters\n const queryParams = new URLSearchParams();\n\n if (filters.start_date) {\n queryParams.append('start_date', filters.start_date);\n }\n\n if (filters.end_date) {\n queryParams.append('end_date', filters.end_date);\n }\n\n const queryString = queryParams.toString();\n const url = `/users/${userId}/budgets${\n queryString ? `?${queryString}` : ''\n }`;\n\n const response = await api.get(url);\n\n // Validate response with Zod schema from Mini-Arc 1\n return BudgetsResponseSchema.parse(response.data);\n },\n staleTime: 1000 * 60 * 5, // 5 minutes - budgets change less frequently than transactions\n ...options,\n });\n}\n","/**\n * Query hook for fetching a single budget\n * Legacy API: GET /users/{userId}/budgets/{id}\n */\n\nimport { useQuery, UseQueryOptions } from '@tanstack/react-query';\nimport { BudgetSchema, Budget } from '@pfm-platform/shared';\nimport { budgetKeys } from '../keys';\nimport { api } from '../client';\n\nexport interface UseBudgetParams {\n userId: string;\n budgetId: number;\n}\n\n/**\n * Fetch a single budget by ID\n * Uses Zod validation to ensure API response matches expected schema\n *\n * @param params - Query parameters with userId and budgetId\n * @param options - TanStack Query options\n * @returns Query result with validated budget data\n *\n * @example\n * ```tsx\n * function BudgetDetail({ budgetId }: { budgetId: number }) {\n * const { data, isLoading, error } = useBudget({\n * userId: 'user123',\n * budgetId\n * });\n *\n * if (isLoading) return <div>Loading...</div>;\n * if (error) return <div>Error: {error.message}</div>;\n *\n * return (\n * <div>\n * <h1>{data.name}</h1>\n * <p>Amount: ${data.budget_amount}</p>\n * <p>Spent: ${data.spent}</p>\n * <p>State: {data.state}</p>\n * </div>\n * );\n * }\n * ```\n */\nexport function useBudget(\n params: UseBudgetParams,\n options?: Omit<UseQueryOptions<Budget>, 'queryKey' | 'queryFn'>\n) {\n const { userId, budgetId } = params;\n\n return useQuery({\n queryKey: budgetKeys.detail(userId, budgetId),\n queryFn: async () => {\n const response = await api.get(`/users/${userId}/budgets/${budgetId}`);\n\n // Validate response with Zod schema from Mini-Arc 1\n return BudgetSchema.parse(response.data);\n },\n staleTime: 1000 * 60 * 5, // 5 minutes\n ...options,\n });\n}\n","/**\n * Mutation hook for creating a budget\n * Legacy API: POST /users/{userId}/budgets\n */\n\nimport {\n useMutation,\n UseMutationOptions,\n useQueryClient,\n} from '@tanstack/react-query';\nimport {\n BudgetCreateSchema,\n BudgetSchema,\n Budget,\n BudgetCreate,\n} from '@pfm-platform/shared';\nimport { budgetKeys } from '../keys';\nimport { api } from '../client';\n\nexport interface CreateBudgetParams {\n userId: string;\n data: BudgetCreate;\n}\n\n/**\n * Create a new budget\n * Validates input with Zod schema and invalidates related queries on success\n *\n * @param options - TanStack Mutation options\n * @returns Mutation result\n *\n * @example\n * ```tsx\n * function BudgetCreateForm() {\n * const createBudget = useCreateBudget();\n *\n * const handleSubmit = (formData) => {\n * createBudget.mutate({\n * userId: 'user123',\n * data: {\n * name: formData.name,\n * budget_amount: formData.amount,\n * tag_names: formData.tags,\n * account_list: formData.accounts,\n * show_on_dashboard: true,\n * other: {}\n * }\n * }, {\n * onSuccess: (newBudget) => {\n * toast.success('Budget created!');\n * router.push(`/budgets/${newBudget.id}`);\n * },\n * onError: (error) => {\n * toast.error(`Failed: ${error.message}`);\n * }\n * });\n * };\n *\n * return <form onSubmit={handleSubmit}>...</form>;\n * }\n * ```\n */\nexport function useCreateBudget(\n options?: Omit<UseMutationOptions<Budget, Error, CreateBudgetParams>, 'mutationFn'>\n) {\n const queryClient = useQueryClient();\n\n return useMutation({\n mutationFn: async ({ userId, data }: CreateBudgetParams) => {\n // Validate input with Zod schema from Mini-Arc 1\n const validated = BudgetCreateSchema.parse(data);\n\n const response = await api.post(`/users/${userId}/budgets`, {\n budget: validated,\n });\n\n // Validate response\n return BudgetSchema.parse(response.data);\n },\n onSuccess: (_, { userId }) => {\n // Invalidate budget list queries for this user\n queryClient.invalidateQueries({ queryKey: budgetKeys.lists() });\n },\n ...options,\n });\n}\n","/**\n * Mutation hook for updating a budget\n * Legacy API: PUT /users/{userId}/budgets/{id}\n */\n\nimport {\n useMutation,\n UseMutationOptions,\n useQueryClient,\n} from '@tanstack/react-query';\nimport {\n BudgetUpdateSchema,\n BudgetSchema,\n Budget,\n BudgetUpdate,\n} from '@pfm-platform/shared';\nimport { budgetKeys } from '../keys';\nimport { api } from '../client';\n\nexport interface UpdateBudgetParams {\n userId: string;\n budgetId: number;\n data: BudgetUpdate;\n}\n\n/**\n * Update an existing budget\n * Validates input with Zod schema and invalidates related queries on success\n *\n * @param options - TanStack Mutation options\n * @returns Mutation result\n *\n * @example\n * ```tsx\n * function BudgetEditForm({ budget }: { budget: Budget }) {\n * const updateBudget = useUpdateBudget();\n *\n * const handleSubmit = (formData) => {\n * updateBudget.mutate({\n * userId: 'user123',\n * budgetId: budget.id,\n * data: {\n * name: formData.name,\n * budget_amount: formData.amount,\n * tag_names: formData.tags,\n * account_list: formData.accounts,\n * show_on_dashboard: formData.showOnDashboard,\n * other: formData.metadata\n * }\n * }, {\n * onSuccess: () => {\n * toast.success('Budget updated!');\n * },\n * onError: (error) => {\n * toast.error(`Failed: ${error.message}`);\n * }\n * });\n * };\n *\n * return <form onSubmit={handleSubmit}>...</form>;\n * }\n * ```\n */\nexport function useUpdateBudget(\n options?: Omit<UseMutationOptions<Budget, Error, UpdateBudgetParams>, 'mutationFn'>\n) {\n const queryClient = useQueryClient();\n\n return useMutation({\n mutationFn: async ({ userId, budgetId, data }: UpdateBudgetParams) => {\n // Validate input with Zod schema from Mini-Arc 1\n const validated = BudgetUpdateSchema.parse(data);\n\n const response = await api.put(`/users/${userId}/budgets/${budgetId}`, {\n budget: validated,\n });\n\n // Validate response\n return BudgetSchema.parse(response.data);\n },\n onSuccess: (_, { userId, budgetId }) => {\n // Invalidate list queries\n queryClient.invalidateQueries({ queryKey: budgetKeys.lists() });\n // Invalidate this specific budget\n queryClient.invalidateQueries({\n queryKey: budgetKeys.detail(userId, budgetId),\n });\n },\n ...options,\n });\n}\n","/**\n * Mutation hook for deleting a budget\n * Legacy API: DELETE /users/{userId}/budgets/{id}\n */\n\nimport {\n useMutation,\n UseMutationOptions,\n useQueryClient,\n} from '@tanstack/react-query';\nimport { budgetKeys } from '../keys';\nimport { api } from '../client';\n\nexport interface DeleteBudgetParams {\n userId: string;\n budgetId: number;\n}\n\n/**\n * Delete a budget\n * Removes budget from user's budgets list\n * Invalidates related queries on success\n *\n * @param options - TanStack Mutation options\n * @returns Mutation result\n *\n * @example\n * ```tsx\n * function BudgetDeleteButton({ budgetId }: { budgetId: number }) {\n * const deleteBudget = useDeleteBudget();\n *\n * const handleDelete = () => {\n * if (confirm('Are you sure you want to delete this budget?')) {\n * deleteBudget.mutate({\n * userId: 'user123',\n * budgetId\n * }, {\n * onSuccess: () => {\n * toast.success('Budget deleted');\n * router.push('/budgets');\n * },\n * onError: (error) => {\n * toast.error(`Failed: ${error.message}`);\n * }\n * });\n * }\n * };\n *\n * return (\n * <button\n * onClick={handleDelete}\n * disabled={deleteBudget.isPending}\n * >\n * {deleteBudget.isPending ? 'Deleting...' : 'Delete'}\n * </button>\n * );\n * }\n * ```\n */\nexport function useDeleteBudget(\n options?: Omit<UseMutationOptions<void, Error, DeleteBudgetParams>, 'mutationFn'>\n) {\n const queryClient = useQueryClient();\n\n return useMutation({\n mutationFn: async ({ userId, budgetId }: DeleteBudgetParams) => {\n await api.delete(`/users/${userId}/budgets/${budgetId}`);\n // DELETE returns 204 No Content - no response body to validate\n },\n onSuccess: (_, { userId, budgetId }) => {\n // Invalidate list queries\n queryClient.invalidateQueries({ queryKey: budgetKeys.lists() });\n // Invalidate this specific budget\n queryClient.invalidateQueries({\n queryKey: budgetKeys.detail(userId, budgetId),\n });\n },\n ...options,\n });\n}\n"]}

package/dist/index.d.cts ADDED Viewed

@@ -0,0 +1,297 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { BudgetsResponse, Budget, BudgetCreate, BudgetUpdate } from '@pfm-platform/shared';
+import * as axios from 'axios';
+/**
+ * Query key factory for Budget domain
+ * Hierarchical structure for efficient cache invalidation
+ */
+interface BudgetDateRangeFilters {
+    start_date?: string;
+    end_date?: string;
+}
+declare const budgetKeys: {
+    all: readonly ["budgets"];
+    lists: () => readonly ["budgets", "list"];
+    list: (userId: string, filters?: BudgetDateRangeFilters) => readonly ["budgets", "list", string, BudgetDateRangeFilters];
+    details: () => readonly ["budgets", "detail"];
+    detail: (userId: string, budgetId: number) => readonly ["budgets", "detail", string, number];
+};
+interface UseBudgetsParams {
+    userId: string;
+    filters?: BudgetDateRangeFilters;
+}
+/**
+ * Fetch budgets with optional date range filters
+ * Uses Zod validation to ensure API response matches expected schema
+ *
+ * @param params - Query parameters with userId and optional date range filters
+ * @param options - TanStack Query options
+ * @returns Query result with validated budgets data
+ *
+ * @example
+ * ```tsx
+ * // Fetch all budgets
+ * function BudgetsList() {
+ *   const { data, isLoading } = useBudgets({ userId: 'user123' });
+ *
+ *   return (
+ *     <ul>
+ *       {data?.budgets.map(budget => (
+ *         <li key={budget.id}>{budget.name}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ *
+ * // Fetch budgets for specific date range
+ * function MonthBudgets() {
+ *   const { data } = useBudgets({
+ *     userId: 'user123',
+ *     filters: {
+ *       start_date: '2025-01-01T00:00:00Z',
+ *       end_date: '2025-01-31T23:59:59Z',
+ *     }
+ *   });
+ *
+ *   return <BudgetList budgets={data?.budgets} />;
+ * }
+ * ```
+ */
+declare function useBudgets(params: UseBudgetsParams, options?: Omit<UseQueryOptions<BudgetsResponse>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<{
+    budgets: {
+        id: number;
+        month: number;
+        year: number;
+        name: string;
+        state: "under" | "risk" | "over";
+        spent: number;
+        budget_amount: number;
+        tag_names: string[];
+        links: {
+            accounts: number[];
+            budget_histories: number[];
+        };
+    }[];
+}, Error>;
+interface UseBudgetParams {
+    userId: string;
+    budgetId: number;
+}
+/**
+ * Fetch a single budget by ID
+ * Uses Zod validation to ensure API response matches expected schema
+ *
+ * @param params - Query parameters with userId and budgetId
+ * @param options - TanStack Query options
+ * @returns Query result with validated budget data
+ *
+ * @example
+ * ```tsx
+ * function BudgetDetail({ budgetId }: { budgetId: number }) {
+ *   const { data, isLoading, error } = useBudget({
+ *     userId: 'user123',
+ *     budgetId
+ *   });
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       <h1>{data.name}</h1>
+ *       <p>Amount: ${data.budget_amount}</p>
+ *       <p>Spent: ${data.spent}</p>
+ *       <p>State: {data.state}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useBudget(params: UseBudgetParams, options?: Omit<UseQueryOptions<Budget>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<{
+    id: number;
+    month: number;
+    year: number;
+    name: string;
+    state: "under" | "risk" | "over";
+    spent: number;
+    budget_amount: number;
+    tag_names: string[];
+    links: {
+        accounts: number[];
+        budget_histories: number[];
+    };
+}, Error>;
+interface CreateBudgetParams {
+    userId: string;
+    data: BudgetCreate;
+}
+/**
+ * Create a new budget
+ * Validates input with Zod schema and invalidates related queries on success
+ *
+ * @param options - TanStack Mutation options
+ * @returns Mutation result
+ *
+ * @example
+ * ```tsx
+ * function BudgetCreateForm() {
+ *   const createBudget = useCreateBudget();
+ *
+ *   const handleSubmit = (formData) => {
+ *     createBudget.mutate({
+ *       userId: 'user123',
+ *       data: {
+ *         name: formData.name,
+ *         budget_amount: formData.amount,
+ *         tag_names: formData.tags,
+ *         account_list: formData.accounts,
+ *         show_on_dashboard: true,
+ *         other: {}
+ *       }
+ *     }, {
+ *       onSuccess: (newBudget) => {
+ *         toast.success('Budget created!');
+ *         router.push(`/budgets/${newBudget.id}`);
+ *       },
+ *       onError: (error) => {
+ *         toast.error(`Failed: ${error.message}`);
+ *       }
+ *     });
+ *   };
+ *
+ *   return <form onSubmit={handleSubmit}>...</form>;
+ * }
+ * ```
+ */
+declare function useCreateBudget(options?: Omit<UseMutationOptions<Budget, Error, CreateBudgetParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    id: number;
+    month: number;
+    year: number;
+    name: string;
+    state: "under" | "risk" | "over";
+    spent: number;
+    budget_amount: number;
+    tag_names: string[];
+    links: {
+        accounts: number[];
+        budget_histories: number[];
+    };
+}, Error, CreateBudgetParams, unknown>;
+interface UpdateBudgetParams {
+    userId: string;
+    budgetId: number;
+    data: BudgetUpdate;
+}
+/**
+ * Update an existing budget
+ * Validates input with Zod schema and invalidates related queries on success
+ *
+ * @param options - TanStack Mutation options
+ * @returns Mutation result
+ *
+ * @example
+ * ```tsx
+ * function BudgetEditForm({ budget }: { budget: Budget }) {
+ *   const updateBudget = useUpdateBudget();
+ *
+ *   const handleSubmit = (formData) => {
+ *     updateBudget.mutate({
+ *       userId: 'user123',
+ *       budgetId: budget.id,
+ *       data: {
+ *         name: formData.name,
+ *         budget_amount: formData.amount,
+ *         tag_names: formData.tags,
+ *         account_list: formData.accounts,
+ *         show_on_dashboard: formData.showOnDashboard,
+ *         other: formData.metadata
+ *       }
+ *     }, {
+ *       onSuccess: () => {
+ *         toast.success('Budget updated!');
+ *       },
+ *       onError: (error) => {
+ *         toast.error(`Failed: ${error.message}`);
+ *       }
+ *     });
+ *   };
+ *
+ *   return <form onSubmit={handleSubmit}>...</form>;
+ * }
+ * ```
+ */
+declare function useUpdateBudget(options?: Omit<UseMutationOptions<Budget, Error, UpdateBudgetParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    id: number;
+    month: number;
+    year: number;
+    name: string;
+    state: "under" | "risk" | "over";
+    spent: number;
+    budget_amount: number;
+    tag_names: string[];
+    links: {
+        accounts: number[];
+        budget_histories: number[];
+    };
+}, Error, UpdateBudgetParams, unknown>;
+interface DeleteBudgetParams {
+    userId: string;
+    budgetId: number;
+}
+/**
+ * Delete a budget
+ * Removes budget from user's budgets list
+ * Invalidates related queries on success
+ *
+ * @param options - TanStack Mutation options
+ * @returns Mutation result
+ *
+ * @example
+ * ```tsx
+ * function BudgetDeleteButton({ budgetId }: { budgetId: number }) {
+ *   const deleteBudget = useDeleteBudget();
+ *
+ *   const handleDelete = () => {
+ *     if (confirm('Are you sure you want to delete this budget?')) {
+ *       deleteBudget.mutate({
+ *         userId: 'user123',
+ *         budgetId
+ *       }, {
+ *         onSuccess: () => {
+ *           toast.success('Budget deleted');
+ *           router.push('/budgets');
+ *         },
+ *         onError: (error) => {
+ *           toast.error(`Failed: ${error.message}`);
+ *         }
+ *       });
+ *     }
+ *   };
+ *
+ *   return (
+ *     <button
+ *       onClick={handleDelete}
+ *       disabled={deleteBudget.isPending}
+ *     >
+ *       {deleteBudget.isPending ? 'Deleting...' : 'Delete'}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+declare function useDeleteBudget(options?: Omit<UseMutationOptions<void, Error, DeleteBudgetParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<void, Error, DeleteBudgetParams, unknown>;
+/**
+ * Axios client for Budget API calls
+ * Reuses pattern from accounts/transactions data-access
+ */
+declare const api: axios.AxiosInstance;
+export { type BudgetDateRangeFilters, type CreateBudgetParams, type DeleteBudgetParams, type UpdateBudgetParams, type UseBudgetParams, type UseBudgetsParams, api, budgetKeys, useBudget, useBudgets, useCreateBudget, useDeleteBudget, useUpdateBudget };

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,297 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { BudgetsResponse, Budget, BudgetCreate, BudgetUpdate } from '@pfm-platform/shared';
+import * as axios from 'axios';
+/**
+ * Query key factory for Budget domain
+ * Hierarchical structure for efficient cache invalidation
+ */
+interface BudgetDateRangeFilters {
+    start_date?: string;
+    end_date?: string;
+}
+declare const budgetKeys: {
+    all: readonly ["budgets"];
+    lists: () => readonly ["budgets", "list"];
+    list: (userId: string, filters?: BudgetDateRangeFilters) => readonly ["budgets", "list", string, BudgetDateRangeFilters];
+    details: () => readonly ["budgets", "detail"];
+    detail: (userId: string, budgetId: number) => readonly ["budgets", "detail", string, number];
+};
+interface UseBudgetsParams {
+    userId: string;
+    filters?: BudgetDateRangeFilters;
+}
+/**
+ * Fetch budgets with optional date range filters
+ * Uses Zod validation to ensure API response matches expected schema
+ *
+ * @param params - Query parameters with userId and optional date range filters
+ * @param options - TanStack Query options
+ * @returns Query result with validated budgets data
+ *
+ * @example
+ * ```tsx
+ * // Fetch all budgets
+ * function BudgetsList() {
+ *   const { data, isLoading } = useBudgets({ userId: 'user123' });
+ *
+ *   return (
+ *     <ul>
+ *       {data?.budgets.map(budget => (
+ *         <li key={budget.id}>{budget.name}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ *
+ * // Fetch budgets for specific date range
+ * function MonthBudgets() {
+ *   const { data } = useBudgets({
+ *     userId: 'user123',
+ *     filters: {
+ *       start_date: '2025-01-01T00:00:00Z',
+ *       end_date: '2025-01-31T23:59:59Z',
+ *     }
+ *   });
+ *
+ *   return <BudgetList budgets={data?.budgets} />;
+ * }
+ * ```
+ */
+declare function useBudgets(params: UseBudgetsParams, options?: Omit<UseQueryOptions<BudgetsResponse>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<{
+    budgets: {
+        id: number;
+        month: number;
+        year: number;
+        name: string;
+        state: "under" | "risk" | "over";
+        spent: number;
+        budget_amount: number;
+        tag_names: string[];
+        links: {
+            accounts: number[];
+            budget_histories: number[];
+        };
+    }[];
+}, Error>;
+interface UseBudgetParams {
+    userId: string;
+    budgetId: number;
+}
+/**
+ * Fetch a single budget by ID
+ * Uses Zod validation to ensure API response matches expected schema
+ *
+ * @param params - Query parameters with userId and budgetId
+ * @param options - TanStack Query options
+ * @returns Query result with validated budget data
+ *
+ * @example
+ * ```tsx
+ * function BudgetDetail({ budgetId }: { budgetId: number }) {
+ *   const { data, isLoading, error } = useBudget({
+ *     userId: 'user123',
+ *     budgetId
+ *   });
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       <h1>{data.name}</h1>
+ *       <p>Amount: ${data.budget_amount}</p>
+ *       <p>Spent: ${data.spent}</p>
+ *       <p>State: {data.state}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useBudget(params: UseBudgetParams, options?: Omit<UseQueryOptions<Budget>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<{
+    id: number;
+    month: number;
+    year: number;
+    name: string;
+    state: "under" | "risk" | "over";
+    spent: number;
+    budget_amount: number;
+    tag_names: string[];
+    links: {
+        accounts: number[];
+        budget_histories: number[];
+    };
+}, Error>;
+interface CreateBudgetParams {
+    userId: string;
+    data: BudgetCreate;
+}
+/**
+ * Create a new budget
+ * Validates input with Zod schema and invalidates related queries on success
+ *
+ * @param options - TanStack Mutation options
+ * @returns Mutation result
+ *
+ * @example
+ * ```tsx
+ * function BudgetCreateForm() {
+ *   const createBudget = useCreateBudget();
+ *
+ *   const handleSubmit = (formData) => {
+ *     createBudget.mutate({
+ *       userId: 'user123',
+ *       data: {
+ *         name: formData.name,
+ *         budget_amount: formData.amount,
+ *         tag_names: formData.tags,
+ *         account_list: formData.accounts,
+ *         show_on_dashboard: true,
+ *         other: {}
+ *       }
+ *     }, {
+ *       onSuccess: (newBudget) => {
+ *         toast.success('Budget created!');
+ *         router.push(`/budgets/${newBudget.id}`);
+ *       },
+ *       onError: (error) => {
+ *         toast.error(`Failed: ${error.message}`);
+ *       }
+ *     });
+ *   };
+ *
+ *   return <form onSubmit={handleSubmit}>...</form>;
+ * }
+ * ```
+ */
+declare function useCreateBudget(options?: Omit<UseMutationOptions<Budget, Error, CreateBudgetParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    id: number;
+    month: number;
+    year: number;
+    name: string;
+    state: "under" | "risk" | "over";
+    spent: number;
+    budget_amount: number;
+    tag_names: string[];
+    links: {
+        accounts: number[];
+        budget_histories: number[];
+    };
+}, Error, CreateBudgetParams, unknown>;
+interface UpdateBudgetParams {
+    userId: string;
+    budgetId: number;
+    data: BudgetUpdate;
+}
+/**
+ * Update an existing budget
+ * Validates input with Zod schema and invalidates related queries on success
+ *
+ * @param options - TanStack Mutation options
+ * @returns Mutation result
+ *
+ * @example
+ * ```tsx
+ * function BudgetEditForm({ budget }: { budget: Budget }) {
+ *   const updateBudget = useUpdateBudget();
+ *
+ *   const handleSubmit = (formData) => {
+ *     updateBudget.mutate({
+ *       userId: 'user123',
+ *       budgetId: budget.id,
+ *       data: {
+ *         name: formData.name,
+ *         budget_amount: formData.amount,
+ *         tag_names: formData.tags,
+ *         account_list: formData.accounts,
+ *         show_on_dashboard: formData.showOnDashboard,
+ *         other: formData.metadata
+ *       }
+ *     }, {
+ *       onSuccess: () => {
+ *         toast.success('Budget updated!');
+ *       },
+ *       onError: (error) => {
+ *         toast.error(`Failed: ${error.message}`);
+ *       }
+ *     });
+ *   };
+ *
+ *   return <form onSubmit={handleSubmit}>...</form>;
+ * }
+ * ```
+ */
+declare function useUpdateBudget(options?: Omit<UseMutationOptions<Budget, Error, UpdateBudgetParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    id: number;
+    month: number;
+    year: number;
+    name: string;
+    state: "under" | "risk" | "over";
+    spent: number;
+    budget_amount: number;
+    tag_names: string[];
+    links: {
+        accounts: number[];
+        budget_histories: number[];
+    };
+}, Error, UpdateBudgetParams, unknown>;
+interface DeleteBudgetParams {
+    userId: string;
+    budgetId: number;
+}
+/**
+ * Delete a budget
+ * Removes budget from user's budgets list
+ * Invalidates related queries on success
+ *
+ * @param options - TanStack Mutation options
+ * @returns Mutation result
+ *
+ * @example
+ * ```tsx
+ * function BudgetDeleteButton({ budgetId }: { budgetId: number }) {
+ *   const deleteBudget = useDeleteBudget();
+ *
+ *   const handleDelete = () => {
+ *     if (confirm('Are you sure you want to delete this budget?')) {
+ *       deleteBudget.mutate({
+ *         userId: 'user123',
+ *         budgetId
+ *       }, {
+ *         onSuccess: () => {
+ *           toast.success('Budget deleted');
+ *           router.push('/budgets');
+ *         },
+ *         onError: (error) => {
+ *           toast.error(`Failed: ${error.message}`);
+ *         }
+ *       });
+ *     }
+ *   };
+ *
+ *   return (
+ *     <button
+ *       onClick={handleDelete}
+ *       disabled={deleteBudget.isPending}
+ *     >
+ *       {deleteBudget.isPending ? 'Deleting...' : 'Delete'}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+declare function useDeleteBudget(options?: Omit<UseMutationOptions<void, Error, DeleteBudgetParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<void, Error, DeleteBudgetParams, unknown>;
+/**
+ * Axios client for Budget API calls
+ * Reuses pattern from accounts/transactions data-access
+ */
+declare const api: axios.AxiosInstance;
+export { type BudgetDateRangeFilters, type CreateBudgetParams, type DeleteBudgetParams, type UpdateBudgetParams, type UseBudgetParams, type UseBudgetsParams, api, budgetKeys, useBudget, useBudgets, useCreateBudget, useDeleteBudget, useUpdateBudget };

package/dist/index.js ADDED Viewed

@@ -0,0 +1,132 @@
+import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
+import { BudgetsResponseSchema, BudgetSchema, BudgetCreateSchema, BudgetUpdateSchema } from '@pfm-platform/shared';
+import axios from 'axios';
+// src/queries/useBudgets.ts
+// src/keys.ts
+var budgetKeys = {
+  all: ["budgets"],
+  lists: () => [...budgetKeys.all, "list"],
+  list: (userId, filters) => [...budgetKeys.lists(), userId, filters ?? {}],
+  details: () => [...budgetKeys.all, "detail"],
+  detail: (userId, budgetId) => [...budgetKeys.details(), userId, budgetId]
+};
+var api = axios.create({
+  baseURL: "/api",
+  headers: {
+    "Content-Type": "application/json"
+  },
+  timeout: 1e4
+});
+api.interceptors.request.use(
+  (config) => {
+    const token = localStorage.getItem("auth_token");
+    if (token) {
+      config.headers.Authorization = `Bearer ${token}`;
+    }
+    return config;
+  },
+  (error) => Promise.reject(error)
+);
+api.interceptors.response.use(
+  (response) => response,
+  (error) => {
+    if (error.response?.status === 401) {
+      localStorage.removeItem("auth_token");
+      window.location.href = "/login";
+    }
+    return Promise.reject(error);
+  }
+);
+// src/queries/useBudgets.ts
+function useBudgets(params, options) {
+  const { userId, filters = {} } = params;
+  return useQuery({
+    queryKey: budgetKeys.list(userId, filters),
+    queryFn: async () => {
+      const queryParams = new URLSearchParams();
+      if (filters.start_date) {
+        queryParams.append("start_date", filters.start_date);
+      }
+      if (filters.end_date) {
+        queryParams.append("end_date", filters.end_date);
+      }
+      const queryString = queryParams.toString();
+      const url = `/users/${userId}/budgets${queryString ? `?${queryString}` : ""}`;
+      const response = await api.get(url);
+      return BudgetsResponseSchema.parse(response.data);
+    },
+    staleTime: 1e3 * 60 * 5,
+    // 5 minutes - budgets change less frequently than transactions
+    ...options
+  });
+}
+function useBudget(params, options) {
+  const { userId, budgetId } = params;
+  return useQuery({
+    queryKey: budgetKeys.detail(userId, budgetId),
+    queryFn: async () => {
+      const response = await api.get(`/users/${userId}/budgets/${budgetId}`);
+      return BudgetSchema.parse(response.data);
+    },
+    staleTime: 1e3 * 60 * 5,
+    // 5 minutes
+    ...options
+  });
+}
+function useCreateBudget(options) {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: async ({ userId, data }) => {
+      const validated = BudgetCreateSchema.parse(data);
+      const response = await api.post(`/users/${userId}/budgets`, {
+        budget: validated
+      });
+      return BudgetSchema.parse(response.data);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({ queryKey: budgetKeys.lists() });
+    },
+    ...options
+  });
+}
+function useUpdateBudget(options) {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: async ({ userId, budgetId, data }) => {
+      const validated = BudgetUpdateSchema.parse(data);
+      const response = await api.put(`/users/${userId}/budgets/${budgetId}`, {
+        budget: validated
+      });
+      return BudgetSchema.parse(response.data);
+    },
+    onSuccess: (_, { userId, budgetId }) => {
+      queryClient.invalidateQueries({ queryKey: budgetKeys.lists() });
+      queryClient.invalidateQueries({
+        queryKey: budgetKeys.detail(userId, budgetId)
+      });
+    },
+    ...options
+  });
+}
+function useDeleteBudget(options) {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: async ({ userId, budgetId }) => {
+      await api.delete(`/users/${userId}/budgets/${budgetId}`);
+    },
+    onSuccess: (_, { userId, budgetId }) => {
+      queryClient.invalidateQueries({ queryKey: budgetKeys.lists() });
+      queryClient.invalidateQueries({
+        queryKey: budgetKeys.detail(userId, budgetId)
+      });
+    },
+    ...options
+  });
+}
+export { api, budgetKeys, useBudget, useBudgets, useCreateBudget, useDeleteBudget, useUpdateBudget };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/keys.ts","../src/client.ts","../src/queries/useBudgets.ts","../src/queries/useBudget.ts","../src/mutations/useCreateBudget.ts","../src/mutations/useUpdateBudget.ts","../src/mutations/useDeleteBudget.ts"],"names":["useQuery","BudgetSchema","useQueryClient","useMutation"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Query key factory for Budget domain\n * Hierarchical structure for efficient cache invalidation\n */\n\nexport interface BudgetDateRangeFilters {\n start_date?: string; // RFC 3339 format\n end_date?: string; // RFC 3339 format\n}\n\nexport const budgetKeys = {\n all: ['budgets'] as const,\n lists: () => [...budgetKeys.all, 'list'] as const,\n list: (userId: string, filters?: BudgetDateRangeFilters) =>\n [...budgetKeys.lists(), userId, filters ?? {}] as const,\n details: () => [...budgetKeys.all, 'detail'] as const,\n detail: (userId: string, budgetId: number) =>\n [...budgetKeys.details(), userId, budgetId] as const,\n};\n","/**\n * Axios client for Budget API calls\n * Reuses pattern from accounts/transactions data-access\n */\n\nimport axios from 'axios';\n\nexport const api = axios.create({\n baseURL: '/api',\n headers: {\n 'Content-Type': 'application/json',\n },\n timeout: 10000,\n});\n\n// Request interceptor - Add auth token\napi.interceptors.request.use(\n (config) => {\n const token = localStorage.getItem('auth_token');\n if (token) {\n config.headers.Authorization = `Bearer ${token}`;\n }\n return config;\n },\n (error) => Promise.reject(error)\n);\n\n// Response interceptor - Handle 401 unauthorized\napi.interceptors.response.use(\n (response) => response,\n (error) => {\n if (error.response?.status === 401) {\n // Clear token and redirect to login\n localStorage.removeItem('auth_token');\n window.location.href = '/login';\n }\n return Promise.reject(error);\n }\n);\n","/**\n * Query hook for fetching budgets list\n * Legacy API: GET /users/{userId}/budgets\n * Optional filters: start_date, end_date (RFC 3339 format)\n */\n\nimport { useQuery, UseQueryOptions } from '@tanstack/react-query';\nimport { BudgetsResponseSchema, BudgetsResponse } from '@pfm-platform/shared';\nimport { budgetKeys, BudgetDateRangeFilters } from '../keys';\nimport { api } from '../client';\n\nexport interface UseBudgetsParams {\n userId: string;\n filters?: BudgetDateRangeFilters;\n}\n\n/**\n * Fetch budgets with optional date range filters\n * Uses Zod validation to ensure API response matches expected schema\n *\n * @param params - Query parameters with userId and optional date range filters\n * @param options - TanStack Query options\n * @returns Query result with validated budgets data\n *\n * @example\n * ```tsx\n * // Fetch all budgets\n * function BudgetsList() {\n * const { data, isLoading } = useBudgets({ userId: 'user123' });\n *\n * return (\n * <ul>\n * {data?.budgets.map(budget => (\n * <li key={budget.id}>{budget.name}</li>\n * ))}\n * </ul>\n * );\n * }\n *\n * // Fetch budgets for specific date range\n * function MonthBudgets() {\n * const { data } = useBudgets({\n * userId: 'user123',\n * filters: {\n * start_date: '2025-01-01T00:00:00Z',\n * end_date: '2025-01-31T23:59:59Z',\n * }\n * });\n *\n * return <BudgetList budgets={data?.budgets} />;\n * }\n * ```\n */\nexport function useBudgets(\n params: UseBudgetsParams,\n options?: Omit<UseQueryOptions<BudgetsResponse>, 'queryKey' | 'queryFn'>\n) {\n const { userId, filters = {} } = params;\n\n return useQuery({\n queryKey: budgetKeys.list(userId, filters),\n queryFn: async () => {\n // Build query parameters\n const queryParams = new URLSearchParams();\n\n if (filters.start_date) {\n queryParams.append('start_date', filters.start_date);\n }\n\n if (filters.end_date) {\n queryParams.append('end_date', filters.end_date);\n }\n\n const queryString = queryParams.toString();\n const url = `/users/${userId}/budgets${\n queryString ? `?${queryString}` : ''\n }`;\n\n const response = await api.get(url);\n\n // Validate response with Zod schema from Mini-Arc 1\n return BudgetsResponseSchema.parse(response.data);\n },\n staleTime: 1000 * 60 * 5, // 5 minutes - budgets change less frequently than transactions\n ...options,\n });\n}\n","/**\n * Query hook for fetching a single budget\n * Legacy API: GET /users/{userId}/budgets/{id}\n */\n\nimport { useQuery, UseQueryOptions } from '@tanstack/react-query';\nimport { BudgetSchema, Budget } from '@pfm-platform/shared';\nimport { budgetKeys } from '../keys';\nimport { api } from '../client';\n\nexport interface UseBudgetParams {\n userId: string;\n budgetId: number;\n}\n\n/**\n * Fetch a single budget by ID\n * Uses Zod validation to ensure API response matches expected schema\n *\n * @param params - Query parameters with userId and budgetId\n * @param options - TanStack Query options\n * @returns Query result with validated budget data\n *\n * @example\n * ```tsx\n * function BudgetDetail({ budgetId }: { budgetId: number }) {\n * const { data, isLoading, error } = useBudget({\n * userId: 'user123',\n * budgetId\n * });\n *\n * if (isLoading) return <div>Loading...</div>;\n * if (error) return <div>Error: {error.message}</div>;\n *\n * return (\n * <div>\n * <h1>{data.name}</h1>\n * <p>Amount: ${data.budget_amount}</p>\n * <p>Spent: ${data.spent}</p>\n * <p>State: {data.state}</p>\n * </div>\n * );\n * }\n * ```\n */\nexport function useBudget(\n params: UseBudgetParams,\n options?: Omit<UseQueryOptions<Budget>, 'queryKey' | 'queryFn'>\n) {\n const { userId, budgetId } = params;\n\n return useQuery({\n queryKey: budgetKeys.detail(userId, budgetId),\n queryFn: async () => {\n const response = await api.get(`/users/${userId}/budgets/${budgetId}`);\n\n // Validate response with Zod schema from Mini-Arc 1\n return BudgetSchema.parse(response.data);\n },\n staleTime: 1000 * 60 * 5, // 5 minutes\n ...options,\n });\n}\n","/**\n * Mutation hook for creating a budget\n * Legacy API: POST /users/{userId}/budgets\n */\n\nimport {\n useMutation,\n UseMutationOptions,\n useQueryClient,\n} from '@tanstack/react-query';\nimport {\n BudgetCreateSchema,\n BudgetSchema,\n Budget,\n BudgetCreate,\n} from '@pfm-platform/shared';\nimport { budgetKeys } from '../keys';\nimport { api } from '../client';\n\nexport interface CreateBudgetParams {\n userId: string;\n data: BudgetCreate;\n}\n\n/**\n * Create a new budget\n * Validates input with Zod schema and invalidates related queries on success\n *\n * @param options - TanStack Mutation options\n * @returns Mutation result\n *\n * @example\n * ```tsx\n * function BudgetCreateForm() {\n * const createBudget = useCreateBudget();\n *\n * const handleSubmit = (formData) => {\n * createBudget.mutate({\n * userId: 'user123',\n * data: {\n * name: formData.name,\n * budget_amount: formData.amount,\n * tag_names: formData.tags,\n * account_list: formData.accounts,\n * show_on_dashboard: true,\n * other: {}\n * }\n * }, {\n * onSuccess: (newBudget) => {\n * toast.success('Budget created!');\n * router.push(`/budgets/${newBudget.id}`);\n * },\n * onError: (error) => {\n * toast.error(`Failed: ${error.message}`);\n * }\n * });\n * };\n *\n * return <form onSubmit={handleSubmit}>...</form>;\n * }\n * ```\n */\nexport function useCreateBudget(\n options?: Omit<UseMutationOptions<Budget, Error, CreateBudgetParams>, 'mutationFn'>\n) {\n const queryClient = useQueryClient();\n\n return useMutation({\n mutationFn: async ({ userId, data }: CreateBudgetParams) => {\n // Validate input with Zod schema from Mini-Arc 1\n const validated = BudgetCreateSchema.parse(data);\n\n const response = await api.post(`/users/${userId}/budgets`, {\n budget: validated,\n });\n\n // Validate response\n return BudgetSchema.parse(response.data);\n },\n onSuccess: (_, { userId }) => {\n // Invalidate budget list queries for this user\n queryClient.invalidateQueries({ queryKey: budgetKeys.lists() });\n },\n ...options,\n });\n}\n","/**\n * Mutation hook for updating a budget\n * Legacy API: PUT /users/{userId}/budgets/{id}\n */\n\nimport {\n useMutation,\n UseMutationOptions,\n useQueryClient,\n} from '@tanstack/react-query';\nimport {\n BudgetUpdateSchema,\n BudgetSchema,\n Budget,\n BudgetUpdate,\n} from '@pfm-platform/shared';\nimport { budgetKeys } from '../keys';\nimport { api } from '../client';\n\nexport interface UpdateBudgetParams {\n userId: string;\n budgetId: number;\n data: BudgetUpdate;\n}\n\n/**\n * Update an existing budget\n * Validates input with Zod schema and invalidates related queries on success\n *\n * @param options - TanStack Mutation options\n * @returns Mutation result\n *\n * @example\n * ```tsx\n * function BudgetEditForm({ budget }: { budget: Budget }) {\n * const updateBudget = useUpdateBudget();\n *\n * const handleSubmit = (formData) => {\n * updateBudget.mutate({\n * userId: 'user123',\n * budgetId: budget.id,\n * data: {\n * name: formData.name,\n * budget_amount: formData.amount,\n * tag_names: formData.tags,\n * account_list: formData.accounts,\n * show_on_dashboard: formData.showOnDashboard,\n * other: formData.metadata\n * }\n * }, {\n * onSuccess: () => {\n * toast.success('Budget updated!');\n * },\n * onError: (error) => {\n * toast.error(`Failed: ${error.message}`);\n * }\n * });\n * };\n *\n * return <form onSubmit={handleSubmit}>...</form>;\n * }\n * ```\n */\nexport function useUpdateBudget(\n options?: Omit<UseMutationOptions<Budget, Error, UpdateBudgetParams>, 'mutationFn'>\n) {\n const queryClient = useQueryClient();\n\n return useMutation({\n mutationFn: async ({ userId, budgetId, data }: UpdateBudgetParams) => {\n // Validate input with Zod schema from Mini-Arc 1\n const validated = BudgetUpdateSchema.parse(data);\n\n const response = await api.put(`/users/${userId}/budgets/${budgetId}`, {\n budget: validated,\n });\n\n // Validate response\n return BudgetSchema.parse(response.data);\n },\n onSuccess: (_, { userId, budgetId }) => {\n // Invalidate list queries\n queryClient.invalidateQueries({ queryKey: budgetKeys.lists() });\n // Invalidate this specific budget\n queryClient.invalidateQueries({\n queryKey: budgetKeys.detail(userId, budgetId),\n });\n },\n ...options,\n });\n}\n","/**\n * Mutation hook for deleting a budget\n * Legacy API: DELETE /users/{userId}/budgets/{id}\n */\n\nimport {\n useMutation,\n UseMutationOptions,\n useQueryClient,\n} from '@tanstack/react-query';\nimport { budgetKeys } from '../keys';\nimport { api } from '../client';\n\nexport interface DeleteBudgetParams {\n userId: string;\n budgetId: number;\n}\n\n/**\n * Delete a budget\n * Removes budget from user's budgets list\n * Invalidates related queries on success\n *\n * @param options - TanStack Mutation options\n * @returns Mutation result\n *\n * @example\n * ```tsx\n * function BudgetDeleteButton({ budgetId }: { budgetId: number }) {\n * const deleteBudget = useDeleteBudget();\n *\n * const handleDelete = () => {\n * if (confirm('Are you sure you want to delete this budget?')) {\n * deleteBudget.mutate({\n * userId: 'user123',\n * budgetId\n * }, {\n * onSuccess: () => {\n * toast.success('Budget deleted');\n * router.push('/budgets');\n * },\n * onError: (error) => {\n * toast.error(`Failed: ${error.message}`);\n * }\n * });\n * }\n * };\n *\n * return (\n * <button\n * onClick={handleDelete}\n * disabled={deleteBudget.isPending}\n * >\n * {deleteBudget.isPending ? 'Deleting...' : 'Delete'}\n * </button>\n * );\n * }\n * ```\n */\nexport function useDeleteBudget(\n options?: Omit<UseMutationOptions<void, Error, DeleteBudgetParams>, 'mutationFn'>\n) {\n const queryClient = useQueryClient();\n\n return useMutation({\n mutationFn: async ({ userId, budgetId }: DeleteBudgetParams) => {\n await api.delete(`/users/${userId}/budgets/${budgetId}`);\n // DELETE returns 204 No Content - no response body to validate\n },\n onSuccess: (_, { userId, budgetId }) => {\n // Invalidate list queries\n queryClient.invalidateQueries({ queryKey: budgetKeys.lists() });\n // Invalidate this specific budget\n queryClient.invalidateQueries({\n queryKey: budgetKeys.detail(userId, budgetId),\n });\n },\n ...options,\n });\n}\n"]}

package/package.json ADDED Viewed

@@ -0,0 +1,61 @@
+{
+  "name": "@pfm-platform/budgets-data-access",
+  "version": "0.1.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "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"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "description": "Personal Finance Management - BUDGETS data-access layer",
+  "keywords": [
+    "pfm",
+    "finance",
+    "budgets",
+    "data-access",
+    "react",
+    "typescript"
+  ],
+  "author": "Lenny Miller",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lennylmiller/pfm-research",
+    "directory": "packages/budgets/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"
+  }
+}