@c9up/eon 0.1.0

package/dist/schema/sync.js

@@ -0,0 +1,102 @@
+/**
+ * Schema facade — drive TDengine DDL from decorator metadata through a live
+ * `EonConnection`. Agnostic leaf: takes the connection structurally, never
+ * imports `@c9up/ream`.
+ *
+ * Every statement is compiled in Rust (`compileStatementNative`) and run through
+ * the literal-only `EonConnection.exec` (58.2 D3). Child-table creation renders
+ * its tag values as inlined SQL literals (`literal: true`, D4) so `exec` can run
+ * it directly; the `?`-bound STMT form lands with ingest in 58.4.
+ */
+import { compileStatementNative } from "../query/native.js";
+import { compileCreateStableSpec, requireSuperTableName, } from "./compile.js";
+/** Compile a spec and run each resulting statement through the connection. */
+async function execSpec(conn, spec) {
+    const { statements } = compileStatementNative(spec, "tdengine");
+    for (const sql of statements) {
+        await conn.exec(sql);
+    }
+}
+/** Create the super-table for a decorated class (`CREATE STABLE IF NOT EXISTS`). */
+export function syncSuperTable(conn, EntityClass) {
+    const spec = { ...compileCreateStableSpec(EntityClass), ifNotExists: true };
+    return execSpec(conn, spec);
+}
+/**
+ * Create an explicit child table bound to its super-table's tag values
+ * (`CREATE TABLE name USING stable TAGS (...)`). Tag values are inlined as typed
+ * SQL literals (D4).
+ */
+export function createChildTable(conn, options) {
+    const using = resolveStableName(options);
+    const spec = {
+        kind: "createChildTable",
+        name: options.name,
+        using,
+        tags: options.tags,
+        ifNotExists: options.ifNotExists ?? true,
+        literal: true,
+    };
+    return execSpec(conn, spec);
+}
+/** Drop the super-table for a decorated class (`DROP STABLE IF EXISTS`). */
+export function dropSuperTable(conn, EntityClass) {
+    const spec = {
+        kind: "dropStable",
+        name: requireSuperTableName(EntityClass),
+        ifExists: true,
+    };
+    return execSpec(conn, spec);
+}
+/**
+ * A deterministic child-table name for a stable + tag-set, so the same tags
+ * always map to the same child (idempotent create, stable routing for 58.4
+ * ingest). Dependency-free FNV-1a — no `crypto`, no npm dep (D6). Pass an
+ * explicit `name` to {@link createChildTable} to override.
+ */
+export function childTableName(stableOrEntity, tagValues) {
+    const stable = typeof stableOrEntity === "string"
+        ? stableOrEntity
+        : requireSuperTableName(stableOrEntity);
+    const key = [stable, ...tagValues.map(stringifyTagValue)].join("\u0000");
+    return `t_${fnv1a(key)}`;
+}
+function resolveStableName(options) {
+    if (typeof options.stable === "string" && options.stable.length > 0) {
+        return options.stable;
+    }
+    if (options.EntityClass) {
+        return requireSuperTableName(options.EntityClass);
+    }
+    throw new Error("[E_EON_CHILD_STABLE] createChildTable requires either `stable` (name) or `EntityClass`");
+}
+/**
+ * A tag value's stable string form for the child-name key. `JSON.stringify`
+ * throws on a `bigint` (`TypeError: Do not know how to serialize a BigInt`),
+ * which would surface as an opaque crash for any BIGINT `@Tag`; render bigints
+ * explicitly so every tag type maps to a deterministic, typed-out string.
+ */
+export function stringifyTagValue(value) {
+    if (typeof value === "bigint")
+        return `${value}n`;
+    return JSON.stringify(value) ?? "null";
+}
+/**
+ * 64-bit FNV-1a over UTF-16 code units → zero-padded 16-char hex. 64 bits keeps
+ * the child-name collision probability negligible even at millions of distinct
+ * tag-sets; a 32-bit space collides ~50% by only ~77k children (realistic
+ * per-device TSDB cardinality), which would silently write one device's rows
+ * under another's tags. `groupByChild` additionally asserts no two distinct
+ * tag-sets ever share a name.
+ */
+function fnv1a(input) {
+    const MASK = (1n << 64n) - 1n;
+    const PRIME = 0x00000100000001b3n;
+    let hash = 0xcbf29ce484222325n;
+    for (let i = 0; i < input.length; i++) {
+        hash = (hash ^ BigInt(input.charCodeAt(i))) & MASK;
+        hash = (hash * PRIME) & MASK;
+    }
+    return hash.toString(16).padStart(16, "0");
+}
+//# sourceMappingURL=sync.js.map

