@moss-js/moss-core 0.29.0 → 0.30.0

package/index.d.ts

@@ -124,29 +124,29 @@ export declare class IndexManager {
   /** Best-effort bulk unload; names that are not loaded are ignored. */
   unloadIndexes(indexNames: Array<string>): Promise<void>
   hasIndex(indexName: string): Promise<boolean>
-  query(indexName: string, query: string, queryEmbedding: Array<number>, topK?: number, alpha?: number, filter?: object): Promise<SearchResult>
-  queryText(indexName: string, query: string, topK?: number, alpha?: number, filter?: object): Promise<SearchResult>
+  query(indexName: string, query: string, queryEmbedding: Array<number>, topK?: number, alpha?: number, filter?: object, tuning?: QueryTuning): Promise<SearchResult>
+  queryText(indexName: string, query: string, topK?: number, alpha?: number, filter?: object, tuning?: QueryTuning): Promise<SearchResult>
   /**
    * Multi-index search with a caller-supplied query embedding. Every name
    * must be loaded and share one embedding model; results carry `indexName`.
-   * `alpha` works as in `query`: 1.0 embedding-only (raw cosine scores),
-   * 0.0 keyword-only, in between hybrid via RRF. Defaults: topK 10, alpha 0.8.
+   * `alpha` works as in `query`: 1.0 embedding-only, 0.0 keyword-only,
+   * in between hybrid. Defaults: topK 10, alpha 0.8.
    */
-  queryMultiIndex(indexNames: Array<string>, query: string, queryEmbedding: Array<number>, topK?: number, alpha?: number, filter?: object): Promise<SearchResult>
+  queryMultiIndex(indexNames: Array<string>, query: string, queryEmbedding: Array<number>, topK?: number, alpha?: number, filter?: object, tuning?: QueryTuning): Promise<SearchResult>
   /**
    * Multi-index search where the core embeds the query text. Same contract as
    * `queryMultiIndex`. With `alpha` above 0 the core embeds the query, which needs
    * builtin-model indexes with an exact artifact identity; `alpha` 0 skips
    * embedding and also works for custom-model and identity-less indexes.
    */
-  queryMultiIndexText(indexNames: Array<string>, query: string, topK?: number, alpha?: number, filter?: object): Promise<SearchResult>
+  queryMultiIndexText(indexNames: Array<string>, query: string, topK?: number, alpha?: number, filter?: object, tuning?: QueryTuning): Promise<SearchResult>
   loadQueryModel(indexName: string): Promise<void>
   refreshIndex(indexName: string): Promise<RefreshResult>
   getIndexInfo(indexName: string): Promise<IndexInfo>
   /**
    * Release the manager's native resources: aborts index pollers and
-   * starts a final telemetry flush via the core Drop (fire-and-forget,
-   * not awaited by this promise). In-flight calls that already
+   * sends the final telemetry flush, which this promise waits for, so a
+   * process can exit right after it resolves. In-flight calls that already
    * hold the manager finish normally; the memory is freed when the
    * last one completes. Idempotent. The process-wide shared runtime
    * is unaffected.
@@ -380,9 +380,10 @@ export declare class SessionIndex {
   inspectSnapshot(cachePath: string): Promise<SnapshotInfo>
   /**
    * Release the session's native resources now instead of waiting for
-   * GC: aborts the auto-refresh poller, starts a final telemetry flush
-   * (fire-and-forget, not awaited by this promise), and drops the
-   * index plus its shared embedding-model reference. Idempotent.
+   * GC: aborts the auto-refresh poller, sends the final telemetry flush,
+   * and drops the index plus its shared embedding-model reference. The
+   * promise waits for the flush, so a process can exit once it resolves.
+   * Idempotent.
    * Afterwards `name` and `modelId` still read, `setDeviceId` is a no-op, and every
    * other method fails with "SessionIndex is closed". The process-wide
    * shared runtime is unaffected.
@@ -557,7 +558,10 @@ export interface LoadIndexesResult {
 export interface LoadIndexOptions {
   /** Enable auto-refresh polling for this index. */
   autoRefresh?: boolean
-  /** Polling interval in seconds (default: 600 / 10 minutes). */
+  /**
+   * Polling interval in seconds (default: 600 / 10 minutes).
+   * An interval of 0 uses the default, and the minimum is 1 second.
+   */
   pollingIntervalInSeconds?: number
   /** Optional filesystem path for caching index data to disk. */
   cachePath?: string
@@ -638,14 +642,30 @@ export interface PushIndexResult {
 
 /** Options for query operations. */
 export interface QueryOptions {
-  /** Caller-provided embedding vector. When supplied, skips embedding generation. */
+  /**
+   * Caller-provided embedding vector. When supplied, skips embedding generation.
+   * Checked at every `alpha`: each component must be finite, and its length
+   * must match the dimension of each queried index that holds vectors.
+   */
   embedding?: Array<number>
-  /** Number of top results to return. */
+  /** Number of top results to return. 0 returns no results. */
   topK?: number
   /** Weight for hybrid search fusion (0.0 to 1.0). Default 0.8. */
   alpha?: number
   /** Optional metadata filter for narrowing results. */
   filter?: any
+  /**
+   * Relevance floor from 0 to 1. Drops results below it.
+   * Returns up to `topK` results that clear it, in hybrid order.
+   * Rejected on a keyword-only query (`alpha` 0).
+   */
+  minScore?: number
+  /**
+   * Hits a hybrid query ranks on each signal before fusion (default `2 * topK`).
+   * A deeper list raises recall. A set value must be at least 1 and is raised to `topK`.
+   * Keyword-only and vector-only queries (`alpha` 0 or 1) ignore it and rank `topK` hits.
+   */
+  candidateDepth?: number
 }
 
 /** Document returned from a query with similarity metadata. */
@@ -656,7 +676,13 @@ export interface QueryResultDocumentInfo {
   text: string
   /** Optional metadata associated with the document. */
   metadata?: Record<string, string>
-  /** Similarity score between 0 and 1 (higher is more relevant). */
+  /**
+   * Relevance to the query from 0 to 1.
+   * It comes from vector similarity alone, so `alpha` and rank never change it.
+   * Results are ordered by hybrid relevance, so a lower result can show a higher score.
+   * A keyword-only query (`alpha` 0, or an index without vectors) scores every hit 0.
+   * Scores depend on the embedding model: tune `minScore` on your own queries.
+   */
   score: number
   /** Optional opaque payload stored with the document, returned as-is. */
   payload?: string
@@ -664,6 +690,22 @@ export interface QueryResultDocumentInfo {
   indexName?: string
 }
 
+/** Optional settings taken after `filter` by the `IndexManager` query methods. */
+export interface QueryTuning {
+  /**
+   * Relevance floor from 0 to 1. Drops results below it.
+   * Returns up to `topK` results that clear it, in hybrid order.
+   * Rejected on a keyword-only query (`alpha` 0).
+   */
+  minScore?: number
+  /**
+   * Hits a hybrid query ranks on each signal before fusion (default `2 * topK`).
+   * A deeper list raises recall. A set value must be at least 1 and is raised to `topK`.
+   * Keyword-only and vector-only queries (`alpha` 0 or 1) ignore it and rank `topK` hits.
+   */
+  candidateDepth?: number
+}
+
 /** Result of an index refresh operation. */
 export interface RefreshResult {
   /** Name of the index that was refreshed. */
@@ -758,3 +800,6 @@ export interface SnapshotInfo {
   /** True for the pre-generation flat layout older cores wrote. */
   legacyLayout: boolean
 }
+
+/** Throws the error `ManageClient` gives for an index name the cloud cannot address. */
+export declare function validateIndexName(name: string): void

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@moss-js/moss-core-android-arm64')
         const bindingPackageVersion = require('@moss-js/moss-core-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-android-arm-eabi')
         const bindingPackageVersion = require('@moss-js/moss-core-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-win32-x64-gnu')
         const bindingPackageVersion = require('@moss-js/moss-core-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-win32-x64-msvc')
         const bindingPackageVersion = require('@moss-js/moss-core-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-win32-ia32-msvc')
         const bindingPackageVersion = require('@moss-js/moss-core-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-win32-arm64-msvc')
         const bindingPackageVersion = require('@moss-js/moss-core-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-darwin-universal')
       const bindingPackageVersion = require('@moss-js/moss-core-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-darwin-x64')
         const bindingPackageVersion = require('@moss-js/moss-core-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-darwin-arm64')
         const bindingPackageVersion = require('@moss-js/moss-core-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-freebsd-x64')
         const bindingPackageVersion = require('@moss-js/moss-core-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-freebsd-arm64')
         const bindingPackageVersion = require('@moss-js/moss-core-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-linux-x64-musl')
           const bindingPackageVersion = require('@moss-js/moss-core-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-linux-x64-gnu')
           const bindingPackageVersion = require('@moss-js/moss-core-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-linux-arm64-musl')
           const bindingPackageVersion = require('@moss-js/moss-core-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-linux-arm64-gnu')
           const bindingPackageVersion = require('@moss-js/moss-core-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-linux-arm-musleabihf')
           const bindingPackageVersion = require('@moss-js/moss-core-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@moss-js/moss-core-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-linux-loong64-musl')
           const bindingPackageVersion = require('@moss-js/moss-core-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-linux-loong64-gnu')
           const bindingPackageVersion = require('@moss-js/moss-core-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-linux-riscv64-musl')
           const bindingPackageVersion = require('@moss-js/moss-core-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-linux-riscv64-gnu')
           const bindingPackageVersion = require('@moss-js/moss-core-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-linux-ppc64-gnu')
         const bindingPackageVersion = require('@moss-js/moss-core-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-linux-s390x-gnu')
         const bindingPackageVersion = require('@moss-js/moss-core-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-openharmony-arm64')
         const bindingPackageVersion = require('@moss-js/moss-core-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-openharmony-x64')
         const bindingPackageVersion = require('@moss-js/moss-core-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 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('@moss-js/moss-core-openharmony-arm')
         const bindingPackageVersion = require('@moss-js/moss-core-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.29.0' && 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.29.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.30.0' && 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.30.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -599,3 +599,4 @@ module.exports.rejectAuthRequest = nativeBinding.rejectAuthRequest
 module.exports.resolveAuthRequest = nativeBinding.resolveAuthRequest
 module.exports.SDK_VERSION_NUMBER = nativeBinding.SDK_VERSION_NUMBER
 module.exports.serializeToBinary = nativeBinding.serializeToBinary
+module.exports.validateIndexName = nativeBinding.validateIndexName

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moss-js/moss-core",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "Connects JS SDK to Rust Moss-Core using N-API",
   "main": "index.js",
   "types": "index.d.ts",
@@ -62,10 +62,10 @@
     "typescript": "^5.9.2"
   },
   "optionalDependencies": {
-    "@moss-js/moss-core-win32-x64-msvc": "0.29.0",
-    "@moss-js/moss-core-linux-x64-gnu": "0.29.0",
-    "@moss-js/moss-core-linux-arm64-gnu": "0.29.0",
-    "@moss-js/moss-core-darwin-arm64": "0.29.0",
-    "@moss-js/moss-core-darwin-x64": "0.29.0"
+    "@moss-js/moss-core-win32-x64-msvc": "0.30.0",
+    "@moss-js/moss-core-linux-x64-gnu": "0.30.0",
+    "@moss-js/moss-core-linux-arm64-gnu": "0.30.0",
+    "@moss-js/moss-core-darwin-arm64": "0.30.0",
+    "@moss-js/moss-core-darwin-x64": "0.30.0"
   }
 }