@withmarfa/core 0.0.2 → 0.0.4

package/index.d.ts

@@ -21,26 +21,62 @@ export declare class MarfaCore {
   /**
    * Holds the event stream open on a thread of its own and applies each
    * event as it arrives: `onChange` for each change, then `onEnd` once,
-   * with the error that ended it or null where it was stopped. Neither
-   * callback keeps the process alive. An `onChange` that throws ends the
-   * follow, and `onEnd` is told what it threw, as `listener_threw: …`.
+   * with the error that ended it, the same error as any call throws, or
+   * null where it was stopped. Neither callback keeps the process alive. An
+   * `onChange` that throws ends the follow, and `onEnd` is given an error
+   * whose `code` is `listener_threw` and whose message says what it threw.
    */
-  follow(onChange: (arg: Change) => void, onEnd: (arg: string | undefined | null) => void): Subscription
+  follow(onChange: (change: Change) => void, onEnd: (error: (Error & { code: string }) | null) => void): Subscription
   /**
    * Opens the file at `path`, creating it when absent. `url` and `key` go
    * together; without them only local reads work.
    */
   static open(path: string, url?: string | undefined | null, key?: string | undefined | null): MarfaCore
   /** Replaces the local copy with the declared types at `tier`. */
-  hydrate(types: Array<string>, tier: Tier): Promise<HydrateReport>
+  hydrate(types: Array<string>, tier: Tier, stop?: Stop | undefined | null): Promise<HydrateReport>
+  /**
+   * A hydration that also holds every edge of `edgeTypes` the key reads,
+   * whichever ends the copy holds.
+   */
+  hydrateWith(types: Array<string>, tier: Tier, edgeTypes: Array<string>, stop?: Stop | undefined | null): Promise<HydrateReport>
+  /** Holds one row by id whatever the slice says of it, read now. */
+  pin(id: string): Promise<PinReport>
+  /**
+   * Stops holding a row by id; one the slice does not take goes, unless
+   * writes to it still wait.
+   */
+  unpin(id: string): PinReport
   /** Applies every event since the stored cursor. */
-  catchUp(): Promise<CatchUpReport>
+  catchUp(stop?: Stop | undefined | null): Promise<CatchUpReport>
   list(filters?: ListFilters | undefined | null, sort?: Sort | undefined | null): Array<Item>
   get(id: string): Item | null
   edgesFrom(id: string): Array<Edge>
   edgesTo(id: string): Array<Edge>
+  edgesOfType(edgeType: string): Array<Edge>
   search(query: string, filters?: SearchFilters | undefined | null, limit?: number | undefined | null): Array<SearchHit>
   status(): Status
+  /**
+   * Declares the types this app saves, each an object with its `id`, its
+   * `fields` and whatever else a type carries. A copy that has never
+   * reached a server checks what it queues against them and the types
+   * Marfa ships, and a hydration registers the ones the instance
+   * lacks, where the key may. The call is the app's whole set and replaces every earlier declaration.
+   */
+  declareTypes(types: Record<string, unknown>[]): void
+  /**
+   * The declarations this copy holds, by id, with the empty `fields` and
+   * the `version` a registration needs filled in where the app left them
+   * out.
+   */
+  declaredTypes(): Record<string, unknown>[]
+  /** Every item type the copy holds, by id, read from the copy alone. */
+  itemTypes(): Array<ItemType>
+  /** `not_found` where the catalog holds no such type. */
+  itemType(id: string): ItemType
+  /** Every edge type the copy holds, by id, read from the copy alone. */
+  edgeTypes(): Array<EdgeType>
+  /** `not_found` where the catalog holds no such edge type. */
+  edgeType(id: string): EdgeType
   /**
    * Which handle this process holds: the one that may write, or a second
    * opener that reads and refuses every write.
@@ -79,7 +115,7 @@ export declare class MarfaCore {
   /** Every queued write and what became of it. */
   queue(): Array<QueuedWrite>
   /** Sends what the queue holds and records what came back. One pass. */
-  drain(): Promise<DrainReport>
+  drain(stop?: Stop | undefined | null): Promise<DrainReport>
   /**
    * Holds a file's bytes beside the working copy and queues their upload.
    * Off the JavaScript thread, because the whole file is copied and
@@ -114,8 +150,36 @@ export declare class MarfaCore {
   release(id: string): boolean
   /** Releases every write blocked for one reason, and says how many. */
   releaseReason(reason: BlockedReason): number
-  /** Clears the writes the server has answered, and says how many went. */
+  /**
+   * 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.
+   */
+  withdraw(id: string): boolean
+  /**
+   * Clears the writes the server has answered, and says how many went. A
+   * refused write that carried content stays until it is discarded.
+   */
   forgetAnswered(): number
+  /**
+   * Takes a refused write out of the queue, with the content it carried.
+   * Answers whether the row was one a discard takes: refused, and with no
+   * write still waiting on it.
+   */
+  discard(id: string): boolean
+}
+
+/**
+ * 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. A
+ * raised `Stop` stays raised, so a call given one afterwards ends at once.
+ */
+export declare class Stop {
+  constructor()
+  raise(): void
 }
 
 /**
@@ -161,14 +225,20 @@ export interface CatchUpReport {
 }
 
 /**
- * One event a held stream applied: what it was, what it was about, and the
- * cursor it left.
+ * What a held stream changed in the copy: an event it applied, named by the
+ * event's type with the item or edge it was about, or `catalog.changed`,
+ * naming neither, where a stream it opened read a catalog that differs from
+ * the one held. Or what became of the server: `server.unreachable`, with
+ * `reason`, once when a stream cannot be had, and `server.reachable` once
+ * when one is had again, which is when to drain what waited. `cursor` is
+ * the cursor held after it.
  */
 export interface Change {
   event: string
   itemId?: string
   edgeId?: string
   cursor: string
+  reason?: string
 }
 
 /** A create, before it is queued. */
