@classic-homes/notifications 0.1.0

package/dist/svelte/index.js

@@ -0,0 +1,382 @@
+import { api } from '@classic-homes/auth/core';
+
+// src/core/api.ts
+var notificationsApi = {
+  // ============================================================================
+  // Notifications CRUD
+  // ============================================================================
+  /**
+   * List notifications with optional filters.
+   */
+  async list(params, customFetch) {
+    const queryParams = new URLSearchParams();
+    const page = params?.page || 1;
+    const limit = params?.limit || 20;
+    const offset = (page - 1) * limit;
+    queryParams.append("limit", limit.toString());
+    queryParams.append("offset", offset.toString());
+    if (params?.unreadOnly) {
+      queryParams.append("read", "false");
+    } else if (params?.readOnly) {
+      queryParams.append("read", "true");
+    }
+    if (params?.type) {
+      queryParams.append("type", params.type);
+    }
+    const response = await api.get(
+      `/notifications?${queryParams.toString()}`,
+      true,
+      customFetch
+    );
+    return response;
+  },
+  /**
+   * Get a single notification by ID.
+   */
+  async get(id, customFetch) {
+    const response = await api.get(
+      `/notifications/${id}`,
+      true,
+      customFetch
+    );
+    return response.notification;
+  },
+  /**
+   * Mark a notification as read.
+   */
+  async markRead(id) {
+    await api.patch(`/notifications/${id}/read`, {}, true);
+  },
+  /**
+   * Mark multiple notifications as read.
+   */
+  async markManyRead(ids) {
+    await api.post("/notifications/mark-read", { ids }, true);
+  },
+  /**
+   * Mark all notifications as read.
+   */
+  async markAllRead() {
+    await api.post("/notifications/mark-read", { all: true }, true);
+  },
+  /**
+   * Dismiss (delete) a notification.
+   */
+  async dismiss(id) {
+    await api.delete(`/notifications/${id}`, true);
+  },
+  /**
+   * Delete multiple notifications in bulk.
+   */
+  async bulkDelete(ids) {
+    await api.post("/notifications/bulk-delete", { ids }, true);
+  },
+  /**
+   * Delete all notifications.
+   */
+  async deleteAll() {
+    await api.post("/notifications/bulk-delete", { all: true }, true);
+  },
+  // ============================================================================
+  // Notification Channels
+  // ============================================================================
+  /**
+   * Get available notification channels.
+   */
+  async getChannels(customFetch) {
+    const response = await api.get("/notifications/channels", true, customFetch);
+    return response;
+  },
+  // ============================================================================
+  // Notification Preferences
+  // ============================================================================
+  /**
+   * Get notification preferences.
+   */
+  async getPreferences(params, customFetch) {
+    const queryParams = new URLSearchParams();
+    if (params?.channelId) queryParams.append("channelId", params.channelId);
+    if (params?.notificationType) queryParams.append("notificationType", params.notificationType);
+    const response = await api.get(
+      `/notifications/preferences?${queryParams.toString()}`,
+      true,
+      customFetch
+    );
+    return response;
+  },
+  /**
+   * Update a notification preference.
+   */
+  async updatePreference(preference) {
+    const response = await api.put(
+      "/notifications/preferences",
+      preference,
+      true
+    );
+    return response;
+  },
+  /**
+   * Batch update notification preferences.
+   */
+  async batchUpdatePreferences(preferences) {
+    const response = await api.post(
+      "/notifications/preferences/batch",
+      { preferences },
+      true
+    );
+    const data = response;
+    return data.data || data;
+  },
+  /**
+   * Delete a notification preference.
+   */
+  async deletePreference(subscriptionId) {
+    const response = await api.delete(
+      `/notifications/preferences/${subscriptionId}`,
+      true
+    );
+    return response;
+  },
+  // ============================================================================
+  // Test Notifications (Dev/Admin)
+  // ============================================================================
+  /**
+   * Generate test notifications.
+   */
+  async generateTestNotifications(params) {
+    const response = await api.post(
+      "/notifications/test",
+      params || {},
+      true
+    );
+    const data = response;
+    return data.data ?? data;
+  }
+};
+
+// src/svelte/stores/notifications.svelte.ts
+var NotificationStore = class {
+  constructor() {
+    this.subscribers = /* @__PURE__ */ new Set();
+    this.state = {
+      notifications: [],
+      unreadCount: 0,
+      isLoading: false,
+      error: null,
+      pagination: {
+        page: 1,
+        limit: 20,
+        total: 0,
+        totalPages: 0
+      }
+    };
+  }
+  /**
+   * Subscribe to state changes (Svelte store contract).
+   */
+  subscribe(subscriber) {
+    this.subscribers.add(subscriber);
+    subscriber(this.state);
+    return () => this.subscribers.delete(subscriber);
+  }
+  notify() {
+    this.subscribers.forEach((sub) => sub(this.state));
+  }
+  setState(partial) {
+    this.state = { ...this.state, ...partial };
+    this.notify();
+  }
+  // Getters for direct access
+  get notifications() {
+    return this.state.notifications;
+  }
+  get unreadCount() {
+    return this.state.unreadCount;
+  }
+  get isLoading() {
+    return this.state.isLoading;
+  }
+  get error() {
+    return this.state.error;
+  }
+  /**
+   * Fetch notifications from the API.
+   */
+  async fetch(params) {
+    this.setState({ isLoading: true, error: null });
+    try {
+      const response = await notificationsApi.list(params);
+      this.setState({
+        notifications: response.notifications,
+        unreadCount: response.unreadCount,
+        pagination: response.pagination,
+        isLoading: false
+      });
+    } catch (error) {
+      this.setState({
+        error: error instanceof Error ? error.message : "Failed to fetch notifications",
+        isLoading: false
+      });
+    }
+  }
+  /**
+   * Refresh notifications (re-fetch with current params).
+   */
+  async refresh() {
+    await this.fetch({
+      page: this.state.pagination.page,
+      limit: this.state.pagination.limit
+    });
+  }
+  /**
+   * Load more notifications (next page).
+   */
+  async loadMore() {
+    if (this.state.pagination.page >= this.state.pagination.totalPages) {
+      return;
+    }
+    this.setState({ isLoading: true, error: null });
+    try {
+      const response = await notificationsApi.list({
+        page: this.state.pagination.page + 1,
+        limit: this.state.pagination.limit
+      });
+      this.setState({
+        notifications: [...this.state.notifications, ...response.notifications],
+        unreadCount: response.unreadCount,
+        pagination: response.pagination,
+        isLoading: false
+      });
+    } catch (error) {
+      this.setState({
+        error: error instanceof Error ? error.message : "Failed to load more notifications",
+        isLoading: false
+      });
+    }
+  }
+  /**
+   * Mark a notification as read.
+   */
+  async markRead(id) {
+    try {
+      await notificationsApi.markRead(id);
+      const notifications2 = this.state.notifications.map(
+        (n) => n.id === id ? { ...n, read: true, readAt: (/* @__PURE__ */ new Date()).toISOString() } : n
+      );
+      const unreadCount2 = Math.max(0, this.state.unreadCount - 1);
+      this.setState({ notifications: notifications2, unreadCount: unreadCount2 });
+    } catch (error) {
+      this.setState({
+        error: error instanceof Error ? error.message : "Failed to mark notification as read"
+      });
+    }
+  }
+  /**
+   * Mark multiple notifications as read.
+   */
+  async markManyRead(ids) {
+    try {
+      await notificationsApi.markManyRead(ids);
+      const notifications2 = this.state.notifications.map(
+        (n) => ids.includes(n.id) ? { ...n, read: true, readAt: (/* @__PURE__ */ new Date()).toISOString() } : n
+      );
+      const readCount = this.state.notifications.filter(
+        (n) => ids.includes(n.id) && !n.read
+      ).length;
+      const unreadCount2 = Math.max(0, this.state.unreadCount - readCount);
+      this.setState({ notifications: notifications2, unreadCount: unreadCount2 });
+    } catch (error) {
+      this.setState({
+        error: error instanceof Error ? error.message : "Failed to mark notifications as read"
+      });
+    }
+  }
+  /**
+   * Mark all notifications as read.
+   */
+  async markAllRead() {
+    try {
+      await notificationsApi.markAllRead();
+      const notifications2 = this.state.notifications.map((n) => ({
+        ...n,
+        read: true,
+        readAt: n.readAt || (/* @__PURE__ */ new Date()).toISOString()
+      }));
+      this.setState({ notifications: notifications2, unreadCount: 0 });
+    } catch (error) {
+      this.setState({
+        error: error instanceof Error ? error.message : "Failed to mark all notifications as read"
+      });
+    }
+  }
+  /**
+   * Dismiss (delete) a notification.
+   */
+  async dismiss(id) {
+    try {
+      await notificationsApi.dismiss(id);
+      const dismissed = this.state.notifications.find((n) => n.id === id);
+      const notifications2 = this.state.notifications.filter((n) => n.id !== id);
+      const unreadCount2 = dismissed && !dismissed.read ? Math.max(0, this.state.unreadCount - 1) : this.state.unreadCount;
+      this.setState({ notifications: notifications2, unreadCount: unreadCount2 });
+    } catch (error) {
+      this.setState({
+        error: error instanceof Error ? error.message : "Failed to dismiss notification"
+      });
+    }
+  }
+  /**
+   * Delete all notifications.
+   */
+  async deleteAll() {
+    try {
+      await notificationsApi.deleteAll();
+      this.setState({ notifications: [], unreadCount: 0 });
+    } catch (error) {
+      this.setState({
+        error: error instanceof Error ? error.message : "Failed to delete all notifications"
+      });
+    }
+  }
+  /**
+   * Clear the error state.
+   */
+  clearError() {
+    this.setState({ error: null });
+  }
+  /**
+   * Reset the store to initial state.
+   */
+  reset() {
+    this.setState({
+      notifications: [],
+      unreadCount: 0,
+      isLoading: false,
+      error: null,
+      pagination: {
+        page: 1,
+        limit: 20,
+        total: 0,
+        totalPages: 0
+      }
+    });
+  }
+};
+var notificationStore = new NotificationStore();
+var unreadCount = {
+  subscribe: (subscriber) => {
+    return notificationStore.subscribe((state) => subscriber(state.unreadCount));
+  }
+};
+var notifications = {
+  subscribe: (subscriber) => {
+    return notificationStore.subscribe((state) => subscriber(state.notifications));
+  }
+};
+var isLoadingNotifications = {
+  subscribe: (subscriber) => {
+    return notificationStore.subscribe((state) => subscriber(state.isLoading));
+  }
+};
+
+export { isLoadingNotifications, notificationStore, notifications, unreadCount };

