@h-rig/collab-session-browser-plugin 0.0.6-alpha.158

package/README.md

@@ -0,0 +1 @@
+# @h-rig/collab-session-browser-plugin

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+export { COLLAB_SESSION_BROWSER_PLUGIN_NAME, collabSessionBrowserPlugin, createCollabSessionBrowserPlugin, } from "./plugin";
+export { default } from "./plugin";

package/dist/src/index.js

@@ -0,0 +1,88 @@
+// @bun
+// packages/collab-session-browser-plugin/src/plugin.ts
+import { fileURLToPath } from "url";
+import { definePlugin } from "@rig/core/config";
+import { defineCapability } from "@rig/core/capability";
+import {
+  COLLAB_SESSION_VIEWER_CAPABILITY
+} from "@rig/contracts";
+var COLLAB_SESSION_BROWSER_PLUGIN_NAME = "@rig/collab-session-browser-plugin";
+var DEFAULT_RELAY_URL = "wss://where.rig-does.work";
+var CollabSessionViewerCap = defineCapability(COLLAB_SESSION_VIEWER_CAPABILITY);
+var LOCAL_HOSTNAMES = { localhost: true, "127.0.0.1": true, "::1": true, "[::1]": true };
+function encodeBase64Url(bytes) {
+  return Buffer.from(bytes).toString("base64").replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
+}
+function normalizeRelayOrigin(relayUrl) {
+  let url;
+  try {
+    url = new URL(relayUrl);
+  } catch {
+    return { error: `Invalid relay URL: ${relayUrl}` };
+  }
+  let scheme;
+  switch (url.protocol) {
+    case "wss:":
+    case "https:":
+      scheme = "wss:";
+      break;
+    case "ws:":
+    case "http:":
+      scheme = "ws:";
+      break;
+    default:
+      return { error: `Unsupported relay URL scheme: ${url.protocol}` };
+  }
+  if (scheme === "ws:" && !LOCAL_HOSTNAMES[url.hostname]) {
+    return { error: "relay link must be wss:// (plain ws:// is only allowed for localhost)" };
+  }
+  const port = url.port ? `:${url.port}` : "";
+  return { origin: `${scheme}//${url.hostname}${port}` };
+}
+function formatCollabLink(relayUrl, roomId, key, writeToken) {
+  const normalized = normalizeRelayOrigin(relayUrl);
+  if ("error" in normalized)
+    throw new Error(normalized.error);
+  let secret = key;
+  if (writeToken) {
+    secret = new Uint8Array(key.byteLength + writeToken.byteLength);
+    secret.set(key, 0);
+    secret.set(writeToken, key.byteLength);
+  }
+  const keyText = encodeBase64Url(secret);
+  if (normalized.origin === DEFAULT_RELAY_URL)
+    return `${roomId}.${keyText}`;
+  const compact = normalized.origin.startsWith("wss://") ? normalized.origin.slice("wss://".length) : normalized.origin;
+  return `${compact}/r/${roomId}.${keyText}`;
+}
+var collabSessionBrowserPlugin = definePlugin({
+  name: COLLAB_SESSION_BROWSER_PLUGIN_NAME,
+  version: "0.0.0-alpha.1",
+  contributes: {
+    capabilities: [
+      CollabSessionViewerCap.provide(async () => {
+        return {
+          distDir() {
+            return fileURLToPath(new URL("../../collab-web/dist", import.meta.url));
+          },
+          formatViewerLink(input) {
+            return formatCollabLink(input.relayUrl, input.roomId, input.key, input.writeToken);
+          }
+        };
+      }, {
+        title: "Collab session browser viewer",
+        description: "Serve the collab-web live-session SPA (paste a roomId.key link \u2192 streaming transcript + tool cards + composer) and format shareable pi-wire viewer links."
+      })
+    ]
+  }
+});
+function createCollabSessionBrowserPlugin() {
+  return collabSessionBrowserPlugin;
+}
+var plugin_default = collabSessionBrowserPlugin;
+export {
+  plugin_default as default,
+  createCollabSessionBrowserPlugin,
+  collabSessionBrowserPlugin,
+  COLLAB_SESSION_BROWSER_PLUGIN_NAME
+};

package/dist/src/plugin.d.ts

@@ -0,0 +1,4 @@
+export declare const COLLAB_SESSION_BROWSER_PLUGIN_NAME = "@rig/collab-session-browser-plugin";
+export declare const collabSessionBrowserPlugin: import("@rig/core/config").RigPlugin;
+export declare function createCollabSessionBrowserPlugin(): import("@rig/core/config").RigPlugin;
+export default collabSessionBrowserPlugin;

