@withmarfa/core 0.0.1 → 0.0.3

package/index.d.ts

@@ -33,13 +33,35 @@ export declare class MarfaCore {
   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>
+  /**
+   * 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>): 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>
   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
+  /** 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.
@@ -49,6 +71,12 @@ export declare class MarfaCore {
   createItem(draft: Draft): QueuedWrite
   /** Changes an item in the local copy and queues the change. */
   updateItem(id: string, edit: Edit): QueuedWrite
+  /**
+   * Changes an item in the local copy and queues the change, based on a
+   * version read before the one the copy holds now, which the server
+   * merges the change against.
+   */
+  updateItemAsRead(id: string, edit: Edit): QueuedWrite
   /** Moves an item to the bin locally and queues the delete. */
   deleteItem(id: string): QueuedWrite
   /** Takes an item out of the bin locally and queues the restore. */
@@ -107,8 +135,24 @@ 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
 }
 
 /**
@@ -154,14 +198,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. */
@@ -184,10 +234,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,
@@ -198,11 +274,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
   /**
@@ -238,6 +316,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. */
@@ -248,6 +348,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',
@@ -257,6 +374,7 @@ export declare const enum Handle {
 export interface HydrateReport {
   types: Array<string>
   tier: Tier
+  edgeTypes: Array<string>
   items: number
   edges: number
   pages: number
@@ -293,6 +411,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.
@@ -305,10 +438,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
@@ -329,7 +488,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
@@ -337,15 +507,45 @@ 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 {
@@ -373,12 +573,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. */
@@ -392,6 +601,22 @@ 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>
+}
+
 /**
  * What the server made of a write: one of six, and absent while the write
  * is unanswered.
@@ -400,8 +625,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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.3' && 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.3 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.1' && 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.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.0.3' && 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.3 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.1') {
-            throw new Error(`WASI binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.0.3') {
+            throw new Error(`WASI binding package version mismatch, expected 0.0.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
         }
         wasiBinding = require('@withmarfa/core-wasm32-wasi')
@@ -781,6 +781,9 @@ module.exports = nativeBinding
 module.exports.MarfaCore = nativeBinding.MarfaCore
 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.1",
+  "version": "0.0.3",
   "description": "marfa-core as a Node module.",
   "license": "Apache-2.0",
   "repository": {
@@ -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"
   }