@fkn/lib 0.9.28 → 0.9.30

package/{contract-BzdjfQge.d.ts → contract-CSdeTq_Y.d.ts}

@@ -181,14 +181,17 @@ type MountDescriptor = {
 };
 type RoomPermission = 'send' | 'receive' | 'remove' | 'block';
 type RoomPermissions = Readonly<Record<RoomPermission, boolean>>;
+/** What a member gets unless an override says otherwise. `maxMessageBytes` is measured on the wire: nonce plus ciphertext, base64url. */
 type RoomDefaults = Readonly<{
   send: boolean;
   receive: boolean;
+  maxMessageBytes: number;
 }>;
 /** A participant as this room sees them. The id is fresh in every room. */
 type RoomMember = {
   id: string;
   permissions: RoomPermissions;
+  maxMessageBytes: number;
 };
 type RoomMessage = {
   seq: number;
@@ -196,9 +199,26 @@ type RoomMessage = {
   at: number;
   text: string;
 };
-type RoomEvent = {
+/** What a claimed room's mailbox holds, as the room last said. Null for a room nobody has claimed. */
+type RoomMailbox = {
+  messages: number;
+  bytes: number;
+  cap: number;
+  archived: boolean;
+};
+type RoomEvent =
+/** `replayed` when the message predates this connection: a backlog page, never a live send */
+{
   type: 'message';
   message: RoomMessage;
+  replayed: boolean;
+} | {
+  type: 'edited';
+  message: RoomMessage;
+} | {
+  type: 'deleted';
+  from: number;
+  to: number;
 } | {
   type: 'joined';
   member: RoomMember;
@@ -210,11 +230,18 @@ type RoomEvent = {
   type: 'permissions';
   id: string;
   permissions: RoomPermissions;
+  maxMessageBytes: number;
 } | {
   type: 'defaults';
   defaults: RoomDefaults;
+} |
+/** the room was claimed, released or dissolved; `owner` is the owner's member id, or '' while a claimed room's owner has never joined */
+{
+  type: 'claim';
+  claimed: boolean;
+  owner: string;
 };
-type RoomsErrorCode = 'invalid' | 'not-found' | 'bad-key' | 'full' | 'blocked' | 'denied' | 'rate-limited' | 'too-large' | 'unavailable' | 'closed';
+type RoomsErrorCode = 'invalid' | 'not-found' | 'bad-key' | 'full' | 'blocked' | 'denied' | 'rate-limited' | 'too-large' | 'storage' | 'quota' | 'unavailable' | 'closed';
 /** A refusal, as data. `packages` crosses the hop the same way, and for the same reason. */
 type RoomsFail = {
   error: RoomsErrorCode;
@@ -224,15 +251,24 @@ type RoomsFail = {
 type RoomEnd = {
   reason: 'left' | 'removed' | 'blocked' | 'ended' | 'unavailable';
 };
-type RoomCreateOptions = {
+type RoomOpenOptions = {
   /** aborting it leaves the room; it never bounds the wait for the broker */
   signal?: AbortSignal;
+  /** honoured only by the join that brings the room into being */
   members?: number;
   defaults?: Partial<RoomDefaults>;
+  /** the room key, 32 bytes base64url, minted when absent. Deriving one from something people already share is how a name becomes a rendezvous. */
+  key?: string;
 };
+type RoomCreateOptions = RoomOpenOptions;
 type RoomJoinOptions = {
   signal?: AbortSignal;
 };
+/** What a backlog page answered: the highest seq it sent, and whether another page follows. */
+type RoomBacklog = {
+  last: number;
+  more: boolean;
+};
 /**
  * A joined room, held by the broker: it owns the socket, the room key and the derived message key,
  * and hands the app plaintext and member ids only.
@@ -241,23 +277,40 @@ type RoomJoinOptions = {
  * survives the osra hop as data. `leave` and `on` cannot be refused.
  */
 type RoomHandle = {
-  /** the room's uuid */
+  /** `<scope>/<name>`: the name under the app's own scope, or under `global` */
   id: string;
-  /** the room key, base64url. The api never sees it. Anyone holding it and the id can join. */
+  name: string;
+  /** the room key, base64url. The server never sees it. Anyone holding it and the id can join. */
   key: string;
-  /** `id` and `key` as one string, the thing to put in a link */
+  /** `<key>.<id>` as one string, the thing to put in a link */
   invite: string;
   self: RoomMember;
   owner: string;
+  claimed: boolean;
+  mailbox: RoomMailbox | null;
   defaults: () => Promise<RoomDefaults>;
   members: () => Promise<RoomMember[]>;
-  /** at most 4,096 bytes of UTF-8, sealed before it leaves the browser; never truncated */
+  /** sealed before it leaves the browser and refused, never truncated, past this member's `maxMessageBytes` on the wire */
   send: (text: string) => Promise<RoomsFail | {
     ok: true;
   }>;
+  /** a stored message's text, replaced: the sender's own, or any as the owner */
+  edit: (seq: number, text: string) => Promise<RoomsFail | {
+    ok: true;
+  }>;
+  /** stored messages dropped: one of the sender's own, or any range as the owner */
+  delete: (from: number, to?: number) => Promise<RoomsFail | {
+    ok: true;
+  }>;
+  /** replays stored messages above `after` as `message` events marked `replayed`, one page at a time */
+  backlog: (after: number, limit?: number) => Promise<RoomsFail | RoomBacklog>;
   setDefault: (permission: 'send' | 'receive', value: boolean) => Promise<RoomsFail | {
     ok: true;
   }>;
+  /** the message size cap: the room default when no member is named, that member's override otherwise, cleared by null */
+  limit: (maxMessageBytes: number | null, id?: string) => Promise<RoomsFail | {
+    ok: true;
+  }>;
   grant: (id: string, permission: RoomPermission) => Promise<RoomsFail | {
     ok: true;
   }>;
@@ -273,6 +326,14 @@ type RoomHandle = {
   unblock: (id: string) => Promise<RoomsFail | {
     ok: true;
   }>;
+  /** keeps the name and a mailbox for the signed-in premium account; the only thing in rooms that premium buys */
+  claim: () => Promise<RoomsFail | {
+    ok: true;
+  }>;
+  release: () => Promise<RoomsFail | {
+    ok: true;
+  }>;
+  usage: () => Promise<RoomsFail | RoomMailbox | null>;
   /** the `account.onChange` shape: one broker-side registration, unsubscribed by the returned function */
   on: (listener: (event: RoomEvent) => void) => (() => void);
   leave: () => Promise<void>;
@@ -309,8 +370,25 @@ type DnsLookup = <T extends boolean = false>(hostname: string, options?: {
   family?: 0 | 4 | 6;
 }) => Promise<T extends true ? AddressLookupResult[] : AddressLookupResult | undefined>;
 type ProxyFetchInput = string | URL | Request;
+/**
+ * What a cloud.fetch accepts beyond the platform's own RequestInit.
+ *
+ * `spread` sends THIS request through any healthy node, taken in turn, instead of the node the
+ * WebVPN session is on. The default keeps every request on that one node: it is the node the header
+ * names, and it is what an upstream that remembers a source address expects. Spreading is for an
+ * upstream that meters per address, where it multiplies the budget by the number of healthy nodes.
+ * AniList is the measured case: its live bucket answers `x-ratelimit-limit: 30` a minute per
+ * address, shared by every user behind one node.
+ *
+ * A spread request is the app's own choice and is not announced: the header keeps naming the
+ * session's node, which every request not carrying this flag still goes through. Only the cloud
+ * backend reads it; the extension and the desktop fetch from the user's own address and ignore it.
+ *
+ * `render` used to sit here. It set a request header the proxy never read and never listed for CORS,
+ * so a caller that passed it failed its own preflight; nothing did, and it is gone.
+ */
 type ProxyFetchInit = (RequestInit & {
-  render?: boolean;
+  spread?: boolean;
 }) | undefined;
 type ProxyFetch = (input: ProxyFetchInput, init: ProxyFetchInit) => Promise<Response>;
 type TcpSocketOptions = {
@@ -483,6 +561,9 @@ type Resolvers = {
   };
   rooms: {
     available: () => Promise<boolean>;
+    /** a name under the calling app's scope, or `global/<name>`; the room comes into being when nothing is there */
+    open: (name: string, options?: RoomOpenOptions) => Promise<RoomsFail | RoomHandle>;
+    /** `open` under a random name */
     create: (options?: RoomCreateOptions) => Promise<RoomsFail | RoomHandle>;
     join: (invite: string, options?: RoomJoinOptions) => Promise<RoomsFail | RoomHandle>;
   };
@@ -508,4 +589,4 @@ type Resolvers = {
   hideInstallPrompt: () => void;
 };
 //#endregion
-export { TcpSocketOptions as $, ProxyFetchInit as A, RoomJoinOptions as B, PackageQuery as C, PickOptions as D, PackagesFail as E, RoomCreateOptions as F, RoomsErrorCode as G, RoomMessage as H, RoomDefaults as I, StorageEntry as J, RoomsFail as K, RoomEnd as L, Quota as M, Radii as N, Placement as O, Resolvers as P, TcpSocketListenerResult as Q, RoomEvent as R, OverlayState as S, PackagesErrorCode as T, RoomPermission as U, RoomMember as V, RoomPermissions as W, SurfaceRect as X, StorageQuota as Y, TcpSocketListenerOptions as Z, InstallOptions as _, ConflictChoice as a, MountDescriptor as b, ConnectAvailability as c, DisplayLevel as d, TcpSocketResult as et, DnsLookup as f, HiddenSurface as g, FrameFetchScope as h, AdoptState as i, WriteData as it, ProxyFetchInput as j, ProxyFetch as k, ConnectOptions as l, FrameConsentRequest as m, AddressLookupResult as n, UdpSocketOptions as nt, ConflictRequest as o, EncryptionState as p, SetOverlayHost as q, AdoptRequest as r, UdpSocketResult as rt, ConflictSide as s, Account as t, UdpDatagram as tt, DisplayCause as u, InstalledPackage as v, PackageResult as w, OverlayRect as x, IpFamily as y, RoomHandle as z };
+export { SurfaceRect as $, ProxyFetchInit as A, RoomHandle as B, PackageQuery as C, PickOptions as D, PackagesFail as E, RoomBacklog as F, RoomOpenOptions as G, RoomMailbox as H, RoomCreateOptions as I, RoomsErrorCode as J, RoomPermission as K, RoomDefaults as L, Quota as M, Radii as N, Placement as O, Resolvers as P, StorageQuota as Q, RoomEnd as R, OverlayState as S, PackagesErrorCode as T, RoomMember as U, RoomJoinOptions as V, RoomMessage as W, SetOverlayHost as X, RoomsFail as Y, StorageEntry as Z, InstallOptions as _, ConflictChoice as a, UdpSocketOptions as at, MountDescriptor as b, ConnectAvailability as c, DisplayLevel as d, TcpSocketListenerOptions as et, DnsLookup as f, HiddenSurface as g, FrameFetchScope as h, AdoptState as i, UdpDatagram as it, ProxyFetchInput as j, ProxyFetch as k, ConnectOptions as l, FrameConsentRequest as m, AddressLookupResult as n, TcpSocketOptions as nt, ConflictRequest as o, UdpSocketResult as ot, EncryptionState as p, RoomPermissions as q, AdoptRequest as r, TcpSocketResult as rt, ConflictSide as s, WriteData as st, Account as t, TcpSocketListenerResult as tt, DisplayCause as u, InstalledPackage as v, PackageResult as w, OverlayRect as x, IpFamily as y, RoomEvent as z };

package/contract.d.ts

@@ -1,3 +1,3 @@
 import { o as TcpSocketOption, v as UdpSocketOption } from "./wire-Gbo-D74t.js";
-import { $ as TcpSocketOptions, A as ProxyFetchInit, B as RoomJoinOptions, C as PackageQuery, D as PickOptions, E as PackagesFail, F as RoomCreateOptions, G as RoomsErrorCode, H as RoomMessage, I as RoomDefaults, J as StorageEntry, K as RoomsFail, L as RoomEnd, M as Quota, N as Radii, O as Placement, P as Resolvers, Q as TcpSocketListenerResult, R as RoomEvent, S as OverlayState, T as PackagesErrorCode, U as RoomPermission, V as RoomMember, W as RoomPermissions, X as SurfaceRect, Y as StorageQuota, Z as TcpSocketListenerOptions, _ as InstallOptions, a as ConflictChoice, b as MountDescriptor, c as ConnectAvailability, d as DisplayLevel, et as TcpSocketResult, f as DnsLookup, g as HiddenSurface, h as FrameFetchScope, i as AdoptState, it as WriteData, j as ProxyFetchInput, k as ProxyFetch, l as ConnectOptions, m as FrameConsentRequest, n as AddressLookupResult, nt as UdpSocketOptions, o as ConflictRequest, p as EncryptionState, q as SetOverlayHost, r as AdoptRequest, rt as UdpSocketResult, s as ConflictSide, t as Account, tt as UdpDatagram, u as DisplayCause, v as InstalledPackage, w as PackageResult, x as OverlayRect, y as IpFamily, z as RoomHandle } from "./contract-BzdjfQge.js";
-export { Account, AddressLookupResult, AdoptRequest, AdoptState, ConflictChoice, ConflictRequest, ConflictSide, ConnectAvailability, ConnectOptions, DisplayCause, DisplayLevel, DnsLookup, EncryptionState, FrameConsentRequest, FrameFetchScope, HiddenSurface, InstallOptions, InstalledPackage, IpFamily, MountDescriptor, OverlayRect, OverlayState, PackageQuery, PackageResult, PackagesErrorCode, PackagesFail, PickOptions, Placement, ProxyFetch, ProxyFetchInit, ProxyFetchInput, Quota, Radii, Resolvers, RoomCreateOptions, RoomDefaults, RoomEnd, RoomEvent, RoomHandle, RoomJoinOptions, RoomMember, RoomMessage, RoomPermission, RoomPermissions, RoomsErrorCode, RoomsFail, SetOverlayHost, StorageEntry, StorageQuota, SurfaceRect, TcpSocketListenerOptions, TcpSocketListenerResult, type TcpSocketOption, TcpSocketOptions, TcpSocketResult, UdpDatagram, type UdpSocketOption, UdpSocketOptions, UdpSocketResult, WriteData };
+import { $ as SurfaceRect, A as ProxyFetchInit, B as RoomHandle, C as PackageQuery, D as PickOptions, E as PackagesFail, F as RoomBacklog, G as RoomOpenOptions, H as RoomMailbox, I as RoomCreateOptions, J as RoomsErrorCode, K as RoomPermission, L as RoomDefaults, M as Quota, N as Radii, O as Placement, P as Resolvers, Q as StorageQuota, R as RoomEnd, S as OverlayState, T as PackagesErrorCode, U as RoomMember, V as RoomJoinOptions, W as RoomMessage, X as SetOverlayHost, Y as RoomsFail, Z as StorageEntry, _ as InstallOptions, a as ConflictChoice, at as UdpSocketOptions, b as MountDescriptor, c as ConnectAvailability, d as DisplayLevel, et as TcpSocketListenerOptions, f as DnsLookup, g as HiddenSurface, h as FrameFetchScope, i as AdoptState, it as UdpDatagram, j as ProxyFetchInput, k as ProxyFetch, l as ConnectOptions, m as FrameConsentRequest, n as AddressLookupResult, nt as TcpSocketOptions, o as ConflictRequest, ot as UdpSocketResult, p as EncryptionState, q as RoomPermissions, r as AdoptRequest, rt as TcpSocketResult, s as ConflictSide, st as WriteData, t as Account, tt as TcpSocketListenerResult, u as DisplayCause, v as InstalledPackage, w as PackageResult, x as OverlayRect, y as IpFamily, z as RoomEvent } from "./contract-CSdeTq_Y.js";
+export { Account, AddressLookupResult, AdoptRequest, AdoptState, ConflictChoice, ConflictRequest, ConflictSide, ConnectAvailability, ConnectOptions, DisplayCause, DisplayLevel, DnsLookup, EncryptionState, FrameConsentRequest, FrameFetchScope, HiddenSurface, InstallOptions, InstalledPackage, IpFamily, MountDescriptor, OverlayRect, OverlayState, PackageQuery, PackageResult, PackagesErrorCode, PackagesFail, PickOptions, Placement, ProxyFetch, ProxyFetchInit, ProxyFetchInput, Quota, Radii, Resolvers, RoomBacklog, RoomCreateOptions, RoomDefaults, RoomEnd, RoomEvent, RoomHandle, RoomJoinOptions, RoomMailbox, RoomMember, RoomMessage, RoomOpenOptions, RoomPermission, RoomPermissions, RoomsErrorCode, RoomsFail, SetOverlayHost, StorageEntry, StorageQuota, SurfaceRect, TcpSocketListenerOptions, TcpSocketListenerResult, type TcpSocketOption, TcpSocketOptions, TcpSocketResult, UdpDatagram, type UdpSocketOption, UdpSocketOptions, UdpSocketResult, WriteData };

package/dgram.d.ts

@@ -1,6 +1,6 @@
 import { v as UdpSocketOption } from "./wire-Gbo-D74t.js";
-import { P as Resolvers, rt as UdpSocketResult } from "./contract-BzdjfQge.js";
-import "./api-CKoF03Me.js";
+import { P as Resolvers, ot as UdpSocketResult } from "./contract-CSdeTq_Y.js";
+import "./api-LKxHamsI.js";
 import { Buffer } from "buffer";
 import { AddressInfo } from "net";
 import { EventEmitter } from "events";

package/dns.d.ts

@@ -1,4 +1,4 @@
-import { n as AddressLookupResult } from "./contract-BzdjfQge.js";
+import { n as AddressLookupResult } from "./contract-CSdeTq_Y.js";
 declare namespace dns_d_exports {
   export { AddressLookupResult, lookup };
 }

package/{extension-DwQOshkM.d.ts → extension-DNkuFy1Y.d.ts}

@@ -352,7 +352,7 @@ declare const promptInstall: (reason?: string) => Promise<boolean>;
 declare const isExtensionAvailable: () => boolean;
 declare const fetch: (input: RequestInfo | URL, init?: RequestInit & {
   reason?: string;
-  render?: boolean;
+  spread?: boolean;
 }) => Promise<Response>;
 declare namespace extension_d_exports {
   export { ATTACH_FRAME_EVENT_KEY, AttachFrameOptions, BoxedVideoElement, CookieDetails, EXTENSION_ABI, Executor, ExtensionHandshake, ExtensionOperationUnsupportedError, ExtensionOutdatedError, FORGEABLE_HEADERS, FetchInit, Frame, FrameBackend, Gate, GateTools, GotoOptions, HeaderOperation, LOCATOR_DENIED, LOCATOR_ERROR, LOCATOR_UNSUPPORTED, Locator, OperationRequest, PermissionGrant, PermissionRequest, ProxyFetchRequest, REQUIRED_EXTENSION_ABI, RemoteVideoElement, RequestHeaderRule, SelectorPart, SiteCookie, VideoElementState, assertAttachableFrameUrl, assertFetchableUrl, assertForgeableHeaders, assertLockdownApplicable, assertOneCookieIdentity, attachFrame, attachFramePermission, isExtensionAvailable as available, box, cookies, createFrame, createVideoElementHandle, extension as events, extension, fetch$1 as fetch, fetchCredentialedPermission, fetchLocalPermission, fetchPermission, gotoPermission, handleRevivableModules, hasForgedCookie, isBlockedFetchUrl, isBlockedFrameUrl, isExtensionExposed, isLocalNetworkUrl, isLocatorDenied, isLocatorUnsupported, isTerminalError, isType, modifyRequestHeadersPermission, permissions, promptInstall, readCookiePermission, readExtensionHandshake, removeRequestHeaderRule, revive, setMissingExtensionHandler, setRequestHeaderRule, supportsOperation, type, waitForExtensionExposure };

package/extension.d.ts

@@ -1,3 +1,3 @@
-import { A as modifyRequestHeadersPermission, B as fetch, C as LOCATOR_ERROR, D as isTerminalError, E as isLocatorUnsupported, F as cookies, G as isLocalNetworkUrl, H as fetchLocalPermission, I as readCookiePermission, J as assertOneCookieIdentity, K as FORGEABLE_HEADERS, L as FetchInit, M as setRequestHeaderRule, N as CookieDetails, O as HeaderOperation, P as SiteCookie, R as ProxyFetchRequest, S as LOCATOR_DENIED, T as isLocatorDenied, U as fetchPermission, V as fetchCredentialedPermission, W as isBlockedFetchUrl, Y as hasForgedCookie, _ as PermissionRequest, a as extension, b as assertLockdownApplicable, c as setMissingExtensionHandler, d as ExtensionHandshake, f as ExtensionOperationUnsupportedError, g as PermissionGrant, h as supportsOperation, i as promptInstall, j as removeRequestHeaderRule, k as RequestHeaderRule, l as waitForExtensionExposure, m as REQUIRED_EXTENSION_ABI, o as isExtensionExposed, p as ExtensionOutdatedError, q as assertForgeableHeaders, r as isExtensionAvailable, s as readExtensionHandshake, u as EXTENSION_ABI, v as permissions, w as LOCATOR_UNSUPPORTED, x as isBlockedFrameUrl, y as assertAttachableFrameUrl, z as assertFetchableUrl } from "./extension-DwQOshkM.js";
+import { A as modifyRequestHeadersPermission, B as fetch, C as LOCATOR_ERROR, D as isTerminalError, E as isLocatorUnsupported, F as cookies, G as isLocalNetworkUrl, H as fetchLocalPermission, I as readCookiePermission, J as assertOneCookieIdentity, K as FORGEABLE_HEADERS, L as FetchInit, M as setRequestHeaderRule, N as CookieDetails, O as HeaderOperation, P as SiteCookie, R as ProxyFetchRequest, S as LOCATOR_DENIED, T as isLocatorDenied, U as fetchPermission, V as fetchCredentialedPermission, W as isBlockedFetchUrl, Y as hasForgedCookie, _ as PermissionRequest, a as extension, b as assertLockdownApplicable, c as setMissingExtensionHandler, d as ExtensionHandshake, f as ExtensionOperationUnsupportedError, g as PermissionGrant, h as supportsOperation, i as promptInstall, j as removeRequestHeaderRule, k as RequestHeaderRule, l as waitForExtensionExposure, m as REQUIRED_EXTENSION_ABI, o as isExtensionExposed, p as ExtensionOutdatedError, q as assertForgeableHeaders, r as isExtensionAvailable, s as readExtensionHandshake, u as EXTENSION_ABI, v as permissions, w as LOCATOR_UNSUPPORTED, x as isBlockedFrameUrl, y as assertAttachableFrameUrl, z as assertFetchableUrl } from "./extension-DNkuFy1Y.js";
 import { C as OperationRequest, S as GateTools, _ as isType, a as FrameBackend, b as Executor, c as attachFramePermission, d as handleRevivableModules, f as BoxedVideoElement, g as createVideoElementHandle, h as box, i as Frame, l as createFrame, m as VideoElementState, n as attachFrame, o as GotoOptions, p as RemoteVideoElement, r as AttachFrameOptions, s as Locator, t as ATTACH_FRAME_EVENT_KEY, u as gotoPermission, v as revive, w as SelectorPart, x as Gate, y as type } from "./index-DH3_12nU.js";
 export { ATTACH_FRAME_EVENT_KEY, AttachFrameOptions, BoxedVideoElement, CookieDetails, EXTENSION_ABI, type Executor, type ExtensionHandshake, ExtensionOperationUnsupportedError, ExtensionOutdatedError, FORGEABLE_HEADERS, FetchInit, Frame, FrameBackend, type Gate, type GateTools, GotoOptions, HeaderOperation, LOCATOR_DENIED, LOCATOR_ERROR, LOCATOR_UNSUPPORTED, Locator, type OperationRequest, PermissionGrant, PermissionRequest, ProxyFetchRequest, REQUIRED_EXTENSION_ABI, RemoteVideoElement, RequestHeaderRule, type SelectorPart, SiteCookie, VideoElementState, assertAttachableFrameUrl, assertFetchableUrl, assertForgeableHeaders, assertLockdownApplicable, assertOneCookieIdentity, attachFrame, attachFramePermission, isExtensionAvailable as available, box, cookies, createFrame, createVideoElementHandle, extension as events, extension, fetch, fetchCredentialedPermission, fetchLocalPermission, fetchPermission, gotoPermission, handleRevivableModules, hasForgedCookie, isBlockedFetchUrl, isBlockedFrameUrl, isExtensionExposed, isLocalNetworkUrl, isLocatorDenied, isLocatorUnsupported, isTerminalError, isType, modifyRequestHeadersPermission, permissions, promptInstall, readCookiePermission, readExtensionHandshake, removeRequestHeaderRule, revive, setMissingExtensionHandler, setRequestHeaderRule, supportsOperation, type, waitForExtensionExposure };

package/http.d.ts

@@ -1,4 +1,4 @@
-import { n as Socket, t as Server$1 } from "./net-Cy6QOTK3.js";
+import { n as Socket, t as Server$1 } from "./net-DtRM2eKo.js";
 import { Buffer } from "buffer";
 import { Stream } from "stream";
 import { IncomingHttpHeaders, OutgoingHttpHeaders, RequestOptions } from "http";

package/index.d.ts

@@ -1,10 +1,10 @@
 import { t as account_d_exports } from "./account.js";
-import { A as modifyRequestHeadersPermission, C as LOCATOR_ERROR, D as isTerminalError, E as isLocatorUnsupported, F as cookies, G as isLocalNetworkUrl, H as fetchLocalPermission, I as readCookiePermission, J as assertOneCookieIdentity, K as FORGEABLE_HEADERS, L as FetchInit, M as setRequestHeaderRule, N as CookieDetails, O as HeaderOperation, P as SiteCookie, R as ProxyFetchRequest, S as LOCATOR_DENIED, T as isLocatorDenied, U as fetchPermission, V as fetchCredentialedPermission, W as isBlockedFetchUrl, Y as hasForgedCookie, _ as PermissionRequest, b as assertLockdownApplicable, c as setMissingExtensionHandler, d as ExtensionHandshake, f as ExtensionOperationUnsupportedError, g as PermissionGrant, h as supportsOperation, i as promptInstall, j as removeRequestHeaderRule, k as RequestHeaderRule, l as waitForExtensionExposure, m as REQUIRED_EXTENSION_ABI, n as fetch, o as isExtensionExposed, p as ExtensionOutdatedError, q as assertForgeableHeaders, s as readExtensionHandshake, t as extension_d_exports, u as EXTENSION_ABI, v as permissions, w as LOCATOR_UNSUPPORTED, x as isBlockedFrameUrl, y as assertAttachableFrameUrl, z as assertFetchableUrl } from "./extension-DwQOshkM.js";
+import { A as modifyRequestHeadersPermission, C as LOCATOR_ERROR, D as isTerminalError, E as isLocatorUnsupported, F as cookies, G as isLocalNetworkUrl, H as fetchLocalPermission, I as readCookiePermission, J as assertOneCookieIdentity, K as FORGEABLE_HEADERS, L as FetchInit, M as setRequestHeaderRule, N as CookieDetails, O as HeaderOperation, P as SiteCookie, R as ProxyFetchRequest, S as LOCATOR_DENIED, T as isLocatorDenied, U as fetchPermission, V as fetchCredentialedPermission, W as isBlockedFetchUrl, Y as hasForgedCookie, _ as PermissionRequest, b as assertLockdownApplicable, c as setMissingExtensionHandler, d as ExtensionHandshake, f as ExtensionOperationUnsupportedError, g as PermissionGrant, h as supportsOperation, i as promptInstall, j as removeRequestHeaderRule, k as RequestHeaderRule, l as waitForExtensionExposure, m as REQUIRED_EXTENSION_ABI, n as fetch, o as isExtensionExposed, p as ExtensionOutdatedError, q as assertForgeableHeaders, s as readExtensionHandshake, t as extension_d_exports, u as EXTENSION_ABI, v as permissions, w as LOCATOR_UNSUPPORTED, x as isBlockedFrameUrl, y as assertAttachableFrameUrl, z as assertFetchableUrl } from "./extension-DNkuFy1Y.js";
 import { C as OperationRequest, S as GateTools, _ as isType, a as FrameBackend, b as Executor, c as attachFramePermission, d as handleRevivableModules, f as BoxedVideoElement, g as createVideoElementHandle, h as box, i as Frame, l as createFrame, m as VideoElementState, o as GotoOptions, p as RemoteVideoElement, r as AttachFrameOptions, s as Locator, t as ATTACH_FRAME_EVENT_KEY, u as gotoPermission, v as revive, w as SelectorPart, x as Gate, y as type } from "./index-DH3_12nU.js";
-import { n as cloud_d_exports } from "./cloud-BX_24NAz.js";
+import { n as cloud_d_exports } from "./cloud-IeXxCNsl.js";
 import { t as dns_d_exports } from "./dns.js";
 import { u as index_d_exports } from "./index-Cg6y_FTi.js";
-import { s as net_d_exports } from "./net-Cy6QOTK3.js";
+import { s as net_d_exports } from "./net-DtRM2eKo.js";
 import { t as dgram_d_exports } from "./dgram.js";
 import { t as http_d_exports } from "./http.js";
 import { t as desktop_d_exports } from "./desktop.js";

package/{net-Cy6QOTK3.d.ts → net-DtRM2eKo.d.ts}

@@ -1,6 +1,6 @@
 import { o as TcpSocketOption } from "./wire-Gbo-D74t.js";
-import { P as Resolvers, Q as TcpSocketListenerResult, et as TcpSocketResult } from "./contract-BzdjfQge.js";
-import "./api-CKoF03Me.js";
+import { P as Resolvers, rt as TcpSocketResult, tt as TcpSocketListenerResult } from "./contract-CSdeTq_Y.js";
+import "./api-LKxHamsI.js";
 import { AddressInfo, ListenOptions, Server, ServerOpts, Socket, SocketConnectOpts, SocketConstructorOpts } from "net";
 import { DuplexOptions, Stream } from "stream";
 import { EventEmitter } from "events";

package/net.d.ts

@@ -1,2 +1,2 @@
-import { a as createConnection, c as isIP, i as connect, l as isIPv4, n as Socket, o as createServer, r as _default, t as Server, u as isIPv6 } from "./net-Cy6QOTK3.js";
+import { a as createConnection, c as isIP, i as connect, l as isIPv4, n as Socket, o as createServer, r as _default, t as Server, u as isIPv6 } from "./net-DtRM2eKo.js";
 export { Server, Socket, _default, _default as default, connect, createConnection, createServer, isIP, isIPv4, isIPv6 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fkn/lib",
-  "version": "0.9.28",
+  "version": "0.9.30",
   "main": "index.js",
   "types": "index.d.ts",
   "type": "module",

package/packages.d.ts

@@ -1,4 +1,4 @@
-import { C as PackageQuery, D as PickOptions, N as Radii, O as Placement, T as PackagesErrorCode, X as SurfaceRect, _ as InstallOptions, l as ConnectOptions, v as InstalledPackage, w as PackageResult } from "./contract-BzdjfQge.js";
+import { $ as SurfaceRect, C as PackageQuery, D as PickOptions, N as Radii, O as Placement, T as PackagesErrorCode, _ as InstallOptions, l as ConnectOptions, v as InstalledPackage, w as PackageResult } from "./contract-CSdeTq_Y.js";
 import { Remote } from "osra";
 declare namespace packages_d_exports {
   export { AppConnectOptions, Connect, ConnectOptions, ConnectPayload, IncomingConnection, IncomingConnectionInfo, InstallOptions, InstalledPackage, MountOptions, MountedPackage, PackageConnection, PackageQuery, PackageResult, PackageView, PackagesError, PackagesErrorCode, PickOptions, Placement, Radii, RawPackageConnection, ShowOptions, SurfaceRect, attach, connect, hide, install, isVisible, list, mount, onConnect, onVisibilityChange, pick, search, show, uninstall };

package/{proxy-DahCiavd.d.ts → proxy-AooDS--C.d.ts}

@@ -1,5 +1,5 @@
-import { P as Resolvers } from "./contract-BzdjfQge.js";
-import "./api-CKoF03Me.js";
+import { P as Resolvers } from "./contract-CSdeTq_Y.js";
+import "./api-LKxHamsI.js";
 //#region src/proxy.d.ts
 type ProxyFetch = Resolvers['cloud']['fetch'];
 type FetchParameters = Parameters<ProxyFetch>;

package/rooms.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-BIInC43l.cjs"),t=require("./api-BCJO3EWi.cjs"),n=require("./busy-Dv8wzE5M.cjs");var r=e.t({available:()=>d,create:()=>f,join:()=>p}),i={noSuchRoom:`rooms: no such room`,wrongKey:`rooms: wrong room key`,inviteNoKey:`rooms: the invite carries no key`,noSuchMember:`rooms: no such member`,roomFull:`rooms: the room is full`,tooManyRooms:`rooms: too many rooms`,tooManyConnections:`rooms: too many connections`,tooManyBlocks:`rooms: too many blocks`,blocked:`rooms: you are blocked from this room`,cannotSend:`rooms: you cannot send here`,permissionDenied:`rooms: permission denied`,notOwner:`rooms: not the room owner`,ownerNotRemovable:`rooms: the owner cannot be removed`,ownerKeepsEvery:`rooms: the owner keeps every permission`,removeYourself:`rooms: you cannot remove yourself`,tooFast:`rooms: sending too fast`,tooLarge:`rooms: the message is too large`,unavailable:`rooms: rooms are unavailable`,notEnabled:`rooms: rooms are not available`,alreadyJoined:`rooms: already joined`,malformed:`rooms: malformed frame`,ended:`rooms: the room has ended`},a=(e,t)=>Object.assign(Error(t),{code:e}),o=e=>e instanceof Error&&typeof e.code==`string`,s=async()=>{if(!t.c)return;let e=(await t.o(`a room`).catch(()=>void 0))?.rooms;return typeof e?.create==`function`?e:void 0},c=()=>{throw a(`unavailable`,i.unavailable)},l=e=>e===`blocked`?`blocked`:e===`not-found`?`ended`:`unavailable`,u=async e=>{let r=e.invite,s=e,c=0,u=e.self,d=await e.defaults().catch(()=>({send:!0,receive:!0})),f=!1,p=new Set,m=new Set,h=n.t(`room`),g=()=>{},_=()=>{},v=new Promise(e=>{_=e}),y=e=>{let t=[...m];m.clear();for(let n of t)try{n(e)}catch{}},b=e=>{f||(f=!0,g(),p.clear(),h(),y(a(`closed`,i.ended)),_({reason:e}))},x=e=>{if(!f){e.type===`defaults`&&(d=e.defaults),e.type===`permissions`&&e.id===u.id&&(u={id:u.id,permissions:e.permissions});for(let t of[...p])try{t(e)}catch{}}},S=(e,t)=>{Promise.resolve(e.on(x)).catch(()=>{}),Promise.resolve(e.closed).then(e=>{t===c&&b(e.reason)},()=>{})},C=async(e,t)=>{if(typeof e?.join!=`function`)return b(`unavailable`);let n=await e.join(r).catch(()=>void 0);if(f||t!==c)return;if(!n)return b(`unavailable`);if(`error`in n)return b(l(n.error));if(n.self.id!==u.id)return Promise.resolve(n.leave()).catch(()=>{}),b(`unavailable`);s=n,u=n.self,S(n,t);let i=await n.defaults().catch(()=>void 0);i&&!f&&t===c&&(d=i)};g=t.l((e,t)=>{let n=c;c=t,!(f||n===0||n===t)&&(y(a(`unavailable`,i.unavailable)),C(e.rooms,t))}),S(e,c);let w=async e=>{if(f)throw a(`closed`,i.ended);let t=()=>{},n=new Promise((e,n)=>{t=n});m.add(t);try{return await Promise.race([Promise.resolve(e(s)),n])}catch(e){throw o(e)?e:a(`unavailable`,i.unavailable)}finally{m.delete(t)}},T=async e=>{let t=await w(e);if(`error`in t)throw a(t.error,t.message)};return{id:e.id,key:e.key,invite:r,get self(){return u},owner:e.owner,defaults:()=>d,members:()=>w(e=>e.members()),send:e=>T(t=>t.send(e)),setDefault:(e,t)=>T(n=>n.setDefault(e,t)),grant:(e,t)=>T(n=>n.grant(e,t)),revoke:(e,t)=>T(n=>n.revoke(e,t)),remove:e=>T(t=>t.remove(e)),block:e=>T(t=>t.block(e)),unblock:e=>T(t=>t.unblock(e)),on:async e=>f?()=>{}:(p.add(e),()=>{p.delete(e)}),leave:async()=>{await Promise.resolve(s.leave()).catch(()=>{}),b(`left`)},closed:v}},d=async()=>{let e=await s();return e?e.available().catch(()=>!1):!1},f=async e=>{let t=await s();if(!t)throw a(`unavailable`,i.unavailable);let n=await t.create(e).catch(c);if(`error`in n)throw a(n.error,n.message);return u(n)},p=async(e,t)=>{let n=typeof e==`string`?e.indexOf(`.`):-1;if(n<=0||n===e.length-1)throw a(`invalid`,i.inviteNoKey);let r=await s();if(!r)throw a(`unavailable`,i.unavailable);let o=await r.join(e,t).catch(c);if(`error`in o)throw a(o.error,o.message);return u(o)};exports.available=d,exports.create=f,exports.join=p,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return r}});
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-BIInC43l.cjs"),t=require("./api-BCJO3EWi.cjs"),n=require("./busy-Dv8wzE5M.cjs");var r=e.t({available:()=>f,create:()=>m,join:()=>h,open:()=>p}),i={wrongKey:`rooms: wrong room key`,inviteNoKey:`rooms: the invite carries no key`,badName:`rooms: the name is not one a room can have`,badKeyOption:`rooms: the key is not 32 bytes base64url`,noSuchMember:`rooms: no such member`,noSuchMessage:`rooms: no such message`,roomFull:`rooms: the room is full`,tooManyConnections:`rooms: too many connections`,tooManyBlocks:`rooms: too many blocks`,tooManyClaims:`rooms: too many claims`,mailboxFull:`rooms: the mailbox is full`,outOfStorage:`rooms: the owner is out of storage`,outOfQuota:`rooms: out of daily bandwidth`,blocked:`rooms: you are blocked from this room`,cannotSend:`rooms: you cannot send here`,permissionDenied:`rooms: permission denied`,notOwner:`rooms: not the room owner`,ownerNotRemovable:`rooms: the owner cannot be removed`,ownerKeepsEvery:`rooms: the owner keeps every permission`,removeYourself:`rooms: you cannot remove yourself`,needsAccount:`rooms: claiming needs an account`,needsPremium:`rooms: claiming needs premium`,nameClaimed:`rooms: the name is claimed`,notClaimed:`rooms: the room is not claimed`,noMailbox:`rooms: the room keeps no messages`,badLimit:`rooms: the limit is out of range`,tooFast:`rooms: sending too fast`,tooLarge:`rooms: the message is too large`,unavailable:`rooms: rooms are unavailable`,notEnabled:`rooms: rooms are not available`,alreadyJoined:`rooms: already joined`,notJoined:`rooms: not joined`,malformed:`rooms: malformed frame`,ended:`rooms: the room has ended`},a=(e,t)=>Object.assign(Error(t),{code:e}),o=e=>e instanceof Error&&typeof e.code==`string`,s={send:!0,receive:!0,maxMessageBytes:262144},c=async()=>{if(!t.c)return;let e=(await t.o(`a room`).catch(()=>void 0))?.rooms;return typeof e?.open==`function`?e:void 0},l=()=>{throw a(`unavailable`,i.unavailable)},u=e=>e===`blocked`?`blocked`:e===`not-found`?`ended`:`unavailable`,d=async e=>{let r=e.invite,c=e,l=0,d=e.self,f=e.owner,p=e.claimed,m=e.mailbox,h=await e.defaults().catch(()=>s),g=!1,_=new Set,v=new Set,y=n.t(`room`),b=()=>{},x=()=>{},S=new Promise(e=>{x=e}),C=e=>{let t=[...v];v.clear();for(let n of t)try{n(e)}catch{}},w=e=>{g||(g=!0,b(),_.clear(),y(),C(a(`closed`,i.ended)),x({reason:e}))},T=e=>{if(!g){e.type===`defaults`&&(h=e.defaults),e.type===`permissions`&&e.id===d.id&&(d={id:d.id,permissions:e.permissions,maxMessageBytes:e.maxMessageBytes}),e.type===`claim`&&(p=e.claimed,f=e.owner,p||(m=null));for(let t of[..._])try{t(e)}catch{}}},E=(e,t)=>{Promise.resolve(e.on(T)).catch(()=>{}),Promise.resolve(e.closed).then(e=>{t===l&&w(e.reason)},()=>{})},D=async(e,t)=>{if(typeof e?.join!=`function`)return w(`unavailable`);let n=await e.join(r).catch(()=>void 0);if(g||t!==l)return;if(!n)return w(`unavailable`);if(`error`in n)return w(u(n.error));if(n.self.id!==d.id)return Promise.resolve(n.leave()).catch(()=>{}),w(`unavailable`);c=n,d=n.self,f=n.owner,p=n.claimed,m=n.mailbox,E(n,t);let i=await n.defaults().catch(()=>void 0);i&&!g&&t===l&&(h=i)};b=t.l((e,t)=>{let n=l;l=t,!(g||n===0||n===t)&&(C(a(`unavailable`,i.unavailable)),D(e.rooms,t))}),E(e,l);let O=async e=>{if(g)throw a(`closed`,i.ended);let t=()=>{},n=new Promise((e,n)=>{t=n});v.add(t);try{return await Promise.race([Promise.resolve(e(c)),n])}catch(e){throw o(e)?e:a(`unavailable`,i.unavailable)}finally{v.delete(t)}},k=async e=>{let t=await O(e);if(`error`in t)throw a(t.error,t.message)},A=async e=>{let t=await O(e);if(typeof t==`object`&&t&&`error`in t)throw a(t.error,t.message);return t};return{id:e.id,name:e.name,key:e.key,invite:r,get self(){return d},get owner(){return f},get claimed(){return p},get mailbox(){return m},defaults:()=>h,members:()=>O(e=>e.members()),send:e=>k(t=>t.send(e)),edit:(e,t)=>k(n=>n.edit(e,t)),delete:(e,t)=>k(n=>n.delete(e,t)),backlog:(e,t)=>A(n=>n.backlog(e,t)),setDefault:(e,t)=>k(n=>n.setDefault(e,t)),limit:(e,t)=>k(n=>n.limit(e,t)),grant:(e,t)=>k(n=>n.grant(e,t)),revoke:(e,t)=>k(n=>n.revoke(e,t)),remove:e=>k(t=>t.remove(e)),block:e=>k(t=>t.block(e)),unblock:e=>k(t=>t.unblock(e)),claim:()=>k(e=>e.claim()),release:()=>k(e=>e.release()),usage:async()=>{let e=await A(e=>e.usage());return m=e,e},on:async e=>g?()=>{}:(_.add(e),()=>{_.delete(e)}),leave:async()=>{await Promise.resolve(c.leave()).catch(()=>{}),w(`left`)},closed:S}},f=async()=>{let e=await c();return e?e.available().catch(()=>!1):!1},p=async(e,t)=>{if(typeof e!=`string`||e.length===0||e.length>72)throw a(`invalid`,i.badName);let n=await c();if(!n)throw a(`unavailable`,i.unavailable);let r=await n.open(e,t).catch(l);if(`error`in r)throw a(r.error,r.message);return d(r)},m=async e=>{let t=await c();if(!t)throw a(`unavailable`,i.unavailable);let n=await t.create(e).catch(l);if(`error`in n)throw a(n.error,n.message);return d(n)},h=async(e,t)=>{let n=typeof e==`string`?e.indexOf(`.`):-1;if(n<=0||n===e.length-1)throw a(`invalid`,i.inviteNoKey);let r=await c();if(!r)throw a(`unavailable`,i.unavailable);let o=await r.join(e,t).catch(l);if(`error`in o)throw a(o.error,o.message);return d(o)};exports.available=f,exports.create=m,exports.join=h,exports.open=p,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return r}});

package/rooms.d.ts

@@ -1,6 +1,6 @@
-import { B as RoomJoinOptions, F as RoomCreateOptions, G as RoomsErrorCode, H as RoomMessage, I as RoomDefaults, L as RoomEnd, R as RoomEvent, U as RoomPermission, V as RoomMember, W as RoomPermissions } from "./contract-BzdjfQge.js";
+import { F as RoomBacklog, G as RoomOpenOptions, H as RoomMailbox, I as RoomCreateOptions, J as RoomsErrorCode, K as RoomPermission, L as RoomDefaults, R as RoomEnd, U as RoomMember, V as RoomJoinOptions, W as RoomMessage, q as RoomPermissions, z as RoomEvent } from "./contract-CSdeTq_Y.js";
 declare namespace rooms_d_exports {
-  export { RoomCreateOptions as CreateOptions, RoomJoinOptions as JoinOptions, Room, RoomDefaults, RoomEnd, RoomEvent, RoomMember, RoomMessage, RoomPermission, RoomPermissions, RoomsError, RoomsErrorCode, available, create, join };
+  export { RoomCreateOptions as CreateOptions, RoomJoinOptions as JoinOptions, RoomOpenOptions as OpenOptions, Room, RoomBacklog, RoomDefaults, RoomEnd, RoomEvent, RoomMailbox, RoomMember, RoomMessage, RoomPermission, RoomPermissions, RoomsError, RoomsErrorCode, available, create, join, open };
 }
 /** Thrown by every member of this namespace. Match on `code`, never on the message. */
 type RoomsError = Error & {
@@ -11,36 +11,60 @@ type RoomsError = Error & {
  * as the chat lasts.
  */
 type Room = {
-  /** the room's uuid */
+  /** `<scope>/<name>`: the name under this app's own scope, or under `global` */
   readonly id: string;
+  readonly name: string;
   /** the room key, base64url. The server never sees it. Anyone holding it and the id can join. */
   readonly key: string;
-  /** `id` and `key` as one string, the thing to put in a link */
+  /** `key` and `id` as one string, the thing to put in a link */
   readonly invite: string;
   /** this app's member record, as this room sees it. The id is fresh in every room. */
   readonly self: RoomMember;
+  /** the owner's member id, or '' while a claimed room's owner has never joined */
   readonly owner: string;
+  /** whether a premium account keeps this name and its messages */
+  readonly claimed: boolean;
+  /** what the mailbox holds, as the room last said. Null for a room nobody has claimed. */
+  readonly mailbox: RoomMailbox | null;
   defaults: () => RoomDefaults;
   members: () => Promise<RoomMember[]>;
-  /** at most 4,096 bytes of UTF-8, sealed before it leaves the browser. Rejects `too-large`, never truncates. */
+  /** sealed before it leaves the browser. Rejects `too-large` past `self.maxMessageBytes` on the wire, never truncates. */
   send: (text: string) => Promise<void>;
+  /** replaces a stored message's text: one of your own, or any as the owner */
+  edit: (seq: number, text: string) => Promise<void>;
+  /** drops stored messages: one of your own, or any range as the owner */
+  delete: (from: number, to?: number) => Promise<void>;
+  /** replays stored messages above `after` as `message` events marked `replayed`, one page at a time */
+  backlog: (after: number, limit?: number) => Promise<RoomBacklog>;
   setDefault: (permission: 'send' | 'receive', value: boolean) => Promise<void>;
+  /** the message size cap: the room default when no member is named, that member's override otherwise, cleared by null */
+  limit: (maxMessageBytes: number | null, id?: string) => Promise<void>;
   grant: (id: string, permission: RoomPermission) => Promise<void>;
   revoke: (id: string, permission: RoomPermission) => Promise<void>;
   remove: (id: string) => Promise<void>;
   block: (id: string) => Promise<void>;
   unblock: (id: string) => Promise<void>;
+  /** keeps the name and a mailbox for the signed-in premium account. The only thing in rooms that premium buys. */
+  claim: () => Promise<void>;
+  release: () => Promise<void>;
+  usage: () => Promise<RoomMailbox | null>;
   /** Await the returned unsubscribe in cleanup, the `account.onChange` shape. */
   on: (listener: (event: RoomEvent) => void) => Promise<() => void>;
   leave: () => Promise<void>;
   /** Settles once, when the room ends for this app. Never rejects. */
   readonly closed: Promise<RoomEnd>;
 };
-/** Whether this realm can join a room: false in Node, false in a worker nothing bridged, false against a shell older than rooms. Answers rather than rejecting. */
+/** Whether this realm can join a room: false in Node, false in a worker nothing bridged, false against a shell older than named rooms. Answers rather than rejecting. */
 declare const available: () => Promise<boolean>;
-/** Open a room and become its owner. Share `room.invite` to let anyone else in. */
+/**
+ * Open a room by name: a name under this app's own scope, or `global/<name>` for the shared one.
+ * Nobody there means the room comes into being with you as its owner; somebody there means you join
+ * them, and the key has to match theirs. Share `room.invite` to let anyone else in.
+ */
+declare const open: (name: string, options?: RoomOpenOptions) => Promise<Room>;
+/** Open a room under a random name and become its owner. Share `room.invite` to let anyone else in. */
 declare const create: (options?: RoomCreateOptions) => Promise<Room>;
-/** `invite` is `room.invite`, or an id and a key joined by a dot. */
+/** `invite` is `room.invite`: a key and a room id joined by a dot. */
 declare const join: (invite: string, options?: RoomJoinOptions) => Promise<Room>;
 //#endregion
-export { type RoomCreateOptions as CreateOptions, type RoomJoinOptions as JoinOptions, Room, type RoomDefaults, type RoomEnd, type RoomEvent, type RoomMember, type RoomMessage, type RoomPermission, type RoomPermissions, RoomsError, type RoomsErrorCode, available, create, join, rooms_d_exports as t };
+export { type RoomCreateOptions as CreateOptions, type RoomJoinOptions as JoinOptions, type RoomOpenOptions as OpenOptions, Room, type RoomBacklog, type RoomDefaults, type RoomEnd, type RoomEvent, type RoomMailbox, type RoomMember, type RoomMessage, type RoomPermission, type RoomPermissions, RoomsError, type RoomsErrorCode, available, create, join, open, rooms_d_exports as t };