@clodocapeo/pulsar-bundle-full 0.2.0

package/README.md

@@ -0,0 +1,104 @@
+# @clodocapeo/pulsar-bundle-full
+
+Full Pulsar bundle for Node consumers — `pulsar.exe` with **browser sources**, **text sources**, and **VLC-backed media sources** included on top of the standard light bundle. Same `spawn()` API as [`@clodocapeo/pulsar-bundle`](../pulsar-bundle).
+
+Use this package when your scenes need any of:
+
+- HTML / CSS / JS overlays (browser_source via CEF)
+- Native text overlays (text_gdiplus / text_ft2_source)
+- Local video file playback (vlc_source)
+
+If you only need game capture + window/monitor capture + audio + recording + RTMP, the smaller [`@clodocapeo/pulsar-bundle`](../pulsar-bundle) (~40 MB zip) is enough.
+
+## Install
+
+```bash
+npm install @clodocapeo/pulsar-bundle-full
+```
+
+Windows x64 only — `os: ["win32"]` in `package.json` makes `npm install` skip the binary on every other platform.
+
+A `postinstall` step downloads the matching version's `pulsar-windows-x64-full-vX.Y.Z.zip` from the Pulsar GitHub Releases (~250 MB) and extracts it into `node_modules/@clodocapeo/pulsar-bundle-full/binaries/`. Cached: re-running `npm install` against an unchanged version is a no-op.
+
+The 200 MB inflation over the light bundle is **CEF** (Chromium Embedded Framework, the runtime obs-browser links against). It is what makes browser sources possible.
+
+### Environment overrides
+
+Same as `@clodocapeo/pulsar-bundle`:
+
+```
+PULSAR_BUNDLE_SKIP_POSTINSTALL=1   # skip download (CI / offline)
+PULSAR_BUNDLE_DOWNLOAD_URL=<url>   # mirror or internal CDN
+```
+
+## Usage
+
+```ts
+import { spawn } from "@clodocapeo/pulsar-bundle-full";
+
+const pulsar = await spawn();
+
+// HTML overlay via browser_source (the headline feature of -full)
+await pulsar.client.obs.call("CreateInput", {
+  sceneName: "Default",
+  inputName: "Overlay",
+  inputKind: "browser_source",
+  inputSettings: {
+    url: "https://example.com/my-overlay",
+    width: 1920,
+    height: 1080,
+  },
+});
+
+// Native text source
+await pulsar.client.obs.call("CreateInput", {
+  sceneName: "Default",
+  inputName: "Title",
+  inputKind: "text_gdiplus",
+  inputSettings: { text: "LIVE", font: { face: "Segoe UI", size: 64 } },
+});
+
+// VLC-backed local video file playback
+await pulsar.client.obs.call("CreateInput", {
+  sceneName: "Default",
+  inputName: "Bumper",
+  inputKind: "vlc_source",
+  inputSettings: { playlist: ["C:/path/to/clip.mp4"] },
+});
+
+await pulsar.shutdown();
+```
+
+`spawn()` returns the same handle shape as the light bundle (`{ client, child, port, libobsVersion, shutdown }`). All the higher-level namespaces (`destinations`, `video`, `adaptive`, `record`, `stream`) are inherited from `@clodocapeo/pulsar-client` and work identically.
+
+## Trade-off vs the light bundle
+
+| | `pulsar-bundle` (light) | `pulsar-bundle-full` |
+|---|---|---|
+| Zip download | ~40 MB | ~250 MB |
+| Extracted | ~100 MB | ~600 MB |
+| Plugins | game capture, window, monitor, WASAPI, dshow webcam, x264/NVENC/QSV/AMF, ffmpeg, filters, transitions, multi-stream + websocket | + obs-browser (CEF) + obs-text + text-freetype2 + vlc-video |
+| Best for | gaming streams, simple capture flows | composed scenes, HTML overlays, multi-source layouts |
+
+Both bundles ship the same set of always-stripped plugins (obs-vst, obs-webrtc, decklink, frontend-tools, obs-libfdk) — those are deliberate omissions, see the repo's main README for the rationale.
+
+## Versioning
+
+Locked to `pulsar-client` and `pulsar.exe` in lockstep. `0.2.0` of this package downloads `pulsar-windows-x64-full-v0.2.0.zip` and depends on `@clodocapeo/pulsar-client@0.2.0`.
+
+## Development
+
+```bash
+# from the monorepo root
+npm install                 # workspaces resolve, postinstall soft-fails
+                            # on offline / unreleased versions
+npm run build               # tsc -> dist/
+npm run test                # vitest with the same fake-pulsar fixture
+                            # as @clodocapeo/pulsar-bundle
+```
+
+The vitest suite uses `tests/fake-pulsar.mjs` (a Node script that mimics pulsar.exe's boot) and exercises the same 5 lifecycle tests as `pulsar-bundle`. Browser-source-specific behaviour requires the real `pulsar.exe` with CEF; that's covered in the repo's integration smoke test, not the package's unit suite.
+
+## License
+
+MIT.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { spawn } from "./spawn.js";
+export type { SpawnOptions, SpawnedPulsar } from "./spawn.js";
+export * from "@clodocapeo/pulsar-client";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9D,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// @clodocapeo/pulsar-bundle-full
+//
+// Spawns the full Pulsar bundle (with obs-browser / CEF + text + vlc)
+// and returns a connected PulsarClient. Identical spawn() API to
+// @clodocapeo/pulsar-bundle; the difference is purely the binary
+// payload downloaded by postinstall. Use this package when consumers
+// need browser sources (HTML overlays), native text sources, or
+// VLC-backed media sources -- e.g. Prism's composed scenes.
+export { spawn } from "./spawn.js";
+export * from "@clodocapeo/pulsar-client";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,sEAAsE;AACtE,iEAAiE;AACjE,iEAAiE;AACjE,qEAAqE;AACrE,gEAAgE;AAChE,4DAA4D;AAE5D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,cAAc,2BAA2B,CAAC"}

package/dist/spawn.d.ts

@@ -0,0 +1,64 @@
+import { type ChildProcess } from "node:child_process";
+import { PulsarClient } from "@clodocapeo/pulsar-client";
+export interface SpawnOptions {
+    /** Override the directory containing bin/64bit/pulsar.exe.
+     *  Default: <package>/binaries (populated by postinstall). */
+    binariesPath?: string;
+    /** Extra env vars for pulsar.exe. Common ones:
+     *    PULSAR_CAPTURE_WINDOW   "<title>:<class>:<exe>" for window_capture
+     *    PULSAR_FPS              30 / 60 / etc.
+     *    PULSAR_VIDEO_BITRATE    kbps
+     *    PULSAR_AUDIO_BITRATE    kbps
+     *    PULSAR_RECORD_DIR       output dir for the singleton recorder
+     *    PULSAR_PROCESS_AUDIO_NAME  exe name for per-process audio
+     *    PULSAR_ADAPTIVE_BITRATE off  to disable the worker
+     */
+    env?: Record<string, string>;
+    /** How long to wait for "ready, idling" on stdout. Default 30 s. */
+    readyTimeoutMs?: number;
+    /** Optional log forwarder. Receives one stdout/stderr line at a time. */
+    onLog?: (stream: "stdout" | "stderr", line: string) => void;
+    /** Test-only escape hatch: spawn a different executable instead of
+     *  the bundled pulsar.exe. The launched process must still print the
+     *  ready marker on stdout and create obs-websocket/config.json under
+     *  the cwd. Used by the package's own vitest suite -- not a public
+     *  API for normal callers.
+     *  @internal */
+    launchCommand?: {
+        exe: string;
+        args?: string[];
+    };
+}
+export interface SpawnedPulsar {
+    /** Connected PulsarClient ready for vendor calls. */
+    client: PulsarClient;
+    /** Underlying child process. Most callers should use shutdown() instead
+     *  of touching this directly, but it's exposed for advanced use cases
+     *  (sending custom signals, reading stdio, etc.). */
+    child: ChildProcess;
+    /** WebSocket port the obs-websocket server is bound to. */
+    port: number;
+    /** libobs version string parsed from the boot log
+     *  (e.g. "32.1.2-1-g8c23ba721-pulsar"). */
+    libobsVersion: string;
+    /** Disconnect the WS client and terminate pulsar.exe. Resolves once
+     *  the process has exited. Idempotent. */
+    shutdown(): Promise<void>;
+}
+/**
+ * Spawn pulsar.exe and return a connected PulsarClient.
+ *
+ * The child process is started with its working directory set to the
+ * binary's location so that the loader resolves obs.dll and the libobs
+ * plugin scanner finds obs-plugins/64bit/ via the relative path
+ * convention add_default_module_paths uses.
+ *
+ * @example
+ *   const pulsar = await spawn({
+ *     env: { PULSAR_CAPTURE_WINDOW: "Untitled - Notepad:Notepad:notepad.exe" },
+ *   });
+ *   await pulsar.client.destinations.create({ kind: "twitch", key });
+ *   await pulsar.shutdown();
+ */
+export declare function spawn(opts?: SpawnOptions): Promise<SpawnedPulsar>;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../src/spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAK5E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAQzD,MAAM,WAAW,YAAY;IAC3B;kEAC8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;;;OAQG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,yEAAyE;IACzE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5D;;;;;oBAKgB;IAChB,aAAa,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAClD;AAED,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,MAAM,EAAE,YAAY,CAAC;IAErB;;yDAEqD;IACrD,KAAK,EAAE,YAAY,CAAC;IAEpB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IAEb;+CAC2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IAEtB;8CAC0C;IAC1C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAUD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,KAAK,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAiH3E"}

package/dist/spawn.js

@@ -0,0 +1,153 @@
+import { spawn as childSpawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { PulsarClient } from "@clodocapeo/pulsar-client";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/** Default location of the bundled binaries inside this package. */
+const DEFAULT_BINARIES = resolve(__dirname, "..", "binaries");
+const READY_MARKER = "pulsar-headless: libobs ";
+const IDLE_MARKER = "ready, idling";
+/**
+ * Spawn pulsar.exe and return a connected PulsarClient.
+ *
+ * The child process is started with its working directory set to the
+ * binary's location so that the loader resolves obs.dll and the libobs
+ * plugin scanner finds obs-plugins/64bit/ via the relative path
+ * convention add_default_module_paths uses.
+ *
+ * @example
+ *   const pulsar = await spawn({
+ *     env: { PULSAR_CAPTURE_WINDOW: "Untitled - Notepad:Notepad:notepad.exe" },
+ *   });
+ *   await pulsar.client.destinations.create({ kind: "twitch", key });
+ *   await pulsar.shutdown();
+ */
+export async function spawn(opts = {}) {
+    const binariesPath = opts.binariesPath ?? DEFAULT_BINARIES;
+    const cwd = join(binariesPath, "bin", "64bit");
+    const configPath = join(cwd, "obs-websocket", "config.json");
+    // Resolve the executable. Default = bundled pulsar.exe; tests can pass
+    // launchCommand to swap in a fake.
+    let exe;
+    let args;
+    if (opts.launchCommand) {
+        exe = opts.launchCommand.exe;
+        args = opts.launchCommand.args ?? [];
+    }
+    else {
+        exe = join(cwd, "pulsar.exe");
+        args = [];
+        if (!existsSync(exe)) {
+            throw new Error(`pulsar.exe not found at ${exe}. ` +
+                `Run \`npm install\` to trigger the postinstall download, ` +
+                `or set binariesPath to a local checkout.`);
+        }
+    }
+    const child = childSpawn(exe, args, {
+        cwd,
+        env: { ...process.env, ...opts.env },
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+    });
+    const readyTimeout = opts.readyTimeoutMs ?? 30_000;
+    let libobsVersion = "";
+    let resolveReady;
+    let rejectReady;
+    const ready = new Promise((res, rej) => {
+        resolveReady = res;
+        rejectReady = rej;
+    });
+    const watchdog = setTimeout(() => {
+        rejectReady(new Error(`pulsar.exe did not signal ready within ${readyTimeout}ms`));
+    }, readyTimeout);
+    const handleLine = (stream, line) => {
+        if (line.length === 0)
+            return;
+        if (opts.onLog)
+            opts.onLog(stream, line);
+        // pulsar-headless prints exactly:
+        //   "pulsar-headless: libobs <version> ready, idling (Ctrl+C to exit)"
+        // when boot is complete.
+        if (stream === "stdout" && line.includes(IDLE_MARKER) && line.includes(READY_MARKER)) {
+            const slice = line.slice(line.indexOf(READY_MARKER) + READY_MARKER.length);
+            libobsVersion = slice.split(" ", 1)[0] ?? "";
+            clearTimeout(watchdog);
+            resolveReady();
+        }
+    };
+    attachLineReader(child, "stdout", (l) => handleLine("stdout", l));
+    attachLineReader(child, "stderr", (l) => handleLine("stderr", l));
+    child.on("exit", (code, signal) => {
+        clearTimeout(watchdog);
+        rejectReady(new Error(`pulsar.exe exited prematurely (code=${code}, signal=${signal})`));
+    });
+    await ready;
+    // obs-websocket writes its config.json on first run -- after the
+    // ready marker, the file is guaranteed to exist with port + password.
+    if (!existsSync(configPath)) {
+        child.kill();
+        throw new Error(`obs-websocket config not found at ${configPath} (boot incomplete?)`);
+    }
+    const config = JSON.parse(readFileSync(configPath, "utf8"));
+    const port = config.server_port ?? 4455;
+    const password = config.server_password;
+    const client = new PulsarClient();
+    await client.connect({
+        url: `ws://127.0.0.1:${port}`,
+        ...(password !== undefined ? { password } : {}),
+    });
+    let shutdownPromise = null;
+    const shutdown = async () => {
+        if (shutdownPromise)
+            return shutdownPromise;
+        shutdownPromise = (async () => {
+            try {
+                await client.disconnect();
+            }
+            catch {
+                // Already closed -- swallow.
+            }
+            if (child.exitCode === null && child.signalCode === null) {
+                child.kill();
+                await new Promise((res) => {
+                    if (child.exitCode !== null || child.signalCode !== null)
+                        return res();
+                    child.once("exit", () => res());
+                    // Safety net: a stuck process gets a 5 s grace period before
+                    // force-kill so a pending muxer trailer write can land.
+                    setTimeout(() => {
+                        if (child.exitCode === null && child.signalCode === null) {
+                            child.kill("SIGKILL");
+                        }
+                    }, 5_000);
+                });
+            }
+        })();
+        return shutdownPromise;
+    };
+    return { client, child, port, libobsVersion, shutdown };
+}
+/** Reads `child[stream]` line-by-line and dispatches each completed line. */
+function attachLineReader(child, stream, onLine) {
+    const out = child[stream];
+    if (!out)
+        return;
+    let buf = "";
+    out.setEncoding("utf8");
+    out.on("data", (chunk) => {
+        buf += chunk;
+        let idx;
+        while ((idx = buf.indexOf("\n")) >= 0) {
+            const line = buf.slice(0, idx).replace(/\r$/, "");
+            buf = buf.slice(idx + 1);
+            onLine(line);
+        }
+    });
+    out.on("end", () => {
+        if (buf.length > 0)
+            onLine(buf.replace(/\r$/, ""));
+    });
+}
+//# sourceMappingURL=spawn.js.map

package/dist/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../src/spawn.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@clodocapeo/pulsar-bundle-full",
+  "version": "0.2.0",
+  "description": "Full Pulsar bundle: pulsar.exe + DLLs + browser sources (CEF) + text + VLC. Same Node spawn() API as @clodocapeo/pulsar-bundle.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ZabLaboratory/Pulsar.git",
+    "directory": "packages/pulsar-bundle-full"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ],
+  "os": ["win32"],
+  "cpu": ["x64"],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "postinstall": "node scripts/postinstall.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@clodocapeo/pulsar-client": "0.2.0"
+  },
+  "devDependencies": {
+    "@msgpack/msgpack": "^3.0.0",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.10",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0",
+    "ws": "^8.18.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/postinstall.mjs

@@ -0,0 +1,106 @@
+// @clodocapeo/pulsar-bundle postinstall.
+//
+// Downloads the matching pulsar-windows-x64-v<VERSION>.zip from the
+// Pulsar GitHub Releases and extracts it into ./binaries/. Idempotent:
+// a stamp file under binaries/.version records what's already on disk
+// so re-running npm install on an unchanged version is a no-op.
+//
+// Skip with `PULSAR_BUNDLE_SKIP_POSTINSTALL=1` (useful for CI matrix
+// runs that don't actually need the binary, or for offline builds with
+// a vendored copy).
+//
+// Override the download URL with `PULSAR_BUNDLE_DOWNLOAD_URL=<url>` if
+// the binary is hosted somewhere else (private mirror, internal CDN).
+
+import { execFileSync } from "node:child_process";
+import { createWriteStream } from "node:fs";
+import { mkdir, readFile, rm, writeFile, stat } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = resolve(__dirname, "..");
+
+if (process.env.PULSAR_BUNDLE_SKIP_POSTINSTALL === "1") {
+  console.log("[pulsar-bundle] PULSAR_BUNDLE_SKIP_POSTINSTALL=1 -- skipping binary download");
+  process.exit(0);
+}
+
+if (process.platform !== "win32" || process.arch !== "x64") {
+  // package.json's "os" / "cpu" guards prevent this on a normal install,
+  // but a cross-platform `npm install --force` could end up here.
+  console.log(`[pulsar-bundle] platform=${process.platform} arch=${process.arch} unsupported; skipping`);
+  process.exit(0);
+}
+
+const pkg = JSON.parse(await readFile(join(pkgRoot, "package.json"), "utf8"));
+const version = pkg.version;
+// pulsar-bundle-full pulls the full distribution variant: light bundle
+// + obs-browser (CEF runtime) + obs-text + text-freetype2 + vlc-video.
+// ~250 MB zipped vs ~40 MB for the light bundle.
+const zipName = `pulsar-windows-x64-full-v${version}.zip`;
+const url =
+  process.env.PULSAR_BUNDLE_DOWNLOAD_URL ??
+  `https://github.com/ZabLaboratory/Pulsar/releases/download/v${version}/${zipName}`;
+
+const binariesDir = join(pkgRoot, "binaries");
+const stampFile = join(binariesDir, ".version-stamp");
+
+// Cache hit?
+try {
+  const stamp = await readFile(stampFile, "utf8");
+  if (stamp.trim() === version) {
+    console.log(`[pulsar-bundle] binaries/ already at v${version}, skipping download`);
+    process.exit(0);
+  }
+} catch {
+  // Missing stamp -> proceed
+}
+
+await rm(binariesDir, { recursive: true, force: true });
+await mkdir(binariesDir, { recursive: true });
+
+console.log(`[pulsar-bundle] downloading ${url}`);
+let response;
+try {
+  response = await fetch(url, { redirect: "follow" });
+} catch (err) {
+  console.warn(`[pulsar-bundle] WARN: network error fetching binary: ${err.message}`);
+  console.warn("[pulsar-bundle] WARN: pulsar.exe will be unavailable until you re-install with network access");
+  process.exit(0);
+}
+if (!response.ok || !response.body) {
+  console.warn(`[pulsar-bundle] WARN: download failed: ${response.status} ${response.statusText}`);
+  console.warn(`[pulsar-bundle] WARN: is the v${version} release published?`);
+  console.warn("[pulsar-bundle]       https://github.com/ZabLaboratory/Pulsar/releases");
+  console.warn("[pulsar-bundle] WARN: pulsar.exe will be unavailable; spawn() will throw a clear error");
+  // Soft-fail so npm install completes -- the bundle is still usable in
+  // monorepo dev (where binariesPath is overridden) and the failure is
+  // surfaced loudly enough that production callers will fix it.
+  process.exit(0);
+}
+
+const zipPath = join(binariesDir, zipName);
+await pipeline(Readable.fromWeb(response.body), createWriteStream(zipPath));
+const sizeMb = ((await stat(zipPath)).size / 1024 / 1024).toFixed(1);
+console.log(`[pulsar-bundle] downloaded ${sizeMb} MB`);
+
+console.log("[pulsar-bundle] extracting...");
+// Expand-Archive is built into PowerShell since Windows 10. Avoids
+// adding a native unzip dependency to the package.
+execFileSync(
+  "powershell.exe",
+  [
+    "-NoProfile",
+    "-NonInteractive",
+    "-Command",
+    `Expand-Archive -Path "${zipPath}" -DestinationPath "${binariesDir}" -Force`,
+  ],
+  { stdio: "inherit" },
+);
+await rm(zipPath, { force: true });
+
+await writeFile(stampFile, `${version}\n`, "utf8");
+console.log(`[pulsar-bundle] binaries ready at ${binariesDir}`);