@protobase/client 0.59.3 → 0.60.1

package/dist/calls/index.d.ts

@@ -1,4 +1,4 @@
 import { CallTrack, PublishOptions } from "./media-link.js";
 import { Call, CallState, JoinCallOptions, joinCall } from "./join-call.js";
-import { CallLeftReason, CallMode, CallTrackSource } from "@protobase/schema/internal";
-export { type Call, type CallLeftReason, type CallMode, type CallState, type CallTrack, type CallTrackSource, type JoinCallOptions, type PublishOptions, joinCall };
+import { CallLeftReason, CallMode, CallRosterMember, CallTrackSource } from "@protobase/schema/internal";
+export { type Call, type CallLeftReason, type CallMode, type CallRosterMember, type CallState, type CallTrack, type CallTrackSource, type JoinCallOptions, type PublishOptions, joinCall };

package/dist/calls/join-call.d.ts

@@ -1,5 +1,5 @@
 import { CallTrack, PublishOptions } from "./media-link.js";
-import { CallLeftReason, CallTrackSource } from "@protobase/schema/internal";
+import { CallLeftReason, CallRosterMember, CallTrackSource } from "@protobase/schema/internal";
 //#region src/calls/join-call.d.ts
 /** Where a call stands: `resuming` while the link to Protobase is restored, with media still flowing. */
 export type CallState = {
@@ -21,6 +21,8 @@ export type JoinCallOptions = {
   url: string;
   /** Every track of other members the member hears, whenever one comes, goes or its media arrives. */
   onTracks?: (tracks: CallTrack[]) => void;
+  /** Everyone in the call, the member too, in the order they came, whenever that changes. */
+  onMembers?: (members: CallRosterMember[]) => void;
   /** Who speaks how loudly, from 0 to 1, for the members whose level changed. */
   onSpeakers?: (speakers: {
     member: string;
@@ -31,14 +33,18 @@ export type JoinCallOptions = {
   onUnpublished?: (source: CallTrackSource) => void;
   /** How long to wait before the `attempt`th try to restore a lost link. */
   retryDelayMs?: (attempt: number) => number;
-  /** How many tries in a row to restore a lost link before the call is left. Default 8. */
+  /** How many tries in a row to restore a lost link, or to get in while the server fails, before the call is left. Default 8. */
   maxRetries?: number;
   WebSocket?: typeof WebSocket;
   createPeerConnection?: (configuration: RTCConfiguration) => RTCPeerConnection;
 };
 export type Call = {
+  /** The call, as the record's calls list it and `calls.remove` takes it. */
+  readonly id: string;
   /** The member's participant in the media server. */
   readonly participant: string;
+  /** Everyone in the call now, the member too. */
+  members: () => CallRosterMember[];
   /** Sends tracks under the sources they carry, such as `{ camera, microphone }`; rejects when the member may not. */
   publish: (tracks: Partial<Record<CallTrackSource, MediaStreamTrack>>, options?: PublishOptions) => Promise<void>;
   unpublish: (source: CallTrackSource) => Promise<void>;

package/dist/calls/join-call.js

@@ -12,6 +12,8 @@ const leftCodes = {
 	1e3: "ended",
 	1008: "removed"
 };
+/** Close codes of a server that failed, or was too busy, for now: getting in is tried again. */
+const failedCodes = /* @__PURE__ */ new Set([1011, 1013]);
 /**
 * Joins a call through the app's function socket and resolves once the member is in it. Media flows over plain
 * `RTCPeerConnection`s, to the media server or straight to the other members, as the app's calls are configured;
@@ -26,6 +28,8 @@ const joinCall = (options) => {
 	let socket;
 	let link;
 	let participant = "";
+	let callId = "";
+	let members = [];
 	let remote = [];
 	let ended = false;
 	let rejoin = false;
@@ -74,6 +78,7 @@ const joinCall = (options) => {
 				const before = link?.sending();
 				link?.close();
 				participant = message.participant;
+				callId = message.call;
 				link = newLink(message);
 				failures = 0;
 				setState({ state: "joined" });
@@ -90,6 +95,10 @@ const joinCall = (options) => {
 			case "speakers":
 				options.onSpeakers?.(message.speakers);
 				return;
+			case "members":
+				members = message.members;
+				options.onMembers?.(members);
+				return;
 			case "left":
 				if (message.reason === "rejoin") rejoin = true;
 				else end(message.reason);
@@ -107,6 +116,7 @@ const joinCall = (options) => {
 				const resume = mode === "resume" && link ? await link.resumeState(participant) : void 0;
 				send(resume ? {
 					type: "resume",
+					call: callId,
 					...resume
 				} : { type: "join" });
 			});
@@ -127,19 +137,23 @@ const joinCall = (options) => {
 		}
 		const left = leftCodes[code];
 		if (left) return end(left);
-		if (!participant) return end("refused");
+		if (!participant && !failedCodes.has(code)) return end("refused");
 		failures++;
-		if (failures > maxRetries) return end("ended");
-		setState({ state: "resuming" });
+		if (failures > maxRetries) return end(participant ? "ended" : "unavailable");
+		setState(participant ? { state: "resuming" } : { state: "connecting" });
 		const next = mode === "resume" && opened && !resumedSinceOpen ? "join" : "resume";
 		setTimeout(() => {
 			if (!ended) connect(next);
 		}, retryDelay(failures - 1));
 	};
 	const call = {
+		get id() {
+			return callId;
+		},
 		get participant() {
 			return participant;
 		},
+		members: () => members,
 		publish: async (tracks, publishOptions) => {
 			if (!link) throw new Error("The call was left");
 			await link.publish(tracks, publishOptions);

package/dist/calls/msid-tracks.js

@@ -1,16 +1,16 @@
 //#region src/calls/msid-tracks.ts
 /**
-* The `mid` of each media section of a description by the sending browser's track id, which its `a=msid` line names: a
-* receiver's own track may have another id, when the browser reused one of its transceivers for the section.
+* The `mid` of each media section of a description by the id of the stream its `a=msid` line names. Unlike the track
+* id there, which Firefox makes up for each sender, both browsers write the sending page's stream id.
 */
-const midsByTrackId = (sdp) => {
+const midsByStreamId = (sdp) => {
 	const mids = /* @__PURE__ */ new Map();
 	for (const section of sdp.split(/\r?\nm=/).slice(1)) {
 		const mid = /^a=mid:(\S+)/m.exec(section)?.[1];
-		const track = /^a=msid:\S+ (\S+)/m.exec(section)?.[1];
-		if (mid !== void 0 && track !== void 0) mids.set(track, mid);
+		const stream = /^a=msid:(\S+) \S+/m.exec(section)?.[1];
+		if (mid !== void 0 && stream !== void 0 && stream !== "-") mids.set(stream, mid);
 	}
 	return mids;
 };
 //#endregion
-export { midsByTrackId };
+export { midsByStreamId };

package/dist/calls/peer-link.js

@@ -1,11 +1,11 @@
 import { createPeerConnection } from "./media-link.js";
-import { midsByTrackId } from "./msid-tracks.js";
+import { midsByStreamId } from "./msid-tracks.js";
 //#region src/calls/peer-link.ts
 /**
 * The media link without a media server: one `RTCPeerConnection` to each other member, whose browser answers, so either
 * side may offer. Protobase passes the descriptions and candidates between the two ("perfect negotiation": the member
 * whose id sorts first gives way when both offer at once) and says who is in the call and which tracks each member
-* hears. A track goes by the id the sending browser gave it, which the receiving browser sees too.
+* hears. A track goes by the id of the stream the sending browser sends it on, which the receiving browser sees too.
 */
 const peerLink = (self, { iceServers, send, onTracks, createPeerConnection: createPeerConnection$1 = createPeerConnection }) => {
 	const peers = /* @__PURE__ */ new Map();
@@ -13,10 +13,13 @@ const peerLink = (self, { iceServers, send, onTracks, createPeerConnection: crea
 	let remote = [];
 	let publishing;
 	let publishes = Promise.resolve();
-	const sendOn = (pc, track) => pc.addTransceiver(track, { direction: "sendonly" }).sender;
+	const sendOn = (pc, { track, stream }) => pc.addTransceiver(track, {
+		direction: "sendonly",
+		streams: [stream]
+	}).sender;
 	const receivedTrack = ({ member, sid }) => {
 		const pc = peers.get(member)?.pc;
-		const mid = pc?.remoteDescription && midsByTrackId(pc.remoteDescription.sdp).get(sid);
+		const mid = pc?.remoteDescription && midsByStreamId(pc.remoteDescription.sdp).get(sid);
 		return mid === void 0 ? void 0 : pc.getTransceivers().find((transceiver) => transceiver.mid === mid)?.receiver.track;
 	};
 	const emitTracks = () => onTracks(remote.map((track) => ({
@@ -57,7 +60,7 @@ const peerLink = (self, { iceServers, send, onTracks, createPeerConnection: crea
 			if (pc.iceConnectionState === "failed") pc.restartIce();
 		};
 		pc.ontrack = () => emitTracks();
-		for (const [source, { track }] of local) peer.senders.set(source, sendOn(pc, track));
+		for (const [source, sending] of local) peer.senders.set(source, sendOn(pc, sending));
 		return peer;
 	};
 	const disconnect = (member) => {
@@ -111,14 +114,22 @@ const peerLink = (self, { iceServers, send, onTracks, createPeerConnection: crea
 		const added = Object.entries(tracks);
 		for (const [source] of added) if (local.has(source)) throw new Error(`The call already sends a ${source} track: unpublish it first`);
 		if (added.length === 0) return;
+		const sending = added.map(([source, track]) => {
+			const stream = new MediaStream([track]);
+			return [source, {
+				track,
+				sid: stream.id,
+				stream
+			}];
+		});
 		const answered = new Promise((resolve, reject) => publishing = {
 			resolve,
 			reject
 		});
 		send({
 			type: "publish",
-			tracks: added.map(([source, track]) => ({
-				cid: track.id,
+			tracks: sending.map(([source, { track, sid }]) => ({
+				cid: sid,
 				kind: track.kind,
 				source
 			}))
@@ -128,11 +139,8 @@ const peerLink = (self, { iceServers, send, onTracks, createPeerConnection: crea
 		} finally {
 			publishing = void 0;
 		}
-		for (const [source, track] of added) {
-			local.set(source, {
-				track,
-				sid: track.id
-			});
+		for (const [source, track] of sending) {
+			local.set(source, track);
 			for (const peer of peers.values()) peer.senders.set(source, sendOn(peer.pc, track));
 		}
 	};
@@ -173,7 +181,7 @@ const peerLink = (self, { iceServers, send, onTracks, createPeerConnection: crea
 		resumeState: async (participant) => ({
 			participant,
 			tracks: [...local].map(([source, { track, sid }]) => ({
-				cid: track.id,
+				cid: sid,
 				sid,
 				kind: track.kind,
 				source

package/dist/channels.js

@@ -23,13 +23,25 @@ const channelsClient = (options) => {
 		const entries = [...channel.presence.values()];
 		for (const listener of channel.presenceListeners) listener(entries, change);
 	};
+	const forget = (id) => {
+		joined.delete(id);
+		if (joined.size === 0) connection.stop();
+	};
 	const join = (channel) => {
+		const id = `${channel.resource}/${channel.key}`;
 		connection.request({
 			type: "join",
 			resource: channel.resource,
 			key: channel.key
 		}).then((reply) => {
-			if (joined.get(`${channel.resource}/${channel.key}`) !== channel) return;
+			if (joined.get(id) !== channel) return;
+			if (channel.holders === 0) {
+				connection.post({
+					type: "leave",
+					channel: reply.channel
+				});
+				return forget(id);
+			}
 			channel.name = reply.channel;
 			byName.set(channel.name, channel);
 			setStatus(channel, { state: "joined" });
@@ -39,6 +51,7 @@ const channelsClient = (options) => {
 				state: channel.tracked.state
 			}).catch(unlessDropped);
 		}).catch((error) => {
+			if (joined.get(id) === channel && channel.holders === 0 && error instanceof ChannelRefusal) return forget(id);
 			if (!(error instanceof ChannelRefusal) || error.code === "disconnected") return unlessDropped(error);
 			setStatus(channel, {
 				state: "refused",
@@ -87,7 +100,11 @@ const channelsClient = (options) => {
 	const connection = channelConnection({
 		...options,
 		onOpen: () => {
-			for (const channel of joined.values()) if (channel.status.state === "joining") join(channel);
+			for (const [id, channel] of joined) {
+				if (channel.status.state !== "joining") continue;
+				if (channel.holders === 0) forget(id);
+				else join(channel);
+			}
 		},
 		onDown: () => {
 			byName.clear();
@@ -98,7 +115,8 @@ const channelsClient = (options) => {
 	const release = (id, channel) => {
 		channel.holders -= 1;
 		if (channel.holders > 0) return;
-		joined.delete(id);
+		channel.tracked = void 0;
+		if (channel.status.state === "joining") return;
 		if (channel.name !== void 0) {
 			byName.delete(channel.name);
 			connection.post({
@@ -106,7 +124,7 @@ const channelsClient = (options) => {
 				channel: channel.name
 			});
 		}
-		if (joined.size === 0) connection.stop();
+		forget(id);
 	};
 	const handleOf = (id, channel) => {
 		let left = false;

package/dist/client.d.ts

@@ -3,9 +3,10 @@ import { ClientOptions } from "./transport.js";
 import { RegisteredDevice, WebDeviceRegistration } from "./devices.js";
 import { InboxPage } from "./notification-history.js";
 import { FilterInput, ListParams, MapParams } from "./query-string.js";
+import { Aggregate, AggregateParams, BatchOp, BatchResult, CommentPage, Facet, FormChallenge, FormProof, Histogram, HistoryPage, ListPage, MapResult, MentionableUser, MetaResult, PublicForm, RecordComment, RecordOf, ResourceRef, Series, SeriesParams, Stored } from "./types.js";
+import { RecordCall, RecordCallsHandlers } from "./record-calls.js";
 import { UploadProgress } from "./upload-request.js";
 import { LiveHandlers } from "./live.js";
-import { Aggregate, AggregateParams, BatchOp, BatchResult, CommentPage, Facet, FormChallenge, FormProof, Histogram, HistoryPage, ListPage, MapResult, MentionableUser, MetaResult, PublicForm, RecordComment, RecordOf, ResourceRef, Series, SeriesParams, Stored } from "./types.js";
 import { KeyValue } from "@protobase/schema";
 //#region src/client.d.ts
 /** How `invoke` calls a function: GET without a body, POST with one, unless `method` says otherwise. */
@@ -118,6 +119,8 @@ export declare const createClient: (options?: ClientOptions) => {
     clear: () => Promise<void>;
     people: () => Promise<import("@protobase/schema/internal").PersonStatus[]>;
   };
+  calls: (resource: ResourceRef, key: KeyValue | readonly KeyValue[]) => Promise<RecordCall[]>;
+  watchCalls: (resource: ResourceRef, key: KeyValue | readonly KeyValue[], handlers: RecordCallsHandlers) => () => void;
 };
 export type Client = ReturnType<typeof createClient>;
 //#endregion

package/dist/client.js

@@ -8,6 +8,7 @@ import { channelsClient } from "./channels.js";
 import { devicesClient } from "./devices.js";
 import { statusClient } from "./status.js";
 import { notificationHistoryClient } from "./notification-history.js";
+import { recordCallsClient } from "./record-calls.js";
 import { encodeKey } from "@protobase/schema/internal";
 //#region src/client.ts
 const nameOf = (resource) => typeof resource === "string" ? resource : resource.toModel().name;
@@ -17,6 +18,8 @@ const channelsUrl = (baseUrl = "/api/v1") => {
 	return url.toString();
 };
 const keyPath = (resource, key) => `/${nameOf(resource)}/${encodeKey(key)}`;
+/** Where a record's calls are read and followed. */
+const callsPath = (resource, key) => `${keyPath(resource, key)}:calls`;
 const toPage = (body, response, origin) => ({
 	items: body.items.map((item) => withFileOrigin(item, origin)),
 	nextPageToken: body.next_page_token,
@@ -431,6 +434,12 @@ const createClient = (options = {}) => {
 		socket: options.webSocket ?? ((url, protocols) => new WebSocket(url, protocols)),
 		retryDelay: (attempt) => Math.min(3e4, 1e3 * 2 ** attempt)
 	});
+	/** The signed-in user's own devices, where they receive push (see `devicesClient`). */
+	const devices = devicesClient(send);
+	/** The signed-in user's own notification history, their inbox (see `notificationHistoryClient`). */
+	const notifications = notificationHistoryClient(send);
+	/** A record's calls, live with `watchCalls`, for whoever may read the record (see `recordCallsClient`). */
+	const { calls, watchCalls } = recordCallsClient(send, callsPath);
 	return {
 		list,
 		search,
@@ -460,10 +469,12 @@ const createClient = (options = {}) => {
 		submitForm,
 		live,
 		channel,
-		devices: devicesClient(send),
-		notifications: notificationHistoryClient(send),
-		status: statusClient(send)
+		devices,
+		notifications,
+		status: statusClient(send),
+		calls,
+		watchCalls
 	};
 };
 //#endregion
-export { createClient };
+export { callsPath, createClient };

package/dist/index.d.ts

@@ -5,9 +5,10 @@ import { ClientOptions } from "./transport.js";
 import { DevicesClient, RegisteredDevice, WebDeviceRegistration } from "./devices.js";
 import { InboxNotification, InboxPage, NotificationHistoryClient } from "./notification-history.js";
 import { FilterInput, ListParams, MapParams, filterText, listWire } from "./query-string.js";
+import { Aggregate, AggregateGroup, AggregateParams, AggregateSplitTotal, BatchOp, BatchRef, BatchResult, CommentPage, CommentPerson, Facet, FormChallenge, FormProof, Histogram, HistogramBucket, HistoryChange, HistoryPage, ListPage, MapBounds, MapBucket, MapLayerModel, MapResult, MentionableUser, Meta, MetaResult, PluginRef, PublicForm, RecordComment, RecordOf, RecordPermissions, RecordPhotos, RelatedLabels, ResourcePermissions, ResourceRef, Series, SeriesParams, SeriesPoint, SourceRef, Stored, StoredFile, StoredFileVariant } from "./types.js";
+import { RecordCall, RecordCallsHandlers } from "./record-calls.js";
 import { UploadProgress } from "./upload-request.js";
 import { LiveChange, LiveHandlers } from "./live.js";
-import { Aggregate, AggregateGroup, AggregateParams, AggregateSplitTotal, BatchOp, BatchRef, BatchResult, CommentPage, CommentPerson, Facet, FormChallenge, FormProof, Histogram, HistogramBucket, HistoryChange, HistoryPage, ListPage, MapBounds, MapBucket, MapLayerModel, MapResult, MentionableUser, Meta, MetaResult, PluginRef, PublicForm, RecordComment, RecordOf, RecordPermissions, RecordPhotos, RelatedLabels, ResourcePermissions, ResourceRef, Series, SeriesParams, SeriesPoint, SourceRef, Stored, StoredFile, StoredFileVariant } from "./types.js";
 import { Client, InvokeOptions, UploadOptions, UploadResult, createClient } from "./client.js";
 import { Availability, PersonStatus, StatusClient, StatusInput } from "./status.js";
 import { ApiError, PreconditionFailedError, ProblemDetails, ProblemError, isApiError } from "./problem.js";
@@ -29,4 +30,4 @@ import { createStaticSession } from "./static-session.js";
 import { AssistantClient, AssistantClientOptions, AssistantConnection, createAssistantClient } from "./assistant.js";
 import { RuntimeClient, RuntimeClientOptions, RuntimeLastUpdate, RuntimePolicy, RuntimeStatus, RuntimeUpdateStage, createRuntimeClient } from "./runtime.js";
 import { availabilities, heldStatus, maxStatusText, statusTextProblem } from "@protobase/schema/internal";
-export { type AccountSecurity, type AccountSignIn, type ActiveRole, type Aggregate, type AggregateGroup, type AggregateParams, type AggregateSplitTotal, ApiError, type AppUser, type AssistantClient, type AssistantClientOptions, type AssistantConnection, AuthError, type AuthSession, type AuthSessionOptions, type AuthUser, type AuthenticatorSetup, type Availability, type BatchOp, type BatchRef, type BatchResult, type Channel, type ChannelError, type ChannelMessage, ChannelRefusal, type ChannelStatus, type ChannelUser, type Client, type ClientOptions, type CommentPage, type CommentPerson, type ConnectClient, type ConnectedApp, type ConnectingClient, type CurrentOrganization, type DeviceSession, type DevicesClient, type Facet, type FilterInput, type FormChallenge, type FormProof, type Histogram, type HistogramBucket, type HistoryChange, type HistoryPage, type InboxNotification, type InboxPage, type InvitationPreview, type InvitationSent, type InvokeOptions, type ListPage, type ListParams, type LiveChange, type LiveHandlers, type MapBounds, type MapBucket, type MapLayerModel, type MapParams, type MapResult, type MentionableUser, type Meta, type MetaResult, type NotificationHistoryClient, type Organization, type OrganizationInvitation, type OrganizationMember, type OrganizationPerson, type OrganizationRole, type OrganizationsClient, type OrganizationsFound, type Passkey, type PersonStatus, type PlatformSignIn, type PluginRef, PreconditionFailedError, type PresenceChange, type PresenceEntry, type ProblemDetails, type ProblemError, type PublicForm, type RecordComment, type RecordOf, type RecordPermissions, type RecordPhotos, type RegisteredDevice, type RelatedLabels, type RequiredSetup, type ResourcePermissions, type ResourceRef, type RoleLabel, type RoleOption, type RolesClient, type RuntimeClient, type RuntimeClientOptions, type RuntimeLastUpdate, type RuntimePolicy, type RuntimeStatus, type RuntimeUpdateStage, type SamlSignIn, type Series, type SeriesParams, type SeriesPoint, type SetupStatus, type SignInMethod, type SignInPolicy, type SignInPolicyClient, type SignInPolicyState, type SignInResult, type SignInRule, type SocketLike, type SourceMeta, type SourceRef, type StaffAccessRule, type StaffSignIn, type StaffSignInClient, type StatusClient, type StatusInput, type Stored, type StoredFile, type StoredFileVariant, type TwoFactorMethod, type UploadOptions, type UploadProgress, type UploadResult, type UserInvitation, type UserInvitationSent, type UsersClient, type UsersFound, type WebDeviceRegistration, availabilities, createAssistantClient, createAuthSession, createClient, createRuntimeClient, createStaticSession, fileUrl, filterText, heldStatus, isApiError, listWire, maxStatusText, routedClient, sourceMeta, statusTextProblem, tokenExpiry };
+export { type AccountSecurity, type AccountSignIn, type ActiveRole, type Aggregate, type AggregateGroup, type AggregateParams, type AggregateSplitTotal, ApiError, type AppUser, type AssistantClient, type AssistantClientOptions, type AssistantConnection, AuthError, type AuthSession, type AuthSessionOptions, type AuthUser, type AuthenticatorSetup, type Availability, type BatchOp, type BatchRef, type BatchResult, type Channel, type ChannelError, type ChannelMessage, ChannelRefusal, type ChannelStatus, type ChannelUser, type Client, type ClientOptions, type CommentPage, type CommentPerson, type ConnectClient, type ConnectedApp, type ConnectingClient, type CurrentOrganization, type DeviceSession, type DevicesClient, type Facet, type FilterInput, type FormChallenge, type FormProof, type Histogram, type HistogramBucket, type HistoryChange, type HistoryPage, type InboxNotification, type InboxPage, type InvitationPreview, type InvitationSent, type InvokeOptions, type ListPage, type ListParams, type LiveChange, type LiveHandlers, type MapBounds, type MapBucket, type MapLayerModel, type MapParams, type MapResult, type MentionableUser, type Meta, type MetaResult, type NotificationHistoryClient, type Organization, type OrganizationInvitation, type OrganizationMember, type OrganizationPerson, type OrganizationRole, type OrganizationsClient, type OrganizationsFound, type Passkey, type PersonStatus, type PlatformSignIn, type PluginRef, PreconditionFailedError, type PresenceChange, type PresenceEntry, type ProblemDetails, type ProblemError, type PublicForm, type RecordCall, type RecordCallsHandlers, type RecordComment, type RecordOf, type RecordPermissions, type RecordPhotos, type RegisteredDevice, type RelatedLabels, type RequiredSetup, type ResourcePermissions, type ResourceRef, type RoleLabel, type RoleOption, type RolesClient, type RuntimeClient, type RuntimeClientOptions, type RuntimeLastUpdate, type RuntimePolicy, type RuntimeStatus, type RuntimeUpdateStage, type SamlSignIn, type Series, type SeriesParams, type SeriesPoint, type SetupStatus, type SignInMethod, type SignInPolicy, type SignInPolicyClient, type SignInPolicyState, type SignInResult, type SignInRule, type SocketLike, type SourceMeta, type SourceRef, type StaffAccessRule, type StaffSignIn, type StaffSignInClient, type StatusClient, type StatusInput, type Stored, type StoredFile, type StoredFileVariant, type TwoFactorMethod, type UploadOptions, type UploadProgress, type UploadResult, type UserInvitation, type UserInvitationSent, type UsersClient, type UsersFound, type WebDeviceRegistration, availabilities, createAssistantClient, createAuthSession, createClient, createRuntimeClient, createStaticSession, fileUrl, filterText, heldStatus, isApiError, listWire, maxStatusText, routedClient, sourceMeta, statusTextProblem, tokenExpiry };

package/dist/record-calls.d.ts

@@ -0,0 +1,26 @@
+import "./types.js";
+import { KeyValue } from "@protobase/schema";
+//#region src/record-calls.d.ts
+/** A call on a record, as its readers see it: who started it, when, when it ended, who is in it and who was removed. */
+export type RecordCall = {
+  id: string;
+  started_by: string;
+  started_at: string;
+  /** `null` while it goes on. */
+  ended_at: string | null;
+  members: {
+    member: string;
+    joined_at: string;
+  }[];
+  removed: {
+    member: string;
+    removed_at: string;
+  }[];
+};
+export type RecordCallsHandlers = {
+  /** The record's latest calls, newest first, the one going on first: at once, then whenever they change. */
+  onCalls: (calls: RecordCall[]) => void;
+  /** The stream failed, with why, or ended (`undefined`); it is followed again after a pause. */
+  onRetry?: (error: unknown) => void;
+};
+//#endregion

package/dist/record-calls.js

@@ -0,0 +1,49 @@
+import { readEventStream } from "@protobase/schema/internal";
+//#region src/record-calls.ts
+const backoff = (attempt) => Math.min(3e4, 1e3 * 2 ** attempt);
+const pause = (ms, signal) => new Promise((resolve) => {
+	const timer = setTimeout(resolve, ms);
+	signal.addEventListener("abort", () => {
+		clearTimeout(timer);
+		resolve();
+	}, { once: true });
+});
+/** A record's calls, for whoever may read the record (`GET /api/{resource}/{key}:calls`). `path` names the record's calls. */
+const recordCallsClient = (send, path, retryDelay = backoff) => ({
+	/** The record's latest calls, newest first, the one going on first. */
+	calls: async (resource, key) => (await (await send({
+		method: "GET",
+		path: path(resource, key)
+	})).json()).items,
+	/** Follows the record's calls until the returned function is called; a stream that ends or fails is followed again. */
+	watchCalls: (resource, key, handlers) => {
+		const controller = new AbortController();
+		const { signal } = controller;
+		let failures = 0;
+		const follow = async () => {
+			const response = await send({
+				method: "GET",
+				path: path(resource, key),
+				query: "?watch=true",
+				headers: { accept: "text/event-stream" },
+				signal
+			});
+			if (!response.body) throw new Error("The server answered the calls stream without a body");
+			await readEventStream(response.body, (data) => {
+				failures = 0;
+				handlers.onCalls(JSON.parse(data).items);
+			}, signal);
+		};
+		(async () => {
+			while (!signal.aborted) {
+				const error = await follow().then(() => void 0, (reason) => reason);
+				if (signal.aborted) return;
+				handlers.onRetry?.(error);
+				await pause(retryDelay(failures++), signal);
+			}
+		})();
+		return () => controller.abort();
+	}
+});
+//#endregion
+export { recordCallsClient };

package/dist/routed-client.js

@@ -43,7 +43,9 @@ const routedClient = (own, sourceOf) => {
 		channel: (resource, key) => own.channel(resource, key),
 		devices: own.devices,
 		notifications: own.notifications,
-		status: own.status
+		status: own.status,
+		calls: (resource, key) => to(resource).calls(resource, key),
+		watchCalls: (resource, key, handlers) => to(resource).watchCalls(resource, key, handlers)
 	};
 };
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@protobase/client",
-  "version": "0.59.3",
+  "version": "0.60.1",
   "description": "Typed fetch client for the Protobase REST API.",
   "license": "Apache-2.0",
   "repository": {
@@ -31,8 +31,8 @@
   },
   "dependencies": {
     "@better-auth/passkey": "^1.7.12",
-    "@protobase/layout": "0.59.3",
-    "@protobase/schema": "0.59.3",
+    "@protobase/layout": "0.60.1",
+    "@protobase/schema": "0.60.1",
     "@simplewebauthn/browser": "^13.3.0",
     "better-auth": "^1.7.12"
   }