@ai-matrx/desktop-protocol 0.5.0 → 0.7.0

package/dist/index.cjs

@@ -23,6 +23,7 @@ __export(src_exports, {
   AbsPath: () => AbsPath,
   BEARER_PREFIX: () => BEARER_PREFIX,
   BROADCAST_CID: () => BROADCAST_CID,
+  CLOSE_RULES: () => CLOSE_RULES,
   CancelMsg: () => CancelMsg,
   ClientToCoreMsg: () => ClientToCoreMsg,
   ClientType: () => ClientType,
@@ -100,6 +101,7 @@ __export(src_exports, {
   HelloMsg: () => HelloMsg,
   Limits: () => Limits,
   NAMED_SCHEMAS: () => NAMED_SCHEMAS,
+  NULL_SINCE: () => NULL_SINCE,
   OPS: () => OPS,
   OpDescriptor: () => OpDescriptor,
   OsPermissionName: () => OsPermissionName,
@@ -146,7 +148,9 @@ __export(src_exports, {
   SysinfoGetResult: () => SysinfoGetResult,
   VERSIONED_RESULT_OPS: () => VERSIONED_RESULT_OPS,
   Welcome: () => Welcome,
+  announcedVersion: () => announcedVersion,
   assertFrameHeader: () => assertFrameHeader,
+  closeRule: () => closeRule,
   compareVersions: () => compareVersions,
   connectionEndFrame: () => connectionEndFrame,
   decodeFrame: () => decodeFrame,
@@ -156,12 +160,15 @@ __export(src_exports, {
   hasFlag: () => hasFlag,
   isConnectionEnd: () => isConnectionEnd,
   isDesktopProtocolError: () => isDesktopProtocolError,
+  isTerminalClose: () => isTerminalClose,
   knows: () => knows,
   negotiate: () => negotiate,
   nonNegInt: () => nonNegInt,
   readCid: () => readCid,
   stampCid: () => stampCid,
-  u32: () => u32
+  statusForPeer: () => statusForPeer,
+  u32: () => u32,
+  versionSubprotocol: () => versionSubprotocol
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -805,7 +812,11 @@ var SessionControlChangedEvent = import_zod8.z.strictObject({ controller_client_
 var import_zod9 = require("zod");
 var RelayDeviceStatusEvent = import_zod9.z.strictObject({
   online: import_zod9.z.boolean(),
-  since_ms: epochMs,
+  /**
+   * When the device last went online/offline; null = it has never connected (since 1.1 —
+   * NULL_SINCE: a 1.0 reader is sent 0, its old meaning).
+   */
+  since_ms: epochMs.nullable(),
   app_version: import_zod9.z.string().max(32).nullable(),
   protocol_version: ProtocolVersion.nullable()
 });
@@ -992,6 +1003,24 @@ var FIELDS_SINCE = {
   "RelayCallResponse|0": { protocol_version: "1.1" },
   "RelayCallResponse|1": { protocol_version: "1.1" }
 };
+var NULL_SINCE = {
+  "RelayDeviceStatusEvent.since_ms": { since: "1.1", olderPeersGet: 0 }
+};
+function statusForPeer(status, version) {
+  const rule = NULL_SINCE["RelayDeviceStatusEvent.since_ms"];
+  return status.since_ms === null && !knows(version, rule.since) ? { ...status, since_ms: rule.olderPeersGet } : status;
+}
+function versionSubprotocol(version) {
+  return `matrx.v${version}`;
+}
+function announcedVersion(offered) {
+  let best = `${PROTOCOL_MAJOR}.0`;
+  for (const p of offered) {
+    const m = /^matrx\.v(\d+\.\d+)$/.exec(p.trim());
+    if (m?.[1] && compareVersions(m[1], best) > 0 && m[1].startsWith(`${PROTOCOL_MAJOR}.`)) best = m[1];
+  }
+  return best;
+}
 function compareVersions(a, b) {
   const [am = 0, an = 0] = a.split(".").map(Number);
   const [bm = 0, bn = 0] = b.split(".").map(Number);
@@ -1029,4 +1058,30 @@ function forPeer(op, part, value, version) {
   return data === body.data ? value : { ...body, data };
 }
 var VERSIONED_RESULT_OPS = [...RESULT_PATH.keys()];
+
+// src/close-policy.ts
+var CLOSE_RULES = {
+  [CloseCode.NORMAL]: { action: "reconnect", error: ["DEVICE_OFFLINE", "Connection closed"] },
+  [CloseCode.GOING_AWAY]: { action: "reconnect_now", error: ["DEVICE_OFFLINE", "Connection lost"] },
+  [CloseCode.ABNORMAL]: { action: "reconnect_now", error: ["DEVICE_OFFLINE", "Connection lost"] },
+  [CloseCode.DEVICE_RECONNECTED]: { action: "reconnect_now", error: ["DEVICE_OFFLINE", "Device reconnected"] },
+  [CloseCode.TRY_AGAIN_LATER]: { action: "reconnect", error: ["DEVICE_OFFLINE", "Relay busy; retrying"] },
+  [CloseCode.AUTH_INVALID]: { action: "reauth", outcome: "signed_out", error: ["AUTH_INVALID", "Sign-in was not accepted"] },
+  [CloseCode.AUTH_FORBIDDEN]: { action: "stop", outcome: "not_owned", error: ["AUTH_FORBIDDEN", "Not this device's owner"] },
+  [CloseCode.DEVICE_NOT_FOUND]: { action: "stop", outcome: "removed", error: ["NOT_FOUND", "Device not found"] },
+  [CloseCode.AUTH_EXPIRED]: { action: "reauth", outcome: "signed_out", error: ["AUTH_EXPIRED", "Sign-in expired"] },
+  [CloseCode.REPLACED]: { action: "stop", outcome: "replaced", error: ["CONFLICT", "Replaced by a newer connection"] },
+  [CloseCode.DEVICE_REVOKED]: { action: "stop", outcome: "revoked", error: ["AUTH_DEVICE_REVOKED", "This device was revoked"] },
+  // A malformed message, or a connection the relay lost track of: a fresh socket starts clean.
+  [CloseCode.PROTOCOL_ERROR]: { action: "reconnect", error: ["PROTOCOL_ERROR", "Connection reset by the relay"] },
+  [CloseCode.UPGRADE_REQUIRED]: { action: "stop", outcome: "upgrade_required", error: ["PROTOCOL_VERSION_UNSUPPORTED", "Protocol upgrade required"] }
+};
+var UNKNOWN = { action: "reconnect", error: ["DEVICE_OFFLINE", "Connection lost"] };
+function closeRule(code) {
+  if (code === null || code === void 0) return CLOSE_RULES[CloseCode.ABNORMAL];
+  return CLOSE_RULES[code] ?? UNKNOWN;
+}
+function isTerminalClose(code) {
+  return closeRule(code).action === "stop";
+}
 //# sourceMappingURL=index.cjs.map