@withmarfa/core 0.0.28 → 0.0.29

package/index.d.ts

@@ -112,7 +112,7 @@ export declare class MarfaCore {
   unpin(id: string): PinReport
   /** Applies every event since the stored cursor. */
   catchUp(stop?: Stop | undefined | null): Promise<CatchUpReport>
-  list(filters?: ListFilters | undefined | null, sort?: Sort | undefined | null): Array<Item>
+  list(filters?: ListFilters | undefined | null, sort?: Sort | undefined | null): Listing
   get(id: string): Item | null
   edgesFrom(id: string): Array<Edge>
   edgesTo(id: string): Array<Edge>
@@ -127,7 +127,7 @@ export declare class MarfaCore {
    * oldest link first.
    */
   conflictedCopiesOf(id: string): Array<Item>
-  search(query: string, filters?: SearchFilters | undefined | null, limit?: number | undefined | null): Array<SearchHit>
+  search(query: string, filters?: SearchFilters | undefined | null, limit?: number | undefined | null): Found
   status(): Status
   /**
    * Declares the types this app saves, each an object with its `id`, its
@@ -217,9 +217,27 @@ export declare class MarfaCore {
   /**
    * Where a blob's bytes are held, fetching them first where this store
    * does not hold them yet. Refused `bytes_absent` where they can be
-   * neither read nor fetched.
+   * neither read nor fetched. No trim in this process takes the bytes
+   * before the promise resolves; after that a trim may, so open the path
+   * at once.
    */
   blob(hash: string): Promise<string>
+  /**
+   * The cache of fetched files: its setting, the budget in force and the
+   * bytes held.
+   */
+  fileCache(): FileCache
+  /**
+   * Chooses the cache's budget, trims to it at once and answers the bytes
+   * the trim took. Refused `invalid` for a budget that is not one, keeping
+   * the setting, and refused to a reading handle.
+   */
+  setFileBudget(budget: FileBudget): number
+  /**
+   * Trims the cache to its budget now and answers the bytes it took.
+   * Refused to a reading handle.
+   */
+  trimFiles(): number
   /** Whether a blob's bytes are held beside the store, with no request. */
   blobHeld(hash: string): boolean
   /**
@@ -270,8 +288,8 @@ 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 refuses reads, a catch-up keeps
- * the cursor it reached, and a drain leaves what it had not sent queued, and
+ * 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
  * 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.
@@ -361,6 +379,15 @@ export type Change =
   | { kind: 'saved'; dataVersion: number; cursor: string }
   | { kind: 'watchFailed'; code: string; reason: string; cursor: string }
 
+/**
+ * Whether a local list or search was read from a whole copy, or from one a
+ * hydration is still filling, which holds only the rows that have arrived.
+ */
+export declare const enum Completeness {
+  Complete = 'complete',
+  Partial = 'partial',
+}
+
 export interface ConfirmedRemoval {
   deleted: number
   moved: number
@@ -524,6 +551,50 @@ export interface FieldRefusal {
   message: string
 }
 
+export interface FileBudget {
+  kind: FileBudgetKind
+  /**
+   * The byte count, for `bytes` alone: a whole number from zero to
+   * `Number.MAX_SAFE_INTEGER`.
+   */
+  bytes?: number
+}
+
+/** How the cache of fetched files chooses its budget. */
+export declare const enum FileBudgetKind {
+  /**
+   * The larger of 2 GiB and a tenth of the volume, held to what leaves a
+   * twentieth of the volume free and never below 256 MiB.
+   */
+  Default = 'default',
+  /** `bytes` bytes. */
+  Bytes = 'bytes',
+  /** No budget: every file fetched stays. */
+  KeepAll = 'keep_all',
+}
+
+/** The cache of fetched files as the state report gives it. */
+export interface FileCache {
+  /** What was chosen. */
+  setting: FileBudget
+  /** The budget in force, in bytes; null while every file fetched is kept. */
+  budget?: number
+  /**
+   * The bytes of the files kept now; null where the cache could not be
+   * read.
+   */
+  held?: number
+  /** Why `held` is unknown; absent when it is known. */
+  heldUnreadable?: string
+  /** The default budget is 2 GiB because the disk could not be read. */
+  volumeUnreadable: boolean
+  /**
+   * Why the files fetched last could not be kept out of backups; absent
+   * once a fetched file is marked.
+   */
+  backupMarkFailure?: string
+}
+
 export declare const enum FileState {
   InStep = 'in_step',
   Waiting = 'waiting',
@@ -632,6 +703,15 @@ export type FolderSyncOutcome =
   | { kind: 'done'; sync: FolderSync }
   | { kind: 'waiting'; plan: FirstSyncPlan }
 
+/**
+ * The hits a local search answers, best match first, and whether the copy
+ * was whole.
+ */
+export interface Found {
+  hits: Array<SearchHit>
+  completeness: Completeness
+}
+
 /** What a missing grant is on. */
 export declare const enum GrantKind {
   Type = 'type',
@@ -750,6 +830,12 @@ export interface ListFilters {
   offset?: number
 }
 
+/** The items a local list answers, and whether the copy was whole. */
+export interface Listing {
+  items: Array<Item>
+  completeness: Completeness
+}
+
 export interface MissingGrant {
   kind: GrantKind
   /** The type or edge type id, or the extension namespace. */
@@ -917,12 +1003,23 @@ export interface Status {
   eventCursor?: string
   hydration: Hydration
   items: number
+  /**
+   * While a hydration fills the copy, how many items its slice held on the
+   * server when it started; absent where the server did not count them.
+   */
+  itemsExpected?: number
+  /**
+   * While a hydration fills the copy, how many rows its listings have
+   * brought, the figure to set against `items_expected`.
+   */
+  itemsListed?: number
   edges: number
   /**
    * Moves each time a refresh changes the catalog; absent where the copy
    * has never held one.
    */
   catalogVersion?: number
+  fileCache: FileCache
 }
 
 export type StorageCause =

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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      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.`)
       }
       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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
           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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.28' && 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.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        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.`)
         }
         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.28') {
-            throw new Error(`WASI binding package version mismatch, expected 0.0.28 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          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.`)
           }
         }
         wasiBinding = require('@withmarfa/core-wasm32-wasi')
@@ -783,8 +783,10 @@ module.exports.MarfaCore = nativeBinding.MarfaCore
 module.exports.Stop = nativeBinding.Stop
 module.exports.Subscription = nativeBinding.Subscription
 module.exports.BlockedReason = nativeBinding.BlockedReason
+module.exports.Completeness = nativeBinding.Completeness
 module.exports.EdgeEnd = nativeBinding.EdgeEnd
 module.exports.EdgeWrittenAt = nativeBinding.EdgeWrittenAt
+module.exports.FileBudgetKind = nativeBinding.FileBudgetKind
 module.exports.FileState = nativeBinding.FileState
 module.exports.GrantKind = nativeBinding.GrantKind
 module.exports.GrantLevel = nativeBinding.GrantLevel

package/package.json

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