@moss-js/moss-core 0.27.0 → 0.29.0

package/index.d.ts

@@ -223,7 +223,13 @@ export declare class SessionIndex {
    * `artifactVersion` and `manifestSha256` must be supplied together or both omitted.
    */
   static withAuthenticator(name: string, modelId: string, projectId: string, notifyFn: (err: Error | null, requestId: number) => void, baseUrl?: string | null, clientId?: string | null, artifactVersion?: string | null, manifestSha256?: string | null): Promise<SessionIndex>
-  /** Number of documents currently in the session. */
+  /**
+   * Number of documents currently in the session. Synchronous and never
+   * waits: it reports the count as of the last completed call and queues
+   * one turn that applies any staged auto-refresh version on a worker
+   * thread, so the count catches up on a later read instead of doing
+   * native work on this thread.
+   */
   get docCount(): number
   /**
    * Session index name. Identifies the cloud index when `pushIndex` /
@@ -233,23 +239,35 @@ export declare class SessionIndex {
   /**
    * Embedding model id this session is configured for
    * (`"moss-minilm"`, `"moss-mediumlm"`, `"moss-litelm"`, or `"custom"`).
+   * Synchronous and never waits: it reports the value as of the last
+   * completed call, and stays readable after `close()`.
    */
   get modelId(): string
   /**
    * Set the stable per-device identifier emitted as `deviceId` on every
    * telemetry event. `null` keeps the current id. No-op when telemetry is
-   * disabled for this session, or when the session has been closed.
+   * disabled for this session, or when the session has been closed. Applied
+   * in turn behind the calls issued before it, so telemetry those calls
+   * emit still carries the previous id; never blocks the caller.
    */
   setDeviceId(deviceId?: string | undefined | null): void
-  /** Set billable and Moss-owned telemetry identity together. */
+  /**
+   * Set billable and Moss-owned telemetry identity together. Values are
+   * validated synchronously; the update is applied in turn behind the calls
+   * issued before it (telemetry those calls emit still carries the previous
+   * identity) and never blocks the caller.
+   */
   setIdentity(deviceId?: string | undefined | null, userId?: string | undefined | null, mossDeviceId?: string | undefined | null): void
   /**
    * Add or upsert documents with precomputed embeddings.
    *
    * Embeddings must be supplied in the same order as `docs`. For
    * `modelId = "custom"` this is the only ingest path.
+   *
+   * Returns a `Promise`: indexing runs on a native worker thread rather
+   * than the Node main thread.
    */
-  addDocuments(docs: Array<DocumentInfo>, embeddings: Array<Array<number>>, options?: AddDocumentsOptions | null): SessionUpdateResult
+  addDocuments(docs: Array<DocumentInfo>, embeddings: Array<Array<number>>, options?: AddDocumentsOptions | null): Promise<SessionUpdateResult>
   /**
    * Add or upsert documents using the session's bundled embedding model
    * to compute embeddings locally. The model is loaded on demand on the
@@ -257,38 +275,52 @@ export declare class SessionIndex {
    * to pre-warm and move that cost out of the latency-sensitive path.
    * Rejects when `modelId = "custom"` — use `addDocuments` with
    * precomputed vectors in that case.
+   *
+   * Returns a `Promise`: embedding and indexing run on a native worker
+   * thread, so the Node event loop keeps serving I/O while a large
+   * batch is processed.
    */
-  addDocumentsText(docs: Array<DocumentInfo>, options?: AddDocumentsOptions | null): SessionUpdateResult
+  addDocumentsText(docs: Array<DocumentInfo>, options?: AddDocumentsOptions | null): Promise<SessionUpdateResult>
   /**
-   * Remove documents by id. Returns the number of documents removed
+   * Remove documents by id. Resolves to the number of documents removed
    * (may be less than `docIds.length` if some ids weren't present).
    */
-  deleteDocuments(docIds: Array<string>): number
+  deleteDocuments(docIds: Array<string>): Promise<number>
   /**
    * Fetch documents currently in the session. With `options.docIds`
-   * returns matching documents; without, returns all.
+   * resolves to the matching documents; without, to all of them.
    */
-  getDocuments(options?: GetDocumentsOptions | null): Array<DocumentInfo>
+  getDocuments(options?: GetDocumentsOptions | null): Promise<Array<DocumentInfo>>
   /**
    * Hybrid (keyword + semantic) search over the session, using a
    * precomputed query embedding. `alpha` blends sparse (0.0) and
    * dense (1.0) scores; defaults to 0.8.
+   *
+   * Returns a `Promise`: search runs on a native worker thread rather
+   * than the Node main thread.
    */
-  query(query: string, topK: number, queryEmbedding: Array<number>, alpha?: number | null, filter?: object | null): SearchResult
+  query(query: string, topK: number, queryEmbedding: Array<number>, alpha?: number | null, filter?: object | null): Promise<SearchResult>
   /**
    * Same as `query` but computes the query embedding locally using
    * the session's bundled model. The model is loaded on demand on the
    * first call; `loadModel()` is available as an optional pre-warm.
    * Rejects on `modelId = "custom"`.
+   *
+   * Returns a `Promise`: embedding and search run on a native worker
+   * thread rather than the Node main thread.
    */
-  queryText(query: string, topK: number, alpha?: number | null, filter?: object | null): SearchResult
+  queryText(query: string, topK: number, alpha?: number | null, filter?: object | null): Promise<SearchResult>
   /**
    * Pre-download and initialize the embedding model. Optional — the
    * session calls this lazily on the first `addDocumentsText` /
    * `queryText`, but invoking it upfront moves the cold start out of
-   * the latency-sensitive path. No-op for `modelId = "custom"`.
+   * the latency-sensitive path. Rejects for `modelId = "custom"`, which
+   * has no bundled model.
+   *
+   * Returns a `Promise`: the download and runtime initialization run on
+   * a native worker thread rather than the Node main thread.
    */
-  loadModel(): void
+  loadModel(): Promise<void>
   /**
    * Load an existing cloud index into the session by name.
    *
@@ -312,15 +344,40 @@ export declare class SessionIndex {
    * crash-safe generation format. A failure or interruption before
    * publication leaves the previously committed snapshot loadable; restore it
    * without a cloud round-trip via `loadFromDisk`.
+   *
+   * Returns a `Promise`: the write runs on a native worker thread rather
+   * than the Node main thread.
    */
-  saveToDisk(cachePath: string): void
+  saveToDisk(cachePath: string): Promise<void>
   /**
    * Restore the committed snapshot previously written by `saveToDisk` from
    * `<cachePath>/<name>/`. The snapshot is validated before the live session
    * changes; corruption rejects the call and leaves current state intact.
-   * Returns the number of documents loaded.
+   * Resolves to the number of documents loaded. A foundation-model snapshot
+   * saved without artifact provenance (by a core before identity stamping)
+   * loads as a custom-model session; pass `{ rebuildLegacy: true }` to
+   * re-embed it with the current model instead (see `inspectSnapshot`).
+   * When that rebuild cannot load the model (offline, delivery down) the
+   * call rejects with a message starting "Legacy snapshot rebuild needs
+   * the embedding model" and changes nothing: the snapshot is intact and
+   * the session is as it was, so retry later rather than discarding the
+   * snapshot.
+   *
+   * Returns a `Promise`: the read and validation run on a native worker
+   * thread rather than the Node main thread.
    */
-  loadFromDisk(cachePath: string): number
+  loadFromDisk(cachePath: string, options?: LoadFromDiskOptions | null): Promise<number>
+  /**
+   * Read what the snapshot under `<cachePath>/<name>/` records without
+   * changing the session: the model it was saved with, whether it carries
+   * model artifact provenance, and its size. It validates the candidates
+   * the way `loadFromDisk` does and describes the one a load would
+   * install, without any of the load's repairs. A foundation snapshot with
+   * `hasModelArtifact: false` was written before identity stamping and
+   * needs `loadFromDisk(cachePath, { rebuildLegacy: true })` to keep its
+   * text search.
+   */
+  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
@@ -330,8 +387,9 @@ export declare class SessionIndex {
    * other method fails with "SessionIndex is closed". The process-wide
    * shared runtime is unaffected.
    *
-   * Async so the core Drop runs inside the runtime context and takes
-   * its non-blocking telemetry path instead of blocking the JS thread.
+   * Returns a `Promise` so the core Drop runs inside the runtime context
+   * and takes its non-blocking telemetry path instead of blocking the JS
+   * thread.
    */
   close(): Promise<void>
 }
@@ -473,6 +531,20 @@ export interface JobStatusResponse {
   completedAt?: string
 }
 
+/** Options for `SessionIndex.loadFromDisk`. */
+export interface LoadFromDiskOptions {
+  /**
+   * When the snapshot records the foundation model this session was
+   * opened with but no artifact provenance, re-embed its documents with
+   * the current model artifact instead of loading it as a custom-model
+   * session, then save the upgraded snapshot back so the rebuild happens
+   * once. Needs the model, so the cloud must be reachable. A snapshot of a
+   * different foundation model, or of a custom model, loads as without the
+   * option. Default `false`.
+   */
+  rebuildLegacy?: boolean
+}
+
 /** Outcome of a best-effort bulk `loadIndexes` call. */
 export interface LoadIndexesResult {
   /** Names of indexes that were successfully loaded into memory. */
@@ -666,3 +738,23 @@ export interface SessionUpdateResult {
   added: number
   updated: number
 }
+
+/** What a saved session snapshot records. See `SessionIndex.inspectSnapshot`. */
+export interface SnapshotInfo {
+  /**
+   * Model id recorded when the snapshot was saved: `"custom"` or a
+   * foundation model id such as `"moss-minilm"`.
+   */
+  modelId: string
+  /**
+   * True when the snapshot carries the model artifact provenance this core
+   * requires before it trusts foundation-model vectors. A foundation
+   * snapshot without it (saved before identity stamping) loads as a
+   * custom-model session unless `loadFromDisk` rebuilds it.
+   */
+  hasModelArtifact: boolean
+  docCount: number
+  dimension: number
+  /** True for the pre-generation flat layout older cores wrote. */
+  legacyLayout: boolean
+}

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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      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.`)
       }
       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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.27.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.27.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         return binding
       } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moss-js/moss-core",
-  "version": "0.27.0",
+  "version": "0.29.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.27.0",
-    "@moss-js/moss-core-linux-x64-gnu": "0.27.0",
-    "@moss-js/moss-core-linux-arm64-gnu": "0.27.0",
-    "@moss-js/moss-core-darwin-arm64": "0.27.0",
-    "@moss-js/moss-core-darwin-x64": "0.27.0"
+    "@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"
   }
 }