build/esm: add dual CJS+ESM output for comm and api-client (Phase 3)

Phase 3 of incremental CJS→ESM migration:

- Add tsconfig-esm.json and conditional exports for @cocalc/comm and
  @cocalc/api-client packages
- Standardize build scripts across all ESM-migrated packages to use
  `pnpm exec tsc` instead of `../node_modules/.bin/tsc`
- Each package now produces both dist/ (CJS) and dist-esm/ (ESM) output

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: haraldschilly

src/packages/api-client/package.json

@@ -3,12 +3,30 @@
   "version": "0.1.2",
   "description": "CoCalc api client - use cocalc from nodejs",
   "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist-esm/index.js",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist-esm/*.js",
+      "default": "./dist/*.js"
+    },
+    "./src/*": {
+      "types": "./dist/src/*.d.ts",
+      "import": "./dist-esm/src/*.js",
+      "default": "./dist/src/*.js"
+    }
+  },
+  "files": ["dist/**", "dist-esm/**", "bin/**", "README.md", "package.json"],
   "scripts": {
     "preinstall": "npx only-allow pnpm",
-    "build": "../node_modules/.bin/tsc --build",
+    "build": "pnpm exec tsc --build && pnpm exec tsc -p tsconfig-esm.json && echo '{\"type\":\"module\"}' > dist-esm/package.json",
+    "clean": "rm -rf node_modules dist dist-esm",
     "depcheck": "pnpx depcheck --ignores @cocalc/api-client "
   },
-  "files": ["dist/**", "bin/**", "README.md", "package.json"],
   "author": "SageMath, Inc.",
   "keywords": ["cocalc", "jupyter"],
   "license": "SEE LICENSE.md",

src/packages/api-client/tsconfig-esm.json

@@ -0,0 +1,15 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "./",
+    "outDir": "dist-esm",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "declaration": false,
+    "declarationMap": false,
+    "composite": false,
+    "incremental": false,
+    "sourceMap": true
+  },
+  "exclude": ["node_modules", "../node_modules", "dist", "dist-esm", "test"]
+}

src/packages/api-client/tsconfig.json

@@ -4,6 +4,6 @@
     "rootDir": "./",
     "outDir": "dist"
   },
-  "exclude": ["node_modules", "dist", "test"],
+  "exclude": ["node_modules", "dist", "dist-esm", "test"],
   "references": [{ "path": "../backend" }]
 }

src/packages/comm/package.json

@@ -3,20 +3,38 @@
   "version": "0.1.0",
   "description": "Communication between project and frontend app support",
   "exports": {
-    "./*": "./dist/*.js",
-    "./websocket/*": "./dist/websocket/*.js",
-    "./project-status/*": "./dist/project-status/*.js",
-    "./project-info/*": "./dist/project-info/*.js"
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist-esm/*.js",
+      "default": "./dist/*.js"
+    },
+    "./websocket/*": {
+      "types": "./dist/websocket/*.d.ts",
+      "import": "./dist-esm/websocket/*.js",
+      "default": "./dist/websocket/*.js"
+    },
+    "./project-status/*": {
+      "types": "./dist/project-status/*.d.ts",
+      "import": "./dist-esm/project-status/*.js",
+      "default": "./dist/project-status/*.js"
+    },
+    "./project-info/*": {
+      "types": "./dist/project-info/*.d.ts",
+      "import": "./dist-esm/project-info/*.js",
+      "default": "./dist/project-info/*.js"
+    }
   },
   "files": [
     "dist/**",
+    "dist-esm/**",
     "README.md",
     "package.json",
     "tsconfig.json"
   ],
   "scripts": {
     "preinstall": "npx only-allow pnpm",
-    "build": "../node_modules/.bin/tsc --build",
+    "build": "pnpm exec tsc --build && pnpm exec tsc -p tsconfig-esm.json && echo '{\"type\":\"module\"}' > dist-esm/package.json",
+    "clean": "rm -rf node_modules dist dist-esm",
     "depcheck": "pnpx depcheck --ignores @types/node"
   },
   "author": "SageMath, Inc.",

src/packages/comm/tsconfig-esm.json

@@ -0,0 +1,15 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "./",
+    "outDir": "dist-esm",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "declaration": false,
+    "declarationMap": false,
+    "composite": false,
+    "incremental": false,
+    "sourceMap": true
+  },
+  "exclude": ["node_modules", "../node_modules", "dist", "dist-esm", "test"]
+}

src/packages/comm/tsconfig.json

@@ -4,7 +4,7 @@
     "rootDir": "./",
     "outDir": "dist"
   },
-  "exclude": ["node_modules", "dist", "test"],
+  "exclude": ["node_modules", "dist", "dist-esm", "test"],
   "references": [
     { "path": "../sync" },
     { "path": "../jupyter" },

src/packages/pnpm-lock.yaml

@@ -29,7 +29,7 @@
   ],
   "scripts": {
     "preinstall": "npx only-allow pnpm",
-    "build": "../node_modules/.bin/tsc --build && ../node_modules/.bin/tsc -p tsconfig-esm.json && echo '{\"type\":\"module\"}' > dist-esm/package.json",
+    "build": "pnpm exec tsc --build && pnpm exec tsc -p tsconfig-esm.json && echo '{\"type\":\"module\"}' > dist-esm/package.json",
     "clean": "rm -rf node_modules dist dist-esm",
     "depcheck": "pnpx depcheck"
   },

src/packages/sync-client/package.json

@@ -29,7 +29,7 @@
   ],
   "scripts": {
     "preinstall": "npx only-allow pnpm",
-    "build": "../node_modules/.bin/tsc --build && ../node_modules/.bin/tsc -p tsconfig-esm.json && echo '{\"type\":\"module\"}' > dist-esm/package.json",
+    "build": "pnpm exec tsc --build && pnpm exec tsc -p tsconfig-esm.json && echo '{\"type\":\"module\"}' > dist-esm/package.json",
     "clean": "rm -rf node_modules dist dist-esm",
     "test": "pnpm exec jest --forceExit --runInBand",
     "depcheck": "pnpx depcheck"

src/packages/sync-fs/package.json

@@ -26,7 +26,7 @@
   },
   "scripts": {
     "preinstall": "npx only-allow pnpm",
-    "build": "../node_modules/.bin/tsc --build && ../node_modules/.bin/tsc -p tsconfig-esm.json && echo '{\"type\":\"module\"}' > dist-esm/package.json",
+    "build": "pnpm exec tsc --build && pnpm exec tsc -p tsconfig-esm.json && echo '{\"type\":\"module\"}' > dist-esm/package.json",
     "test": "pnpm exec jest --forceExit",
     "depcheck": "pnpx depcheck --ignores events",
     "prepublishOnly": "pnpm test"