@moss-js/moss-core 0.24.0

package/README.md

@@ -0,0 +1,19 @@
+# Moss JavaScript Binding
+
+Rust-powered Node.js native addon that exposes the Moss core indexing and model APIs via N-API.
+
+## Getting Started
+
+```bash
+npm install @moss-js/moss-core
+```
+
+The package bundles prebuilt binaries for common targets; npm will download the correct artifact for your platform during install.
+
+## Prerequisites For Local Builds
+
+- Node.js 20+ (matches the engines field in `package.json`)
+- Rust toolchain with `cargo`
+- `npm` 8+ 
+  
+Refer to the `test/` directory for additional usage examples.

package/index.d.ts

@@ -0,0 +1,658 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+/**
+ * Low-level interface for working with a Moss search index from Node.js.
+ *
+ * Instances of this type keep an in-memory index that you can populate with
+ * precomputed embeddings, execute hybrid semantic queries, and serialize to
+ * the `.moss` file format. Most JavaScript developers should prefer the
+ * higher-level `MossClient`, but this type is available when you need direct
+ * control over embeddings and lifecycle.
+ */
+export declare class Index {
+  /**
+   * Create a new in-memory index instance.
+   *
+   * @param name Index name used for diagnostics and serialization.
+   * @param modelId Embedding model identifier (`"moss-minilm"`, `"moss-mediumlm"`, or `"custom"`).
+   *
+   * @example
+   * ```typescript
+   * const index = new Index('knowledge-base', 'moss-minilm')
+   * ```
+   */
+  constructor(name: string, modelId: string)
+  /**
+   * Get metadata describing the current index state.
+   *
+   * @returns Index information including status, document counts, and model details.
+   */
+  getInfo(): IndexInfo
+  /**
+   * Add new documents or update existing ones using precomputed embeddings.
+   *
+   * Embeddings **must** be generated separately and supplied alongside the
+   * documents in the same order.
+   *
+   * @param docs Documents to insert or update.
+   * @param embeddings One embedding vector per document.
+   * @param options Optional write behaviour (upsert by default).
+   * @returns Object containing the number of added and updated documents.
+   *
+   * @example
+   * ```typescript
+   * await index.addDocuments(docs, embeddings, { upsert: true })
+   * ```
+   */
+  addDocuments(docs: Array<DocumentInfo>, embeddings: Array<Array<number>>, options?: AddDocumentsOptions | null): IndexUpdateResult
+  /**
+   * Delete one or more documents by their identifier.
+   *
+   * @param docIds Document identifiers to remove.
+   * @returns Number of documents deleted.
+   */
+  deleteDocuments(docIds: Array<string>): number
+  /**
+   * Retrieve documents from the index.
+   *
+   * When `options.docIds` is omitted all documents are returned. Provide a
+   * list of IDs to fetch specific entries.
+   */
+  getDocuments(options?: GetDocumentsOptions | null): Array<DocumentInfo>
+  /**
+   * Perform a semantic similarity search using a precomputed query embedding.
+   *
+   * @param query Original search text used for logging and metadata.
+   * @param topK Maximum number of results to return (defaults to 5).
+   * @param queryEmbedding Precomputed embedding vector representing the query.
+   * @param alpha Optional hybrid fusion weight between dense and sparse scores (default `0.8`).
+   * @returns Search result containing ranked documents with scores.
+   */
+  query(query: string, topK: number, queryEmbedding: Array<number>, alpha?: number | null, filter?: object | null): SearchResult
+  /**
+   * Serialize the in-memory index into a plain JavaScript object.
+   *
+   * Useful for persisting the index or converting to the `.moss` binary format.
+   */
+  serialize(): SerializedIndex
+  /**
+   * Load serialized metadata and embeddings into the index instance.
+   *
+   * @param data Serialized index object produced by `serialize` or deserialized from `.moss` files.
+   * @param documents Full document objects matching the doc_ids in the serialized data.
+   */
+  deserialize(data: SerializedIndex, documents: Array<DocumentInfo>): void
+  /** Number of documents currently stored in the index. */
+  get docCount(): number
+  /** Remove all documents and embeddings from the index. */
+  clear(): void
+}
+
+/** Rust-backed local index manager with optional auto-refresh polling. */
+export declare class IndexManager {
+  constructor(projectId: string, projectKey: string, baseUrl?: string | null)
+  /**
+   * Creates an IndexManager that delegates authentication to a JS `IAuthenticator`.
+   *
+   * `notifyFn` is a JS function `(requestId: number) => void`. When Rust needs a token,
+   * it calls this function with a unique `requestId`. The JS side must call
+   * `resolveAuthRequest(requestId, token)` or `rejectAuthRequest(requestId, error)`.
+   *
+   * `baseUrl` overrides the default cloud API endpoint — useful for testing against a local server.
+   */
+  static withAuthenticator(projectId: string, notifyFn: (err: Error | null, requestId: number) => void, baseUrl?: string | null): IndexManager
+  /**
+   * Set the stable per-device identifier emitted as `deviceId` on every
+   * telemetry event. No-op when telemetry is disabled for this manager,
+   * or when the manager has been closed.
+   */
+  setDeviceId(deviceId?: string | undefined | null): void
+  /** Set billable and Moss-owned telemetry identity together. */
+  setIdentity(deviceId?: string | undefined | null, userId?: string | undefined | null, mossDeviceId?: string | undefined | null): void
+  loadIndex(indexName: string, options?: LoadIndexOptions | null): Promise<IndexInfo>
+  unloadIndex(indexName: string): Promise<void>
+  /**
+   * Best-effort bulk load. Per-name failures are reported in `failed` and do
+   * not roll back indexes that loaded; `options` apply to the whole batch.
+   */
+  loadIndexes(indexNames: Array<string>, options?: LoadIndexOptions | null): Promise<LoadIndexesResult>
+  /** 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>
+  /**
+   * 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.
+   */
+  queryMultiIndex(indexNames: Array<string>, query: string, queryEmbedding: Array<number>, topK?: number, alpha?: number, filter?: object): 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>
+  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
+   * hold the manager finish normally; the memory is freed when the
+   * last one completes. Idempotent. The process-wide shared runtime
+   * is unaffected.
+   */
+  close(): Promise<void>
+}
+export type JsIndexManager = IndexManager
+
+/** Rust-backed cloud orchestration client for index mutations and metadata operations. */
+export declare class ManageClient {
+  constructor(projectId: string, projectKey: string, baseUrl?: string | null)
+  /**
+   * Creates a ManageClient that delegates authentication to a JS `IAuthenticator`.
+   *
+   * `notifyFn` is a JS function `(requestId: number) => void`. When Rust needs a token,
+   * it calls this function with a unique `requestId`. The JS side must then call
+   * `authenticator.getAuthHeader()` and pass the result to `resolveAuthRequest(requestId, token)`
+   * or `rejectAuthRequest(requestId, error)`.
+   *
+   * `baseUrl` overrides the default cloud API endpoint — useful for testing against a local server.
+   */
+  static withAuthenticator(projectId: string, notifyFn: (err: Error | null, requestId: number) => void, baseUrl?: string | null): ManageClient
+  createIndex(name: string, docs: Array<DocumentInfo>, modelId: string, onProgress?: (progress: JobProgress) => void): Promise<MutationResult>
+  createIndexFromFiles(name: string, files: Array<ParseFileInput>, modelId: string, onProgress?: (progress: JobProgress) => void, parseOptions?: ParseOptions | null): Promise<MutationResult>
+  addDocs(name: string, docs: Array<DocumentInfo>, options?: MutationOptions | null, onProgress?: (progress: JobProgress) => void): Promise<MutationResult>
+  deleteDocs(name: string, docIds: Array<string>, onProgress?: (progress: JobProgress) => void): Promise<MutationResult>
+  getJobStatus(jobId: string): Promise<JobStatusResponse>
+  getIndex(name: string): Promise<IndexInfo>
+  listIndexes(): Promise<Array<IndexInfo>>
+  deleteIndex(name: string): Promise<boolean>
+  getDocs(name: string, options?: GetDocumentsOptions | null): Promise<Array<DocumentInfo>>
+}
+export type JsManageClient = ManageClient
+
+/**
+ * Local-first session index backed by `moss::session::SessionIndex`.
+ *
+ * Holds documents + embeddings in process memory, supports
+ * add/delete/get/query without a network round-trip, and can push the
+ * resulting index to the cloud or persist to disk for offline reuse.
+ *
+ * Mirrors the Python `SessionIndex` surface 1:1 — see the
+ * `moss` (Python) SDK docs for the full semantic model.
+ */
+export declare class SessionIndex {
+  static modelArtifactContractVersion(): number
+  /**
+   * Create a session for `name`. The session is empty until
+   * `addDocuments` / `addDocumentsText` populates it, or `loadIndex`
+   * pulls an existing cloud index into it.
+   *
+   * `moss::session::SessionIndex::new` validates credentials against
+   * the cloud synchronously and explicitly refuses to run inside any
+   * tokio runtime context. Exposing this as `#[napi(factory)] async`
+   * (rather than `#[napi(constructor)]`) plus dispatching the work
+   * to a fresh OS thread keeps the Node main thread responsive: the
+   * caller sees a `Promise`, and the blocking cloud call runs in
+   * truly-isolated thread space.
+   * `artifactVersion` and `manifestSha256` must be supplied together or both omitted.
+   */
+  static create(name: string, modelId: string, projectId: string, projectKey: string, clientId?: string | null, artifactVersion?: string | null, manifestSha256?: string | null): Promise<SessionIndex>
+  /**
+   * Create a session that delegates authentication to a JS `IAuthenticator`,
+   * mirroring `IndexManager.withAuthenticator`. Credential validation on
+   * open, `pushIndex`, `loadIndex`, and usage telemetry all authenticate
+   * via `notifyFn` rather than a static project key — so a custom-auth
+   * client (short-lived JWTs, no project key on device) can use sessions.
+   *
+   * `notifyFn` is a JS function `(err, requestId) => void`. When Rust needs
+   * a token it calls `notifyFn` with a unique `requestId`; the JS side must
+   * call `resolveAuthRequest(requestId, token)` or
+   * `rejectAuthRequest(requestId, error)`. `baseUrl` overrides the default
+   * cloud endpoint.
+   * `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. */
+  get docCount(): number
+  /**
+   * Session index name. Identifies the cloud index when `pushIndex` /
+   * `loadIndex` is called.
+   */
+  get name(): string
+  /**
+   * Embedding model id this session is configured for
+   * (`"moss-minilm"`, `"moss-mediumlm"`, `"moss-litelm"`, or `"custom"`).
+   */
+  get modelId(): string
+  /**
+   * Set the stable per-device identifier emitted as `deviceId` on every
+   * telemetry event. No-op when telemetry is disabled for this session,
+   * or when the session has been closed.
+   */
+  setDeviceId(deviceId?: string | undefined | null): void
+  /** Set billable and Moss-owned telemetry identity together. */
+  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.
+   */
+  addDocuments(docs: Array<DocumentInfo>, embeddings: Array<Array<number>>, options?: AddDocumentsOptions | null): SessionUpdateResult
+  /**
+   * Add or upsert documents using the session's bundled embedding model
+   * to compute embeddings locally. The model is loaded on demand on the
+   * first call (or the first `queryText`); call `loadModel()` upfront
+   * 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.
+   */
+  addDocumentsText(docs: Array<DocumentInfo>, options?: AddDocumentsOptions | null): SessionUpdateResult
+  /**
+   * Remove documents by id. Returns the number of documents removed
+   * (may be less than `docIds.length` if some ids weren't present).
+   */
+  deleteDocuments(docIds: Array<string>): number
+  /**
+   * Fetch documents currently in the session. With `options.docIds`
+   * returns matching documents; without, returns all.
+   */
+  getDocuments(options?: GetDocumentsOptions | null): 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.
+   */
+  query(query: string, topK: number, queryEmbedding: Array<number>, alpha?: number | null, filter?: object | null): 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"`.
+   */
+  queryText(query: string, topK: number, alpha?: number | null, filter?: object | null): 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"`.
+   */
+  loadModel(): void
+  /**
+   * Load an existing cloud index into the session by name.
+   *
+   * With `options.autoRefresh = true`, a background poller pulls
+   * newer cloud versions in on the next read at the configured
+   * interval (default 600 s). The poller pauses while the session
+   * has un-pushed local edits, so local additions are never
+   * clobbered.
+   *
+   * Returns the number of documents loaded into the session.
+   */
+  loadIndex(indexName: string, options?: LoadSessionOptions | null): Promise<number>
+  /**
+   * Upload the session contents to the cloud, creating or replacing
+   * the index with the same name. Documents are pushed with their
+   * locally-computed embeddings — no server-side re-embedding.
+   */
+  pushIndex(): Promise<PushIndexResult>
+  /**
+   * Persist the session beneath `<cachePath>/<name>/` using the core's
+   * 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`.
+   */
+  saveToDisk(cachePath: string): 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.
+   */
+  loadFromDisk(cachePath: string): number
+  /**
+   * 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.
+   * 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.
+   *
+   * Async 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>
+}
+export type JsSessionIndex = SessionIndex
+
+/** Options controlling how documents are written into the index. */
+export interface AddDocumentsOptions {
+  /** When true, existing documents with the same ID will be updated (default true). */
+  upsert: boolean
+}
+
+/** Auth token endpoint — POST projectId + projectKey, receive JWT. */
+export const CLOUD_API_AUTH_URL: string
+
+/** Base URL for the Moss identity service. */
+export const CLOUD_API_IDENTITY_URL: string
+
+/** Base URL for the Moss index management service. */
+export const CLOUD_API_INDEX_URL: string
+
+/** Query endpoint for the Moss query service. */
+export const CLOUD_QUERY_URL: string
+
+/**
+ * Deserialize Moss binary data into a JsSerializedIndex object.
+ *
+ * @param blob - A Uint8Array view containing the binary data.
+ * @returns The deserialized SerializedIndex object.
+ */
+export declare function deserializeFromBinary(blob: Uint8Array): SerializedIndex
+
+/** Document payload that can be indexed and later retrieved. */
+export interface DocumentInfo {
+  /** Unique identifier within the index. */
+  id: string
+  /** Canonical text content used for embedding generation. */
+  text: string
+  /** Optional metadata map persisted alongside the document. */
+  metadata?: Record<string, string>
+  /** Optional precomputed embedding vector (f64 for JS compatibility). */
+  embedding?: Array<number>
+  /**
+   * Optional opaque structured payload (e.g. a JSON string), stored
+   * verbatim and returned as-is — never embedded or searched.
+   */
+  payload?: string
+}
+
+/** Optional filters when retrieving documents from an index. */
+export interface GetDocumentsOptions {
+  /** List of document IDs to fetch; omitted returns all documents. */
+  docIds?: Array<string>
+}
+
+/** Information about a persisted index including status and model metadata. */
+export interface IndexInfo {
+  /** Unique identifier of the index. */
+  id: string
+  /** Human-readable index name. */
+  name: string
+  /** Index build or schema version string. */
+  version?: string
+  /** Current lifecycle status of the index build. */
+  status: IndexStatus
+  /** Number of documents stored in the index. */
+  docCount: number
+  /** RFC 3339 timestamp indicating when the index was created. */
+  createdAt?: string
+  /** RFC 3339 timestamp indicating the last update time. */
+  updatedAt?: string
+  /** Embedding model details bound to the index. */
+  model: ModelRef
+}
+
+/** Lifecycle status for background index creation processes. */
+export declare const enum IndexStatus {
+  NotStarted = 'NotStarted',
+  Building = 'Building',
+  Ready = 'Ready',
+  Failed = 'Failed'
+}
+
+/**
+ * A simple struct to return the added/updated counts to JS,
+ * since JS doesn't support tuples.
+ */
+export interface IndexUpdateResult {
+  added: number
+  updated: number
+}
+
+/** Job phase for async cloud operations. */
+export declare const enum JobPhase {
+  Downloading = 'downloading',
+  Deserializing = 'deserializing',
+  GeneratingEmbeddings = 'generating_embeddings',
+  BuildingIndex = 'building_index',
+  Uploading = 'uploading',
+  Cleanup = 'cleanup',
+  WaitingForParser = 'waiting_for_parser',
+  Parsing = 'parsing',
+  ParsingComplete = 'parsing_complete',
+  Queued = 'queued',
+  Crawling = 'crawling',
+  ParsingDocuments = 'parsing_documents'
+}
+
+/** Progress update for async cloud operations. */
+export interface JobProgress {
+  jobId: string
+  status: JobStatus
+  progress: number
+  currentPhase?: JobPhase
+}
+
+/** Job status for async cloud operations. */
+export declare const enum JobStatus {
+  PendingUpload = 'pending_upload',
+  Uploading = 'uploading',
+  Building = 'building',
+  Completed = 'completed',
+  Failed = 'failed'
+}
+
+/** Status payload for a long-running async job. */
+export interface JobStatusResponse {
+  jobId: string
+  status: JobStatus
+  progress: number
+  currentPhase?: JobPhase
+  error?: string
+  createdAt: string
+  updatedAt: string
+  completedAt?: string
+}
+
+/** Outcome of a best-effort bulk `loadIndexes` call. */
+export interface LoadIndexesResult {
+  /** Names of indexes that were successfully loaded into memory. */
+  loaded: Array<string>
+  /** Names that failed to load, mapping name to error message. */
+  failed: Record<string, string>
+}
+
+/** Options for loading an index with auto-refresh configuration. */
+export interface LoadIndexOptions {
+  /** Enable auto-refresh polling for this index. */
+  autoRefresh?: boolean
+  /** Polling interval in seconds (default: 600 / 10 minutes). */
+  pollingIntervalInSeconds?: number
+  /** Optional filesystem path for caching index data to disk. */
+  cachePath?: string
+}
+
+export interface LoadSessionOptions {
+  /**
+   * If `true`, the SDK starts a background poller that pulls newer cloud
+   * versions of this index into the session at the configured interval.
+   * Paused automatically while the session has un-pushed local edits.
+   */
+  autoRefresh?: boolean
+  /**
+   * Poll interval in seconds (default 600 = 10 minutes). Only consulted
+   * when `autoRefresh` is `true`.
+   */
+  pollingIntervalInSeconds?: number
+}
+
+/** Public CDN endpoint for downloading Moss embedding models locally. */
+export const MODEL_DOWNLOAD_URL: string
+
+/** Reference to the embedding model powering a Moss index. */
+export interface ModelRef {
+  /** Model identifier string. */
+  id: string
+  /** Semantic version or build identifier of the model. */
+  version?: string
+}
+
+/** Options for async mutation operations. */
+export interface MutationOptions {
+  upsert?: boolean
+}
+
+/** Completed result from an async mutation operation. */
+export interface MutationResult {
+  jobId: string
+  indexName: string
+  docCount: number
+}
+
+/** Input descriptor for a single file in the parse pipeline. */
+export interface ParseFileInput {
+  /** File identifier sent to the server. Required. */
+  name: string
+  /** MIME type (e.g. "application/pdf"). Required. */
+  contentType: string
+  /** Filesystem path to the file. Required when `data` is not provided. */
+  path?: string
+  /** Raw file bytes. Takes precedence over `path` when provided. */
+  data?: Array<number>
+}
+
+/**
+ * Options controlling how the server parses uploaded documents.
+ *
+ * Every field is optional; omitted fields use the parsing service defaults.
+ * Use `ocrMode: "full_ocr"` for scanned documents with no text layer.
+ */
+export interface ParseOptions {
+  /** Slower, higher fidelity extraction. Useful for dense tables. */
+  useHighResolution?: boolean
+  /** "smart_layout_detection" or "page_by_page". */
+  segmentationMethod?: string
+  /** "auto_ocr" or "full_ocr". */
+  ocrMode?: string
+  /** Merge tables spanning a page break into one segment. */
+  mergeTables?: boolean
+}
+
+export interface PushIndexResult {
+  jobId: string
+  indexName: string
+  docCount: number
+  status: string
+}
+
+/** Options for query operations. */
+export interface QueryOptions {
+  /** Caller-provided embedding vector. When supplied, skips embedding generation. */
+  embedding?: Array<number>
+  /** Number of top results to return. */
+  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
+}
+
+/** Document returned from a query with similarity metadata. */
+export interface QueryResultDocumentInfo {
+  /** Document identifier. */
+  id: string
+  /** Original document text. */
+  text: string
+  /** Optional metadata associated with the document. */
+  metadata?: Record<string, string>
+  /** Similarity score between 0 and 1 (higher is more relevant). */
+  score: number
+  /** Optional opaque payload stored with the document, returned as-is. */
+  payload?: string
+  /** Source index name. Set on `queryMultiIndex` results; absent for single-index queries. */
+  indexName?: string
+}
+
+/** Result of an index refresh operation. */
+export interface RefreshResult {
+  /** Name of the index that was refreshed. */
+  indexName: string
+  /** Timestamp before the refresh operation. */
+  previousUpdatedAt: string
+  /** Timestamp after the refresh operation. */
+  newUpdatedAt: string
+  /** Whether the index was actually updated (true if cloud had newer version). */
+  wasUpdated: boolean
+}
+
+/** Called by JS to reject a pending auth request. */
+export declare function rejectAuthRequest(requestId: number, error: string): void
+
+/**
+ * Called by JS to resolve a pending auth request.
+ * `token` should be the raw token string — `JsAuthBridge` adds the "Bearer " prefix.
+ */
+export declare function resolveAuthRequest(requestId: number, token: string): void
+
+/** Version of the published `@moss-js/moss-core` package, matching its `package.json`. */
+export const SDK_VERSION_NUMBER: string
+
+/** Result payload returned by a semantic query operation. */
+export interface SearchResult {
+  /** Matching documents ordered by similarity. */
+  docs: Array<QueryResultDocumentInfo>
+  /** Original query string for reference. */
+  query: string
+  /** Optional index name when available. */
+  indexName?: string
+  /** Optional execution time in milliseconds. */
+  timeTakenInMs?: number
+}
+
+/** Complete serialized representation of an index for `.moss` file storage. */
+export interface SerializedIndex {
+  /** Name of the index. */
+  name: string
+  /** Index build or format version. */
+  version: string
+  /** Associated embedding model metadata. */
+  model: ModelRef
+  /** Dimensionality of each embedding vector. */
+  dimension: number
+  /** Embedding vectors stored row-wise. */
+  embeddings: Array<Array<number>>
+  /** Document identifiers parallel to the embeddings array. */
+  docIds: Array<string>
+  envelope?: SerializedIndexEnvelope
+}
+
+export interface SerializedIndexEnvelope {
+  /** Serialized envelope schema version. */
+  version: number
+  /** Exact immutable model artifact version, paired with `manifestSha256`. */
+  modelArtifactVersion?: string
+  /** Lowercase SHA-256 of the authoritative artifact manifest. */
+  manifestSha256?: string
+}
+
+/**
+ * Serialize a JsSerializedIndex object into a binary Buffer (.moss file format).
+ *
+ * @param index - The index object to serialize.
+ * @returns A Node.js Buffer containing the binary data.
+ */
+export declare function serializeToBinary(index: SerializedIndex): Buffer
+
+export interface SessionUpdateResult {
+  added: number
+  updated: number
+}

package/index.js

@@ -0,0 +1,601 @@
+// prettier-ignore
+/* eslint-disable */
+// @ts-nocheck
+/* auto-generated by NAPI-RS */
+
+const { readFileSync } = require('node:fs')
+let nativeBinding = null
+const loadErrors = []
+
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  let report = null
+  if (typeof process.report?.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
+      return true
+    }
+  }
+  return false
+}
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err)
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./js-binding.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./js-binding.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
+        try {
+        return require('./js-binding.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./js-binding.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      }
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./js-binding.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./js-binding.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+      return require('./js-binding.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    if (process.arch === 'x64') {
+      try {
+        return require('./js-binding.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./js-binding.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./js-binding.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./js-binding.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+          return require('./js-binding.linux-x64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./js-binding.linux-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
+        try {
+          return require('./js-binding.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./js-binding.linux-arm64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./js-binding.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./js-binding.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./js-binding.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./js-binding.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./js-binding.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./js-binding.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./js-binding.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./js-binding.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
+    }
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./js-binding.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'x64') {
+      try {
+        return require('./js-binding.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./js-binding.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      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.24.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.24.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  let wasiBinding = null
+  let wasiBindingError = null
+  try {
+    wasiBinding = require('./js-binding.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (process.env.NAPI_RS_FORCE_WASI) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+    try {
+      wasiBinding = require('@moss-js/moss-core-wasm32-wasi')
+      nativeBinding = wasiBinding
+    } catch (err) {
+      if (process.env.NAPI_RS_FORCE_WASI) {
+        if (!wasiBindingError) {
+          wasiBindingError = err
+        } else {
+          wasiBindingError.cause = err
+        }
+        loadErrors.push(err)
+      }
+    }
+  }
+  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
+    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
+    error.cause = wasiBindingError
+    throw error
+  }
+}
+
+if (!nativeBinding) {
+  if (loadErrors.length > 0) {
+    throw new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
+      {
+        cause: loadErrors.reduce((err, cur) => {
+          cur.cause = err
+          return cur
+        }),
+      },
+    )
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+module.exports = nativeBinding
+module.exports.Index = nativeBinding.Index
+module.exports.IndexManager = nativeBinding.IndexManager
+module.exports.JsIndexManager = nativeBinding.JsIndexManager
+module.exports.ManageClient = nativeBinding.ManageClient
+module.exports.JsManageClient = nativeBinding.JsManageClient
+module.exports.SessionIndex = nativeBinding.SessionIndex
+module.exports.JsSessionIndex = nativeBinding.JsSessionIndex
+module.exports.CLOUD_API_AUTH_URL = nativeBinding.CLOUD_API_AUTH_URL
+module.exports.CLOUD_API_IDENTITY_URL = nativeBinding.CLOUD_API_IDENTITY_URL
+module.exports.CLOUD_API_INDEX_URL = nativeBinding.CLOUD_API_INDEX_URL
+module.exports.CLOUD_QUERY_URL = nativeBinding.CLOUD_QUERY_URL
+module.exports.deserializeFromBinary = nativeBinding.deserializeFromBinary
+module.exports.IndexStatus = nativeBinding.IndexStatus
+module.exports.JsIndexStatus = nativeBinding.JsIndexStatus
+module.exports.JobPhase = nativeBinding.JobPhase
+module.exports.JsJobPhase = nativeBinding.JsJobPhase
+module.exports.JobStatus = nativeBinding.JobStatus
+module.exports.JsJobStatus = nativeBinding.JsJobStatus
+module.exports.MODEL_DOWNLOAD_URL = nativeBinding.MODEL_DOWNLOAD_URL
+module.exports.rejectAuthRequest = nativeBinding.rejectAuthRequest
+module.exports.resolveAuthRequest = nativeBinding.resolveAuthRequest
+module.exports.SDK_VERSION_NUMBER = nativeBinding.SDK_VERSION_NUMBER
+module.exports.serializeToBinary = nativeBinding.serializeToBinary

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@moss-js/moss-core",
+  "version": "0.24.0",
+  "description": "Connects JS SDK to Rust Moss-Core using N-API",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "repository": {
+    "type": "git"
+  },
+  "license": "Proprietary",
+  "keywords": [
+    "napi-rs",
+    "NAPI",
+    "N-API",
+    "Rust",
+    "node-addon",
+    "node-addon-api"
+  ],
+  "files": [
+    "index.d.ts",
+    "index.js",
+    "*.node",
+    "*.dylib",
+    "LICENSE-onnxruntime"
+  ],
+  "napi": {
+    "binaryName": "js-binding",
+    "targets": [
+      "x86_64-pc-windows-msvc",
+      "x86_64-unknown-linux-gnu",
+      "aarch64-unknown-linux-gnu",
+      "aarch64-apple-darwin",
+      "x86_64-apple-darwin"
+    ]
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "build": "napi build --platform --release",
+    "build:release-surface": "napi build --platform --release --target-dir target/release-surface-build --output-dir target/release-surface",
+    "build:debug": "napi build --platform",
+    "format:rs": "cargo fmt",
+    "test:abi": "node test/parse-options-abi.mjs",
+    "version": "napi version"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^3.2.0",
+    "@oxc-node/core": "^0.0.35",
+    "typescript": "^5.9.2"
+  },
+  "optionalDependencies": {
+    "@moss-js/moss-core-win32-x64-msvc": "0.24.0",
+    "@moss-js/moss-core-linux-x64-gnu": "0.24.0",
+    "@moss-js/moss-core-linux-arm64-gnu": "0.24.0",
+    "@moss-js/moss-core-darwin-arm64": "0.24.0",
+    "@moss-js/moss-core-darwin-x64": "0.24.0"
+  }
+}