package/dist/src/plugin.js

@@ -0,0 +1,88 @@
+// @bun
+// packages/collab-session-browser-plugin/src/plugin.ts
+import { fileURLToPath } from "url";
+import { definePlugin } from "@rig/core/config";
+import { defineCapability } from "@rig/core/capability";
+import {
+  COLLAB_SESSION_VIEWER_CAPABILITY
+} from "@rig/contracts";
+var COLLAB_SESSION_BROWSER_PLUGIN_NAME = "@rig/collab-session-browser-plugin";
+var DEFAULT_RELAY_URL = "wss://where.rig-does.work";
+var CollabSessionViewerCap = defineCapability(COLLAB_SESSION_VIEWER_CAPABILITY);
+var LOCAL_HOSTNAMES = { localhost: true, "127.0.0.1": true, "::1": true, "[::1]": true };
+function encodeBase64Url(bytes) {
+  return Buffer.from(bytes).toString("base64").replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
+}
+function normalizeRelayOrigin(relayUrl) {
+  let url;
+  try {
+    url = new URL(relayUrl);
+  } catch {
+    return { error: `Invalid relay URL: ${relayUrl}` };
+  }
+  let scheme;
+  switch (url.protocol) {
+    case "wss:":
+    case "https:":
+      scheme = "wss:";
+      break;
+    case "ws:":
+    case "http:":
+      scheme = "ws:";
+      break;
+    default:
+      return { error: `Unsupported relay URL scheme: ${url.protocol}` };
+  }
+  if (scheme === "ws:" && !LOCAL_HOSTNAMES[url.hostname]) {
+    return { error: "relay link must be wss:// (plain ws:// is only allowed for localhost)" };
+  }
+  const port = url.port ? `:${url.port}` : "";
+  return { origin: `${scheme}//${url.hostname}${port}` };
+}
+function formatCollabLink(relayUrl, roomId, key, writeToken) {
+  const normalized = normalizeRelayOrigin(relayUrl);
+  if ("error" in normalized)
+    throw new Error(normalized.error);
+  let secret = key;
+  if (writeToken) {
+    secret = new Uint8Array(key.byteLength + writeToken.byteLength);
+    secret.set(key, 0);
+    secret.set(writeToken, key.byteLength);
+  }
+  const keyText = encodeBase64Url(secret);
+  if (normalized.origin === DEFAULT_RELAY_URL)
+    return `${roomId}.${keyText}`;
+  const compact = normalized.origin.startsWith("wss://") ? normalized.origin.slice("wss://".length) : normalized.origin;
+  return `${compact}/r/${roomId}.${keyText}`;
+}
+var collabSessionBrowserPlugin = definePlugin({
+  name: COLLAB_SESSION_BROWSER_PLUGIN_NAME,
+  version: "0.0.0-alpha.1",
+  contributes: {
+    capabilities: [
+      CollabSessionViewerCap.provide(async () => {
+        return {
+          distDir() {
+            return fileURLToPath(new URL("../../collab-web/dist", import.meta.url));
+          },
+          formatViewerLink(input) {
+            return formatCollabLink(input.relayUrl, input.roomId, input.key, input.writeToken);
+          }
+        };
+      }, {
+        title: "Collab session browser viewer",
+        description: "Serve the collab-web live-session SPA (paste a roomId.key link \u2192 streaming transcript + tool cards + composer) and format shareable pi-wire viewer links."
+      })
+    ]
+  }
+});
+function createCollabSessionBrowserPlugin() {
+  return collabSessionBrowserPlugin;
+}
+var plugin_default = collabSessionBrowserPlugin;
+export {
+  plugin_default as default,
+  createCollabSessionBrowserPlugin,
+  collabSessionBrowserPlugin,
+  COLLAB_SESSION_BROWSER_PLUGIN_NAME
+};

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@h-rig/collab-session-browser-plugin",
+  "version": "0.0.6-alpha.158",
+  "type": "module",
+  "description": "Owns the collab-web browser SPA as the collab-session-viewer surface: serve the live transcript viewer + format pi-wire roomId.key links.",
+  "license": "UNLICENSED",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/src/plugin.d.ts",
+      "import": "./dist/src/plugin.js"
+    }
+  },
+  "engines": {
+    "bun": ">=1.3.11"
+  },
+  "main": "./dist/src/index.js",
+  "module": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "dependencies": {
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.158",
+    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.158"
+  }
+}