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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sqd-pipes/delta-db",
-  "version": "0.0.1-alpha.1",
+  "version": "0.0.1-alpha.2",
   "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 src",
+    "build:debug": "napi build --cargo-cwd ../../.. --features napi src",
     "test": "vitest run",
     "test:watch": "vitest"
   },

package/src/index.d.ts

@@ -1,3 +1,8 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
 /** Configuration for opening a DeltaDb instance. */
 export interface DeltaDbConfig {
   /** SQL schema definition string. */
@@ -10,65 +15,49 @@ export interface DeltaDbConfig {
   /** Maximum buffer size before backpressure (default: 10000). */
   maxBufferSize?: number
 }
-
 /** Block cursor: number + hash. */
 export interface DeltaDbCursor {
   number: number
   hash: string
 }
-
-/** A single delta record. */
-export interface DeltaRecord {
-  table: string
-  operation: string
-  key: Record<string, any>
-  values: Record<string, any>
-  prevValues?: Record<string, any> | null
-}
-
-/** A batch of delta records. */
-export interface DeltaBatch {
-  sequence: number
-  finalizedHead?: DeltaDbCursor | null
-  latestHead?: DeltaDbCursor | null
-  records: Array<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, msgpack-encoded as `{tableName: [{col: val}, ...], ...}`. */
+  data: Buffer
   /** Unfinalized blocks with hashes for fork resolution. */
   rollbackChain?: Array<DeltaDbCursor>
   /** Finalized head cursor — both number and hash stored. */
   finalizedHead: DeltaDbCursor
 }
-
-/** Delta DB — embedded rollback-aware computation engine. */
+/** Delta DB N-API wrapper. */
 export declare class DeltaDb {
   /** Open a new DeltaDb instance. */
   static open(config: DeltaDbConfig): DeltaDb
   /**
    * Process a batch of rows for a raw table.
+   * `rows` is a msgpack-encoded Buffer: `[{col: val, ...}, ...]`.
    * Returns true if backpressure should be applied.
    */
-  processBatch(table: string, block: number, rows: Array<Record<string, any>>): boolean
+  processBatch(table: string, block: number, rows: Buffer): boolean
   /** Roll back all state after fork_point. */
   rollback(forkPoint: number): void
   /** Finalize all state up to and including the given block. */
   finalize(block: number): void
   /**
    * Atomic ingest: process all tables, store rollback chain, finalize, flush.
-   * Returns the delta batch, or null if no records produced.
+   * Returns a msgpack-encoded DeltaBatch buffer, or null if no records produced.
    */
-  ingest(input: IngestInput): DeltaBatch | null
+  ingest(input: IngestInput): Buffer | 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
-  /** Flush buffered deltas into a batch. Returns null if no pending records. */
-  flush(): DeltaBatch | null
+  /**
+   * Flush buffered deltas into a msgpack-encoded batch.
+   * Returns null if no pending records.
+   */
+  flush(): Buffer | null
   /** Acknowledge a flushed batch by sequence number. */
   ack(sequence: number): void
   /** Number of pending (unflushed) delta records. */