@norskvideo/ctl-test-harness 0.1.9 → 0.1.10

package/container-net.js

@@ -1,6 +1,8 @@
 // Reach launched product instances by their norsk-net service DNS instead of a
-// host-published port. PROTOTYPE for dissolving the cross-product host-port
-// collision the release gate trips on.
+// host-published port. Dissolves the cross-product host-port collision the
+// release gate trips on. Consumed by the playout, funke, and commentary
+// integration harnesses (studioApiBase / mediaHttpBase / srtEgressUrl /
+// studioBaseFrom); commentary's WHIP path already reaches media directly.
 //
 // WHY host ports collide: in the docker-outside-of-docker CI runner the test
 // process is itself a container and studio/media run as HOST-sibling containers,

package/launch.d.ts

@@ -12,3 +12,13 @@ export declare function withContainerUser<T>(opts: T & {
 }): T & {
     containerUser?: string;
 };
+/** True when the resolved norsk-ctl CLI understands `--no-publish`. Memoised. */
+export declare function ctlSupportsNoPublish(): Promise<boolean>;
+/** In `direct` reach mode, ask the daemon to bind no host ports (`noPublish`) so
+ *  concurrent instances on a shared runner can't collide on the product's
+ *  host-port bands — but only when the resolved ctl supports the flag (see
+ *  {@link ctlSupportsNoPublish}). `publish` mode and an explicit `noPublish` pass
+ *  through untouched. Async because the capability probe is. */
+export declare function withNoPublish<T extends {
+    noPublish?: boolean;
+}>(opts: T): Promise<T>;

package/launch.js

@@ -9,6 +9,8 @@
 // This is the prevention half; @norskvideo/ctl-test-harness/daemon's
 // cleanupDaemon is the tolerance half (root-nuke on teardown). Pairing the two
 // is the harness's whole "launch clean, tear down clean" story.
+import { cliCommand } from "./cli-command.js";
+import { netReachMode } from "./container-net.js";
 /** The `uid:gid` the current process runs as, for docker `--container-user`, or
  *  undefined where POSIX uids don't exist (e.g. Windows, or Docker Desktop's VM
  *  which maps bind-mount ownership itself and needs no explicit spec). */
@@ -30,3 +32,40 @@ export function withContainerUser(opts) {
     const user = runnerContainerUser();
     return user === undefined ? opts : { ...opts, containerUser: user };
 }
+// The CLI is `.strict()`, so passing `--no-publish` to a norsk-ctl that predates
+// the flag aborts the launch with "Unknown argument". A newer product must still
+// launch on an older ctl (the contract's whole additive rule), so we probe the
+// resolved binary once and only emit the flag when it advertises it. On an old
+// ctl this silently no-ops (publish as today); when `latest` catches up the same
+// harness starts binding no host ports — no cross-repo release ordering to get
+// right. Cached: one `--help` spawn per process.
+let noPublishSupport;
+async function probeNoPublishSupport() {
+    try {
+        const proc = Bun.spawn([...cliCommand, "instance", "launch-template", "--help"], {
+            stdout: "pipe",
+            stderr: "pipe",
+        });
+        const [out, errText] = await Promise.all([new Response(proc.stdout).text(), new Response(proc.stderr).text()]);
+        await proc.exited;
+        return `${out}${errText}`.includes("--no-publish");
+    }
+    catch {
+        return false;
+    }
+}
+/** True when the resolved norsk-ctl CLI understands `--no-publish`. Memoised. */
+export function ctlSupportsNoPublish() {
+    noPublishSupport ??= probeNoPublishSupport();
+    return noPublishSupport;
+}
+/** In `direct` reach mode, ask the daemon to bind no host ports (`noPublish`) so
+ *  concurrent instances on a shared runner can't collide on the product's
+ *  host-port bands — but only when the resolved ctl supports the flag (see
+ *  {@link ctlSupportsNoPublish}). `publish` mode and an explicit `noPublish` pass
+ *  through untouched. Async because the capability probe is. */
+export async function withNoPublish(opts) {
+    if (opts.noPublish !== undefined || netReachMode() !== "direct")
+        return opts;
+    return (await ctlSupportsNoPublish()) ? { ...opts, noPublish: true } : opts;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-test-harness",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "type": "module",
   "exports": {
     "./daemon": {