@cosmicdrift/kumiko-testing 0.350.0 → 0.351.0

package/bin/kumiko-testing.ts

@@ -19,8 +19,13 @@ const USAGE = `kumiko-testing <command>
   integration [--parallel N]               run every *.integration.test.ts under the cwd,
               [--timings <file>] [--update-timings]  or only the given file(s) when passed
               [file...]                               as positional args
+  -h, --help                               print this help (also works after a command)
 `;
 
+function isHelpFlag(arg: string | undefined): boolean {
+  return arg === "--help" || arg === "-h";
+}
+
 function runBunfig(args: readonly string[]): number {
   const { values } = parseArgs({
     args: [...args],
@@ -99,6 +104,10 @@ async function runIntegration(args: readonly string[]): Promise<number> {
 }
 
 const [command, ...rest] = process.argv.slice(2);
+if (isHelpFlag(command) || rest.some(isHelpFlag)) {
+  console.log(USAGE);
+  process.exit(0);
+}
 if (command === "bunfig") process.exit(runBunfig(rest));
 if (command === "integration") process.exit(await runIntegration(rest));
 console.error(USAGE);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-testing",
-  "version": "0.350.0",
+  "version": "0.351.0",
   "description": "Test template for Kumiko apps: per-flow seedTenant, app test stack, canonical test preloads, bunfig generator and integration runner.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -75,9 +75,9 @@
     "kumiko-testing": "./bin/kumiko-testing.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.350.0",
-    "@cosmicdrift/kumiko-dev-server": "0.350.0",
-    "@cosmicdrift/kumiko-framework": "0.350.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.351.0",
+    "@cosmicdrift/kumiko-dev-server": "0.351.0",
+    "@cosmicdrift/kumiko-framework": "0.351.0",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
@@ -115,6 +115,7 @@
     "bin",
     "!src/**/__tests__/**",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "!bin/__tests__/**"
   ]
 }

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.351.0",
+    "type": "improvement",
+    "title": "CapturedMail.text in the e2e seed route carries the mail's plain-text part",
+    "detail": "The e2e seed route returns the plain-text part of captured mails\n`CapturedMail` in the seed contract has an optional `text`, filled from the mail's text part, so e2e flows can assert on it."
+  },
   {
     "version": "0.345.0",
     "type": "improvement",

package/src/e2e/seed-contract.ts

@@ -89,6 +89,7 @@ const capturedMailSchema = z.object({
   to: z.string(),
   subject: z.string(),
   html: z.string(),
+  text: z.string().optional(),
   from: z.string().optional(),
   fromName: z.string().optional(),
   replyTo: z.string().optional(),

package/src/e2e/seed-route.ts

@@ -145,6 +145,7 @@ function toCapturedMail(message: EmailMessage): CapturedMail {
     to: message.to,
     subject: message.subject,
     html: message.html,
+    ...(message.text !== undefined ? { text: message.text } : {}),
     ...(message.from !== undefined ? { from: message.from } : {}),
     ...(message.fromName !== undefined ? { fromName: message.fromName } : {}),
     ...(message.replyTo !== undefined ? { replyTo: message.replyTo } : {}),

package/bin/__tests__/kumiko-testing-bunfig.test.ts

@@ -1,76 +0,0 @@
-// kumiko-framework#3120: `kumiko-testing bunfig` used to overwrite an
-// existing bunfig.toml unconditionally, silently dropping app-owned sections
-// (e.g. `[install.scopes]` with a private-registry token) and unmanaged keys
-// (e.g. `concurrency`) alike. Foreign sections now merge back in verbatim;
-// only an unmanaged key inside a *managed* section still blocks the write.
-
-import { describe, expect, test } from "bun:test";
-import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-
-const CLI_PATH = join(import.meta.dir, "..", "kumiko-testing.ts");
-
-async function runCli(args: string[], cwd: string) {
-  const proc = Bun.spawn(["bun", CLI_PATH, ...args], { cwd, stdout: "pipe", stderr: "pipe" });
-  const [stdout, stderr, exitCode] = await Promise.all([
-    new Response(proc.stdout).text(),
-    new Response(proc.stderr).text(),
-    proc.exited,
-  ]);
-  return { stdout, stderr, exitCode };
-}
-
-describe("kumiko-testing bunfig — existing file with a foreign section", () => {
-  test("merges [install.scopes] back in instead of dropping it", async () => {
-    const dir = mkdtempSync(join(tmpdir(), "kumiko-testing-bunfig-"));
-    try {
-      const existing =
-        '[install.scopes]\n"@cosmicdriftgamestudio" = { token = "$GITHUB_TOKEN" }\n\n[test]\npreload = []\n';
-      writeFileSync(join(dir, "bunfig.toml"), existing);
-
-      const { exitCode } = await runCli(["bunfig"], dir);
-
-      expect(exitCode).toBe(0);
-      const written = readFileSync(join(dir, "bunfig.toml"), "utf-8");
-      expect(written).toContain("Generated by kumiko-testing");
-      expect(written).toContain(
-        '[install.scopes]\n"@cosmicdriftgamestudio" = { token = "$GITHUB_TOKEN" }',
-      );
-    } finally {
-      rmSync(dir, { recursive: true, force: true });
-    }
-  });
-
-  test("aborts and names an unmanaged key inside [test], leaves the file untouched", async () => {
-    const dir = mkdtempSync(join(tmpdir(), "kumiko-testing-bunfig-"));
-    try {
-      const existing = "[test]\nconcurrency = 8\npreload = []\n";
-      writeFileSync(join(dir, "bunfig.toml"), existing);
-
-      const { exitCode, stderr } = await runCli(["bunfig"], dir);
-
-      expect(exitCode).toBe(1);
-      expect(stderr).toContain("test.concurrency");
-      expect(readFileSync(join(dir, "bunfig.toml"), "utf-8")).toBe(existing);
-    } finally {
-      rmSync(dir, { recursive: true, force: true });
-    }
-  });
-
-  test("regenerates a file with no foreign sections and no unmanaged keys", async () => {
-    const dir = mkdtempSync(join(tmpdir(), "kumiko-testing-bunfig-"));
-    try {
-      writeFileSync(join(dir, "bunfig.toml"), "[test]\npreload = []\n");
-
-      const { exitCode } = await runCli(["bunfig"], dir);
-
-      expect(exitCode).toBe(0);
-      expect(readFileSync(join(dir, "bunfig.toml"), "utf-8")).toContain(
-        "Generated by kumiko-testing",
-      );
-    } finally {
-      rmSync(dir, { recursive: true, force: true });
-    }
-  });
-});