@protobase/client 0.62.1 → 0.62.2

package/dist/calls/connection-stats.d.ts

@@ -0,0 +1,12 @@
+//#region src/calls/connection-stats.d.ts
+/**
+ * How one of the member's connections fares: to another member (`member`), or to the media server (no `member`). Its
+ * state, and once connected, the round trip of its network path and the share of the media it received that was lost.
+ */
+export type CallConnection = {
+  member?: string;
+  state: RTCPeerConnectionState;
+  roundTripMs?: number;
+  lostRatio?: number;
+};
+//#endregion

package/dist/calls/connection-stats.js

@@ -0,0 +1,31 @@
+//#region src/calls/connection-stats.ts
+/** What `connectionOf` reads of a connection's stats: the selected candidate pair's round trip, and the received media's losses. */
+const statsOf = (report) => {
+	const stats = [...report];
+	const transport = stats.find((stat) => stat.type === "transport" && typeof stat.selectedCandidatePairId === "string");
+	const pair = stats.find((stat) => stat.type === "candidate-pair" && (stat.id === transport?.selectedCandidatePairId || !transport && stat.selected === true || !transport && stat.nominated === true && stat.state === "succeeded"));
+	let lost = 0;
+	let received = 0;
+	for (const stat of stats) {
+		if (stat.type !== "inbound-rtp") continue;
+		lost += Math.max(0, Number(stat.packetsLost ?? 0));
+		received += Number(stat.packetsReceived ?? 0);
+	}
+	const roundTrip = typeof pair?.currentRoundTripTime === "number" ? pair.currentRoundTripTime * 1e3 : void 0;
+	return {
+		...roundTrip !== void 0 && { roundTripMs: roundTrip },
+		...lost + received > 0 && { lostRatio: lost / (lost + received) }
+	};
+};
+/** How the connection fares now, as `CallConnection`. */
+const connectionOf = async (pc, member) => {
+	const state = pc.connectionState;
+	const report = state === "connected" ? statsOf((await pc.getStats()).values()) : {};
+	return {
+		...member !== void 0 && { member },
+		state,
+		...report
+	};
+};
+//#endregion
+export { connectionOf, statsOf };

package/dist/calls/index.d.ts

@@ -1,4 +1,6 @@
+import { CallConnection } from "./connection-stats.js";
 import { CallTrack, PublishOptions } from "./media-link.js";
 import { Call, CallState, JoinCallOptions, joinCall } from "./join-call.js";
+import { PublishRefused } from "./publish-refused.js";
 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 };
+export { type Call, type CallConnection, type CallLeftReason, type CallMode, type CallRosterMember, type CallState, type CallTrack, type CallTrackSource, type JoinCallOptions, type PublishOptions, PublishRefused, joinCall };

package/dist/calls/index.js

@@ -1,2 +1,3 @@
+import { PublishRefused } from "./publish-refused.js";
 import { joinCall } from "./join-call.js";
-export { joinCall };
+export { PublishRefused, joinCall };

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

@@ -1,3 +1,4 @@
+import { CallConnection } from "./connection-stats.js";
 import { CallTrack, PublishOptions } from "./media-link.js";
 import { CallLeftReason, CallRosterMember, CallTrackSource } from "@protobase/schema/internal";
 //#region src/calls/join-call.d.ts
