@outfitter/testing 0.1.0 → 0.2.0

package/README.md

@@ -69,6 +69,33 @@ const user2 = createUser({
 
 Each call returns a fresh copy, preventing test pollution from shared mutable state.
 
+#### Deep Merge Behavior
+
+Overrides are deep-merged for nested objects:
+
+```typescript
+const createConfig = createFixture({
+  env: {
+    region: "us-east-1",
+    flags: { beta: false, audit: true },
+  },
+  retries: 3,
+});
+
+const config = createConfig({
+  env: { flags: { beta: true } },
+});
+// Result:
+// {
+//   env: { region: "us-east-1", flags: { beta: true, audit: true } },
+//   retries: 3
+// }
+```
+
+Notes:
+- Arrays are replaced, not merged.
+- `undefined` override values are ignored (defaults remain).
+
 ### withTempDir
 
 Runs a function with an isolated temporary directory that is automatically cleaned up.

package/dist/index.d.ts

@@ -95,6 +95,15 @@ interface LoadFixtureOptions {
 */
 declare function loadFixture2<T = string>(name: string, options?: LoadFixtureOptions): T;
 /**
+* @outfitter/testing - CLI Harness
+*
+* Test harness for executing and capturing CLI command output.
+* Provides a simple interface for running CLI commands in tests
+* and capturing their stdout, stderr, and exit code.
+*
+* @packageDocumentation
+*/
+/**
 * Result of a CLI command execution.
 *
 * Contains the captured output streams and exit code from the command.

package/dist/index.js

@@ -1,8 +1,37 @@
 // src/fixtures.ts
-import { readFileSync } from "node:fs";
-import { mkdir, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { extname, join } from "node:path";
+var cachedRequire;
+function getNodeRequire() {
+  if (cachedRequire !== undefined) {
+    if (cachedRequire === null) {
+      throw new Error("Node.js built-ins are unavailable in this runtime.");
+    }
+    return cachedRequire;
+  }
+  const metaRequire = import.meta.require;
+  if (typeof metaRequire === "function") {
+    cachedRequire = metaRequire;
+    return metaRequire;
+  }
+  const globalRequire = globalThis.require;
+  if (typeof globalRequire === "function") {
+    cachedRequire = globalRequire;
+    return globalRequire;
+  }
+  cachedRequire = null;
+  throw new Error("Node.js built-ins are unavailable in this runtime.");
+}
+function getNodeFs() {
+  return getNodeRequire()("node:fs");
+}
+function getNodeFsPromises() {
+  return getNodeRequire()("node:fs/promises");
+}
+function getNodeOs() {
+  return getNodeRequire()("node:os");
+}
+function getNodePath() {
+  return getNodeRequire()("node:path");
+}
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -45,11 +74,14 @@ function createFixture(defaults) {
   };
 }
 function generateTempDirPath() {
+  const { tmpdir } = getNodeOs();
+  const { join } = getNodePath();
   const timestamp = Date.now();
   const random = Math.random().toString(36).slice(2, 10);
   return join(tmpdir(), `outfitter-test-${timestamp}-${random}`);
 }
 async function withTempDir(fn) {
+  const { mkdir, rm } = getNodeFsPromises();
   const dir = generateTempDirPath();
   await mkdir(dir, { recursive: true });
   try {
@@ -79,6 +111,8 @@ async function withEnv(vars, fn) {
   }
 }
 function loadFixture(name, options) {
+  const { readFileSync } = getNodeFs();
+  const { extname, join } = getNodePath();
   const baseDir = options?.fixturesDir ?? join(process.cwd(), "__fixtures__");
   const filePath = join(baseDir, name);
   const content = readFileSync(filePath, "utf-8");
@@ -88,59 +122,31 @@ function loadFixture(name, options) {
   return content;
 }
 // src/cli-harness.ts
-import { spawn } from "node:child_process";
-import { constants } from "node:os";
 function createCliHarness(command) {
   return {
-    run(args) {
-      return new Promise((resolve, reject) => {
-        const child = spawn(command, args, {
-          shell: false,
-          stdio: ["pipe", "pipe", "pipe"]
-        });
-        child.stdin.end();
-        const stdoutChunks = [];
-        const stderrChunks = [];
-        child.stdout.on("data", (chunk) => {
-          stdoutChunks.push(chunk);
-        });
-        child.stderr.on("data", (chunk) => {
-          stderrChunks.push(chunk);
-        });
-        child.on("error", (err) => {
-          reject(err);
-        });
-        child.on("close", (exitCode, signal) => {
-          const decoder = new TextDecoder("utf-8");
-          let finalExitCode;
-          if (exitCode !== null) {
-            finalExitCode = exitCode;
-          } else if (signal !== null) {
-            const signalNumber = constants.signals[signal];
-            finalExitCode = signalNumber !== undefined ? 128 + signalNumber : 1;
-          } else {
-            finalExitCode = 1;
-          }
-          resolve({
-            stdout: decoder.decode(concatUint8Arrays(stdoutChunks)),
-            stderr: decoder.decode(concatUint8Arrays(stderrChunks)),
-            exitCode: finalExitCode
-          });
-        });
+    async run(args) {
+      const child = Bun.spawn([command, ...args], {
+        stdin: "pipe",
+        stdout: "pipe",
+        stderr: "pipe"
       });
+      child.stdin?.end();
+      const stdoutPromise = child.stdout ? new Response(child.stdout).text() : Promise.resolve("");
+      const stderrPromise = child.stderr ? new Response(child.stderr).text() : Promise.resolve("");
+      const exitCodePromise = child.exited;
+      const [stdout, stderr, exitCode] = await Promise.all([
+        stdoutPromise,
+        stderrPromise,
+        exitCodePromise
+      ]);
+      return {
+        stdout,
+        stderr,
+        exitCode: typeof exitCode === "number" ? exitCode : 1
+      };
     }
   };
 }
-function concatUint8Arrays(chunks) {
-  const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
-  const result = new Uint8Array(totalLength);
-  let offset = 0;
-  for (const chunk of chunks) {
-    result.set(chunk, offset);
-    offset += chunk.length;
-  }
-  return result;
-}
 // src/cli-helpers.ts
 class ExitError extends Error {
   code;
@@ -298,22 +304,22 @@ function createTestLoggerWithContext(context, logs) {
     clear() {
       logs.length = 0;
     },
-    trace(message, metadata) {
+    trace: (message, metadata) => {
       write("trace", message, metadata);
     },
-    debug(message, metadata) {
+    debug: (message, metadata) => {
       write("debug", message, metadata);
     },
-    info(message, metadata) {
+    info: (message, metadata) => {
       write("info", message, metadata);
     },
-    warn(message, metadata) {
+    warn: (message, metadata) => {
       write("warn", message, metadata);
     },
-    error(message, metadata) {
+    error: (message, metadata) => {
       write("error", message, metadata);
     },
-    fatal(message, metadata) {
+    fatal: (message, metadata) => {
       write("fatal", message, metadata);
     },
     child(childContext) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@outfitter/testing",
   "description": "Test harnesses, fixtures, and utilities for Outfitter packages",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "files": [
     "dist"
@@ -33,8 +33,8 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@outfitter/contracts": "0.1.0",
-    "@outfitter/mcp": "0.1.0",
+    "@outfitter/contracts": "0.2.0",
+    "@outfitter/mcp": "0.2.0",
     "zod": "^4.3.5"
   },
   "devDependencies": {