import { MultiSet } from './multiset.js' import type { MultiSetArray } from './multiset.js' import type { IDifferenceStreamReader, IDifferenceStreamWriter, IOperator, } from './types.js' /** * A read handle to a dataflow edge that receives data from a writer. */ export class DifferenceStreamReader implements IDifferenceStreamReader { #queue: Array> constructor(queue: Array>) { this.#queue = queue } drain(): Array> { const out = [...this.#queue].reverse() this.#queue.length = 0 return out } isEmpty(): boolean { return this.#queue.length === 0 } } /** * A write handle to a dataflow edge that is allowed to publish data. */ export class DifferenceStreamWriter implements IDifferenceStreamWriter { #queues: Array>> = [] sendData(collection: MultiSet | MultiSetArray): void { if (!(collection instanceof MultiSet)) { collection = new MultiSet(collection) } for (const q of this.#queues) { q.unshift(collection) } } newReader(): DifferenceStreamReader { const q: Array> = [] this.#queues.push(q) return new DifferenceStreamReader(q) } } /** * A generic implementation of a dataflow operator (node) that has multiple incoming edges (read handles) and * one outgoing edge (write handle). */ export abstract class Operator implements IOperator { protected inputs: Array> protected output: DifferenceStreamWriter constructor( public id: number, inputs: Array>, output: DifferenceStreamWriter, ) { this.inputs = inputs this.output = output } abstract run(): void hasPendingWork(): boolean { return this.inputs.some((input) => !input.isEmpty()) } } /** * A convenience implementation of a dataflow operator that has a handle to one * incoming stream of data, and one handle to an outgoing stream of data. */ export abstract class UnaryOperator extends Operator< Tin | Tout > { constructor( public id: number, inputA: DifferenceStreamReader, output: DifferenceStreamWriter, ) { super(id, [inputA], output) } inputMessages(): Array> { return this.inputs[0]!.drain() as Array> } } /** * A convenience implementation of a dataflow operator that has a handle to two * incoming streams of data, and one handle to an outgoing stream of data. */ export abstract class BinaryOperator extends Operator { constructor( public id: number, inputA: DifferenceStreamReader, inputB: DifferenceStreamReader, output: DifferenceStreamWriter, ) { super(id, [inputA, inputB], output) } inputAMessages(): Array> { return this.inputs[0]!.drain() } inputBMessages(): Array> { return this.inputs[1]!.drain() } } /** * Base class for operators that process a single input stream */ export abstract class LinearUnaryOperator extends UnaryOperator { abstract inner(collection: MultiSet): MultiSet run(): void { for (const message of this.inputMessages()) { this.output.sendData(this.inner(message)) } } }