Merge branch 'main' into leetcode-api-module

Author: miorel

.github/workflows/post-leetcode-potd-to-discord.yml

@@ -34,7 +34,7 @@ jobs:
         uses: ./.github/workflows/set-up-everything
 
       - name: Prepare secrets
-        run: (cd workspaces/post-leetcode-potd-to-discord && echo "$SECRETS_FILE" > secrets_DO_NOT_COMMIT_OR_SHARE.json)
+        run: echo "$SECRETS_FILE" > workspaces/post-leetcode-potd-to-discord/secrets_DO_NOT_COMMIT_OR_SHARE.json
         env:
           SECRETS_FILE: ${{ secrets.SECRETS_FILE }}
 

.yarn/patches/nullthrows-npm-1.1.1-3d1f817134.patch

@@ -0,0 +1,21 @@
+diff --git a/nullthrows.d.ts b/nullthrows.d.ts
+index d4953f2f47b79701e5f125b9c041fb185668dd53..a39a37b30cd206e037ecbbb66bc90dacd6adb3af 100644
+--- a/nullthrows.d.ts
++++ b/nullthrows.d.ts
+@@ -1,5 +1,15 @@
+ /**
+  * Throws if value is null or undefined, otherwise returns value.
+  */
++declare function nullthrows<T>(
++  value?: T | null,
++  message?: string,
++): NonNullable<T>;
++
++// Patched based on https://github.com/microsoft/TypeScript/issues/46770#issuecomment-1039459991 and https://github.com/zertosh/nullthrows/pull/15
++
++declare namespace nullthrows {
++  export { nullthrows as default };
++}
++export = nullthrows;
+ 
+-export default function nullthrows<T>(value?: T | null, message?: string): T;

workspaces/adventure-pack/package.json

