@noverachat/sdk-web 0.0.3 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noverachat/sdk-web",
-  "version": "0.0.3",
+  "version": "0.2.0",
   "description": "NoveraChat browser/Node SDK — WebSocket + REST client with optimistic UI, reconnection and gap-fill",
   "license": "MIT",
   "type": "module",

package/src/client.ts

@@ -14,6 +14,11 @@ import type {
   MessageIdStr, RegisterDeviceParams, UnreadSummary, WsAnnouncementEvent,
   WsInbound, WsPresence, WsRoomEvent,
 } from "./types.js";
+import {
+  parseAppPolicy, parseBlockOut, parseDeviceListResponse, parseDeviceOut,
+  parseFileOut, parseInviteAcceptResponse, parsePushPreferencesOut,
+  parseUnreadSummary,
+} from "./generated/rest.js";
 
 /** Client-level events (not tied to a single Room facade). `roomEvent` fires
  *  for membership / room-lifecycle changes on ANY room — including ones the
@@ -202,20 +207,8 @@ export class NoveraChat {
    *  read on the server) — fetch once on connect to decide which
    *  destructive buttons to expose. */
   async appPolicy(): Promise<AppPolicy> {
-    const raw = await this.http.request<{
-      app_id: string;
-      allow_member_bulk_delete: boolean;
-      read_receipts_enabled: boolean;
-      typing_indicators_enabled: boolean;
-      allow_member_delete_any_message: boolean;
-    }>("GET", "/api/v1/app/policy");
-    return {
-      appId: raw.app_id,
-      allowMemberBulkDelete: raw.allow_member_bulk_delete,
-      readReceiptsEnabled: raw.read_receipts_enabled ?? true,
-      typingIndicatorsEnabled: raw.typing_indicators_enabled ?? true,
-      deleteAnyMessageEnabled: raw.allow_member_delete_any_message ?? false,
-    };
+    const raw = await this.http.request<unknown>("GET", "/api/v1/app/policy");
+    return parseAppPolicy(raw);
   }
 
   // ---- device tokens (push) ----
