Convert @gitbook/cli to ESM and consume the ESM content-engine

The content-engine is now built as a self-contained ESM bundle (tsdown),
so the CLI bundle switches to ESM output:

- package.json: type module, postinstall script renamed to .cjs
- build.sh: esm format, with a banner shimming require/__dirname for
  bundled CommonJS dependencies and the cloudflared tunnel path
- cli.js bin shim: import instead of require

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: gregberge

bun.lock

@@ -4,6 +4,8 @@ rm -rf ./dist/
 esbuild ./src/cli.ts \
     --bundle \
     --platform=node \
+    --format=esm \
+    --banner:js="$(cat ./esm-shims.js)" \
     --external:esbuild \
     --external:miniflare \
     --external:fsevents \

packages/cli/build.sh

@@ -4,4 +4,4 @@
  * To avoid the probem of bun/npm only linking the CLI at the installation time.
  * We use a fixed file that will be linked to the bin folder and requires the actual CLI.
  */
-require('./dist/cli.js');
+import './dist/cli.js';

packages/cli/cli.js

@@ -0,0 +1,8 @@
+// Shims for CommonJS globals used by bundled dependencies (require) and by
+// the CLI itself (__dirname), injected as a banner in the ESM bundle.
+import { createRequire as __createRequire } from 'node:module';
+import { fileURLToPath as __fileURLToPath } from 'node:url';
+import { dirname as __pathDirname } from 'node:path';
+const require = __createRequire(import.meta.url);
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);

packages/cli/esm-shims.js

@@ -2,9 +2,10 @@
     "name": "@gitbook/cli",
     "description": "CLI to build and publish integrations on GitBook.com",
     "version": "0.28.0",
+    "type": "module",
     "dependencies": {
         "@gitbook/api": "*",
-        "@gitbook/content-engine": "file:../../../gitbook-x/packages/content-engine/dist-pkg",
+        "@gitbook/content-engine": "file:../../../gitbook-x/packages/content-engine/dist",
         "check-node-version": "^4.2.1",
         "commander": "^9.2.0",
         "conf": "^13.1.0",
@@ -27,11 +28,11 @@
     },
     "files": [
         "dist/**",
-        "postinstall.js"
+        "postinstall.cjs"
     ],
     "scripts": {
         "build": "./build.sh",
-        "postinstall": "node postinstall.js",
+        "postinstall": "node postinstall.cjs",
         "typecheck": "tsc --noEmit"
     },
     "engines": {

packages/cli/package.json

@@ -2,7 +2,7 @@
  * Script to install cloudflared binary on the current platform.
  * Reference: https://github.com/JacobLinCool/node-cloudflared/blob/main/src/install.ts
  */
-const { execSync } = require('child_process');
+const { execSync } = require('node:child_process');
 const fs = require('fs');
 const https = require('https');
 const path = require('path');