package/dist/schema/sync.js.map

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

package/dist/services/connection.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Default `connection` singleton — ergonomic access to the configured eon
+ * connection from anywhere, mirroring `@c9up/atlas/services/db`.
+ *
+ *   import connection from '@c9up/eon/services/connection'
+ *
+ *   const rows = await connection.query('SELECT server_version()')
+ *
+ * Populated by `EonProvider.boot()`. The instance is whatever
+ * `timeseries.connections[default]` resolves to — a ws `EonConnection` today, a
+ * future native impl behind the same seam tomorrow.
+ */
+import type { EonConnection } from "../connection/EonConnection.js";
+/** @internal Bind the singleton (called by EonProvider.boot). */
+export declare function setConnection(connection: EonConnection): void;
+/**
+ * @internal Unbind the singleton IF it still points at `connection` (called by
+ * EonProvider.shutdown). Ownership-guarded: when a second provider rebound the
+ * singleton, an older provider's shutdown must not clear the newer binding —
+ * otherwise `connection.*` after shutdown would dereference a closed handle.
+ */
+export declare function clearConnection(connection: EonConnection): void;
+/** @internal Read the singleton (or `undefined` pre-boot). */
+export declare function getConnection(): EonConnection | undefined;
+/**
+ * Forwards each `EonConnection` member to the bound instance (throwing until
+ * boot binds it). A plain forwarding object rather than a `Proxy` keeps the
+ * generic `query<T>` typed and cast-free (AC9) — the seam surface is small and
+ * explicit.
+ */
+declare const connection: EonConnection;
+export default connection;
+//# sourceMappingURL=connection.d.ts.map

package/dist/services/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/services/connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAEX,aAAa,EAEb,MAAM,gCAAgC,CAAC;AAIxC,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI,CAE/D;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,IAAI,aAAa,GAAG,SAAS,CAEzD;AAcD;;;;;GAKG;AACH,QAAA,MAAM,UAAU,EAAE,aA2BjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/services/connection.js

@@ -0,0 +1,71 @@
+/**
+ * Default `connection` singleton — ergonomic access to the configured eon
+ * connection from anywhere, mirroring `@c9up/atlas/services/db`.
+ *
+ *   import connection from '@c9up/eon/services/connection'
+ *
+ *   const rows = await connection.query('SELECT server_version()')
+ *
+ * Populated by `EonProvider.boot()`. The instance is whatever
+ * `timeseries.connections[default]` resolves to — a ws `EonConnection` today, a
+ * future native impl behind the same seam tomorrow.
+ */
+let instance;
+/** @internal Bind the singleton (called by EonProvider.boot). */
+export function setConnection(connection) {
+    instance = connection;
+}
+/**
+ * @internal Unbind the singleton IF it still points at `connection` (called by
+ * EonProvider.shutdown). Ownership-guarded: when a second provider rebound the
+ * singleton, an older provider's shutdown must not clear the newer binding —
+ * otherwise `connection.*` after shutdown would dereference a closed handle.
+ */
+export function clearConnection(connection) {
+    if (instance === connection)
+        instance = undefined;
+}
+/** @internal Read the singleton (or `undefined` pre-boot). */
+export function getConnection() {
+    return instance;
+}
+/** The bound connection, or a descriptive throw if accessed before boot. */
+function requireInstance() {
+    if (!instance) {
+        throw new Error("[eon] connection singleton accessed before EonProvider.boot() ran. " +
+            "Check that `@c9up/eon/provider` is listed in your reamrc.ts providers " +
+            "and that `config/timeseries.ts` defines at least one connection.");
+    }
+    return instance;
+}
+/**
+ * Forwards each `EonConnection` member to the bound instance (throwing until
+ * boot binds it). A plain forwarding object rather than a `Proxy` keeps the
+ * generic `query<T>` typed and cast-free (AC9) — the seam surface is small and
+ * explicit.
+ */
+const connection = {
+    get transport() {
+        return requireInstance().transport;
+    },
+    exec(sql) {
+        return requireInstance().exec(sql);
+    },
+    query(sql) {
+        return requireInstance().query(sql);
+    },
+    ping() {
+        return requireInstance().ping();
+    },
+    ingestColumnar(request) {
+        return requireInstance().ingestColumnar(request);
+    },
+    schemaless(lines, options) {
+        return requireInstance().schemaless(lines, options);
+    },
+    close() {
+        return requireInstance().close();
+    },
+};
+export default connection;
+//# sourceMappingURL=connection.js.map

