@oai-statsig/statsig-node-core 0.32.0-beta.20260918.1821 → 0.32.0-beta.20260920.1827

package/index.d.ts

@@ -2,7 +2,7 @@ import { DynamicConfigEvaluationOptions, ExperimentEvaluationOptions, FeatureGat
 import { DynamicConfig, Experiment, FeatureGate, Layer } from './statsig_types';
 export * from './statsig-generated';
 export * from './statsig_types';
-export declare const SDK_VERSION = "0.32.0-beta.20260918.1821";
+export declare const SDK_VERSION = "0.32.0-beta.20260920.1827";
 export declare class Statsig extends StatsigNapiInternal {
     private static _sharedInstance;
     static shared(): Statsig;

package/index.js

@@ -31,7 +31,7 @@ const statsig_generated_1 = require("./statsig-generated");
 const statsig_types_1 = require("./statsig_types");
 __exportStar(require("./statsig-generated"), exports);
 __exportStar(require("./statsig_types"), exports);
-exports.SDK_VERSION = '0.32.0-beta.20260918.1821';
+exports.SDK_VERSION = '0.32.0-beta.20260920.1827';
 const inspectSym = Symbol.for('nodejs.util.inspect.custom');
 // @ts-expect-error - prototype assignment
 statsig_generated_1.StatsigUser.prototype[inspectSym] = function () {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oai-statsig/statsig-node-core",
-  "version": "0.32.0-beta.20260918.1821",
+  "version": "0.32.0-beta.20260920.1827",
   "main": "index.js",
   "scripts": {
     "test": "jest --colors"
@@ -17,7 +17,7 @@
   },
   "devDependencies": {
     "@babel/helpers": "7.26.10",
-    "@napi-rs/cli": "3.0.0-alpha.65",
+    "@napi-rs/cli": "3.4.1",
     "@octokit/endpoint": "10.1.3",
     "@octokit/plugin-paginate-rest": "11.4.1",
     "@octokit/request": "9.2.1",
@@ -60,13 +60,13 @@
     }
   },
   "optionalDependencies": {
-    "@oai-statsig/statsig-node-core-darwin-arm64": "0.32.0-beta.20260918.1821",
-    "@oai-statsig/statsig-node-core-darwin-x64": "0.32.0-beta.20260918.1821",
-    "@oai-statsig/statsig-node-core-linux-arm64-gnu": "0.32.0-beta.20260918.1821",
-    "@oai-statsig/statsig-node-core-linux-arm64-musl": "0.32.0-beta.20260918.1821",
-    "@oai-statsig/statsig-node-core-linux-x64-gnu": "0.32.0-beta.20260918.1821",
-    "@oai-statsig/statsig-node-core-linux-x64-musl": "0.32.0-beta.20260918.1821",
-    "@oai-statsig/statsig-node-core-win32-ia32-msvc": "0.32.0-beta.20260918.1821",
-    "@oai-statsig/statsig-node-core-win32-x64-msvc": "0.32.0-beta.20260918.1821"
+    "@oai-statsig/statsig-node-core-darwin-arm64": "0.32.0-beta.20260920.1827",
+    "@oai-statsig/statsig-node-core-darwin-x64": "0.32.0-beta.20260920.1827",
+    "@oai-statsig/statsig-node-core-linux-arm64-gnu": "0.32.0-beta.20260920.1827",
+    "@oai-statsig/statsig-node-core-linux-arm64-musl": "0.32.0-beta.20260920.1827",
+    "@oai-statsig/statsig-node-core-linux-x64-gnu": "0.32.0-beta.20260920.1827",
+    "@oai-statsig/statsig-node-core-linux-x64-musl": "0.32.0-beta.20260920.1827",
+    "@oai-statsig/statsig-node-core-win32-ia32-msvc": "0.32.0-beta.20260920.1827",
+    "@oai-statsig/statsig-node-core-win32-x64-msvc": "0.32.0-beta.20260920.1827"
   }
 }

package/statsig-generated.js

@@ -3,9 +3,6 @@
 // @ts-nocheck
 /* auto-generated by NAPI-RS */
 
-const { createRequire } = require('node:module')
-require = createRequire(__filename)
-
 const { readFileSync } = require('node:fs')
 let nativeBinding = null
 const loadErrors = []
@@ -35,7 +32,11 @@ const isMuslFromFilesystem = () => {
 }
 
 const isMuslFromReport = () => {
-  const report = typeof process.report.getReport === 'function' ? process.report.getReport() : null
+  let report = null
+  if (typeof process.report?.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
   if (!report) {
     return null
   }
@@ -60,7 +61,13 @@ const isMuslFromChildProcess = () => {
 }
 
 function requireNative() {
-  if (process.platform === 'android') {
+  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('./statsig-node-core.android-arm64.node')
@@ -68,11 +75,15 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-android-arm64')
+        const binding = require('@oai-statsig/statsig-node-core-android-arm64')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-android-arm64/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 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('./statsig-node-core.android-arm-eabi.node')
@@ -80,27 +91,53 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-android-arm-eabi')
+        const binding = require('@oai-statsig/statsig-node-core-android-arm-eabi')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 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?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
+        try {
+        return require('./statsig-node-core.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
       try {
+        const binding = require('@oai-statsig/statsig-node-core-win32-x64-gnu')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
         return require('./statsig-node-core.win32-x64-msvc.node')
       } catch (e) {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-win32-x64-msvc')
+        const binding = require('@oai-statsig/statsig-node-core-win32-x64-msvc')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 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('./statsig-node-core.win32-ia32-msvc.node')
@@ -108,11 +145,15 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-win32-ia32-msvc')
+        const binding = require('@oai-statsig/statsig-node-core-win32-ia32-msvc')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 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('./statsig-node-core.win32-arm64-msvc.node')
@@ -120,26 +161,34 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-win32-arm64-msvc')
+        const binding = require('@oai-statsig/statsig-node-core-win32-arm64-msvc')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 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('./statsig-node-core.darwin-universal.node')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-      try {
-        return require('@oai-statsig/statsig-node-core-darwin-universal')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-
+      return require('./statsig-node-core.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('@oai-statsig/statsig-node-core-darwin-universal')
+      const bindingPackageVersion = require('@oai-statsig/statsig-node-core-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 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('./statsig-node-core.darwin-x64.node')
@@ -147,11 +196,15 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-darwin-x64')
+        const binding = require('@oai-statsig/statsig-node-core-darwin-x64')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 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('./statsig-node-core.darwin-arm64.node')
@@ -159,11 +212,15 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-darwin-arm64')
+        const binding = require('@oai-statsig/statsig-node-core-darwin-arm64')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 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}`))
     }
@@ -175,11 +232,15 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-freebsd-x64')
+        const binding = require('@oai-statsig/statsig-node-core-freebsd-x64')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 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('./statsig-node-core.freebsd-arm64.node')
@@ -187,11 +248,15 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-freebsd-arm64')
+        const binding = require('@oai-statsig/statsig-node-core-freebsd-arm64')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 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}`))
     }
@@ -199,133 +264,259 @@ function requireNative() {
     if (process.arch === 'x64') {
       if (isMusl()) {
         try {
-        return require('./statsig-node-core.linux-x64-musl.node')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-      try {
-        return require('@oai-statsig/statsig-node-core-linux-x64-musl')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-
+          return require('./statsig-node-core.linux-x64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@oai-statsig/statsig-node-core-linux-x64-musl')
+          const bindingPackageVersion = require('@oai-statsig/statsig-node-core-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
       } else {
         try {
-        return require('./statsig-node-core.linux-x64-gnu.node')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-      try {
-        return require('@oai-statsig/statsig-node-core-linux-x64-gnu')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-
+          return require('./statsig-node-core.linux-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@oai-statsig/statsig-node-core-linux-x64-gnu')
+          const bindingPackageVersion = require('@oai-statsig/statsig-node-core-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
       }
     } else if (process.arch === 'arm64') {
       if (isMusl()) {
         try {
-        return require('./statsig-node-core.linux-arm64-musl.node')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-      try {
-        return require('@oai-statsig/statsig-node-core-linux-arm64-musl')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-
+          return require('./statsig-node-core.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@oai-statsig/statsig-node-core-linux-arm64-musl')
+          const bindingPackageVersion = require('@oai-statsig/statsig-node-core-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
       } else {
         try {
-        return require('./statsig-node-core.linux-arm64-gnu.node')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-      try {
-        return require('@oai-statsig/statsig-node-core-linux-arm64-gnu')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-
+          return require('./statsig-node-core.linux-arm64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@oai-statsig/statsig-node-core-linux-arm64-gnu')
+          const bindingPackageVersion = require('@oai-statsig/statsig-node-core-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
       }
     } else if (process.arch === 'arm') {
       if (isMusl()) {
         try {
-        return require('./statsig-node-core.linux-arm-musleabihf.node')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-      try {
-        return require('@oai-statsig/statsig-node-core-linux-arm-musleabihf')
-      } catch (e) {
-        loadErrors.push(e)
+          return require('./statsig-node-core.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@oai-statsig/statsig-node-core-linux-arm-musleabihf')
+          const bindingPackageVersion = require('@oai-statsig/statsig-node-core-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./statsig-node-core.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@oai-statsig/statsig-node-core-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('@oai-statsig/statsig-node-core-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./statsig-node-core.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@oai-statsig/statsig-node-core-linux-loong64-musl')
+          const bindingPackageVersion = require('@oai-statsig/statsig-node-core-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./statsig-node-core.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@oai-statsig/statsig-node-core-linux-loong64-gnu')
+          const bindingPackageVersion = require('@oai-statsig/statsig-node-core-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
       }
-
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./statsig-node-core.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@oai-statsig/statsig-node-core-linux-riscv64-musl')
+          const bindingPackageVersion = require('@oai-statsig/statsig-node-core-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
       } else {
         try {
-        return require('./statsig-node-core.linux-arm-gnueabihf.node')
+          return require('./statsig-node-core.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@oai-statsig/statsig-node-core-linux-riscv64-gnu')
+          const bindingPackageVersion = require('@oai-statsig/statsig-node-core-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./statsig-node-core.linux-ppc64-gnu.node')
       } catch (e) {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-linux-arm-gnueabihf')
+        const binding = require('@oai-statsig/statsig-node-core-linux-ppc64-gnu')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
-
-      }
-    } else if (process.arch === 'riscv64') {
-      if (isMusl()) {
-        try {
-        return require('./statsig-node-core.linux-riscv64-musl.node')
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./statsig-node-core.linux-s390x-gnu.node')
       } catch (e) {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-linux-riscv64-musl')
+        const binding = require('@oai-statsig/statsig-node-core-linux-s390x-gnu')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
-
-      } else {
-        try {
-        return require('./statsig-node-core.linux-riscv64-gnu.node')
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
+    }
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./statsig-node-core.openharmony-arm64.node')
       } catch (e) {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-linux-riscv64-gnu')
+        const binding = require('@oai-statsig/statsig-node-core-openharmony-arm64')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
-
-      }
-    } else if (process.arch === 'ppc64') {
+    } else if (process.arch === 'x64') {
       try {
-        return require('./statsig-node-core.linux-ppc64-gnu.node')
+        return require('./statsig-node-core.openharmony-x64.node')
       } catch (e) {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-linux-ppc64-gnu')
+        const binding = require('@oai-statsig/statsig-node-core-openharmony-x64')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
-
-    } else if (process.arch === 's390x') {
+    } else if (process.arch === 'arm') {
       try {
-        return require('./statsig-node-core.linux-s390x-gnu.node')
+        return require('./statsig-node-core.openharmony-arm.node')
       } catch (e) {
         loadErrors.push(e)
       }
       try {
-        return require('@oai-statsig/statsig-node-core-linux-s390x-gnu')
+        const binding = require('@oai-statsig/statsig-node-core-openharmony-arm')
+        const bindingPackageVersion = require('@oai-statsig/statsig-node-core-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '0.32.0-beta.20260920.1827' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.32.0-beta.20260920.1827 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 Linux: ${process.arch}`))
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
     }
   } else {
     loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
@@ -335,35 +526,52 @@ function requireNative() {
 nativeBinding = requireNative()
 
 if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  let wasiBinding = null
+  let wasiBindingError = null
   try {
-    nativeBinding = require('./statsig-node-core.wasi.cjs')
+    wasiBinding = require('./statsig-node-core.wasi.cjs')
+    nativeBinding = wasiBinding
   } catch (err) {
     if (process.env.NAPI_RS_FORCE_WASI) {
-      loadErrors.push(err)
+      wasiBindingError = err
     }
   }
   if (!nativeBinding) {
     try {
-      nativeBinding = require('@oai-statsig/statsig-node-core-wasm32-wasi')
+      wasiBinding = require('@oai-statsig/statsig-node-core-wasm32-wasi')
+      nativeBinding = wasiBinding
     } catch (err) {
       if (process.env.NAPI_RS_FORCE_WASI) {
+        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 (loadErrors.length > 0) {
-    // TODO Link to documentation with potential fixes
-    //  - The package owner could build/publish bindings for this arch
-    //  - The user may need to bundle the correct files
-    //  - The user may need to re-install node_modules to get new packages
-    throw new Error('Failed to load native binding', { cause: loadErrors })
+    throw 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.',
+      {
+        cause: loadErrors.reduce((err, cur) => {
+          cur.cause = err
+          return cur
+        }),
+      },
+    )
   }
   throw new Error(`Failed to load native binding`)
 }
 
+module.exports = nativeBinding
 module.exports.InternedStore = nativeBinding.InternedStore
 module.exports.LayerParamExposureData = nativeBinding.LayerParamExposureData
 module.exports.ParameterStore = nativeBinding.ParameterStore