@pfm-platform/notifications-data-access 0.1.1

package/dist/index.cjs

@@ -0,0 +1,106 @@
+'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/useNotifications.ts
+var api = axios__default.default.create({
+  baseURL: "/api",
+  headers: {
+    "Content-Type": "application/json"
+  }
+});
+
+// src/keys.ts
+var notificationKeys = {
+  all: ["notifications"],
+  lists: () => [...notificationKeys.all, "list"],
+  list: (userId) => [...notificationKeys.lists(), userId]
+};
+
+// src/queries/useNotifications.ts
+function useNotifications({ userId }, options) {
+  return reactQuery.useQuery({
+    queryKey: notificationKeys.list(userId),
+    queryFn: async () => {
+      const response = await api.get(`/users/${userId}/alerts/notifications`);
+      const validated = shared.NotificationsResponseSchema.parse(response.data);
+      return validated.notifications;
+    },
+    staleTime: 1e3 * 60 * 2,
+    // 2 minutes (notifications change frequently)
+    ...options
+  });
+}
+function useCreateNotification(options) {
+  const queryClient = reactQuery.useQueryClient();
+  const { mode } = shared.useAppMode();
+  return reactQuery.useMutation({
+    mutationFn: async ({ userId, data }) => {
+      const schema = mode === "admin" ? shared.NotificationCreateSchemaAdmin : shared.NotificationCreateSchemaUser;
+      const validated = schema.parse(data);
+      const response = await api.post(
+        `/users/${userId}/alerts/notifications`,
+        validated
+      );
+      return shared.NotificationSchema.parse(response.data);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({
+        queryKey: notificationKeys.list(userId)
+      });
+    },
+    ...options
+  });
+}
+function useUpdateNotification(options) {
+  const queryClient = reactQuery.useQueryClient();
+  const { mode } = shared.useAppMode();
+  return reactQuery.useMutation({
+    mutationFn: async ({
+      userId,
+      notificationId,
+      data
+    }) => {
+      const schema = mode === "admin" ? shared.NotificationUpdateSchemaAdmin : shared.NotificationUpdateSchemaUser;
+      const validated = schema.parse(data);
+      const response = await api.put(
+        `/users/${userId}/alerts/notifications/${notificationId}`,
+        validated
+      );
+      return shared.NotificationSchema.parse(response.data);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({
+        queryKey: notificationKeys.list(userId)
+      });
+    },
+    ...options
+  });
+}
+function useDeleteNotification(options) {
+  const queryClient = reactQuery.useQueryClient();
+  return reactQuery.useMutation({
+    mutationFn: async ({ userId, notificationId }) => {
+      await api.delete(`/users/${userId}/alerts/notifications/${notificationId}`);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({ queryKey: notificationKeys.list(userId) });
+    },
+    ...options
+  });
+}
+
+exports.api = api;
+exports.notificationKeys = notificationKeys;
+exports.useCreateNotification = useCreateNotification;
+exports.useDeleteNotification = useDeleteNotification;
+exports.useNotifications = useNotifications;
+exports.useUpdateNotification = useUpdateNotification;
+//# 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/useNotifications.ts","../src/mutations/useCreateNotification.ts","../src/mutations/useUpdateNotification.ts","../src/mutations/useDeleteNotification.ts"],"names":["axios","useQuery","NotificationsResponseSchema","useQueryClient","useAppMode","useMutation","NotificationCreateSchemaAdmin","NotificationCreateSchemaUser","NotificationSchema","NotificationUpdateSchemaAdmin","NotificationUpdateSchemaUser"],"mappings":"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","file":"index.cjs","sourcesContent":["import axios from 'axios';\n\n/**\n * Axios instance for Notifications 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","/**\n * Query key factory for Notifications domain\n */\nexport const notificationKeys = {\n  all: ['notifications'] as const,\n  lists: () => [...notificationKeys.all, 'list'] as const,\n  list: (userId: string) => [...notificationKeys.lists(), userId] as const,\n};\n","import { useQuery, UseQueryOptions } from '@tanstack/react-query';\nimport { Notification, NotificationsResponseSchema } from '@pfm-platform/shared';\nimport { api } from '../client.js';\nimport { notificationKeys } from '../keys.js';\n\nexport interface UseNotificationsParams {\n  userId: string;\n}\n\n/**\n * Fetch all notifications for a user\n * GET /users/:userId/alerts/notifications\n *\n * Notifications are system-generated based on alert configurations\n * Read-only domain (no create/update operations)\n */\nexport function useNotifications(\n  { userId }: UseNotificationsParams,\n  options?: Omit<UseQueryOptions<Notification[]>, 'queryKey' | 'queryFn'>\n) {\n  return useQuery({\n    queryKey: notificationKeys.list(userId),\n    queryFn: async () => {\n      const response = await api.get(`/users/${userId}/alerts/notifications`);\n      const validated = NotificationsResponseSchema.parse(response.data);\n      return validated.notifications;\n    },\n    staleTime: 1000 * 60 * 2, // 2 minutes (notifications change frequently)\n    ...options,\n  });\n}\n","import {\n  useMutation,\n  useQueryClient,\n  type UseMutationOptions,\n} from '@tanstack/react-query';\nimport {\n  NotificationCreateSchemaAdmin,\n  NotificationCreateSchemaUser,\n  NotificationSchema,\n  useAppMode,\n  type AlertType,\n} from '@pfm-platform/shared';\nimport type { Notification } from '@pfm-platform/shared';\nimport { api } from '../client';\nimport { notificationKeys } from '../keys';\n\n/**\n * Notification create data interface\n */\nexport interface NotificationCreate {\n  message: string;\n  alert_type: AlertType;\n  created_at?: string;\n}\n\n/**\n * Parameters for useCreateNotification mutation\n */\nexport interface CreateNotificationParams {\n  userId: string;\n  data: NotificationCreate;\n}\n\n/**\n * Mutation hook for creating a new notification\n *\n * Creates a notification manually for testing purposes.\n * Uses mode switching for validation:\n * - Admin mode: Allows manual notification creation for test data\n * - User mode: Blocked (notifications are system-generated)\n *\n * @example\n * ```tsx\n * const createNotification = useCreateNotification();\n *\n * createNotification.mutate({\n *   userId: 'user123',\n *   data: {\n *     message: 'Test notification',\n *     alert_type: 'AccountThresholdAlert',\n *     created_at: new Date().toISOString() // Optional\n *   }\n * });\n * ```\n */\nexport function useCreateNotification(\n  options?: Omit<\n    UseMutationOptions<Notification, Error, CreateNotificationParams>,\n    'mutationFn'\n  >\n) {\n  const queryClient = useQueryClient();\n  const { mode } = useAppMode();\n\n  return useMutation({\n    mutationFn: async ({ userId, data }: CreateNotificationParams) => {\n      // Select schema based on mode\n      const schema =\n        mode === 'admin'\n          ? NotificationCreateSchemaAdmin\n          : NotificationCreateSchemaUser;\n\n      // Validate notification data\n      const validated = schema.parse(data);\n\n      // POST to create new notification\n      const response = await api.post(\n        `/users/${userId}/alerts/notifications`,\n        validated\n      );\n\n      // Return created notification\n      return NotificationSchema.parse(response.data);\n    },\n    onSuccess: (_, { userId }) => {\n      // Invalidate notifications query to refetch updated list\n      queryClient.invalidateQueries({\n        queryKey: notificationKeys.list(userId),\n      });\n    },\n    ...options,\n  });\n}\n","import {\n  useMutation,\n  useQueryClient,\n  type UseMutationOptions,\n} from '@tanstack/react-query';\nimport {\n  NotificationUpdateSchemaAdmin,\n  NotificationUpdateSchemaUser,\n  NotificationSchema,\n  useAppMode,\n  type AlertType,\n} from '@pfm-platform/shared';\nimport type { Notification } from '@pfm-platform/shared';\nimport { api } from '../client';\nimport { notificationKeys } from '../keys';\n\n/**\n * Notification update data interface\n */\nexport interface NotificationUpdate {\n  message?: string;\n  alert_type?: AlertType;\n}\n\n/**\n * Parameters for useUpdateNotification mutation\n */\nexport interface UpdateNotificationParams {\n  userId: string;\n  notificationId: number;\n  data: NotificationUpdate;\n}\n\n/**\n * Mutation hook for updating a notification\n *\n * Updates notification fields for testing purposes.\n * Uses mode switching for validation:\n * - Admin mode: Allows updating notifications for test scenarios\n * - User mode: Blocked (notifications are system-generated)\n *\n * @example\n * ```tsx\n * const updateNotification = useUpdateNotification();\n *\n * updateNotification.mutate({\n *   userId: 'user123',\n *   notificationId: 1,\n *   data: {\n *     message: 'Updated test notification'\n *   }\n * });\n * ```\n */\nexport function useUpdateNotification(\n  options?: Omit<\n    UseMutationOptions<Notification, Error, UpdateNotificationParams>,\n    'mutationFn'\n  >\n) {\n  const queryClient = useQueryClient();\n  const { mode } = useAppMode();\n\n  return useMutation({\n    mutationFn: async ({\n      userId,\n      notificationId,\n      data,\n    }: UpdateNotificationParams) => {\n      // Select schema based on mode\n      const schema =\n        mode === 'admin'\n          ? NotificationUpdateSchemaAdmin\n          : NotificationUpdateSchemaUser;\n\n      // Validate notification update data\n      const validated = schema.parse(data);\n\n      // PUT to update notification\n      const response = await api.put(\n        `/users/${userId}/alerts/notifications/${notificationId}`,\n        validated\n      );\n\n      // Return updated notification\n      return NotificationSchema.parse(response.data);\n    },\n    onSuccess: (_, { userId }) => {\n      // Invalidate notifications query to refetch updated list\n      queryClient.invalidateQueries({\n        queryKey: notificationKeys.list(userId),\n      });\n    },\n    ...options,\n  });\n}\n","import { useMutation, UseMutationOptions, useQueryClient } from '@tanstack/react-query';\nimport { api } from '../client.js';\nimport { notificationKeys } from '../keys.js';\n\nexport interface DeleteNotificationParams {\n  userId: string;\n  notificationId: number;\n}\n\n/**\n * Delete a notification\n * DELETE /users/:userId/alerts/notifications/:notificationId\n *\n * Notifications are system-generated, deletion only removes from view\n */\nexport function useDeleteNotification(\n  options?: Omit<UseMutationOptions<void, Error, DeleteNotificationParams>, 'mutationFn'>\n) {\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn: async ({ userId, notificationId }: DeleteNotificationParams) => {\n      await api.delete(`/users/${userId}/alerts/notifications/${notificationId}`);\n    },\n    onSuccess: (_, { userId }) => {\n      // Invalidate notifications list to refetch without deleted item\n      queryClient.invalidateQueries({ queryKey: notificationKeys.list(userId) });\n    },\n    ...options,\n  });\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,137 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { Notification, AlertType } from '@pfm-platform/shared';
+import * as axios from 'axios';
+
+interface UseNotificationsParams {
+    userId: string;
+}
+/**
+ * Fetch all notifications for a user
+ * GET /users/:userId/alerts/notifications
+ *
+ * Notifications are system-generated based on alert configurations
+ * Read-only domain (no create/update operations)
+ */
+declare function useNotifications({ userId }: UseNotificationsParams, options?: Omit<UseQueryOptions<Notification[]>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<{
+    id: number;
+    message: string;
+    alert_type: "AccountThresholdAlert" | "GoalAlert" | "MerchantNameAlert" | "SpendingTargetAlert" | "TransactionLimitAlert" | "UpcomingBillAlert";
+    created_at: string;
+}[], Error>;
+
+/**
+ * Notification create data interface
+ */
+interface NotificationCreate {
+    message: string;
+    alert_type: AlertType;
+    created_at?: string;
+}
+/**
+ * Parameters for useCreateNotification mutation
+ */
+interface CreateNotificationParams {
+    userId: string;
+    data: NotificationCreate;
+}
+/**
+ * Mutation hook for creating a new notification
+ *
+ * Creates a notification manually for testing purposes.
+ * Uses mode switching for validation:
+ * - Admin mode: Allows manual notification creation for test data
+ * - User mode: Blocked (notifications are system-generated)
+ *
+ * @example
+ * ```tsx
+ * const createNotification = useCreateNotification();
+ *
+ * createNotification.mutate({
+ *   userId: 'user123',
+ *   data: {
+ *     message: 'Test notification',
+ *     alert_type: 'AccountThresholdAlert',
+ *     created_at: new Date().toISOString() // Optional
+ *   }
+ * });
+ * ```
+ */
+declare function useCreateNotification(options?: Omit<UseMutationOptions<Notification, Error, CreateNotificationParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    id: number;
+    message: string;
+    alert_type: "AccountThresholdAlert" | "GoalAlert" | "MerchantNameAlert" | "SpendingTargetAlert" | "TransactionLimitAlert" | "UpcomingBillAlert";
+    created_at: string;
+}, Error, CreateNotificationParams, unknown>;
+
+/**
+ * Notification update data interface
+ */
+interface NotificationUpdate {
+    message?: string;
+    alert_type?: AlertType;
+}
+/**
+ * Parameters for useUpdateNotification mutation
+ */
+interface UpdateNotificationParams {
+    userId: string;
+    notificationId: number;
+    data: NotificationUpdate;
+}
+/**
+ * Mutation hook for updating a notification
+ *
+ * Updates notification fields for testing purposes.
+ * Uses mode switching for validation:
+ * - Admin mode: Allows updating notifications for test scenarios
+ * - User mode: Blocked (notifications are system-generated)
+ *
+ * @example
+ * ```tsx
+ * const updateNotification = useUpdateNotification();
+ *
+ * updateNotification.mutate({
+ *   userId: 'user123',
+ *   notificationId: 1,
+ *   data: {
+ *     message: 'Updated test notification'
+ *   }
+ * });
+ * ```
+ */
+declare function useUpdateNotification(options?: Omit<UseMutationOptions<Notification, Error, UpdateNotificationParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    id: number;
+    message: string;
+    alert_type: "AccountThresholdAlert" | "GoalAlert" | "MerchantNameAlert" | "SpendingTargetAlert" | "TransactionLimitAlert" | "UpcomingBillAlert";
+    created_at: string;
+}, Error, UpdateNotificationParams, unknown>;
+
+interface DeleteNotificationParams {
+    userId: string;
+    notificationId: number;
+}
+/**
+ * Delete a notification
+ * DELETE /users/:userId/alerts/notifications/:notificationId
+ *
+ * Notifications are system-generated, deletion only removes from view
+ */
+declare function useDeleteNotification(options?: Omit<UseMutationOptions<void, Error, DeleteNotificationParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<void, Error, DeleteNotificationParams, unknown>;
+
+/**
+ * Query key factory for Notifications domain
+ */
+declare const notificationKeys: {
+    all: readonly ["notifications"];
+    lists: () => readonly ["notifications", "list"];
+    list: (userId: string) => readonly ["notifications", "list", string];
+};
+
+/**
+ * Axios instance for Notifications API
+ * Base URL configured through environment variables or defaults to relative path
+ */
+declare const api: axios.AxiosInstance;
+
+export { type CreateNotificationParams, type DeleteNotificationParams, type NotificationCreate, type NotificationUpdate, type UpdateNotificationParams, type UseNotificationsParams, api, notificationKeys, useCreateNotification, useDeleteNotification, useNotifications, useUpdateNotification };

package/dist/index.d.ts

@@ -0,0 +1,137 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { Notification, AlertType } from '@pfm-platform/shared';
+import * as axios from 'axios';
+
+interface UseNotificationsParams {
+    userId: string;
+}
+/**
+ * Fetch all notifications for a user
+ * GET /users/:userId/alerts/notifications
+ *
+ * Notifications are system-generated based on alert configurations
+ * Read-only domain (no create/update operations)
+ */
+declare function useNotifications({ userId }: UseNotificationsParams, options?: Omit<UseQueryOptions<Notification[]>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<{
+    id: number;
+    message: string;
+    alert_type: "AccountThresholdAlert" | "GoalAlert" | "MerchantNameAlert" | "SpendingTargetAlert" | "TransactionLimitAlert" | "UpcomingBillAlert";
+    created_at: string;
+}[], Error>;
+
+/**
+ * Notification create data interface
+ */
+interface NotificationCreate {
+    message: string;
+    alert_type: AlertType;
+    created_at?: string;
+}
+/**
+ * Parameters for useCreateNotification mutation
+ */
+interface CreateNotificationParams {
+    userId: string;
+    data: NotificationCreate;
+}
+/**
+ * Mutation hook for creating a new notification
+ *
+ * Creates a notification manually for testing purposes.
+ * Uses mode switching for validation:
+ * - Admin mode: Allows manual notification creation for test data
+ * - User mode: Blocked (notifications are system-generated)
+ *
+ * @example
+ * ```tsx
+ * const createNotification = useCreateNotification();
+ *
+ * createNotification.mutate({
+ *   userId: 'user123',
+ *   data: {
+ *     message: 'Test notification',
+ *     alert_type: 'AccountThresholdAlert',
+ *     created_at: new Date().toISOString() // Optional
+ *   }
+ * });
+ * ```
+ */
+declare function useCreateNotification(options?: Omit<UseMutationOptions<Notification, Error, CreateNotificationParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    id: number;
+    message: string;
+    alert_type: "AccountThresholdAlert" | "GoalAlert" | "MerchantNameAlert" | "SpendingTargetAlert" | "TransactionLimitAlert" | "UpcomingBillAlert";
+    created_at: string;
+}, Error, CreateNotificationParams, unknown>;
+
+/**
+ * Notification update data interface
+ */
+interface NotificationUpdate {
+    message?: string;
+    alert_type?: AlertType;
+}
+/**
+ * Parameters for useUpdateNotification mutation
+ */
+interface UpdateNotificationParams {
+    userId: string;
+    notificationId: number;
+    data: NotificationUpdate;
+}
+/**
+ * Mutation hook for updating a notification
+ *
+ * Updates notification fields for testing purposes.
+ * Uses mode switching for validation:
+ * - Admin mode: Allows updating notifications for test scenarios
+ * - User mode: Blocked (notifications are system-generated)
+ *
+ * @example
+ * ```tsx
+ * const updateNotification = useUpdateNotification();
+ *
+ * updateNotification.mutate({
+ *   userId: 'user123',
+ *   notificationId: 1,
+ *   data: {
+ *     message: 'Updated test notification'
+ *   }
+ * });
+ * ```
+ */
+declare function useUpdateNotification(options?: Omit<UseMutationOptions<Notification, Error, UpdateNotificationParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<{
+    id: number;
+    message: string;
+    alert_type: "AccountThresholdAlert" | "GoalAlert" | "MerchantNameAlert" | "SpendingTargetAlert" | "TransactionLimitAlert" | "UpcomingBillAlert";
+    created_at: string;
+}, Error, UpdateNotificationParams, unknown>;
+
+interface DeleteNotificationParams {
+    userId: string;
+    notificationId: number;
+}
+/**
+ * Delete a notification
+ * DELETE /users/:userId/alerts/notifications/:notificationId
+ *
+ * Notifications are system-generated, deletion only removes from view
+ */
+declare function useDeleteNotification(options?: Omit<UseMutationOptions<void, Error, DeleteNotificationParams>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<void, Error, DeleteNotificationParams, unknown>;
+
+/**
+ * Query key factory for Notifications domain
+ */
+declare const notificationKeys: {
+    all: readonly ["notifications"];
+    lists: () => readonly ["notifications", "list"];
+    list: (userId: string) => readonly ["notifications", "list", string];
+};
+
+/**
+ * Axios instance for Notifications API
+ * Base URL configured through environment variables or defaults to relative path
+ */
+declare const api: axios.AxiosInstance;
+
+export { type CreateNotificationParams, type DeleteNotificationParams, type NotificationCreate, type NotificationUpdate, type UpdateNotificationParams, type UseNotificationsParams, api, notificationKeys, useCreateNotification, useDeleteNotification, useNotifications, useUpdateNotification };

package/dist/index.js

@@ -0,0 +1,95 @@
+import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
+import { NotificationsResponseSchema, useAppMode, NotificationCreateSchemaAdmin, NotificationCreateSchemaUser, NotificationSchema, NotificationUpdateSchemaAdmin, NotificationUpdateSchemaUser } from '@pfm-platform/shared';
+import axios from 'axios';
+
+// src/queries/useNotifications.ts
+var api = axios.create({
+  baseURL: "/api",
+  headers: {
+    "Content-Type": "application/json"
+  }
+});
+
+// src/keys.ts
+var notificationKeys = {
+  all: ["notifications"],
+  lists: () => [...notificationKeys.all, "list"],
+  list: (userId) => [...notificationKeys.lists(), userId]
+};
+
+// src/queries/useNotifications.ts
+function useNotifications({ userId }, options) {
+  return useQuery({
+    queryKey: notificationKeys.list(userId),
+    queryFn: async () => {
+      const response = await api.get(`/users/${userId}/alerts/notifications`);
+      const validated = NotificationsResponseSchema.parse(response.data);
+      return validated.notifications;
+    },
+    staleTime: 1e3 * 60 * 2,
+    // 2 minutes (notifications change frequently)
+    ...options
+  });
+}
+function useCreateNotification(options) {
+  const queryClient = useQueryClient();
+  const { mode } = useAppMode();
+  return useMutation({
+    mutationFn: async ({ userId, data }) => {
+      const schema = mode === "admin" ? NotificationCreateSchemaAdmin : NotificationCreateSchemaUser;
+      const validated = schema.parse(data);
+      const response = await api.post(
+        `/users/${userId}/alerts/notifications`,
+        validated
+      );
+      return NotificationSchema.parse(response.data);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({
+        queryKey: notificationKeys.list(userId)
+      });
+    },
+    ...options
+  });
+}
+function useUpdateNotification(options) {
+  const queryClient = useQueryClient();
+  const { mode } = useAppMode();
+  return useMutation({
+    mutationFn: async ({
+      userId,
+      notificationId,
+      data
+    }) => {
+      const schema = mode === "admin" ? NotificationUpdateSchemaAdmin : NotificationUpdateSchemaUser;
+      const validated = schema.parse(data);
+      const response = await api.put(
+        `/users/${userId}/alerts/notifications/${notificationId}`,
+        validated
+      );
+      return NotificationSchema.parse(response.data);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({
+        queryKey: notificationKeys.list(userId)
+      });
+    },
+    ...options
+  });
+}
+function useDeleteNotification(options) {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: async ({ userId, notificationId }) => {
+      await api.delete(`/users/${userId}/alerts/notifications/${notificationId}`);
+    },
+    onSuccess: (_, { userId }) => {
+      queryClient.invalidateQueries({ queryKey: notificationKeys.list(userId) });
+    },
+    ...options
+  });
+}
+
+export { api, notificationKeys, useCreateNotification, useDeleteNotification, useNotifications, useUpdateNotification };
+//# 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/useNotifications.ts","../src/mutations/useCreateNotification.ts","../src/mutations/useUpdateNotification.ts","../src/mutations/useDeleteNotification.ts"],"names":["useQueryClient","useAppMode","useMutation","NotificationSchema"],"mappings":"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","file":"index.js","sourcesContent":["import axios from 'axios';\n\n/**\n * Axios instance for Notifications 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","/**\n * Query key factory for Notifications domain\n */\nexport const notificationKeys = {\n  all: ['notifications'] as const,\n  lists: () => [...notificationKeys.all, 'list'] as const,\n  list: (userId: string) => [...notificationKeys.lists(), userId] as const,\n};\n","import { useQuery, UseQueryOptions } from '@tanstack/react-query';\nimport { Notification, NotificationsResponseSchema } from '@pfm-platform/shared';\nimport { api } from '../client.js';\nimport { notificationKeys } from '../keys.js';\n\nexport interface UseNotificationsParams {\n  userId: string;\n}\n\n/**\n * Fetch all notifications for a user\n * GET /users/:userId/alerts/notifications\n *\n * Notifications are system-generated based on alert configurations\n * Read-only domain (no create/update operations)\n */\nexport function useNotifications(\n  { userId }: UseNotificationsParams,\n  options?: Omit<UseQueryOptions<Notification[]>, 'queryKey' | 'queryFn'>\n) {\n  return useQuery({\n    queryKey: notificationKeys.list(userId),\n    queryFn: async () => {\n      const response = await api.get(`/users/${userId}/alerts/notifications`);\n      const validated = NotificationsResponseSchema.parse(response.data);\n      return validated.notifications;\n    },\n    staleTime: 1000 * 60 * 2, // 2 minutes (notifications change frequently)\n    ...options,\n  });\n}\n","import {\n  useMutation,\n  useQueryClient,\n  type UseMutationOptions,\n} from '@tanstack/react-query';\nimport {\n  NotificationCreateSchemaAdmin,\n  NotificationCreateSchemaUser,\n  NotificationSchema,\n  useAppMode,\n  type AlertType,\n} from '@pfm-platform/shared';\nimport type { Notification } from '@pfm-platform/shared';\nimport { api } from '../client';\nimport { notificationKeys } from '../keys';\n\n/**\n * Notification create data interface\n */\nexport interface NotificationCreate {\n  message: string;\n  alert_type: AlertType;\n  created_at?: string;\n}\n\n/**\n * Parameters for useCreateNotification mutation\n */\nexport interface CreateNotificationParams {\n  userId: string;\n  data: NotificationCreate;\n}\n\n/**\n * Mutation hook for creating a new notification\n *\n * Creates a notification manually for testing purposes.\n * Uses mode switching for validation:\n * - Admin mode: Allows manual notification creation for test data\n * - User mode: Blocked (notifications are system-generated)\n *\n * @example\n * ```tsx\n * const createNotification = useCreateNotification();\n *\n * createNotification.mutate({\n *   userId: 'user123',\n *   data: {\n *     message: 'Test notification',\n *     alert_type: 'AccountThresholdAlert',\n *     created_at: new Date().toISOString() // Optional\n *   }\n * });\n * ```\n */\nexport function useCreateNotification(\n  options?: Omit<\n    UseMutationOptions<Notification, Error, CreateNotificationParams>,\n    'mutationFn'\n  >\n) {\n  const queryClient = useQueryClient();\n  const { mode } = useAppMode();\n\n  return useMutation({\n    mutationFn: async ({ userId, data }: CreateNotificationParams) => {\n      // Select schema based on mode\n      const schema =\n        mode === 'admin'\n          ? NotificationCreateSchemaAdmin\n          : NotificationCreateSchemaUser;\n\n      // Validate notification data\n      const validated = schema.parse(data);\n\n      // POST to create new notification\n      const response = await api.post(\n        `/users/${userId}/alerts/notifications`,\n        validated\n      );\n\n      // Return created notification\n      return NotificationSchema.parse(response.data);\n    },\n    onSuccess: (_, { userId }) => {\n      // Invalidate notifications query to refetch updated list\n      queryClient.invalidateQueries({\n        queryKey: notificationKeys.list(userId),\n      });\n    },\n    ...options,\n  });\n}\n","import {\n  useMutation,\n  useQueryClient,\n  type UseMutationOptions,\n} from '@tanstack/react-query';\nimport {\n  NotificationUpdateSchemaAdmin,\n  NotificationUpdateSchemaUser,\n  NotificationSchema,\n  useAppMode,\n  type AlertType,\n} from '@pfm-platform/shared';\nimport type { Notification } from '@pfm-platform/shared';\nimport { api } from '../client';\nimport { notificationKeys } from '../keys';\n\n/**\n * Notification update data interface\n */\nexport interface NotificationUpdate {\n  message?: string;\n  alert_type?: AlertType;\n}\n\n/**\n * Parameters for useUpdateNotification mutation\n */\nexport interface UpdateNotificationParams {\n  userId: string;\n  notificationId: number;\n  data: NotificationUpdate;\n}\n\n/**\n * Mutation hook for updating a notification\n *\n * Updates notification fields for testing purposes.\n * Uses mode switching for validation:\n * - Admin mode: Allows updating notifications for test scenarios\n * - User mode: Blocked (notifications are system-generated)\n *\n * @example\n * ```tsx\n * const updateNotification = useUpdateNotification();\n *\n * updateNotification.mutate({\n *   userId: 'user123',\n *   notificationId: 1,\n *   data: {\n *     message: 'Updated test notification'\n *   }\n * });\n * ```\n */\nexport function useUpdateNotification(\n  options?: Omit<\n    UseMutationOptions<Notification, Error, UpdateNotificationParams>,\n    'mutationFn'\n  >\n) {\n  const queryClient = useQueryClient();\n  const { mode } = useAppMode();\n\n  return useMutation({\n    mutationFn: async ({\n      userId,\n      notificationId,\n      data,\n    }: UpdateNotificationParams) => {\n      // Select schema based on mode\n      const schema =\n        mode === 'admin'\n          ? NotificationUpdateSchemaAdmin\n          : NotificationUpdateSchemaUser;\n\n      // Validate notification update data\n      const validated = schema.parse(data);\n\n      // PUT to update notification\n      const response = await api.put(\n        `/users/${userId}/alerts/notifications/${notificationId}`,\n        validated\n      );\n\n      // Return updated notification\n      return NotificationSchema.parse(response.data);\n    },\n    onSuccess: (_, { userId }) => {\n      // Invalidate notifications query to refetch updated list\n      queryClient.invalidateQueries({\n        queryKey: notificationKeys.list(userId),\n      });\n    },\n    ...options,\n  });\n}\n","import { useMutation, UseMutationOptions, useQueryClient } from '@tanstack/react-query';\nimport { api } from '../client.js';\nimport { notificationKeys } from '../keys.js';\n\nexport interface DeleteNotificationParams {\n  userId: string;\n  notificationId: number;\n}\n\n/**\n * Delete a notification\n * DELETE /users/:userId/alerts/notifications/:notificationId\n *\n * Notifications are system-generated, deletion only removes from view\n */\nexport function useDeleteNotification(\n  options?: Omit<UseMutationOptions<void, Error, DeleteNotificationParams>, 'mutationFn'>\n) {\n  const queryClient = useQueryClient();\n\n  return useMutation({\n    mutationFn: async ({ userId, notificationId }: DeleteNotificationParams) => {\n      await api.delete(`/users/${userId}/alerts/notifications/${notificationId}`);\n    },\n    onSuccess: (_, { userId }) => {\n      // Invalidate notifications list to refetch without deleted item\n      queryClient.invalidateQueries({ queryKey: notificationKeys.list(userId) });\n    },\n    ...options,\n  });\n}\n"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@pfm-platform/notifications-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 - NOTIFICATIONS data-access layer",
+  "keywords": [
+    "pfm",
+    "finance",
+    "notifications",
+    "data-access",
+    "react",
+    "typescript"
+  ],
+  "author": "Lenny Miller",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lennylmiller/pfm-research",
+    "directory": "packages/notifications/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"
+  }
+}