strict

Author: saschanaz

deploy/createTypesPackages.js

@@ -2,6 +2,13 @@
 
 // node deploy/createTypesPackages.js
 
+/**
+ * @template T
+ * @typedef {T extends (infer U)[] ? U : T} ArrayInner
+ */
+/**
+ * @typedef {ArrayInner<typeof packages>} Package
+ */
 // prettier-ignore
 export const packages = [
   {
@@ -52,11 +59,8 @@ import { fileURLToPath } from "url";
 import semver from "semver";
 import pkg from "prettier";
 const { format } = pkg;
-import { execSync } from "child_process";
 
 const go = async () => {
-  const gitSha = execSync("git rev-parse HEAD").toString().trim().slice(0, 7);
-
   const generatedDir = new URL("generated/", import.meta.url);
   const templateDir = new URL("template/", import.meta.url);
 
@@ -88,25 +92,30 @@ const go = async () => {
     prependAutoImports(pkg, packagePath);
 
     // Setup the files in the repo
-    const newPkgJSON = await updatePackageJSON(pkg, packagePath, gitSha);
+    const newPkgJSON = await updatePackageJSON(pkg, packagePath);
     copyREADME(pkg, newPkgJSON, new URL("README.md", packagePath));
 
     // Done
     console.log("Built:", pkg.name);
   }
 };
 
-async function updatePackageJSON(pkg, packagePath, gitSha) {
+/**
+ * @param {Package} pkg
+ * @param {URL} packagePath
+ */
+async function updatePackageJSON(pkg, packagePath) {
   const pkgJSONPath = new URL("package.json", packagePath);
   const packageText = fs.readFileSync(pkgJSONPath, "utf8");
+  /** @type {import("./template/package.json")} */
   const packageJSON = JSON.parse(packageText);
   packageJSON.name = pkg.name;
   packageJSON.description = pkg.description;
 
   // Bump the last version of the number from npm,
   // or use the _version in tsconfig if it's higher,
   // or default to 0.0.1
-  let version = pkg.version || "0.0.1";
+  let version = "0.0.1";
   try {
     const npmResponse = await fetch(
       `https://registry.npmjs.org/${packageJSON.name}`
@@ -128,7 +137,6 @@ async function updatePackageJSON(pkg, packagePath, gitSha) {
   }
 
   packageJSON.version = version;
-  packageJSON.domLibGeneratorSha = gitSha;
 
   fs.writeFileSync(
     pkgJSONPath,
@@ -140,7 +148,12 @@ async function updatePackageJSON(pkg, packagePath, gitSha) {
   return packageJSON;
 }
 
-// Copies the README and adds some rudimentary templating to the file.
+/**
+ * Copies the README and adds some rudimentary templating to the file.
+ * @param {Package} pkg
+ * @param {import("./template/package.json")} pkgJSON
+ * @param {URL} writePath
+ */
 function copyREADME(pkg, pkgJSON, writePath) {
   let readme = fs.readFileSync(new URL(pkg.readme, import.meta.url), "utf-8");
 
@@ -157,7 +170,11 @@ function copyREADME(pkg, pkgJSON, writePath) {
   fs.writeFileSync(writePath, readme);
 }
 
-// Appends any files marked as autoImport in the metadata.
+/**
+ * Appends any files marked as autoImport in the metadata.
+ * @param {Package} pkg
+ * @param {URL} packagePath
+ */
 function prependAutoImports(pkg, packagePath) {
   const index = new URL("index.d.ts", packagePath);
   if (!fs.existsSync(index)) return;

deploy/deployChangedPackages.js

@@ -7,10 +7,10 @@
 
 import * as fs from "fs";
 import { basename } from "path";
-import { spawnSync, execSync } from "child_process";
+import { spawnSync } from "child_process";
 import { Octokit } from "@octokit/core";
 import printDiff from "print-diff";
-import { generateChangelogFrom } from "../lib/changelog.js";
+import { gitShowFile, generateChangelogFrom } from "../lib/changelog.js";
 import { packages } from "./createTypesPackages.js";
 import { fileURLToPath } from "node:url";
 
@@ -31,21 +31,26 @@ for (const dirName of fs.readdirSync(generatedDir)) {
   // We'll need to map back from the filename in the npm package to the
   // generated file in baselines inside the git tag
   const thisPackageMeta = packages.find((p) => p.name === pkgJSON.name);
+  if (!thisPackageMeta) {
+    throw new Error(`Couldn't find ${pkgJSON.name}`);
+  }
 
   const dtsFiles = fs
     .readdirSync(packageDir)
     .filter((f) => f.endsWith(".d.ts"));
 
-  /** @type {string[]} */
-  let releaseNotes = [];
+  /** @type {string} */
+  let releaseNotes = "";
 
   // Look through each .d.ts file included in a package to
   // determine if anything has changed
   let upload = false;
   for (const file of dtsFiles) {
-    const originalFilename = basename(
-      thisPackageMeta.files.find((f) => f.to === file).from
-    );
+    const filemap = thisPackageMeta.files.find((f) => f.to === file);
+    if (!filemap) {
+      throw new Error(`Couldn't find ${file} from ${pkgJSON.name}`);
+    }
+    const originalFilename = basename(filemap.from);
 
     const generatedDTSPath = new URL(file, packageDir);
     const generatedDTSContent = fs.readFileSync(generatedDTSPath, "utf8");
@@ -63,10 +68,10 @@ for (const dirName of fs.readdirSync(generatedDir)) {
       console.log(`Comparing ${file} from ${olderVersion}, to now:`);
       printDiff(oldFile, generatedDTSContent);
 
-      const title = `\n## \`${file}\`\n`;
+      const title = `\n## \`${file}\`\n\n`;
       const notes = generateChangelogFrom(oldFile, generatedDTSContent);
-      releaseNotes.push(title);
-      releaseNotes.push(notes.trim() === "" ? "No changes" : notes);
+      releaseNotes = title;
+      releaseNotes += notes.trim() === "" ? "No changes" : notes;
 
       upload = upload || oldFile !== generatedDTSContent;
     } catch (error) {
@@ -106,7 +111,7 @@ Assuming that this means we need to upload this package.`);
   }
 
   console.log("\n# Release notes:");
-  console.log(releaseNotes.join("\n"), "\n\n");
+  console.log(releaseNotes, "\n\n");
 }
 // Warn if we did a dry run.
 if (!process.env.NODE_AUTH_TOKEN) {
@@ -119,6 +124,10 @@ if (uploaded.length) {
   console.log("No uploads");
 }
 
+/**
+ * @param {string} tag
+ * @param {string} body
+ */
 async function createRelease(tag, body) {
   const authToken = process.env.GITHUB_TOKEN || process.env.GITHUB_API_TOKEN;
   const octokit = new Octokit({ auth: authToken });
@@ -146,7 +155,3 @@ function verify() {
       "There isn't an ENV var set up for creating a GitHub release, expected GITHUB_TOKEN."
     );
 }
-
-function gitShowFile(commitish, path) {
-  return execSync(`git show "${commitish}":${path}`, { encoding: "utf-8" });
-}

deploy/jsconfig.json

@@ -2,6 +2,8 @@
   "compilerOptions": {
     "target": "es2020",
     "module": "esnext", // es2022
-    "moduleResolution": "node"
+    "moduleResolution": "node",
+    "strict": true,
+    "resolveJsonModule": true
   }
 }

deploy/versionChangelog.js

@@ -2,9 +2,8 @@
 
 // npm run ts-changelog @types/web 0.0.1 0.0.3
 
-import { generateChangelogFrom } from "../lib/changelog.js";
+import { gitShowFile, generateChangelogFrom } from "../lib/changelog.js";
 import { packages } from "./createTypesPackages.js";
-import { execSync } from "child_process";
 import { basename } from "path";
 
 const [name, before, to] = process.argv.slice(2);
@@ -33,7 +32,4 @@ const go = () => {
   }
 };
 
-const gitShowFile = (commitish, path) =>
-  execSync(`git show "${commitish}":${path}`, { encoding: "utf-8" });
-
 go();

src/changelog.ts

@@ -2,7 +2,7 @@ import { execSync } from "child_process";
 import ts from "typescript";
 import { fileURLToPath } from "url";
 
-function gitShowFile(commit: string, path: string) {
+export function gitShowFile(commit: string, path: string): string {
   return execSync(`git show ${commit}:${path}`, { encoding: "utf-8" });
 }