@falkordb/text-to-cypher 0.1.13 → 0.1.15

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.15] - 2026-06-02
+
+### Added
+- Token usage reporting: `TextToCypherResponse` now includes an optional `tokenUsage`
+  field aggregating `promptTokens`, `completionTokens`, and `totalTokens` across all LLM
+  calls made while serving a request (cypher generation, final answer, self-healing
+  retries, and skill tool-call rounds). Present on successful responses and omitted when
+  no tokens were consumed.
+
+### Changed
+- Bumped the `text-to-cypher` Rust dependency to `0.1.18`.
+
 ## [0.1.10] - 2026-01-12
 
 ### Added
@@ -60,4 +72,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Proper error handling and propagation from Rust to JavaScript
 - Zero runtime dependencies
 
+[0.1.15]: https://github.com/FalkorDB/text-to-cypher-node/releases/tag/v0.1.15
 [0.1.0]: https://github.com/FalkorDB/text-to-cypher-node/releases/tag/v0.1.0

package/README.md

@@ -216,9 +216,22 @@ interface TextToCypherResponse {
   cypherResult?: string;    // Query execution result
   answer?: string;          // Natural language answer
   error?: string;           // Error message if status is "error"
+  tokenUsage?: TokenUsage;  // Aggregated LLM token usage (omitted when no tokens were spent)
+}
+
+interface TokenUsage {
+  promptTokens: number;     // Total input (prompt) tokens across all LLM calls
+  completionTokens: number; // Total output (completion) tokens across all LLM calls
+  totalTokens: number;      // Total tokens across all LLM calls
 }
 ```
 
+`tokenUsage` aggregates the prompt, completion, and total tokens reported by the LLM
+provider across every call made while serving a request (cypher generation, the final
+answer, self-healing retries, and skill tool-call rounds). It is present on successful
+responses and omitted when no tokens were consumed. Failed requests reject with an error,
+so `tokenUsage` is not surfaced for failures.
+
 ### Message
 
 ```typescript
