@superdoc-dev/cli 0.7.0-next.8 → 0.7.0-next.9

package/dist/index.js

@@ -19530,6 +19530,27 @@ function expectOptionalEnvVarName(value, path) {
   }
   return value;
 }
+function expectOptionalWebSocketParams(value, path) {
+  if (value == null)
+    return;
+  if (!isRecord3(value)) {
+    throw new CliError("VALIDATION_ERROR", `${path} must be an object of string key-value pairs.`);
+  }
+  const result = {};
+  for (const [key, val] of Object.entries(value)) {
+    if (key.trim().length === 0) {
+      throw new CliError("VALIDATION_ERROR", `${path} keys must be non-empty strings.`);
+    }
+    if (RESERVED_WEBSOCKET_PARAM_KEYS.has(key)) {
+      throw new CliError("VALIDATION_ERROR", `${path}.${key} is reserved; the collaboration token is set automatically from tokenEnv.`);
+    }
+    if (typeof val !== "string") {
+      throw new CliError("VALIDATION_ERROR", `${path}.${key} must be a string.`);
+    }
+    result[key] = val;
+  }
+  return result;
+}
 function parseOnMissing(value) {
   if (value == null)
     return;
@@ -19562,15 +19583,13 @@ function parseWebSocketInput(raw) {
   if ("token" in raw) {
     throw new CliError("VALIDATION_ERROR", "collaboration.token is not supported in v1; use collaboration.tokenEnv.");
   }
-  if ("params" in raw) {
-    throw new CliError("VALIDATION_ERROR", "collaboration.params is not supported in v1.");
-  }
   const providerType = normalizeProviderType(raw.providerType, "collaboration.providerType");
   return {
     providerType,
     url: expectNonEmptyString(raw.url, "collaboration.url").trim(),
     documentId: raw.documentId != null ? expectNonEmptyString(raw.documentId, "collaboration.documentId") : undefined,
     tokenEnv: expectOptionalEnvVarName(raw.tokenEnv, "collaboration.tokenEnv"),
+    params: expectOptionalWebSocketParams(raw.params, "collaboration.params"),
     ...parseSharedFields(raw)
   };
 }
@@ -19588,7 +19607,7 @@ function parseLiveblocksInput(raw) {
     throw new CliError("VALIDATION_ERROR", "collaboration.token is not supported in v1.");
   }
   if ("params" in raw) {
-    throw new CliError("VALIDATION_ERROR", "collaboration.params is not supported in v1.");
+    throw new CliError("VALIDATION_ERROR", "collaboration.params is not supported for Liveblocks.");
   }
   if ("headers" in raw) {
     throw new CliError("VALIDATION_ERROR", "collaboration.headers is not supported; use authHeadersEnv for custom auth headers.");
@@ -19647,7 +19666,7 @@ function buildShorthandCollaborationInput(params) {
     ...params
   });
 }
