@electric-sql/d2ts/tests/operators-sqlite/consolidate.test.ts

D2TS is a TypeScript implementation of Differential Dataflow.

import { describe, test, expect, beforeEach, afterEach } from 'vitest'
import { D2 } from '../../src/d2.js'
import { MultiSet } from '../../src/multiset.js'
import { Antichain, v } from '../../src/order.js'
import { DataMessage, MessageType } from '../../src/types.js'
import { consolidate } from '../../src/sqlite/operators/consolidate.js'
import { output } from '../../src/operators/index.js'
import Database from 'better-sqlite3'
import { BetterSQLite3Wrapper } from '../../src/sqlite/database.js'
import fs from 'fs'
import path from 'path'

const DB_FILENAME = 'test-consolidate.db'

describe('SQLite Operators', () => {
  describe('Consolidate operation', () => {
    let db: BetterSQLite3Wrapper

    beforeEach(() => {
      const sqlite = new Database(':memory:')
      db = new BetterSQLite3Wrapper(sqlite)
    })

    afterEach(() => {
      db.close()
    })

    test('basic consolidate operation', () => {
      const graph = new D2({ initialFrontier: v([0, 0]) })
      const input = graph.newInput<number>()
      const messages: DataMessage<number>[] = []

      input.pipe(
        consolidate(db),
        output((message) => {
          if (message.type === MessageType.DATA) {
            messages.push(message.data)
          }
        }),
      )

      graph.finalize()

      input.sendData(
        v([1, 0]),
        new MultiSet([
          [1, 1],
          [2, 1],
        ]),
      )
      input.sendData(
        v([1, 0]),
        new MultiSet([
          [3, 1],
          [4, 1],
        ]),
      )
      input.sendData(
        v([1, 0]),
        new MultiSet([
          [3, 2],
          [2, -1],
        ]),
      )
      input.sendFrontier(new Antichain([v([1, 1])]))

      graph.run()

      const data = messages.map((m) => m.collection.getInner())

      expect(data).toEqual([
        [
          [1, 1],
          [3, 3],
          [4, 1],
        ],
      ])
    })

    test('consolidate with multiple versions', () => {
      const graph = new D2({ initialFrontier: v([0, 0]) })
      const input = graph.newInput<number>()
      const messages: DataMessage<number>[] = []

      input.pipe(
        consolidate(db),
        output((message) => {
          if (message.type === MessageType.DATA) {
            messages.push(message.data)
          }
        }),
      )

      graph.finalize()

      input.sendData(
        v([1, 0]),
        new MultiSet([
          [1, 1],
          [2, 1],
        ]),
      )
      input.sendData(
        v([2, 0]),
        new MultiSet([
          [2, 1],
          [3, 1],
        ]),
      )
      input.sendFrontier(new Antichain([v([3, 0])]))

      graph.run()

      const data = messages.map((m) => m.collection.getInner())

      expect(data).toEqual([
        [
          [1, 1],
          [2, 1],
        ],
        [
          [2, 1],
          [3, 1],
        ],
      ])
    })
  })

  describe('Consolidate operation with persistence', () => {
    const dbPath = path.join(import.meta.dirname, DB_FILENAME)
    let db: BetterSQLite3Wrapper

    beforeEach(() => {
      if (fs.existsSync(dbPath)) {
        fs.unlinkSync(dbPath)
      }
      const sqlite = new Database(dbPath)
      db = new BetterSQLite3Wrapper(sqlite)
    })

    afterEach(() => {
      db.close()
      if (fs.existsSync(dbPath)) {
        fs.unlinkSync(dbPath)
      }
    })

    test('persists and recovers state', () => {
      // First graph instance - initial processing
      let messages: DataMessage<number>[] = []
      let graph = new D2({ initialFrontier: v([0, 0]) })
      const input = graph.newInput<number>()

      input.pipe(
        consolidate(db),
        output((message) => {
          if (message.type === MessageType.DATA) {
            messages.push(message.data)
          }
        }),
      )

      graph.finalize()

      // Send initial data
      input.sendData(
        v([1, 0]),
        new MultiSet([
          [1, 1],
          [2, 2],
        ]),
      )

      graph.run()

      // Close first graph instance and database
      db.close()

      // Create new graph instance with same database
      messages = []
      db = new BetterSQLite3Wrapper(new Database(dbPath))
      graph = new D2({ initialFrontier: v([1, 0]) })
      const newInput = graph.newInput<number>()

      newInput.pipe(
        consolidate(db),
        output((message) => {
          if (message.type === MessageType.DATA) {
            messages.push(message.data)
          }
        }),
      )

      graph.finalize()

      // Send new data
      newInput.sendData(
        v([1, 0]),
        new MultiSet([
          [2, 1],
          [3, 3],
        ]),
      )
      newInput.sendFrontier(new Antichain([v([2, 0])]))

      graph.run()

      // Verify that new results work with persisted state
      expect(messages.map((m) => m.collection.getInner())).toEqual([
        [
          [1, 1],
          [2, 3],
          [3, 3],
        ],
      ])
    })
  })
})