v0.1.4: Node strict-ESM compat (type: module + .js-extension rewrites)

Published 0.1.3 wouldn't load under Node's strict ESM loader: missing
`"type": "module"` made Node parse `dist/*.js` as CommonJS, so consumers
got `does not provide an export named 'createPool'` on a plain
`import { createPool } from '@perryts/mysql'`. Compounding that, the
compiled `dist/*.{js,d.ts}` carried extensionless relative imports
(`from './connection'`) that Node strict ESM refuses to resolve.

Two surgical fixes:
- `"type": "module"` in package.json so dist/*.js is parsed as ESM.
- Post-build script (scripts/fix-esm-imports.mjs) walks dist/, rewrites
  every relative import to `./foo.js`. Source files stay extensionless
  (24 files / 96 imports preserved); only build output is patched.

Verified locally: `node --input-type=module -e "import { createPool }
from './dist/index.js'"` resolves all named exports. Bun + Perry paths
are unaffected — failure was Node-strict-ESM only.

Author: proggeramlug

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## v0.1.4
+
+- Make the published package importable under Node's strict ESM loader.
+  `package.json` was missing `"type": "module"`, so Node parsed
+  `dist/*.js` as CommonJS and reported `does not provide an export
+  named 'createPool'` when consumers used `import { createPool } from
+  '@perryts/mysql'`. Compounding it, the compiled `dist/*.{js,d.ts}`
+  carried extensionless relative imports (`from './connection'`) that
+  Node strict ESM refuses to resolve.
+- Fix both: declare `"type": "module"` and add a post-build pass
+  (`scripts/fix-esm-imports.mjs`) that rewrites every relative import
+  in `dist/` to include an explicit `.js` extension. Source files stay
+  extensionless — only the compiled artifacts are patched.
+- Bun + Perry paths are unaffected; the failure was Node-strict-ESM only.
+
 ## v0.1.3
 
 - Fix the Perry path of `transport/net-socket.ts::openSocket` to call

package.json

@@ -1,6 +1,7 @@
 {
   "name": "@perryts/mysql",
-  "version": "0.1.3",
+  "version": "0.1.4",
+  "type": "module",
   "description": "Pure-TypeScript MySQL/MariaDB wire-protocol driver. Runs on Node.js and Bun, and compiles to a native binary via Perry (LLVM). Zero native dependencies.",
   "keywords": [
     "mysql",
@@ -42,7 +43,7 @@
   },
   "files": ["src/", "dist/", "README.md", "LICENSE", "CLAUDE.md"],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/fix-esm-imports.mjs",
     "test": "bun test",
     "test:unit": "bun test tests/unit",
     "test:integration": "bun test tests/integration",

scripts/fix-esm-imports.mjs

@@ -0,0 +1,69 @@
+// Post-tsc pass: rewrite relative imports in dist/*.{js,d.ts} to include
+// explicit `.js` extensions.
+//
+// Why this exists: package.json declares `type: module`, but the
+// TypeScript sources author imports as `from './connection'` (no
+// extension) because tsconfig uses `moduleResolution: bundler`. Node's
+// strict ESM loader (Node 22+) requires the file extension and won't
+// resolve `./connection` against `./connection.js` on disk.
+//
+// Rather than touching all ~24 source files (and re-locking developers
+// into adding `.js` to every TS import), patch only the compiled output.
+// Source files stay clean; published `.js` is Node-strict-ESM compliant.
+
+import { readdir, readFile, writeFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const DIST = join(dirname(fileURLToPath(import.meta.url)), '..', 'dist');
+
+// Walk dist/ recursively, return absolute paths matching the predicate.
+async function walk(dir) {
+  const out = [];
+  for (const entry of await readdir(dir, { withFileTypes: true })) {
+    const p = join(dir, entry.name);
+    if (entry.isDirectory()) out.push(...(await walk(p)));
+    else out.push(p);
+  }
+  return out;
+}
+
+// Match: from|import|export ... from '...' / "..." where '...' is a
+// relative path (./ or ../) with no extension. We deliberately do NOT
+// touch absolute/package imports, nor imports that already end in a
+// recognized extension (.js, .json, .css, .cjs, .mjs).
+const RE = /((?:\bfrom\s+|\bimport\s*\(\s*|\bexport\s+\{[^}]*\}\s+from\s+|\bimport\s+(?:[\w*${},\s]+?\s+from\s+)?))(['"])(\.\.?\/[^'"\n]+?)\2/g;
+
+function shouldSkip(path) {
+  return (
+    path.endsWith('.js') ||
+    path.endsWith('.cjs') ||
+    path.endsWith('.mjs') ||
+    path.endsWith('.json') ||
+    path.endsWith('.css')
+  );
+}
+
+function rewrite(source) {
+  let changed = 0;
+  const out = source.replace(RE, (match, prefix, quote, path) => {
+    if (shouldSkip(path)) return match;
+    changed++;
+    return `${prefix}${quote}${path}.js${quote}`;
+  });
+  return { out, changed };
+}
+
+let totalFiles = 0;
+let totalChanged = 0;
+for (const file of await walk(DIST)) {
+  if (!file.endsWith('.js') && !file.endsWith('.d.ts')) continue;
+  const src = await readFile(file, 'utf8');
+  const { out, changed } = rewrite(src);
+  if (changed > 0) {
+    await writeFile(file, out);
+    totalFiles++;
+    totalChanged += changed;
+  }
+}
+console.log(`fix-esm-imports: rewrote ${totalChanged} import(s) across ${totalFiles} file(s)`);