@@ -227,32 +220,21 @@ export class NoveraChat {
    * safe. Returns the stored device record (token shown only as a prefix).
    */
   async registerDevice(params: RegisterDeviceParams): Promise<DeviceInfo> {
-    const raw = await this.http.request<{
-      device_id: string;
-      token_type: DeviceInfo["tokenType"];
-      token_preview: string;
-      os: DeviceInfo["os"];
-      app_version: string | null;
-      push_enabled: boolean;
-      last_active_at: string | null;
-      created_at: string;
-    }>("POST", "/api/v1/users/me/devices", {
-      device_id: params.deviceId,
-      token: params.token,
-      token_type: params.tokenType,
-      os: params.os ?? null,
-      app_version: params.appVersion ?? null,
-    });
-    return this._toDeviceInfo(raw);
+    const raw = await this.http.request<unknown>(
+      "POST", "/api/v1/users/me/devices", {
+        device_id: params.deviceId,
+        token: params.token,
+        token_type: params.tokenType,
+        os: params.os ?? null,
+        app_version: params.appVersion ?? null,
+      });
+    return parseDeviceOut(raw);
   }
 
   /** List the devices registered for the authenticated user. */
   async listDevices(): Promise<DeviceInfo[]> {
-    const raw = await this.http.request<{
-      items: Array<Parameters<NoveraChat["_toDeviceInfo"]>[0]>;
-      total: number;
-    }>("GET", "/api/v1/users/me/devices");
-    return raw.items.map((d) => this._toDeviceInfo(d));
+    const raw = await this.http.request<unknown>("GET", "/api/v1/users/me/devices");
+    return parseDeviceListResponse(raw).items;
   }
 
   /**
@@ -288,10 +270,10 @@ export class NoveraChat {
    *   2. **Global (this)** — overrides all rooms when off.
    */
   async getPushPreferences(): Promise<{ pushEnabled: boolean }> {
-    const raw = await this.http.request<{ push_enabled: boolean }>(
+    const raw = await this.http.request<unknown>(
       "GET", "/api/v1/users/me/push-preferences",
     );
-    return { pushEnabled: Boolean(raw.push_enabled) };
+    return parsePushPreferencesOut(raw);
   }
 
   /**
@@ -300,11 +282,11 @@ export class NoveraChat {
    * `true` to restore normal delivery. Idempotent.
    */
   async setPushEnabled(enabled: boolean): Promise<{ pushEnabled: boolean }> {
-    const raw = await this.http.request<{ push_enabled: boolean }>(
+    const raw = await this.http.request<unknown>(
       "PATCH", "/api/v1/users/me/push-preferences",
       { push_enabled: enabled },
     );
-    return { pushEnabled: Boolean(raw.push_enabled) };
+    return parsePushPreferencesOut(raw);
   }
 
   // -------------------------------------------------------------------------
@@ -325,19 +307,11 @@ export class NoveraChat {
    * @param reason  Optional local note ≤500 chars.
    */
   async blockUser(userId: string, reason?: string): Promise<Block> {
-    const raw = await this.http.request<{
-      blocked_user_id: string;
-      reason: string | null;
-      created_at: string;
-    }>(
+    const raw = await this.http.request<unknown>(
       "POST", `/api/v1/users/me/blocks/${encodeURIComponent(userId)}`,
       { reason: reason ?? null },
     );
-    return {
-      blockedUserId: raw.blocked_user_id,
-      reason: raw.reason,
-      createdAt: raw.created_at,
-    };
+    return parseBlockOut(raw);
   }
 
   /** Unblock a user. Idempotent — resolves either way. */
@@ -349,38 +323,8 @@ export class NoveraChat {
 
   /** List every user the caller has blocked, newest first. */
   async listBlocks(): Promise<Block[]> {
-    const raw = await this.http.request<Array<{
-      blocked_user_id: string;
-      reason: string | null;
-      created_at: string;
-    }>>("GET", "/api/v1/users/me/blocks");
-    return raw.map((r) => ({
-      blockedUserId: r.blocked_user_id,
-      reason: r.reason,
-      createdAt: r.created_at,
-    }));
-  }
-
-  private _toDeviceInfo(raw: {
-    device_id: string;
-    token_type: DeviceInfo["tokenType"];
-    token_preview: string;
-    os: DeviceInfo["os"];
-    app_version: string | null;
-    push_enabled: boolean;
-    last_active_at: string | null;
-    created_at: string;
-  }): DeviceInfo {
-    return {
-      deviceId: raw.device_id,
-      tokenType: raw.token_type,
-      tokenPreview: raw.token_preview,
-      os: raw.os,
-      appVersion: raw.app_version,
-      pushEnabled: raw.push_enabled,
-      lastActiveAt: raw.last_active_at,
-      createdAt: raw.created_at,
-    };
+    const raw = await this.http.request<unknown[]>("GET", "/api/v1/users/me/blocks");
+    return raw.map((r) => parseBlockOut(r));
   }
 
   /**
@@ -441,76 +385,31 @@ export class NoveraChat {
    * shipping date.
    */
   async getFileMeta(fileId: MessageIdStr): Promise<FileMeta> {
-    // Wire shape mirrors backend ``FileOut`` (Pydantic v2). The ``id``
-    // field comes through with its alias name, not the model attribute
-    // ``file_id`` — easy mistake to make when looking at the SQLAlchemy
-    // model. ``original_name`` was renamed to ``name`` in the inline
-    // shape but the standalone meta still uses ``original_name``.
-    const raw = await this.http.request<{
-      id: MessageIdStr;
-      kind: "image" | "video" | "file";
-      mime: string;
-      size_bytes: number;
-      original_name: string | null;
-      width: number | null;
-      height: number | null;
-      duration_sec: number | null;
-      thumbnail_status: "pending" | "ready" | "failed" | "skipped";
-      forward_blocked?: boolean;
-    }>("GET", `/api/v1/files/${encodeURIComponent(fileId)}/meta`);
+    // Endpoint returns the generated ``FileOut`` shape (size_bytes /
+    // original_name / …). Parse it with the codegen'd converter, then
+    // fold down to the leaner inline ``FileMeta`` (= FileInline) the SDK
+    // exposes — the same fields WS chat_receive frames carry.
+    const raw = await this.http.request<unknown>(
+      "GET", `/api/v1/files/${encodeURIComponent(fileId)}/meta`,
+    );
+    const f = parseFileOut(raw);
     return {
-      id: raw.id,
-      kind: raw.kind,
-      mime: raw.mime,
-      size: raw.size_bytes,
-      name: raw.original_name ?? null,
-      width: raw.width ?? null,
-      height: raw.height ?? null,
-      durationSec: raw.duration_sec ?? null,
-      thumbnailStatus: raw.thumbnail_status,
-      forwardBlocked: Boolean(raw.forward_blocked),
+      id: f.id,
+      kind: f.kind,
+      mime: f.mime,
+      size: f.sizeBytes,
+      name: f.originalName ?? null,
+      width: f.width ?? null,
+      height: f.height ?? null,
+      durationSec: f.durationSec ?? null,
+      thumbnailStatus: f.thumbnailStatus,
+      forwardBlocked: Boolean(f.forwardBlocked),
     };
   }
 
   async unreadSummary(): Promise<UnreadSummary> {
-    const raw = await this.http.request<{
-      total: number;
-      rooms: Array<{
-        room_id: string;
-        name: string | null;
-        room_type: string | null;
-        unread_count: number;
-        last_message_id: string | null;
-        last_message_preview: string | null;
-        last_read_message_id: string | null;
-        member_count: number;
-        members_preview: Array<{
-          user_id: string;
-          nickname: string | null;
-          profile_image_url: string | null;
-          is_online: boolean | null;
-        }>;
-      }>;
-    }>("GET", "/api/v1/users/me/unread");
-    return {
-      total: raw.total,
-      rooms: raw.rooms.map((r) => ({
-        roomId: r.room_id,
-        name: r.name,
-        roomType: r.room_type ?? null,
-        unreadCount: r.unread_count,
-        lastMessageId: r.last_message_id,
-        lastMessagePreview: r.last_message_preview ?? null,
-        lastReadMessageId: r.last_read_message_id,
-        memberCount: r.member_count ?? 0,
-        members: (r.members_preview ?? []).map((m) => ({
-          userId: m.user_id,
-          nickname: m.nickname ?? null,
-          profileImageUrl: m.profile_image_url ?? null,
-          isOnline: m.is_online ?? null,
-        })),
-      })),
-    };
+    const raw = await this.http.request<unknown>("GET", "/api/v1/users/me/unread");
+    return parseUnreadSummary(raw);
   }
 
   /**
@@ -529,16 +428,10 @@ export class NoveraChat {
    * kicked from the target room.
    */
   async acceptInvite(token: string): Promise<AcceptInviteResult> {
-    const raw = await this.http.request<{
-      room_id: string;
-      room_name: string | null;
-      was_already_member: boolean;
-    }>("POST", `/api/v1/invites/${encodeURIComponent(token)}/accept`);
-    return {
-      roomId: raw.room_id,
-      roomName: raw.room_name,
-      wasAlreadyMember: raw.was_already_member,
-    };
+    const raw = await this.http.request<unknown>(
+      "POST", `/api/v1/invites/${encodeURIComponent(token)}/accept`,
+    );
+    return parseInviteAcceptResponse(raw);
   }
 
   // ---- internal ----