@withmarfa/core 0.0.13 → 0.0.15

package/index.d.ts

@@ -9,6 +9,23 @@
  */
 export declare const __napiBindingTarget: 'native' | 'wasm32-wasi' | 'wasm32-wasip1'
 
+export declare class Folders {
+  constructor(url?: string | undefined | null, key?: string | undefined | null)
+  add(dir: string, folder: string): Promise<AddedFolder>
+  list(): Promise<Array<ListedFolder>>
+  status(dir: string): Promise<FolderStatus>
+  sync(dir: string): Promise<FolderSyncOutcome>
+  confirmFirstSync(dir: string): Promise<boolean>
+  confirm(dir: string): Promise<ConfirmedRemoval>
+  restore(dir: string): Promise<RestoredRemoval>
+  remove(dir: string): Promise<void>
+  /**
+   * The callbacks share one event-loop queue, so the end follows every event.
+   * A callback that throws stops the watch and ends it with `listener_threw`.
+   */
+  watch(dir: string, onEvent: (event: FolderEvent) => void, onEnd: (error: (Error & { code: string }) | null) => void): Subscription
+}
+
 /** A local copy of a slice of one server. */
 export declare class MarfaCore {
   /**
@@ -28,8 +45,12 @@ export declare class MarfaCore {
    * Each time it tells `serverReachable` with work queued for a drain, it
    * drains once, after any drain under way, and tells `queueDrained` or
    * `queueNotDrained`; `onEnd` follows that drain's end.
+   *
+   * `toldUnreachable` says the caller was last told `serverUnreachable` by
+   * an earlier follow: this one tells `serverReachable` when it has its
+   * first stream, and does not tell `serverUnreachable` again before.
    */
-  follow(onChange: (change: Change) => void, onEnd: (error: (Error & { code: string }) | null) => void): Subscription
+  follow(onChange: (change: Change) => void, onEnd: (error: (Error & { code: string }) | null) => void, toldUnreachable?: boolean): Subscription
   /**
    * Adds a listener to this store's watch, and starts it if it was idle.
    * However many listeners there are, one source runs: a writer with a
@@ -51,8 +72,12 @@ export declare class MarfaCore {
    * drain is told as `follow` tells it. An `onChange` that throws ends its
    * listener, and `onEnd` is given an error whose `code` is
    * `listener_threw`. Throws `no_server` for a writer with no server.
+   *
+   * `toldUnreachable` says the listener was last told `serverUnreachable`
+   * by an earlier watch: it is told `serverReachable` once the server is
+   * reached, and not `serverUnreachable` again before.
    */
-  watch(onChange: (change: Change) => void, onEnd: (error: (Error & { code: string }) | null) => void): Subscription
+  watch(onChange: (change: Change) => void, onEnd: (error: (Error & { code: string }) | null) => void, toldUnreachable?: boolean): Subscription
   /**
    * Opens the file at `path`, creating it when absent. `url` and `key` go
    * together; without them only local reads work.
@@ -207,9 +232,10 @@ export declare class MarfaCore {
    * Takes a write blocked `ancestor_unavailable` or `conflict_unresolved`
    * out of the queue, and puts the copy back to what the server holds;
    * each write held for it is refused unsent. Answers whether the row was
-   * one a withdraw takes.
+   * one a withdraw takes. Off the JavaScript thread, because it reads each
+   * row it puts back from the server.
    */
-  withdraw(id: string): boolean
+  withdraw(id: string): Promise<boolean>
   /**
    * Clears the writes the server has answered, and says how many went. A
    * refused write that carried content stays until it is discarded.
@@ -228,9 +254,9 @@ export declare class MarfaCore {
    * write still waiting on it, or a create refused onto a row its natural
    * key names that no read has found, whose waiting writes it refuses
    * unsent. A create's discard first waits for a drain already running to
-   * end.
+   * end, which is why it is off the JavaScript thread.
    */
-  discard(id: string): boolean
+  discard(id: string): Promise<boolean>
 }
 
 /**
@@ -256,6 +282,12 @@ export declare class Subscription {
   stop(): void
 }
 
+export interface AddedFolder {
+  dir: string
+  folder: string
+  storage?: StorageCause
+}
+
 /**
  * The three writes an attachment is, in the order they go out, and the
  * text that embeds the file in the item's body.
@@ -316,6 +348,13 @@ export type Change =
   | { kind: 'saved'; dataVersion: number; cursor: string }
   | { kind: 'watchFailed'; code: string; reason: string; cursor: string }
 
+export interface ConfirmedRemoval {
+  deleted: number
+  moved: number
+  removed: number
+  unsure: Array<UnsureFile>
+}
+
 /** A create, before it is queued. */
 export interface Draft {
   type: string
@@ -472,6 +511,112 @@ export interface FieldRefusal {
   message: string
 }
 
+export declare const enum FileState {
+  InStep = 'in_step',
+  Waiting = 'waiting',
+  Held = 'held',
+  Unmatched = 'unmatched',
+  Unreached = 'unreached',
+  Outside = 'outside',
+}
+
+export interface FileStatus {
+  path: string
+  itemId?: string
+  state: FileState
+  waits: Array<string>
+  flag?: string
+  reason?: string
+  warning?: string
+}
+
+export interface FirstSyncPlan {
+  write: number
+  send: number
+  beside: number
+}
+
+export interface FlaggedFile {
+  path: string
+  flag: string
+  reason: string
+  item?: string
+}
+
+export type FolderEvent =
+  | { kind: 'watching'; dir: string; storage?: StorageCause }
+  | { kind: 'watcherFailed'; message: string }
+  | { kind: 'retrying'; error: any; waitMs: number }
+  | { kind: 'unreachable'; reason: string }
+  | { kind: 'reachable' }
+  | { kind: 'waiting'; reason: string }
+  | { kind: 'passed'; pass: FolderPass }
+  | { kind: 'handedOver' }
+  | { kind: 'heldElsewhere' }
+  | { kind: 'takenBack' }
+  | { kind: 'removed' }
+  | { kind: 'unlisted' }
+
+export interface FolderPass {
+  settings: SettingsFileOutcome
+  scan: FolderScan
+  drain: DrainReport
+  rebased: number
+  gaveWay: number
+  pull?: FolderPull
+  flagged: Array<FlaggedFile>
+}
+
+export interface FolderPull {
+  written: number
+  rewritten: number
+  moved: number
+  unchanged: number
+  skipped: number
+  removed: number
+  purged: number
+  kept: number
+  unwritten: number
+  absent: number
+  unplaced: number
+  unmatched: number
+  paused: number
+  rootGone?: string
+}
+
+export interface FolderScan {
+  created: number
+  updated: number
+  renamed: number
+  unchanged: number
+  missing: number
+  deleted: number
+  skipped: number
+  movedAway: number
+  paused: number
+  trashed: Array<string>
+  secrets: Array<string>
+  warnings: Array<FlaggedFile>
+  rootGone?: string
+}
+
+export interface FolderStatus {
+  directories: Array<FlaggedFile>
+  files: Array<FileStatus>
+  paused: PausedRemoval
+  firstSync?: WaitingFirstSync
+}
+
+export interface FolderSync {
+  hydrated?: HydrateReport
+  catchUpError?: any
+  pass: FolderPass
+}
+
+export type FolderSyncOutcome =
+  | { kind: 'done'; sync: FolderSync }
+  | { kind: 'waiting'; plan: FirstSyncPlan }
+
 /** What a missing grant is on. */
 export declare const enum GrantKind {
   Type = 'type',
@@ -549,6 +694,11 @@ export interface ItemType {
   compatibleWith: Array<string>
 }
 
+export interface ListedFolder {
+  dir: string
+  folder: string
+}
+
 /**
  * Narrowing for a list. Leaving `state` unset answers the active state, as
  * the server does; `allStates` lifts that, and a named state wins.
@@ -583,6 +733,11 @@ export interface MissingGrant {
   level: GrantLevel
 }
 
+export interface PausedRemoval {
+  disk: number
+  pull: number
+}
+
 /** What a pin or an unpin answers. */
 export interface PinReport {
   /** Whether the row is pinned now. */
@@ -648,6 +803,12 @@ export interface Refusal {
   grant?: MissingGrant
 }
 
+export interface RestoredRemoval {
+  putBack: number
+  restored: number
+  pull: FolderPull
+}
+
 /**
  * Narrowing for a search: the state rule a list takes, a type with its
  * subtree, tags, a listing-grammar expression and `beneath`, each read as
@@ -687,6 +848,13 @@ export interface ServerCatalog {
   edgeTypes: Array<EdgeType>
 }
 
+export interface SettingsFileOutcome {
+  sent: boolean
+  written: boolean
+  flagged?: string
+  unwritten?: string
+}
+
 /** The tiers a slice holds: one, or `all` for both. */
 export declare const enum SliceTier {
   Library = 'library',
@@ -729,6 +897,12 @@ export interface Status {
   catalogVersion?: number
 }
 
+export type StorageCause =
+  | { cause: 'iCloudDrive' }
+  | { cause: 'cloudService' }
+  | { cause: 'cloudSynced' }
+  | { cause: 'networkFileSystem'; kind: string }
+
 /** An item's thumbnail: the image's type and its bytes. */
 export interface Thumbnail {
   mimeType: string
@@ -764,6 +938,11 @@ export interface UnregisteredType {
   message: string
 }
 
+export interface UnsureFile {
+  path: string
+  reason: string
+}
+
 /**
  * What the server made of a write: one of six, and absent while the write
  * is unanswered.
@@ -776,6 +955,10 @@ export type Verdict =
   | { verdict: 'blocked'; reason: BlockedReason; refusal?: Refusal }
   | { verdict: 'dead' }
 
+export interface WaitingFirstSync {
+  plan?: FirstSyncPlan
+}
+
 /** The kinds of write a queue holds. */
 export declare const enum WriteKind {
   CreateItem = 'create_item',

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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.15' && 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.15 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.13' && 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.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.15' && 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.15 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.13') {
-            throw new Error(`WASI binding package version mismatch, expected 0.0.13 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.15') {
+            throw new Error(`WASI binding package version mismatch, expected 0.0.15 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
         }
         wasiBinding = require('@withmarfa/core-wasm32-wasi')
@@ -778,12 +778,14 @@ function __napiStampBindingTarget(exportsObject, target) {
 // linked import resolves to `undefined`.
 module.exports.__napiBindingTarget = __napiStampBindingTarget(nativeBinding, __napiLoadedBindingTarget)
 module.exports = nativeBinding
+module.exports.Folders = nativeBinding.Folders
 module.exports.MarfaCore = nativeBinding.MarfaCore
 module.exports.Stop = nativeBinding.Stop
 module.exports.Subscription = nativeBinding.Subscription
 module.exports.BlockedReason = nativeBinding.BlockedReason
 module.exports.EdgeEnd = nativeBinding.EdgeEnd
 module.exports.EdgeWrittenAt = nativeBinding.EdgeWrittenAt
+module.exports.FileState = nativeBinding.FileState
 module.exports.GrantKind = nativeBinding.GrantKind
 module.exports.GrantLevel = nativeBinding.GrantLevel
 module.exports.Handle = nativeBinding.Handle

package/package.json

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