From 15125c728feec15bae1f8523427c813657405a08 Mon Sep 17 00:00:00 2001
From: Charis Lam <26616127+charislam@users.noreply.github.com>
Date: Fri, 6 Dec 2024 17:18:53 -0500
Subject: [PATCH] test: test node packages

---
 .github/workflows/build.yml          | 168 +++++++++++++++++++++++++++
 packages/supa-mdx-lint/package.json  |   3 +
 packages/supa-mdx-lint/src/helper.js |  74 ++++++++----
 packages/supa-mdx-lint/src/index.js  |   2 +
 4 files changed, 227 insertions(+), 20 deletions(-)

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 0d62941..409aa94 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -197,3 +197,171 @@ jobs:
           name: artifact-npm-binary-distributions
           path: npm-binary-distributions/*/*.tgz
           if-no-files-found: "error"
+
+  test-linux:
+    runs-on: ubuntu-latest
+    needs: [node, npm-distributions]
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version: [18, 20, 22]
+    steps:
+      - uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4.1.0
+        with:
+          node-version: ${{ matrix.node-version }}
+      - uses: actions/download-artifact@fa0a91b85d4f404e444e00e005971372dc801d16 # v4.1.8
+        with:
+          name: artifact-npm-binary-distributions
+          path: ./npm-binary-distributions
+      - uses: actions/download-artifact@fa0a91b85d4f404e444e00e005971372dc801d16 # v4.1.8
+        with:
+          name: artifact-pkg-node
+          path: ./node-pkg
+      - name: Create package.json
+        run: |
+          mkdir test
+          cd test
+          cat <<EOF > package.json
+          {
+            "name": "test",
+            "version": "1.0.0",
+            "description": "",
+            "main": "index.js",
+            "scripts": {
+              "lint": "supa-mdx-lint --version"
+            },
+            "keywords": [],
+            "author": "",
+            "license": "ISC"
+          }
+          EOF
+      - name: Install test packages
+        working-directory: test
+        run: |
+          npm install ../npm-binary-distributions/linux-x64/*.tgz
+          npm install ../node-pkg/*.tgz
+      - name: Test lint script
+        working-directory: test
+        run: npm run lint
+
+  test-macos:
+    runs-on: macos-latest
+    needs: [node, npm-distributions]
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version: [18, 20, 22]
+    steps:
+      - uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4.1.0
+        with:
+          node-version: ${{ matrix.node-version }}
+      - uses: actions/download-artifact@fa0a91b85d4f404e444e00e005971372dc801d16 # v4.1.8
+        with:
+          name: artifact-npm-binary-distributions
+          path: ./npm-binary-distributions
+      - uses: actions/download-artifact@fa0a91b85d4f404e444e00e005971372dc801d16 # v4.1.8
+        with:
+          name: artifact-pkg-node
+          path: ./node-pkg
+      - name: Create package.json
+        run: |
+          mkdir test
+          cd test
+          cat <<EOF > package.json
+          {
+            "name": "test",
+            "version": "1.0.0",
+            "description": "",
+            "main": "index.js",
+            "scripts": {
+              "lint": "supa-mdx-lint --version"
+            },
+            "keywords": [],
+            "author": "",
+            "license": "ISC"
+          }
+          EOF
+      - name: Install test packages
+        working-directory: test
+        run: |
+          npm install ../npm-binary-distributions/darwin/*.tgz
+          npm install ../node-pkg/*.tgz
+      - name: Test lint script
+        working-directory: test
+        run: npm run lint
+
+  test-windows:
+    runs-on: windows-latest
+    needs: [node, npm-distributions]
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version: [18, 20, 22]
+    steps:
+      - uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4.1.0
+        with:
+          node-version: ${{ matrix.node-version }}
+      - uses: actions/download-artifact@fa0a91b85d4f404e444e00e005971372dc801d16 # v4.1.8
+        with:
+          name: artifact-npm-binary-distributions
+          path: ./npm-binary-distributions
+      - uses: actions/download-artifact@fa0a91b85d4f404e444e00e005971372dc801d16 # v4.1.8
+        with:
+          name: artifact-pkg-node
+          path: ./node-pkg
+      - name: Create package.json
+        shell: pwsh
+        run: |
+          mkdir test
+          cd test
+          $json = @"
+          {
+            "name": "test",
+            "version": "1.0.0",
+            "description": "",
+            "main": "index.js",
+            "scripts": {
+              "lint": "supa-mdx-lint --version"
+            },
+            "keywords": [],
+            "author": "",
+            "license": "ISC"
+          }
+          "@
+          $json | Out-File -FilePath package.json -Encoding utf8
+      - name: Unpack binary tarball
+        shell: pwsh
+        run: |
+          $tarballPath = Get-ChildItem -Path npm-binary-distributions\win32-x64\*.tgz | Select-Object -First 1
+          tar -xzf $tarballPath.FullName -C npm-binary-distributions\win32-x64
+          Get-ChildItem -Path npm-binary-distributions\win32-x64\package
+      - name: Install binary
+        run: |
+          cd test
+          npm install ..\npm-binary-distributions\win32-x64\package
+      - name: Unpack node-pkg tarball
+        shell: pwsh
+        run: |
+          $tarballPath = Get-ChildItem -Path node-pkg\*.tgz | Select-Object -First 1
+          tar -xzf $tarballPath.FullName -C node-pkg
+          Get-ChildItem -Path node-pkg\package
+      - name: Install main package
+        run: |
+          cd test
+          npm install ..\node-pkg\package
+      - name: Verify lint executable (debug)
+        shell: pwsh
+        run: |
+          cd test\node_modules\@supabase\supa-mdx-lint-win32-x64\bin
+          Get-Item supa-mdx-lint.exe | Format-List -Property *
+          cd ../../../..
+          .\node_modules\@supabase\supa-mdx-lint-win32-x64\bin\supa-mdx-lint.exe --version
+      - name: Test lint script
+        working-directory: test
+        run: |
+          cat package.json
+          cat package-lock.json
+          ls -r node_modules
+          ls -r node_modules\@supabase\supa-mdx-lint-win32-x64
+          npm exec -- supa-mdx-lint-windows --version
+          npm run lint
diff --git a/packages/supa-mdx-lint/package.json b/packages/supa-mdx-lint/package.json
index 836ca4d..a23a885 100644
--- a/packages/supa-mdx-lint/package.json
+++ b/packages/supa-mdx-lint/package.json
@@ -2,6 +2,9 @@
   "name": "@supabase/supa-mdx-lint",
   "version": "0.1.6-pre",
   "main": "src/index.js",
+  "bin": {
+    "supa-mdx-lint": "src/index.js"
+  },
   "scripts": {
     "format": "prettier --write .",
     "format:check": "prettier --check .",
diff --git a/packages/supa-mdx-lint/src/helper.js b/packages/supa-mdx-lint/src/helper.js
index 06f0993..71f76d8 100644
--- a/packages/supa-mdx-lint/src/helper.js
+++ b/packages/supa-mdx-lint/src/helper.js
@@ -8,7 +8,10 @@
 "use strict";
 
 const childProcess = require("child_process");
+const fs = require("fs");
 const os = require("os");
+const path = require("path");
+const util = require("util");
 
 const BINARY_DISTRIBUTIONS = [
   {
@@ -110,6 +113,23 @@ supa-mdx-lint supports:
   );
 }
 
+/**
+ * Tries to find the node_modules directory by walking up the directory tree.
+ *
+ * @param {string} startDir The directory to start the search from.
+ */
+function findNodeModulesDir(startDir) {
+  let currentDir = startDir;
+  while (currentDir !== path.parse(currentDir).root) {
+    const nodeModulesPath = path.join(currentDir, "node_modules");
+    if (fs.existsSync(nodeModulesPath)) {
+      return nodeModulesPath;
+    }
+    currentDir = path.dirname(currentDir);
+  }
+  throw new Error("node_modules directory not found");
+}
+
 /**
  * Tries to find the installed supa-mdx-lint binary - either by looking into the relevant
  * optional dependencies or by trying to resolve the fallback binary.
@@ -127,36 +147,50 @@ function getBinaryPath() {
     throwUnsupportedPlatformError();
   }
 
-  let compatibleBinaryPath;
   try {
-    compatibleBinaryPath = require.resolve(`${packageName}/${subpath}`);
+    return require.resolve(`${packageName}/${subpath}`);
   } catch {
-    const otherInstalledDistribution = BINARY_DISTRIBUTIONS.find(
-      ({ packageName, subpath }) => {
-        try {
-          require.resolve(`${packageName}/${subpath}`);
-          return true;
-        } catch {
-          return false;
-        }
-      },
-    );
-
-    // These error messages are heavily inspired by esbuild's error messages: https://github.com/evanw/esbuild/blob/f3d535262e3998d845d0f102b944ecd5a9efda57/lib/npm/node-platform.ts#L150
-    if (otherInstalledDistribution) {
-      throw new Error(`supa-mdx-lint binary for this platform/architecture not found!
+    try {
+      // Windows has a problem resolving the package with require.resolve, so
+      // try to manually construct the path from node_modules.
+      const nodeModulesPath = findNodeModulesDir(__dirname);
+      const binaryPath = path.join(nodeModulesPath, packageName, subpath);
+      if (fs.existsSync(binaryPath)) {
+        return binaryPath;
+      } else {
+        throw new Error(
+          util.format(
+            "Binary not found from manually constructed path: %s",
+            binaryPath,
+          ),
+        );
+      }
+    } catch {
+      const otherInstalledDistribution = BINARY_DISTRIBUTIONS.find(
+        ({ packageName, subpath }) => {
+          try {
+            require.resolve(`${packageName}/${subpath}`);
+            return true;
+          } catch {
+            return false;
+          }
+        },
+      );
+
+      // These error messages are heavily inspired by esbuild's error messages: https://github.com/evanw/esbuild/blob/f3d535262e3998d845d0f102b944ecd5a9efda57/lib/npm/node-platform.ts#L150
+      if (otherInstalledDistribution) {
+        throw new Error(`supa-mdx-lint binary for this platform/architecture not found!
 
 The "${otherInstalledDistribution.packageName}" package is installed, but for the current platform, you should have the "${packageName}" package installed instead. This usually happens if the "supa-mdx-lint" package is installed on one platform (for example Windows or MacOS) and then the "node_modules" folder is reused on another operating system (for example Linux in Docker).
 
 To fix this, avoid copying the "node_modules" folder, and instead freshly install your dependencies on the target system. You can also configure your package manager to install the right package. For example, yarn has the "supportedArchitectures" feature: https://yarnpkg.com/configuration/yarnrc/#supportedArchitecture.`);
-    } else {
-      throw new Error(`supa-mdx-lint binary for this platform/architecture not found!
+      } else {
+        throw new Error(`supa-mdx-lint binary for this platform/architecture not found!
 
 It seems like none of the "@supabase/supa-mdx-lint" package's optional dependencies got installed. Please make sure your package manager is configured to install optional dependencies. If you are using npm to install your dependencies, please don't set the "--no-optional", "--ignore-optional", or "--omit=optional" flags. supa-mdx-lint needs the "optionalDependencies" feature in order to install its binary.`);
+      }
     }
   }
-
-  return compatibleBinaryPath;
 }
 
 /**
diff --git a/packages/supa-mdx-lint/src/index.js b/packages/supa-mdx-lint/src/index.js
index cfe630a..5b56243 100644
--- a/packages/supa-mdx-lint/src/index.js
+++ b/packages/supa-mdx-lint/src/index.js
@@ -1,3 +1,5 @@
+#!/usr/bin/env node
+
 //@ ts-check
 
 "use strict";