@kasuvia/sdk 0.0.8 → 0.0.9

package/src/services/notifications.service.ts

@@ -1,10 +1,13 @@
 /**
  * Notification Service
- * 
- * Handles contact form submissions and email notifications.
+ *
+ * Handles contact form submissions, email notifications, and notification
+ * channel preferences (customer self-service + merchant-level policy).
  * Stateless - all configuration passed as parameters.
  */
 import type { SdkConfig } from '../config'
+import type { NotificationPreferences } from '../types/auth'
+import { apiRequest, storefrontHeaders, JSON_HEADERS } from '../utils/http-client'
 
 export interface ContactFormData {
   name: string
@@ -14,7 +17,10 @@ export interface ContactFormData {
   source?: string
   company_name?: string
   current_year?: number
-  turnstile_token?: string
+}
+
+function bearerHeaders(accessToken: string): Record<string, string> {
+  return { Authorization: `Bearer ${accessToken}` }
 }
 
 /**
@@ -25,17 +31,12 @@ export async function sendContactEmail(
   config: SdkConfig,
   payload: ContactFormData
 ): Promise<{ detail: string }> {
-  const response = await fetch(`${config.backendUrls.notifications}/contact/send-contact-email`, {
+  return apiRequest<{ detail: string }>(`${config.backendUrls.notifications}/contact/send-contact-email`, {
     method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      "X-Storefront-Key": config.storefrontApiKey,
-      "X-Business-ID": config.businessId,
-    },
+    headers: { ...JSON_HEADERS, ...storefrontHeaders(config) },
     body: JSON.stringify(payload),
+    fallbackErrorMessage: 'Failed to send contact email',
   })
-  if (!response.ok) throw new Error('Failed to send contact email')
-  return response.json()
 }
 
 /**
@@ -44,22 +45,205 @@ export async function sendContactEmail(
  */
 export async function sendContactConfirmation(
   config: SdkConfig,
-  payload: Omit<ContactFormData, 'turnstile_token'>
+  payload: ContactFormData
 ): Promise<{ detail: string }> {
-  const response = await fetch(`${config.backendUrls.notifications}/contact/send-contact-confirmation`, {
+  return apiRequest<{ detail: string }>(`${config.backendUrls.notifications}/contact/send-contact-confirmation`, {
     method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      "X-Storefront-Key": config.storefrontApiKey,
-      "X-Business-ID": config.businessId,
-    },
+    headers: { ...JSON_HEADERS, ...storefrontHeaders(config) },
+    body: JSON.stringify(payload),
+    fallbackErrorMessage: 'Failed to send contact confirmation',
+  })
+}
+
+/**
+ * Get the caller's own notification preferences (customer or business
+ * owner self-service — whoever's access token is passed).
+ * GET /notifications/preferences/
+ */
+export async function getNotificationPreferences(
+  config: SdkConfig,
+  accessToken: string
+): Promise<NotificationPreferences> {
+  return apiRequest<NotificationPreferences>(`${config.backendUrls.notifications}/notifications/preferences/`, {
+    headers: bearerHeaders(accessToken),
+    fallbackErrorMessage: 'Failed to fetch notification preferences',
+  })
+}
+
+/**
+ * Update the caller's own notification preferences.
+ * PATCH /notifications/preferences/
+ */
+export async function updateNotificationPreferences(
+  config: SdkConfig,
+  accessToken: string,
+  payload: Partial<NotificationPreferences>
+): Promise<NotificationPreferences> {
+  return apiRequest<NotificationPreferences>(`${config.backendUrls.notifications}/notifications/preferences/`, {
+    method: 'PATCH',
+    headers: { ...JSON_HEADERS, ...bearerHeaders(accessToken) },
     body: JSON.stringify(payload),
+    fallbackErrorMessage: 'Failed to update notification preferences',
+  })
+}
+
+// ── Push subscriptions ───────────────────────────────────────────────────
+// REAL FEATURE WIRED (2026-09-21): kasuvia-notification-system-go's push.go
+// (VAPID key, subscribe/unsubscribe, device list) already works correctly
+// for both owner/staff and customer callers (role-branched server-side) but
+// had zero SDK coverage. Auth here is JWT-bearer-only (AuthMiddleware —
+// no X-Storefront-Key/X-Business-ID requirement), matching
+// getNotificationPreferences above.
+
+export interface VapidPublicKeyResponse {
+  public_key: string
+  subject: string
+}
+
+export interface PushSubscriptionKeys {
+  p256dh: string
+  auth: string
+}
+
+export interface SubscribeToPushParams {
+  subscription: {
+    endpoint: string
+    keys: PushSubscriptionKeys
+  }
+  user_agent: string
+}
+
+export async function getVapidPublicKey(config: SdkConfig): Promise<VapidPublicKeyResponse> {
+  return apiRequest<VapidPublicKeyResponse>(`${config.backendUrls.notifications}/push/vapid-public-key`, {
+    fallbackErrorMessage: 'Failed to fetch VAPID public key',
+  })
+}
+
+export async function subscribeToPush(
+  config: SdkConfig,
+  accessToken: string,
+  params: SubscribeToPushParams
+): Promise<{ status: string; subscription_id: string; vapid_key_version: number }> {
+  return apiRequest(`${config.backendUrls.notifications}/push/subscribe`, {
+    method: 'POST',
+    headers: { ...JSON_HEADERS, ...bearerHeaders(accessToken) },
+    body: JSON.stringify(params),
+    fallbackErrorMessage: 'Failed to subscribe to push notifications',
+  })
+}
+
+export async function unsubscribeFromPush(
+  config: SdkConfig,
+  accessToken: string,
+  endpoint: string
+): Promise<{ status: string }> {
+  return apiRequest(`${config.backendUrls.notifications}/push/subscribe`, {
+    method: 'DELETE',
+    headers: { ...JSON_HEADERS, ...bearerHeaders(accessToken) },
+    body: JSON.stringify({ endpoint }),
+    fallbackErrorMessage: 'Failed to unsubscribe from push notifications',
+  })
+}
+
+// ── Notification inbox ──────────────────────────────────────────────────
+// REAL FEATURE WIRED (2026-09-21): kasuvia-notification-system-go's
+// notification_inbox.go (list/mark-read/mark-all-read/click) — fixed
+// alongside this to actually work for a customer caller (see that file's
+// own doc comments: it used to always query/check by user_id, which a
+// customer-facing notification never has set).
+
+export type NotificationPriority = 'urgent' | 'normal' | 'low'
+
+export interface NotificationInboxItem {
+  id: string
+  title: string
+  body: string
+  icon_url?: string | null
+  image_url?: string | null
+  priority: NotificationPriority
+  action_type?: string | null
+  action_url?: string | null
+  entity_id?: string | null
+  entity_type?: string | null
+  category: string
+  source_event_type: string
+  read: boolean
+  read_at?: string | null
+  clicked: boolean
+  clicked_at?: string | null
+  action_performed: boolean
+  created_at: string
+  expires_at?: string | null
+}
+
+export interface NotificationInboxResponse {
+  results: NotificationInboxItem[]
+  count: number
+  page: number
+  page_size: number
+  total_pages: number
+}
+
+export async function getNotificationInbox(
+  config: SdkConfig,
+  accessToken: string,
+  params?: { page?: number; limit?: number; unread_only?: boolean }
+): Promise<NotificationInboxResponse> {
+  const query = new URLSearchParams()
+  if (params?.page) query.set('page', String(params.page))
+  if (params?.limit) query.set('limit', String(params.limit))
+  if (params?.unread_only) query.set('unread_only', 'true')
+  return apiRequest<NotificationInboxResponse>(`${config.backendUrls.notifications}/notifications?${query.toString()}`, {
+    headers: bearerHeaders(accessToken),
+    fallbackErrorMessage: 'Failed to fetch notifications',
+  })
+}
+
+export async function markNotificationRead(
+  config: SdkConfig,
+  accessToken: string,
+  notificationId: string
+): Promise<{ status: string }> {
+  return apiRequest(`${config.backendUrls.notifications}/notifications/${notificationId}/read`, {
+    method: 'POST',
+    headers: bearerHeaders(accessToken),
+    fallbackErrorMessage: 'Failed to mark notification as read',
+  })
+}
+
+export async function markAllNotificationsRead(
+  config: SdkConfig,
+  accessToken: string
+): Promise<{ status: string }> {
+  return apiRequest(`${config.backendUrls.notifications}/notifications/mark-all-read`, {
+    method: 'POST',
+    headers: bearerHeaders(accessToken),
+    fallbackErrorMessage: 'Failed to mark all notifications as read',
+  })
+}
+
+export async function trackNotificationClick(
+  config: SdkConfig,
+  accessToken: string,
+  notificationId: string
+): Promise<{ status: string }> {
+  return apiRequest(`${config.backendUrls.notifications}/notifications/${notificationId}/click`, {
+    method: 'POST',
+    headers: bearerHeaders(accessToken),
+    fallbackErrorMessage: 'Failed to track notification click',
   })
-  if (!response.ok) throw new Error('Failed to send contact confirmation')
-  return response.json()
 }
 
 export const notificationsService = {
   sendContactEmail,
   sendContactConfirmation,
+  getNotificationPreferences,
+  updateNotificationPreferences,
+  getVapidPublicKey,
+  subscribeToPush,
+  unsubscribeFromPush,
+  getNotificationInbox,
+  markNotificationRead,
+  markAllNotificationsRead,
+  trackNotificationClick,
 } as const