@noverachat/sdk-web 0.0.3 → 0.2.0

package/dist/index.js

@@ -1,3 +1,221 @@
+// src/generated/rest.ts
+function parseAppPolicy(j) {
+  return {
+    appId: j["app_id"],
+    allowMemberBulkDelete: j["allow_member_bulk_delete"],
+    readReceiptsEnabled: j["read_receipts_enabled"],
+    typingIndicatorsEnabled: j["typing_indicators_enabled"],
+    allowMemberDeleteAnyMessage: j["allow_member_delete_any_message"]
+  };
+}
+function parseUnreadSummary(j) {
+  return {
+    total: j["total"],
+    rooms: j["rooms"].map((e) => parseUnreadRoomItem(e))
+  };
+}
+function parseUnreadRoomItem(j) {
+  return {
+    roomId: j["room_id"],
+    name: j["name"],
+    roomType: j["room_type"],
+    unreadCount: j["unread_count"],
+    lastMessageId: j["last_message_id"],
+    lastReadMessageId: j["last_read_message_id"],
+    lastMessagePreview: j["last_message_preview"],
+    memberCount: j["member_count"],
+    membersPreview: j["members_preview"] == null ? void 0 : j["members_preview"].map((e) => parseMemberPreview(e))
+  };
+}
+function parseMemberPreview(j) {
+  return {
+    userId: j["user_id"],
+    nickname: j["nickname"],
+    profileImageUrl: j["profile_image_url"],
+    isOnline: j["is_online"]
+  };
+}
+function parseRoomUnread(j) {
+  return {
+    roomId: j["room_id"],
+    unreadCount: j["unread_count"],
+    lastReadMessageId: j["last_read_message_id"],
+    lastMessageId: j["last_message_id"]
+  };
+}
+function parseMessageOut(j) {
+  return {
+    appId: j["app_id"],
+    roomId: j["room_id"],
+    messageId: j["message_id"],
+    sender: j["sender"] == null ? null : parseSenderMini(j["sender"]),
+    senderId: j["sender_id"],
+    messageType: j["message_type"],
+    customType: j["custom_type"],
+    content: j["content"],
+    data: j["data"],
+    meta: j["meta"],
+    fileId: j["file_id"],
+    file: j["file"],
+    files: j["files"],
+    replyToId: j["reply_to_id"],
+    reactions: j["reactions"] == null ? void 0 : j["reactions"].map((e) => parseReactionEntry(e)),
+    createdAt: j["created_at"],
+    updatedAt: j["updated_at"],
+    deletedAt: j["deleted_at"],
+    deletedByUserId: j["deleted_by_user_id"],
+    deleteScope: j["delete_scope"],
+    editedCount: j["edited_count"],
+    createdAtMs: j["created_at_ms"],
+    updatedAtMs: j["updated_at_ms"]
+  };
+}
+function parseAnnouncementOut(j) {
+  return {
+    id: j["id"],
+    roomId: j["room_id"],
+    content: j["content"],
+    createdBy: j["created_by"],
+    createdAt: j["created_at"],
+    updatedAt: j["updated_at"]
+  };
+}
+function parseInviteTokenOut(j) {
+  return {
+    token: j["token"],
+    roomId: j["room_id"],
+    createdBy: j["created_by"],
+    createdAt: j["created_at"],
+    expiresAt: j["expires_at"],
+    maxUses: j["max_uses"],
+    usedCount: j["used_count"],
+    revokedAt: j["revoked_at"]
+  };
+}
+function parseInviteAcceptResponse(j) {
+  return {
+    roomId: j["room_id"],
+    roomName: j["room_name"],
+    wasAlreadyMember: j["was_already_member"]
+  };
+}
+function parseDeviceOut(j) {
+  return {
+    deviceId: j["device_id"],
+    tokenType: j["token_type"],
+    tokenPreview: j["token_preview"],
+    os: j["os"],
+    appVersion: j["app_version"],
+    pushEnabled: j["push_enabled"],
+    lastActiveAt: j["last_active_at"],
+    createdAt: j["created_at"]
+  };
+}
+function parseDeviceListResponse(j) {
+  return {
+    items: j["items"].map((e) => parseDeviceOut(e)),
+    total: j["total"]
+  };
+}
+function parsePushPreferencesOut(j) {
+  return {
+    pushEnabled: j["push_enabled"]
+  };
+}
+function parseFileOut(j) {
+  return {
+    id: j["id"],
+    kind: j["kind"],
+    mime: j["mime"],
+    sizeBytes: j["size_bytes"],
+    originalName: j["original_name"],
+    width: j["width"],
+    height: j["height"],
+    durationSec: j["duration_sec"],
+    thumbnailStatus: j["thumbnail_status"],
+    uploadStatus: j["upload_status"],
+    createdAt: j["created_at"],
+    committedAt: j["committed_at"],
+    forwardBlocked: j["forward_blocked"]
+  };
+}
+function parseFileCreateResponse(j) {
+  return {
+    fileId: j["file_id"],
+    uploadUrl: j["upload_url"],
+    headers: j["headers"],
+    expiresAtMs: j["expires_at_ms"]
+  };
+}
+function parseBlockOut(j) {
+  return {
+    blockedUserId: j["blocked_user_id"],
+    reason: j["reason"],
+    createdAt: j["created_at"]
+  };
+}
+function parseRoomMemberOut(j) {
+  return {
+    userId: j["user_id"],
+    nickname: j["nickname"],
+    role: j["role"],
+    pushTrigger: j["push_trigger"],
+    lastReadMessageId: j["last_read_message_id"],
+    joinedAt: j["joined_at"],
+    isOnline: j["is_online"],
+    mutedUntil: j["muted_until"]
+  };
+}
+function parseBulkDeleteResult(j) {
+  return {
+    cleared: j["cleared"],
+    upToMessageId: j["up_to_message_id"]
+  };
+}
+function parseBulkDeleteBySenderResult(j) {
+  return {
+    cleared: j["cleared"]
+  };
+}
+function parseJoinRequestOut(j) {
+  return {
+    userId: j["user_id"],
+    status: j["status"],
+    reason: j["reason"],
+    requestedAt: j["requested_at"],
+    processedAt: j["processed_at"],
+    processedByUserId: j["processed_by_user_id"]
+  };
+}
+function parseJoinRequestListResponse(j) {
+  return {
+    items: j["items"].map((e) => parseJoinRequestOut(e)),
+    total: j["total"],
+    limit: j["limit"],
+    offset: j["offset"]
+  };
+}
+function parseJoinRequestCreateResponse(j) {
+  return {
+    status: j["status"],
+    roomId: j["room_id"]
+  };
+}
+function parseSenderMini(j) {
+  return {
+    userId: j["user_id"],
+    nickname: j["nickname"],
+    profileImageUrl: j["profile_image_url"]
+  };
+}
+function parseReactionEntry(j) {
+  return {
+    key: j["key"],
+    userIds: j["user_ids"],
+    updatedAt: j["updated_at"]
+  };
+}
+
 // src/errors.ts
 var ErrorCode = {
   INTERNAL: "NC-GEN-001",
@@ -293,64 +511,31 @@ function tempId() {
 }
 
 // src/features/room.ts
-function toMessageOut(r) {
-  const dataObj = r.data ?? null;
+function toFileInline(f) {
+  return {
+    id: f.id,
+    kind: f.kind,
+    mime: f.mime,
+    size: f.size,
+    name: f.name ?? null,
+    width: f.width ?? null,
+    height: f.height ?? null,
+    durationSec: f.duration_sec ?? null,
+    thumbnailStatus: f.thumbnail_status,
+    forwardBlocked: Boolean(f.forward_blocked)
+  };
+}
+function toMessageOut(j) {
+  const base = parseMessageOut(j);
+  const raw = j;
+  const dataObj = base.data ?? null;
   const customMeta = dataObj && typeof dataObj === "object" && "_customMeta" in dataObj ? dataObj._customMeta : null;
   return {
-    appId: r.app_id,
-    roomId: r.room_id,
-    messageId: r.message_id,
-    sender: r.sender ? {
-      userId: r.sender.user_id,
-      nickname: r.sender.nickname ?? null,
-      profileImageUrl: r.sender.profile_image_url ?? null
-    } : null,
-    senderId: r.sender_id ?? null,
-    messageType: r.message_type,
-    customType: r.custom_type ?? null,
-    content: r.content ?? null,
-    data: dataObj,
-    meta: r.meta ?? null,
-    customMeta,
-    fileId: r.file_id ?? null,
-    file: r.file ? {
-      id: r.file.id,
-      kind: r.file.kind,
-      mime: r.file.mime,
-      size: r.file.size,
-      name: r.file.name ?? null,
-      width: r.file.width ?? null,
-      height: r.file.height ?? null,
-      durationSec: r.file.duration_sec ?? null,
-      thumbnailStatus: r.file.thumbnail_status,
-      forwardBlocked: Boolean(r.file.forward_blocked)
-    } : null,
-    files: r.files && r.files.length > 0 ? r.files.map((f) => ({
-      id: f.id,
-      kind: f.kind,
-      mime: f.mime,
-      size: f.size,
-      name: f.name ?? null,
-      width: f.width ?? null,
-      height: f.height ?? null,
-      durationSec: f.duration_sec ?? null,
-      thumbnailStatus: f.thumbnail_status,
-      forwardBlocked: Boolean(f.forward_blocked)
-    })) : null,
-    replyToId: r.reply_to_id ?? null,
-    reactions: (r.reactions ?? []).map((x) => ({
-      key: x.key,
-      userIds: x.user_ids,
-      updatedAt: x.updated_at
-    })),
-    createdAt: r.created_at,
-    createdAtMs: r.created_at_ms,
-    updatedAt: r.updated_at ?? null,
-    updatedAtMs: r.updated_at_ms ?? null,
-    deletedAt: r.deleted_at ?? null,
-    deletedByUserId: r.deleted_by_user_id ?? null,
-    deleteScope: r.delete_scope ?? null,
-    editedCount: r.edited_count ?? 0
+    ...base,
+    file: raw.file ? toFileInline(raw.file) : null,
+    files: raw.files && raw.files.length > 0 ? raw.files.map(toFileInline) : null,
+    reactions: base.reactions ?? [],
+    customMeta
   };
 }
 var Room = class _Room {
@@ -536,20 +721,24 @@ var Room = class _Room {
   async sendFile(file, opts = {}) {
     const kind = opts.kind ?? (file.type.startsWith("image/") ? "image" : file.type.startsWith("video/") ? "video" : "file");
     const name = opts.name ?? file.name;
-    const presign = await this.http.request("POST", "/api/v1/files", {
-      kind,
-      mime: file.type || "application/octet-stream",
-      size: file.size,
-      original_name: name,
-      // 파일 전달 제한 — uploader-set at presign time. When true,
-      // other users can't forward this file to a different room.
-      forward_blocked: Boolean(opts.forwardBlocked)
-    });
+    const created = parseFileCreateResponse(
+      await this.http.request("POST", "/api/v1/files", {
+        kind,
+        mime: file.type || "application/octet-stream",
+        size: file.size,
+        original_name: name,
+        // 파일 전달 제한 — uploader-set at presign time. When true,
+        // other users can't forward this file to a different room.
+        forward_blocked: Boolean(opts.forwardBlocked)
+      })
+    );
     const presigned = {
-      fileId: presign.file_id,
-      uploadUrl: presign.upload_url,
-      headers: presign.headers,
-      expiresAtMs: presign.expires_at_ms
+      fileId: created.fileId,
+      uploadUrl: created.uploadUrl,
+      // Presigned S3 headers are always string-valued; the generated
+      // model types the JSON object loosely as Record<string, unknown>.
+      headers: created.headers,
+      expiresAtMs: created.expiresAtMs
     };
     await new Promise((resolve, reject) => {
       const xhr = new XMLHttpRequest();
@@ -604,17 +793,19 @@ var Room = class _Room {
   async uploadFileOnly(file, opts = {}) {
     const kind = opts.kind ?? (file.type.startsWith("image/") ? "image" : file.type.startsWith("video/") ? "video" : "file");
     const name = opts.name ?? file.name;
-    const presign = await this.http.request("POST", "/api/v1/files", {
-      kind,
-      mime: file.type || "application/octet-stream",
-      size: file.size,
-      original_name: name,
-      forward_blocked: Boolean(opts.forwardBlocked)
-    });
+    const created = parseFileCreateResponse(
+      await this.http.request("POST", "/api/v1/files", {
+        kind,
+        mime: file.type || "application/octet-stream",
+        size: file.size,
+        original_name: name,
+        forward_blocked: Boolean(opts.forwardBlocked)
+      })
+    );
     await new Promise((resolve, reject) => {
       const xhr = new XMLHttpRequest();
-      xhr.open("PUT", presign.upload_url);
-      for (const [k, v] of Object.entries(presign.headers)) {
+      xhr.open("PUT", created.uploadUrl);
+      for (const [k, v] of Object.entries(created.headers)) {
         xhr.setRequestHeader(k, v);
       }
       if (opts.onProgress) {
@@ -641,10 +832,10 @@ var Room = class _Room {
     });
     await this.http.request(
       "POST",
-      `/api/v1/files/${presign.file_id}/commit`,
+      `/api/v1/files/${created.fileId}/commit`,
       {}
     );
-    return presign.file_id;
+    return created.fileId;
   }
   /**
    * List files shared in this room — newest-first, paginated.
@@ -669,23 +860,26 @@ var Room = class _Room {
       }
     );
     return {
-      items: raw.items.map((r) => ({
-        messageId: r.message_id,
-        senderId: r.sender_id,
-        createdAtMs: r.created_at_ms,
-        file: {
-          id: r.file.id,
-          kind: r.file.kind,
-          mime: r.file.mime,
-          size: r.file.size_bytes,
-          name: r.file.original_name ?? null,
-          width: r.file.width ?? null,
-          height: r.file.height ?? null,
-          durationSec: r.file.duration_sec ?? null,
-          thumbnailStatus: r.file.thumbnail_status,
-          forwardBlocked: Boolean(r.file.forward_blocked)
-        }
-      })),
+      items: raw.items.map((r) => {
+        const f = parseFileOut(r.file);
+        return {
+          messageId: r.message_id,
+          senderId: r.sender_id,
+          createdAtMs: r.created_at_ms,
+          file: {
+            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)
+          }
+        };
+      }),
       nextCursor: raw.next_cursor,
       hasMore: raw.has_more
     };
@@ -723,11 +917,12 @@ var Room = class _Room {
     this.ws.send({ type: "typing", room_id: this.roomId, is_typing: isTyping });
   }
   async edit(messageId, patch) {
-    return this.http.request(
+    const raw = await this.http.request(
       "PUT",
       `/api/v1/rooms/${this.roomId}/messages/${messageId}`,
       patch
     );
+    return toMessageOut(raw);
   }
   async delete(messageId, scope = "ALL") {
     await this.http.request(
@@ -752,12 +947,39 @@ var Room = class _Room {
    *  Other members get a `MEMBER_LEFT` [`roomEvent`](../reference/noverachat.md#events).
    *  Idempotent if already a non-member; throws 409 if the caller was KICKED
    *  (ask an operator to restore first). For GROUP/SUPER_GROUP, re-entry needs
-   *  an operator add; for ONE, re-creating the 1:1 rejoins with history kept. */
-  async leave() {
+   *  an operator add; for ONE, re-creating the 1:1 rejoins with history kept.
+   *
+   *  Optional `deleteMessages` — atomically clean up chat history as part
+   *  of leaving.  Default is `"none"` (messages survive so the room's
+   *  history keeps making sense to remaining members).
+   *    - `"none"` — leave only.
+   *    - `"mine"` — soft-delete every message YOU sent, then leave.  Other
+   *                 members' messages are untouched.  Broadcasts
+   *                 `messages_cleared_by_sender` so connected clients hide
+   *                 them locally.
+   *    - `"all"`  — wipe every message in the room, then leave.  Subject to
+   *                 the app's `allow_member_bulk_delete` gate and per-room
+   *                 OPERATOR check — a plain member gets 403 back. */
+  async leave(options) {
+    const mode = options?.deleteMessages ?? "none";
+    const query = mode === "none" ? "" : `?delete_messages=${encodeURIComponent(mode)}`;
     await this.http.request(
       "POST",
-      `/api/v1/rooms/${this.roomId}/leave`
+      `/api/v1/rooms/${this.roomId}/leave${query}`
+    );
+  }
+  /** Delete every message YOU sent in this room.  Standalone version of
+   *  `leave({ deleteMessages: "mine" })` — useful when a user wants to
+   *  scrub their history without actually leaving.  Other members'
+   *  messages are untouched; broadcasts `messages_cleared_by_sender`
+   *  so connected clients hide the vanished ones locally.
+   *  No OPERATOR gate — you own your messages. */
+  async deleteMyMessages() {
+    const raw = await this.http.request(
+      "DELETE",
+      `/api/v1/rooms/${this.roomId}/messages/mine`
     );
+    return parseBulkDeleteBySenderResult(raw);
   }
   /**
    * Set the caller's per-room push preference — like long-pressing a
@@ -783,11 +1005,11 @@ var Room = class _Room {
    * hide rendered messages up to (and including) that id.
    */
   async deleteAllMessages() {
-    const raw = await this.http.request("DELETE", `/api/v1/rooms/${this.roomId}/messages`);
-    return {
-      cleared: raw.cleared,
-      upToMessageId: raw.up_to_message_id
-    };
+    const raw = await this.http.request(
+      "DELETE",
+      `/api/v1/rooms/${this.roomId}/messages`
+    );
+    return parseBulkDeleteResult(raw);
   }
   async react(messageId, key) {
     await this.http.request(
@@ -874,17 +1096,11 @@ var Room = class _Room {
    *  rooms, so the caller must already be a member to read this.
    */
   async listMembers() {
-    const raw = await this.http.request("GET", `/api/v1/rooms/${this.roomId}/members`);
-    return raw.map((m) => ({
-      userId: m.user_id,
-      nickname: m.nickname ?? null,
-      role: m.role,
-      pushTrigger: m.push_trigger,
-      lastReadMessageId: m.last_read_message_id,
-      joinedAt: m.joined_at,
-      isOnline: m.is_online ?? null,
-      mutedUntil: m.muted_until ?? null
-    }));
+    const raw = await this.http.request(
+      "GET",
+      `/api/v1/rooms/${this.roomId}/members`
+    );
+    return raw.map((m) => parseRoomMemberOut(m));
   }
   // -------- mute --------
   /** OPERATOR-only: mute a member so they can't send messages in this
@@ -912,13 +1128,11 @@ var Room = class _Room {
    *  newer than the caller's `read_watermark`, plus the room's
    *  `last_message_id` so the UI can show a "•" dot regardless of count. */
   async unread() {
-    const raw = await this.http.request("GET", `/api/v1/rooms/${this.roomId}/unread`);
-    return {
-      roomId: raw.room_id,
-      unreadCount: raw.unread_count,
-      lastReadMessageId: raw.last_read_message_id,
-      lastMessageId: raw.last_message_id
-    };
+    const raw = await this.http.request(
+      "GET",
+      `/api/v1/rooms/${this.roomId}/unread`
+    );
+    return parseRoomUnread(raw);
   }
   // -------- freeze --------
   /** OPERATOR-only moderation: freeze this room. Non-admin messages are
@@ -953,49 +1167,35 @@ var Room = class _Room {
   }
   // -------- announcements --------
   async listAnnouncements() {
-    const raw = await this.http.request("GET", `/api/v1/rooms/${this.roomId}/announcements`);
-    return raw.map((a) => ({
-      id: a.id,
-      roomId: a.room_id,
-      content: a.content,
-      createdBy: a.created_by,
-      createdAt: a.created_at,
-      updatedAt: a.updated_at
-    }));
+    const raw = await this.http.request(
+      "GET",
+      `/api/v1/rooms/${this.roomId}/announcements`
+    );
+    return raw.map((a) => parseAnnouncementOut(a));
   }
   async getCurrentAnnouncement() {
-    const raw = await this.http.request("GET", `/api/v1/rooms/${this.roomId}/announcements/current`);
+    const raw = await this.http.request(
+      "GET",
+      `/api/v1/rooms/${this.roomId}/announcements/current`
+    );
     if (!raw) return null;
-    return {
-      id: raw.id,
-      roomId: raw.room_id,
-      content: raw.content,
-      createdBy: raw.created_by,
-      createdAt: raw.created_at,
-      updatedAt: raw.updated_at
-    };
+    return parseAnnouncementOut(raw);
   }
   async postAnnouncement(content) {
-    const raw = await this.http.request("POST", `/api/v1/rooms/${this.roomId}/announcements`, { content });
-    return {
-      id: raw.id,
-      roomId: raw.room_id,
-      content: raw.content,
-      createdBy: raw.created_by,
-      createdAt: raw.created_at,
-      updatedAt: raw.updated_at
-    };
+    const raw = await this.http.request(
+      "POST",
+      `/api/v1/rooms/${this.roomId}/announcements`,
+      { content }
+    );
+    return parseAnnouncementOut(raw);
   }
   async updateAnnouncement(id, content) {
-    const raw = await this.http.request("PATCH", `/api/v1/rooms/${this.roomId}/announcements/${id}`, { content });
-    return {
-      id: raw.id,
-      roomId: raw.room_id,
-      content: raw.content,
-      createdBy: raw.created_by,
-      createdAt: raw.created_at,
-      updatedAt: raw.updated_at
-    };
+    const raw = await this.http.request(
+      "PATCH",
+      `/api/v1/rooms/${this.roomId}/announcements/${id}`,
+      { content }
+    );
+    return parseAnnouncementOut(raw);
   }
   async deleteAnnouncement(id) {
     await this.http.request(
@@ -1017,32 +1217,21 @@ var Room = class _Room {
     const body = {};
     if (opts && "expiresInHours" in opts) body.expires_in_hours = opts.expiresInHours;
     if (opts && "maxUses" in opts) body.max_uses = opts.maxUses;
-    const raw = await this.http.request("POST", `/api/v1/rooms/${this.roomId}/invites`, body);
-    return {
-      token: raw.token,
-      roomId: raw.room_id,
-      createdBy: raw.created_by,
-      createdAt: raw.created_at,
-      expiresAt: raw.expires_at,
-      maxUses: raw.max_uses,
-      usedCount: raw.used_count,
-      revokedAt: raw.revoked_at
-    };
+    const raw = await this.http.request(
+      "POST",
+      `/api/v1/rooms/${this.roomId}/invites`,
+      body
+    );
+    return parseInviteTokenOut(raw);
   }
   /** OPERATOR-only: list all invite tokens for this room (including
    *  revoked / expired / exhausted), newest first. */
   async listInvites() {
-    const raw = await this.http.request("GET", `/api/v1/rooms/${this.roomId}/invites`);
-    return raw.map((r) => ({
-      token: r.token,
-      roomId: r.room_id,
-      createdBy: r.created_by,
-      createdAt: r.created_at,
-      expiresAt: r.expires_at,
-      maxUses: r.max_uses,
-      usedCount: r.used_count,
-      revokedAt: r.revoked_at
-    }));
+    const raw = await this.http.request(
+      "GET",
+      `/api/v1/rooms/${this.roomId}/invites`
+    );
+    return raw.map((r) => parseInviteTokenOut(r));
   }
   /** OPERATOR-only: revoke a token immediately. Idempotent — revoking
    *  an already-revoked token returns 204 as well. */
@@ -1052,6 +1241,81 @@ var Room = class _Room {
       `/api/v1/rooms/${this.roomId}/invites/${encodeURIComponent(token)}`
     );
   }
+  // -------- join requests --------
+  /**
+   * Ask to join this room (self). Behavior depends on the room's
+   * `joinPolicy`:
+   *   - `OPEN` → the caller is added immediately (`status: "joined"`);
+   *   - `APPROVAL_REQUIRED` → the request lands in the operators' inbox
+   *     (`status: "pending"`) until [`approveJoinRequest`] / reject.
+   * Idempotent for members (`status: "already_member"`).
+   *
+   * @param reason Optional note shown to operators ("하은이 반 친구 엄마예요").
+   */
+  async requestJoin(reason) {
+    const raw = await this.http.request(
+      "POST",
+      `/api/v1/rooms/${this.roomId}/join-request`,
+      reason ? { reason } : {}
+    );
+    return parseJoinRequestCreateResponse(raw);
+  }
+  /** Cancel the caller's own pending join request. */
+  async cancelJoinRequest() {
+    await this.http.request(
+      "DELETE",
+      `/api/v1/rooms/${this.roomId}/join-request`
+    );
+  }
+  /** OPERATOR-only: list join requests for this room (the approval inbox).
+   *  Defaults to pending only — pass a status to see processed history. */
+  async listJoinRequests(opts) {
+    const raw = await this.http.request(
+      "GET",
+      `/api/v1/rooms/${this.roomId}/join-requests`,
+      void 0,
+      {
+        ...opts?.status ? { status: opts.status } : {},
+        ...opts?.limit !== void 0 ? { limit: opts.limit } : {},
+        ...opts?.offset !== void 0 ? { offset: opts.offset } : {}
+      }
+    );
+    return parseJoinRequestListResponse(raw);
+  }
+  /** OPERATOR-only: approve a pending join request — the requester becomes
+   *  a MEMBER. [reason] is echoed back to them in later list calls. */
+  async approveJoinRequest(userId, reason) {
+    await this.http.request(
+      "POST",
+      `/api/v1/rooms/${this.roomId}/join-requests/${encodeURIComponent(userId)}/approve`,
+      reason ? { reason } : {}
+    );
+  }
+  /** OPERATOR-only: reject a pending join request. */
+  async rejectJoinRequest(userId, reason) {
+    await this.http.request(
+      "POST",
+      `/api/v1/rooms/${this.roomId}/join-requests/${encodeURIComponent(userId)}/reject`,
+      reason ? { reason } : {}
+    );
+  }
+  // -------- hide / unhide --------
+  /** Hide this room from the caller's own room list (self, reversible —
+   *  the KakaoTalk "숨기기"). The room typically reappears via [unhide]
+   *  or on new activity, per server policy. Messages are untouched. */
+  async hide() {
+    await this.http.request(
+      "POST",
+      `/api/v1/rooms/${this.roomId}/hide`
+    );
+  }
+  /** Undo [hide] — the room shows up in the caller's list again. */
+  async unhide() {
+    await this.http.request(
+      "POST",
+      `/api/v1/rooms/${this.roomId}/unhide`
+    );
+  }
   // -------- internal dispatch --------
   on(event, fn) {
     return this.bus.on(event, fn);
@@ -1300,13 +1564,7 @@ var NoveraChat = class {
    *  destructive buttons to expose. */
   async appPolicy() {
     const raw = await this.http.request("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
-    };
+    return parseAppPolicy(raw);
   }
   // ---- device tokens (push) ----
   /**
@@ -1316,19 +1574,23 @@ var NoveraChat = class {
    * safe. Returns the stored device record (token shown only as a prefix).
    */
   async registerDevice(params) {
-    const raw = await this.http.request("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(
+      "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() {
     const raw = await this.http.request("GET", "/api/v1/users/me/devices");
-    return raw.items.map((d) => this._toDeviceInfo(d));
+    return parseDeviceListResponse(raw).items;
   }
   /**
    * Turn push delivery on/off for one device without unregistering it —
@@ -1366,7 +1628,7 @@ var NoveraChat = class {
       "GET",
       "/api/v1/users/me/push-preferences"
     );
-    return { pushEnabled: Boolean(raw.push_enabled) };
+    return parsePushPreferencesOut(raw);
   }
   /**
    * Flip the caller's global push kill switch. Pass `false` to mute
@@ -1379,7 +1641,7 @@ var NoveraChat = class {
       "/api/v1/users/me/push-preferences",
       { push_enabled: enabled }
     );
-    return { pushEnabled: Boolean(raw.push_enabled) };
+    return parsePushPreferencesOut(raw);
   }
   // -------------------------------------------------------------------------
   // User blocks — KakaoTalk-style one-way block.
@@ -1403,11 +1665,7 @@ var NoveraChat = class {
       `/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. */
   async unblockUser(userId) {
@@ -1419,23 +1677,7 @@ var NoveraChat = class {
   /** List every user the caller has blocked, newest first. */
   async listBlocks() {
     const raw = await this.http.request("GET", "/api/v1/users/me/blocks");
-    return raw.map((r) => ({
-      blockedUserId: r.blocked_user_id,
-      reason: r.reason,
-      createdAt: r.created_at
-    }));
-  }
-  _toDeviceInfo(raw) {
-    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
-    };
+    return raw.map((r) => parseBlockOut(r));
   }
   /**
    * Authorization-gated URL for downloading a file attachment.
@@ -1493,41 +1735,27 @@ var NoveraChat = class {
    * shipping date.
    */
   async getFileMeta(fileId) {
-    const raw = await this.http.request("GET", `/api/v1/files/${encodeURIComponent(fileId)}/meta`);
+    const raw = await this.http.request(
+      "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() {
     const raw = await this.http.request("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
-        }))
-      }))
-    };
+    return parseUnreadSummary(raw);
   }
   /**
    * Accept an invite link — call this in flows where you receive a
@@ -1545,12 +1773,11 @@ var NoveraChat = class {
    * kicked from the target room.
    */
   async acceptInvite(token) {
-    const raw = await this.http.request("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(
+      "POST",
+      `/api/v1/invites/${encodeURIComponent(token)}/accept`
+    );
+    return parseInviteAcceptResponse(raw);
   }
   // ---- internal ----
   dispatch(msg) {