@firtoz/worker-helper 1.5.1 → 1.6.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @firtoz/worker-helper
 
+## 1.6.1
+
+### Patch Changes
+
+- [`80a7aa6`](https://github.com/firtoz/fullstack-toolkit/commit/80a7aa6abbca3b7ef621e6dd92f51954bee84b43) Thanks [@firtoz](https://github.com/firtoz)! - `prepareEnvFiles` no longer passes `.env` / `.env.local` to `wrangler types` when a matching `.env.example` / `.env.local.example` exists, so generated `worker-configuration.d.ts` headers match CI and local dev.
+
+## 1.6.0
+
+### Minor Changes
+
+- [`c3a3cc7`](https://github.com/firtoz/fullstack-toolkit/commit/c3a3cc778ba9ce4b5efe1bcdd8d541f46dec3bfd) Thanks [@firtoz](https://github.com/firtoz)! - Publish compiled ESM and TypeScript declarations from `dist/` for each package (`tsup`, `prepack` build). `exports`, `main`, and `types` resolve to `dist/`; CLI bins point at built JS with a Node shebang where applicable. Shared `scripts/tsup-lib.ts` discovers `src` entries and externals; workspace test apps map `@firtoz/*` to package sources in `tsconfig` for accurate generics during typecheck. `@firtoz/socka` is published under the scoped name with the same `dist/` layout.
+
+### Patch Changes
+
+- [`f78c988`](https://github.com/firtoz/fullstack-toolkit/commit/f78c988d37a9cc48490ee3372dccc14a42810bfe) Thanks [@firtoz](https://github.com/firtoz)! - Improve READMEs: npm shields, contextual stack badges, clearer taglines, and new docs for `@firtoz/idb-collections` and `@firtoz/collection-sync`. Align `@firtoz/db-helpers` copy with published `dist/` builds.
+
 ## 1.5.1
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,14 @@
 # @firtoz/worker-helper
 
-Type-safe Web Worker helper with Zod validation for input and output messages. This package provides a simple way to create type-safe Web Workers with automatic validation of messages sent between the main thread and worker threads.
+[![npm version](https://img.shields.io/npm/v/%40firtoz%2Fworker-helper.svg)](https://www.npmjs.com/package/@firtoz/worker-helper)
+[![npm downloads](https://img.shields.io/npm/dm/%40firtoz%2Fworker-helper.svg)](https://www.npmjs.com/package/@firtoz/worker-helper)
+[![license](https://img.shields.io/npm/l/%40firtoz%2Fworker-helper.svg)](https://github.com/firtoz/fullstack-toolkit/blob/main/LICENSE)
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![Zod](https://img.shields.io/badge/Zod-3B82F6?logo=zod&logoColor=white)](https://zod.dev)
+[![Web Workers](https://img.shields.io/badge/Web_Workers-646464)](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API)
+
+**Typed messages between the main thread and workers** — Zod validates every postMessage in both directions, with helpers for Cloudflare `wrangler types` / `.env` when you deploy Workers too.
 
 > **⚠️ Early WIP Notice:** This package is in very early development and is **not production-ready**. It is TypeScript-only and may have breaking changes. While I (the maintainer) have limited time, I'm open to PRs for features, bug fixes, or additional support (like JS builds). Please feel free to try it out and contribute! See [CONTRIBUTING.md](../../CONTRIBUTING.md) for details.
 

package/dist/WorkerClient.d.ts

@@ -0,0 +1,51 @@
+import { ZodType } from 'zod/v4';
+
+interface WorkerClientOptions<TClientMessage, TServerMessage> {
+    /**
+     * Worker instance to wrap
+     */
+    worker: Worker;
+    /**
+     * Schema for validating messages sent to the worker
+     */
+    clientSchema: ZodType<TClientMessage>;
+    /**
+     * Schema for validating messages received from the worker
+     */
+    serverSchema: ZodType<TServerMessage>;
+    /**
+     * Callback for validated messages from the worker
+     */
+    onMessage?: (message: TServerMessage) => void;
+    /**
+     * Callback for when validation fails on incoming messages
+     */
+    onValidationError?: (error: Error, rawMessage: unknown) => void;
+    /**
+     * Callback for worker errors
+     */
+    onError?: (event: ErrorEvent) => void;
+}
+declare class WorkerClient<TClientMessage, TServerMessage> {
+    private worker;
+    private readonly clientSchema;
+    private readonly serverSchema;
+    private readonly onMessageCallback?;
+    private readonly onValidationErrorCallback?;
+    constructor(options: WorkerClientOptions<TClientMessage, TServerMessage>);
+    private handleMessage;
+    /**
+     * Send a message to the worker with validation
+     */
+    send(message: TClientMessage): void;
+    /**
+     * Terminate the worker
+     */
+    terminate(): void;
+    /**
+     * Get the underlying Worker instance
+     */
+    getWorker(): Worker;
+}
+
+export { WorkerClient, type WorkerClientOptions };

package/dist/WorkerClient.js

@@ -0,0 +1,3 @@
+export { WorkerClient } from './chunk-TYKZZZOR.js';
+//# sourceMappingURL=WorkerClient.js.map
+//# sourceMappingURL=WorkerClient.js.map

package/dist/WorkerClient.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"WorkerClient.js"}

package/dist/cf-typegen-discovery.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Find workspace root by walking up from startPath until we find a package.json
+ * with a "workspaces" field (npm/bun convention).
+ */
+declare function findWorkspaceRoot(startPath: string): string | null;
+/**
+ * Expand workspace glob patterns (e.g. "packages/*", "tests/*") to absolute paths.
+ * Only supports single-level globs; each pattern must be exactly "dirname/*".
+ */
+declare function expandWorkspacePatterns(root: string, patterns: string[]): string[];
+/**
+ * Get workspace package paths from root package.json (workspaces field).
+ * Returns absolute paths to each workspace member directory.
+ */
+declare function getWorkspacePaths(root: string): string[];
+/**
+ * Find all wrangler config files under the given workspace member paths.
+ * Does not rely on git; includes untracked configs (e.g. new durable objects).
+ */
+declare function findWranglerConfigsInPaths(workspacePaths: string[]): string[];
+/**
+ * Discover all wrangler config paths for the workspace containing cwd.
+ * Returns empty array if not in a workspace or if root has no workspaces field.
+ */
+declare function discoverWranglerConfigs(cwd: string): string[];
+
+export { discoverWranglerConfigs, expandWorkspacePatterns, findWorkspaceRoot, findWranglerConfigsInPaths, getWorkspacePaths };

package/dist/cf-typegen-discovery.js

@@ -0,0 +1,3 @@
+export { discoverWranglerConfigs, expandWorkspacePatterns, findWorkspaceRoot, findWranglerConfigsInPaths, getWorkspacePaths } from './chunk-QEZL4IJI.js';
+//# sourceMappingURL=cf-typegen-discovery.js.map
+//# sourceMappingURL=cf-typegen-discovery.js.map

package/dist/cf-typegen-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"cf-typegen-discovery.js"}

package/dist/cf-typegen.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env bun

package/dist/cf-typegen.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env bun
+import { findWorkspaceRoot, discoverWranglerConfigs } from './chunk-QEZL4IJI.js';
+import { prepareEnvFiles } from './chunk-A4S7WGGQ.js';
+import { spawnSync } from 'child_process';
+import * as fs from 'fs';
+import path from 'path';
+import process from 'process';
+
+var cwd = process.argv[2];
+var extraWranglerArgs = process.argv.slice(3);
+if (!cwd || !fs.existsSync(cwd)) {
+  console.error(
+    "Please specify a directory as the first parameter. Usually $(pwd)."
+  );
+  process.exit(1);
+}
+console.log(`Running CF typegen for: ${cwd}`);
+function runWranglerTypes() {
+  const envFiles = prepareEnvFiles(cwd);
+  console.log("Running wrangler types...");
+  const workspaceRoot = findWorkspaceRoot(cwd);
+  let allConfigs;
+  if (workspaceRoot) {
+    allConfigs = discoverWranglerConfigs(cwd);
+  } else {
+    console.warn("\u26A0 No workspace root found, using current directory only");
+    allConfigs = [];
+  }
+  if (allConfigs.length > 0) {
+    console.log(`  Found ${allConfigs.length} wrangler config(s) in workspace`);
+  }
+  const args = ["types", "-c", "wrangler.jsonc"];
+  const currentWranglerJsonc = path.join(cwd, "wrangler.jsonc");
+  const currentWranglerJson = path.join(cwd, "wrangler.json");
+  for (const configPath of allConfigs) {
+    const resolvedPath = path.resolve(configPath);
+    if (resolvedPath === currentWranglerJsonc || resolvedPath === currentWranglerJson) {
+      continue;
+    }
+    const relativePath = path.relative(cwd, configPath);
+    args.push("-c", relativePath);
+  }
+  for (const envFile of envFiles) {
+    args.push("--env-file", envFile);
+  }
+  args.push(...extraWranglerArgs);
+  const command = `wrangler ${args.join(" ")}`;
+  console.log(`  Command: ${command}`);
+  const result = spawnSync("wrangler", args, {
+    cwd,
+    stdio: "inherit"
+  });
+  if (result.status !== 0) {
+    console.error("Failed to run wrangler types");
+    process.exit(1);
+  }
+  console.log("\u2713 Wrangler types generated with all workspace bindings");
+}
+try {
+  runWranglerTypes();
+  console.log("\n\u2713 CF typegen completed successfully");
+} catch (error) {
+  console.error("\n\u2717 CF typegen failed:", error);
+  process.exit(1);
+}
+//# sourceMappingURL=cf-typegen.js.map
+//# sourceMappingURL=cf-typegen.js.map

package/dist/cf-typegen.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cf-typegen.ts"],"names":[],"mappings":"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","file":"cf-typegen.js","sourcesContent":["#!/usr/bin/env bun\nimport { spawnSync } from \"node:child_process\";\nimport * as fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport {\n\tdiscoverWranglerConfigs,\n\tfindWorkspaceRoot,\n} from \"./cf-typegen-discovery\";\nimport { prepareEnvFiles } from \"./utils/prepare-env\";\n\n// First arg: directory (cwd). Remaining args: passed through to `wrangler types`.\nconst cwd = process.argv[2];\nconst extraWranglerArgs = process.argv.slice(3);\n\nif (!cwd || !fs.existsSync(cwd)) {\n\tconsole.error(\n\t\t\"Please specify a directory as the first parameter. Usually $(pwd).\",\n\t);\n\tprocess.exit(1);\n}\n\nconsole.log(`Running CF typegen for: ${cwd}`);\n\nfunction runWranglerTypes() {\n\tconst envFiles = prepareEnvFiles(cwd);\n\n\tconsole.log(\"Running wrangler types...\");\n\n\t// Discover wrangler configs from npm/bun workspace definition (includes untracked packages)\n\tconst workspaceRoot = findWorkspaceRoot(cwd);\n\tlet allConfigs: string[];\n\tif (workspaceRoot) {\n\t\tallConfigs = discoverWranglerConfigs(cwd);\n\t} else {\n\t\tconsole.warn(\"⚠ No workspace root found, using current directory only\");\n\t\tallConfigs = [];\n\t}\n\n\tif (allConfigs.length > 0) {\n\t\tconsole.log(`  Found ${allConfigs.length} wrangler config(s) in workspace`);\n\t}\n\n\t// Build args for wrangler types: multiple -c flags, --env-file, then any extra args\n\t// The first config should be the current directory's wrangler.jsonc\n\tconst args: string[] = [\"types\", \"-c\", \"wrangler.jsonc\"];\n\n\t// Add other configs (relative to cwd for better readability)\n\tconst currentWranglerJsonc = path.join(cwd, \"wrangler.jsonc\");\n\tconst currentWranglerJson = path.join(cwd, \"wrangler.json\");\n\n\tfor (const configPath of allConfigs) {\n\t\tconst resolvedPath = path.resolve(configPath);\n\t\t// Skip if it's the current directory's config\n\t\tif (\n\t\t\tresolvedPath === currentWranglerJsonc ||\n\t\t\tresolvedPath === currentWranglerJson\n\t\t) {\n\t\t\tcontinue;\n\t\t}\n\t\t// Make path relative to cwd\n\t\tconst relativePath = path.relative(cwd, configPath);\n\t\targs.push(\"-c\", relativePath);\n\t}\n\n\tfor (const envFile of envFiles) {\n\t\targs.push(\"--env-file\", envFile);\n\t}\n\n\targs.push(...extraWranglerArgs);\n\n\tconst command = `wrangler ${args.join(\" \")}`;\n\tconsole.log(`  Command: ${command}`);\n\n\tconst result = spawnSync(\"wrangler\", args, {\n\t\tcwd,\n\t\tstdio: \"inherit\",\n\t});\n\tif (result.status !== 0) {\n\t\tconsole.error(\"Failed to run wrangler types\");\n\t\tprocess.exit(1);\n\t}\n\tconsole.log(\"✓ Wrangler types generated with all workspace bindings\");\n}\n\n// Run all steps\ntry {\n\trunWranglerTypes();\n\tconsole.log(\"\\n✓ CF typegen completed successfully\");\n} catch (error: unknown) {\n\tconsole.error(\"\\n✗ CF typegen failed:\", error);\n\tprocess.exit(1);\n}\n"]}

package/dist/chunk-A4S7WGGQ.js

@@ -0,0 +1,51 @@
+import * as fs from 'fs';
+import path from 'path';
+import process from 'process';
+
+// src/utils/prepare-env.ts
+function isCiEnvironment() {
+  return Boolean(process.env.CI) || process.env.GITHUB_ACTIONS === "true";
+}
+function prepareEnvFiles(targetDir) {
+  const exampleEnvPath = path.join(targetDir, ".env.example");
+  const exampleEnvLocalPath = path.join(targetDir, ".env.local.example");
+  const exampleEnvExists = fs.existsSync(exampleEnvPath);
+  const exampleLocalEnvExists = fs.existsSync(exampleEnvLocalPath);
+  const envPath = path.join(targetDir, ".env");
+  const envLocalPath = path.join(targetDir, ".env.local");
+  let envExists = fs.existsSync(envPath);
+  let envLocalExists = fs.existsSync(envLocalPath);
+  const allowCopies = !isCiEnvironment();
+  if (allowCopies && exampleEnvExists) {
+    if (!envExists) {
+      fs.cpSync(exampleEnvPath, envPath);
+      console.log("\u2713 Created .env from .env.example");
+      envExists = true;
+    }
+  }
+  if (allowCopies && exampleLocalEnvExists) {
+    if (!envLocalExists) {
+      fs.cpSync(exampleEnvLocalPath, envLocalPath);
+      console.log("\u2713 Created .env.local from .env.local.example");
+      envLocalExists = true;
+    }
+  }
+  const result = [];
+  if (exampleEnvExists) {
+    result.push(".env.example");
+  }
+  if (exampleLocalEnvExists) {
+    result.push(".env.local.example");
+  }
+  if (!exampleEnvExists && envExists) {
+    result.push(".env");
+  }
+  if (!exampleLocalEnvExists && envLocalExists) {
+    result.push(".env.local");
+  }
+  return result;
+}
+
+export { prepareEnvFiles };
+//# sourceMappingURL=chunk-A4S7WGGQ.js.map
+//# sourceMappingURL=chunk-A4S7WGGQ.js.map

package/dist/chunk-A4S7WGGQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/prepare-env.ts"],"names":[],"mappings":";;;;;AAIA,SAAS,eAAA,GAA2B;AACnC,EAAA,OAAO,QAAQ,OAAA,CAAQ,GAAA,CAAI,EAAE,CAAA,IAAK,OAAA,CAAQ,IAAI,cAAA,KAAmB,MAAA;AAClE;AAWO,SAAS,gBAAgB,SAAA,EAA6B;AAC5D,EAAA,MAAM,cAAA,GAAiB,IAAA,CAAK,IAAA,CAAK,SAAA,EAAW,cAAc,CAAA;AAC1D,EAAA,MAAM,mBAAA,GAAsB,IAAA,CAAK,IAAA,CAAK,SAAA,EAAW,oBAAoB,CAAA;AAErE,EAAA,MAAM,gBAAA,GAAsB,cAAW,cAAc,CAAA;AACrD,EAAA,MAAM,qBAAA,GAA2B,cAAW,mBAAmB,CAAA;AAE/D,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,IAAA,CAAK,SAAA,EAAW,MAAM,CAAA;AAC3C,EAAA,MAAM,YAAA,GAAe,IAAA,CAAK,IAAA,CAAK,SAAA,EAAW,YAAY,CAAA;AAEtD,EAAA,IAAI,SAAA,GAAe,cAAW,OAAO,CAAA;AACrC,EAAA,IAAI,cAAA,GAAoB,cAAW,YAAY,CAAA;AAE/C,EAAA,MAAM,WAAA,GAAc,CAAC,eAAA,EAAgB;AAErC,EAAA,IAAI,eAAe,gBAAA,EAAkB;AACpC,IAAA,IAAI,CAAC,SAAA,EAAW;AACf,MAAG,EAAA,CAAA,MAAA,CAAO,gBAAgB,OAAO,CAAA;AAEjC,MAAA,OAAA,CAAQ,IAAI,uCAAkC,CAAA;AAC9C,MAAA,SAAA,GAAY,IAAA;AAAA,IACb;AAAA,EACD;AAEA,EAAA,IAAI,eAAe,qBAAA,EAAuB;AACzC,IAAA,IAAI,CAAC,cAAA,EAAgB;AACpB,MAAG,EAAA,CAAA,MAAA,CAAO,qBAAqB,YAAY,CAAA;AAE3C,MAAA,OAAA,CAAQ,IAAI,mDAA8C,CAAA;AAC1D,MAAA,cAAA,GAAiB,IAAA;AAAA,IAClB;AAAA,EACD;AAEA,EAAA,MAAM,SAAmB,EAAC;AAE1B,EAAA,IAAI,gBAAA,EAAkB;AACrB,IAAA,MAAA,CAAO,KAAK,cAAc,CAAA;AAAA,EAC3B;AACA,EAAA,IAAI,qBAAA,EAAuB;AAC1B,IAAA,MAAA,CAAO,KAAK,oBAAoB,CAAA;AAAA,EACjC;AAIA,EAAA,IAAI,CAAC,oBAAoB,SAAA,EAAW;AACnC,IAAA,MAAA,CAAO,KAAK,MAAM,CAAA;AAAA,EACnB;AACA,EAAA,IAAI,CAAC,yBAAyB,cAAA,EAAgB;AAC7C,IAAA,MAAA,CAAO,KAAK,YAAY,CAAA;AAAA,EACzB;AAEA,EAAA,OAAO,MAAA;AACR","file":"chunk-A4S7WGGQ.js","sourcesContent":["import * as fs from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\n\nfunction isCiEnvironment(): boolean {\n\treturn Boolean(process.env.CI) || process.env.GITHUB_ACTIONS === \"true\";\n}\n\n/**\n * Ensures a .env and .env.local file exists in the target directory.\n * If it doesn't exist, copies from .env.example and .env.local.example.\n *\n * In CI, does not create those files — typegen uses `.env.example` / `.env.local.example` only when real files are absent.\n *\n * @param targetDir - The directory where the .env and .env.local files should exist\n * @returns An array of the files that were created or already existed\n */\nexport function prepareEnvFiles(targetDir: string): string[] {\n\tconst exampleEnvPath = path.join(targetDir, \".env.example\");\n\tconst exampleEnvLocalPath = path.join(targetDir, \".env.local.example\");\n\n\tconst exampleEnvExists = fs.existsSync(exampleEnvPath);\n\tconst exampleLocalEnvExists = fs.existsSync(exampleEnvLocalPath);\n\n\tconst envPath = path.join(targetDir, \".env\");\n\tconst envLocalPath = path.join(targetDir, \".env.local\");\n\n\tlet envExists = fs.existsSync(envPath);\n\tlet envLocalExists = fs.existsSync(envLocalPath);\n\n\tconst allowCopies = !isCiEnvironment();\n\n\tif (allowCopies && exampleEnvExists) {\n\t\tif (!envExists) {\n\t\t\tfs.cpSync(exampleEnvPath, envPath);\n\n\t\t\tconsole.log(\"✓ Created .env from .env.example\");\n\t\t\tenvExists = true;\n\t\t}\n\t}\n\n\tif (allowCopies && exampleLocalEnvExists) {\n\t\tif (!envLocalExists) {\n\t\t\tfs.cpSync(exampleEnvLocalPath, envLocalPath);\n\n\t\t\tconsole.log(\"✓ Created .env.local from .env.local.example\");\n\t\t\tenvLocalExists = true;\n\t\t}\n\t}\n\n\tconst result: string[] = [];\n\t// The order matters, because latter files' values will override former files' values\n\tif (exampleEnvExists) {\n\t\tresult.push(\".env.example\");\n\t}\n\tif (exampleLocalEnvExists) {\n\t\tresult.push(\".env.local.example\");\n\t}\n\t// Only pass real .env / .env.local when there is no corresponding example file.\n\t// Otherwise `wrangler types` embeds different `--env-file` lists locally (with\n\t// .env.local) vs CI (no .env.local), causing noisy diffs in committed worker-configuration.d.ts.\n\tif (!exampleEnvExists && envExists) {\n\t\tresult.push(\".env\");\n\t}\n\tif (!exampleLocalEnvExists && envLocalExists) {\n\t\tresult.push(\".env.local\");\n\t}\n\n\treturn result;\n}\n"]}

package/dist/chunk-QEZL4IJI.js

@@ -0,0 +1,77 @@
+import * as fs from 'fs';
+import path from 'path';
+
+// src/cf-typegen-discovery.ts
+function findWorkspaceRoot(startPath) {
+  let dir = path.resolve(startPath);
+  for (; ; ) {
+    const pkgPath = path.join(dir, "package.json");
+    if (fs.existsSync(pkgPath)) {
+      try {
+        const content = fs.readFileSync(pkgPath, "utf8");
+        const pkg = JSON.parse(content);
+        if (pkg.workspaces != null && (Array.isArray(pkg.workspaces) || typeof pkg.workspaces === "object" && "packages" in pkg.workspaces)) {
+          return dir;
+        }
+      } catch {
+      }
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+function expandWorkspacePatterns(root, patterns) {
+  const dirs = [];
+  for (const pattern of patterns) {
+    if (!pattern.endsWith("/*")) continue;
+    const base = pattern.slice(0, -2);
+    const basePath = path.join(root, base);
+    try {
+      const entries = fs.readdirSync(basePath, { withFileTypes: true });
+      for (const e of entries) {
+        if (e.isDirectory()) {
+          dirs.push(path.join(basePath, e.name));
+        }
+      }
+    } catch {
+    }
+  }
+  return dirs;
+}
+function getWorkspacePaths(root) {
+  const pkgPath = path.join(root, "package.json");
+  try {
+    const content = fs.readFileSync(pkgPath, "utf8");
+    const pkg = JSON.parse(content);
+    const raw = Array.isArray(pkg.workspaces) ? pkg.workspaces : pkg.workspaces?.packages;
+    if (!Array.isArray(raw)) return [];
+    return expandWorkspacePatterns(root, raw);
+  } catch {
+    return [];
+  }
+}
+function findWranglerConfigsInPaths(workspacePaths) {
+  const results = [];
+  for (const dir of workspacePaths) {
+    for (const name of ["wrangler.json", "wrangler.jsonc"]) {
+      const fullPath = path.join(dir, name);
+      if (fs.existsSync(fullPath)) {
+        results.push(fullPath);
+        break;
+      }
+    }
+  }
+  return results.sort((a, b) => a < b ? -1 : 1);
+}
+function discoverWranglerConfigs(cwd) {
+  const workspaceRoot = findWorkspaceRoot(cwd);
+  if (!workspaceRoot) return [];
+  const workspacePaths = getWorkspacePaths(workspaceRoot);
+  return findWranglerConfigsInPaths(workspacePaths);
+}
+
+export { discoverWranglerConfigs, expandWorkspacePatterns, findWorkspaceRoot, findWranglerConfigsInPaths, getWorkspacePaths };
+//# sourceMappingURL=chunk-QEZL4IJI.js.map
+//# sourceMappingURL=chunk-QEZL4IJI.js.map

package/dist/chunk-QEZL4IJI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cf-typegen-discovery.ts"],"names":[],"mappings":"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","file":"chunk-QEZL4IJI.js","sourcesContent":["import * as fs from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Find workspace root by walking up from startPath until we find a package.json\n * with a \"workspaces\" field (npm/bun convention).\n */\nexport function findWorkspaceRoot(startPath: string): string | null {\n\tlet dir = path.resolve(startPath);\n\tfor (;;) {\n\t\tconst pkgPath = path.join(dir, \"package.json\");\n\t\tif (fs.existsSync(pkgPath)) {\n\t\t\ttry {\n\t\t\t\tconst content = fs.readFileSync(pkgPath, \"utf8\");\n\t\t\t\tconst pkg = JSON.parse(content) as { workspaces?: unknown };\n\t\t\t\tif (\n\t\t\t\t\tpkg.workspaces != null &&\n\t\t\t\t\t(Array.isArray(pkg.workspaces) ||\n\t\t\t\t\t\t(typeof pkg.workspaces === \"object\" &&\n\t\t\t\t\t\t\t\"packages\" in pkg.workspaces))\n\t\t\t\t) {\n\t\t\t\t\treturn dir;\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// ignore parse errors\n\t\t\t}\n\t\t}\n\t\tconst parent = path.dirname(dir);\n\t\tif (parent === dir) break;\n\t\tdir = parent;\n\t}\n\treturn null;\n}\n\n/**\n * Expand workspace glob patterns (e.g. \"packages/*\", \"tests/*\") to absolute paths.\n * Only supports single-level globs; each pattern must be exactly \"dirname/*\".\n */\nexport function expandWorkspacePatterns(\n\troot: string,\n\tpatterns: string[],\n): string[] {\n\tconst dirs: string[] = [];\n\tfor (const pattern of patterns) {\n\t\tif (!pattern.endsWith(\"/*\")) continue;\n\t\tconst base = pattern.slice(0, -2);\n\t\tconst basePath = path.join(root, base);\n\t\ttry {\n\t\t\tconst entries = fs.readdirSync(basePath, { withFileTypes: true });\n\t\t\tfor (const e of entries) {\n\t\t\t\tif (e.isDirectory()) {\n\t\t\t\t\tdirs.push(path.join(basePath, e.name));\n\t\t\t\t}\n\t\t\t}\n\t\t} catch {\n\t\t\t// base path may not exist\n\t\t}\n\t}\n\treturn dirs;\n}\n\n/**\n * Get workspace package paths from root package.json (workspaces field).\n * Returns absolute paths to each workspace member directory.\n */\nexport function getWorkspacePaths(root: string): string[] {\n\tconst pkgPath = path.join(root, \"package.json\");\n\ttry {\n\t\tconst content = fs.readFileSync(pkgPath, \"utf8\");\n\t\tconst pkg = JSON.parse(content) as {\n\t\t\tworkspaces?: string[] | { packages?: string[] };\n\t\t};\n\t\tconst raw = Array.isArray(pkg.workspaces)\n\t\t\t? pkg.workspaces\n\t\t\t: pkg.workspaces?.packages;\n\t\tif (!Array.isArray(raw)) return [];\n\t\treturn expandWorkspacePatterns(root, raw);\n\t} catch {\n\t\treturn [];\n\t}\n}\n\n/**\n * Find all wrangler config files under the given workspace member paths.\n * Does not rely on git; includes untracked configs (e.g. new durable objects).\n */\nexport function findWranglerConfigsInPaths(workspacePaths: string[]): string[] {\n\tconst results: string[] = [];\n\tfor (const dir of workspacePaths) {\n\t\tfor (const name of [\"wrangler.json\", \"wrangler.jsonc\"]) {\n\t\t\tconst fullPath = path.join(dir, name);\n\t\t\tif (fs.existsSync(fullPath)) {\n\t\t\t\tresults.push(fullPath);\n\t\t\t\tbreak; // at most one per dir\n\t\t\t}\n\t\t}\n\t}\n\treturn results.sort((a, b) => (a < b ? -1 : 1));\n}\n\n/**\n * Discover all wrangler config paths for the workspace containing cwd.\n * Returns empty array if not in a workspace or if root has no workspaces field.\n */\nexport function discoverWranglerConfigs(cwd: string): string[] {\n\tconst workspaceRoot = findWorkspaceRoot(cwd);\n\tif (!workspaceRoot) return [];\n\tconst workspacePaths = getWorkspacePaths(workspaceRoot);\n\treturn findWranglerConfigsInPaths(workspacePaths);\n}\n"]}

package/dist/chunk-TYKZZZOR.js

@@ -0,0 +1,48 @@
+// src/WorkerClient.ts
+var WorkerClient = class {
+  constructor(options) {
+    this.clientSchema = options.clientSchema;
+    this.serverSchema = options.serverSchema;
+    this.onMessageCallback = options.onMessage;
+    this.onValidationErrorCallback = options.onValidationError;
+    this.worker = options.worker;
+    this.worker.addEventListener("message", (event) => {
+      this.handleMessage(event);
+    });
+    if (options.onError) {
+      this.worker.addEventListener("error", options.onError);
+    }
+  }
+  handleMessage(event) {
+    try {
+      const validatedMessage = this.serverSchema.parse(event.data);
+      this.onMessageCallback?.(validatedMessage);
+    } catch (error) {
+      const validationError = error instanceof Error ? error : new Error(String(error));
+      this.onValidationErrorCallback?.(validationError, event.data);
+    }
+  }
+  /**
+   * Send a message to the worker with validation
+   */
+  send(message) {
+    const validatedMessage = this.clientSchema.parse(message);
+    this.worker.postMessage(validatedMessage);
+  }
+  /**
+   * Terminate the worker
+   */
+  terminate() {
+    this.worker.terminate();
+  }
+  /**
+   * Get the underlying Worker instance
+   */
+  getWorker() {
+    return this.worker;
+  }
+};
+
+export { WorkerClient };
+//# sourceMappingURL=chunk-TYKZZZOR.js.map
+//# sourceMappingURL=chunk-TYKZZZOR.js.map

package/dist/chunk-TYKZZZOR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/WorkerClient.ts"],"names":[],"mappings":";AA6BO,IAAM,eAAN,MAAmD;AAAA,EAUzD,YAAY,OAAA,EAA8D;AACzE,IAAA,IAAA,CAAK,eAAe,OAAA,CAAQ,YAAA;AAC5B,IAAA,IAAA,CAAK,eAAe,OAAA,CAAQ,YAAA;AAC5B,IAAA,IAAA,CAAK,oBAAoB,OAAA,CAAQ,SAAA;AACjC,IAAA,IAAA,CAAK,4BAA4B,OAAA,CAAQ,iBAAA;AACzC,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AAGtB,IAAA,IAAA,CAAK,MAAA,CAAO,gBAAA,CAAiB,SAAA,EAAW,CAAC,KAAA,KAAwB;AAChE,MAAA,IAAA,CAAK,cAAc,KAAK,CAAA;AAAA,IACzB,CAAC,CAAA;AAED,IAAA,IAAI,QAAQ,OAAA,EAAS;AACpB,MAAA,IAAA,CAAK,MAAA,CAAO,gBAAA,CAAiB,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAA;AAAA,IACtD;AAAA,EACD;AAAA,EAEQ,cAAc,KAAA,EAA2B;AAChD,IAAA,IAAI;AAEH,MAAA,MAAM,gBAAA,GAAmB,IAAA,CAAK,YAAA,CAAa,KAAA,CAAM,MAAM,IAAI,CAAA;AAC3D,MAAA,IAAA,CAAK,oBAAoB,gBAAgB,CAAA;AAAA,IAC1C,SAAS,KAAA,EAAO;AAEf,MAAA,MAAM,eAAA,GACL,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AACzD,MAAA,IAAA,CAAK,yBAAA,GAA4B,eAAA,EAAiB,KAAA,CAAM,IAAI,CAAA;AAAA,IAC7D;AAAA,EACD;AAAA;AAAA;AAAA;AAAA,EAKO,KAAK,OAAA,EAA+B;AAE1C,IAAA,MAAM,gBAAA,GAAmB,IAAA,CAAK,YAAA,CAAa,KAAA,CAAM,OAAO,CAAA;AACxD,IAAA,IAAA,CAAK,MAAA,CAAO,YAAY,gBAAgB,CAAA;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKO,SAAA,GAAkB;AACxB,IAAA,IAAA,CAAK,OAAO,SAAA,EAAU;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKO,SAAA,GAAoB;AAC1B,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACb;AACD","file":"chunk-TYKZZZOR.js","sourcesContent":["import type { ZodType } from \"zod/v4\";\n\nexport interface WorkerClientOptions<TClientMessage, TServerMessage> {\n\t/**\n\t * Worker instance to wrap\n\t */\n\tworker: Worker;\n\t/**\n\t * Schema for validating messages sent to the worker\n\t */\n\tclientSchema: ZodType<TClientMessage>;\n\t/**\n\t * Schema for validating messages received from the worker\n\t */\n\tserverSchema: ZodType<TServerMessage>;\n\t/**\n\t * Callback for validated messages from the worker\n\t */\n\tonMessage?: (message: TServerMessage) => void;\n\t/**\n\t * Callback for when validation fails on incoming messages\n\t */\n\tonValidationError?: (error: Error, rawMessage: unknown) => void;\n\t/**\n\t * Callback for worker errors\n\t */\n\tonError?: (event: ErrorEvent) => void;\n}\n\nexport class WorkerClient<TClientMessage, TServerMessage> {\n\tprivate worker: Worker;\n\tprivate readonly clientSchema: ZodType<TClientMessage>;\n\tprivate readonly serverSchema: ZodType<TServerMessage>;\n\tprivate readonly onMessageCallback?: (message: TServerMessage) => void;\n\tprivate readonly onValidationErrorCallback?: (\n\t\terror: Error,\n\t\trawMessage: unknown,\n\t) => void;\n\n\tconstructor(options: WorkerClientOptions<TClientMessage, TServerMessage>) {\n\t\tthis.clientSchema = options.clientSchema;\n\t\tthis.serverSchema = options.serverSchema;\n\t\tthis.onMessageCallback = options.onMessage;\n\t\tthis.onValidationErrorCallback = options.onValidationError;\n\t\tthis.worker = options.worker;\n\n\t\t// Setup event handlers\n\t\tthis.worker.addEventListener(\"message\", (event: MessageEvent) => {\n\t\t\tthis.handleMessage(event);\n\t\t});\n\n\t\tif (options.onError) {\n\t\t\tthis.worker.addEventListener(\"error\", options.onError);\n\t\t}\n\t}\n\n\tprivate handleMessage(event: MessageEvent): void {\n\t\ttry {\n\t\t\t// Validate the incoming message\n\t\t\tconst validatedMessage = this.serverSchema.parse(event.data);\n\t\t\tthis.onMessageCallback?.(validatedMessage);\n\t\t} catch (error) {\n\t\t\t// Validation failed\n\t\t\tconst validationError =\n\t\t\t\terror instanceof Error ? error : new Error(String(error));\n\t\t\tthis.onValidationErrorCallback?.(validationError, event.data);\n\t\t}\n\t}\n\n\t/**\n\t * Send a message to the worker with validation\n\t */\n\tpublic send(message: TClientMessage): void {\n\t\t// Validate the outgoing message\n\t\tconst validatedMessage = this.clientSchema.parse(message);\n\t\tthis.worker.postMessage(validatedMessage);\n\t}\n\n\t/**\n\t * Terminate the worker\n\t */\n\tpublic terminate(): void {\n\t\tthis.worker.terminate();\n\t}\n\n\t/**\n\t * Get the underlying Worker instance\n\t */\n\tpublic getWorker(): Worker {\n\t\treturn this.worker;\n\t}\n}\n"]}

package/dist/chunk-UNYDCGUS.js

@@ -0,0 +1,45 @@
+// src/worker-helper.ts
+var WorkerHelper = class {
+  constructor(self, inputSchema, outputSchema, handlers) {
+    this.self = self;
+    this.inputSchema = inputSchema;
+    this.outputSchema = outputSchema;
+    this.handlers = handlers;
+    this.send = (response) => {
+      const outputValidation = this.outputSchema.safeParse(response);
+      if (!outputValidation.success) {
+        this.handlers.handleOutputValidationError(
+          outputValidation.error,
+          response
+        );
+        return;
+      }
+      this.self.postMessage(response);
+    };
+    this.setupMessageListener();
+  }
+  setupMessageListener() {
+    this.self.addEventListener("message", (event) => {
+      this.handleMessage(event);
+    });
+  }
+  async handleMessage(event) {
+    const validationResult = this.inputSchema.safeParse(event.data);
+    if (!validationResult.success) {
+      await this.handlers.handleInputValidationError(
+        validationResult.error,
+        event.data
+      );
+      return;
+    }
+    try {
+      await this.handlers.handleMessage(validationResult.data);
+    } catch (error) {
+      await this.handlers.handleProcessingError(error, validationResult.data);
+    }
+  }
+};
+
+export { WorkerHelper };
+//# sourceMappingURL=chunk-UNYDCGUS.js.map
+//# sourceMappingURL=chunk-UNYDCGUS.js.map

package/dist/chunk-UNYDCGUS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/worker-helper.ts"],"names":[],"mappings":";AAoBO,IAAe,eAAf,MAA6C;AAAA,EACnD,WAAA,CACS,IAAA,EACA,WAAA,EACA,YAAA,EACA,QAAA,EACP;AAJO,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,WAAA,GAAA,WAAA;AACA,IAAA,IAAA,CAAA,YAAA,GAAA,YAAA;AACA,IAAA,IAAA,CAAA,QAAA,GAAA,QAAA;AAKT,IAAA,IAAA,CAAU,IAAA,GAAO,CAAC,QAAA,KAAsB;AAEvC,MAAA,MAAM,gBAAA,GAAmB,IAAA,CAAK,YAAA,CAAa,SAAA,CAAU,QAAQ,CAAA;AAC7D,MAAA,IAAI,CAAC,iBAAiB,OAAA,EAAS;AAC9B,QAAA,IAAA,CAAK,QAAA,CAAS,2BAAA;AAAA,UACb,gBAAA,CAAiB,KAAA;AAAA,UACjB;AAAA,SACD;AACA,QAAA;AAAA,MACD;AAGA,MAAA,IAAA,CAAK,IAAA,CAAK,YAAY,QAAQ,CAAA;AAAA,IAC/B,CAAA;AAhBC,IAAA,IAAA,CAAK,oBAAA,EAAqB;AAAA,EAC3B;AAAA,EAiBQ,oBAAA,GAA6B;AACpC,IAAA,IAAA,CAAK,IAAA,CAAK,gBAAA,CAAiB,SAAA,EAAW,CAAC,KAAA,KAAwB;AAC9D,MAAA,IAAA,CAAK,cAAc,KAAK,CAAA;AAAA,IACzB,CAAC,CAAA;AAAA,EACF;AAAA,EAEA,MAAc,cAAc,KAAA,EAAoC;AAE/D,IAAA,MAAM,gBAAA,GAAmB,IAAA,CAAK,WAAA,CAAY,SAAA,CAAU,MAAM,IAAI,CAAA;AAE9D,IAAA,IAAI,CAAC,iBAAiB,OAAA,EAAS;AAC9B,MAAA,MAAM,KAAK,QAAA,CAAS,0BAAA;AAAA,QACnB,gBAAA,CAAiB,KAAA;AAAA,QACjB,KAAA,CAAM;AAAA,OACP;AACA,MAAA;AAAA,IACD;AAGA,IAAA,IAAI;AACH,MAAA,MAAM,IAAA,CAAK,QAAA,CAAS,aAAA,CAAc,gBAAA,CAAiB,IAAI,CAAA;AAAA,IACxD,SAAS,KAAA,EAAO;AACf,MAAA,MAAM,IAAA,CAAK,QAAA,CAAS,qBAAA,CAAsB,KAAA,EAAO,iBAAiB,IAAI,CAAA;AAAA,IACvE;AAAA,EACD;AACD","file":"chunk-UNYDCGUS.js","sourcesContent":["import type { ZodError, ZodType } from \"zod/v4\";\n\ntype MessageTarget = DedicatedWorkerGlobalScope;\n\nexport type WorkerHelperHandlers<TInput, TOutput> = {\n\thandleMessage: (data: TInput) => void | Promise<void>;\n\thandleInputValidationError: (\n\t\terror: ZodError<TInput>,\n\t\toriginalData: unknown,\n\t) => void | Promise<void>;\n\thandleOutputValidationError: (\n\t\terror: ZodError<TOutput>,\n\t\toriginalData: TOutput,\n\t) => void | Promise<void>;\n\thandleProcessingError: (\n\t\terror: unknown,\n\t\tvalidatedData: TInput,\n\t) => void | Promise<void>;\n};\n\nexport abstract class WorkerHelper<TInput, TOutput> {\n\tconstructor(\n\t\tprivate self: MessageTarget,\n\t\tprivate inputSchema: ZodType<TInput>,\n\t\tprivate outputSchema: ZodType<TOutput>,\n\t\tprivate handlers: WorkerHelperHandlers<TInput, TOutput>,\n\t) {\n\t\tthis.setupMessageListener();\n\t}\n\n\tprotected send = (response: TOutput) => {\n\t\t// Validate output before sending\n\t\tconst outputValidation = this.outputSchema.safeParse(response);\n\t\tif (!outputValidation.success) {\n\t\t\tthis.handlers.handleOutputValidationError(\n\t\t\t\toutputValidation.error,\n\t\t\t\tresponse,\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\t// Send as success response\n\t\tthis.self.postMessage(response);\n\t};\n\n\tprivate setupMessageListener(): void {\n\t\tthis.self.addEventListener(\"message\", (event: MessageEvent) => {\n\t\t\tthis.handleMessage(event);\n\t\t});\n\t}\n\n\tprivate async handleMessage(event: MessageEvent): Promise<void> {\n\t\t// Validate input using safeParse\n\t\tconst validationResult = this.inputSchema.safeParse(event.data);\n\n\t\tif (!validationResult.success) {\n\t\t\tawait this.handlers.handleInputValidationError(\n\t\t\t\tvalidationResult.error,\n\t\t\t\tevent.data,\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\t// Handle the validated message\n\t\ttry {\n\t\t\tawait this.handlers.handleMessage(validationResult.data);\n\t\t} catch (error) {\n\t\t\tawait this.handlers.handleProcessingError(error, validationResult.data);\n\t\t}\n\t}\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { WorkerClient, WorkerClientOptions } from './WorkerClient.js';
+export { WorkerHelper, WorkerHelperHandlers } from './worker-helper.js';
+import 'zod/v4';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { WorkerClient } from './chunk-TYKZZZOR.js';
+export { WorkerHelper } from './chunk-UNYDCGUS.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/utils/prepare-env.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Ensures a .env and .env.local file exists in the target directory.
+ * If it doesn't exist, copies from .env.example and .env.local.example.
+ *
+ * In CI, does not create those files — typegen uses `.env.example` / `.env.local.example` only when real files are absent.
+ *
+ * @param targetDir - The directory where the .env and .env.local files should exist
+ * @returns An array of the files that were created or already existed
+ */
+declare function prepareEnvFiles(targetDir: string): string[];
+
+export { prepareEnvFiles };

package/dist/utils/prepare-env.js

@@ -0,0 +1,3 @@
+export { prepareEnvFiles } from '../chunk-A4S7WGGQ.js';
+//# sourceMappingURL=prepare-env.js.map
+//# sourceMappingURL=prepare-env.js.map

package/dist/utils/prepare-env.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"prepare-env.js"}

package/dist/worker-helper.d.ts

@@ -0,0 +1,21 @@
+import { ZodType, ZodError } from 'zod/v4';
+
+type MessageTarget = DedicatedWorkerGlobalScope;
+type WorkerHelperHandlers<TInput, TOutput> = {
+    handleMessage: (data: TInput) => void | Promise<void>;
+    handleInputValidationError: (error: ZodError<TInput>, originalData: unknown) => void | Promise<void>;
+    handleOutputValidationError: (error: ZodError<TOutput>, originalData: TOutput) => void | Promise<void>;
+    handleProcessingError: (error: unknown, validatedData: TInput) => void | Promise<void>;
+};
+declare abstract class WorkerHelper<TInput, TOutput> {
+    private self;
+    private inputSchema;
+    private outputSchema;
+    private handlers;
+    constructor(self: MessageTarget, inputSchema: ZodType<TInput>, outputSchema: ZodType<TOutput>, handlers: WorkerHelperHandlers<TInput, TOutput>);
+    protected send: (response: TOutput) => void;
+    private setupMessageListener;
+    private handleMessage;
+}
+
+export { WorkerHelper, type WorkerHelperHandlers };

package/dist/worker-helper.js

@@ -0,0 +1,3 @@
+export { WorkerHelper } from './chunk-UNYDCGUS.js';
+//# sourceMappingURL=worker-helper.js.map
+//# sourceMappingURL=worker-helper.js.map

package/dist/worker-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"worker-helper.js"}

package/package.json

@@ -1,32 +1,36 @@
 {
 	"name": "@firtoz/worker-helper",
-	"version": "1.5.1",
+	"version": "1.6.1",
 	"description": "Type-safe Web Worker helper with Zod validation and Cloudflare Workers utilities (cf-typegen)",
-	"main": "./src/index.ts",
-	"module": "./src/index.ts",
-	"types": "./src/index.ts",
+	"type": "module",
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
 	"exports": {
 		".": {
-			"types": "./src/index.ts",
-			"import": "./src/index.ts",
-			"require": "./src/index.ts"
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
 		},
 		"./*": {
-			"types": "./src/*.ts",
-			"import": "./src/*.ts",
-			"require": "./src/*.ts"
+			"types": "./dist/*.d.ts",
+			"import": "./dist/*.js"
 		}
 	},
 	"bin": {
-		"cf-typegen": "./src/cf-typegen.ts"
+		"cf-typegen": "./dist/cf-typegen.js"
 	},
 	"files": [
+		"dist/**/*.js",
+		"dist/**/*.js.map",
+		"dist/**/*.d.ts",
 		"src/**/*.ts",
 		"README.md",
 		"CHANGELOG.md"
 	],
 	"scripts": {
-		"typecheck": "tsc --noEmit -p ./tsconfig.json",
+		"build": "tsup && bun ../../scripts/add-node-shebang.ts dist/cf-typegen.js",
+		"prepack": "bun run build",
+		"typecheck": "tsgo --noEmit -p ./tsconfig.json",
 		"lint": "biome check --write src",
 		"lint:ci": "biome ci src",
 		"format": "biome format src --write",
@@ -67,8 +71,8 @@
 		"zod": "^4.3.6"
 	},
 	"devDependencies": {
-		"@types/node": "^25.5.0",
-		"@firtoz/maybe-error": "^1.5.2",
-		"bun-types": "^1.3.11"
+		"@types/node": "^25.6.0",
+		"@firtoz/maybe-error": "^1.6.1",
+		"bun-types": "^1.3.12"
 	}
 }

package/src/utils/prepare-env.ts

@@ -56,10 +56,13 @@ export function prepareEnvFiles(targetDir: string): string[] {
 	if (exampleLocalEnvExists) {
 		result.push(".env.local.example");
 	}
-	if (envExists) {
+	// Only pass real .env / .env.local when there is no corresponding example file.
+	// Otherwise `wrangler types` embeds different `--env-file` lists locally (with
+	// .env.local) vs CI (no .env.local), causing noisy diffs in committed worker-configuration.d.ts.
+	if (!exampleEnvExists && envExists) {
 		result.push(".env");
 	}
-	if (envLocalExists) {
+	if (!exampleLocalEnvExists && envLocalExists) {
 		result.push(".env.local");
 	}