@@ -59,6 +60,8 @@ export type Call = {
   leave: () => void;
   /** The tracks of other members the member hears now. */
   tracks: () => CallTrack[];
+  /** How each of the member's connections fares now: to each other member, or to the media server. */
+  connections: () => Promise<CallConnection[]>;
 };
 /**
  * Joins a call through the app's function socket and resolves once the member is in it. Media flows over plain

package/dist/calls/join-call.js

@@ -181,7 +181,8 @@ const joinCall = (options) => {
 			send({ type: "leave" });
 			end("ended");
 		},
-		tracks: () => remote
+		tracks: () => remote,
+		connections: async () => link ? link.connections() : []
 	};
 	setState({ state: "connecting" });
 	connect("join");

package/dist/calls/peer-link.js

@@ -1,10 +1,20 @@
+import { PublishRefused } from "./publish-refused.js";
 import { createPeerConnection } from "./media-link.js";
+import { connectionOf } from "./connection-stats.js";
 import { midsByStreamId } from "./msid-tracks.js";
 //#region src/calls/peer-link.ts
+const firefoxMade = (sdp) => /^o=mozilla/m.test(sdp);
+const inFirefox = typeof navigator !== "undefined" && /Firefox\//.test(navigator.userAgent);
+/**
+* Who gives way when this side's offer crosses the other's: Firefox, when only one of the two is, since an offer
+* Chromium rolls back for Firefox's leaves their header extension ids clashing and Chromium's next offer fails;
+* otherwise the member whose id sorts first.
+*/
+const politeTo = (peer, offer) => inFirefox === firefoxMade(offer) ? peer.polite : inFirefox;
 /**
 * 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
+* whose id sorts first gives way when both offer at once, or Firefox to Chromium) and says who is in the call and which tracks each member
 * 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 }) => {
@@ -72,7 +82,7 @@ const peerLink = (self, { iceServers, send, onTracks, createPeerConnection: crea
 		const { pc } = peer;
 		if (description) {
 			const collision = description.type === "offer" && (peer.makingOffer || pc.signalingState !== "stable");
-			peer.ignoreOffer = !peer.polite && collision;
+			peer.ignoreOffer = !politeTo(peer, description.sdp) && collision;
 			if (peer.ignoreOffer) return;
 			await pc.setRemoteDescription(description);
 			if (description.type === "offer") {
@@ -106,7 +116,7 @@ const peerLink = (self, { iceServers, send, onTracks, createPeerConnection: crea
 				publishing?.resolve();
 				return;
 			case "publish-refused":
-				publishing?.reject(new Error(message.reason));
+				publishing?.reject(new PublishRefused(message.reason));
 				return;
 		}
 	};
@@ -192,6 +202,7 @@ const peerLink = (self, { iceServers, send, onTracks, createPeerConnection: crea
 			track,
 			simulcast: false
 		}])),
+		connections: () => Promise.all([...peers].map(([member, peer]) => connectionOf(peer.pc, member))),
 		close: () => {
 			publishing?.reject(/* @__PURE__ */ new Error("The call ended"));
 			for (const member of [...peers.keys()]) disconnect(member);

package/dist/calls/publish-refused.d.ts

@@ -0,0 +1,6 @@
+//#region src/calls/publish-refused.d.ts
+/** The server refused tracks the member may not send, such as a camera for a member who may only listen. */
+export declare class PublishRefused extends Error {
+  constructor(reason: string);
+}
+//#endregion

package/dist/calls/publish-refused.js

@@ -0,0 +1,10 @@
+//#region src/calls/publish-refused.ts
+/** The server refused tracks the member may not send, such as a camera for a member who may only listen. */
+var PublishRefused = class extends Error {
+	constructor(reason) {
+		super(reason);
+		this.name = "PublishRefused";
+	}
+};
+//#endregion
+export { PublishRefused };

package/dist/calls/sfu-link.js

@@ -1,4 +1,6 @@
+import { PublishRefused } from "./publish-refused.js";
 import { createPeerConnection } from "./media-link.js";
+import { connectionOf } from "./connection-stats.js";
 import { negotiation } from "./negotiation.js";
 //#region src/calls/sfu-link.ts
 const simulcastLayers = [
@@ -156,7 +158,7 @@ const sfuLink = ({ iceServers, send, onTracks, onUnpublished, createPeerConnecti
 				publishing?.resolve(message.tracks);
 				return;
 			case "publish-refused":
-				publishing?.reject(new Error(message.reason));
+				publishing?.reject(new PublishRefused(message.reason));
 				return;
 		}
 	};
@@ -250,6 +252,7 @@ const sfuLink = ({ iceServers, send, onTracks, onUnpublished, createPeerConnecti
 			track: track.track,
 			simulcast: track.simulcast
 		}])),
+		connections: async () => [await connectionOf(pc)],
 		close: () => {
 			publishing?.reject(/* @__PURE__ */ new Error("The call ended"));
 			offers.reset();

package/dist/client.d.ts

@@ -121,6 +121,10 @@ export declare const createClient: (options?: ClientOptions) => {
   };
   calls: (resource: ResourceRef, key: KeyValue | readonly KeyValue[]) => Promise<RecordCall[]>;
   watchCalls: (resource: ResourceRef, key: KeyValue | readonly KeyValue[], handlers: RecordCallsHandlers) => () => void;
+  rings: {
+    list: () => Promise<import("@protobase/schema/internal").CallRing[]>;
+    decline: (call: string) => Promise<void>;
+  };
 };
 export type Client = ReturnType<typeof createClient>;
 //#endregion

