@falkordb/text-to-cypher 0.1.14 → 0.1.16

package/CHANGELOG.md

@@ -5,6 +5,33 @@ 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.16] - 2026-06-03
+
+### Added
+- New `examples/token-usage.js` example demonstrating how to read aggregated
+  `tokenUsage` (`promptTokens`, `completionTokens`, `totalTokens`) from responses for
+  both the full `textToCypher` pipeline and the generation-only `cypherOnly` path.
+- README and examples documentation for token-usage tracking and a clearer note that
+  model discovery merges each provider's live list with a curated static catalog.
+
+### Changed
+- Bumped the `text-to-cypher` Rust dependency to `0.1.19`. `listModels()` /
+  `listModelsByProvider()` now merge live provider results with a curated static model
+  catalog, so providers with a curated list return their well-known models even when no
+  matching API key is configured.
+
+## [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 +87,6 @@ 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.16]: https://github.com/FalkorDB/text-to-cypher-node/releases/tag/v0.1.16
+[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

@@ -142,7 +142,7 @@ console.log('Relationships:', schemaObj.relationships);
 
 Lists all available AI models across all supported providers.
 
-**Note:** This method queries all provider APIs (OpenAI, Anthropic, Gemini, Ollama) and aggregates the results. Models are returned with provider prefixes (except OpenAI).
+**Note:** This method queries all provider APIs (OpenAI, Anthropic, Gemini, Ollama) and aggregates the results. Each provider's live results are merged with a small curated static catalog, so providers with a curated list still return their well-known models even when no matching API key is configured. Providers without a curated list (e.g. Ollama) only appear when reachable. Models are returned with provider prefixes (except OpenAI).
 
 **Returns:** `Promise<string[]>` - Array of model names with provider prefixes where applicable
 
@@ -152,17 +152,22 @@ const models = await client.listModels();
 console.log('All available models:', models);
 // Output: [
 //   'gpt-4o-mini', 'gpt-4o', 'gpt-4-turbo',  // OpenAI (no prefix)
-//   'anthropic:claude-sonnet-4-5', 'anthropic:claude-opus-4-5',  // Anthropic
-//   'gemini:gemini-2.5-pro', 'gemini:gemini-3-pro-preview',  // Gemini
-//   'ollama:llama3', 'ollama:mistral'  // Ollama (if running)
+//   'anthropic::claude-sonnet-4-5', 'anthropic::claude-opus-4-5',  // Anthropic
+//   'gemini::gemini-2.5-pro', 'gemini::gemini-3-pro-preview',  // Gemini
+//   'ollama::llama3', 'ollama::mistral'  // Ollama (if running)
 // ]
 ```
 
+Non-OpenAI models are namespaced with a `provider::model` (double-colon) prefix in the
+returned list. When passing a model to the constructor you can use either that form or the
+shorter `provider:model` (single-colon) form — both are accepted (e.g.
+`'anthropic::claude-sonnet-4-5'` and `'anthropic:claude-sonnet-4-5'` are equivalent).
+
 ### `listModelsByProvider(provider)`
 
 Lists available AI models from a specific provider by querying the actual provider APIs.
 
-**Note:** This method makes real API calls to the AI providers to get current model listings. The availability depends on your API credentials and the current offerings from each provider.
+**Note:** This method merges each provider's live model list with a small curated static catalog. Providers with a curated list (OpenAI, Anthropic, Gemini) still return their well-known models even when no matching API key is configured; an API key adds any additional models the provider reports live. Providers without a curated list (e.g. Ollama) are only returned when reachable.
 
 **Parameters:**
 - `provider` (string): Provider name - `'openai'`, `'anthropic'`, `'gemini'`, or `'ollama'` (case-insensitive)
@@ -216,9 +221,24 @@ 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.
+
+See [examples/token-usage.js](examples/token-usage.js) for a complete working example.
+
 ### Message
 
 ```typescript
@@ -301,6 +321,24 @@ try {
 }
 ```
 
+### Tracking Token Usage
+
+Each request aggregates the token counts from every LLM call it makes (cypher generation,
+self-healing retries, skill tool-call rounds, and final answer generation) into
+`response.tokenUsage`:
+
+```javascript
+const response = await client.textToCypher('movies', 'How many actors are there?');
+
+if (response.tokenUsage) {
+  console.log('Prompt tokens:', response.tokenUsage.promptTokens);
+  console.log('Completion tokens:', response.tokenUsage.completionTokens);
+  console.log('Total tokens:', response.tokenUsage.totalTokens);
+}
+```
+
+See [examples/token-usage.js](examples/token-usage.js) for a complete, runnable example.
+
 ## Requirements
 
 - Node.js >= 20

package/examples/README.md

@@ -15,6 +15,34 @@ export FALKORDB_CONNECTION="falkor://localhost:6379"
 node examples/basic-usage.js
 ```
 
+### Model Discovery Example
+
+```bash
+# An API key lets each provider return its live model list; a curated static
+# catalog is also merged in, so well-known models appear even without a key.
+export OPENAI_API_KEY="your-api-key"
+
+node examples/list-models.js
+```
+
+### Token Usage Example
+
+```bash
+# Requires a running FalkorDB and a seeded graph so schema discovery succeeds.
+docker run -d -p 6379:6379 falkordb/falkordb:latest
+redis-cli GRAPH.QUERY demo_graph \
+  "MERGE (:Person {name:'Alice'}) MERGE (:Person {name:'Bob'}) MERGE (:Person {name:'Charlie'})"
+
+# Provide an API key (the account must have available quota)
+export OPENAI_API_KEY="sk-..."
+
+# MODEL defaults to gpt-4o-mini; GRAPH_NAME defaults to demo_graph
+node examples/token-usage.js
+
+# Or load variables from a .env file (Node >= 20.6)
+node --env-file=.env examples/token-usage.js
+```
+
 ### TypeScript Example
 
 ```bash
@@ -28,7 +56,9 @@ ts-node examples/typescript-usage.ts
 ## Examples Included
 
 1. **basic-usage.js** - Comprehensive JavaScript example showing all major features
-2. **typescript-usage.ts** - TypeScript example with type safety
+2. **list-models.js** - Model discovery across providers (`listModels` / `listModelsByProvider`)
+3. **token-usage.js** - Reading aggregated LLM token usage from `response.tokenUsage`
+4. **typescript-usage.ts** - TypeScript example with type safety
 
 ## Prerequisites
 

package/examples/token-usage.js

@@ -0,0 +1,103 @@
+/**
+ * Token-usage tracking example for @falkordb/text-to-cypher
+ *
+ * A single `textToCypher` / `cypherOnly` request may issue several LLM calls
+ * (schema-aware Cypher generation, optional self-healing retries, skill tool-call
+ * rounds, and final answer generation). The library aggregates the token counts
+ * from every one of those calls into `response.tokenUsage`.
+ *
+ * This example runs real requests against an AI model and prints the aggregated
+ * `tokenUsage` for both the full pipeline and the generation-only path.
+ *
+ * To run this example:
+ * 1. Ensure FalkorDB is running, e.g.:
+ *      docker run -d -p 6379:6379 falkordb/falkordb:latest
+ * 2. Seed a graph so schema discovery returns a non-empty ontology, e.g.:
+ *      redis-cli GRAPH.QUERY demo_graph \
+ *        "MERGE (:Person {name:'Alice'}) MERGE (:Person {name:'Bob'}) MERGE (:Person {name:'Charlie'})"
+ * 3. Provide an API key and (optionally) overrides via the environment, then run:
+ *      OPENAI_API_KEY=sk-... node examples/token-usage.js
+ *    or, using a .env file (Node >= 20.6):
+ *      node --env-file=.env examples/token-usage.js
+ *
+ * Supported environment variables:
+ *   OPENAI_API_KEY / DEFAULT_KEY   - API key forwarded to the provider (required)
+ *   MODEL / DEFAULT_MODEL          - model to use (defaults to 'gpt-4o-mini')
+ *   FALKORDB_CONNECTION            - connection string (defaults to 'falkor://localhost:6379')
+ *   GRAPH_NAME                     - graph to query (defaults to 'demo_graph')
+ */
+
+const { TextToCypher } = require('../index');
+
+function reportUsage(response) {
+  if (response.answer) {
+    console.log('Answer:', response.answer);
+  }
+
+  const usage = response.tokenUsage;
+  if (!usage) {
+    console.error(
+      '✗ No tokenUsage reported on the response — the provider may not return usage data.'
+    );
+    return;
+  }
+
+  console.log('Token usage:');
+  console.log(`  promptTokens     = ${usage.promptTokens}`);
+  console.log(`  completionTokens = ${usage.completionTokens}`);
+  console.log(`  totalTokens      = ${usage.totalTokens}`);
+
+  if (usage.totalTokens === 0) {
+    console.error(
+      '⚠ tokenUsage was reported but totalTokens is 0 — the provider may not return usage data.'
+    );
+  } else {
+    console.log('✓ Token usage tracking is working.');
+  }
+}
+
+async function main() {
+  const apiKey = process.env.OPENAI_API_KEY || process.env.DEFAULT_KEY;
+  if (!apiKey) {
+    console.error('Please set OPENAI_API_KEY (or DEFAULT_KEY) to run this example.');
+    process.exit(1);
+  }
+
+  const model = process.env.MODEL || process.env.DEFAULT_MODEL || 'gpt-4o-mini';
+  const falkordbConnection = process.env.FALKORDB_CONNECTION || 'falkor://localhost:6379';
+  const graphName = process.env.GRAPH_NAME || 'demo_graph';
+
+  console.log('=== Token Usage Tracking Example ===');
+  console.log(`model: ${model}`);
+  console.log(`connection: ${falkordbConnection}`);
+  console.log(`graph: ${graphName}\n`);
+
+  const client = new TextToCypher({ model, apiKey, falkordbConnection });
+
+  // Example 1: full pipeline (generate -> execute -> answer). Usage is summed across
+  // every LLM call the request made.
+  console.log('--- Example 1: full textToCypher pipeline ---');
+  try {
+    const response = await client.textToCypher(graphName, 'How many people are in the graph?');
+    reportUsage(response);
+  } catch (error) {
+    console.error('✗ Request failed:', error.message);
+  }
+
+  // Example 2: cypherOnly (no execution / no answer generation). Usage should reflect
+  // just the query-generation call(s) and therefore typically be smaller.
+  console.log('\n--- Example 2: cypherOnly (generation only) ---');
+  try {
+    const response = await client.cypherOnly(graphName, 'List the names of all people.');
+    if (response.cypherQuery) {
+      console.log('Generated query:', response.cypherQuery);
+    }
+    reportUsage(response);
+  } catch (error) {
+    console.error('✗ Request failed:', error.message);
+  }
+
+  console.log('\n=== Example completed ===');
+}
+
+main().catch(console.error);

package/index.d.ts

@@ -165,8 +165,10 @@ export declare class TextToCypher {
    *
    * # Note
    *
-   * This method queries the actual AI provider APIs to get the list of available models.
-   * The availability depends on your API credentials and the current offerings from each provider.
+   * Each provider's live results are merged with a curated static catalog, so
+   * providers with a curated list (OpenAI, Anthropic, Gemini) still return their
+   * well-known models even when no matching API key is configured. Providers without
+   * a curated list (e.g. Ollama) are only returned when reachable.
    *
    * # Returns
    *
@@ -215,4 +217,25 @@ export interface TextToCypherResponse {
   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

@@ -77,8 +77,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       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.14' && 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.14 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.16' && 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.16 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@falkordb/text-to-cypher",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Node.js bindings for FalkorDB text-to-cypher library - Convert natural language to Cypher queries",
   "main": "index.js",
   "types": "index.d.ts",