@sqd-pipes/delta-db 0.0.1-alpha.1 → 0.0.1-alpha.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sqd-pipes/delta-db",
-  "version": "0.0.1-alpha.1",
+  "version": "0.0.1-alpha.3",
   "description": "Embedded rollback-aware computation engine for blockchain data",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -11,8 +11,8 @@
     }
   },
   "scripts": {
-    "build": "napi build --cargo-cwd ../.. --features napi --release",
-    "build:debug": "napi build --cargo-cwd ../.. --features napi",
+    "build": "napi build --cargo-cwd ../../.. --features napi --release --dts native.d.ts src",
+    "build:debug": "napi build --cargo-cwd ../../.. --features napi --dts native.d.ts src",
     "test": "vitest run",
     "test:watch": "vitest"
   },

package/src/index.d.ts

@@ -17,34 +17,36 @@ export interface DeltaDbCursor {
   hash: string
 }
 
-/** A single delta record. */
+export type DeltaOperation = 'insert' | 'update' | 'delete'
+
 export interface DeltaRecord {
   table: string
-  operation: string
+  operation: DeltaOperation
   key: Record<string, any>
   values: Record<string, any>
-  prevValues?: Record<string, any> | null
+  prevValues: Record<string, any> | null
 }
 
-/** A batch of delta records. */
 export interface DeltaBatch {
   sequence: number
-  finalizedHead?: DeltaDbCursor | null
-  latestHead?: DeltaDbCursor | null
-  records: Array<DeltaRecord>
+  finalizedHead: DeltaDbCursor | null
+  latestHead: DeltaDbCursor | null
+  records: DeltaRecord[]
 }
 
 /** Input for the atomic `ingest()` method. */
 export interface IngestInput {
-  /** Table name → rows. Rows must contain `block_number`. */
-  data: Record<string, Array<Record<string, any>>>
+  /** Table name → rows: `{tableName: [{col: val}, ...], ...}`. */
+  data: Record<string, Record<string, any>[]>
   /** Unfinalized blocks with hashes for fork resolution. */
-  rollbackChain?: Array<DeltaDbCursor>
+  rollbackChain?: DeltaDbCursor[]
   /** Finalized head cursor — both number and hash stored. */
   finalizedHead: DeltaDbCursor
+  /** Called with each delta batch. When provided, batch is auto-acked. */
+  onDelta?: (batch: DeltaBatch) => void
 }
 
-/** Delta DB — embedded rollback-aware computation engine. */
+/** Delta DB wrapper. */
 export declare class DeltaDb {
   /** Open a new DeltaDb instance. */
   static open(config: DeltaDbConfig): DeltaDb
@@ -52,7 +54,7 @@ export declare class DeltaDb {
    * Process a batch of rows for a raw table.
    * Returns true if backpressure should be applied.
    */
-  processBatch(table: string, block: number, rows: Array<Record<string, any>>): boolean
+  processBatch(table: string, block: number, rows: Record<string, any>[]): boolean
   /** Roll back all state after fork_point. */
   rollback(forkPoint: number): void
   /** Finalize all state up to and including the given block. */
@@ -60,13 +62,14 @@ export declare class DeltaDb {
   /**
    * Atomic ingest: process all tables, store rollback chain, finalize, flush.
    * Returns the delta batch, or null if no records produced.
+   * When `onDelta` is provided in input, it is called and batch is auto-acked.
    */
   ingest(input: IngestInput): DeltaBatch | null
   /**
    * Find the common ancestor between our state and the Portal's chain.
    * Returns the matching block cursor, or null if no common ancestor found.
    */
-  resolveForkCursor(previousBlocks: Array<DeltaDbCursor>): DeltaDbCursor | null
+  resolveForkCursor(previousBlocks: DeltaDbCursor[]): DeltaDbCursor | null
   /** Flush buffered deltas into a batch. Returns null if no pending records. */
   flush(): DeltaBatch | null
   /** Acknowledge a flushed batch by sequence number. */

package/src/index.js

@@ -44,7 +44,12 @@ class DeltaDb {
       rollbackChain: input.rollbackChain,
       finalizedHead: input.finalizedHead,
     })
-    return buf ? decode(buf) : null
+    const batch = buf ? decode(buf) : null
+    if (batch && input.onDelta) {
+      input.onDelta(batch)
+      this.#native.ack(batch.sequence)
+    }
+    return batch
   }
 
   /**