@q9labsai/chalk-client 5.2.1 → 5.2.2

package/dist/{chunk-TVNI2XUZ.js → chunk-AIJ5Z6HA.js}

@@ -249,8 +249,11 @@ var SAFE_REASONS = /* @__PURE__ */ new Set([
 function safeSyncCloseReason(reason) {
   return reason ? SAFE_REASONS.has(reason) ? reason : "redacted" : null;
 }
+function syncConnectFailureCode(diagnostic) {
+  return diagnostic?.stage === "upgrade" ? "sync_start_failed" : "sync_hello_timeout";
+}
 function formatSyncConnectDiagnostic(diagnostic) {
-  return `[${diagnostic.stage}; open=${diagnostic.opened ? 1 : 0}; close=${diagnostic.closeCode ?? "none"}; reason=${safeSyncCloseReason(diagnostic.closeReason ?? void 0) ?? "none"}; ${Math.round(diagnostic.durationMs)}ms]`;
+  return `[${diagnostic.stage}; open=${diagnostic.opened ? 1 : 0}; close=${diagnostic.closeCode ?? "none"}; reason=${safeSyncCloseReason(diagnostic.closeReason ?? void 0) ?? "none"}; ${diagnostic.stage === "upgrade" && diagnostic.closeCode !== null ? "cause=closed_before_open; " : ""}${diagnostic.attempt === void 0 ? "" : `attempt=${diagnostic.attempt}; `}${diagnostic.attempts === void 0 ? "" : `attempts=${diagnostic.attempts}; `}${Math.round(diagnostic.durationMs)}ms]`;
 }
 
 // src/sync/v1-health.ts
@@ -3024,10 +3027,11 @@ var V1SyncClient = class {
   #cancelDial;
   #dialTimeoutCount = 0;
   #connectStartedAt = null;
+  #connectAttemptCount = 0;
   #opened = false;
   #connectFailure;
   #connectDiagnostic() {
-    return { stage: this.#opened ? "hello" : "upgrade", opened: this.#opened, closeCode: null, closeReason: null, durationMs: Math.max(0, this.#clock().now() - (this.#connectStartedAt ?? this.#clock().now())) };
+    return { stage: this.#opened ? "hello" : "upgrade", opened: this.#opened, closeCode: null, closeReason: null, durationMs: Math.max(0, this.#clock().now() - (this.#connectStartedAt ?? this.#clock().now())), attempt: this.#connectAttemptCount };
   }
   #reconnectAttempt = 0;
   #episodeEndTimer;
@@ -3090,6 +3094,8 @@ var V1SyncClient = class {
   async start() {
     if (this.#started) return;
     this.#started = true;
+    this.#connectAttemptCount = 0;
+    this.#connectFailure = void 0;
     const startupGeneration = ++this.#startupGeneration;
     let stored;
     try {
@@ -3288,9 +3294,10 @@ var V1SyncClient = class {
   #connect() {
     if (!this.#started || !this.#transportAvailable || this.#socket || this.#phase.phase === "terminal") return;
     this.#phase = { phase: "connecting" };
+    this.#connectAttemptCount += 1;
     this.#connectStartedAt = this.#clock().now();
     this.#opened = false;
-    this.#connectFailure = void 0;
+    if (this.#connectFailure?.opened) this.#connectFailure = void 0;
     this.#emit();
     this.#entryNegotiated = false;
     let socket;
@@ -3299,7 +3306,7 @@ var V1SyncClient = class {
     } catch {
       this.#connectFailure = this.#connectDiagnostic();
       this.#emit();
-      throw new V1SyncError("Sync WebSocket could not be created", "sync_hello_timeout");
+      throw new V1SyncError("Sync WebSocket could not be created", "sync_start_failed");
     }
     const connectionGeneration = ++this.#connectionGeneration;
     this.#socket = socket;
@@ -3341,7 +3348,7 @@ var V1SyncClient = class {
     };
     socket.onerror = () => {
       if (socket === this.#socket && (this.#phase.phase === "connecting" || this.#phase.phase === "recovering")) {
-        this.#connectFailure = this.#connectDiagnostic();
+        this.#connectFailure ??= this.#connectDiagnostic();
         this.#emit();
       }
       socket.close(CLIENT_RESTART_CLOSE_CODE, "transport error");
@@ -4046,6 +4053,7 @@ function createV1SyncClient(options) {
 }
 
 export {
+  syncConnectFailureCode,
   formatSyncConnectDiagnostic,
   UuidSchema,
   ReactionValues,

package/dist/{chunk-RVUN6LW4.js → chunk-XPW3OCPO.js}

@@ -18,8 +18,9 @@ import {
   createBrowserWebSocketFactory,
   createV1SyncClient,
   formatSyncConnectDiagnostic,
-  scheduleSyncDialDeadline
-} from "./chunk-TVNI2XUZ.js";
+  scheduleSyncDialDeadline,
+  syncConnectFailureCode
+} from "./chunk-AIJ5Z6HA.js";
 
 // src/access/manager.ts
 import { Clock, Context, Data, Effect, Layer, SynchronizedRef } from "effect";
@@ -2551,7 +2552,7 @@ var ConnectionDiagnostics = class {
 
 // src/connection/lifecycle.ts
 var MEDIA_RECOVERY_TIMEOUT_MS = 6e4;
-var START_TIMEOUT_MS = 1e4;
+var START_TIMEOUT_MS = 3e4;
 var LEAVE_TIMEOUT_MS = 5e3;
 var RECOVERY_BUDGET_MS = 1e4;
 var MAX_RECOVERY_ATTEMPTS = 3;
@@ -2768,7 +2769,7 @@ var makeConnectionLifecycleLayerFromServices = (options) => Layer3.effect(
         const failure2 = snapshot.connection.connectFailure;
         if (failure2 && failure2 !== observedConnectFailure) {
           observedConnectFailure = failure2;
-          diagnostics.record({ event: "sync_connect_failed", state: model.state, epoch: model.epoch, code: "sync_hello_timeout", sync: failure2 });
+          diagnostics.record({ event: "sync_connect_failed", state: model.state, epoch: model.epoch, code: syncConnectFailureCode(failure2), sync: failure2 });
         }
         const count = snapshot.connection.dialTimeoutCount ?? 0;
         if (count > observedDialTimeouts) {
@@ -2844,7 +2845,7 @@ var makeConnectionLifecycleLayerFromServices = (options) => Layer3.effect(
       const span = diagnostics.startSpan({ step, state: model.state, epoch: model.epoch });
       return effect.pipe(
         Effect2.tap(() => Effect2.sync(() => span.end({ state: model.state, epoch: model.epoch, outcome: "succeeded" }))),
-        Effect2.tapError(() => Effect2.sync(() => span.end({ state: model.state, epoch: model.epoch, outcome: "failed" })))
+        Effect2.tapError((cause) => Effect2.sync(() => span.end({ state: model.state, epoch: model.epoch, outcome: "failed", code: failureFromCause(cause, "internal_error", "Connection step failed").code })))
       );
     };
     const confirmSyncEntry = (sync) => {
@@ -2921,7 +2922,7 @@ var makeConnectionLifecycleLayerFromServices = (options) => Layer3.effect(
         Effect2.matchEffect({
           onFailure: (cause) => Effect2.gen(function* () {
             stopStream(stream);
-            const failure2 = failureFromCause(cause, "sync_start_failed", "The Connection could not start");
+            const failure2 = failureFromCause(cause, "internal_error", "The Connection could not start");
             model.failure = toFailure(failure2);
             if (model.joinCancelled) {
               span.end({ state: model.state, epoch: model.epoch, outcome: "cancelled", code: "invalid_state" });
@@ -3584,9 +3585,11 @@ function syncTerminalFailure(snapshot) {
   return lifecycleFailure("sync_start_failed", true, "The Sync transport needs recovery");
 }
 function syncStartupFailure(snapshot) {
-  const sync = snapshot.connection.connectFailure ?? snapshot.connection.connectAttempt;
+  const evidence = snapshot.connection.connectFailure ?? snapshot.connection.connectAttempt;
+  const attempts = snapshot.connection.connectAttempt?.attempt;
+  const sync = evidence ? { ...evidence, ...attempts === void 0 ? {} : { attempts } } : void 0;
   const message = sync?.opened === false ? "Sync could not reach the call service" : "Sync could not connect";
-  return new ConnectionLifecycleFailure({ code: "sync_hello_timeout", recoverable: true, message: `${message}${sync ? ` ${formatSyncConnectDiagnostic(sync)}` : " before the startup deadline"}`, ...sync ? { sync: Object.freeze({ ...sync }) } : {} });
+  return new ConnectionLifecycleFailure({ code: syncConnectFailureCode(sync), recoverable: true, message: `${message}${sync ? ` ${formatSyncConnectDiagnostic(sync)}` : " before the startup deadline"}`, ...sync ? { sync: Object.freeze({ ...sync }) } : {} });
 }
 function syncAutoRecoverable(snapshot, failure2) {
   return failure2.recoverable && snapshot.connection.terminalReason !== "entry_timeout";
@@ -3631,6 +3634,7 @@ var INVALID_PAYLOAD_CODE_BY_ACTION = /* @__PURE__ */ new Map([
 ]);
 var MEDIA_TIMEOUT_FAILURE = { code: "media.timeout", recoverable: true, message: "Media did not respond in time. Try again." };
 var SYNC_FAILURES = /* @__PURE__ */ new Map([
+  ["sync_start_failed", { failure: { code: "connection.sync_start_failed", recoverable: true, message: "A connection to the call service could not be opened. Try again." } }],
   ["sync_hello_timeout", { failure: { code: "connection.sync_hello_timeout", recoverable: true, message: "Sync could not reach the call service. Try again." } }],
   ["not_live", { failure: { code: "connection.invalid_state", recoverable: true, message: "Wait for the call to connect, then try again." } }],
   ["signaling_timeout", { failure: MEDIA_TIMEOUT_FAILURE }],

package/dist/effect.js

@@ -17,7 +17,7 @@ import {
   makeSpaceClientCoreLayer,
   makeSpaceClientCoreLayerFromServices,
   makeSpaceStoreLayer
-} from "./chunk-RVUN6LW4.js";
+} from "./chunk-XPW3OCPO.js";
 import "./chunk-DWKTGBHR.js";
 import {
   APIKeyListSchema,
@@ -829,7 +829,7 @@ import {
   WhiteboardStorageUnavailableErrorWireSchema,
   createChalkEffectClient
 } from "./chunk-GA3JDPFI.js";
-import "./chunk-TVNI2XUZ.js";
+import "./chunk-AIJ5Z6HA.js";
 
 // src/space-client/effect.ts
 import { Context, Effect, Exit, Layer, Scope } from "effect";

package/dist/index.d.ts

@@ -6,3 +6,4 @@ export * from "./sync";
 export * from "./whiteboard";
 export * from "./public-invites";
 export { formatSyncConnectDiagnostic } from "./sync/connect-diagnostics";
+export { getConnectionFailureDetail } from "./space-client/failure-detail";

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   createSpaceClient,
   decodeWhiteboardV1ServerFrame,
   encodeWhiteboardV1ClientFrame
-} from "./chunk-RVUN6LW4.js";
+} from "./chunk-XPW3OCPO.js";
 import {
   CloudflareSFUClient,
   CloudflareSFUError,
@@ -69,7 +69,7 @@ import {
   optimisticV1Control,
   reactionFromFrame,
   restoreV1Snapshot
-} from "./chunk-TVNI2XUZ.js";
+} from "./chunk-AIJ5Z6HA.js";
 
 // src/space-client/reload-rejoin.ts
 import { Schema } from "effect";
@@ -115,6 +115,23 @@ function reloadRejoinAccess(access) {
   const parsed = parseParsedAccessGrant(access);
   return { tenantId: parsed.subject.tenantId, episodeId: parsed.subject.episodeId, participantId: parsed.subject.participantId, participantGeneration: parsed.subject.participantGeneration, mediaProof: parsed.media.token };
 }
+
+// src/space-client/failure-detail.ts
+var DEFAULT_FAILURE_DETAIL = "Something went wrong while joining. Try again.";
+var FAILURE_DETAILS = {
+  "access.invalid": "Access to this call was rejected. Refresh the page and try again.",
+  "access.unavailable": "Couldn\u2019t get access to the call. Try again.",
+  "connection.sync_start_failed": "Couldn\u2019t reach the call service. Try again.",
+  "connection.sync_hello_timeout": "The call service did not respond in time. Try again.",
+  "connection.sync_recovery_exhausted": "The call connection could not recover. Try again.",
+  "connection.media_start_failed": "Audio and video could not connect. Try again.",
+  "connection.media_recovery_exhausted": "Audio and video could not reconnect. Try again.",
+  "environment.unsupported": "This device cannot start the call. Use an up-to-date browser over HTTPS, or update the app."
+};
+function getConnectionFailureDetail({ code, sync }) {
+  if (sync?.stage === "upgrade") return sync.closeCode !== null ? "The connection closed before the call service could be reached. Try again." : "A connection to the call service could not be opened. Try again.";
+  return (code && FAILURE_DETAILS[code]) ?? DEFAULT_FAILURE_DETAIL;
+}
 export {
   ArrivalInvalidHandleError,
   ArrivalUnavailableError,
@@ -166,6 +183,7 @@ export {
   encodeV1ClientFrame,
   encodeWhiteboardV1ClientFrame,
   formatSyncConnectDiagnostic,
+  getConnectionFailureDetail,
   optimisticV1Control,
   parseCloudflareSFUPublicationID,
   parseInviteCode,

package/dist/space-client/failure-detail.d.ts

@@ -0,0 +1,6 @@
+import type { ClientFailure, ErrorCode } from "./types";
+/** Safe, actionable failure copy shared by web and native call screens. */
+export declare function getConnectionFailureDetail({ code, sync }: {
+    readonly code?: ErrorCode;
+    readonly sync?: ClientFailure["sync"];
+}): string;

package/dist/sync/connect-diagnostics.d.ts

@@ -5,6 +5,12 @@ export type SyncConnectDiagnostic = {
     readonly closeCode: number | null;
     readonly closeReason: string | null;
     readonly durationMs: number;
+    /** One-based socket attempt since Sync start; absent in older SDK evidence. */
+    readonly attempt?: number;
+    /** Total sockets started when the join failed, including a pending replacement. */
+    readonly attempts?: number;
 };
 export declare function safeSyncCloseReason(reason: string | undefined): string | null;
+/** Keep published error codes stable while separating upgrade from hello failures. */
+export declare function syncConnectFailureCode(diagnostic: SyncConnectDiagnostic | undefined): "sync_start_failed" | "sync_hello_timeout";
 export declare function formatSyncConnectDiagnostic(diagnostic: SyncConnectDiagnostic): string;

package/dist/sync/index.js

@@ -22,7 +22,7 @@ import {
   encodeV1ClientFrame,
   optimisticV1Control,
   restoreV1Snapshot
-} from "../chunk-TVNI2XUZ.js";
+} from "../chunk-AIJ5Z6HA.js";
 export {
   AsyncStorageV1PendingTargetStore,
   InMemoryV1PendingTargetStore,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@q9labsai/chalk-client",
-  "version": "5.2.1",
+  "version": "5.2.2",
   "license": "MIT",
   "repository": {
     "type": "git",