@@ -303,7 +316,7 @@ try {
 
 ## Requirements
 
-- Node.js >= 10
+- Node.js >= 20
 - FalkorDB instance running and accessible
 - API key for your chosen AI provider (OpenAI, Anthropic, etc.)
 
@@ -325,7 +338,7 @@ npm test
 ### Prerequisites for Building
 
 - Rust toolchain (install from [rustup.rs](https://rustup.rs/))
-- Node.js >= 10
+- Node.js >= 20
 - C++ compiler (platform-specific)
 
 ## Platform Support
@@ -338,6 +351,16 @@ Pre-built binaries are available for:
 - macOS ARM64 (Apple Silicon)
 - Windows x64
 
+## Releasing
+
+Versions are derived automatically from Git tags. To publish a new release:
+
+1. Create a GitHub release with a semver tag (e.g., `v1.2.0`)
+2. The release workflow builds all platform binaries and publishes to npm
+3. The version in `package.json` (`0.0.0`) is a placeholder — the release CI sets the real version from the tag
+
+No manual `package.json` version edits are needed.
+
 ## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.

package/index.d.ts

@@ -1,39 +1,5 @@
-/* tslint:disable */
-/* eslint-disable */
-
 /* auto-generated by NAPI-RS */
-
-/** Options for creating a TextToCypher client */
-export interface ClientOptions {
-  /** The AI model to use (e.g., "gpt-4o-mini", "anthropic:claude-3") */
-  model: string
-  /** API key for the AI service */
-  apiKey: string
-  /** FalkorDB connection string (e.g., "falkor://localhost:6379") */
-  falkordbConnection: string
-}
-/** A chat message in the conversation */
-export interface Message {
-  /** Role of the message sender: "user", "assistant", or "system" */
-  role: string
-  /** Content of the message */
-  content: string
-}
-/** Response from text-to-cypher operations */
-export interface TextToCypherResponse {
-  /** Status of the operation: "success" or "error" */
-  status: string
-  /** The discovered graph schema (JSON string) */
-  schema?: string
-  /** The generated Cypher query */
-  cypherQuery?: string
-  /** The result from executing the Cypher query */
-  cypherResult?: string
-  /** Natural language answer generated from the results */
-  answer?: string
-  /** Error message if status is "error" */
-  error?: string
-}
+/* eslint-disable */
 /**
  * Node.js wrapper for the text-to-cypher Rust library
  *
@@ -216,3 +182,58 @@ export declare class TextToCypher {
    */
   listModelsByProvider(provider: string): Promise<Array<string>>
 }
+
+/** Options for creating a TextToCypher client */
+export interface ClientOptions {
+  /** The AI model to use (e.g., "gpt-4o-mini", "anthropic:claude-3") */
+  model: string
+  /** API key for the AI service */
+  apiKey: string
+  /** FalkorDB connection string (e.g., "falkor://localhost:6379") */
+  falkordbConnection: string
+}
+
+/** A chat message in the conversation */
+export interface Message {
+  /** Role of the message sender: "user", "assistant", or "system" */
+  role: string
+  /** Content of the message */
+  content: string
+}
+
+/** Response from text-to-cypher operations */
+export interface TextToCypherResponse {
+  /** Status of the operation: "success" or "error" */
+  status: string
+  /** The discovered graph schema (JSON string) */
+  schema?: string
+  /** The generated Cypher query */
+  cypherQuery?: string
+  /** The result from executing the Cypher query */
+  cypherResult?: string
+  /** Natural language answer generated from the results */
+  answer?: string
+  /** Error message if status is "error" */
+  error?: string
+  /**
+   * Aggregated token usage across all LLM calls made while serving the request.
+   * Omitted when no tokens were consumed (e.g. failures before any LLM call).
+   */
+  tokenUsage?: TokenUsage
+}
+
+/**
+ * Aggregated token usage for a text-to-cypher request
+ *
+ * A single request may issue several LLM calls (cypher generation, final answer
+ * generation, self-healing retries, and skill tool-call rounds). These counts are
+ * summed across all of those calls.
+ */
+export interface TokenUsage {
+  /** Total input (prompt) tokens consumed across all LLM calls */
+  promptTokens: number
+  /** Total output (completion) tokens produced across all LLM calls */
+  completionTokens: number
+  /** Total tokens consumed across all LLM calls */
+  totalTokens: number
+}

package/index.js

@@ -1,315 +1,579 @@
-/* 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('node: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 (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, 'text-to-cypher.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('./text-to-cypher.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-android-arm64')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-android-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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('./text-to-cypher.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-android-arm-eabi')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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 {
-          if (localFileExisted) {
-            nativeBinding = require('./text-to-cypher.android-arm64.node')
-          } else {
-            nativeBinding = require('@falkordb/text-to-cypher-android-arm64')
-          }
+        return require('./text-to-cypher.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-win32-x64-gnu')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./text-to-cypher.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-win32-x64-msvc')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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('./text-to-cypher.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-win32-ia32-msvc')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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('./text-to-cypher.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-win32-arm64-msvc')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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('./text-to-cypher.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('@falkordb/text-to-cypher-darwin-universal')
+      const bindingPackageVersion = require('@falkordb/text-to-cypher-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '0.1.15' && 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.1.15 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('./text-to-cypher.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-darwin-x64')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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('./text-to-cypher.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-darwin-arm64')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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('./text-to-cypher.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-freebsd-x64')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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('./text-to-cypher.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-freebsd-arm64')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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('./text-to-cypher.linux-x64-musl.node')
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'arm':
-        localFileExisted = existsSync(join(__dirname, 'text-to-cypher.android-arm-eabi.node'))
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./text-to-cypher.android-arm-eabi.node')
-          } else {
-            nativeBinding = require('@falkordb/text-to-cypher-android-arm-eabi')
+          const binding = require('@falkordb/text-to-cypher-linux-x64-musl')
+          const bindingPackageVersion = require('@falkordb/text-to-cypher-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.15' && 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.1.15 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, 'text-to-cypher.win32-x64-msvc.node')
-        )
+      } else {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./text-to-cypher.win32-x64-msvc.node')
-          } else {
-            nativeBinding = require('@falkordb/text-to-cypher-win32-x64-msvc')
-          }
+          return require('./text-to-cypher.linux-x64-gnu.node')
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'ia32':
-        localFileExisted = existsSync(
-          join(__dirname, 'text-to-cypher.win32-ia32-msvc.node')
-        )
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./text-to-cypher.win32-ia32-msvc.node')
-          } else {
-            nativeBinding = require('@falkordb/text-to-cypher-win32-ia32-msvc')
+          const binding = require('@falkordb/text-to-cypher-linux-x64-gnu')
+          const bindingPackageVersion = require('@falkordb/text-to-cypher-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.15' && 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.1.15 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, 'text-to-cypher.win32-arm64-msvc.node')
-        )
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./text-to-cypher.win32-arm64-msvc.node')
-          } else {
-            nativeBinding = require('@falkordb/text-to-cypher-win32-arm64-msvc')
+          return require('./text-to-cypher.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@falkordb/text-to-cypher-linux-arm64-musl')
+          const bindingPackageVersion = require('@falkordb/text-to-cypher-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.15' && 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.1.15 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, 'text-to-cypher.darwin-universal.node'))
-    try {
-      if (localFileExisted) {
-        nativeBinding = require('./text-to-cypher.darwin-universal.node')
       } else {
-        nativeBinding = require('@falkordb/text-to-cypher-darwin-universal')
-      }
-      break
-    } catch {}
-    switch (arch) {
-      case 'x64':
-        localFileExisted = existsSync(join(__dirname, 'text-to-cypher.darwin-x64.node'))
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./text-to-cypher.darwin-x64.node')
-          } else {
-            nativeBinding = require('@falkordb/text-to-cypher-darwin-x64')
-          }
+          return require('./text-to-cypher.linux-arm64-gnu.node')
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'arm64':
-        localFileExisted = existsSync(
-          join(__dirname, 'text-to-cypher.darwin-arm64.node')
-        )
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./text-to-cypher.darwin-arm64.node')
-          } else {
-            nativeBinding = require('@falkordb/text-to-cypher-darwin-arm64')
+          const binding = require('@falkordb/text-to-cypher-linux-arm64-gnu')
+          const bindingPackageVersion = require('@falkordb/text-to-cypher-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.15' && 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.1.15 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, 'text-to-cypher.freebsd-x64.node'))
-    try {
-      if (localFileExisted) {
-        nativeBinding = require('./text-to-cypher.freebsd-x64.node')
-      } else {
-        nativeBinding = require('@falkordb/text-to-cypher-freebsd-x64')
       }
-    } catch (e) {
-      loadError = e
-    }
-    break
-  case 'linux':
-    switch (arch) {
-      case 'x64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'text-to-cypher.linux-x64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./text-to-cypher.linux-x64-musl.node')
-            } else {
-              nativeBinding = require('@falkordb/text-to-cypher-linux-x64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'text-to-cypher.linux-x64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./text-to-cypher.linux-x64-gnu.node')
-            } else {
-              nativeBinding = require('@falkordb/text-to-cypher-linux-x64-gnu')
-            }
-          } catch (e) {
-            loadError = e
-          }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./text-to-cypher.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 'arm64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'text-to-cypher.linux-arm64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./text-to-cypher.linux-arm64-musl.node')
-            } else {
-              nativeBinding = require('@falkordb/text-to-cypher-linux-arm64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'text-to-cypher.linux-arm64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./text-to-cypher.linux-arm64-gnu.node')
-            } else {
-              nativeBinding = require('@falkordb/text-to-cypher-linux-arm64-gnu')
-            }
-          } catch (e) {
-            loadError = e
+        try {
+          const binding = require('@falkordb/text-to-cypher-linux-arm-musleabihf')
+          const bindingPackageVersion = require('@falkordb/text-to-cypher-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '0.1.15' && 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.1.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./text-to-cypher.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 'arm':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'text-to-cypher.linux-arm-musleabihf.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./text-to-cypher.linux-arm-musleabihf.node')
-            } else {
-              nativeBinding = require('@falkordb/text-to-cypher-linux-arm-musleabihf')
-            }
-          } catch (e) {
-            loadError = e
+        try {
+          const binding = require('@falkordb/text-to-cypher-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('@falkordb/text-to-cypher-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '0.1.15' && 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.1.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'text-to-cypher.linux-arm-gnueabihf.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./text-to-cypher.linux-arm-gnueabihf.node')
-            } else {
-              nativeBinding = require('@falkordb/text-to-cypher-linux-arm-gnueabihf')
-            }
-          } catch (e) {
-            loadError = e
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./text-to-cypher.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@falkordb/text-to-cypher-linux-loong64-musl')
+          const bindingPackageVersion = require('@falkordb/text-to-cypher-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.15' && 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.1.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 'riscv64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'text-to-cypher.linux-riscv64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./text-to-cypher.linux-riscv64-musl.node')
-            } else {
-              nativeBinding = require('@falkordb/text-to-cypher-linux-riscv64-musl')
-            }
-          } catch (e) {
-            loadError = e
+      } else {
+        try {
+          return require('./text-to-cypher.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@falkordb/text-to-cypher-linux-loong64-gnu')
+          const bindingPackageVersion = require('@falkordb/text-to-cypher-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.15' && 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.1.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'text-to-cypher.linux-riscv64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./text-to-cypher.linux-riscv64-gnu.node')
-            } else {
-              nativeBinding = require('@falkordb/text-to-cypher-linux-riscv64-gnu')
-            }
-          } catch (e) {
-            loadError = e
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./text-to-cypher.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@falkordb/text-to-cypher-linux-riscv64-musl')
+          const bindingPackageVersion = require('@falkordb/text-to-cypher-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.15' && 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.1.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./text-to-cypher.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 's390x':
-        localFileExisted = existsSync(
-          join(__dirname, 'text-to-cypher.linux-s390x-gnu.node')
-        )
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./text-to-cypher.linux-s390x-gnu.node')
-          } else {
-            nativeBinding = require('@falkordb/text-to-cypher-linux-s390x-gnu')
+          const binding = require('@falkordb/text-to-cypher-linux-riscv64-gnu')
+          const bindingPackageVersion = require('@falkordb/text-to-cypher-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.15' && 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.1.15 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('./text-to-cypher.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-linux-ppc64-gnu')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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 if (process.arch === 's390x') {
+      try {
+        return require('./text-to-cypher.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-linux-s390x-gnu')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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}`))
     }
-    break
-  default:
-    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./text-to-cypher.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-openharmony-arm64')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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('./text-to-cypher.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-openharmony-x64')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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('./text-to-cypher.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@falkordb/text-to-cypher-openharmony-arm')
+        const bindingPackageVersion = require('@falkordb/text-to-cypher-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '0.1.15' && 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.1.15 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()
+
+if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  let wasiBinding = null
+  let wasiBindingError = null
+  try {
+    wasiBinding = require('./text-to-cypher.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (process.env.NAPI_RS_FORCE_WASI) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+    try {
+      wasiBinding = require('@falkordb/text-to-cypher-wasm32-wasi')
+      nativeBinding = wasiBinding
+    } catch (err) {
+      if (process.env.NAPI_RS_FORCE_WASI) {
+        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) {
+    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`)
 }
 
-const { TextToCypher } = nativeBinding
-
-module.exports.TextToCypher = TextToCypher
+module.exports = nativeBinding
+module.exports.TextToCypher = nativeBinding.TextToCypher

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@falkordb/text-to-cypher",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Node.js bindings for FalkorDB text-to-cypher library - Convert natural language to Cypher queries",
   "main": "index.js",
   "types": "index.d.ts",
@@ -25,22 +25,20 @@
   },
   "homepage": "https://github.com/FalkorDB/text-to-cypher-node#readme",
   "napi": {
-    "name": "text-to-cypher",
-    "triples": {
-      "additional": [
-        "x86_64-apple-darwin",
-        "aarch64-apple-darwin",
-        "x86_64-pc-windows-msvc",
-        "x86_64-unknown-linux-gnu",
-        "aarch64-unknown-linux-gnu",
-        "x86_64-unknown-linux-musl",
-        "aarch64-unknown-linux-musl",
-	"universal-apple-darwin"  
-      ]
-    }
+    "binaryName": "text-to-cypher",
+    "targets": [
+      "x86_64-apple-darwin",
+      "aarch64-apple-darwin",
+      "x86_64-pc-windows-msvc",
+      "x86_64-unknown-linux-gnu",
+      "aarch64-unknown-linux-gnu",
+      "x86_64-unknown-linux-musl",
+      "aarch64-unknown-linux-musl",
+      "universal-apple-darwin"
+    ]
   },
   "engines": {
-    "node": ">= 16"
+    "node": ">= 20"
   },
   "scripts": {
     "artifacts": "napi artifacts",
@@ -51,18 +49,19 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "universal": "napi universal",
+    "universal": "napi universalize",
     "version": "napi version",
     "format": "prettier --write .",
     "lint": "eslint . --ext .ts,.js"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^2.18.0",
-    "@types/node": "^25.0.3",
-    "@vitest/coverage-v8": "^1.2.0",
+    "@napi-rs/cli": "^3.5.1",
+    "@types/node": "^25.3.3",
+    "@vitest/coverage-v8": "^4.1.4",
+    "minimatch": "^10.2.5",
     "prettier": "^3.2.0",
-    "typescript": "^5.3.3",
-    "vitest": "^1.2.0"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.4"
   },
   "files": [
     "index.js",