@@ -191,10 +261,36 @@ export interface Draft {
 
 /** What a drain did. */
 export interface DrainReport {
-  sent: number
+  /** Writes the server answered this drain, whatever it answered. */
+  answered: number
   held: number
+  /**
+   * Writes it could not deliver, each still waiting, uncounted, for the
+   * next drain.
+   */
+  undelivered: number
+  /**
+   * Writes it gave a verdict without sending them: refused for a write
+   * they waited on or for bytes no longer held, or settled by another
+   * write's answer.
+   */
+  unsent: number
+  /**
+   * Writes whose request could not be made: each is counted against its
+   * write and waits for the next drain, or is dead at the ceiling. The
+   * writes a refused credential parks are counted in `stopped`.
+   */
+  unmade: number
+  /**
+   * Why the drain ended before the queue was through: the server could
+   * not be reached, failed, or asked to be left alone for a while.
+   */
+  unavailable?: string
   verdicts: Array<DrainVerdict>
-  /** Why the drain stopped before the queue was empty, where it did. */
+  /**
+   * Why the drain stopped: the server refused the credential, and every
+   * write waits until it is replaced.
+   */
   stopped?: string
   /**
    * The sources the server said this credential's key does not claim,
@@ -205,11 +301,13 @@ export interface DrainReport {
   retryAfterSeconds?: number
 }
 
-/** What became of one write a drain sent. */
+/** What became of one write a drain answered, sent or not. */
 export interface DrainVerdict {
   id: string
   kind: WriteKind
+  /** An edge write's source; otherwise the row written to. */
   itemId?: string
+  edgeId?: string
   verdict?: Verdict
   refusals: number
   /**
@@ -245,6 +343,28 @@ export interface EdgeEdit {
   baseVersion?: number
 }
 
+/** The end of an edge whose file writes it. */
+export declare const enum EdgeEnd {
+  Source = 'source',
+  Target = 'target',
+}
+
+/** An edge type as the copy holds it. */
+export interface EdgeType {
+  id: string
+  label?: string
+  description?: string
+  cardinality: string
+  /** The name the edge goes by read from its target. */
+  reverseName?: string
+  writtenAt: EdgeEnd
+  sourceTypeConstraints: Array<string>
+  targetTypeConstraints: Array<string>
+  cascadeOnDelete: string
+  properties: Array<TypeField>
+  shipped: boolean
+}
+
 /** A change to an item, and the version it was read at. */
 export interface Edit {
   /** Whole field values; a device never merges inside a field. */
@@ -255,6 +375,23 @@ export interface Edit {
   sourceId?: string
 }
 
+export interface FieldRefusal {
+  field: string
+  message: string
+}
+
+/** What a missing grant is on. */
+export declare const enum GrantKind {
+  Type = 'type',
+  EdgeType = 'edge_type',
+  Extension = 'extension',
+}
+
+export declare const enum GrantLevel {
+  Read = 'read',
+  Write = 'write',
+}
+
 /** Which handle this process holds on the store. */
 export declare const enum Handle {
   Writer = 'writer',
@@ -264,10 +401,15 @@ export declare const enum Handle {
 export interface HydrateReport {
   types: Array<string>
   tier: Tier
+  edgeTypes: Array<string>
   items: number
   edges: number
   pages: number
   cursor: string
+  /** Types the app declared that the instance did not hold and now does. */
+  registeredTypes: Array<string>
+  /** Declared types the instance did not hold and would not take. */
+  unregisteredTypes: Array<UnregisteredType>
 }
 
 export declare const enum Hydration {
@@ -300,6 +442,21 @@ export declare const enum ItemState {
   Revoked = 'revoked',
 }
 
+/** An item type as the copy holds it, with the fields it inherits. */
+export interface ItemType {
+  id: string
+  label?: string
+  description?: string
+  parent?: string
+  version: number
+  fields: Array<TypeField>
+  titleField?: string
+  bodyField?: string
+  linkField?: string
+  roles: Array<string>
+  compatibleWith: Array<string>
+}
+
 /**
  * Narrowing for a list. Leaving `state` unset answers the active state, as
  * the server does; `allStates` lifts that, and a named state wins.
@@ -312,10 +469,36 @@ export interface ListFilters {
   tags?: Array<string>
   occurredAfter?: string
   occurredBefore?: string
+  /**
+   * An expression in the server's listing grammar, answered as the server
+   * answers `filter` and refused `validation_error` where it refuses it.
+   * A `backref` condition is refused `invalid`.
+   */
+  filter?: string
+  /**
+   * An item id: that item and every item it reaches along `parent-of`
+   * edges, as far as the copy holds them.
+   */
+  beneath?: string
   limit?: number
   offset?: number
 }
 
+export interface MissingGrant {
+  kind: GrantKind
+  /** The type or edge type id, or the extension namespace. */
+  name: string
+  level: GrantLevel
+}
+
+/** What a pin or an unpin answers. */
+export interface PinReport {
+  /** Whether the row is pinned now. */
+  pinned: boolean
+  /** Whether it was pinned before the call. */
+  wasPinned: boolean
+}
+
 /** One queued write and what became of it. */
 export interface QueuedWrite {
   id: string
@@ -336,7 +519,18 @@ export interface QueuedWrite {
    * out after and is not refused with.
    */
   follows?: string
+  /** Absent while the server has not answered it. */
   verdict?: Verdict
+  /**
+   * Held behind a write that has no answer yet: `depends_on` and
+   * `follows` say which.
+   */
+  waiting: boolean
+  /**
+   * The body the write sends, or sent: a refused write's content stays
+   * readable here until it is discarded.
+   */
+  body: Record<string, unknown>
   /** The server's answer, whole, as it arrived. */
   answer?: string
   refusals: number
@@ -344,21 +538,52 @@ export interface QueuedWrite {
   answeredAt?: string
 }
 
+/** Why the server, or the drain for a write it never sent, refused a write. */
+export interface Refusal {
+  /**
+   * The server's code verbatim, or the sentence naming the write this one
+   * waited on where that write was refused.
+   */
+  reason: string
+  /** The code in the server's envelope, where the server refused it. */
+  code?: string
+  message?: string
+  /** Each property the server would not take, and why. */
+  fields: Array<FieldRefusal>
+  /** The row the write named is in the bin, and can be restored. */
+  trashed: boolean
+  /** The permission the credential's key lacks, where the refusal names one. */
+  grant?: MissingGrant
+}
+
 /**
  * Narrowing for a search: the state rule a list takes, a type with its
- * subtree, and tags, each read as the list reads it.
+ * subtree, tags, a listing-grammar expression and `beneath`, each read as
+ * the list reads it.
  */
 export interface SearchFilters {
   state?: ItemState
   allStates?: boolean
   type?: string
   tags?: Array<string>
+  /**
+   * An expression in the server's listing grammar, answered as the server
+   * answers `filter` and refused `validation_error` where it refuses it.
+   * A `backref` condition is refused `invalid`.
+   */
+  filter?: string
+  /**
+   * An item id: that item and every item it reaches along `parent-of`
+   * edges, as far as the copy holds them.
+   */
+  beneath?: string
 }
 
 export interface SearchHit {
   item: Item
   /** Higher is a better match. */
   score: number
+  /** An excerpt as HTML: the text escaped and each match in `<mark>` tags. */
   snippet: string
 }
 
@@ -380,12 +605,21 @@ export declare const enum SortField {
 
 export interface Status {
   serverOrigin?: string
+  /** The instance the copy was hydrated from. */
+  instanceId?: string
   sliceTypes: Array<string>
   sliceTier?: Tier
+  sliceEdgeTypes: Array<string>
+  pinned: Array<string>
   eventCursor?: string
   hydration: Hydration
   items: number
   edges: number
+  /**
+   * Moves each time a refresh changes the catalog; absent where the copy
+   * has never held one.
+   */
+  catalogVersion?: number
 }
 
 /** An item's thumbnail: the image's type and its bytes. */
@@ -399,6 +633,30 @@ export declare const enum Tier {
   Feed = 'feed',
 }
 
+/** A field of an item type, or a property of an edge type. */
+export interface TypeField {
+  name: string
+  /** The field's own type, such as `string` or `thumbnail`. */
+  type: string
+  required: boolean
+  description?: string
+  /**
+   * The type that declares it: the type itself, or the nearest one it
+   * inherits the field from.
+   */
+  declaredBy: string
+  /** The definition whole, as the server answers it. */
+  definition: Record<string, unknown>
+}
+
+/** A declared type the instance refused to register, and why. */
+export interface UnregisteredType {
+  id: string
+  /** The server's code for the refusal. */
+  code: string
+  message: string
+}
+
 /**
  * What the server made of a write: one of six, and absent while the write
  * is unanswered.
@@ -407,8 +665,8 @@ export type Verdict =
   | { verdict: 'accepted' }
   | { verdict: 'merged'; fields: Array<string> }
   | { verdict: 'conflicted'; siblingId: string; fields: Array<string> }
-  | { verdict: 'refused'; reason: string }
-  | { verdict: 'blocked'; reason: BlockedReason }
+  | { verdict: 'refused'; refusal: Refusal }
+  | { verdict: 'blocked'; reason: BlockedReason; refusal?: Refusal }
   | { verdict: 'dead' }
 
 /** The kinds of write a queue holds. */

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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.4 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.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.4' && 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.4 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.2') {
-            throw new Error(`WASI binding package version mismatch, expected 0.0.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.4') {
+            throw new Error(`WASI binding package version mismatch, expected 0.0.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
         }
         wasiBinding = require('@withmarfa/core-wasm32-wasi')
@@ -779,8 +779,12 @@ function __napiStampBindingTarget(exportsObject, target) {
 module.exports.__napiBindingTarget = __napiStampBindingTarget(nativeBinding, __napiLoadedBindingTarget)
 module.exports = nativeBinding
 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.GrantKind = nativeBinding.GrantKind
+module.exports.GrantLevel = nativeBinding.GrantLevel
 module.exports.Handle = nativeBinding.Handle
 module.exports.Hydration = nativeBinding.Hydration
 module.exports.ItemState = nativeBinding.ItemState

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withmarfa/core",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "marfa-core as a Node module.",
   "license": "Apache-2.0",
   "repository": {
@@ -18,8 +18,8 @@
   },
   "devDependencies": {
     "@napi-rs/cli": "^3",
-    "@types/node": "^22.20.4",
-    "typescript": "^5.9.3"
+    "@types/node": "^26.6.4",
+    "typescript": "^7.0.2"
   },
   "files": [
     "index.js",
@@ -32,7 +32,6 @@
   "scripts": {
     "build": "napi build --platform --release",
     "build:debug": "napi build --platform",
-    "proof": "node scripts/proof.mjs",
     "check": "tsc -p tsconfig.json",
     "test": "node --expose-gc --test test/*.test.mjs"
   }