@norskvideo/ctl-dev-kit 0.1.35 → 0.1.37

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/local-dev/README.md

@@ -57,12 +57,12 @@ HARDWARE=none NORSK_LICENSE_FILE=... bun run iterate           # no GPU reservat
 To develop a product against **un-published** ctl code or a **locally-built**
 media server, there are three independent override layers. Each is opt-in and
 leaves the default (registry/pinned) path untouched when unset. They compose:
-changing the daemon *and* a ctl library it exposes means layers 1 + 3 together.
+changing the daemon _and_ a ctl library it exposes means layers 1 + 3 together.
 
 ## 1. The npm layer — local `@norskvideo/ctl-*` checkouts
 
 The product depends on `@norskvideo/ctl-{sdk,foundation,product-template-schema,
-oas-to-ts,test-harness,commands,dev-kit}` at a caret range. To point one (or all)
+test-harness,commands,dev-kit}` at a caret range. To point one (or all)
 at a local checkout of the ctl monorepo instead of the registry, use
 `dev-link.sh`:
 
@@ -119,9 +119,9 @@ bun run --cwd ../norsk-ctl cli product add --dev-url http://localhost:<backendPo
 bun run --cwd ../norsk-ctl cli instance launch-template demo --template <t> --hardware none
 ```
 
-No linking is needed for this — you are running the daemon *code* directly. Pair
+No linking is needed for this — you are running the daemon _code_ directly. Pair
 with layer 1 (`dev-link.sh`) only if you also changed a `@norskvideo/ctl-*`
-library the product *compiles* against.
+library the product _compiles_ against.
 
 ### Integration tests against source ctl
 

package/local-dev/dev-link.sh

@@ -8,7 +8,7 @@
 # Nothing is committed — the links live only in this repo's node_modules.
 set -euo pipefail
 
-PACKAGES=(sdk foundation product-template-schema oas-to-ts test-harness commands dev-kit)
+PACKAGES=(sdk foundation product-template-schema test-harness commands dev-kit)
 product_root="$(cd "$(dirname "${BASH_SOURCE[0]}")" && git -C . rev-parse --show-toplevel 2>/dev/null || pwd)"
 
 if [ "${1:-}" = "--unlink" ]; then

package/package.json

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