@checkdigit/typescript-config 3.4.0 → 3.6.0-PR.38-9dab

package/README.md

@@ -25,7 +25,7 @@ types, and `esbuild` for generating code.
 
 #### Options
 
-- `--type` the type of module to generate. Defaults to `module` (ESM). Valid values are `commonjs` and `module`.
+- `--type` the type of output to generate. Defaults to `module` (ESM). Valid values are `commonjs`, `module` or `types`.
 - `--entryPoint` the entry point for the bundle, relative to the inDir. if not provided, the files in the inDir will
   be processed as individual unbundled files.
 - `--inDir` the input source code directory.

package/bin/builder.mjs

@@ -78,8 +78,9 @@ async function builder_default({
     moduleResolution: typescript.ModuleResolutionKind.Bundler,
     target: typescript.ScriptTarget.ESNext,
     declaration: true,
+    noEmit: type2 !== "types",
     noEmitOnError: true,
-    emitDeclarationOnly: true,
+    emitDeclarationOnly: type2 === "types",
     rootDir: inDir2,
     outDir: outDir2,
     noLib: false,
@@ -120,8 +121,11 @@ async function builder_default({
       messages2.push(`tsc: ${typescript.flattenDiagnosticMessageText(diagnostic.messageText, "\n")}`);
     }
   }
-  if (emitResult.emitSkipped) {
-    throw new Error(`TypeScript compilation failed ${JSON.stringify(messages2)}`);
+  if (messages2.length > 0) {
+    throw new Error(`tsc failed ${JSON.stringify(messages2)}`);
+  }
+  if (type2 === "types") {
+    return [];
   }
   const buildResult = await build({
     entryPoints: productionSourceFiles,
@@ -177,7 +181,7 @@ var {
     sourceMap: { type: "boolean", short: "s", default: false }
   }
 });
-assert2.ok(type === "module" || type === "commonjs", "type must be module or commonjs");
+assert2.ok(type === "module" || type === "commonjs" || type === "types", "type must be types, module or commonjs");
 assert2.ok(inDir !== void 0, "inDir is required");
 assert2.ok(outDir !== void 0, "outDir is required");
 var messages = await builder_default({

package/package.json

@@ -1,196 +1 @@
-{
-  "name": "@checkdigit/typescript-config",
-  "version": "3.4.0",
-  "description": "Check Digit standard Typescript configuration",
-  "prettier": "@checkdigit/prettier-config",
-  "engines": {
-    "node": ">=16"
-  },
-  "bin": {
-    "builder": "./bin/builder.mjs"
-  },
-  "peerDependencies": {
-    "@types/node": ">=16",
-    "esbuild": "0.17.19",
-    "typescript": ">=5.0.4 <5.1"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/checkdigit/typescript-config.git"
-  },
-  "author": "Check Digit, LLC",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/checkdigit/typescript-config/issues"
-  },
-  "homepage": "https://github.com/checkdigit/typescript-config#readme",
-  "scripts": {
-    "preversion": "npm test",
-    "postversion": "git push && git push --tags",
-    "prepare": "npm run build-builder",
-    "lint:fix": "eslint -f unix --ext .ts,.mts src --fix",
-    "lint": "eslint -f unix --ext .ts,.mts src",
-    "prettier": "prettier --ignore-path .gitignore --list-different .",
-    "prettier:fix": "prettier --ignore-path .gitignore --write .",
-    "test": "npm run ci:compile && npm run ci:test && npm run ci:lint && npm run ci:style",
-    "build-builder": "esbuild src/builder/index.mts --bundle --platform=node --format=esm --external:typescript --external:esbuild --outfile=build-builder/builder.mjs && mkdir -p bin && { echo '#!/usr/bin/env node'; cat build-builder/builder.mjs; } > bin/builder.mjs && chmod +x bin/builder.mjs",
-    "build-cjs": "rimraf build-cjs && npx builder --type=commonjs --outDir=build-cjs",
-    "build-cjs-bundle": "rimraf build-cjs-bundle && npx builder --type=commonjs --entryPoint=test/index.test.ts --outDir=build-cjs-bundle --outFile=test/index.test.cjs --minify --sourceMap",
-    "build-cjs-bundle-no-external": "rimraf build-cjs-bundle-no-external && npx builder --type=commonjs --external=./node_modules/* --entryPoint=test/index.test.ts --outDir=build-cjs-bundle-no-external --outFile=test/index.test.cjs",
-    "build-esm": "rimraf build-esm && npx builder --type=module --outDir=build-esm",
-    "build-esm-bundle": "rimraf build-esm-bundle && npx builder --type=module --outDir=build-esm-bundle --entryPoint=test/index.test.ts --outFile=test/index.test.mjs",
-    "build-esm-bundle-no-external": "rimraf build-esm-bundle-no-external && npx builder --type=module --external=./node_modules/* --outDir=build-esm-bundle-no-external --entryPoint=test/index.test.ts --outFile=test/index.test.mjs --minify",
-    "test-jest-esm": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --coverage=false src/*.mts src/*/*.mts src/*/*/*.mts",
-    "test-jest-cjs": "jest --coverage=false src/*.ts src/*/*.ts src/*/*/*.ts",
-    "test-cjs": "node --test build-cjs/test/index.test.cjs",
-    "test-cjs-bundle": "node --test build-cjs-bundle/test/index.test.cjs",
-    "test-cjs-bundle-no-external": "node --test build-cjs-bundle-no-external/test/index.test.cjs",
-    "test-esm": "node --test build-esm/test/index.test.mjs",
-    "test-esm-bundle": "echo \"node --test build-esm-bundle/test/index.test.mjs\"",
-    "test-esm-bundle-no-external": "node --test build-esm-bundle-no-external/test/index.test.mjs",
-    "ci:test": "npm run test-jest-cjs && npm run test-jest-esm && npm run test-cjs && npm run test-cjs-bundle && npm run test-cjs-bundle-no-external && npm run test-esm && npm run test-esm-bundle && npm run test-esm-bundle-no-external",
-    "ci:compile": "npm run build-builder && npm run build-cjs && npm run build-cjs-bundle && npm run build-cjs-bundle-no-external && npm run build-esm && npm run build-esm-bundle && npm run build-esm-bundle-no-external",
-    "ci:lint": "npm run lint",
-    "ci:style": "npm run prettier"
-  },
-  "devDependencies": {
-    "@checkdigit/prettier-config": "^3.4.0",
-    "@types/debug": "^4.1.7",
-    "@types/jest": "^29.5.1",
-    "@types/uuid": "^9.0.1",
-    "@typescript-eslint/eslint-plugin": "^5.59.6",
-    "@typescript-eslint/parser": "^5.59.6",
-    "debug": "^4.3.4",
-    "eslint": "^8.40.0",
-    "eslint-config-prettier": "^8.8.0",
-    "get-port": "^6.1.2",
-    "got": "^11.8.6",
-    "jest": "^29.5.0",
-    "rimraf": "^5.0.1",
-    "ts-jest": "^29.1.0",
-    "uuid": "^9.0.0"
-  },
-  "eslintConfig": {
-    "parser": "@typescript-eslint/parser",
-    "plugins": [
-      "@typescript-eslint"
-    ],
-    "parserOptions": {
-      "project": "./tsconfig.json"
-    },
-    "extends": [
-      "eslint:all",
-      "plugin:@typescript-eslint/recommended",
-      "plugin:@typescript-eslint/recommended-requiring-type-checking",
-      "plugin:@typescript-eslint/strict",
-      "prettier"
-    ],
-    "rules": {
-      "@typescript-eslint/non-nullable-type-assertion-style": "error",
-      "capitalized-comments": "off",
-      "one-var": "off",
-      "sort-keys": "off",
-      "sort-imports": "off",
-      "func-style": [
-        "error",
-        "declaration",
-        {
-          "allowArrowFunctions": true
-        }
-      ],
-      "no-magic-numbers": [
-        "error",
-        {
-          "ignore": [
-            0,
-            1,
-            2
-          ]
-        }
-      ],
-      "no-undefined": "off",
-      "no-ternary": "off"
-    },
-    "overrides": [
-      {
-        "files": [
-          "*.spec.mts",
-          "*.test.mts",
-          "*.spec.ts",
-          "*.test.ts"
-        ],
-        "rules": {
-          "@typescript-eslint/non-nullable-type-assertion-style": "off",
-          "@typescript-eslint/ban-types": "off",
-          "@typescript-eslint/require-await": "off",
-          "@typescript-eslint/consistent-type-definitions": "off",
-          "@typescript-eslint/ban-ts-comment": "off",
-          "@typescript-eslint/no-unnecessary-condition": "off",
-          "@typescript-eslint/consistent-indexed-object-style": "off",
-          "@typescript-eslint/no-unused-vars": "off",
-          "@typescript-eslint/no-unsafe-member-access": "off",
-          "line-comment-position": "off",
-          "no-inline-comments": "off",
-          "no-param-reassign": "off",
-          "id-length": "off",
-          "no-magic-numbers": "off",
-          "func-names": "off",
-          "no-duplicate-imports": "off",
-          "symbol-description": "off",
-          "no-invalid-this": "off",
-          "max-lines-per-function": "off",
-          "max-lines": "off",
-          "max-statements": "off",
-          "no-await-in-loop": "off"
-        }
-      }
-    ]
-  },
-  "jest": {
-    "moduleFileExtensions": [
-      "js",
-      "mjs",
-      "cjs",
-      "ts",
-      "mts",
-      "json",
-      "node"
-    ],
-    "extensionsToTreatAsEsm": [
-      ".mts"
-    ],
-    "transform": {
-      "^.+\\.mts$": [
-        "ts-jest",
-        {
-          "isolatedModules": true,
-          "diagnostics": false,
-          "useESM": true
-        }
-      ],
-      "^.+\\.ts$": [
-        "ts-jest",
-        {
-          "isolatedModules": true,
-          "diagnostics": false,
-          "useESM": false
-        }
-      ]
-    },
-    "collectCoverageFrom": [
-      "<rootDir>/src/**",
-      "!<rootDir>/src/**/*.spec.mts",
-      "!<rootDir>/src/**/*.test.mts",
-      "!<rootDir>/src/**/*.spec.ts",
-      "!<rootDir>/src/**/*.test.ts"
-    ],
-    "testMatch": [
-      "<rootDir>/src/**/*.spec.ts",
-      "<rootDir>/src/**/*.spec.mts"
-    ]
-  },
-  "files": [
-    "tsconfig.json",
-    "SECURITY.md"
-  ]
-}
+{"name":"@checkdigit/typescript-config","version":"3.6.0-PR.38-9dab","description":"Check Digit standard Typescript configuration","prettier":"@checkdigit/prettier-config","engines":{"node":">=16"},"bin":{"builder":"./bin/builder.mjs"},"peerDependencies":{"@types/node":">=16","esbuild":"0.17.19","typescript":">=5.1.3 <5.2"},"repository":{"type":"git","url":"git+https://github.com/checkdigit/typescript-config.git"},"author":"Check Digit, LLC","license":"MIT","bugs":{"url":"https://github.com/checkdigit/typescript-config/issues"},"homepage":"https://github.com/checkdigit/typescript-config#readme","scripts":{"preversion":"npm test","postversion":"git push && git push --tags","prepare":"npm run build-builder","lint:fix":"eslint -f unix --ext .ts,.mts src --fix","lint":"eslint -f unix --ext .ts,.mts src","prettier":"prettier --ignore-path .gitignore --list-different .","prettier:fix":"prettier --ignore-path .gitignore --write .","test":"npm run ci:compile && npm run ci:test && npm run ci:lint && npm run ci:style","build-builder":"esbuild src/builder/index.mts --bundle --platform=node --format=esm --external:typescript --external:esbuild --outfile=build-builder/builder.mjs && mkdir -p bin && { echo '#!/usr/bin/env node'; cat build-builder/builder.mjs; } > bin/builder.mjs && chmod +x bin/builder.mjs","build-types":"rimraf build-types && npx builder --type=types --outDir=build-types","build-cjs":"rimraf build-cjs && npx builder --type=commonjs --outDir=build-cjs","build-cjs-bundle":"rimraf build-cjs-bundle && npx builder --type=commonjs --entryPoint=test/index.test.ts --outDir=build-cjs-bundle --outFile=test/index.test.cjs --minify --sourceMap","build-cjs-bundle-no-external":"rimraf build-cjs-bundle-no-external && npx builder --type=commonjs --external=./node_modules/* --entryPoint=test/index.test.ts --outDir=build-cjs-bundle-no-external --outFile=test/index.test.cjs","build-esm":"rimraf build-esm && npx builder --type=module --outDir=build-esm","build-esm-bundle":"rimraf build-esm-bundle && npx builder --type=module --outDir=build-esm-bundle --entryPoint=test/index.test.ts --outFile=test/index.test.mjs","build-esm-bundle-no-external":"rimraf build-esm-bundle-no-external && npx builder --type=module --external=./node_modules/* --outDir=build-esm-bundle-no-external --entryPoint=test/index.test.ts --outFile=test/index.test.mjs --minify","test-jest-esm":"NODE_OPTIONS=\"--experimental-vm-modules\" jest --coverage=false src/*.mts src/*/*.mts src/*/*/*.mts","test-jest-cjs":"jest --coverage=false src/*.ts src/*/*.ts src/*/*/*.ts","test-cjs":"node --test build-cjs/test/index.test.cjs","test-cjs-bundle":"node --test build-cjs-bundle/test/index.test.cjs","test-cjs-bundle-no-external":"node --test build-cjs-bundle-no-external/test/index.test.cjs","test-esm":"node --test build-esm/test/index.test.mjs","test-esm-bundle":"echo \"node --test build-esm-bundle/test/index.test.mjs\"","test-esm-bundle-no-external":"node --test build-esm-bundle-no-external/test/index.test.mjs","ci:test":"npm run test-jest-cjs && npm run test-jest-esm && npm run test-cjs && npm run test-cjs-bundle && npm run test-cjs-bundle-no-external && npm run test-esm && npm run test-esm-bundle && npm run test-esm-bundle-no-external","ci:compile":"npm run build-builder && npm run build-types && npm run build-cjs && npm run build-cjs-bundle && npm run build-cjs-bundle-no-external && npm run build-esm && npm run build-esm-bundle && npm run build-esm-bundle-no-external","ci:lint":"npm run lint","ci:style":"npm run prettier"},"devDependencies":{"@checkdigit/prettier-config":"^3.4.0","@types/debug":"^4.1.8","@types/jest":"^29.5.2","@types/uuid":"^9.0.1","@typescript-eslint/eslint-plugin":"^5.59.8","@typescript-eslint/parser":"^5.59.8","debug":"^4.3.4","eslint":"^8.41.0","eslint-config-prettier":"^8.8.0","get-port":"^6.1.2","got":"^11.8.6","jest":"^29.5.0","rimraf":"^5.0.1","ts-jest":"^29.1.0","uuid":"^9.0.0"},"eslintConfig":{"parser":"@typescript-eslint/parser","plugins":["@typescript-eslint"],"parserOptions":{"project":"./tsconfig.json"},"extends":["eslint:all","plugin:@typescript-eslint/recommended","plugin:@typescript-eslint/recommended-requiring-type-checking","plugin:@typescript-eslint/strict","prettier"],"rules":{"@typescript-eslint/non-nullable-type-assertion-style":"error","capitalized-comments":"off","one-var":"off","sort-keys":"off","sort-imports":"off","func-style":["error","declaration",{"allowArrowFunctions":true}],"no-magic-numbers":["error",{"ignore":[0,1,2]}],"no-undefined":"off","no-ternary":"off"},"overrides":[{"files":["*.spec.mts","*.test.mts","*.spec.ts","*.test.ts"],"rules":{"@typescript-eslint/non-nullable-type-assertion-style":"off","@typescript-eslint/ban-types":"off","@typescript-eslint/require-await":"off","@typescript-eslint/consistent-type-definitions":"off","@typescript-eslint/ban-ts-comment":"off","@typescript-eslint/no-unnecessary-condition":"off","@typescript-eslint/consistent-indexed-object-style":"off","@typescript-eslint/no-unused-vars":"off","@typescript-eslint/no-unsafe-member-access":"off","line-comment-position":"off","no-inline-comments":"off","no-param-reassign":"off","id-length":"off","no-magic-numbers":"off","func-names":"off","no-duplicate-imports":"off","symbol-description":"off","no-invalid-this":"off","max-lines-per-function":"off","max-lines":"off","max-statements":"off","no-await-in-loop":"off"}}]},"jest":{"moduleFileExtensions":["js","mjs","cjs","ts","mts","json","node"],"extensionsToTreatAsEsm":[".mts"],"transform":{"^.+\\.mts$":["ts-jest",{"isolatedModules":true,"diagnostics":false,"useESM":true}],"^.+\\.ts$":["ts-jest",{"isolatedModules":true,"diagnostics":false,"useESM":false}]},"collectCoverageFrom":["<rootDir>/src/**","!<rootDir>/src/**/*.spec.mts","!<rootDir>/src/**/*.test.mts","!<rootDir>/src/**/*.spec.ts","!<rootDir>/src/**/*.test.ts"],"testMatch":["<rootDir>/src/**/*.spec.ts","<rootDir>/src/**/*.spec.mts"]},"files":["tsconfig.json","SECURITY.md","/src/"]}

package/src/builder/builder.mts

@@ -0,0 +1,236 @@
+// builder/builder.mts
+
+import { strict as assert } from 'node:assert';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import typescript from 'typescript';
+
+import { PluginBuild, build } from 'esbuild';
+
+export interface BuilderOptions {
+  /**
+   * whether to produce Typescript types, ESM or CommonJS code
+   */
+  type: 'module' | 'commonjs' | 'types';
+
+  /**
+   * the entry point for the bundle, relative to the inDir.  if not provided, the files in the inDir will be processed
+   * as individual unbundled files
+   */
+  entryPoint?: string | undefined;
+
+  /**
+   * source code
+   */
+  inDir: string;
+
+  /**
+   * build directory
+   */
+  outDir: string;
+
+  /**
+   * build file, relative to the outDir
+   */
+  outFile?: string | undefined;
+
+  /**
+   * external modules to exclude from the bundle
+   */
+  external?: string[] | undefined;
+
+  /**
+   * whether to minify output
+   */
+  minify?: boolean | undefined;
+
+  /**
+   * whether to include sourcemap
+   */
+  sourceMap?: boolean | undefined;
+}
+
+/**
+ * Recursively obtains all files in a directory
+ * @param {string} directory
+ * @returns {Promise<string[]>}
+ */
+async function getFiles(directory: string): Promise<string[]> {
+  const entries = await fs.readdir(directory, { withFileTypes: true });
+  const files = await Promise.all(
+    entries.map((entry) => {
+      const result = path.resolve(directory, entry.name);
+      return entry.isDirectory() ? getFiles(result) : result;
+    })
+  );
+  return files.flat();
+}
+
+function excludeSourceMaps(filter: RegExp) {
+  return (pluginBuild: PluginBuild) => {
+    // ignore source maps for any Javascript file that matches filter
+    pluginBuild.onLoad({ filter }, async (args) => {
+      if (args.path.endsWith('.js') || args.path.endsWith('.mjs') || args.path.endsWith('.cjs')) {
+        return {
+          contents: `${await fs.readFile(
+            args.path,
+            'utf8'
+          )}\n//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIiJdLCJtYXBwaW5ncyI6IkEifQ==`,
+          loader: 'default',
+        };
+      }
+      return undefined;
+    });
+  };
+}
+
+function resolveTypescriptPaths(type: 'module' | 'commonjs') {
+  const extension = type === 'module' ? 'mjs' : 'cjs';
+  return (pluginBuild: PluginBuild) => {
+    // rewrite paths based on standard node resolution
+    pluginBuild.onResolve({ filter: /.*/u }, async (resolved) => {
+      if (resolved.kind === 'entry-point' || !resolved.path.startsWith('.') || resolved.path.endsWith('.js')) {
+        return { external: resolved.kind !== 'entry-point' };
+      }
+      let isDirectory = false;
+      try {
+        const stats = await fs.lstat(path.join(resolved.resolveDir, resolved.path));
+        isDirectory = stats.isDirectory();
+      } catch {
+        // do nothing
+      }
+      let newPath = resolved.path;
+      newPath += isDirectory ? `/index.${extension}` : `.${extension}`;
+      return { path: newPath, external: true };
+    });
+  };
+}
+
+// eslint-disable-next-line func-names,max-lines-per-function,max-statements
+export default async function ({
+  type,
+  entryPoint,
+  inDir,
+  outDir,
+  outFile,
+  external = [],
+  minify = false,
+  sourceMap,
+}: BuilderOptions): Promise<string[]> {
+  const messages: string[] = [];
+
+  assert.ok(
+    (entryPoint === undefined && outFile === undefined) || (entryPoint !== undefined && outFile !== undefined),
+    'entryPoint and outFile must both be provided'
+  );
+
+  const allSourceFiles = await getFiles(inDir);
+  const productionSourceFiles =
+    entryPoint === undefined ? allSourceFiles.filter((file) => file.endsWith('.ts')) : [path.join(inDir, entryPoint)];
+
+  /**
+   * Emit declarations using typescript compiler, if type is 'types'.  Otherwise, just compile to ensure the build is good.
+   */
+  const program = typescript.createProgram(productionSourceFiles, {
+    module: typescript.ModuleKind.ESNext,
+    moduleResolution: typescript.ModuleResolutionKind.Bundler,
+    target: typescript.ScriptTarget.ESNext,
+    declaration: true,
+    noEmit: type !== 'types',
+    noEmitOnError: true,
+    emitDeclarationOnly: type === 'types',
+    rootDir: inDir,
+    outDir,
+    noLib: false,
+    skipLibCheck: true,
+    strict: true,
+    preserveConstEnums: true,
+    noImplicitReturns: true,
+    noUnusedLocals: true,
+    noUnusedParameters: true,
+    alwaysStrict: true,
+    verbatimModuleSyntax: false,
+    noFallthroughCasesInSwitch: true,
+    forceConsistentCasingInFileNames: true,
+    emitDecoratorMetadata: true,
+    experimentalDecorators: true,
+    resolveJsonModule: true,
+    esModuleInterop: true,
+    noUncheckedIndexedAccess: true,
+    noPropertyAccessFromIndexSignature: true,
+    allowUnusedLabels: false,
+    allowUnreachableCode: false,
+    noImplicitOverride: true,
+    useUnknownInCatchVariables: true,
+    exactOptionalPropertyTypes: true,
+  });
+  const emitResult = program.emit();
+  const allDiagnostics = typescript.sortAndDeduplicateDiagnostics([
+    ...typescript.getPreEmitDiagnostics(program),
+    ...emitResult.diagnostics,
+  ]);
+  for (const diagnostic of allDiagnostics) {
+    if (diagnostic.file) {
+      assert.ok(diagnostic.start !== undefined);
+      const { line, character } = typescript.getLineAndCharacterOfPosition(diagnostic.file, diagnostic.start);
+      const message = typescript.flattenDiagnosticMessageText(diagnostic.messageText, '\n');
+      messages.push(`tsc: ${diagnostic.file.fileName} (${line + 1},${character + 1}): ${message}`);
+    } else {
+      // eslint-disable-next-line no-console
+      messages.push(`tsc: ${typescript.flattenDiagnosticMessageText(diagnostic.messageText, '\n')}`);
+    }
+  }
+
+  if (messages.length > 0) {
+    throw new Error(`tsc failed ${JSON.stringify(messages)}`);
+  }
+
+  if (type === 'types') {
+    return [];
+  }
+
+  /**
+   * Emit ESM javascript using esbuild
+   */
+  const buildResult = await build({
+    entryPoints: productionSourceFiles,
+    bundle: true,
+    minify,
+    platform: 'node',
+    format: type === 'module' ? 'esm' : 'cjs',
+    sourcesContent: false,
+    sourcemap: sourceMap ? 'inline' : false,
+    ...(outFile === undefined
+      ? {
+          // individual files
+          outdir: outDir,
+          outExtension: { '.js': type === 'module' ? '.mjs' : '.cjs' },
+          plugins: [
+            {
+              name: 'resolve-typescript-paths',
+              setup: resolveTypescriptPaths(type),
+            },
+          ],
+        }
+      : {
+          // bundling
+          outfile: path.join(outDir, outFile),
+          legalComments: 'none',
+          external,
+          plugins: [
+            {
+              name: 'exclude-source-maps',
+              setup: excludeSourceMaps(/node_modules/u),
+            },
+          ],
+        }),
+  });
+
+  messages.push(...buildResult.errors.map((error) => `esbuild error: ${error.text}`));
+  messages.push(...buildResult.warnings.map((warning) => `esbuild warning: ${warning.text}`));
+  if (messages.length > 0) {
+    throw new Error(`esbuild failed ${JSON.stringify(messages)}`);
+  }
+
+  return messages;
+}

package/src/builder/index.mts

@@ -0,0 +1,44 @@
+// builder/index.mts
+
+import { strict as assert } from 'node:assert';
+import path from 'node:path';
+import { parseArgs } from 'node:util';
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-expect-error
+import builder from './builder.mts';
+
+const {
+  values: { type, inDir, outDir, entryPoint, outFile, external, minify, sourceMap },
+} = parseArgs({
+  options: {
+    type: { type: 'string', short: 't', default: 'module' },
+    inDir: { type: 'string', short: 'i', default: 'src' },
+    outDir: { type: 'string', short: 'o', default: 'build' },
+    entryPoint: { type: 'string', short: 'e', default: undefined },
+    outFile: { type: 'string', short: 'f', default: undefined },
+    external: { type: 'string', short: 'x', multiple: true, default: [] },
+    minify: { type: 'boolean', short: 'm', default: false },
+    sourceMap: { type: 'boolean', short: 's', default: false },
+  },
+});
+
+assert.ok(type === 'module' || type === 'commonjs' || type === 'types', 'type must be types, module or commonjs');
+assert.ok(inDir !== undefined, 'inDir is required');
+assert.ok(outDir !== undefined, 'outDir is required');
+
+const messages = await builder({
+  type,
+  inDir: path.join(process.cwd(), inDir),
+  outDir: path.join(process.cwd(), outDir),
+  entryPoint,
+  outFile,
+  external,
+  minify,
+  sourceMap,
+});
+if (messages.length > 0) {
+  // eslint-disable-next-line no-console
+  console.warn(JSON.stringify(messages, undefined, 2));
+  process.exit(1);
+}

package/src/test/typescript/module-directory/index.ts

@@ -0,0 +1,3 @@
+// module-directory/index.ts
+
+export default () => 'module-directory-index';