-var DEFAULT_SHORTHAND_COLLABORATION_PROVIDER_TYPE = "y-websocket", WEBSOCKET_ALLOWED_KEYS, LIVEBLOCKS_ALLOWED_KEYS;
+var DEFAULT_SHORTHAND_COLLABORATION_PROVIDER_TYPE = "y-websocket", WEBSOCKET_ALLOWED_KEYS, RESERVED_WEBSOCKET_PARAM_KEYS, LIVEBLOCKS_ALLOWED_KEYS;
 var init_parse = __esm(() => {
   init_errors();
   init_guards();
@@ -19657,10 +19676,12 @@ var init_parse = __esm(() => {
     "url",
     "documentId",
     "tokenEnv",
+    "params",
     "syncTimeoutMs",
     "onMissing",
     "bootstrapSettlingMs"
   ]);
+  RESERVED_WEBSOCKET_PARAM_KEYS = new Set(["token"]);
   LIVEBLOCKS_ALLOWED_KEYS = new Set([
     "providerType",
     "roomId",
@@ -19680,6 +19701,7 @@ function resolveWebSocketProfile(input, sessionId) {
     url: input.url,
     documentId: input.documentId?.trim() || sessionId,
     tokenEnv: input.tokenEnv,
+    params: input.params,
     syncTimeoutMs: input.syncTimeoutMs,
     onMissing: input.onMissing,
     bootstrapSettlingMs: input.bootstrapSettlingMs
@@ -41219,9 +41241,13 @@ function createWebSocketRuntime(profile) {
   const syncTimeoutMs = profile.syncTimeoutMs ?? DEFAULT_SYNC_TIMEOUT_MS;
   let provider;
   if (profile.providerType === "y-websocket") {
-    const providerOptions = {};
+    const params3 = { ...profile.params ?? {} };
     if (token) {
-      providerOptions.params = { token };
+      params3.token = token;
+    }
+    const providerOptions = {};
+    if (Object.keys(params3).length > 0) {
+      providerOptions.params = params3;
     }
     provider = new WebsocketProvider(profile.url, profile.documentId, ydoc, providerOptions);
   } else {
@@ -41230,6 +41256,7 @@ function createWebSocketRuntime(profile) {
       document: ydoc,
       name: profile.documentId,
       token: token ?? "",
+      parameters: profile.params,
       preserveConnection: false
     });
   }
@@ -41356,6 +41383,21 @@ function normalizeSharedFields(record) {
     bootstrapSettlingMs: typeof record.bootstrapSettlingMs === "number" ? record.bootstrapSettlingMs : undefined
   };
 }
+function normalizeWebSocketParams(value) {
+  if (value == null)
+    return;
+  if (!isRecord3(value))
+    return null;
+  const result = {};
+  for (const [key, val] of Object.entries(value)) {
+    if (typeof key !== "string" || key.length === 0)
+      return null;
+    if (typeof val !== "string")
+      return null;
+    result[key] = val;
+  }
+  return result;
+}
 function normalizeWebSocketProfile(record) {
   const { providerType, url: url2, documentId, tokenEnv } = record;
   if (typeof url2 !== "string" || url2.length === 0)
@@ -41367,11 +41409,15 @@ function normalizeWebSocketProfile(record) {
   const shared = normalizeSharedFields(record);
   if (!shared)
     return;
+  const params3 = normalizeWebSocketParams(record.params);
+  if (params3 === null)
+    return;
   return {
     providerType,
     url: url2,
     documentId,
     tokenEnv: typeof tokenEnv === "string" ? tokenEnv : undefined,
+    params: params3,
     ...shared
   };
 }
@@ -374039,6 +374085,11 @@ var init_operation_params = __esm(() => {
                     description: "Room/document identifier. Defaults to session ID if omitted."
                   },
                   tokenEnv: { type: "string", description: "Environment variable name containing the auth token." },
+                  params: {
+                    type: "object",
+                    description: "Custom query parameters appended to the WebSocket URL. Values must be strings. Reserved keys: token.",
+                    additionalProperties: { type: "string" }
+                  },
                   syncTimeoutMs: { type: "number", description: "Max time (ms) to wait for initial sync." },
                   onMissing: {
                     type: "string",
@@ -374915,7 +374966,7 @@ function validateValueAgainstTypeSpec(value2, schema, path2) {
         throw new CliError("VALIDATION_ERROR", `${path2}.${key2} is required.`);
       }
     }
-    const propertyEntries = Object.entries(schema.properties);
+    const propertyEntries = schema.properties ? Object.entries(schema.properties) : [];
     const shouldRestrictUnknownKeys = propertyEntries.length > 0 || required.length > 0;
     if (shouldRestrictUnknownKeys) {
       const knownKeys = new Set(propertyEntries.map(([key2]) => key2));
@@ -374988,7 +375039,8 @@ function validateResponseValueAgainstTypeSpec(value2, schema, path2) {
         throw new CliError("VALIDATION_ERROR", `${path2}.${key2} is required.`);
       }
     }
-    for (const [key2, propSchema] of Object.entries(schema.properties)) {
+    const properties = schema.properties ?? {};
+    for (const [key2, propSchema] of Object.entries(properties)) {
       if (!Object.prototype.hasOwnProperty.call(value2, key2))
         continue;
       validateResponseValueAgainstTypeSpec(value2[key2], propSchema, `${path2}.${key2}`);
@@ -382733,9 +382785,16 @@ var init_version2 = () => {};
 
 // src/host/session-pool.ts
 import { createHash as createHash4 } from "node:crypto";
+function stableStringify4(value2) {
+  if (value2 === null || typeof value2 !== "object")
+    return JSON.stringify(value2);
+  if (Array.isArray(value2))
+    return `[${value2.map(stableStringify4).join(",")}]`;
+  const entries3 = Object.keys(value2).sort().map((key2) => `${JSON.stringify(key2)}:${stableStringify4(value2[key2])}`);
+  return `{${entries3.join(",")}}`;
+}
 function profileToFingerprint(profile) {
-  const sortedJson = JSON.stringify(profile, Object.keys(profile).sort());
-  return createHash4("sha256").update(sortedJson).digest("hex");
+  return createHash4("sha256").update(stableStringify4(profile)).digest("hex");
 }
 function createSessionLocks() {
   const locks = new Map;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli",
-  "version": "0.7.0-next.8",
+  "version": "0.7.0-next.9",
   "type": "module",
   "bin": {
     "superdoc": "./dist/index.js"
@@ -25,20 +25,20 @@
     "@types/ws": "^8.5.13",
     "typescript": "^5.9.2",
     "@superdoc/document-api": "0.0.1",
+    "@superdoc/pm-adapter": "0.0.0",
     "@superdoc/super-editor": "0.0.1",
-    "superdoc": "1.26.0",
-    "@superdoc/pm-adapter": "0.0.0"
+    "superdoc": "1.26.0"
   },
   "module": "src/index.ts",
   "publishConfig": {
     "access": "public"
   },
   "optionalDependencies": {
-    "@superdoc-dev/cli-darwin-arm64": "0.7.0-next.8",
-    "@superdoc-dev/cli-darwin-x64": "0.7.0-next.8",
-    "@superdoc-dev/cli-linux-x64": "0.7.0-next.8",
-    "@superdoc-dev/cli-windows-x64": "0.7.0-next.8",
-    "@superdoc-dev/cli-linux-arm64": "0.7.0-next.8"
+    "@superdoc-dev/cli-darwin-arm64": "0.7.0-next.9",
+    "@superdoc-dev/cli-darwin-x64": "0.7.0-next.9",
+    "@superdoc-dev/cli-linux-arm64": "0.7.0-next.9",
+    "@superdoc-dev/cli-linux-x64": "0.7.0-next.9",
+    "@superdoc-dev/cli-windows-x64": "0.7.0-next.9"
   },
   "scripts": {
     "predev": "node scripts/ensure-superdoc-build.js",