package/dist/client.js

@@ -9,6 +9,7 @@ import { devicesClient } from "./devices.js";
 import { statusClient } from "./status.js";
 import { notificationHistoryClient } from "./notification-history.js";
 import { recordCallsClient } from "./record-calls.js";
+import { ringsClient } from "./rings.js";
 import { encodeKey } from "@protobase/schema/internal";
 //#region src/client.ts
 const nameOf = (resource) => typeof resource === "string" ? resource : resource.toModel().name;
@@ -473,7 +474,8 @@ const createClient = (options = {}) => {
 		notifications,
 		status: statusClient(send),
 		calls,
-		watchCalls
+		watchCalls,
+		rings: ringsClient(send)
 	};
 };
 //#endregion

package/dist/index.d.ts

@@ -11,6 +11,7 @@ import { UploadProgress } from "./upload-request.js";
 import { LiveChange, LiveHandlers } from "./live.js";
 import { Client, InvokeOptions, UploadOptions, UploadResult, createClient } from "./client.js";
 import { Availability, PersonStatus, StatusClient, StatusInput } from "./status.js";
+import { CallRing, RingsClient } from "./rings.js";
 import { ApiError, PreconditionFailedError, ProblemDetails, ProblemError, isApiError } from "./problem.js";
 import { fileUrl } from "./file-urls.js";
 import { routedClient } from "./routed-client.js";
@@ -30,4 +31,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 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 };
+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 CallRing, 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 RingsClient, 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/rings.d.ts

@@ -0,0 +1,14 @@
+import { Transport } from "./transport.js";
+import { CallRing, CallRing as CallRing$1 } from "@protobase/schema/internal";
+//#region src/rings.d.ts
+/**
+ * The calls that ring the signed-in user (`/api/calls/rings`), in an app with calls: `list` those ringing them now,
+ * newest first, and `decline` stops one ringing them on every page they have open. Joining the call stops it too.
+ */
+export declare const ringsClient: (send: Transport) => {
+  list: () => Promise<CallRing[]>;
+  decline: (call: string) => Promise<void>;
+};
+export type RingsClient = ReturnType<typeof ringsClient>;
+//#endregion
+export type { CallRing$1 as CallRing };

package/dist/rings.js

@@ -0,0 +1,23 @@
+import { ringsPath } from "@protobase/schema/internal";
+//#region src/rings.ts
+/**
+* The calls that ring the signed-in user (`/api/calls/rings`), in an app with calls: `list` those ringing them now,
+* newest first, and `decline` stops one ringing them on every page they have open. Joining the call stops it too.
+*/
+const ringsClient = (send) => ({
+	list: async () => (await (await send({
+		method: "GET",
+		path: ringsPath(""),
+		system: true
+	})).json()).items,
+	decline: async (call) => {
+		await send({
+			method: "POST",
+			path: ringsPath("", { decline: call }),
+			system: true,
+			body: {}
+		});
+	}
+});
+//#endregion
+export { ringsClient };

package/dist/routed-client.js

@@ -44,6 +44,7 @@ const routedClient = (own, sourceOf) => {
 		devices: own.devices,
 		notifications: own.notifications,
 		status: own.status,
+		rings: own.rings,
 		calls: (resource, key) => to(resource).calls(resource, key),
 		watchCalls: (resource, key, handlers) => to(resource).watchCalls(resource, key, handlers)
 	};

package/dist/types.d.ts

@@ -285,6 +285,7 @@ export type Meta = {
     webPushKey?: string;
   };
   status?: true;
+  calls?: true;
   locale?: 'en' | 'nl';
   files?: {
     trustedHosts: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@protobase/client",
-  "version": "0.62.1",
+  "version": "0.62.2",
   "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.62.1",
-    "@protobase/schema": "0.62.1",
+    "@protobase/layout": "0.62.2",
+    "@protobase/schema": "0.62.2",
     "@simplewebauthn/browser": "^13.3.0",
     "better-auth": "^1.7.12"
   }