@@ -59,7 +59,7 @@
   "dependencies": {
     "immutability-helper": "3.1.1",
     "invariant": "2.2.4",
-    "nullthrows": "1.1.1",
+    "nullthrows": "patch:nullthrows@npm%3A1.1.1#~/.yarn/patches/nullthrows-npm-1.1.1-3d1f817134.patch",
     "react": "18.3.1",
     "react-dom": "18.3.1",
     "react-syntax-highlighter": "15.5.0"

workspaces/download-leetcode-submissions/.gitignore

@@ -3,3 +3,5 @@ secrets_DO_NOT_COMMIT_OR_SHARE.json
 submissions/
 submissions.jsonl
 submissions.sha512
+
+dist/

workspaces/download-leetcode-submissions/README.md

@@ -19,7 +19,7 @@ To use:
    nano secrets_DO_NOT_COMMIT_OR_SHARE.json
    ```
 
-2. **Run the script!**
+2. **Run the script!** You can run a development version:
 
    ```sh
    # Install dependencies, if you haven't already:
@@ -33,7 +33,26 @@ To use:
    yarn start
    ```
 
-Submissions will be downloaded to a directory named `submissions`, grouped by problem and problem number range. Filenames take the form `{yyyymmdd-date}-{submission-id}-{result}.{extension}`, resulting in full paths like `submissions/2101-2200/2163-kth-distinct-string-in-an-array/20240805-1345920313-ac.c` for an accepted C solution submitted on August 5th, 2024.
+   Or, build and run a distribution version:
+
+   ```sh
+   # It's easiest to do this from the package's directory:
+   cd workspaces/download-leetcode-submissions
+
+   # Install dependencies, if you haven't already:
+   yarn
+
+   # Package the script into an executable:
+   yarn build
+
+   # Run it with Node!
+   node dist/download-leetcode-submissions.cjs
+
+   # Or if your system can handle executable files, try running it directly:
+   ./dist/download-leetcode-submissions.cjs
+   ```
+
+   Submissions will be downloaded to a directory named `submissions`, grouped by problem and problem number range. Filenames take the form `{yyyymmdd-date}-{submission-id}-{result}.{extension}`, resulting in full paths like `submissions/2101-2200/2163-kth-distinct-string-in-an-array/20240805-1345920313-ac.c` for an accepted C solution submitted on August 5th, 2024.
 
 ## Metadata Files
 
@@ -79,6 +98,10 @@ As such it's safe to run the script multiple times, without redoing too much wor
 
 Like the rest of the [Code Chronicles Leetcode ecosystem](../../), this package is structured as a Node module, using [Yarn](https://yarnpkg.com/) as the package manager.
 
-You can install dependencies by running `yarn`, either in this package's directory, or in the repository root. The usual `yarn format`, `yarn lint`, and `yarn typecheck` scripts are available to aid in development and occasionally to annoy.
+You can install dependencies by running `yarn`, either in this package's directory, or in the repository root. The usual `yarn format`, `yarn lint`, and `yarn typecheck` scripts are available to aid in development and occasionally to annoy. Read more in the repository's general [development guide](../../DEVELOPMENT.md).
+
+This package supports an additional `package.json` script:
+
+### `yarn build`
 
-See also the repository's general [development guide](../../DEVELOPMENT.md).
+Builds a distribution version of this package, in a `dist` directory within the package's workspace.

workspaces/download-leetcode-submissions/eslint.config.mjs

@@ -1,3 +1,3 @@
 import config from "@code-chronicles/eslint-config";
 
-export default [...config, { ignores: ["submissions/"] }];
+export default [...config, { ignores: ["dist/", "submissions/"] }];

workspaces/download-leetcode-submissions/package.json

@@ -12,8 +12,10 @@
     "name": "Miorel-Lucian Palii",
     "url": "https://github.com/miorel"
   },
+  "type": "module",
   "exports": "./src/main.ts",
   "scripts": {
+    "build": "cross-env NODE_OPTIONS=\"--import tsx\" webpack && chmod +x dist/download-leetcode-submissions.cjs",
     "format": "prettier --color --write .",
     "lint": "eslint --color --max-warnings=0 .",
     "start": "tsx src/main.ts",
@@ -22,15 +24,19 @@
   "dependencies": {
     "@code-chronicles/leetcode-api": "workspace:*",
     "@code-chronicles/util": "workspace:*",
-    "nullthrows": "1.1.1",
+    "nullthrows": "patch:nullthrows@npm%3A1.1.1#~/.yarn/patches/nullthrows-npm-1.1.1-3d1f817134.patch",
     "zod": "3.23.8"
   },
   "devDependencies": {
     "@code-chronicles/eslint-config": "workspace:*",
     "@types/node": "22.5.5",
+    "cross-env": "7.0.3",
     "eslint": "9.10.0",
     "prettier": "3.3.3",
+    "ts-loader": "9.5.1",
     "tsx": "4.19.1",
-    "typescript": "5.6.2"
+    "typescript": "5.6.2",
+    "webpack": "5.94.0",
+    "webpack-cli": "5.1.4"
   }
 }

workspaces/download-leetcode-submissions/src/getDirnameForSubmission.ts

@@ -1,6 +1,6 @@
 import path from "node:path";
 
-import type { TransformedSubmission } from "./transformSubmission";
+import type { TransformedSubmission } from "./transformSubmission.js";
 
 const PROBLEMS_PER_GROUP = 100;
 

workspaces/download-leetcode-submissions/src/getFilenameForSubmission.ts

@@ -3,8 +3,8 @@ import nullthrows from "nullthrows";
 import { SUBMISSION_STATUS_TO_ABBREVIATION } from "@code-chronicles/leetcode-api";
 import { timestampInSecondsToYearMonthDay } from "@code-chronicles/util/timestampInSecondsToYearMonthDay";
 
-import { LANGUAGE_TO_FILE_EXTENSION } from "./constants";
-import type { TransformedSubmission } from "./transformSubmission";
+import { LANGUAGE_TO_FILE_EXTENSION } from "./constants.js";
+import type { TransformedSubmission } from "./transformSubmission.js";
 
 export function getFilenameForSubmission({
   id,

workspaces/download-leetcode-submissions/src/main.ts

@@ -10,16 +10,16 @@ import { promiseAllLimitingConcurrency } from "@code-chronicles/util/promiseAllL
 import { sleep } from "@code-chronicles/util/sleep";
 import { whileReturnsTrueAsync } from "@code-chronicles/util/whileReturnsTrueAsync";
 
-import { CONCURRENCY_LIMIT } from "./constants";
-import { getFilenameForSubmission } from "./getFilenameForSubmission";
-import { getDirnameForSubmission } from "./getDirnameForSubmission";
-import { readPriorSubmissions } from "./readPriorSubmissions";
-import { readSecrets } from "./readSecrets";
+import { CONCURRENCY_LIMIT } from "./constants.js";
+import { getDirnameForSubmission } from "./getDirnameForSubmission.js";
+import { getFilenameForSubmission } from "./getFilenameForSubmission.js";
+import { readPriorSubmissions } from "./readPriorSubmissions.js";
+import { readSecrets } from "./readSecrets.js";
 import {
   transformSubmission,
   type TransformedSubmission,
-} from "./transformSubmission";
-import { writeSubmissionsMetadataAndHashes } from "./writeSubmissionsMetadataAndHashes";
+} from "./transformSubmission.js";
+import { writeSubmissionsMetadataAndHashes } from "./writeSubmissionsMetadataAndHashes.js";
 
 async function main(): Promise<void> {
   // TODO: maybe create the file from a template if it doesn't exist