@noverachat/sdk-web 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -206,6 +206,30 @@ function parseBulkDeleteBySenderResult(j) {
     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"],
@@ -1246,6 +1270,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);

package/dist/index.d.cts

@@ -320,6 +320,25 @@ interface RoomMemberOut {
     isOnline?: boolean | null;
     mutedUntil?: string | null;
 }
+interface JoinRequestOut {
+    userId: string;
+    status: "PENDING" | "APPROVED" | "REJECTED" | "CANCELLED";
+    reason: string | null;
+    requestedAt: string;
+    processedAt: string | null;
+    processedByUserId: string | null;
+}
+interface JoinRequestListResponse {
+    items: JoinRequestOut[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/** Synchronous response after `POST /join-request`.  `status="joined"`   — OPEN room, user was immediately added. `status="pending"`  — APPROVAL_REQUIRED, request is pending. `status="already_member"` — caller is already an active member; no-op. */
+interface JoinRequestCreateResponse {
+    status: "joined" | "pending" | "already_member";
+    roomId: string;
+}
 /** Minimal sender identity — no friend/block/profile-url fluff. */
 interface SenderMini {
     userId: string;
@@ -875,6 +894,37 @@ declare class Room {
     /** OPERATOR-only: revoke a token immediately. Idempotent — revoking
      *  an already-revoked token returns 204 as well. */
     revokeInvite(token: string): Promise<void>;
+    /**
+     * 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 ("하은이 반 친구 엄마예요").
+     */
+    requestJoin(reason?: string): Promise<JoinRequestCreateResponse>;
+    /** Cancel the caller's own pending join request. */
+    cancelJoinRequest(): Promise<void>;
+    /** OPERATOR-only: list join requests for this room (the approval inbox).
+     *  Defaults to pending only — pass a status to see processed history. */
+    listJoinRequests(opts?: {
+        status?: "PENDING" | "APPROVED" | "REJECTED" | "CANCELLED";
+        limit?: number;
+        offset?: number;
+    }): Promise<JoinRequestListResponse>;
+    /** OPERATOR-only: approve a pending join request — the requester becomes
+     *  a MEMBER. [reason] is echoed back to them in later list calls. */
+    approveJoinRequest(userId: string, reason?: string): Promise<void>;
+    /** OPERATOR-only: reject a pending join request. */
+    rejectJoinRequest(userId: string, reason?: string): Promise<void>;
+    /** 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. */
+    hide(): Promise<void>;
+    /** Undo [hide] — the room shows up in the caller's list again. */
+    unhide(): Promise<void>;
     on<K extends keyof RoomEvents>(event: K, fn: (p: RoomEvents[K]) => void): () => void;
     off<K extends keyof RoomEvents>(event: K, fn: (p: RoomEvents[K]) => void): void;
     _dispatchAnnouncement(msg: WsAnnouncementEvent): void;
@@ -1141,4 +1191,4 @@ declare class NoveraChatError extends Error {
     static fromResponse(status: number, body: unknown): NoveraChatError;
 }
 
-export { type InviteAcceptResponse as AcceptInviteResult, type AnnouncementOut as Announcement, type AppPolicy, type BlockOut as Block, type ClientOptions, type DeleteScope, ErrorCode, type ErrorCodeValue, type InviteTokenOut as InviteToken, type MessageOut, type MessageType, NoveraChat, NoveraChatError, type ReactionEntry, Room, type RoomEvents, type RoomMemberOut, type RoomUnread, type SendParams, type SenderMini, type UnreadRoomItem, type UnreadSummary, type WsAnnouncementEvent, type WsInbound, type WsOutbound };
+export { type InviteAcceptResponse as AcceptInviteResult, type AnnouncementOut as Announcement, type AppPolicy, type BlockOut as Block, type ClientOptions, type DeleteScope, ErrorCode, type ErrorCodeValue, type InviteTokenOut as InviteToken, type JoinRequestCreateResponse, type JoinRequestListResponse, type JoinRequestOut, type MessageOut, type MessageType, NoveraChat, NoveraChatError, type ReactionEntry, Room, type RoomEvents, type RoomMemberOut, type RoomUnread, type SendParams, type SenderMini, type UnreadRoomItem, type UnreadSummary, type WsAnnouncementEvent, type WsInbound, type WsOutbound };

package/dist/index.d.ts

@@ -320,6 +320,25 @@ interface RoomMemberOut {
     isOnline?: boolean | null;
     mutedUntil?: string | null;
 }
+interface JoinRequestOut {
+    userId: string;
+    status: "PENDING" | "APPROVED" | "REJECTED" | "CANCELLED";
+    reason: string | null;
+    requestedAt: string;
+    processedAt: string | null;
+    processedByUserId: string | null;
+}
+interface JoinRequestListResponse {
+    items: JoinRequestOut[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/** Synchronous response after `POST /join-request`.  `status="joined"`   — OPEN room, user was immediately added. `status="pending"`  — APPROVAL_REQUIRED, request is pending. `status="already_member"` — caller is already an active member; no-op. */
+interface JoinRequestCreateResponse {
+    status: "joined" | "pending" | "already_member";
+    roomId: string;
+}
 /** Minimal sender identity — no friend/block/profile-url fluff. */
 interface SenderMini {
     userId: string;
@@ -875,6 +894,37 @@ declare class Room {
     /** OPERATOR-only: revoke a token immediately. Idempotent — revoking
      *  an already-revoked token returns 204 as well. */
     revokeInvite(token: string): Promise<void>;
+    /**
+     * 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 ("하은이 반 친구 엄마예요").
+     */
+    requestJoin(reason?: string): Promise<JoinRequestCreateResponse>;
+    /** Cancel the caller's own pending join request. */
+    cancelJoinRequest(): Promise<void>;
+    /** OPERATOR-only: list join requests for this room (the approval inbox).
+     *  Defaults to pending only — pass a status to see processed history. */
+    listJoinRequests(opts?: {
+        status?: "PENDING" | "APPROVED" | "REJECTED" | "CANCELLED";
+        limit?: number;
+        offset?: number;
+    }): Promise<JoinRequestListResponse>;
+    /** OPERATOR-only: approve a pending join request — the requester becomes
+     *  a MEMBER. [reason] is echoed back to them in later list calls. */
+    approveJoinRequest(userId: string, reason?: string): Promise<void>;
+    /** OPERATOR-only: reject a pending join request. */
+    rejectJoinRequest(userId: string, reason?: string): Promise<void>;
+    /** 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. */
+    hide(): Promise<void>;
+    /** Undo [hide] — the room shows up in the caller's list again. */
+    unhide(): Promise<void>;
     on<K extends keyof RoomEvents>(event: K, fn: (p: RoomEvents[K]) => void): () => void;
     off<K extends keyof RoomEvents>(event: K, fn: (p: RoomEvents[K]) => void): void;
     _dispatchAnnouncement(msg: WsAnnouncementEvent): void;
@@ -1141,4 +1191,4 @@ declare class NoveraChatError extends Error {
     static fromResponse(status: number, body: unknown): NoveraChatError;
 }
 
-export { type InviteAcceptResponse as AcceptInviteResult, type AnnouncementOut as Announcement, type AppPolicy, type BlockOut as Block, type ClientOptions, type DeleteScope, ErrorCode, type ErrorCodeValue, type InviteTokenOut as InviteToken, type MessageOut, type MessageType, NoveraChat, NoveraChatError, type ReactionEntry, Room, type RoomEvents, type RoomMemberOut, type RoomUnread, type SendParams, type SenderMini, type UnreadRoomItem, type UnreadSummary, type WsAnnouncementEvent, type WsInbound, type WsOutbound };
+export { type InviteAcceptResponse as AcceptInviteResult, type AnnouncementOut as Announcement, type AppPolicy, type BlockOut as Block, type ClientOptions, type DeleteScope, ErrorCode, type ErrorCodeValue, type InviteTokenOut as InviteToken, type JoinRequestCreateResponse, type JoinRequestListResponse, type JoinRequestOut, type MessageOut, type MessageType, NoveraChat, NoveraChatError, type ReactionEntry, Room, type RoomEvents, type RoomMemberOut, type RoomUnread, type SendParams, type SenderMini, type UnreadRoomItem, type UnreadSummary, type WsAnnouncementEvent, type WsInbound, type WsOutbound };

package/dist/index.js

@@ -177,6 +177,30 @@ function parseBulkDeleteBySenderResult(j) {
     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"],
@@ -1217,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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noverachat/sdk-web",
-  "version": "0.1.0",
+  "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/features/room.ts

@@ -42,10 +42,16 @@ import {
   parseFileCreateResponse,
   parseFileOut,
   parseInviteTokenOut,
+  parseJoinRequestCreateResponse,
+  parseJoinRequestListResponse,
   parseMessageOut,
   parseRoomMemberOut,
   parseRoomUnread,
 } from "../generated/rest.js";
+import type {
+  JoinRequestCreateResponse,
+  JoinRequestListResponse,
+} from "../generated/rest.js";
 // Note: previously used `utils/debounce`, replaced with a hand-rolled
 // timer in Room so we can also expose `flushMarkRead()` — the util has
 // no flush primitive.
@@ -1010,6 +1016,87 @@ export class Room {
     );
   }
 
+  // -------- 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?: string): Promise<JoinRequestCreateResponse> {
+    const raw = await this.http.request<unknown>(
+      "POST", `/api/v1/rooms/${this.roomId}/join-request`,
+      reason ? { reason } : {},
+    );
+    return parseJoinRequestCreateResponse(raw);
+  }
+
+  /** Cancel the caller's own pending join request. */
+  async cancelJoinRequest(): Promise<void> {
+    await this.http.request<void>(
+      "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?: {
+    status?: "PENDING" | "APPROVED" | "REJECTED" | "CANCELLED";
+    limit?: number;
+    offset?: number;
+  }): Promise<JoinRequestListResponse> {
+    const raw = await this.http.request<unknown>(
+      "GET", `/api/v1/rooms/${this.roomId}/join-requests`, undefined, {
+        ...(opts?.status ? { status: opts.status } : {}),
+        ...(opts?.limit !== undefined ? { limit: opts.limit } : {}),
+        ...(opts?.offset !== undefined ? { 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: string, reason?: string): Promise<void> {
+    await this.http.request<void>(
+      "POST",
+      `/api/v1/rooms/${this.roomId}/join-requests/${encodeURIComponent(userId)}/approve`,
+      reason ? { reason } : {},
+    );
+  }
+
+  /** OPERATOR-only: reject a pending join request. */
+  async rejectJoinRequest(userId: string, reason?: string): Promise<void> {
+    await this.http.request<void>(
+      "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(): Promise<void> {
+    await this.http.request<void>(
+      "POST", `/api/v1/rooms/${this.roomId}/hide`,
+    );
+  }
+
+  /** Undo [hide] — the room shows up in the caller's list again. */
+  async unhide(): Promise<void> {
+    await this.http.request<void>(
+      "POST", `/api/v1/rooms/${this.roomId}/unhide`,
+    );
+  }
+
   // -------- internal dispatch --------
 
   on<K extends keyof RoomEvents>(event: K, fn: (p: RoomEvents[K]) => void): () => void {

package/src/generated/rest.ts

@@ -440,6 +440,55 @@ export function parseBulkDeleteBySenderResult(j: any): BulkDeleteBySenderResult
   } as BulkDeleteBySenderResult;
 }
 
+export interface JoinRequestOut {
+  userId: string;
+  status: "PENDING" | "APPROVED" | "REJECTED" | "CANCELLED";
+  reason: string | null;
+  requestedAt: string;
+  processedAt: string | null;
+  processedByUserId: string | null;
+}
+
+export function parseJoinRequestOut(j: any): JoinRequestOut {
+  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"],
+  } as JoinRequestOut;
+}
+
+export interface JoinRequestListResponse {
+  items: JoinRequestOut[];
+  total: number;
+  limit: number;
+  offset: number;
+}
+
+export function parseJoinRequestListResponse(j: any): JoinRequestListResponse {
+  return {
+    items: (j["items"] as unknown[]).map((e: any) => parseJoinRequestOut(e)),
+    total: j["total"],
+    limit: j["limit"],
+    offset: j["offset"],
+  } as JoinRequestListResponse;
+}
+
+/** Synchronous response after `POST /join-request`.  `status="joined"`   — OPEN room, user was immediately added. `status="pending"`  — APPROVAL_REQUIRED, request is pending. `status="already_member"` — caller is already an active member; no-op. */
+export interface JoinRequestCreateResponse {
+  status: "joined" | "pending" | "already_member";
+  roomId: string;
+}
+
+export function parseJoinRequestCreateResponse(j: any): JoinRequestCreateResponse {
+  return {
+    status: j["status"],
+    roomId: j["room_id"],
+  } as JoinRequestCreateResponse;
+}
+
 /** Minimal sender identity — no friend/block/profile-url fluff. */
 export interface SenderMini {
   userId: string;

package/src/index.ts

@@ -13,6 +13,9 @@ export type {
   ClientOptions,
   DeleteScope,
   InviteToken,
+  JoinRequestCreateResponse,
+  JoinRequestListResponse,
+  JoinRequestOut,
   MessageOut,
   MessageType,
   ReactionEntry,

package/src/types.ts

@@ -62,6 +62,9 @@ export type {
   RoomOut,
   DeviceListResponse,
   PushPreferencesOut,
+  JoinRequestOut,
+  JoinRequestListResponse,
+  JoinRequestCreateResponse,
 } from "./generated/rest.js";
 
 // 공개 이름 유지 — 이전 손 DTO 이름을 생성물 이름으로 alias (0.x, minor 브레이킹 허용).