@rust-gear/glob 1.0.0 → 1.1.1

package/README.md

@@ -4,12 +4,72 @@ A fast glob alternative for Node.js powered by Rust.
 
 ## Performance
 
-- **3–10x faster** than traditional JavaScript glob implementations.
+Measured against `fast-glob` on a synthetic tree of ~50k files
+(Apple Silicon, `node bench/bench.mjs`, medians):
+
+| pattern (~50k file tree) | `globSync` | `fast-glob` sync | `fast-glob` async |
+| :----------------------- | ---------: | ---------------: | ----------------: |
+| `**/*.js` (10k matches)  |      25 ms |            77 ms |             42 ms |
+| `**/*.{js,ts}` (18k)     |      26 ms |            80 ms |             42 ms |
+| `**/*` + exclude (37.8k) |      29 ms |            82 ms |             43 ms |
+| `mod1/**/*.rs` (400)     |     1.3 ms |           3.7 ms |            1.9 ms |
+
+- **~3x faster** than the synchronous APIs of `fast-glob` and `glob`.
+  The directory walk is parallelized on a Rust thread pool, so `globSync`
+  runs at full speed without blocking on single-threaded I/O.
+- **~1.6x faster** than their async APIs, with ~0.04 ms fixed overhead
+  per call.
+
+### Thread pool size
+
+How wide the walk runs is a property of the _filesystem_, not of the CPU, so
+it is decided per platform.
+
+On **Windows and Linux** the pool is every logical CPU the process may use.
+NTFS takes a per-directory lock and Linux takes `inode->i_rwsem` per inode, so
+enumerating different directories in parallel does not collide, and the walk
+keeps scaling to the full width of the machine:
+
+```
+$ node bench/threads.mjs      # Windows 11, 16 logical CPUs, NTFS
+threads   1    237.81 ms
+threads   8     43.71 ms
+threads  16     28.24 ms   <- fastest
+threads  32     28.43 ms
+
+$ node bench/threads.mjs      # Ubuntu, 8 logical CPUs, ext4
+threads   1     37.08 ms
+threads   4     11.57 ms
+threads   8     10.75 ms
+threads  16     10.79 ms
+```
+
+On **macOS** it is capped to the machine's fastest core class, read from
+`hw.perflevel0`. APFS serializes enumeration on volume-wide state in the vnode
+layer, so wall time bottoms out long before the CPU does — past the knee the
+extra threads are queueing in the kernel, not working:
+
+```
+$ node bench/threads.mjs      # macOS, Apple Silicon 4P+4E, APFS
+threads   1     64.13 ms
+threads   4     24.16 ms   <- fastest
+threads   8     35.16 ms
+threads  16     34.76 ms
+```
+
+The knee tracks syscall _rate_ rather than core count, so on a Mac with many
+more performance cores the optimum may sit below their count. On an Intel Mac,
+where every core is one class, nothing is capped.
+
+Set `RUST_GEAR_GLOB_THREADS` to override the choice on any platform; run
+`node bench/threads.mjs` to see your own machine's curve. The count is always
+clamped to the process's CPU allowance, so a cgroup quota or affinity mask
+still wins.
 
 ## Installation
 
 ```sh
-npm install --save-dev @rust-gear/glob
+pnpm add -D @rust-gear/glob
 ```
 
 ## Usage
