@norskvideo/ctl-sdk 0.1.23 → 0.1.24

package/docker-runner.d.ts

@@ -4,10 +4,17 @@ export declare const CONTAINER_INTERNAL_PORT = 4321;
  *  `norsk-ctl.role` label (proxy, proxy-oauth2, cpu-monitor, product); the
  *  value doubles as the card's component name. */
 export declare const PRODUCT_ROLE_LABEL = "norsk-ctl.role=product";
+/** How to place a product container. The network is the host's call: ctl puts
+ *  the control plane on the same bridge as nginx and every launched instance,
+ *  which is what makes it reachable from a daemon that is itself a container
+ *  (see product-reach.ts). Omitted leaves it on docker's default bridge. */
+export interface ProductRunOpts {
+    network?: string;
+}
 /** argv (sans leading "docker") that launches a product container: detached,
  *  auto-removed, loopback-published to its internal 4321, and role-labelled so
  *  it shows up in the Infrastructure tab. */
-export declare function productRunArgs(image: string, hostPort: number): string[];
+export declare function productRunArgs(image: string, hostPort: number, opts?: ProductRunOpts): string[];
 /** Stable container name for a product, derived from its manifest name, so
  *  `docker ps` shows `norsk-product-studio` instead of a random docker alias.
  *  Mirrors the singleton naming of norsk-proxy / norsk-ctl-cpu-monitor. */
@@ -16,7 +23,7 @@ export declare function productContainerName(productName: string): string;
  *  so there is nothing to refresh; a tag can move under a registration. */
 export declare function isDigestRef(image: string): boolean;
 export declare function dockerPull(image: string): Promise<void>;
-export declare function dockerRun(image: string, hostPort: number): Promise<string>;
+export declare function dockerRun(image: string, hostPort: number, opts?: ProductRunOpts): Promise<string>;
 /** The container's address on its first network (the default bridge for a
  *  product container), or undefined when docker cannot say. */
 export declare function dockerAddress(containerId: string): Promise<string | undefined>;

package/docker-runner.js

@@ -8,13 +8,14 @@ export const PRODUCT_ROLE_LABEL = "norsk-ctl.role=product";
 /** argv (sans leading "docker") that launches a product container: detached,
  *  auto-removed, loopback-published to its internal 4321, and role-labelled so
  *  it shows up in the Infrastructure tab. */
-export function productRunArgs(image, hostPort) {
+export function productRunArgs(image, hostPort, opts = {}) {
     return [
         "run",
         "-d",
         "--rm",
         "--label",
         PRODUCT_ROLE_LABEL,
+        ...(opts.network ? ["--network", opts.network] : []),
         "-p",
         `127.0.0.1:${hostPort}:${CONTAINER_INTERNAL_PORT}`,
         image,
@@ -43,8 +44,8 @@ export async function dockerPull(image) {
         throw new ProductError("DOCKER_PULL_FAILED", `docker pull failed (exit ${exitCode}): ${stderr || "no stderr"}`);
     }
 }
-export async function dockerRun(image, hostPort) {
-    const proc = Bun.spawn(["docker", ...productRunArgs(image, hostPort)], { stdout: "pipe", stderr: "pipe" });
+export async function dockerRun(image, hostPort, opts = {}) {
+    const proc = Bun.spawn(["docker", ...productRunArgs(image, hostPort, opts)], { stdout: "pipe", stderr: "pipe" });
     const exitCode = await proc.exited;
     const stdout = (await new Response(proc.stdout).text()).trim();
     const stderr = (await new Response(proc.stderr).text()).trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-sdk",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "type": "module",
   "exports": {
     ".": {