@openmarket/rooms-client 0.8.0 → 0.10.0

package/dist/agent/library-model.d.ts

@@ -24,7 +24,9 @@ export declare class LibraryModel {
     refresh(): Promise<boolean>;
     private refreshSpace;
     private applyChanges;
-    /** Upsert after our own write so the UI reflects it without waiting a poll. */
+    /** Upsert after our own write so the UI reflects it without waiting a poll.
+     *  Every local write (archive included) advances the receipt: our write IS
+     *  the head we would otherwise refetch. */
     applyLocalWrite(doc: RoomDoc): void;
     docsFor(spaceId: string): RoomDoc[];
     recentFor(spaceId: string, limit?: number): RoomDoc[];
@@ -34,6 +36,17 @@ export declare class LibraryModel {
     freshCount(spaceId: string): number;
     isFresh(spaceId: string, docId: string): boolean;
     markSeen(spaceId: string): void;
+    /**
+     * Record a server poke (DOC_CHANGED) that the space's change head moved.
+     * Bookkeeping only: latestSeq ratchets up (never down) so atHead() reports
+     * stale until a refresh catches up. Returns whether a refresh would fetch
+     * anything: false for untracked spaces, true for a seqless poke (an
+     * unconditional "something changed"), otherwise whether the poked head is
+     * ahead of the cursor. Callers own debounce/refresh scheduling, and must
+     * re-check atHead() after a refresh completes: the refresh() single-flight
+     * guard drops a poke that lands mid-refresh.
+     */
+    noteRemoteHead(spaceId: string, latestSeq?: number): boolean;
     /** True when the cache has provably caught up to the space's change head. */
     atHead(spaceId: string): boolean;
     syncedOnce(spaceId: string): boolean;

package/dist/agent/library-model.js

@@ -95,21 +95,23 @@ export class LibraryModel {
         }
         return changed;
     }
-    /** Upsert after our own write so the UI reflects it without waiting a poll. */
+    /** Upsert after our own write so the UI reflects it without waiting a poll.
+     *  Every local write (archive included) advances the receipt: our write IS
+     *  the head we would otherwise refetch. */
     applyLocalWrite(doc) {
         const state = this.spaces.get(doc.spaceId);
         if (!state)
             return;
+        if (doc.spaceDocSeq > state.cursor) {
+            state.cursor = doc.spaceDocSeq;
+            state.latestSeq = Math.max(state.latestSeq, doc.spaceDocSeq);
+        }
         if (doc.status === "archived") {
             state.docs.delete(doc.docId);
             state.freshDocIds.delete(doc.docId);
             return;
         }
         state.docs.set(doc.docId, doc);
-        if (doc.spaceDocSeq > state.cursor) {
-            state.cursor = doc.spaceDocSeq;
-            state.latestSeq = Math.max(state.latestSeq, doc.spaceDocSeq);
-        }
     }
     docsFor(spaceId) {
         const state = this.spaces.get(spaceId);
@@ -157,6 +159,25 @@ export class LibraryModel {
     markSeen(spaceId) {
         this.spaces.get(spaceId)?.freshDocIds.clear();
     }
+    /**
+     * Record a server poke (DOC_CHANGED) that the space's change head moved.
+     * Bookkeeping only: latestSeq ratchets up (never down) so atHead() reports
+     * stale until a refresh catches up. Returns whether a refresh would fetch
+     * anything: false for untracked spaces, true for a seqless poke (an
+     * unconditional "something changed"), otherwise whether the poked head is
+     * ahead of the cursor. Callers own debounce/refresh scheduling, and must
+     * re-check atHead() after a refresh completes: the refresh() single-flight
+     * guard drops a poke that lands mid-refresh.
+     */
+    noteRemoteHead(spaceId, latestSeq) {
+        const state = this.spaces.get(spaceId);
+        if (!state)
+            return false;
+        if (latestSeq === undefined)
+            return true;
+        state.latestSeq = Math.max(state.latestSeq, latestSeq);
+        return latestSeq > state.cursor;
+    }
     /** True when the cache has provably caught up to the space's change head. */
     atHead(spaceId) {
         const state = this.spaces.get(spaceId);

package/dist/shared/rooms-protocol.d.ts

@@ -104,6 +104,8 @@ export declare const RoomServerMessageType: {
     readonly TOPIC: "TOPIC";
     readonly TOPICS: "TOPICS";
     readonly TOPIC_UPDATED: "TOPIC_UPDATED";
+    readonly DOC_CHANGED: "DOC_CHANGED";
+    readonly FRIEND_UPDATED: "FRIEND_UPDATED";
 };
 export declare function addBounded<T>(set: Set<T>, value: T, max: number): void;
 export type RoomServerMessageType = (typeof RoomServerMessageType)[keyof typeof RoomServerMessageType];
@@ -834,6 +836,12 @@ export interface RoomSpace {
     createdAt: string | number | Date;
     joined?: boolean | undefined;
     iconUrl?: string | null | undefined;
+    /** Archived channels in this server (sidebar Archive row; absent on
+     *  stores that predate the count). */
+    archivedRoomCount?: number | undefined;
+    /** Archived docs twin: keeps the Archive row reachable when only docs
+     *  are archived. */
+    archivedDocCount?: number | undefined;
 }
 export interface RoomSpacesPayload {
     requestId?: string;
@@ -874,6 +882,9 @@ export interface RoomUpdatedPayload {
     room: string;
     meta?: RoomMeta | undefined;
     archived?: boolean | undefined;
+    /** Rides WITH archived on hard deletion: old clients evict on archived,
+     *  new clients word the eviction honestly. */
+    deleted?: boolean | undefined;
 }
 /** Server settings changed (rename / icon / archive). */
 export interface SpaceUpdatedPayload {
@@ -881,6 +892,8 @@ export interface SpaceUpdatedPayload {
     name?: string | undefined;
     iconUrl?: string | null | undefined;
     archived?: boolean | undefined;
+    /** Rides WITH archived on hard deletion (see RoomUpdatedPayload). */
+    deleted?: boolean | undefined;
 }
 export interface RoomSpaceJoinedPayload {
     requestId?: string;
@@ -975,6 +988,19 @@ export interface RoomTopicUpdatedPayload {
     room: string;
     topic: RoomTopic;
 }
+/** Poke: a space's doc-library change head moved (create/edit/archive/restore).
+ *  Deliberately content-free: clients refetch deltas over REST. */
+export interface RoomDocChangedPayload {
+    spaceId: string;
+    /** The space's change head after the mutation, when the server knows it
+     *  cheaply; absent still means "something changed, refetch". */
+    latestSeq?: number | undefined;
+}
+/** Poke: the recipient's friendship graph changed. Clients refetch over REST. */
+export interface RoomFriendUpdatedPayload {
+    kind: "request" | "accepted" | "rejected" | "removed";
+    friendshipId?: string | undefined;
+}
 export type RoomClientMessage = {
     type: typeof RoomClientMessageType.AUTHENTICATE;
     payload: {
@@ -1504,6 +1530,14 @@ export type RoomServerMessage = {
     type: typeof RoomServerMessageType.TOPIC_UPDATED;
     payload: RoomTopicUpdatedPayload;
     timestamp: number;
+} | {
+    type: typeof RoomServerMessageType.DOC_CHANGED;
+    payload: RoomDocChangedPayload;
+    timestamp: number;
+} | {
+    type: typeof RoomServerMessageType.FRIEND_UPDATED;
+    payload: RoomFriendUpdatedPayload;
+    timestamp: number;
 };
 export type RoomServerMessageOf<T extends RoomServerMessageType> = Extract<RoomServerMessage, {
     type: T;

package/dist/shared/rooms-protocol.js

@@ -103,6 +103,8 @@ export const RoomServerMessageType = {
     TOPIC: "TOPIC",
     TOPICS: "TOPICS",
     TOPIC_UPDATED: "TOPIC_UPDATED",
+    DOC_CHANGED: "DOC_CHANGED",
+    FRIEND_UPDATED: "FRIEND_UPDATED",
 };
 export function addBounded(set, value, max) {
     set.add(value);

package/dist/social-client.d.ts

@@ -171,6 +171,13 @@ export interface RoomSpaceSummary {
     iconUrl?: string | null;
     /** Creation time — the stable server-rail sort key. */
     createdAt?: string | number | null;
+    /** Archived channels in this server; with archivedDocCount it drives
+     *  the sidebar's Archive row (rendered only when the sum > 0). Absent
+     *  on stores that predate the counts. */
+    archivedRoomCount?: number | undefined;
+    /** Archived docs in this server: the row must stay reachable when only
+     *  docs are archived, since they have no other retrieval surface. */
+    archivedDocCount?: number | undefined;
 }
 export declare function listRoomSpacesViaChat(config: RoomSocialConfig): Promise<RoomSpaceSummary[]>;
 export interface RoomSpaceMember {
@@ -355,6 +362,33 @@ export declare function updateRoomSpace(config: RoomSocialConfig, spaceId: strin
 export declare function archiveRoomSpace(config: RoomSocialConfig, spaceId: string): Promise<{
     archived?: boolean;
 }>;
+/** Un-archive a channel back onto the active sidebar (manage-room). The
+ *  wire verb is /restore, the store-wide grammar shared with docs; the
+ *  receipt carries `restored`, not the archive shape's `archived`. */
+export declare function unarchiveRoomChannel(config: RoomSocialConfig, room: string): Promise<{
+    roomId?: string;
+    restored?: boolean;
+}>;
+/** PERMANENTLY delete a channel and every row keyed to it (manage-room).
+ *  The bare DELETE verb on /rooms/:id is the legacy ARCHIVE shape; purge is
+ *  the explicit destruction verb and there is no undo. */
+export declare function purgeRoomChannel(config: RoomSocialConfig, room: string): Promise<{
+    roomId?: string;
+    deleted?: boolean;
+}>;
+/** PERMANENTLY delete a server: every channel, message, member, role,
+ *  invite, and the entire docs family (owner only; no undo). */
+export declare function purgeRoomSpace(config: RoomSocialConfig, spaceId: string): Promise<{
+    spaceId?: string;
+    deleted?: boolean;
+}>;
+/** A server's archived channels, for the Archive panel. */
+export declare function listArchivedRoomChannels(config: RoomSocialConfig, spaceId: string): Promise<Array<{
+    roomId: string;
+    name?: string;
+    title?: string;
+    archivedAt?: string;
+}>>;
 /** Full channel roster (paged): role + lastSeen for every membership row. */
 export declare function listRoomChannelMembers(config: RoomSocialConfig, roomId: string, options?: {
     offset?: number;

package/dist/social-client.js

@@ -567,6 +567,34 @@ export async function updateRoomSpace(config, spaceId, input) {
 export async function archiveRoomSpace(config, spaceId) {
     return socialRequest(config, `/spaces/${encodeURIComponent(spaceId)}`, { method: "DELETE" });
 }
+/** Un-archive a channel back onto the active sidebar (manage-room). The
+ *  wire verb is /restore, the store-wide grammar shared with docs; the
+ *  receipt carries `restored`, not the archive shape's `archived`. */
+export async function unarchiveRoomChannel(config, room) {
+    return socialRequest(config, `/rooms/${encodeURIComponent(cleanRoomId(room))}/restore`, {
+        method: "POST",
+    });
+}
+/** PERMANENTLY delete a channel and every row keyed to it (manage-room).
+ *  The bare DELETE verb on /rooms/:id is the legacy ARCHIVE shape; purge is
+ *  the explicit destruction verb and there is no undo. */
+export async function purgeRoomChannel(config, room) {
+    return socialRequest(config, `/rooms/${encodeURIComponent(cleanRoomId(room))}/purge`, {
+        method: "POST",
+    });
+}
+/** PERMANENTLY delete a server: every channel, message, member, role,
+ *  invite, and the entire docs family (owner only; no undo). */
+export async function purgeRoomSpace(config, spaceId) {
+    return socialRequest(config, `/spaces/${encodeURIComponent(spaceId)}/purge`, {
+        method: "POST",
+    });
+}
+/** A server's archived channels, for the Archive panel. */
+export async function listArchivedRoomChannels(config, spaceId) {
+    const result = await socialRequest(config, `/spaces/${encodeURIComponent(spaceId)}/rooms/archived`, { method: "GET" });
+    return result.rooms ?? [];
+}
 /** Full channel roster (paged): role + lastSeen for every membership row. */
 export async function listRoomChannelMembers(config, roomId, options = {}) {
     const params = new URLSearchParams();

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.7.0";
-export declare const RUNNER_VERSION = "0.7.0";
+export declare const VERSION = "0.9.1";
+export declare const RUNNER_VERSION = "0.9.1";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "0.7.0";
-export const RUNNER_VERSION = "0.7.0";
+export const VERSION = "0.9.1";
+export const RUNNER_VERSION = "0.9.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmarket/rooms-client",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "OM Rooms protocol client: wire types, WebSocket + REST clients, and chat view-models. Browser-safe (no node:/bun: imports).",
   "type": "module",
   "license": "Apache-2.0",

package/src/agent/library-model.ts

@@ -129,20 +129,22 @@ export class LibraryModel {
     return changed;
   }
 
-  /** Upsert after our own write so the UI reflects it without waiting a poll. */
+  /** Upsert after our own write so the UI reflects it without waiting a poll.
+   *  Every local write (archive included) advances the receipt: our write IS
+   *  the head we would otherwise refetch. */
   applyLocalWrite(doc: RoomDoc): void {
     const state = this.spaces.get(doc.spaceId);
     if (!state) return;
+    if (doc.spaceDocSeq > state.cursor) {
+      state.cursor = doc.spaceDocSeq;
+      state.latestSeq = Math.max(state.latestSeq, doc.spaceDocSeq);
+    }
     if (doc.status === "archived") {
       state.docs.delete(doc.docId);
       state.freshDocIds.delete(doc.docId);
       return;
     }
     state.docs.set(doc.docId, doc);
-    if (doc.spaceDocSeq > state.cursor) {
-      state.cursor = doc.spaceDocSeq;
-      state.latestSeq = Math.max(state.latestSeq, doc.spaceDocSeq);
-    }
   }
 
   docsFor(spaceId: string): RoomDoc[] {
@@ -193,6 +195,24 @@ export class LibraryModel {
     this.spaces.get(spaceId)?.freshDocIds.clear();
   }
 
+  /**
+   * Record a server poke (DOC_CHANGED) that the space's change head moved.
+   * Bookkeeping only: latestSeq ratchets up (never down) so atHead() reports
+   * stale until a refresh catches up. Returns whether a refresh would fetch
+   * anything: false for untracked spaces, true for a seqless poke (an
+   * unconditional "something changed"), otherwise whether the poked head is
+   * ahead of the cursor. Callers own debounce/refresh scheduling, and must
+   * re-check atHead() after a refresh completes: the refresh() single-flight
+   * guard drops a poke that lands mid-refresh.
+   */
+  noteRemoteHead(spaceId: string, latestSeq?: number): boolean {
+    const state = this.spaces.get(spaceId);
+    if (!state) return false;
+    if (latestSeq === undefined) return true;
+    state.latestSeq = Math.max(state.latestSeq, latestSeq);
+    return latestSeq > state.cursor;
+  }
+
   /** True when the cache has provably caught up to the space's change head. */
   atHead(spaceId: string): boolean {
     const state = this.spaces.get(spaceId);

package/src/shared/rooms-protocol.ts

@@ -107,6 +107,8 @@ export const RoomServerMessageType = {
   TOPIC: "TOPIC",
   TOPICS: "TOPICS",
   TOPIC_UPDATED: "TOPIC_UPDATED",
+  DOC_CHANGED: "DOC_CHANGED",
+  FRIEND_UPDATED: "FRIEND_UPDATED",
 } as const;
 
 export function addBounded<T>(set: Set<T>, value: T, max: number): void {
@@ -959,6 +961,12 @@ export interface RoomSpace {
   createdAt: string | number | Date;
   joined?: boolean | undefined;
   iconUrl?: string | null | undefined;
+  /** Archived channels in this server (sidebar Archive row; absent on
+   *  stores that predate the count). */
+  archivedRoomCount?: number | undefined;
+  /** Archived docs twin: keeps the Archive row reachable when only docs
+   *  are archived. */
+  archivedDocCount?: number | undefined;
 }
 
 export interface RoomSpacesPayload {
@@ -1002,6 +1010,9 @@ export interface RoomUpdatedPayload {
   room: string;
   meta?: RoomMeta | undefined;
   archived?: boolean | undefined;
+  /** Rides WITH archived on hard deletion: old clients evict on archived,
+   *  new clients word the eviction honestly. */
+  deleted?: boolean | undefined;
 }
 
 /** Server settings changed (rename / icon / archive). */
@@ -1010,6 +1021,8 @@ export interface SpaceUpdatedPayload {
   name?: string | undefined;
   iconUrl?: string | null | undefined;
   archived?: boolean | undefined;
+  /** Rides WITH archived on hard deletion (see RoomUpdatedPayload). */
+  deleted?: boolean | undefined;
 }
 
 export interface RoomSpaceJoinedPayload {
@@ -1118,6 +1131,21 @@ export interface RoomTopicUpdatedPayload {
   topic: RoomTopic;
 }
 
+/** Poke: a space's doc-library change head moved (create/edit/archive/restore).
+ *  Deliberately content-free: clients refetch deltas over REST. */
+export interface RoomDocChangedPayload {
+  spaceId: string;
+  /** The space's change head after the mutation, when the server knows it
+   *  cheaply; absent still means "something changed, refetch". */
+  latestSeq?: number | undefined;
+}
+
+/** Poke: the recipient's friendship graph changed. Clients refetch over REST. */
+export interface RoomFriendUpdatedPayload {
+  kind: "request" | "accepted" | "rejected" | "removed";
+  friendshipId?: string | undefined;
+}
+
 export type RoomClientMessage =
   | {
       type: typeof RoomClientMessageType.AUTHENTICATE;
@@ -1696,6 +1724,16 @@ export type RoomServerMessage =
       type: typeof RoomServerMessageType.TOPIC_UPDATED;
       payload: RoomTopicUpdatedPayload;
       timestamp: number;
+    }
+  | {
+      type: typeof RoomServerMessageType.DOC_CHANGED;
+      payload: RoomDocChangedPayload;
+      timestamp: number;
+    }
+  | {
+      type: typeof RoomServerMessageType.FRIEND_UPDATED;
+      payload: RoomFriendUpdatedPayload;
+      timestamp: number;
     };
 
 export type RoomServerMessageOf<T extends RoomServerMessageType> = Extract<

package/src/social-client.ts

@@ -671,6 +671,13 @@ export interface RoomSpaceSummary {
   iconUrl?: string | null;
   /** Creation time — the stable server-rail sort key. */
   createdAt?: string | number | null;
+  /** Archived channels in this server; with archivedDocCount it drives
+   *  the sidebar's Archive row (rendered only when the sum > 0). Absent
+   *  on stores that predate the counts. */
+  archivedRoomCount?: number | undefined;
+  /** Archived docs in this server: the row must stay reachable when only
+   *  docs are archived, since they have no other retrieval surface. */
+  archivedDocCount?: number | undefined;
 }
 
 export async function listRoomSpacesViaChat(config: RoomSocialConfig): Promise<RoomSpaceSummary[]> {
@@ -1179,6 +1186,52 @@ export async function archiveRoomSpace(
   return socialRequest(config, `/spaces/${encodeURIComponent(spaceId)}`, { method: "DELETE" });
 }
 
+/** Un-archive a channel back onto the active sidebar (manage-room). The
+ *  wire verb is /restore, the store-wide grammar shared with docs; the
+ *  receipt carries `restored`, not the archive shape's `archived`. */
+export async function unarchiveRoomChannel(
+  config: RoomSocialConfig,
+  room: string,
+): Promise<{ roomId?: string; restored?: boolean }> {
+  return socialRequest(config, `/rooms/${encodeURIComponent(cleanRoomId(room))}/restore`, {
+    method: "POST",
+  });
+}
+
+/** PERMANENTLY delete a channel and every row keyed to it (manage-room).
+ *  The bare DELETE verb on /rooms/:id is the legacy ARCHIVE shape; purge is
+ *  the explicit destruction verb and there is no undo. */
+export async function purgeRoomChannel(
+  config: RoomSocialConfig,
+  room: string,
+): Promise<{ roomId?: string; deleted?: boolean }> {
+  return socialRequest(config, `/rooms/${encodeURIComponent(cleanRoomId(room))}/purge`, {
+    method: "POST",
+  });
+}
+
+/** PERMANENTLY delete a server: every channel, message, member, role,
+ *  invite, and the entire docs family (owner only; no undo). */
+export async function purgeRoomSpace(
+  config: RoomSocialConfig,
+  spaceId: string,
+): Promise<{ spaceId?: string; deleted?: boolean }> {
+  return socialRequest(config, `/spaces/${encodeURIComponent(spaceId)}/purge`, {
+    method: "POST",
+  });
+}
+
+/** A server's archived channels, for the Archive panel. */
+export async function listArchivedRoomChannels(
+  config: RoomSocialConfig,
+  spaceId: string,
+): Promise<Array<{ roomId: string; name?: string; title?: string; archivedAt?: string }>> {
+  const result = await socialRequest<{
+    rooms?: Array<{ roomId: string; name?: string; title?: string; archivedAt?: string }>;
+  }>(config, `/spaces/${encodeURIComponent(spaceId)}/rooms/archived`, { method: "GET" });
+  return result.rooms ?? [];
+}
+
 /** Full channel roster (paged): role + lastSeen for every membership row. */
 export async function listRoomChannelMembers(
   config: RoomSocialConfig,

package/src/version.ts

@@ -1,2 +1,2 @@
-export const VERSION = "0.7.0";
-export const RUNNER_VERSION = "0.7.0";
+export const VERSION = "0.9.1";
+export const RUNNER_VERSION = "0.9.1";