package/dist/types-BSztr7EQ.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Notification Types
+ *
+ * Type definitions for notification-related data structures.
+ */
+type NotificationType = 'security' | 'system' | 'feature' | 'update' | 'alert' | 'info';
+type NotificationPriority = 'urgent' | 'high' | 'normal' | 'low';
+interface Notification {
+    id: string;
+    userId: string;
+    type: NotificationType;
+    category: string;
+    title: string;
+    message: string;
+    icon?: string;
+    color?: string;
+    priority: NotificationPriority;
+    read: boolean;
+    dismissed: boolean;
+    actionUrl?: string;
+    actionLabel?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    readAt?: string;
+    dismissedAt?: string;
+}
+interface NotificationsListResponse {
+    notifications: Notification[];
+    unreadCount: number;
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+interface NotificationListParams {
+    page?: number;
+    limit?: number;
+    unreadOnly?: boolean;
+    readOnly?: boolean;
+    type?: NotificationType;
+}
+type ChannelType = 'email' | 'sms' | 'push' | 'in_app';
+interface NotificationChannel {
+    id: string;
+    name: string;
+    displayName: string;
+    description?: string;
+    enabled: boolean;
+    priority: number;
+}
+type NotificationFrequency = 'immediate' | 'digest_hourly' | 'digest_daily' | 'digest_weekly';
+interface NotificationPreference {
+    id: string;
+    userId: string;
+    channelId: string;
+    notificationType: NotificationType;
+    notificationCategory?: string;
+    enabled: boolean;
+    frequency: NotificationFrequency;
+    quietHoursStart?: string;
+    quietHoursEnd?: string;
+    quietHoursTimezone?: string;
+    minPriority: NotificationPriority;
+    tags?: string[];
+    createdAt: string;
+    updatedAt?: string;
+}
+interface UpdatePreferenceData {
+    channelId: string;
+    notificationType: NotificationType;
+    notificationCategory?: string;
+    enabled: boolean;
+    frequency?: NotificationFrequency;
+    quietHoursStart?: string;
+    quietHoursEnd?: string;
+    quietHoursTimezone?: string;
+    minPriority?: NotificationPriority;
+    tags?: string[];
+}
+interface BatchPreferenceUpdate {
+    eventType: string;
+    channels?: ChannelType[];
+    enabled?: boolean;
+    minPriority?: NotificationPriority;
+}
+interface NotificationPreferenceResult {
+    subscriptionId: string;
+    eventType: string;
+    success: boolean;
+    error?: string;
+}
+interface NotificationError {
+    subscriptionId?: string;
+    eventType?: string;
+    message: string;
+    code?: string;
+}
+interface BulkPreferenceResponse {
+    success: boolean;
+    total: number;
+    successful: number;
+    failed: number;
+    results: NotificationPreferenceResult[];
+    errors?: NotificationError[];
+}
+interface ChannelsResponse {
+    success: boolean;
+    channels: NotificationChannel[];
+}
+interface PreferencesResponse {
+    success: boolean;
+    preferences: NotificationPreference[];
+}
+interface UpdatePreferenceResponse {
+    success: boolean;
+    message: string;
+    subscriptionId: string;
+}
+interface DeletePreferenceResponse {
+    success: boolean;
+    message: string;
+}
+interface TestNotificationParams {
+    userId?: string;
+    type?: NotificationType;
+}
+interface TestNotificationResponse {
+    message: string;
+    data: {
+        targetUserId: string;
+        notifications: Array<{
+            id: string;
+            type: string;
+            title: string;
+        }>;
+    };
+}
+
+export type { BatchPreferenceUpdate as B, ChannelType as C, DeletePreferenceResponse as D, NotificationType as N, PreferencesResponse as P, TestNotificationParams as T, UpdatePreferenceData as U, NotificationPriority as a, Notification as b, NotificationsListResponse as c, NotificationListParams as d, NotificationChannel as e, NotificationFrequency as f, NotificationPreference as g, NotificationPreferenceResult as h, NotificationError as i, BulkPreferenceResponse as j, ChannelsResponse as k, UpdatePreferenceResponse as l, TestNotificationResponse as m };

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@classic-homes/notifications",
+  "version": "0.1.0",
+  "description": "Notification services and Svelte bindings for Classic Theme apps",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./svelte": {
+      "types": "./dist/svelte/index.d.ts",
+      "import": "./dist/svelte/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "notifications",
+    "svelte",
+    "classic-theme"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Classic-Homes/classic-theme.git",
+    "directory": "packages/notifications"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@classic-homes/auth": "*"
+  },
+  "peerDependencies": {
+    "svelte": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "svelte": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "svelte": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  }
+}