package/dist/services/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/services/connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,IAAI,QAAmC,CAAC;AAExC,iEAAiE;AACjE,MAAM,UAAU,aAAa,CAAC,UAAyB;IACtD,QAAQ,GAAG,UAAU,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,UAAyB;IACxD,IAAI,QAAQ,KAAK,UAAU;QAAE,QAAQ,GAAG,SAAS,CAAC;AACnD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa;IAC5B,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,4EAA4E;AAC5E,SAAS,eAAe;IACvB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACd,qEAAqE;YACpE,wEAAwE;YACxE,kEAAkE,CACnE,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,GAAkB;IACjC,IAAI,SAAS;QACZ,OAAO,eAAe,EAAE,CAAC,SAAS,CAAC;IACpC,CAAC;IACD,IAAI,CAAC,GAAW;QACf,OAAO,eAAe,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,CAA8B,GAAW;QAC7C,OAAO,eAAe,EAAE,CAAC,KAAK,CAAI,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,IAAI;QACH,OAAO,eAAe,EAAE,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IACD,cAAc,CACb,OAA0B;QAE1B,OAAO,eAAe,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IACD,UAAU,CACT,KAAwB,EACxB,OAA8B;QAE9B,OAAO,eAAe,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IACD,KAAK;QACJ,OAAO,eAAe,EAAE,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;CACD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/testing/Factory.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `factory` / `FactoryBuilder` — Lucid/atlas-shaped test-data factory for
+ * time-series points (58.6), mirroring atlas `testing/Factory.ts`.
+ *
+ * Named states, ad-hoc merges, stubbing (build without persisting), and a
+ * minimal `create`/`createMany` that persists through a literal `INSERT` via
+ * `EonConnection.exec` — working against a {@link FakeEonConnection} OR a real
+ * one. Hydration resolves columns/tags via the 58.3 metadata getters, NEVER
+ * `key in instance` (the `@Column() declare x` pitfall, memory
+ * `project_atlas_declare_hydration`).
+ *
+ * Named boundary: `create()` is a TEST-ONLY insert, NOT the 58.4
+ * `SuperTableRepository` ingest API — the two coexist (the factory stays
+ * test-scoped) once a live repository is in play.
+ */
+import type { EonConnection } from "../connection/EonConnection.js";
+/** A concrete, `@SuperTable`-decorated point class (has a no-arg constructor). */
+type PointConstructor<T extends object> = (new () => T) & {
+    readonly name: string;
+};
+/** A named state — mutates an in-progress data object in place. */
+type StateFn = (data: Record<string, unknown>) => void;
+export interface FactoryBuilder<T extends object> {
+    /** Override fields for the NEXT build (reset after consumption). */
+    merge(overrides: Record<string, unknown>): FactoryBuilder<T>;
+    /** Declare a named variation, stored on the factory's state map. */
+    state(name: string, fn: StateFn): FactoryBuilder<T>;
+    /** Activate declared states for the NEXT build (compose in order; reset after). */
+    apply(...names: string[]): FactoryBuilder<T>;
+    /** Build a data object without persisting or instantiating. */
+    make(): Record<string, unknown>;
+    /** Build `count` data objects without persisting. */
+    makeMany(count: number): Record<string, unknown>[];
+    /** Build an INSTANCE without persisting (Lucid `makeStubbed`). */
+    makeStubbed(): T;
+    /** Build + persist a single point through `conn.exec` (literal INSERT). */
+    create(conn: EonConnection): Promise<T>;
+    /** Build + persist `count` points. */
+    createMany(count: number, conn: EonConnection): Promise<T[]>;
+}
+export declare function factory<T extends object>(EntityClass: PointConstructor<T>, defaults: () => Record<string, unknown>): FactoryBuilder<T>;
+export {};
+//# sourceMappingURL=Factory.d.ts.map

