@withmarfa/core 0.0.29 → 0.0.31

package/index.d.ts

@@ -28,6 +28,14 @@ export declare class Folders {
 
 /** A local copy of a slice of one server. */
 export declare class MarfaCore {
+  createView(settings: Record<string, unknown>, idempotencyKey?: string | undefined | null): Promise<ViewRow>
+  changeView(id: string, changes: Record<string, unknown>, version: number, idempotencyKey?: string | undefined | null): Promise<ViewRow>
+  deleteView(id: string, idempotencyKey?: string | undefined | null): Promise<void>
+  listViews(): Views
+  view(id: string): ViewRow | null
+  listInView(id: string, layout?: string | undefined | null, limit?: number | undefined | null, offset?: number | undefined | null): Listing
+  searchInView(query: string, id: string, limit?: number | undefined | null): Found
+  viewGroups(id: string, layout: string, timeZone?: string | undefined | null): ViewGroups
   /**
    * Opens a store another process writes, to read it only: never the
    * writer, never a write, and a path with no store is refused.
@@ -95,12 +103,16 @@ export declare class MarfaCore {
   static replaceRefused(path: string, url?: string | undefined | null, key?: string | undefined | null): MarfaCore
   /**
    * Replaces the local copy with the declared types at `tier`, one tier or
-   * `all` for both.
+   * `all` for both. `["*"]` alone is every type but `system.*`, hydrated in
+   * one pass with no need to read the catalog and name its types first;
+   * beside `system.*` types it adds them, and beside any other type it is
+   * refused `invalid`.
    */
   hydrate(types: Array<string>, tier: SliceTier, stop?: Stop | undefined | null): Promise<HydrateReport>
   /**
    * A hydration that also holds every edge of `edgeTypes` the key reads,
-   * whichever ends the copy holds.
+   * whichever ends the copy holds. `types` reads as in `hydrate`, so
+   * `["*"]` alone is every type but `system.*`.
    */
   hydrateWith(types: Array<string>, tier: SliceTier, edgeTypes: Array<string>, stop?: Stop | undefined | null): Promise<HydrateReport>
   /** Holds one row by id whatever the slice says of it, read now. */
@@ -113,6 +125,8 @@ export declare class MarfaCore {
   /** Applies every event since the stored cursor. */
   catchUp(stop?: Stop | undefined | null): Promise<CatchUpReport>
   list(filters?: ListFilters | undefined | null, sort?: Sort | undefined | null): Listing
+  listInFolder(id: string, sort?: Sort | undefined | null, limit?: number | undefined | null, offset?: number | undefined | null): Listing
+  searchInFolder(query: string, id: string, limit?: number | undefined | null): Found
   get(id: string): Item | null
   edgesFrom(id: string): Array<Edge>
   edgesTo(id: string): Array<Edge>
@@ -238,6 +252,17 @@ export declare class MarfaCore {
    * Refused to a reading handle.
    */
   trimFiles(): number
+  /**
+   * Fetches the bytes of every file attached to an item the copy holds
+   * that the cache does not hold whole, smallest first, and answers what
+   * it fetched and the attachments after it, resuming the part of one an
+   * earlier fetch left. Waits out a server that asks for a wait of a
+   * minute or less, and stops at the first the disk has no room for, once
+   * the server cannot be reached, or once it asks for a longer wait; one
+   * that fails otherwise is passed over. Run after a hydration and after
+   * a catch-up. Refused to a reading handle and for a folder's copy.
+   */
+  fetchKept(stop?: Stop | undefined | null): Promise<KeptFetch>
   /** Whether a blob's bytes are held beside the store, with no request. */
   blobHeld(hash: string): boolean
   /**
@@ -289,7 +314,7 @@ export declare class MarfaCore {
  * Raised to end a `hydrate`, `catchUp` or `drain` it was given to, soon
  * after, with an error coded `canceled`. What the call had taken is
  * consistent: a hydration left unfinished answers lists and searches marked
- * partial and refuses writes, a catch-up keeps the cursor it reached, and a drain leaves what it had not sent queued, and
+ * partial and refuses writes until a hydration completes (the next one of the same slice carries on from the page it reached where it can), a catch-up keeps the cursor it reached, and a drain leaves what it had not sent queued, and
  * an upload or item or edge write it had in flight queued as sent, for the
  * next drain to send again under the same key. A raised `Stop` stays raised, so a call given one
  * afterwards ends at once.
@@ -340,6 +365,21 @@ export interface Attachment {
   tier?: Tier
 }
 
+/** The files attached to items the copy holds. */
+export interface Attachments {
+  /** The file items whose bytes the cache holds whole. */
+  held: number
+  /** Their bytes, counted once for files that share them. */
+  heldBytes: number
+  /** The bytes of partial files of attachments. */
+  partialBytes: number
+  /** The attachments whose bytes the cache does not hold whole. */
+  notHeld: number
+  /** The bytes they state, counted once for files that share them. */
+  notHeldBytes: number
+  notHeldByReason: Array<NotHeld>
+}
+
 /** Why a `blocked` write has stopped. */
 export declare const enum BlockedReason {
   CredentialRefused = 'credential_refused',
@@ -593,6 +633,12 @@ export interface FileCache {
    * once a fetched file is marked.
    */
   backupMarkFailure?: string
+  /**
+   * The files attached to items the copy holds, which stay on the device
+   * outside the budget; absent from the start of a hydration until one
+   * completes, for a folder's copy, and where the cache could not be read.
+   */
+  attachments?: Attachments
 }
 
 export declare const enum FileState {
@@ -736,7 +782,26 @@ export interface HydrateReport {
   edgeTypes: Array<string>
   items: number
   edges: number
+  /**
+   * The listing pages this call read, those of a walk it then started
+   * again from the first page included.
+   */
   pages: number
+  /**
+   * The listing pages the hydration read in all, those of the interrupted
+   * calls it resumed included.
+   */
+  pagesTotal: number
+  /**
+   * Whether this call carried on from the page an interrupted hydration
+   * of the same slice had reached.
+   */
+  resumed: boolean
+  /**
+   * Why an interrupted hydration was filled again from the first page
+   * rather than resumed, such as `slice_changed` or `head_aged_out`.
+   */
+  restarted?: string
   cursor: string
   /** Types the app declared that the instance did not hold and now does. */
   registeredTypes: Array<string>
@@ -789,6 +854,18 @@ export interface ItemType {
   compatibleWith: Array<string>
 }
 
+/** What a fetch of the attachments did. */
+export interface KeptFetch {
+  /**
+   * The files whose bytes it fetched, counted once for files that share
+   * them.
+   */
+  fetched: number
+  fetchedBytes: number
+  /** The attachments after it, as the state report gives them. */
+  attachments?: Attachments
+}
+
 /**
  * What a write met that was no answer to it: the HTTP status, absent where
  * nothing answered, and the start of the answer's body when it is text.
@@ -843,6 +920,43 @@ export interface MissingGrant {
   level: GrantLevel
 }
 
+/** The attachments not held for one reason. */
+export interface NotHeld {
+  reason: NotHeldReason
+  attachments: number
+  /** The bytes they state, counted once for files that share them. */
+  bytes: number
+  /** How many of them state no size, so add nothing to `bytes`. */
+  unstated: number
+}
+
+/** Why an attachment's bytes are not held. */
+export declare const enum NotHeldReason {
+  /** No fetch of them has been asked for since they became an attachment. */
+  NotFetched = 'not_fetched',
+  /**
+   * The volume had no room for them, or for an attachment before them in
+   * the same fetch.
+   */
+  NoRoom = 'no_room',
+  /**
+   * The server, or the link it gave, could not be reached, or the link
+   * stopped sending part way.
+   */
+  Unreachable = 'unreachable',
+  /**
+   * The server asked for a wait longer than a fetch of attachments
+   * makes, before them or an attachment before them in the same fetch.
+   */
+  RateLimited = 'rate_limited',
+  /** The server holds no bytes by that hash. */
+  Absent = 'absent',
+  /** The fetch failed otherwise. */
+  Failed = 'failed',
+  /** The edge is held but its file item is not. */
+  NotInCopy = 'not_in_copy',
+}
+
 export interface PausedRemoval {
   disk: number
   pull: number
@@ -1080,6 +1194,29 @@ export type Verdict =
   | { verdict: 'blocked'; reason: BlockedReason; refusal?: Refusal }
   | { verdict: 'dead' }
 
+export interface ViewGroup {
+  key: string | number | boolean | null
+  count: number
+  sum?: number
+}
+
+export interface ViewGroups {
+  groups: Array<ViewGroup>
+  completeness: Completeness
+}
+
+export interface ViewRow {
+  id: string
+  version: number
+  state: ItemState
+  settings: Record<string, unknown>
+}
+
+export interface Views {
+  views: Array<ViewRow>
+  completeness: Completeness
+}
+
 export interface WaitingFirstSync {
   plan?: FirstSyncPlan
 }

package/index.js

@@ -89,8 +89,8 @@ function requireNative() {
       try {
         const binding = require('@withmarfa/core-android-arm64')
         const bindingPackageVersion = require('@withmarfa/core-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -105,8 +105,8 @@ function requireNative() {
       try {
         const binding = require('@withmarfa/core-android-arm-eabi')
         const bindingPackageVersion = require('@withmarfa/core-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -126,8 +126,8 @@ function requireNative() {
         try {
           const binding = require('@withmarfa/core-win32-x64-gnu')
           const bindingPackageVersion = require('@withmarfa/core-win32-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -142,8 +142,8 @@ function requireNative() {
         try {
           const binding = require('@withmarfa/core-win32-x64-msvc')
           const bindingPackageVersion = require('@withmarfa/core-win32-x64-msvc/package.json').version
-          if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -159,8 +159,8 @@ function requireNative() {
       try {
         const binding = require('@withmarfa/core-win32-ia32-msvc')
         const bindingPackageVersion = require('@withmarfa/core-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -175,8 +175,8 @@ function requireNative() {
       try {
         const binding = require('@withmarfa/core-win32-arm64-msvc')
         const bindingPackageVersion = require('@withmarfa/core-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -194,8 +194,8 @@ function requireNative() {
     try {
       const binding = require('@withmarfa/core-darwin-universal')
       const bindingPackageVersion = require('@withmarfa/core-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -210,8 +210,8 @@ function requireNative() {
       try {
         const binding = require('@withmarfa/core-darwin-x64')
         const bindingPackageVersion = require('@withmarfa/core-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -226,8 +226,8 @@ function requireNative() {
       try {
         const binding = require('@withmarfa/core-darwin-arm64')
         const bindingPackageVersion = require('@withmarfa/core-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -246,8 +246,8 @@ function requireNative() {
       try {
         const binding = require('@withmarfa/core-freebsd-x64')
         const bindingPackageVersion = require('@withmarfa/core-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -262,8 +262,8 @@ function requireNative() {
       try {
         const binding = require('@withmarfa/core-freebsd-arm64')
         const bindingPackageVersion = require('@withmarfa/core-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -283,8 +283,8 @@ function requireNative() {
         try {
           const binding = require('@withmarfa/core-linux-x64-musl')
           const bindingPackageVersion = require('@withmarfa/core-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -299,8 +299,8 @@ function requireNative() {
         try {
           const binding = require('@withmarfa/core-linux-x64-gnu')
           const bindingPackageVersion = require('@withmarfa/core-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -317,8 +317,8 @@ function requireNative() {
         try {
           const binding = require('@withmarfa/core-linux-arm64-musl')
           const bindingPackageVersion = require('@withmarfa/core-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -333,8 +333,8 @@ function requireNative() {
         try {
           const binding = require('@withmarfa/core-linux-arm64-gnu')
           const bindingPackageVersion = require('@withmarfa/core-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -351,8 +351,8 @@ function requireNative() {
         try {
           const binding = require('@withmarfa/core-linux-arm-musleabihf')
           const bindingPackageVersion = require('@withmarfa/core-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -367,8 +367,8 @@ function requireNative() {
         try {
           const binding = require('@withmarfa/core-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@withmarfa/core-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -385,8 +385,8 @@ function requireNative() {
         try {
           const binding = require('@withmarfa/core-linux-loong64-musl')
           const bindingPackageVersion = require('@withmarfa/core-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -401,8 +401,8 @@ function requireNative() {
         try {
           const binding = require('@withmarfa/core-linux-loong64-gnu')
           const bindingPackageVersion = require('@withmarfa/core-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -419,8 +419,8 @@ function requireNative() {
         try {
           const binding = require('@withmarfa/core-linux-riscv64-musl')
           const bindingPackageVersion = require('@withmarfa/core-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -435,8 +435,8 @@ function requireNative() {
         try {
           const binding = require('@withmarfa/core-linux-riscv64-gnu')
           const bindingPackageVersion = require('@withmarfa/core-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -452,8 +452,8 @@ function requireNative() {
       try {
         const binding = require('@withmarfa/core-linux-ppc64-gnu')
         const bindingPackageVersion = require('@withmarfa/core-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -468,8 +468,8 @@ function requireNative() {
       try {
         const binding = require('@withmarfa/core-linux-s390x-gnu')
         const bindingPackageVersion = require('@withmarfa/core-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -488,8 +488,8 @@ function requireNative() {
       try {
         const binding = require('@withmarfa/core-openharmony-arm64')
         const bindingPackageVersion = require('@withmarfa/core-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -504,8 +504,8 @@ function requireNative() {
       try {
         const binding = require('@withmarfa/core-openharmony-x64')
         const bindingPackageVersion = require('@withmarfa/core-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -520,8 +520,8 @@ function requireNative() {
       try {
         const binding = require('@withmarfa/core-openharmony-arm')
         const bindingPackageVersion = require('@withmarfa/core-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.0.29' && 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.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.31' && 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.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -661,8 +661,8 @@ if (!nativeBinding || forceWasi) {
       if (!candidateFailed) {
         if (process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
           const bindingPackageVersion = require('@withmarfa/core-wasm32-wasi/package.json').version
-          if (bindingPackageVersion !== '0.0.29') {
-            throw new Error(`WASI binding package version mismatch, expected 0.0.29 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.31') {
+            throw new Error(`WASI binding package version mismatch, expected 0.0.31 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
         }
         wasiBinding = require('@withmarfa/core-wasm32-wasi')
@@ -793,6 +793,7 @@ module.exports.GrantLevel = nativeBinding.GrantLevel
 module.exports.Handle = nativeBinding.Handle
 module.exports.Hydration = nativeBinding.Hydration
 module.exports.ItemState = nativeBinding.ItemState
+module.exports.NotHeldReason = nativeBinding.NotHeldReason
 module.exports.SliceTier = nativeBinding.SliceTier
 module.exports.SortDirection = nativeBinding.SortDirection
 module.exports.SortField = nativeBinding.SortField

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withmarfa/core",
-  "version": "0.0.29",
+  "version": "0.0.31",
   "description": "marfa-core as a Node module.",
   "license": "Apache-2.0",
   "repository": {