@hipnation-truth/sdk 0.6.0 → 0.7.0

package/dist/index.js

@@ -72,6 +72,8 @@ __export(src_exports, {
   NOTIFICATION_EVENTS: () => NOTIFICATION_EVENTS,
   NotesError: () => NotesError,
   NotesResource: () => NotesResource,
+  NotificationsError: () => NotificationsError,
+  NotificationsResource: () => NotificationsResource,
   PROVIDER_EVENTS: () => PROVIDER_EVENTS,
   PatientDetailsError: () => PatientDetailsError,
   PatientDetailsResource: () => PatientDetailsResource,
@@ -87,7 +89,12 @@ __export(src_exports, {
   TranslationError: () => TranslationError,
   TranslationResource: () => TranslationResource,
   TruthClient: () => TruthClient,
-  generateUuidV7: () => generateUuidV7
+  generateUuidV7: () => generateUuidV7,
+  isWebPushSupported: () => isWebPushSupported,
+  onServiceWorkerMessage: () => onServiceWorkerMessage,
+  registerServiceWorker: () => registerServiceWorker,
+  subscribeToPush: () => subscribeToPush,
+  subscriptionToJSON: () => subscriptionToJSON
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -627,6 +634,188 @@ var NotesResource = class {
   }
 };
 
+// src/resources/notifications.ts
+var NotificationsError = class extends Error {
+  constructor(operation, status, message) {
+    super(message != null ? message : `Notifications ${operation} failed (HTTP ${status})`);
+    this.name = "NotificationsError";
+    this.status = status;
+  }
+};
+var NotificationsResource = class {
+  constructor(apiBaseUrl, apiKey) {
+    this.baseUrl = apiBaseUrl;
+    this.apiKey = apiKey;
+  }
+  post(path, body) {
+    return __async(this, null, function* () {
+      const res = yield fetch(`${this.baseUrl}/api${path}`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Accept: "application/json",
+          "X-API-Key": this.apiKey
+        },
+        body: JSON.stringify(body)
+      });
+      if (!res.ok) {
+        const text = yield res.text().catch(() => "");
+        throw new NotificationsError(path, res.status, text.slice(0, 200));
+      }
+      return yield res.json();
+    });
+  }
+  get(path, params) {
+    return __async(this, null, function* () {
+      const url = new URL(`${this.baseUrl}/api${path}`);
+      for (const [k, v] of Object.entries(params)) {
+        url.searchParams.set(k, v);
+      }
+      const res = yield fetch(url.toString(), {
+        method: "GET",
+        headers: {
+          Accept: "application/json",
+          "X-API-Key": this.apiKey
+        }
+      });
+      if (!res.ok) {
+        const text = yield res.text().catch(() => "");
+        throw new NotificationsError(path, res.status, text.slice(0, 200));
+      }
+      return yield res.json();
+    });
+  }
+  delete(path) {
+    return __async(this, null, function* () {
+      const res = yield fetch(`${this.baseUrl}/api${path}`, {
+        method: "DELETE",
+        headers: {
+          Accept: "application/json",
+          "X-API-Key": this.apiKey
+        }
+      });
+      if (!res.ok) {
+        const text = yield res.text().catch(() => "");
+        throw new NotificationsError(path, res.status, text.slice(0, 200));
+      }
+      return yield res.json();
+    });
+  }
+  /**
+   * Register a device (or refresh its metadata) for push delivery.
+   * Safe to call repeatedly — the server dedupes by native token.
+   */
+  registerDevice(input) {
+    return __async(this, null, function* () {
+      return this.post("/notifications/devices/register", input);
+    });
+  }
+  /** Revoke a device — on sign-out or when the OS reports an invalid token. */
+  unregisterDevice(input) {
+    return __async(this, null, function* () {
+      return this.post("/notifications/devices/unregister", input);
+    });
+  }
+  /**
+   * Send a push notification to every active device belonging to
+   * `userId`. Honors the user's notificationPreferences (quiet hours,
+   * DND, channel off) before publishing.
+   */
+  send(input) {
+    return __async(this, null, function* () {
+      return this.post("/notifications/send", input);
+    });
+  }
+  /** Read a user's notification preferences. Returns defaults when no row exists. */
+  getPreferences(userId) {
+    return __async(this, null, function* () {
+      return this.get("/notifications/preferences", { userId });
+    });
+  }
+  updatePreferences(input) {
+    return __async(this, null, function* () {
+      return this.post("/notifications/preferences", input);
+    });
+  }
+  /**
+   * Schedule a future push notification. Convex's native scheduler
+   * fires the send at `scheduledAt` and runs the same delivery
+   * pipeline as `send()` (preferences, devices, history audit).
+   *
+   * Throws `NotificationsError` with status 400 if `scheduledAt` is
+   * not strictly in the future.
+   */
+  schedule(input) {
+    return __async(this, null, function* () {
+      return this.post("/notifications/schedule", input);
+    });
+  }
+  /**
+   * Cancel a pending scheduled notification. Returns `cancelled: false`
+   * (no error) if the job has already executed, was previously
+   * cancelled, or no longer exists — `reason` describes which case.
+   */
+  cancelScheduled(jobId) {
+    return __async(this, null, function* () {
+      return this.delete(`/notifications/schedule/${encodeURIComponent(jobId)}`);
+    });
+  }
+  /**
+   * List scheduled notifications for a user — pending, executed,
+   * cancelled, or failed. Most-recent first. Default limit 100.
+   */
+  listScheduled(userId, options) {
+    return __async(this, null, function* () {
+      const params = { userId };
+      if ((options == null ? void 0 : options.limit) !== void 0) {
+        params.limit = String(options.limit);
+      }
+      return this.get("/notifications/schedule", params);
+    });
+  }
+  getVapidKey() {
+    return __async(this, null, function* () {
+      try {
+        const result = yield this.get(
+          "/notifications/vapid-key",
+          {}
+        );
+        return result.vapidPublicKey;
+      } catch (e) {
+        return null;
+      }
+    });
+  }
+  onPushReceived(callback) {
+    if (typeof navigator === "undefined" || !("serviceWorker" in navigator)) {
+      return () => {
+      };
+    }
+    const handler = (event) => {
+      var _a;
+      if (((_a = event.data) == null ? void 0 : _a.type) === "TRUTH_PUSH_RECEIVED") {
+        callback(event.data.payload);
+      }
+    };
+    navigator.serviceWorker.addEventListener("message", handler);
+    return () => navigator.serviceWorker.removeEventListener("message", handler);
+  }
+  onPushTapped(callback) {
+    if (typeof navigator === "undefined" || !("serviceWorker" in navigator)) {
+      return () => {
+      };
+    }
+    const handler = (event) => {
+      var _a;
+      if (((_a = event.data) == null ? void 0 : _a.type) === "TRUTH_PUSH_TAPPED") {
+        callback(event.data.payload);
+      }
+    };
+    navigator.serviceWorker.addEventListener("message", handler);
+    return () => navigator.serviceWorker.removeEventListener("message", handler);
+  }
+};
+
 // src/resources/patient-details.ts
 var PatientDetailsError = class extends Error {
   constructor(operation, status, message) {
@@ -1192,6 +1381,65 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
+// src/web-push.ts
+function isWebPushSupported() {
+  return typeof window !== "undefined" && "serviceWorker" in navigator && "PushManager" in window;
+}
+function registerServiceWorker(path = "/truth-sw.js") {
+  return __async(this, null, function* () {
+    return navigator.serviceWorker.register(path);
+  });
+}
+function subscribeToPush(registration, vapidPublicKey) {
+  return __async(this, null, function* () {
+    const existing = yield registration.pushManager.getSubscription();
+    if (existing) {
+      return existing;
+    }
+    return registration.pushManager.subscribe({
+      userVisibleOnly: true,
+      applicationServerKey: urlBase64ToUint8Array(
+        vapidPublicKey
+      )
+    });
+  });
+}
+function subscriptionToJSON(sub) {
+  var _a, _b, _c, _d;
+  const json = sub.toJSON();
+  return {
+    endpoint: sub.endpoint,
+    keys: {
+      p256dh: (_b = (_a = json.keys) == null ? void 0 : _a.p256dh) != null ? _b : "",
+      auth: (_d = (_c = json.keys) == null ? void 0 : _c.auth) != null ? _d : ""
+    }
+  };
+}
+function urlBase64ToUint8Array(base64String) {
+  const padding = "=".repeat((4 - base64String.length % 4) % 4);
+  const base64 = (base64String + padding).replace(/-/g, "+").replace(/_/g, "/");
+  const rawData = atob(base64);
+  const outputArray = new Uint8Array(rawData.length);
+  for (let i = 0; i < rawData.length; ++i) {
+    outputArray[i] = rawData.charCodeAt(i);
+  }
+  return outputArray;
+}
+function onServiceWorkerMessage(type, callback) {
+  if (typeof navigator === "undefined" || !("serviceWorker" in navigator)) {
+    return () => {
+    };
+  }
+  const handler = (event) => {
+    var _a;
+    if (((_a = event.data) == null ? void 0 : _a.type) === type) {
+      callback(event.data.payload);
+    }
+  };
+  navigator.serviceWorker.addEventListener("message", handler);
+  return () => navigator.serviceWorker.removeEventListener("message", handler);
+}
+
 // src/client.ts
 var CONVEX_URLS = {
   local: "https://courteous-duck-623.convex.cloud",
@@ -1203,7 +1451,9 @@ var CONVEX_URLS = {
 };
 var TruthClient = class {
   constructor(config) {
-    var _a, _b, _c, _d, _e, _f, _g;
+    this._vapidPublicKey = null;
+    this._webPushReady = null;
+    var _a, _b, _c, _d, _e, _f, _g, _h;
     const convexUrl = (_b = (_a = config.convexUrl) != null ? _a : CONVEX_URLS[config.environment]) != null ? _b : CONVEX_URLS.local;
     this.convex = new import_browser.ConvexHttpClient(convexUrl);
     this.tracker = new Tracker({
@@ -1232,6 +1482,40 @@ var TruthClient = class {
     );
     this.notes = new NotesResource(apiUrl, config.apiKey);
     this.physicians = new PhysiciansResource(this.convex);
+    this.notifications = new NotificationsResource(apiUrl, config.apiKey);
+    this._serviceWorkerPath = (_h = config.serviceWorkerPath) != null ? _h : "/truth-sw.js";
+    if (typeof window !== "undefined" && isWebPushSupported() && config.autoInitServiceWorker !== false) {
+      this._webPushReady = this.initWebPush();
+    }
+  }
+  get vapidPublicKey() {
+    return this._vapidPublicKey;
+  }
+  get webPushReady() {
+    return this._webPushReady;
+  }
+  initWebPush() {
+    return __async(this, null, function* () {
+      try {
+        const key = yield this.notifications.getVapidKey();
+        if (!key) {
+          return;
+        }
+        this._vapidPublicKey = key;
+        const registration = yield registerServiceWorker(this._serviceWorkerPath);
+        yield navigator.serviceWorker.ready;
+        const subscription = yield subscribeToPush(registration, key);
+        const subJSON = subscriptionToJSON(subscription);
+        yield this.notifications.registerDevice({
+          userId: "__pending__",
+          platform: "web",
+          webPushSubscription: subJSON,
+          locale: navigator.language,
+          timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
+        });
+      } catch (e) {
+      }
+    });
   }
   /**
    * The resolved Truth API base URL for this environment.
@@ -1389,6 +1673,8 @@ var ENVIRONMENTS = {
   NOTIFICATION_EVENTS,
   NotesError,
   NotesResource,
+  NotificationsError,
+  NotificationsResource,
   PROVIDER_EVENTS,
   PatientDetailsError,
   PatientDetailsResource,
@@ -1404,6 +1690,11 @@ var ENVIRONMENTS = {
   TranslationError,
   TranslationResource,
   TruthClient,
-  generateUuidV7
+  generateUuidV7,
+  isWebPushSupported,
+  onServiceWorkerMessage,
+  registerServiceWorker,
+  subscribeToPush,
+  subscriptionToJSON
 });
 //# sourceMappingURL=index.js.map