package/dist/testing/Factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.d.ts","sourceRoot":"","sources":["../../src/testing/Factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAapE,kFAAkF;AAClF,KAAK,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,mEAAmE;AACnE,KAAK,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAEvD,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM;IAC/C,oEAAoE;IACpE,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC7D,oEAAoE;IACpE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACpD,mFAAmF;IACnF,KAAK,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC7C,+DAA+D;IAC/D,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACnD,kEAAkE;IAClE,WAAW,IAAI,CAAC,CAAC;IACjB,2EAA2E;IAC3E,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxC,sCAAsC;IACtC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CAC7D;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EACvC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAChC,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,cAAc,CAAC,CAAC,CAAC,CA8HnB"}

package/dist/testing/Factory.js

@@ -0,0 +1,134 @@
+/**
+ * `factory` / `FactoryBuilder` — Lucid/atlas-shaped test-data factory for
+ * time-series points (58.6), mirroring atlas `testing/Factory.ts`.
+ *
+ * Named states, ad-hoc merges, stubbing (build without persisting), and a
+ * minimal `create`/`createMany` that persists through a literal `INSERT` via
+ * `EonConnection.exec` — working against a {@link FakeEonConnection} OR a real
+ * one. Hydration resolves columns/tags via the 58.3 metadata getters, NEVER
+ * `key in instance` (the `@Column() declare x` pitfall, memory
+ * `project_atlas_declare_hydration`).
+ *
+ * Named boundary: `create()` is a TEST-ONLY insert, NOT the 58.4
+ * `SuperTableRepository` ingest API — the two coexist (the factory stays
+ * test-scoped) once a live repository is in play.
+ */
+import { getColumnMetadata, getTagMetadata, getTimestampColumn, } from "../decorators/superTable.js";
+import { compileStatementNative } from "../query/native.js";
+import { orderTimestampFirst, requireSuperTableName, } from "../schema/compile.js";
+import { childTableName } from "../schema/sync.js";
+export function factory(EntityClass, defaults) {
+    const states = new Map();
+    let pendingOverrides = {};
+    let pendingStates = [];
+    const buildData = () => {
+        const data = {
+            ...defaults(),
+            ...pendingOverrides,
+        };
+        for (const name of pendingStates) {
+            const fn = states.get(name);
+            if (!fn) {
+                throw new Error(`[E_EON_FACTORY_STATE] state '${name}' is not defined on ${EntityClass.name}Factory`);
+            }
+            fn(data);
+        }
+        return data;
+    };
+    const resetPending = () => {
+        pendingOverrides = {};
+        pendingStates = [];
+    };
+    /** Hydrate an instance from data, assigning only declared columns/tags. */
+    const hydrate = (data) => {
+        const instance = new EntityClass();
+        const known = new Set([
+            ...getColumnMetadata(EntityClass).map((c) => c.propertyKey),
+            ...getTagMetadata(EntityClass).map((t) => t.propertyKey),
+        ]);
+        const assignable = {};
+        for (const key of known) {
+            if (key in data)
+                assignable[key] = data[key];
+        }
+        Object.assign(instance, assignable);
+        return instance;
+    };
+    const persist = async (conn, data) => {
+        const stable = requireSuperTableName(EntityClass);
+        const tsProperty = getTimestampColumn(EntityClass);
+        if (tsProperty === undefined) {
+            throw new Error(`[E_EON_NO_TIMESTAMP] super-table '${stable}' has no @Timestamp column`);
+        }
+        const columns = getColumnMetadata(EntityClass);
+        const tsColumn = columns.find((c) => c.propertyKey === tsProperty);
+        if (tsColumn === undefined) {
+            throw new Error(`[E_EON_NO_TIMESTAMP] super-table '${stable}' @Timestamp column '${tsProperty}' is not registered`);
+        }
+        const ordered = orderTimestampFirst(columns, tsColumn, tsProperty);
+        const tags = getTagMetadata(EntityClass);
+        const tagValues = tags.map((t) => data[t.propertyKey] ?? null);
+        const table = childTableName(stable, tagValues);
+        const row = ordered.map((c) => data[c.propertyKey] ?? null);
+        const { statements } = compileStatementNative({
+            kind: "insert",
+            table,
+            using: stable,
+            tags: tagValues,
+            columns: ordered.map((c) => c.propertyKey),
+            rows: [row],
+            literal: true,
+        }, "tdengine");
+        for (const sql of statements)
+            await conn.exec(sql);
+        return hydrate(data);
+    };
+    const builder = {
+        merge(overrides) {
+            pendingOverrides = { ...pendingOverrides, ...overrides };
+            return builder;
+        },
+        state(name, fn) {
+            states.set(name, fn);
+            return builder;
+        },
+        apply(...names) {
+            pendingStates.push(...names);
+            return builder;
+        },
+        make() {
+            const data = buildData();
+            resetPending();
+            return data;
+        },
+        makeMany(count) {
+            const rows = [];
+            for (let i = 0; i < count; i++)
+                rows.push(buildData());
+            resetPending();
+            return rows;
+        },
+        makeStubbed() {
+            const data = buildData();
+            resetPending();
+            return hydrate(data);
+        },
+        async create(conn) {
+            const data = buildData();
+            resetPending();
+            return persist(conn, data);
+        },
+        async createMany(count, conn) {
+            const rows = [];
+            for (let i = 0; i < count; i++)
+                rows.push(buildData());
+            resetPending();
+            const created = [];
+            for (const data of rows)
+                created.push(await persist(conn, data));
+            return created;
+        },
+    };
+    return builder;
+}
+//# sourceMappingURL=Factory.js.map

