build: update scripts for Prettier v3, switch to ESM (#581)

* build: remove uneeded `fix-package-json` script

* build: switch to ESM for scripts

* style: replace tabs for spaces for consistency

* build(typescript.mjs): remove need for intermediate variable

* style: prettier

* build: update lint script

Author: wolfy1339

.github/workflows/release.yml

@@ -18,8 +18,6 @@ jobs:
           cache: npm
       - run: npm ci
       - run: npm run build
-      - name: "Fix pkg.files file pattern"
-        run: node scripts/fix-package-json.js
       - run: npx semantic-release
         env:
           GITHUB_TOKEN: ${{ secrets.OCTOKITBOT_PAT }}

package.json

@@ -11,14 +11,14 @@
   "scripts": {
     "build": "node scripts/build.mjs && tsc -p tsconfig.json",
     "docs": "typedoc --readme none --out docs src/index.ts && touch docs/.nojekyll",
-    "lint": "prettier --check \"{src,test,scripts}/**/*.{js,ts,json}\" README.md package.json !src/generated/* !scripts/update-endpoints/generated/*",
-    "lint:fix": "prettier --write \"{src,test,scripts}/**/*.{js,ts,json}\" README.md package.json !src/generated/* !scripts/update-endpoints/generated/*",
+    "lint": "prettier --check \"{src,test,scripts}/**/*.{js,mjs,ts,json}\" README.md package.json !src/generated/* !scripts/update-endpoints/generated/*",
+    "lint:fix": "prettier --write \"{src,test,scripts}/**/*.{js,mjs,ts,json}\" README.md package.json !src/generated/* !scripts/update-endpoints/generated/*",
     "pretest": "npm run -s lint",
     "test": "npx tsc --project tsconfig.test.json",
     "update-endpoints": "npm-run-all update-endpoints:*",
-    "update-endpoints:fetch-json": "node scripts/update-endpoints/fetch-json",
-    "update-endpoints:typescript": "node scripts/update-endpoints/typescript",
-    "update-endpoints:package": "node scripts/update-endpoints/package"
+    "update-endpoints:fetch-json": "node scripts/update-endpoints/fetch-json.mjs",
+    "update-endpoints:typescript": "node scripts/update-endpoints/typescript.mjs",
+    "update-endpoints:package": "node scripts/update-endpoints/package.mjs"
   },
   "repository": "github:octokit/types.ts",
   "keywords": [

scripts/build.mjs

@@ -1,34 +1,33 @@
 import { copyFile, readFile, writeFile, rm, mkdir } from "node:fs/promises";
 
-
 async function main() {
-	// Start with a clean slate
-	await rm("pkg", { recursive: true, force: true });
-	await mkdir("pkg");
+  // Start with a clean slate
+  await rm("pkg", { recursive: true, force: true });
+  await mkdir("pkg");
 
-	// Copy the README, LICENSE to the pkg folder
-	await copyFile("LICENSE", "pkg/LICENSE");
-	await copyFile("README.md", "pkg/README.md");
+  // Copy the README, LICENSE to the pkg folder
+  await copyFile("LICENSE", "pkg/LICENSE");
+  await copyFile("README.md", "pkg/README.md");
 
-	// Handle the package.json
-	let pkg = JSON.parse((await readFile("package.json", "utf8")).toString());
-	// Remove unnecessary fields from the package.json
-	delete pkg.scripts;
-	delete pkg.prettier;
-	delete pkg.release;
-	delete pkg.jest;
-	await writeFile(
-		"pkg/package.json",
-		JSON.stringify(
-			{
-				...pkg,
-				files: ["dist-types/**"],
-				types: "dist-types/index.d.ts",
-				sideEffects: false,
-			},
-			null,
-			2
-		)
-	);
+  // Handle the package.json
+  let pkg = JSON.parse((await readFile("package.json", "utf8")).toString());
+  // Remove unnecessary fields from the package.json
+  delete pkg.scripts;
+  delete pkg.prettier;
+  delete pkg.release;
+  delete pkg.jest;
+  await writeFile(
+    "pkg/package.json",
+    JSON.stringify(
+      {
+        ...pkg,
+        files: ["dist-types/**"],
+        types: "dist-types/index.d.ts",
+        sideEffects: false,
+      },
+      null,
+      2,
+    ),
+  );
 }
 main();

scripts/fix-package-json.js

@@ -1,13 +1,16 @@
-const { writeFileSync } = require("fs");
-const path = require("path");
+import { writeFileSync } from "fs";
+import { resolve } from "path";
+import { fileURLToPath } from "url";
 
-const graphql = require("github-openapi-graphql-query");
-const prettier = require("prettier");
+import graphql from "github-openapi-graphql-query";
+import { format } from "prettier";
 
 if (!process.env.VERSION) {
   throw new Error(`VERSION environment variable must be set`);
 }
 
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+
 const version = process.env.VERSION.replace(/^v/, "");
 
 const QUERY = `
@@ -39,8 +42,8 @@ async function main() {
   });
 
   writeFileSync(
-    path.resolve(__dirname, "generated", "endpoints.json"),
-    prettier.format(JSON.stringify(endpoints), {
+    resolve(__dirname, "generated", "endpoints.json"),
+    await format(JSON.stringify(endpoints), {
       parser: "json",
     }),
   );

scripts/update-endpoints/fetch-json.js renamed to scripts/update-endpoints/fetch-json.mjs

@@ -1,10 +1,13 @@
-const { writeFileSync } = require("fs");
+import { writeFileSync, readFileSync } from "fs";
 
 if (!process.env.VERSION) {
   throw new Error(`VERSION environment variable must be set`);
 }
 
-const pkg = require("../../package.json");
+const parentDir = new URL("../..", import.meta.url);
+const pkg = JSON.parse(
+  readFileSync(new URL("package.json", parentDir), "utf8"),
+);
 
 if (!pkg.octokit) {
   pkg.octokit = {};

scripts/update-endpoints/package.js renamed to scripts/update-endpoints/package.mjs

@@ -1,11 +1,13 @@
-const { readFileSync, writeFileSync } = require("fs");
-const { resolve } = require("path");
+import { readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
 
-const Handlebars = require("handlebars");
-const prettier = require("prettier");
-const sortKeys = require("sort-keys");
+import handlebars from "handlebars";
+import { format } from "prettier";
+import sortKeys from "sort-keys";
 
-const ENDPOINTS = require("./generated/endpoints.json");
+const ENDPOINTS = JSON.parse(
+  readFileSync(new URL("generated/endpoints.json", import.meta.url), "utf8"),
+);
 const ENDPOINTS_PATH = resolve(
   process.cwd(),
   "src",
@@ -20,7 +22,7 @@ const ENDPOINTS_TEMPLATE_PATH = resolve(
   "endpoints.ts.template",
 );
 
-const template = Handlebars.compile(
+const template = handlebars.compile(
   readFileSync(ENDPOINTS_TEMPLATE_PATH, "utf8"),
 );
 
@@ -63,10 +65,7 @@ async function run() {
     endpointsByRoute: sortKeys(endpointsByRoute, { deep: true }),
   });
 
-  writeFileSync(
-    ENDPOINTS_PATH,
-    prettier.format(result, { parser: "typescript" }),
-  );
+  writeFileSync(ENDPOINTS_PATH, await format(result, { parser: "typescript" }));
   console.log(`${ENDPOINTS_PATH} updated.`);
 }