@venturewild/workspace 0.6.28 → 0.6.30

package/server/src/preview-rails.mjs

@@ -0,0 +1,103 @@
+// PreviewRails — the shared-preview registry client on the rails (bmo-sync).
+//
+// WHY: a `pv-<token>` link must route, through bmo-sync, back to the daemon of
+// the account that started the dev server. bmo-sync needs token→account so its
+// proxy forward path can find the right daemon, plus an optional shared-workspace
+// tag so collaborators can DISCOVER each other's live previews (membership-gated,
+// exactly like session-rails). This thin client publishes/heartbeats/retires the
+// token and lists previews — for the workspace (members) or for this account (the
+// owner's own devices). The local dev PORT never leaves this machine; the Node
+// server maps token→port locally (preview-proxy.mjs LocalPreviewRegistry).
+//
+// degrade-never-throw: every call fails soft (publish/heartbeat/retire → false;
+// lists → []), so the dev-port watcher keeps the LOCAL registry working — and the
+// owner's same-machine localhost fallback keeps working — when the rails are down,
+// the endpoint isn't deployed yet (Part D), or the install has no account.
+// Modeled on session-rails.mjs / canvas-rails.mjs.
+
+const DEFAULT_TIMEOUT_MS = 3000;
+
+export class PreviewRails {
+  constructor({
+    bmoSyncUrl,
+    accountToken,
+    timeoutMs = DEFAULT_TIMEOUT_MS,
+    fetchImpl = (...a) => globalThis.fetch(...a),
+  } = {}) {
+    this.bmoSyncUrl = bmoSyncUrl ? bmoSyncUrl.replace(/\/$/, '') : null;
+    this.accountToken = accountToken || null;
+    this.timeoutMs = timeoutMs;
+    this.fetchImpl = fetchImpl;
+    this.capable = Boolean(this.accountToken) && Boolean(this.bmoSyncUrl);
+  }
+
+  async _post(path, body) {
+    if (!this.capable) return null;
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+    if (timer.unref) timer.unref();
+    try {
+      const r = await this.fetchImpl(`${this.bmoSyncUrl}${path}`, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ account_token: this.accountToken, ...body }),
+        signal: ctrl.signal,
+      });
+      if (!r || !r.ok) return null;
+      return await r.json().catch(() => null);
+    } catch {
+      return null;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+
+  /**
+   * Publish (create-or-touch) a live preview. `slug` is the shared-workspace slug
+   * (or null for a personal/unshared preview). The dev port stays local.
+   * @returns {Promise<boolean>} true iff the rails accepted it.
+   */
+  async publish({ token, slug = null, label = null } = {}) {
+    const resp = await this._post('/api/preview/publish', { token, slug, label });
+    return Boolean(resp && resp.ok === true);
+  }
+
+  /** Refresh a preview's heartbeat (keeps it from auto-expiring). */
+  async heartbeat(token) {
+    const resp = await this._post('/api/preview/heartbeat', { token });
+    return Boolean(resp && resp.ok === true);
+  }
+
+  /** Retire a preview now (dev server stopped). Idempotent. */
+  async retire(token) {
+    const resp = await this._post('/api/preview/retire', { token });
+    return Boolean(resp && resp.ok === true);
+  }
+
+  /**
+   * List a shared workspace's live previews (membership-gated server-side).
+   * @returns {Promise<{ok:boolean, previews:Array}>} each:
+   *   {token,url,owner_account_id,owner_email,label,created_at,updated_at}
+   */
+  async listWorkspace(slug) {
+    const resp = await this._post('/api/preview/list', { slug });
+    if (!resp || resp.ok !== true) return { ok: false, previews: [] };
+    return { ok: true, previews: Array.isArray(resp.previews) ? resp.previews : [] };
+  }
+
+  /** List THIS account's own live previews (the owner's other devices). */
+  async listMine() {
+    const resp = await this._post('/api/preview/list-mine', {});
+    if (!resp || resp.ok !== true) return { ok: false, previews: [] };
+    return { ok: true, previews: Array.isArray(resp.previews) ? resp.previews : [] };
+  }
+}
+
+/** Build the rails client from server config (inert when not logged in). */
+export function createPreviewRails(config, fetchImpl) {
+  return new PreviewRails({
+    bmoSyncUrl: config?.bmoSyncServerUrl,
+    accountToken: config?.accountToken,
+    fetchImpl,
+  });
+}