package/dist/testing/Factory.js.map

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

package/dist/testing/FakeEonConnection.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `FakeEonConnection` — a hand-rolled in-memory `EonConnection` for fast,
+ * deterministic unit tests without a live TDengine (58.6). The atlas analogue is
+ * a REAL in-memory SQLite (`testing/TestDatabase.ts`); TDengine has no embeddable
+ * engine, so this is a deliberately narrow test double, NOT a SQL engine.
+ *
+ * ── Scope (named boundary) ─────────────────────────────────────────────────
+ *  - `exec(sql)` RECORDS every statement (assertable via {@link statements}) and,
+ *    for recognised `CREATE TABLE`/`CREATE STABLE`/`INSERT` forms, updates a
+ *    per-table row store.
+ *  - `query(sql)` answers ONLY flat `SELECT [cols] FROM t [WHERE col <op> val]
+ *    [LIMIT n]`. Windowed / aggregate SQL (`INTERVAL`/`FILL`/`PARTITION BY`/
+ *    `avg(...)`) is NOT interpreted — it throws `E_EON_FAKE_UNSUPPORTED` pointing
+ *    the caller to the docker integration harness (`describeIfTdengine`).
+ *  - `ingestColumnar`/`schemaless` are STMT/line-protocol paths that need a live
+ *    connector — they throw `E_EON_FAKE_UNSUPPORTED`. (The 58.6 factory persists
+ *    through literal `exec` INSERTs, which the store DOES handle.)
+ *  - `ping()`/`close()` are no-ops.
+ */
+import type { EonColumnarIngest, EonConnection, EonSchemalessOptions } from "../connection/EonConnection.js";
+type Row = Record<string, unknown>;
+export declare class FakeEonConnection implements EonConnection {
+    #private;
+    readonly transport: "fake";
+    /** Every `exec`ed statement, in order — assert against this in tests. */
+    readonly statements: string[];
+    exec(sql: string): Promise<{
+        rowsAffected: number;
+    }>;
+    query<T = Row>(sql: string): Promise<T[]>;
+    ingestColumnar(request: EonColumnarIngest): Promise<{
+        rowsAffected: number;
+    }>;
+    schemaless(lines: readonly string[], options?: EonSchemalessOptions): Promise<void>;
+    ping(): Promise<void>;
+    close(): Promise<void>;
+    /** Clear recorded statements and the row store. */
+    reset(): void;
+    /** Read the current rows for a table (a copy) — a test-inspection helper. */
+    rows(table: string): Row[];
+}
+export {};
+//# sourceMappingURL=FakeEonConnection.d.ts.map

package/dist/testing/FakeEonConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FakeEonConnection.d.ts","sourceRoot":"","sources":["../../src/testing/FakeEonConnection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACX,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,MAAM,gCAAgC,CAAC;AAExC,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAInC,qBAAa,iBAAkB,YAAW,aAAa;;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAU;IACpC,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAM;IAG7B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IA+B1D,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IA6BnC,cAAc,CACnB,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAO9B,UAAU,CACf,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAQV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE5B,mDAAmD;IACnD,KAAK,IAAI,IAAI;IAKb,6EAA6E;IAC7E,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE;CAmB1B"}