build: dual CJS/ESM output, ES2020 target, Node 18 floor

"exports" gains "import" and "types" next to "require": import "alex2node" failed with
ERR_PACKAGE_PATH_NOT_EXPORTED. scripts/build.mjs compiles src/ to dist/cjs, dist/esm and dist/types in a staging
directory and swaps them in only when both compiler runs passed. "main" and "types" follow for resolvers that do
not read "exports". Target ES6 -> ES2020, "engines": node >= 18, relative imports carry ".js" for Node's ESM loader.
uuid gives way to crypto.randomUUID(); mqtt is the only runtime dependency left.

Tests load the package by name. New: both entry points, the modules the builds import, dist/ equal to a fresh
build, a round trip on the ES module build, and two compiled type fixtures in place of the .d.ts regexes.
22 tests pass in 5.7 s. dist/: 16 files, 79,711 B -> 25 files, 132,291 B; the npm tarball is 25,125 B.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
David 2026-09-28 13:58:17 +00:00
parent 58869d44c1
commit 1d88c7811a
50 changed files with 1472 additions and 195 deletions

10
test/fixtures/types.mts vendored Normal file
View file

@ -0,0 +1,10 @@
// Compiled, never run: the same declarations as seen from an ES module. Without a "types" condition in "exports" the
// import resolves to dist/esm/index.js, which has no declarations next to it, and this file fails with TS7016.
import { Alex2MQTT, DEFAULT_HOST, EndpointHealth } from "alex2node";
import type { Device } from "alex2node";
const bridge = new Alex2MQTT("user", "password", "root", false, { host: DEFAULT_HOST });
const devices: Device[] = bridge.getDevices();
const health: EndpointHealth = EndpointHealth.OK;
export { devices, health };