@c9up/eon 0.1.0

package/dist/testing/FakeEonConnection.js

@@ -0,0 +1,315 @@
+/**
+ * `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.
+ */
+const WINDOWED = /\b(INTERVAL|FILL|PARTITION\s+BY|SLIDING)\b/i;
+export class FakeEonConnection {
+    transport = "fake";
+    /** Every `exec`ed statement, in order — assert against this in tests. */
+    statements = [];
+    #store = new Map();
+    async exec(sql) {
+        this.statements.push(sql);
+        const trimmed = sql.trim();
+        if (/^CREATE\s+(STABLE|TABLE)\b/i.test(trimmed)) {
+            const table = extractCreateTarget(trimmed);
+            if (table !== undefined && !this.#store.has(table)) {
+                this.#store.set(table, []);
+            }
+            return { rowsAffected: 0 };
+        }
+        if (/^INSERT\s+INTO\b/i.test(trimmed)) {
+            const rows = parseInsert(trimmed);
+            if (rows !== undefined) {
+                const existing = this.#store.get(rows.table) ?? [];
+                existing.push(...rows.rows);
+                this.#store.set(rows.table, existing);
+                return { rowsAffected: rows.rows.length };
+            }
+        }
+        if (/^DELETE\s+FROM\b/i.test(trimmed)) {
+            const affected = this.#applyDelete(trimmed);
+            return { rowsAffected: affected };
+        }
+        // DROP / USE / other DDL: recorded, no store change.
+        if (/^DROP\s+(STABLE|TABLE)\b/i.test(trimmed)) {
+            const table = extractDropTarget(trimmed);
+            if (table !== undefined)
+                this.#store.delete(table);
+        }
+        return { rowsAffected: 0 };
+    }
+    async query(sql) {
+        const trimmed = sql.trim();
+        if (WINDOWED.test(trimmed) || hasAggregate(trimmed)) {
+            throw new Error(`[E_EON_FAKE_UNSUPPORTED] FakeEonConnection answers only flat SELECT; windowed/aggregate SQL needs a live TDengine (use describeIfTdengine). Query: ${trimmed}`);
+        }
+        const parsed = parseSelect(trimmed);
+        if (parsed === undefined) {
+            throw new Error(`[E_EON_FAKE_UNSUPPORTED] FakeEonConnection could not parse this SELECT: ${trimmed}`);
+        }
+        let rows = [...(this.#store.get(parsed.table) ?? [])];
+        if (parsed.where !== undefined) {
+            const { column, op, value } = parsed.where;
+            rows = rows.filter((r) => compareOp(r[column], op, value));
+        }
+        if (parsed.limit !== undefined)
+            rows = rows.slice(0, parsed.limit);
+        if (parsed.columns === "*")
+            return rows;
+        const cols = parsed.columns;
+        return rows.map((r) => {
+            const projected = {};
+            for (const c of cols)
+                projected[c] = r[c];
+            return projected;
+        });
+    }
+    async ingestColumnar(request) {
+        void request;
+        throw new Error("[E_EON_FAKE_UNSUPPORTED] FakeEonConnection has no STMT columnar path; test bulk ingest against a live TDengine (describeIfTdengine).");
+    }
+    async schemaless(lines, options) {
+        void lines;
+        void options;
+        throw new Error("[E_EON_FAKE_UNSUPPORTED] FakeEonConnection has no line-protocol path; test schemaless ingest against a live TDengine (describeIfTdengine).");
+    }
+    async ping() { }
+    async close() { }
+    /** Clear recorded statements and the row store. */
+    reset() {
+        this.statements.length = 0;
+        this.#store.clear();
+    }
+    /** Read the current rows for a table (a copy) — a test-inspection helper. */
+    rows(table) {
+        return [...(this.#store.get(table) ?? [])];
+    }
+    #applyDelete(sql) {
+        const match = /^DELETE\s+FROM\s+`([^`]+)`\s+WHERE\s+`([^`]+)`\s*=\s*(.+)$/i.exec(sql);
+        if (match === null)
+            return 0;
+        const [, table, column, rawValue] = match;
+        if (table === undefined || column === undefined || rawValue === undefined) {
+            return 0;
+        }
+        const value = parseLiteral(rawValue.trim());
+        const existing = this.#store.get(table);
+        if (existing === undefined)
+            return 0;
+        const kept = existing.filter((r) => r[column] !== value);
+        this.#store.set(table, kept);
+        return existing.length - kept.length;
+    }
+}
+/** Detect a function-call in the SELECT projection (`avg(...)`, `count(*)`, …). */
+function hasAggregate(sql) {
+    const match = /^SELECT\s+(.+?)\s+FROM\b/i.exec(sql);
+    if (match === null)
+        return false;
+    const projection = match[1] ?? "";
+    return /[A-Za-z_][A-Za-z0-9_]*\s*\(/.test(projection);
+}
+function extractCreateTarget(sql) {
+    const match = /^CREATE\s+(?:STABLE|TABLE)\s+(?:IF\s+NOT\s+EXISTS\s+)?`([^`]+)`/i.exec(sql);
+    return match?.[1];
+}
+function extractDropTarget(sql) {
+    const match = /^DROP\s+(?:STABLE|TABLE)\s+(?:IF\s+EXISTS\s+)?`([^`]+)`/i.exec(sql);
+    return match?.[1];
+}
+/** Parse a literal `INSERT` (plain or `USING … TAGS`) into rows keyed by column. */
+function parseInsert(sql) {
+    const tableMatch = /^INSERT\s+INTO\s+`([^`]+)`/i.exec(sql);
+    const table = tableMatch?.[1];
+    if (table === undefined)
+        return undefined;
+    // Strip an optional child-create `USING `stb` TAGS (...)` clause.
+    const body = sql.replace(/\bUSING\s+`[^`]+`\s+TAGS\s*\([^)]*\)/i, "");
+    const colsMatch = /\(([^)]*)\)\s*VALUES/i.exec(body);
+    const valuesPart = body.slice(body.search(/VALUES/i) + "VALUES".length);
+    if (colsMatch === null)
+        return undefined;
+    const columns = (colsMatch[1] ?? "")
+        .split(",")
+        .map((c) => c.trim().replace(/^`|`$/g, ""));
+    const rows = [];
+    for (const tuple of splitTuples(valuesPart)) {
+        const values = splitValues(tuple).map(parseLiteral);
+        const row = {};
+        columns.forEach((c, i) => {
+            row[c] = values[i];
+        });
+        rows.push(row);
+    }
+    return { table, rows };
+}
+function parseSelect(sql) {
+    const match = /^SELECT\s+(.+?)\s+FROM\s+`([^`]+)`\s*(?:WHERE\s+(.+?))?\s*(?:LIMIT\s+(\d+))?\s*$/i.exec(sql);
+    if (match === null)
+        return undefined;
+    const [, rawCols, table, rawWhere, rawLimit] = match;
+    if (rawCols === undefined || table === undefined)
+        return undefined;
+    const columns = rawCols.trim() === "*"
+        ? "*"
+        : rawCols.split(",").map((c) => c.trim().replace(/^`|`$/g, ""));
+    const result = { columns, table };
+    if (rawWhere !== undefined) {
+        const clause = rawWhere.trim();
+        // A multi-predicate WHERE (`a` = 1 AND `b` = 2) or an unparseable clause
+        // (non-backtick column, unknown operator) is NOT supported. Return
+        // undefined so the caller throws E_EON_FAKE_UNSUPPORTED rather than
+        // silently dropping the predicate and returning every row (fail-loud).
+        if (hasBooleanConnector(clause))
+            return undefined;
+        const w = /^`([^`]+)`\s*(=|!=|<>|>=|<=|>|<)\s*(.+)$/.exec(clause);
+        if (w === null ||
+            w[1] === undefined ||
+            w[2] === undefined ||
+            w[3] === undefined) {
+            return undefined;
+        }
+        result.where = {
+            column: w[1],
+            op: w[2],
+            value: parseLiteral(w[3].trim()),
+        };
+    }
+    if (rawLimit !== undefined)
+        result.limit = Number(rawLimit);
+    return result;
+}
+/**
+ * True if a WHERE clause has a top-level `AND`/`OR` connector (a multi-predicate
+ * filter the flat store cannot evaluate). Single-quoted string literals are
+ * blanked first so an `AND` inside a value (`'a AND b'`) is not misread.
+ */
+function hasBooleanConnector(clause) {
+    const unquoted = clause.replace(/'(?:\\.|[^'\\])*'/g, "''");
+    return /\b(?:AND|OR)\b/i.test(unquoted);
+}
+function compareOp(left, op, right) {
+    switch (op) {
+        case "=":
+            return left === right;
+        case "!=":
+        case "<>":
+            return left !== right;
+        default: {
+            const l = Number(left);
+            const r = Number(right);
+            if (Number.isNaN(l) || Number.isNaN(r))
+                return false;
+            if (op === ">")
+                return l > r;
+            if (op === ">=")
+                return l >= r;
+            if (op === "<")
+                return l < r;
+            if (op === "<=")
+                return l <= r;
+            return false;
+        }
+    }
+}
+/** Split a `VALUES` clause into per-row tuples, respecting quoted strings. */
+function splitTuples(valuesPart) {
+    const tuples = [];
+    let depth = 0;
+    let inString = false;
+    let start = -1;
+    for (let i = 0; i < valuesPart.length; i++) {
+        const ch = valuesPart[i];
+        if (inString) {
+            if (ch === "\\")
+                i++; // skip the escaped char
+            else if (ch === "'")
+                inString = false;
+            continue;
+        }
+        if (ch === "'") {
+            inString = true;
+        }
+        else if (ch === "(") {
+            if (depth === 0)
+                start = i + 1;
+            depth++;
+        }
+        else if (ch === ")") {
+            depth--;
+            if (depth === 0 && start >= 0) {
+                tuples.push(valuesPart.slice(start, i));
+                start = -1;
+            }
+        }
+    }
+    return tuples;
+}
+/** Split a tuple body into top-level comma-separated value tokens. */
+function splitValues(tuple) {
+    const values = [];
+    let inString = false;
+    let current = "";
+    for (let i = 0; i < tuple.length; i++) {
+        const ch = tuple[i];
+        if (inString) {
+            current += ch;
+            if (ch === "\\") {
+                const next = tuple[i + 1];
+                if (next !== undefined) {
+                    current += next;
+                    i++;
+                }
+            }
+            else if (ch === "'") {
+                inString = false;
+            }
+            continue;
+        }
+        if (ch === "'") {
+            inString = true;
+            current += ch;
+        }
+        else if (ch === ",") {
+            values.push(current.trim());
+            current = "";
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current.trim().length > 0)
+        values.push(current.trim());
+    return values;
+}
+/** Parse a single SQL literal token back to a JS value (inverse of `render_literal`). */
+function parseLiteral(token) {
+    if (token === "NULL")
+        return null;
+    if (token === "true")
+        return true;
+    if (token === "false")
+        return false;
+    if (token.startsWith("'") && token.endsWith("'")) {
+        return token.slice(1, -1).replace(/\\(['\\])/g, "$1");
+    }
+    const num = Number(token);
+    return Number.isNaN(num) ? token : num;
+}
+//# sourceMappingURL=FakeEonConnection.js.map

package/dist/testing/FakeEonConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FakeEonConnection.js","sourceRoot":"","sources":["../../src/testing/FakeEonConnection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAUH,MAAM,QAAQ,GAAG,6CAA6C,CAAC;AAE/D,MAAM,OAAO,iBAAiB;IACpB,SAAS,GAAW,MAAM,CAAC;IACpC,yEAAyE;IAChE,UAAU,GAAa,EAAE,CAAC;IAC1B,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IAE3C,KAAK,CAAC,IAAI,CAAC,GAAW;QACrB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACnD,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;gBACtC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3C,CAAC;QACF,CAAC;QACD,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAC5C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;QACnC,CAAC;QACD,qDAAqD;QACrD,IAAI,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/C,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACzC,IAAI,KAAK,KAAK,SAAS;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAC5B,CAAC;IAGD,KAAK,CAAC,KAAK,CAAC,GAAW;QACtB,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CACd,sJAAsJ,OAAO,EAAE,CAC/J,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACd,2EAA2E,OAAO,EAAE,CACpF,CAAC;QACH,CAAC;QACD,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;YAC3C,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,MAAM,CAAC,OAAO,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACrB,MAAM,SAAS,GAAQ,EAAE,CAAC;YAC1B,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,OAAO,SAAS,CAAC;QAClB,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CACnB,OAA0B;QAE1B,KAAK,OAAO,CAAC;QACb,MAAM,IAAI,KAAK,CACd,sIAAsI,CACtI,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CACf,KAAwB,EACxB,OAA8B;QAE9B,KAAK,KAAK,CAAC;QACX,KAAK,OAAO,CAAC;QACb,MAAM,IAAI,KAAK,CACd,4IAA4I,CAC5I,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,KAAmB,CAAC;IAC9B,KAAK,CAAC,KAAK,KAAmB,CAAC;IAE/B,mDAAmD;IACnD,KAAK;QACJ,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,6EAA6E;IAC7E,IAAI,CAAC,KAAa;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,YAAY,CAAC,GAAW;QACvB,MAAM,KAAK,GACV,6DAA6D,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzE,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC;QAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3E,OAAO,CAAC,CAAC;QACV,CAAC;QACD,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACtC,CAAC;CACD;AAED,mFAAmF;AACnF,SAAS,YAAY,CAAC,GAAW;IAChC,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACjC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,OAAO,6BAA6B,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAW;IACvC,MAAM,KAAK,GACV,kEAAkE,CAAC,IAAI,CACtE,GAAG,CACH,CAAC;IACH,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW;IACrC,MAAM,KAAK,GAAG,0DAA0D,CAAC,IAAI,CAC5E,GAAG,CACH,CAAC;IACF,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAOD,oFAAoF;AACpF,SAAS,WAAW,CAAC,GAAW;IAC/B,MAAM,UAAU,GAAG,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,kEAAkE;IAClE,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,uCAAuC,EAAE,EAAE,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxE,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SAClC,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAU,EAAE,CAAC;IACvB,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACpD,MAAM,GAAG,GAAQ,EAAE,CAAC;QACpB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACxB,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AASD,SAAS,WAAW,CAAC,GAAW;IAC/B,MAAM,KAAK,GACV,mFAAmF,CAAC,IAAI,CACvF,GAAG,CACH,CAAC;IACH,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC;IACrD,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACnE,MAAM,OAAO,GACZ,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG;QACrB,CAAC,CAAC,GAAG;QACL,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,yEAAyE;QACzE,mEAAmE;QACnE,oEAAoE;QACpE,uEAAuE;QACvE,IAAI,mBAAmB,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;QAClD,MAAM,CAAC,GAAG,0CAA0C,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClE,IACC,CAAC,KAAK,IAAI;YACV,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS;YAClB,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS;YAClB,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,EACjB,CAAC;YACF,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,MAAM,CAAC,KAAK,GAAG;YACd,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;YACZ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YACR,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SAChC,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,MAAc;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IAC5D,OAAO,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,SAAS,CAAC,IAAa,EAAE,EAAU,EAAE,KAAc;IAC3D,QAAQ,EAAE,EAAE,CAAC;QACZ,KAAK,GAAG;YACP,OAAO,IAAI,KAAK,KAAK,CAAC;QACvB,KAAK,IAAI,CAAC;QACV,KAAK,IAAI;YACR,OAAO,IAAI,KAAK,KAAK,CAAC;QACvB,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YACvB,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YACxB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;YACrD,IAAI,EAAE,KAAK,GAAG;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,EAAE,KAAK,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,EAAE,KAAK,GAAG;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,EAAE,KAAK,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;AACF,CAAC;AAED,8EAA8E;AAC9E,SAAS,WAAW,CAAC,UAAkB;IACtC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,QAAQ,EAAE,CAAC;YACd,IAAI,EAAE,KAAK,IAAI;gBACd,CAAC,EAAE,CAAC,CAAC,wBAAwB;iBACzB,IAAI,EAAE,KAAK,GAAG;gBAAE,QAAQ,GAAG,KAAK,CAAC;YACtC,SAAS;QACV,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAChB,QAAQ,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACvB,IAAI,KAAK,KAAK,CAAC;gBAAE,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/B,KAAK,EAAE,CAAC;QACT,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACvB,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;gBACxC,KAAK,GAAG,CAAC,CAAC,CAAC;YACZ,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,sEAAsE;AACtE,SAAS,WAAW,CAAC,KAAa;IACjC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,EAAE,CAAC;YACd,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACxB,OAAO,IAAI,IAAI,CAAC;oBAChB,CAAC,EAAE,CAAC;gBACL,CAAC;YACF,CAAC;iBAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACvB,QAAQ,GAAG,KAAK,CAAC;YAClB,CAAC;YACD,SAAS;QACV,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAChB,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,IAAI,EAAE,CAAC;QACf,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5B,OAAO,GAAG,EAAE,CAAC;QACd,CAAC;aAAM,CAAC;YACP,OAAO,IAAI,EAAE,CAAC;QACf,CAAC;IACF,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC;AACf,CAAC;AAED,yFAAyF;AACzF,SAAS,YAAY,CAAC,KAAa;IAClC,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;AACxC,CAAC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Test helpers for @c9up/eon — the REAL-connection harness for integration
+ * suites (58.2) PLUS the in-memory fake store + factory (58.6).
+ *
+ * `EON_TEST_URL` gates the live paths: unset → local dev without a server, so
+ * integration suites skip via `describeIfTdengine` (mirrors atlas's "no external
+ * DB required for unit tests" posture). CI sets it, so the roundtrip runs for
+ * real — no silent cap. The fake store + factory need NO server.
+ */
+import type { EonConnectionConfig } from "../connection/config.js";
+import type { EonConnection } from "../connection/EonConnection.js";
+export { type FactoryBuilder, factory } from "./Factory.js";
+export { FakeEonConnection } from "./FakeEonConnection.js";
+/** Whether an `EON_TEST_URL` is configured (a live TDengine is reachable). */
+export declare function hasTestServer(): boolean;
+/**
+ * Register a suite that runs only when a test server is configured, else skips —
+ * so integration suites gate uniformly. CI (with `EON_TEST_URL`) runs them for
+ * real; local dev without a server skips them.
+ */
+export declare function describeIfTdengine(name: string, factory: () => void): void;
+/**
+ * Open a connection to the test server (`EON_TEST_URL`), applying root/taosdata
+ * defaults and a generous connect-retry for a cold docker server. Callers gate
+ * with `hasTestServer()` / `describeIfTdengine` first.
+ */
+export declare function connectTestEon(overrides?: Partial<EonConnectionConfig>): Promise<EonConnection>;
+/**
+ * Reset a database for test isolation: drop it if present, then recreate it at
+ * millisecond precision. The name is validated against a safe alphabet before
+ * interpolation — a test-only helper, but no injection footgun.
+ */
+export declare function resetDatabase(conn: EonConnection, db: string): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAGpE,OAAO,EAAE,KAAK,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAQ3D,8EAA8E;AAC9E,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAM1E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,SAAS,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAC1C,OAAO,CAAC,aAAa,CAAC,CAexB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAClC,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,MAAM,GACR,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/testing/index.js

@@ -0,0 +1,67 @@
+/**
+ * Test helpers for @c9up/eon — the REAL-connection harness for integration
+ * suites (58.2) PLUS the in-memory fake store + factory (58.6).
+ *
+ * `EON_TEST_URL` gates the live paths: unset → local dev without a server, so
+ * integration suites skip via `describeIfTdengine` (mirrors atlas's "no external
+ * DB required for unit tests" posture). CI sets it, so the roundtrip runs for
+ * real — no silent cap. The fake store + factory need NO server.
+ */
+import { describe } from "vitest";
+import { connectWsEon } from "../connection/websocket.js";
+export { factory } from "./Factory.js";
+export { FakeEonConnection } from "./FakeEonConnection.js";
+/** The live TDengine URL for integration tests (taosAdapter WS), or `undefined`. */
+function testUrl() {
+    const url = process.env.EON_TEST_URL;
+    return typeof url === "string" && url.length > 0 ? url : undefined;
+}
+/** Whether an `EON_TEST_URL` is configured (a live TDengine is reachable). */
+export function hasTestServer() {
+    return testUrl() !== undefined;
+}
+/**
+ * Register a suite that runs only when a test server is configured, else skips —
+ * so integration suites gate uniformly. CI (with `EON_TEST_URL`) runs them for
+ * real; local dev without a server skips them.
+ */
+export function describeIfTdengine(name, factory) {
+    if (hasTestServer()) {
+        describe(name, factory);
+    }
+    else {
+        describe.skip(name, factory);
+    }
+}
+/**
+ * Open a connection to the test server (`EON_TEST_URL`), applying root/taosdata
+ * defaults and a generous connect-retry for a cold docker server. Callers gate
+ * with `hasTestServer()` / `describeIfTdengine` first.
+ */
+export function connectTestEon(overrides = {}) {
+    const url = testUrl();
+    if (!url) {
+        throw new Error("[eon] connectTestEon requires EON_TEST_URL (a live TDengine taosAdapter WS URL, e.g. ws://localhost:6041).");
+    }
+    return connectWsEon({
+        url,
+        user: "root",
+        password: "taosdata",
+        connectRetries: 10,
+        connectBackoffMs: 250,
+        ...overrides,
+    });
+}
+/**
+ * Reset a database for test isolation: drop it if present, then recreate it at
+ * millisecond precision. The name is validated against a safe alphabet before
+ * interpolation — a test-only helper, but no injection footgun.
+ */
+export async function resetDatabase(conn, db) {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(db)) {
+        throw new Error(`[eon] resetDatabase: unsafe database name '${db}'`);
+    }
+    await conn.exec(`DROP DATABASE IF EXISTS ${db}`);
+    await conn.exec(`CREATE DATABASE ${db} PRECISION 'ms'`);
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGlC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EAAuB,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,oFAAoF;AACpF,SAAS,OAAO;IACf,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACpE,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,aAAa;IAC5B,OAAO,OAAO,EAAE,KAAK,SAAS,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,OAAmB;IACnE,IAAI,aAAa,EAAE,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzB,CAAC;SAAM,CAAC;QACP,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC7B,YAA0C,EAAE;IAE5C,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACd,4GAA4G,CAC5G,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC;QACnB,GAAG;QACH,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,UAAU;QACpB,cAAc,EAAE,EAAE;QAClB,gBAAgB,EAAE,GAAG;QACrB,GAAG,SAAS;KACZ,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,IAAmB,EACnB,EAAU;IAEV,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,8CAA8C,EAAE,GAAG,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,IAAI,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;IACjD,MAAM,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;AACzD,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@c9up/eon",
+  "version": "0.1.0",
+  "description": "Eon — time-series data layer for the Ream framework (TDengine-backed)",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "LICENSE",
+    "README.md",
+    "dist",
+    "index.*.node",
+    "scripts",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./provider": {
+      "types": "./dist/EonProvider.d.ts",
+      "import": "./dist/EonProvider.js"
+    },
+    "./services/connection": {
+      "types": "./dist/services/connection.d.ts",
+      "import": "./dist/services/connection.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
+    }
+  },
+  "dependencies": {
+    "@tdengine/websocket": "3.5.0",
+    "reflect-metadata": "^0.2"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.10",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2",
+    "@types/node": "^22"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/C9up/eon.git"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:rust": "cargo build --release -p eon-query-napi",
+    "build:napi": "pnpm build:rust && node scripts/copy-napi.mjs",
+    "test": "vitest run",
+    "test:rust": "cargo test -p eon-query",
+    "lint": "biome check src/",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/scripts/copy-napi.mjs

@@ -0,0 +1,72 @@
+// Eon ships ONE NAPI artefact:
+//   - eon-query-napi → index.<suffix>.node
+//
+// Usage:
+//   node scripts/copy-napi.mjs      # eon-query → index.<suffix>.node
+
+import { copyFileSync, existsSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { arch, env, platform } from 'node:process'
+import { fileURLToPath } from 'node:url'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const root = join(here, '..')
+
+// Cross-compile aware: set CARGO_BUILD_TARGET (e.g. x86_64-apple-darwin on an
+// arm64 runner so we don't depend on the scarce macos-13 Intel runners) and we
+// read target/<triple>/release. Unset = host platform / target/release.
+const tripleMap = {
+  'x86_64-unknown-linux-gnu': { suffix: 'linux-x64-gnu', os: 'linux' },
+  'aarch64-unknown-linux-gnu': { suffix: 'linux-arm64-gnu', os: 'linux' },
+  'x86_64-apple-darwin': { suffix: 'darwin-x64', os: 'darwin' },
+  'aarch64-apple-darwin': { suffix: 'darwin-arm64', os: 'darwin' },
+  'x86_64-pc-windows-msvc': { suffix: 'win32-x64-msvc', os: 'win32' },
+}
+const hostSuffixMap = {
+  'linux-x64': 'linux-x64-gnu',
+  'linux-arm64': 'linux-arm64-gnu',
+  'darwin-x64': 'darwin-x64',
+  'darwin-arm64': 'darwin-arm64',
+  'win32-x64': 'win32-x64-msvc',
+}
+
+const basename = 'index'
+const crate = 'eon_query_napi'
+
+const triple = env.CARGO_BUILD_TARGET ?? ''
+let suffix
+let os
+let releaseDir
+if (triple) {
+  const entry = tripleMap[triple]
+  if (!entry) {
+    throw new Error(`[eon:napi] unsupported CARGO_BUILD_TARGET: ${triple}`)
+  }
+  suffix = entry.suffix
+  os = entry.os
+  releaseDir = join(root, 'target', triple, 'release')
+} else {
+  suffix = hostSuffixMap[`${platform}-${arch}`]
+  os = platform
+  releaseDir = join(root, 'target', 'release')
+  if (!suffix) {
+    throw new Error(`[eon:napi] unsupported platform/arch: ${platform}-${arch}`)
+  }
+}
+
+const candidates = os === 'win32'
+  ? [join(releaseDir, `${crate}.dll`), join(releaseDir, `lib${crate}.dll`)]
+  : os === 'darwin'
+  ? [join(releaseDir, `lib${crate}.dylib`)]
+  : [join(releaseDir, `lib${crate}.so`)]
+
+const source = candidates.find((candidate) => existsSync(candidate))
+if (!source) {
+  throw new Error(
+    `[eon:napi] native library not found. Looked for:\n${candidates.map((p) => `- ${p}`).join('\n')}`,
+  )
+}
+
+const target = join(root, `${basename}.${suffix}.node`)
+copyFileSync(source, target)
+console.log(`[eon:napi] copied ${source} -> ${target}`)