@@ -31,12 +91,17 @@ const files = rs.globSync("**/*.rs", {
 
 ## Options
 
-| Option  | Type     | Default         | Description                             |
-| :------ | :------- | :-------------- | :-------------------------------------- |
-| cwd     | string   | `process.cwd()` | Current working directory for searching |
-| exclude | string[] | `[]`            | Glob patterns to exclude                |
-| dot     | boolean  | `false`         | Include dot files and directories       |
-| sort    | boolean  | `false`         | Return sorted results                   |
+| Option    | Type     | Default         | Description                                          |
+| :-------- | :------- | :-------------- | :--------------------------------------------------- |
+| cwd       | string   | `process.cwd()` | Current working directory for searching              |
+| exclude   | string[] | `[]`            | Glob patterns to exclude                             |
+| dot       | boolean  | `false`         | Include dot files and directories                    |
+| sort      | boolean  | `false`         | Return sorted results                                |
+| gitignore | boolean  | `true`          | Respect `.gitignore` files inside git (`.git`) repos |
+
+> **Note:** Set `gitignore: false` for results that depend only on the
+> patterns and the filesystem, matching the behavior of `fast-glob`,
+> which never reads `.gitignore`.
 
 ## License
 

package/index.d.ts

@@ -1,13 +1,13 @@
-/* tslint:disable */
-/* eslint-disable */
-
 /* auto-generated by NAPI-RS */
+/* eslint-disable */
+export declare function glob(patterns: string | Array<string>, options?: GlobOptions | undefined | null): Promise<Array<string>>
 
 export interface GlobOptions {
   exclude?: Array<string>
   cwd?: string
   dot?: boolean
   sort?: boolean
+  gitignore?: boolean
 }
+
 export declare function globSync(patterns: string | Array<string>, options?: GlobOptions | undefined | null): Array<string>
-export declare function glob(patterns: string | Array<string>, options?: GlobOptions | undefined | null): Promise<Array<string>>

package/index.js

@@ -1,316 +1,591 @@
-/* tslint:disable */
+// prettier-ignore
 /* eslint-disable */
-/* prettier-ignore */
-
+// @ts-nocheck
 /* auto-generated by NAPI-RS */
 
-const { existsSync, readFileSync } = require('fs')
-const { join } = require('path')
+const { readFileSync } = require('fs')
+let nativeBinding = null
+const loadErrors = []
 
-const { platform, arch } = process
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
 
-let nativeBinding = null
-let localFileExisted = false
-let loadError = null
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
 
-function isMusl() {
-  // For Node 10
-  if (!process.report || typeof process.report.getReport !== 'function') {
-    try {
-      const lddPath = require('child_process').execSync('which ldd').toString().trim()
-      return readFileSync(lddPath, 'utf8').includes('musl')
-    } catch (e) {
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  let report = null
+  if (process.report && typeof process.report.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
       return true
     }
-  } else {
-    const { glibcVersionRuntime } = process.report.getReport().header
-    return !glibcVersionRuntime
   }
+  return false
 }
 
-switch (platform) {
-  case 'android':
-    switch (arch) {
-      case 'arm64':
-        localFileExisted = existsSync(join(__dirname, 'glob.android-arm64.node'))
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err)
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./glob.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-android-arm64')
+        const bindingPackageVersion = require('@rust-gear/glob-android-arm64/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./glob.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-android-arm-eabi')
+        const bindingPackageVersion = require('@rust-gear/glob-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      if ((process.config && process.config.variables && process.config.variables.shlib_suffix === 'dll.a') || (process.config && process.config.variables && process.config.variables.node_target_type === 'shared_library')) {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./glob.android-arm64.node')
-          } else {
-            nativeBinding = require('@rust-gear/glob-android-arm64')
-          }
+        return require('./glob.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-win32-x64-gnu')
+        const bindingPackageVersion = require('@rust-gear/glob-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./glob.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-win32-x64-msvc')
+        const bindingPackageVersion = require('@rust-gear/glob-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      }
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./glob.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-win32-ia32-msvc')
+        const bindingPackageVersion = require('@rust-gear/glob-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./glob.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-win32-arm64-msvc')
+        const bindingPackageVersion = require('@rust-gear/glob-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+      return require('./glob.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('@rust-gear/glob-darwin-universal')
+      const bindingPackageVersion = require('@rust-gear/glob-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    if (process.arch === 'x64') {
+      try {
+        return require('./glob.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-darwin-x64')
+        const bindingPackageVersion = require('@rust-gear/glob-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./glob.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-darwin-arm64')
+        const bindingPackageVersion = require('@rust-gear/glob-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./glob.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-freebsd-x64')
+        const bindingPackageVersion = require('@rust-gear/glob-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./glob.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-freebsd-arm64')
+        const bindingPackageVersion = require('@rust-gear/glob-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+          return require('./glob.linux-x64-musl.node')
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'arm':
-        localFileExisted = existsSync(join(__dirname, 'glob.android-arm-eabi.node'))
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./glob.android-arm-eabi.node')
-          } else {
-            nativeBinding = require('@rust-gear/glob-android-arm-eabi')
+          const binding = require('@rust-gear/glob-linux-x64-musl')
+          const bindingPackageVersion = require('@rust-gear/glob-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      default:
-        throw new Error(`Unsupported architecture on Android ${arch}`)
-    }
-    break
-  case 'win32':
-    switch (arch) {
-      case 'x64':
-        localFileExisted = existsSync(
-          join(__dirname, 'glob.win32-x64-msvc.node')
-        )
+      } else {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./glob.win32-x64-msvc.node')
-          } else {
-            nativeBinding = require('@rust-gear/glob-win32-x64-msvc')
-          }
+          return require('./glob.linux-x64-gnu.node')
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'ia32':
-        localFileExisted = existsSync(
-          join(__dirname, 'glob.win32-ia32-msvc.node')
-        )
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./glob.win32-ia32-msvc.node')
-          } else {
-            nativeBinding = require('@rust-gear/glob-win32-ia32-msvc')
+          const binding = require('@rust-gear/glob-linux-x64-gnu')
+          const bindingPackageVersion = require('@rust-gear/glob-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'arm64':
-        localFileExisted = existsSync(
-          join(__dirname, 'glob.win32-arm64-msvc.node')
-        )
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./glob.win32-arm64-msvc.node')
-          } else {
-            nativeBinding = require('@rust-gear/glob-win32-arm64-msvc')
+          return require('./glob.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@rust-gear/glob-linux-arm64-musl')
+          const bindingPackageVersion = require('@rust-gear/glob-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      default:
-        throw new Error(`Unsupported architecture on Windows: ${arch}`)
-    }
-    break
-  case 'darwin':
-    localFileExisted = existsSync(join(__dirname, 'glob.darwin-universal.node'))
-    try {
-      if (localFileExisted) {
-        nativeBinding = require('./glob.darwin-universal.node')
       } else {
-        nativeBinding = require('@rust-gear/glob-darwin-universal')
-      }
-      break
-    } catch {}
-    switch (arch) {
-      case 'x64':
-        localFileExisted = existsSync(join(__dirname, 'glob.darwin-x64.node'))
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./glob.darwin-x64.node')
-          } else {
-            nativeBinding = require('@rust-gear/glob-darwin-x64')
-          }
+          return require('./glob.linux-arm64-gnu.node')
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'arm64':
-        localFileExisted = existsSync(
-          join(__dirname, 'glob.darwin-arm64.node')
-        )
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./glob.darwin-arm64.node')
-          } else {
-            nativeBinding = require('@rust-gear/glob-darwin-arm64')
+          const binding = require('@rust-gear/glob-linux-arm64-gnu')
+          const bindingPackageVersion = require('@rust-gear/glob-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      default:
-        throw new Error(`Unsupported architecture on macOS: ${arch}`)
-    }
-    break
-  case 'freebsd':
-    if (arch !== 'x64') {
-      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
-    }
-    localFileExisted = existsSync(join(__dirname, 'glob.freebsd-x64.node'))
-    try {
-      if (localFileExisted) {
-        nativeBinding = require('./glob.freebsd-x64.node')
-      } else {
-        nativeBinding = require('@rust-gear/glob-freebsd-x64')
       }
-    } catch (e) {
-      loadError = e
-    }
-    break
-  case 'linux':
-    switch (arch) {
-      case 'x64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'glob.linux-x64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./glob.linux-x64-musl.node')
-            } else {
-              nativeBinding = require('@rust-gear/glob-linux-x64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'glob.linux-x64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./glob.linux-x64-gnu.node')
-            } else {
-              nativeBinding = require('@rust-gear/glob-linux-x64-gnu')
-            }
-          } catch (e) {
-            loadError = e
-          }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./glob.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 'arm64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'glob.linux-arm64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./glob.linux-arm64-musl.node')
-            } else {
-              nativeBinding = require('@rust-gear/glob-linux-arm64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'glob.linux-arm64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./glob.linux-arm64-gnu.node')
-            } else {
-              nativeBinding = require('@rust-gear/glob-linux-arm64-gnu')
-            }
-          } catch (e) {
-            loadError = e
+        try {
+          const binding = require('@rust-gear/glob-linux-arm-musleabihf')
+          const bindingPackageVersion = require('@rust-gear/glob-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./glob.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 'arm':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'glob.linux-arm-musleabihf.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./glob.linux-arm-musleabihf.node')
-            } else {
-              nativeBinding = require('@rust-gear/glob-linux-arm-musleabihf')
-            }
-          } catch (e) {
-            loadError = e
+        try {
+          const binding = require('@rust-gear/glob-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('@rust-gear/glob-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'glob.linux-arm-gnueabihf.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./glob.linux-arm-gnueabihf.node')
-            } else {
-              nativeBinding = require('@rust-gear/glob-linux-arm-gnueabihf')
-            }
-          } catch (e) {
-            loadError = e
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./glob.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@rust-gear/glob-linux-loong64-musl')
+          const bindingPackageVersion = require('@rust-gear/glob-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./glob.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 'riscv64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'glob.linux-riscv64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./glob.linux-riscv64-musl.node')
-            } else {
-              nativeBinding = require('@rust-gear/glob-linux-riscv64-musl')
-            }
-          } catch (e) {
-            loadError = e
+        try {
+          const binding = require('@rust-gear/glob-linux-loong64-gnu')
+          const bindingPackageVersion = require('@rust-gear/glob-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'glob.linux-riscv64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./glob.linux-riscv64-gnu.node')
-            } else {
-              nativeBinding = require('@rust-gear/glob-linux-riscv64-gnu')
-            }
-          } catch (e) {
-            loadError = e
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./glob.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@rust-gear/glob-linux-riscv64-musl')
+          const bindingPackageVersion = require('@rust-gear/glob-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./glob.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 's390x':
-        localFileExisted = existsSync(
-          join(__dirname, 'glob.linux-s390x-gnu.node')
-        )
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./glob.linux-s390x-gnu.node')
-          } else {
-            nativeBinding = require('@rust-gear/glob-linux-s390x-gnu')
+          const binding = require('@rust-gear/glob-linux-riscv64-gnu')
+          const bindingPackageVersion = require('@rust-gear/glob-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./glob.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-linux-ppc64-gnu')
+        const bindingPackageVersion = require('@rust-gear/glob-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./glob.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-linux-s390x-gnu')
+        const bindingPackageVersion = require('@rust-gear/glob-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
-        break
-      default:
-        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
     }
-    break
-  default:
-    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./glob.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-openharmony-arm64')
+        const bindingPackageVersion = require('@rust-gear/glob-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'x64') {
+      try {
+        return require('./glob.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-openharmony-x64')
+        const bindingPackageVersion = require('@rust-gear/glob-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./glob.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@rust-gear/glob-openharmony-arm')
+        const bindingPackageVersion = require('@rust-gear/glob-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '1.1.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.1.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+// NAPI_RS_FORCE_WASI is a tri-state flag:
+//   unset / any other value → native binding preferred, WASI is only a fallback
+//   'true'                   → force WASI fallback even if native loaded
+//   'error'                  → force WASI and throw if no WASI binding is found
+// Treating any non-empty string as truthy (the historical behavior) meant
+// NAPI_RS_FORCE_WASI=false, NAPI_RS_FORCE_WASI=0, etc. inadvertently triggered
+// the WASI path, causing ENOENT for packages shipped without a .wasi.cjs file.
+const forceWasi =
+  process.env.NAPI_RS_FORCE_WASI === 'true' || process.env.NAPI_RS_FORCE_WASI === 'error'
+
+if (!nativeBinding || forceWasi) {
+  let wasiBinding = null
+  let wasiBindingError = null
+  try {
+    wasiBinding = require('./glob.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (forceWasi) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding || forceWasi) {
+    try {
+      wasiBinding = require('@rust-gear/glob-wasm32-wasi')
+      nativeBinding = wasiBinding
+    } catch (err) {
+      if (forceWasi) {
+        if (!wasiBindingError) {
+          wasiBindingError = err
+        } else {
+          wasiBindingError.cause = err
+        }
+        loadErrors.push(err)
+      }
+    }
+  }
+  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
+    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
+    error.cause = wasiBindingError
+    throw error
+  }
 }
 
 if (!nativeBinding) {
-  if (loadError) {
-    throw loadError
+  if (loadErrors.length > 0) {
+    const error = new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
+    )
+    // assign instead of the `new Error(message, { cause })` options form,
+    // which Node < 16.9 silently ignores
+    error.cause = loadErrors.reduce((err, cur) => {
+      cur.cause = err
+      return cur
+    })
+    throw error
   }
   throw new Error(`Failed to load native binding`)
 }
 
-const { globSync, glob } = nativeBinding
-
-module.exports.globSync = globSync
-module.exports.glob = glob
+module.exports = nativeBinding
+module.exports.glob = nativeBinding.glob
+module.exports.globSync = nativeBinding.globSync

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rust-gear/glob",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "A fast glob alternative for Node.js powered by Rust.",
   "keywords": [
     "glob",
@@ -34,17 +34,17 @@
     "index.d.ts"
   ],
   "napi": {
-    "name": "glob",
-    "triples": [
-      "darwin-arm64",
-      "darwin-x64",
-      "linux-arm64-gnu",
-      "linux-arm64-musl",
-      "linux-x64-gnu",
-      "linux-x64-musl",
-      "win32-x64-msvc",
-      "win32-ia32-msvc",
-      "win32-arm64-msvc"
+    "binaryName": "glob",
+    "targets": [
+      "aarch64-apple-darwin",
+      "x86_64-apple-darwin",
+      "aarch64-unknown-linux-gnu",
+      "aarch64-unknown-linux-musl",
+      "x86_64-unknown-linux-gnu",
+      "x86_64-unknown-linux-musl",
+      "x86_64-pc-windows-msvc",
+      "i686-pc-windows-msvc",
+      "aarch64-pc-windows-msvc"
     ]
   },
   "scripts": {
@@ -52,7 +52,8 @@
     "packages": "node ../../scripts/generate-platform-packages.js",
     "readme": "node ../../scripts/generate-platform-readme.js",
     "update:main": "node ../../scripts/update-main-package.js",
-    "test": "ava"
+    "test": "ava",
+    "bench": "node bench/bench.mjs"
   },
   "engines": {
     "node": ">=10"
@@ -62,17 +63,17 @@
     "access": "public"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^2.18.4"
+    "@napi-rs/cli": "^3.7.3"
   },
   "optionalDependencies": {
-    "@rust-gear/glob-darwin-arm64": "1.0.0",
-    "@rust-gear/glob-darwin-x64": "1.0.0",
-    "@rust-gear/glob-linux-arm64-gnu": "1.0.0",
-    "@rust-gear/glob-linux-arm64-musl": "1.0.0",
-    "@rust-gear/glob-linux-x64-gnu": "1.0.0",
-    "@rust-gear/glob-linux-x64-musl": "1.0.0",
-    "@rust-gear/glob-win32-arm64-msvc": "1.0.0",
-    "@rust-gear/glob-win32-ia32-msvc": "1.0.0",
-    "@rust-gear/glob-win32-x64-msvc": "1.0.0"
+    "@rust-gear/glob-darwin-arm64": "1.1.1",
+    "@rust-gear/glob-darwin-x64": "1.1.1",
+    "@rust-gear/glob-linux-arm64-gnu": "1.1.1",
+    "@rust-gear/glob-linux-arm64-musl": "1.1.1",
+    "@rust-gear/glob-linux-x64-gnu": "1.1.1",
+    "@rust-gear/glob-linux-x64-musl": "1.1.1",
+    "@rust-gear/glob-win32-x64-msvc": "1.1.1",
+    "@rust-gear/glob-win32-ia32-msvc": "1.1.1",
+    "@rust-gear/glob-win32-arm64-msvc": "1.1.1"
   }
 }