@norskvideo/ctl-dev-kit 0.1.35 → 0.1.36

package/conventions/publish-docs.yml

@@ -104,6 +104,11 @@ jobs:
           # reaches host-published ports via the host-gateway alias, not
           # localhost — same as the integration suite.
           NORSK_TEST_HOST: host.docker.internal
+          # Reach launched instances over norsk-net by service DNS (as the
+          # integration tier already does) AND, on a ctl that supports it, launch
+          # them binding no host ports — so concurrent doc-guide instances can't
+          # collide on the product's deterministic host-port bands.
+          NORSK_TEST_NET: direct
         run: |
           nix develop .#build --command bash -c '
             set -euo pipefail

package/doc-guide/instance-proxy.d.ts

@@ -13,4 +13,13 @@ export declare function startInstanceProxy(opts: {
     studioHostPort: number;
     instanceId: string;
     dashboardKey: string;
+    /** Explicit upstream studio endpoint. When set, the proxy forwards here
+     *  instead of `NORSK_TEST_HOST:studioHostPort` — a `noPublish` instance binds
+     *  no host port, so the caller supplies its `norsk-net` reach
+     *  (`<id>-studio-1:8000`) via `resolveEndpoint`. Omitted = today's
+     *  host-published behaviour. */
+    upstream?: {
+        host: string;
+        port: number;
+    };
 }): InstanceProxy;

package/doc-guide/instance-proxy.js

@@ -27,8 +27,10 @@ export function startInstanceProxy(opts) {
     // (host.docker.internal), mirroring @norskvideo/ctl-test-harness's STUDIO_HOST.
     // Without this the proxy's own fetch/WebSocket dials localhost inside the
     // runner container and ConnectionRefuses, so the baked dashboard never loads.
-    const upstreamHost = process.env.NORSK_TEST_HOST ?? "localhost";
-    const httpUpstream = `http://${upstreamHost}:${opts.studioHostPort}`;
+    // An explicit `upstream` (direct/noPublish mode) overrides both.
+    const upstreamHost = opts.upstream?.host ?? process.env.NORSK_TEST_HOST ?? "localhost";
+    const upstreamPort = opts.upstream?.port ?? opts.studioHostPort;
+    const httpUpstream = `http://${upstreamHost}:${upstreamPort}`;
     const strip = (pathname) => pathname === prefix ? "/" : pathname.startsWith(`${prefix}/`) ? pathname.slice(prefix.length) : pathname;
     const server = Bun.serve({
         port: 0,
@@ -36,7 +38,7 @@ export function startInstanceProxy(opts) {
             const u = new URL(req.url);
             const path = strip(u.pathname);
             if (req.headers.get("upgrade")?.toLowerCase() === "websocket") {
-                const upstreamUrl = `ws://${upstreamHost}:${opts.studioHostPort}${path}${u.search}`;
+                const upstreamUrl = `ws://${upstreamHost}:${upstreamPort}${path}${u.search}`;
                 const ok = srv.upgrade(req, { data: { upstreamUrl, upstream: null, queue: [] } });
                 return ok ? undefined : new Response("ws upgrade failed", { status: 400 });
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-dev-kit",
-  "version": "0.1.35",
+  "version": "0.1.36",
   "type": "module",
   "exports": {
     "./package.json": "./package.json",