@jaepil/uqa 0.1.0

package/dist/types/src/engine.d.ts

@@ -0,0 +1,130 @@
+import { SQLCompiler } from "./sql/compiler.js";
+import type { SQLResult } from "./sql/compiler.js";
+import type { Table } from "./sql/table.js";
+import type { GraphStore } from "./storage/abc/graph-store.js";
+import { QueryBuilder } from "./api/query-builder.js";
+import type { Catalog } from "./storage/catalog.js";
+import type { IndexManager } from "./storage/index-manager.js";
+import type { Transaction } from "./storage/transaction.js";
+import type { PathIndex } from "./graph/index.js";
+import type { ForeignServer, ForeignTable } from "./fdw/foreign-table.js";
+import type { Vertex, Edge, DocId } from "./core/types.js";
+import type { ExecutionContext } from "./operators/base.js";
+export interface EngineOptions {
+    dbPath?: string;
+    parallelWorkers?: number;
+    spillThreshold?: number;
+}
+export declare class Engine {
+    _tables: Map<string, Table>;
+    _views: Map<string, unknown>;
+    _prepared: Map<string, unknown>;
+    _sequences: Map<string, Record<string, number>>;
+    _tempTables: Set<string>;
+    _graphStore: GraphStore;
+    _versionedGraphs: Map<string, unknown>;
+    _pathIndexes: Map<string, PathIndex>;
+    _foreignServers: Map<string, ForeignServer>;
+    _foreignTables: Map<string, ForeignTable>;
+    _models: Map<string, Record<string, unknown>>;
+    private _catalog;
+    private _indexManager;
+    private _transaction;
+    private _compiler;
+    private _dbPath;
+    private _parallelWorkers;
+    private _spillThreshold;
+    constructor(opts?: EngineOptions);
+    sql(query: string, params?: unknown[]): Promise<SQLResult | null>;
+    getTable(name: string): Table;
+    hasTable(name: string): boolean;
+    registerTable(name: string, table: Table): void;
+    addDocument(docId: DocId, document: Record<string, unknown>, table: string, embedding?: Float64Array | null): void;
+    getDocument(docId: DocId, table: string): Record<string, unknown> | null;
+    deleteDocument(docId: DocId, table: string): void;
+    getGraphStore(_table: string): GraphStore;
+    addGraphVertex(vertex: Vertex, table: string): void;
+    addGraphEdge(edge: Edge, table: string): void;
+    createGraph(name: string): GraphStore;
+    dropGraph(name: string): void;
+    getGraph(name: string): GraphStore;
+    hasGraph(name: string): boolean;
+    get graphStore(): GraphStore;
+    estimateConvWeights(table: string, edgeLabel: string, kernelHops: number, embeddingField?: string): number[];
+    saveModel(modelName: string, config: Record<string, unknown>): void;
+    loadModel(modelName: string): Record<string, unknown> | null;
+    deleteModel(modelName: string): void;
+    buildPathIndex(graphName: string, labelSequences: string[][]): void;
+    getPathIndex(graphName: string): PathIndex | null;
+    dropPathIndex(graphName: string): void;
+    createAnalyzer(name: string, config: Record<string, unknown>): void;
+    dropAnalyzer(name: string): void;
+    setTableAnalyzer(tableName: string, field: string, analyzerName: string, phase?: "index" | "search" | "both"): void;
+    getTableAnalyzer(tableName: string, field: string, phase?: "index" | "search"): unknown;
+    saveScoringParams(name: string, params: Record<string, unknown>): void;
+    loadScoringParams(name: string): Record<string, unknown> | null;
+    loadAllScoringParams(): [string, Record<string, unknown>][];
+    learnScoringParams(table: string, field: string, query: string, labels: number[], opts?: {
+        mode?: string;
+    }): Record<string, number>;
+    updateScoringParams(table: string, field: string, score: number, label: number): void;
+    vectorBackgroundStats(table: string, field: string): [number, number] | null;
+    begin(): Transaction;
+    query(table: string): QueryBuilder;
+    insert(table: string, docId: number, document: Record<string, unknown>): void;
+    get dbPath(): string | null;
+    get parallelWorkers(): number;
+    get spillThreshold(): number;
+    get compiler(): SQLCompiler;
+    get catalog(): Catalog | null;
+    get indexManager(): IndexManager | null;
+    _contextForTable(tableName: string): ExecutionContext;
+    /**
+     * Train a deep learning model on the given table data.
+     * Returns the trained model configuration.
+     */
+    deepLearn(table: string, modelName: string, config: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Run inference using a trained deep learning model.
+     */
+    deepPredict(modelName: string, inputs: Record<string, unknown>[]): Record<string, unknown>[];
+    /**
+     * Apply a batch of graph mutations (delta) atomically.
+     * Delta format: { addVertices, removeVertices, addEdges, removeEdges }
+     */
+    applyGraphDelta(graphName: string, delta: {
+        addVertices?: Vertex[];
+        removeVertices?: number[];
+        addEdges?: Edge[];
+        removeEdges?: number[];
+    }): void;
+    /**
+     * Create a versioned snapshot of a graph.
+     */
+    createGraphVersion(graphName: string, versionTag: string): void;
+    /**
+     * List all version tags for a graph.
+     */
+    graphVersions(graphName: string): string[];
+    /**
+     * Restore a graph to a specific version.
+     */
+    restoreGraphVersion(graphName: string, versionTag: string): void;
+    /**
+     * Generate a calibration report for scoring parameters.
+     * Returns statistics about the calibration quality.
+     */
+    calibrationReport(table: string, field: string): Record<string, unknown>;
+    /**
+     * Save the full engine state to the catalog for persistence.
+     * Called automatically when a catalog is available and mutations occur.
+     */
+    saveToCatalog(): void;
+    /**
+     * Load the full engine state from the catalog.
+     * Called during initialization when a catalog is available.
+     */
+    loadFromCatalog(): void;
+    close(): void;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/types/src/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/engine.ts"],"names":[],"mappings":"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"}

package/dist/types/src/execution/batch.d.ts

@@ -0,0 +1,144 @@
+export type DataType = "integer" | "float" | "text" | "boolean" | "bytes" | "unknown";
+export interface ArrowField {
+    readonly name: string;
+    readonly type: DataType;
+    readonly nullable: boolean;
+}
+export interface ArrowSchema {
+    readonly fields: readonly ArrowField[];
+}
+export declare function arrowSchema(fields: ArrowField[]): ArrowSchema;
+export declare function arrowField(name: string, type: DataType, nullable?: boolean): ArrowField;
+/**
+ * ColumnVector wraps a plain JS array with an optional selection vector.
+ * When a selection vector is present, only indices listed in the selection
+ * vector are logically valid. This avoids copying data during filter operations.
+ */
+export declare class ColumnVector {
+    readonly name: string;
+    readonly type: DataType;
+    private _data;
+    private _selection;
+    private _logicalLength;
+    constructor(name: string, type: DataType, data: unknown[], selection?: number[] | null);
+    /** Physical length of the underlying data array. */
+    get physicalLength(): number;
+    /** Logical length respecting the selection vector. */
+    get length(): number;
+    /** Whether a selection vector is active. */
+    get hasSelection(): boolean;
+    /** Access the raw data array (bypasses selection). */
+    get rawData(): unknown[];
+    /** Access the selection vector, or null if none. */
+    get selection(): number[] | null;
+    /**
+     * Get the value at logical index i.
+     * If a selection vector is present, maps through it.
+     */
+    get(i: number): unknown;
+    /**
+     * Return a new ColumnVector with an applied selection vector.
+     * The resulting selection vector is composed with any existing selection.
+     */
+    withSelection(indices: number[]): ColumnVector;
+    /**
+     * Compact the column vector by materializing only the selected rows
+     * into a new contiguous array. Removes the selection vector.
+     */
+    compact(): ColumnVector;
+    /**
+     * Convert to a plain array respecting selection.
+     */
+    toArray(): unknown[];
+    /**
+     * Create a ColumnVector from a typed Float64Array (for numeric columns).
+     */
+    static fromFloat64Array(name: string, arr: Float64Array): ColumnVector;
+    /**
+     * Create a ColumnVector from a string array.
+     */
+    static fromStrings(name: string, arr: string[]): ColumnVector;
+}
+/**
+ * Columnar batch: a collection of named columns, each represented as a plain
+ * JS array. All columns share the same logical length.
+ */
+export declare class Batch {
+    private _columns;
+    private _length;
+    constructor(data: Map<string, unknown[]>, length: number);
+    /**
+     * Build a Batch from an array of row objects.
+     * If schema is provided, columns are created in schema order; otherwise
+     * columns are derived from the union of all row keys.
+     */
+    static fromRows(rows: Record<string, unknown>[], schema?: Map<string, DataType>): Batch;
+    /** Number of rows in this batch. */
+    get length(): number;
+    /** Ordered column names. */
+    get columnNames(): string[];
+    /**
+     * Return the column array for the given name.
+     * Throws if the column does not exist.
+     */
+    column(name: string): unknown[];
+    /**
+     * Return the column array for the given name, or null if missing.
+     */
+    getColumn(name: string): unknown[] | null;
+    /**
+     * Convert the columnar batch back into an array of row objects.
+     */
+    toRows(): Record<string, unknown>[];
+    /**
+     * Return a new Batch containing rows [offset, offset + length).
+     */
+    slice(offset: number, length: number): Batch;
+    /**
+     * Return a new Batch with only the specified columns, optionally renaming
+     * them via the aliases map (original -> alias).
+     */
+    selectColumns(columns: string[], aliases?: Map<string, string>): Batch;
+    /**
+     * Return a new Batch containing only the rows at the given indices.
+     */
+    take(indices: number[]): Batch;
+    /**
+     * Add a new column to this batch (mutating).
+     * The array must have the same length as existing columns.
+     */
+    addColumn(name: string, data: unknown[]): void;
+    /**
+     * Remove a column from this batch (mutating).
+     */
+    removeColumn(name: string): void;
+    /**
+     * Rename a column (mutating).
+     */
+    renameColumn(oldName: string, newName: string): void;
+    /**
+     * Return true if this batch has a column with the given name.
+     */
+    hasColumn(name: string): boolean;
+    /**
+     * Concatenate rows from another batch (same schema assumed).
+     */
+    concat(other: Batch): Batch;
+    /**
+     * Return a new empty Batch with the same column names.
+     */
+    empty(): Batch;
+    /**
+     * Build a Batch from ColumnVector instances.
+     */
+    static fromColumnVectors(vectors: ColumnVector[]): Batch;
+    /**
+     * Convert this Batch to an array of ColumnVector instances.
+     */
+    toColumnVectors(): ColumnVector[];
+    /**
+     * Build an ArrowSchema from this Batch's column types.
+     */
+    inferSchema(): ArrowSchema;
+}
+//# sourceMappingURL=batch.d.ts.map

package/dist/types/src/execution/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../../../src/execution/batch.ts"],"names":[],"mappings":"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"}

package/dist/types/src/execution/physical.d.ts

@@ -0,0 +1,18 @@
+import type { Batch } from "./batch.js";
+/**
+ * Abstract base class for Volcano-model physical operators.
+ *
+ * Each operator implements `open()`, `next()`, and `close()`.
+ * - `open()` initializes state (e.g. opens child iterators).
+ * - `next()` returns the next Batch, or null when exhausted.
+ * - `close()` releases resources.
+ */
+export declare abstract class PhysicalOperator {
+    /** Initialize the operator and its children. */
+    abstract open(): void;
+    /** Return the next batch of rows, or null if exhausted. */
+    abstract next(): Batch | null;
+    /** Release all resources. */
+    abstract close(): void;
+}
+//# sourceMappingURL=physical.d.ts.map

package/dist/types/src/execution/physical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"physical.d.ts","sourceRoot":"","sources":["../../../../src/execution/physical.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;GAOG;AACH,8BAAsB,gBAAgB;IACpC,gDAAgD;IAChD,QAAQ,CAAC,IAAI,IAAI,IAAI;IAErB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,IAAI,KAAK,GAAG,IAAI;IAE7B,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,IAAI,IAAI;CACvB"}

package/dist/types/src/execution/relational.d.ts

@@ -0,0 +1,174 @@
+import type { Predicate } from "../core/types.js";
+import { ExprEvaluator } from "../sql/expr-evaluator.js";
+import { Batch } from "./batch.js";
+import { PhysicalOperator } from "./physical.js";
+export interface WindowSpec {
+    readonly outputCol: string;
+    readonly funcName: string;
+    readonly partitionBy: string[];
+    readonly orderBy: SortKey[];
+    readonly inputCol?: string;
+    readonly lagLeadOffset?: number;
+    readonly lagLeadDefault?: unknown;
+    readonly ntileBuckets?: number;
+    readonly frameStart?: string | null;
+    readonly frameEnd?: string | null;
+    readonly frameStartOffset?: number;
+    readonly frameEndOffset?: number;
+    readonly frameType?: string;
+    readonly filterNode?: Record<string, unknown>;
+}
+export declare class FilterOp extends PhysicalOperator {
+    private readonly _child;
+    private readonly _column;
+    private readonly _predicate;
+    constructor(child: PhysicalOperator, column: string, predicate: Predicate);
+    open(): void;
+    next(): Batch | null;
+    close(): void;
+}
+export declare class ExprFilterOp extends PhysicalOperator {
+    private readonly _child;
+    private readonly _exprNode;
+    private readonly _evaluator;
+    constructor(child: PhysicalOperator, exprNode: Record<string, unknown>, evaluator?: ExprEvaluator);
+    open(): void;
+    next(): Batch | null;
+    close(): void;
+}
+export declare class ProjectOp extends PhysicalOperator {
+    private readonly _child;
+    private readonly _columns;
+    private readonly _aliases;
+    constructor(child: PhysicalOperator, columns: string[], aliases?: Map<string, string>);
+    open(): void;
+    next(): Batch | null;
+    close(): void;
+}
+export interface ExprProjectSpec {
+    readonly outputCol: string;
+    readonly exprNode: Record<string, unknown>;
+}
+export declare class ExprProjectOp extends PhysicalOperator {
+    private readonly _child;
+    private readonly _specs;
+    private readonly _evaluator;
+    constructor(child: PhysicalOperator, specs: ExprProjectSpec[], evaluator?: ExprEvaluator);
+    open(): void;
+    next(): Batch | null;
+    /**
+     * Attempt vectorized column copy for simple ColumnRef-only projections.
+     * Returns null if any spec is not a simple column reference.
+     */
+    private _tryVectorized;
+    /**
+     * Extract a simple column name from a ColumnRef AST node.
+     * Returns null if the node is not a simple ColumnRef.
+     */
+    private _extractColumnName;
+    close(): void;
+}
+export interface SortKey {
+    readonly column: string;
+    readonly ascending: boolean;
+    readonly nullsFirst: boolean;
+}
+export declare class SortOp extends PhysicalOperator {
+    private readonly _child;
+    private readonly _sortKeys;
+    private _sorted;
+    private _index;
+    private readonly _batchSize;
+    private readonly _spillThreshold;
+    private _spillManager;
+    constructor(child: PhysicalOperator, sortKeys: SortKey[], batchSize?: number, spillThreshold?: number);
+    open(): void;
+    /**
+     * External merge sort: read child in chunks of _spillThreshold rows,
+     * sort each chunk in memory, spill to SpillManager, then k-way merge
+     * all sorted runs.
+     */
+    private _externalMergeSort;
+    next(): Batch | null;
+    close(): void;
+    static _sortRows(rows: Record<string, unknown>[], sortKeys: SortKey[]): void;
+    private _compare;
+}
+export declare class LimitOp extends PhysicalOperator {
+    private readonly _child;
+    private readonly _limit;
+    private readonly _offset;
+    private _emitted;
+    private _skipped;
+    constructor(child: PhysicalOperator, limit: number, offset?: number);
+    open(): void;
+    next(): Batch | null;
+    close(): void;
+}
+export interface AggregateSpec {
+    readonly outputCol: string;
+    readonly funcName: string;
+    readonly inputCol?: string;
+    readonly distinct?: boolean;
+    readonly extra?: unknown;
+    readonly filterNode?: Record<string, unknown>;
+    readonly orderKeys?: [string, boolean][];
+}
+export declare class HashAggOp extends PhysicalOperator {
+    private readonly _child;
+    private readonly _groupByCols;
+    private readonly _aggSpecs;
+    private readonly _groupAliases;
+    private _result;
+    private _index;
+    private readonly _batchSize;
+    private readonly _spillThreshold;
+    private _filterEvaluator;
+    private static readonly NUM_PARTITIONS;
+    constructor(child: PhysicalOperator, groupByCols: string[], aggSpecs: AggregateSpec[], opts?: {
+        batchSize?: number;
+        groupAliases?: Map<string, string>;
+        spillThreshold?: number;
+    });
+    open(): void;
+    /**
+     * 16-partition spill strategy for large aggregations.
+     * Hash-partition rows into 16 buckets, aggregate each bucket independently,
+     * then combine results.
+     */
+    private _aggregateWithSpill;
+    /**
+     * Simple string hash for partitioning.
+     */
+    private static _hashString;
+    private _canStream;
+    private _aggregateStreaming;
+    private _aggregateMaterialized;
+    next(): Batch | null;
+    close(): void;
+}
+export declare class DistinctOp extends PhysicalOperator {
+    private readonly _child;
+    private readonly _columns;
+    private readonly _spillThreshold;
+    private _seen;
+    private _spillPartitions;
+    private static readonly NUM_PARTITIONS;
+    constructor(child: PhysicalOperator, columns: string[], spillThreshold?: number);
+    open(): void;
+    next(): Batch | null;
+    private static _hashKey;
+    close(): void;
+}
+export declare class WindowOp extends PhysicalOperator {
+    private readonly _child;
+    private readonly _windowSpecs;
+    private _result;
+    private _index;
+    private readonly _batchSize;
+    constructor(child: PhysicalOperator, windowSpecs: WindowSpec[], batchSize?: number);
+    open(): void;
+    next(): Batch | null;
+    close(): void;
+}
+//# sourceMappingURL=relational.d.ts.map

package/dist/types/src/execution/relational.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relational.d.ts","sourceRoot":"","sources":["../../../../src/execution/relational.ts"],"names":[],"mappings":"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"}

package/dist/types/src/execution/scan.d.ts

@@ -0,0 +1,41 @@
+import type { PostingList } from "../core/posting-list.js";
+import type { DocumentStore } from "../storage/abc/document-store.js";
+import { Batch } from "./batch.js";
+import { PhysicalOperator } from "./physical.js";
+export declare class SeqScanOp extends PhysicalOperator {
+    private readonly _store;
+    private readonly _columns;
+    private _iterator;
+    private _batchSize;
+    /**
+     * @param store    The document store to scan.
+     * @param columns  If provided, only these columns are emitted.
+     *                 null means all columns present in the document.
+     * @param batchSize Number of rows per batch (default 1024).
+     */
+    constructor(store: DocumentStore, columns?: string[] | null, batchSize?: number);
+    open(): void;
+    next(): Batch | null;
+    close(): void;
+}
+export declare class PostingListScanOp extends PhysicalOperator {
+    private readonly _postingList;
+    private readonly _store;
+    private readonly _columns;
+    private _index;
+    private _batchSize;
+    /**
+     * @param postingList The posting list to scan.
+     * @param store       If provided, row fields are enriched from the
+     *                    document store. Otherwise only docId and score
+     *                    are emitted.
+     * @param columns     If provided with a store, only these columns are
+     *                    fetched.
+     * @param batchSize   Number of rows per batch (default 1024).
+     */
+    constructor(postingList: PostingList, store?: DocumentStore | null, columns?: string[] | null, batchSize?: number);
+    open(): void;
+    next(): Batch | null;
+    close(): void;
+}
+//# sourceMappingURL=scan.d.ts.map

package/dist/types/src/execution/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../../src/execution/scan.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAMjD,qBAAa,SAAU,SAAQ,gBAAgB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,SAAS,CAAmE;IACpF,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;OAKG;gBACS,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,SAAO;IAO7E,IAAI,IAAI,IAAI;IAIZ,IAAI,IAAI,KAAK,GAAG,IAAI;IA6BpB,KAAK,IAAI,IAAI;CAGd;AAOD,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;OAQG;gBAED,WAAW,EAAE,WAAW,EACxB,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,EAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EACzB,SAAS,SAAO;IASlB,IAAI,IAAI,IAAI;IAIZ,IAAI,IAAI,KAAK,GAAG,IAAI;IAoDpB,KAAK,IAAI,IAAI;CAGd"}

package/dist/types/src/execution/spill.d.ts

@@ -0,0 +1,39 @@
+export declare class SpillManager {
+    private _runs;
+    /** Allocate a new run buffer. Returns the run index. */
+    newRun(): number;
+    /** Return a new SpillWriter backed by a new run. */
+    newWriter(): SpillWriter;
+    /** Append rows to an existing run. */
+    writeRows(runIdx: number, rows: Record<string, unknown>[]): void;
+    /** Read all rows from a run. */
+    readRows(runIdx: number): Record<string, unknown>[];
+    /** Return the number of runs. */
+    get runCount(): number;
+    /** Release all spill memory. */
+    cleanup(): void;
+}
+export declare class SpillWriter {
+    private _manager;
+    private _runIdx;
+    private _rowCount;
+    constructor(manager: SpillManager, runIdx: number);
+    get runIdx(): number;
+    get rowCount(): number;
+    writeRows(rows: Record<string, unknown>[]): void;
+    close(): void;
+}
+/**
+ * Merge multiple pre-sorted runs into a single sorted array.
+ *
+ * Uses a simple k-way merge with a linear scan to find the minimum at each
+ * step. For the expected number of runs (typically 2-8), this is efficient
+ * enough; a heap-based approach can be added for very large k values.
+ *
+ * @param runs     Array of sorted run arrays.
+ * @param sortKeys Array of [column, ascending] pairs.
+ * @returns        Merged sorted array.
+ */
+export type SortKeySpec = [string, boolean] | [string, boolean, boolean];
+export declare function mergeSortedRuns(runs: Record<string, unknown>[][], sortKeys: SortKeySpec[]): Record<string, unknown>[];
+//# sourceMappingURL=spill.d.ts.map

package/dist/types/src/execution/spill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spill.d.ts","sourceRoot":"","sources":["../../../../src/execution/spill.ts"],"names":[],"mappings":"AAoBA,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAmC;IAEhD,wDAAwD;IACxD,MAAM,IAAI,MAAM;IAMhB,oDAAoD;IACpD,SAAS,IAAI,WAAW;IAKxB,sCAAsC;IACtC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI;IAUhE,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAQnD,iCAAiC;IACjC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,gCAAgC;IAChC,OAAO,IAAI,IAAI;CAGhB;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM;IAMjD,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI;IAMhD,KAAK,IAAI,IAAI;CAGd;AAMD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAEzE,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EACjC,QAAQ,EAAE,WAAW,EAAE,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAiC3B"}

package/dist/types/src/fdw/arrow-handler.d.ts

@@ -0,0 +1,28 @@
+import type { FDWPredicate } from "./handler.js";
+import { FDWHandler } from "./handler.js";
+import type { ForeignServer } from "./foreign-table.js";
+import type { ForeignTable } from "./foreign-table.js";
+export declare class ArrowFDWHandler extends FDWHandler {
+    private _server;
+    private _cachedData;
+    private _arrowLib;
+    constructor(server: ForeignServer);
+    get server(): ForeignServer;
+    /**
+     * Attempt to load the apache-arrow library dynamically.
+     */
+    private _loadArrowLib;
+    /**
+     * Convert Arrow table/RecordBatch to plain row objects.
+     */
+    private _arrowTableToRows;
+    /**
+     * Load data from the Arrow source specified in server options.
+     * Supports 'data' option (JSON-encoded rows for testing) and
+     * 'buffer' option (base64-encoded Arrow IPC buffer).
+     */
+    private _loadData;
+    scan(foreignTable: ForeignTable, columns?: string[] | null, predicates?: FDWPredicate[] | null, limit?: number | null): Record<string, unknown>[];
+    close(): void;
+}
+//# sourceMappingURL=arrow-handler.d.ts.map

package/dist/types/src/fdw/arrow-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrow-handler.d.ts","sourceRoot":"","sources":["../../../../src/fdw/arrow-handler.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA4EvD,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,SAAS,CAAU;gBAEf,MAAM,EAAE,aAAa;IAOjC,IAAI,MAAM,IAAI,aAAa,CAE1B;IAED;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAmCjB,IAAI,CACF,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EACzB,UAAU,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,EAClC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAK5B,KAAK,IAAI,IAAI;CAId"}

package/dist/types/src/fdw/duckdb-handler.d.ts

@@ -0,0 +1,32 @@
+import type { FDWPredicate } from "./handler.js";
+import { FDWHandler } from "./handler.js";
+import type { ForeignServer } from "./foreign-table.js";
+import type { ForeignTable } from "./foreign-table.js";
+export declare class DuckDBFDWHandler extends FDWHandler {
+    private _server;
+    private _db;
+    private _conn;
+    private _duckdbLib;
+    constructor(server: ForeignServer);
+    get server(): ForeignServer;
+    /**
+     * Attempt to load @duckdb/duckdb-wasm dynamically.
+     */
+    private _loadDuckDB;
+    /**
+     * Build the SQL query string with pushdown predicates, column projection, and limit.
+     */
+    private _buildQuery;
+    /**
+     * Convert DuckDB query result to plain row objects.
+     */
+    private _resultToRows;
+    scan(foreignTable: ForeignTable, columns?: string[] | null, predicates?: FDWPredicate[] | null, limit?: number | null): Record<string, unknown>[];
+    /**
+     * Initialize the DuckDB WASM connection asynchronously.
+     * Must be called before scan() when using actual DuckDB.
+     */
+    initAsync(): Promise<void>;
+    close(): void;
+}
+//# sourceMappingURL=duckdb-handler.d.ts.map

package/dist/types/src/fdw/duckdb-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-handler.d.ts","sourceRoot":"","sources":["../../../../src/fdw/duckdb-handler.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAkEvD,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,UAAU,CAAU;gBAEhB,MAAM,EAAE,aAAa;IAQjC,IAAI,MAAM,IAAI,aAAa,CAE1B;IAED;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAkBnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmCrB,IAAI,CACF,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EACzB,UAAU,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,EAClC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IA0E5B;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAqChC,KAAK,IAAI,IAAI;CAiBd"}