frogql 0.2.6 → 0.2.8

package/index.d.ts

@@ -1,38 +1,61 @@
-/* tslint:disable */
-/* eslint-disable */
-
 /* auto-generated by NAPI-RS */
-
-/** Result of `Connection.schema()`. */
-export interface SchemaSummary {
-  nodeLabels: Array<string>
-  edgeLabels: Array<string>
-  nodeCount: number
-  edgeCount: number
+/* eslint-disable */
+export declare class Connection {
+  get nodeCount(): number
+  get edgeCount(): number
+  /**
+   * Run a GQL statement. The return is polymorphic — depends on
+   * statement kind:
+   * - Query with RETURN: `Array<Record<string, unknown>>` keyed by alias
+   * - Query without RETURN: `Array<{ _paths, ...vars }>`
+   * - CREATE / USE / DROP GRAPH TYPE: `DdlOk`
+   * - SHOW GRAPH TYPES: `Array<GraphTypeSummary>`
+   * - SHOW GRAPH TYPE / SHOW CURRENT GRAPH TYPE / VALIDATE GRAPH TYPE: object
+   * - CREATE / DROP INDEX: `IndexResult`
+   * - SHOW INDEXES: `Array<IndexSummary>`
+   * - DML: `DmCounters`
+   *
+   * Cast the return to the expected shape:
+   * `const rows = conn.execute("MATCH ...") as Array<{ x: NodeRef }>`
+   */
+  execute(query: string, limit?: number | undefined | null): unknown
+  /**
+   * Persist the merged base+overlay state back to the file the
+   * connection was opened from. Mirrors `.save` REPL command and
+   * SQLite's explicit-save model.
+   */
+  save(): void
+  /** List graph types currently in the catalog with active markers. */
+  graphTypes(): Array<GraphTypeSummary>
+  /**
+   * Lightweight schema summary derived from the live graph: sorted
+   * label sets + node / edge counts. Does NOT consult the catalog.
+   */
+  schema(): SchemaSummary
 }
-/** One entry in `Connection.graphTypes()`. */
-export interface GraphTypeSummary {
-  name: string
-  active: boolean
-  /** Number of node types declared in this graph type, if known. */
-  nodes?: number
-  /** Number of edge types declared in this graph type, if known. */
-  edges?: number
+
+/** Result envelope for `CREATE / USE / DROP GRAPH TYPE`. */
+export interface DdlOk {
+  ok: boolean
+  /** Always `"ddl"` for catalog statements. */
+  kind: string
+  message: string
 }
+
 /**
- * Shape of a node reference inside an `execute()` row. `kind` is
- * always `"node"`. Cast `execute()` rows to `{ x: NodeRef }` etc.
+ * Counters returned from a successful DML statement (INSERT / SET /
+ * REMOVE / DELETE / DETACH DELETE).
  */
-export interface NodeRef {
-  kind: string
-  id: number
-  labels: Array<string>
-  /**
-   * Free-form property bag. Values are JSON-compatible (number /
-   * string / boolean / null / nested object / array).
-   */
-  props: any
+export interface DmCounters {
+  nodesInserted: number
+  edgesInserted: number
+  nodesDeleted: number
+  edgesDeleted: number
+  nodesModified: number
+  edgesModified: number
+  rows: number
 }
+
 /**
  * Shape of an edge reference inside an `execute()` row. `kind` is
  * always `"edge"`. Symmetric with `NodeRef`: `props` is always
@@ -48,26 +71,29 @@ export interface EdgeRef {
    */
   props: any
 }
+
+/** One entry in `Connection.graphTypes()`. */
+export interface GraphTypeSummary {
+  name: string
+  active: boolean
+  /** Number of node types declared in this graph type, if known. */
+  nodes?: number
+  /** Number of edge types declared in this graph type, if known. */
+  edges?: number
+}
+
 /**
- * Counters returned from a successful DML statement (INSERT / SET /
- * REMOVE / DELETE / DETACH DELETE).
+ * Import a directory of CSVs (configured via `spanner_import_config.json`)
+ * into a fresh `.gdb` at `dbPath`. Overwrites the destination.
  */
-export interface DmCounters {
-  nodesInserted: number
-  edgesInserted: number
-  nodesDeleted: number
-  edgesDeleted: number
-  nodesModified: number
-  edgesModified: number
-  rows: number
-}
-/** Result envelope for `CREATE / USE / DROP GRAPH TYPE`. */
-export interface DdlOk {
-  ok: boolean
-  /** Always `"ddl"` for catalog statements. */
-  kind: string
-  message: string
-}
+export declare function importCsv(dbPath: string, csvDir: string): void
+
+/**
+ * Import a JSON graph (`{nodes: [...], edges: [...]}`) into a fresh
+ * `.gdb` at `dbPath`. Overwrites the destination.
+ */
+export declare function importJson(dbPath: string, jsonPath: string): void
+
 /** Result envelope for `CREATE / DROP INDEX`. */
 export interface IndexResult {
   ok: boolean
@@ -85,6 +111,7 @@ export interface IndexResult {
   /** Present when DROP failed (index not found). */
   error?: string
 }
+
 /** One entry in `SHOW INDEXES`. */
 export interface IndexSummary {
   name: string
@@ -99,52 +126,35 @@ export interface IndexSummary {
   auto: boolean
   entries: number
 }
+
 /**
- * Open or create a `.gdb` database. Eagerly warms the LTJ TripleIndex
- * so the first `execute()` on the returned Connection runs at warm
- * cache speed.
- */
-export declare function open(path: string): Connection
-/**
- * Import a JSON graph (`{nodes: [...], edges: [...]}`) into a fresh
- * `.gdb` at `dbPath`. Overwrites the destination.
- */
-export declare function importJson(dbPath: string, jsonPath: string): void
-/**
- * Import a directory of CSVs (configured via `spanner_import_config.json`)
- * into a fresh `.gdb` at `dbPath`. Overwrites the destination.
+ * Shape of a node reference inside an `execute()` row. `kind` is
+ * always `"node"`. Cast `execute()` rows to `{ x: NodeRef }` etc.
  */
-export declare function importCsv(dbPath: string, csvDir: string): void
-export declare class Connection {
-  get nodeCount(): number
-  get edgeCount(): number
-  /**
-   * Run a GQL statement. The return is polymorphic — depends on
-   * statement kind:
-   * - Query with RETURN: `Array<Record<string, unknown>>` keyed by alias
-   * - Query without RETURN: `Array<{ _paths, ...vars }>`
-   * - CREATE / USE / DROP GRAPH TYPE: `DdlOk`
-   * - SHOW GRAPH TYPES: `Array<GraphTypeSummary>`
-   * - SHOW GRAPH TYPE / SHOW CURRENT GRAPH TYPE / VALIDATE GRAPH TYPE: object
-   * - CREATE / DROP INDEX: `IndexResult`
-   * - SHOW INDEXES: `Array<IndexSummary>`
-   * - DML: `DmCounters`
-   *
-   * Cast the return to the expected shape:
-   * `const rows = conn.execute("MATCH ...") as Array<{ x: NodeRef }>`
-   */
-  execute(query: string, limit?: number | undefined | null): unknown
-  /**
-   * Persist the merged base+overlay state back to the file the
-   * connection was opened from. Mirrors `.save` REPL command and
-   * SQLite's explicit-save model.
-   */
-  save(): void
-  /** List graph types currently in the catalog with active markers. */
-  graphTypes(): Array<GraphTypeSummary>
+export interface NodeRef {
+  kind: string
+  id: number
+  labels: Array<string>
   /**
-   * Lightweight schema summary derived from the live graph: sorted
-   * label sets + node / edge counts. Does NOT consult the catalog.
+   * Free-form property bag. Values are JSON-compatible (number /
+   * string / boolean / null / nested object / array).
    */
-  schema(): SchemaSummary
+  props: any
+}
+
+/**
+ * Open or create a `.gdb` database. SQLite-style: if `path` does not
+ * exist, an empty database is created there (zero nodes/edges, DEFAULT
+ * graph type active), ready for `INSERT` + `save()`. Eagerly warms the
+ * LTJ TripleIndex so the first `execute()` on the returned Connection
+ * runs at warm cache speed.
+ */
+export declare function open(path: string): Connection
+
+/** Result of `Connection.schema()`. */
+export interface SchemaSummary {
+  nodeLabels: Array<string>
+  edgeLabels: Array<string>
+  nodeCount: number
+  edgeCount: number
 }

package/index.js

@@ -1,318 +1,593 @@
-/* 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, 'frogql.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('./frogql.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-android-arm64')
+        const bindingPackageVersion = require('frogql-android-arm64/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-android-arm-eabi')
+        const bindingPackageVersion = require('frogql-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.android-arm64.node')
-          } else {
-            nativeBinding = require('frogql-android-arm64')
-          }
+        return require('./frogql.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-win32-x64-gnu')
+        const bindingPackageVersion = require('frogql-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./frogql.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-win32-x64-msvc')
+        const bindingPackageVersion = require('frogql-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-win32-ia32-msvc')
+        const bindingPackageVersion = require('frogql-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-win32-arm64-msvc')
+        const bindingPackageVersion = require('frogql-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('frogql-darwin-universal')
+      const bindingPackageVersion = require('frogql-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-darwin-x64')
+        const bindingPackageVersion = require('frogql-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-darwin-arm64')
+        const bindingPackageVersion = require('frogql-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-freebsd-x64')
+        const bindingPackageVersion = require('frogql-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-freebsd-arm64')
+        const bindingPackageVersion = require('frogql-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.linux-x64-musl.node')
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'arm':
-        localFileExisted = existsSync(join(__dirname, 'frogql.android-arm-eabi.node'))
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./frogql.android-arm-eabi.node')
-          } else {
-            nativeBinding = require('frogql-android-arm-eabi')
+          const binding = require('frogql-linux-x64-musl')
+          const bindingPackageVersion = require('frogql-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '0.2.8' && 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.2.8 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, 'frogql.win32-x64-msvc.node')
-        )
+      } else {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./frogql.win32-x64-msvc.node')
-          } else {
-            nativeBinding = require('frogql-win32-x64-msvc')
-          }
+          return require('./frogql.linux-x64-gnu.node')
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'ia32':
-        localFileExisted = existsSync(
-          join(__dirname, 'frogql.win32-ia32-msvc.node')
-        )
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./frogql.win32-ia32-msvc.node')
-          } else {
-            nativeBinding = require('frogql-win32-ia32-msvc')
+          const binding = require('frogql-linux-x64-gnu')
+          const bindingPackageVersion = require('frogql-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.2.8' && 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.2.8 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, 'frogql.win32-arm64-msvc.node')
-        )
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./frogql.win32-arm64-msvc.node')
-          } else {
-            nativeBinding = require('frogql-win32-arm64-msvc')
+          return require('./frogql.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('frogql-linux-arm64-musl')
+          const bindingPackageVersion = require('frogql-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '0.2.8' && 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.2.8 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, 'frogql.darwin-universal.node'))
-    try {
-      if (localFileExisted) {
-        nativeBinding = require('./frogql.darwin-universal.node')
       } else {
-        nativeBinding = require('frogql-darwin-universal')
-      }
-      break
-    } catch {}
-    switch (arch) {
-      case 'x64':
-        localFileExisted = existsSync(join(__dirname, 'frogql.darwin-x64.node'))
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./frogql.darwin-x64.node')
-          } else {
-            nativeBinding = require('frogql-darwin-x64')
-          }
+          return require('./frogql.linux-arm64-gnu.node')
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'arm64':
-        localFileExisted = existsSync(
-          join(__dirname, 'frogql.darwin-arm64.node')
-        )
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./frogql.darwin-arm64.node')
-          } else {
-            nativeBinding = require('frogql-darwin-arm64')
+          const binding = require('frogql-linux-arm64-gnu')
+          const bindingPackageVersion = require('frogql-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.2.8' && 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.2.8 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, 'frogql.freebsd-x64.node'))
-    try {
-      if (localFileExisted) {
-        nativeBinding = require('./frogql.freebsd-x64.node')
-      } else {
-        nativeBinding = require('frogql-freebsd-x64')
       }
-    } catch (e) {
-      loadError = e
-    }
-    break
-  case 'linux':
-    switch (arch) {
-      case 'x64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'frogql.linux-x64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./frogql.linux-x64-musl.node')
-            } else {
-              nativeBinding = require('frogql-linux-x64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'frogql.linux-x64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./frogql.linux-x64-gnu.node')
-            } else {
-              nativeBinding = require('frogql-linux-x64-gnu')
-            }
-          } catch (e) {
-            loadError = e
-          }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./frogql.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 'arm64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'frogql.linux-arm64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./frogql.linux-arm64-musl.node')
-            } else {
-              nativeBinding = require('frogql-linux-arm64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'frogql.linux-arm64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./frogql.linux-arm64-gnu.node')
-            } else {
-              nativeBinding = require('frogql-linux-arm64-gnu')
-            }
-          } catch (e) {
-            loadError = e
+        try {
+          const binding = require('frogql-linux-arm-musleabihf')
+          const bindingPackageVersion = require('frogql-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '0.2.8' && 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.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./frogql.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 'arm':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'frogql.linux-arm-musleabihf.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./frogql.linux-arm-musleabihf.node')
-            } else {
-              nativeBinding = require('frogql-linux-arm-musleabihf')
-            }
-          } catch (e) {
-            loadError = e
+        try {
+          const binding = require('frogql-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('frogql-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '0.2.8' && 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.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'frogql.linux-arm-gnueabihf.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./frogql.linux-arm-gnueabihf.node')
-            } else {
-              nativeBinding = require('frogql-linux-arm-gnueabihf')
-            }
-          } catch (e) {
-            loadError = e
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./frogql.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('frogql-linux-loong64-musl')
+          const bindingPackageVersion = require('frogql-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '0.2.8' && 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.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./frogql.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 'riscv64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'frogql.linux-riscv64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./frogql.linux-riscv64-musl.node')
-            } else {
-              nativeBinding = require('frogql-linux-riscv64-musl')
-            }
-          } catch (e) {
-            loadError = e
+        try {
+          const binding = require('frogql-linux-loong64-gnu')
+          const bindingPackageVersion = require('frogql-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.2.8' && 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.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'frogql.linux-riscv64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./frogql.linux-riscv64-gnu.node')
-            } else {
-              nativeBinding = require('frogql-linux-riscv64-gnu')
-            }
-          } catch (e) {
-            loadError = e
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./frogql.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('frogql-linux-riscv64-musl')
+          const bindingPackageVersion = require('frogql-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '0.2.8' && 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.2.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./frogql.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 's390x':
-        localFileExisted = existsSync(
-          join(__dirname, 'frogql.linux-s390x-gnu.node')
-        )
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./frogql.linux-s390x-gnu.node')
-          } else {
-            nativeBinding = require('frogql-linux-s390x-gnu')
+          const binding = require('frogql-linux-riscv64-gnu')
+          const bindingPackageVersion = require('frogql-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-linux-ppc64-gnu')
+        const bindingPackageVersion = require('frogql-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-linux-s390x-gnu')
+        const bindingPackageVersion = require('frogql-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-openharmony-arm64')
+        const bindingPackageVersion = require('frogql-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-openharmony-x64')
+        const bindingPackageVersion = require('frogql-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('frogql-openharmony-arm')
+        const bindingPackageVersion = require('frogql-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '0.2.8' && 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.2.8 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('./frogql.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (forceWasi) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding || forceWasi) {
+    try {
+      wasiBinding = require('frogql-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 { Connection, open, importJson, importCsv } = nativeBinding
-
-module.exports.Connection = Connection
-module.exports.open = open
-module.exports.importJson = importJson
-module.exports.importCsv = importCsv
+module.exports = nativeBinding
+module.exports.Connection = nativeBinding.Connection
+module.exports.importCsv = nativeBinding.importCsv
+module.exports.importJson = nativeBinding.importJson
+module.exports.open = nativeBinding.open

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frogql",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "froGQL — embedded GQL graph database with ISO GQL path patterns (Rust core, Node.js bindings via napi-rs)",
   "main": "index.js",
   "types": "index.d.ts",
@@ -27,17 +27,14 @@
     "node": ">= 16"
   },
   "napi": {
-    "name": "frogql",
-    "triples": {
-      "defaults": false,
-      "additional": [
-        "x86_64-apple-darwin",
-        "aarch64-apple-darwin",
-        "x86_64-unknown-linux-gnu",
-        "aarch64-unknown-linux-gnu",
-        "x86_64-pc-windows-msvc"
-      ]
-    }
+    "binaryName": "frogql",
+    "targets": [
+      "x86_64-apple-darwin",
+      "aarch64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "aarch64-unknown-linux-gnu",
+      "x86_64-pc-windows-msvc"
+    ]
   },
   "scripts": {
     "artifacts": "napi artifacts",
@@ -48,7 +45,7 @@
     "version": "napi version"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^2.18.0",
+    "@napi-rs/cli": "^3.7.2",
     "@types/node": "^20.0.0",
     "typescript": "^5.4.0"
   },
@@ -65,10 +62,10 @@
     "provenance": true
   },
   "optionalDependencies": {
-    "frogql-darwin-x64": "0.2.6",
-    "frogql-darwin-arm64": "0.2.6",
-    "frogql-linux-x64-gnu": "0.2.6",
-    "frogql-linux-arm64-gnu": "0.2.6",
-    "frogql-win32-x64-msvc": "0.2.6"
+    "frogql-darwin-arm64": "0.2.8",
+    "frogql-darwin-x64": "0.2.8",
+    "frogql-linux-arm64-gnu": "0.2.8",
+    "frogql-linux-x64-gnu": "0.2.8",
+    "frogql-win32-x64-msvc": "0.2.8"
   }
 }