@c9up/eon 0.1.0

package/dist/schema/EonSchema.js

@@ -0,0 +1,309 @@
+/**
+ * `EonSchema` — the fluent DDL surface a migration's `up()`/`down()` drives.
+ *
+ * Mirrors atlas `Schema` (`schema/Schema.ts`) in shape: each method compiles its
+ * spec through the Rust `compileStatementNative` seam and appends the resulting
+ * SQL to an internal buffer the runner flushes. The TS side NEVER string-builds
+ * SQL — every identifier, literal, and option value is quoted/validated in Rust
+ * (the injection seam stays in one place, memory `feedback_security_first`).
+ *
+ * The `StableBuilder` is intentionally THINNER than atlas `TableBuilder`:
+ * TDengine columns have no `DEFAULT`, no per-column `PRIMARY KEY` choice (the
+ * first `TIMESTAMP` is always the key), no `UNIQUE`, no foreign keys, no SQL
+ * secondary indexes — so `defaultTo`/`primary`/`unique`/`references`/`increments`
+ * have NO analogue and are deliberately absent (D — the reconciliation note).
+ */
+import { compileStatementNative } from "../query/native.js";
+/** Build one column/tag spec — the ONE place logical type args become an `EonColumnSpec`. */
+function columnSpec(name, kind, length = null, precision = null, scale = null) {
+    return { name, kind, length, precision, scale };
+}
+/** Build the type portion — the ONE place logical type args become an `EonType`. */
+function makeType(kind, length = null, precision = null, scale = null) {
+    return { kind, length, precision, scale };
+}
+/**
+ * The thin column/tag surface shared by every builder: only column-type methods
+ * (+ length/precision/scale). No `defaultTo`/`primary`/`unique` — TDengine has
+ * no analogue. Each method appends a column via `#add` and returns whatever that
+ * hook returns (a tag-handle for stables, `void` for basic tables).
+ */
+class ColumnMethods {
+    timestamp(name) {
+        return this.add(columnSpec(name, "timestamp"));
+    }
+    int(name) {
+        return this.add(columnSpec(name, "int"));
+    }
+    bigInteger(name) {
+        return this.add(columnSpec(name, "bigInt"));
+    }
+    float(name) {
+        return this.add(columnSpec(name, "float"));
+    }
+    double(name) {
+        return this.add(columnSpec(name, "double"));
+    }
+    bool(name) {
+        return this.add(columnSpec(name, "bool"));
+    }
+    varchar(name, length) {
+        return this.add(columnSpec(name, "varchar", length));
+    }
+    nchar(name, length) {
+        return this.add(columnSpec(name, "nchar", length));
+    }
+    binary(name, length) {
+        return this.add(columnSpec(name, "varbinary", length));
+    }
+    decimal(name, precision, scale) {
+        return this.add(columnSpec(name, "decimal", null, precision, scale ?? null));
+    }
+    json(name) {
+        return this.add(columnSpec(name, "json"));
+    }
+}
+/**
+ * The no-name type surface for an `ALTER STABLE` add/modify change: the column
+ * name is already fixed (by `addColumn(name)` etc.), so these methods take ONLY
+ * the type arguments and finalize the change.
+ */
+class TypeMethods {
+    timestamp() {
+        return this.emit(makeType("timestamp"));
+    }
+    int() {
+        return this.emit(makeType("int"));
+    }
+    bigInteger() {
+        return this.emit(makeType("bigInt"));
+    }
+    float() {
+        return this.emit(makeType("float"));
+    }
+    double() {
+        return this.emit(makeType("double"));
+    }
+    bool() {
+        return this.emit(makeType("bool"));
+    }
+    varchar(length) {
+        return this.emit(makeType("varchar", length));
+    }
+    nchar(length) {
+        return this.emit(makeType("nchar", length));
+    }
+    binary(length) {
+        return this.emit(makeType("varbinary", length));
+    }
+    decimal(precision, scale) {
+        return this.emit(makeType("decimal", null, precision, scale ?? null));
+    }
+    json() {
+        return this.emit(makeType("json"));
+    }
+}
+/** Fluent builder for `CREATE STABLE` columns + tags (ts-first is enforced in Rust). */
+export class StableBuilder extends ColumnMethods {
+    #columns = [];
+    #tags = [];
+    add(spec) {
+        this.#columns.push(spec);
+        return {
+            tag: () => {
+                // Idempotent: a second `.tag()` on the same handle finds the spec
+                // already re-homed (i < 0) and must NOT push a duplicate tag.
+                const i = this.#columns.indexOf(spec);
+                if (i >= 0) {
+                    this.#columns.splice(i, 1);
+                    this.#tags.push(spec);
+                }
+            },
+        };
+    }
+    /** @internal */
+    columns() {
+        return this.#columns;
+    }
+    /** @internal */
+    tags() {
+        return this.#tags;
+    }
+}
+/** Fluent builder for a basic (non-super) table — same columns, no tags. */
+export class BasicTableBuilder extends ColumnMethods {
+    #columns = [];
+    add(spec) {
+        this.#columns.push(spec);
+    }
+    /** @internal */
+    columns() {
+        return this.#columns;
+    }
+}
+class AlterTypeSetterImpl extends TypeMethods {
+    #record;
+    constructor(record) {
+        super();
+        this.#record = record;
+    }
+    emit(type) {
+        this.#record(type);
+    }
+}
+/** Fluent builder for `ALTER STABLE` — one method per TDengine change op. */
+export class AlterStableBuilder {
+    #changes = [];
+    addColumn(name) {
+        return new AlterTypeSetterImpl((type) => this.#changes.push({ op: "addColumn", name, type }));
+    }
+    modifyColumn(name) {
+        return new AlterTypeSetterImpl((type) => this.#changes.push({ op: "modifyColumn", name, type }));
+    }
+    dropColumn(name) {
+        this.#changes.push({ op: "dropColumn", name });
+        return this;
+    }
+    addTag(name) {
+        return new AlterTypeSetterImpl((type) => this.#changes.push({ op: "addTag", name, type }));
+    }
+    modifyTag(name) {
+        return new AlterTypeSetterImpl((type) => this.#changes.push({ op: "modifyTag", name, type }));
+    }
+    dropTag(name) {
+        this.#changes.push({ op: "dropTag", name });
+        return this;
+    }
+    renameTag(from, to) {
+        this.#changes.push({ op: "renameTag", from, to });
+        return this;
+    }
+    /** @internal */
+    changes() {
+        return this.#changes;
+    }
+}
+/** Map an `alterDatabase` option key to its Rust-side option name. */
+const ALTER_DB_OPTION_NAMES = {
+    keep: "keep",
+    buffer: "buffer",
+    walLevel: "wal_level",
+    cachemodel: "cachemodel",
+    replica: "replica",
+    minrows: "minrows",
+};
+export class EonSchema {
+    #statements = [];
+    #push(spec) {
+        const { statements } = compileStatementNative(spec, "tdengine");
+        this.#statements.push(...statements);
+    }
+    /**
+     * `CREATE STABLE`. Defaults to `IF NOT EXISTS` (idempotent DDL — the mitigation
+     * for TDengine's non-transactional migrations, AC6). Pass `keep` for retention.
+     */
+    createStable(name, callback, options = {}) {
+        const builder = new StableBuilder();
+        callback(builder);
+        const spec = {
+            kind: "createStable",
+            name,
+            columns: builder.columns(),
+            tags: builder.tags(),
+            ifNotExists: options.ifNotExists ?? true,
+            ...(options.keep !== undefined ? { keep: options.keep } : {}),
+        };
+        this.#push(spec);
+        return this;
+    }
+    /** `ALTER STABLE` → one statement per change. */
+    alterStable(name, callback) {
+        const builder = new AlterStableBuilder();
+        callback(builder);
+        const spec = {
+            kind: "alterStable",
+            name,
+            changes: builder.changes(),
+        };
+        this.#push(spec);
+        return this;
+    }
+    /** `DROP STABLE IF EXISTS`. */
+    dropStable(name) {
+        this.#push({ kind: "dropStable", name, ifExists: true });
+        return this;
+    }
+    /** `CREATE DATABASE IF NOT EXISTS` with optional retention/storage options. */
+    createDatabase(name, options = {}) {
+        this.#push({
+            kind: "createDatabase",
+            name,
+            ifNotExists: true,
+            ...options,
+        });
+        return this;
+    }
+    /**
+     * `ALTER DATABASE` — exactly ONE option per call (TDengine restriction).
+     * Throws if zero or more than one option key is provided.
+     */
+    alterDatabase(name, options) {
+        const keys = [
+            "keep",
+            "buffer",
+            "walLevel",
+            "cachemodel",
+            "replica",
+            "minrows",
+        ];
+        const set = keys.filter((k) => options[k] !== undefined);
+        const key = set[0];
+        if (set.length !== 1 || key === undefined) {
+            throw new Error(`[E_EON_ALTER_DB_ONE_OPTION] alterDatabase('${name}', …) requires exactly one option, got ${set.length}`);
+        }
+        const value = options[key];
+        if (value === undefined) {
+            throw new Error(`[E_EON_ALTER_DB_ONE_OPTION] alterDatabase('${name}', …) option '${key}' has no value`);
+        }
+        const spec = {
+            kind: "alterDatabase",
+            name,
+            option: ALTER_DB_OPTION_NAMES[key],
+            value,
+        };
+        this.#push(spec);
+        return this;
+    }
+    /** `CREATE TABLE IF NOT EXISTS` — a basic (non-super) table, no tags. */
+    createTable(name, callback) {
+        const builder = new BasicTableBuilder();
+        callback(builder);
+        const spec = {
+            kind: "createTable",
+            name,
+            columns: builder.columns(),
+            ifNotExists: true,
+        };
+        this.#push(spec);
+        return this;
+    }
+    /** `DROP TABLE IF EXISTS`. */
+    dropTable(name) {
+        this.#push({ kind: "dropTable", name, ifExists: true });
+        return this;
+    }
+    /** Queue a raw SQL statement verbatim (an escape hatch for options not modelled above). */
+    raw(sql) {
+        this.#statements.push(sql);
+        return this;
+    }
+    /** Clear the buffer (called before each `up()`/`down()` run). */
+    reset() {
+        this.#statements = [];
+    }
+    /** The compiled SQL statements queued so far. */
+    toSQL() {
+        return [...this.#statements];
+    }
+}
+//# sourceMappingURL=EonSchema.js.map

package/dist/schema/EonSchema.js.map

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

package/dist/schema/Migration.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `Migration` — extend this to author a versioned eon (TDengine) migration.
+ *
+ * Mirrors atlas `Migration` (`schema/Migration.ts`): `up()`/`down()` drive a
+ * fluent `EonSchema`, and `getUpSQL()`/`getDownSQL()` replay the callback to
+ * collect the compiled SQL. Single-dialect (TDengine) so — unlike atlas — the
+ * constructor takes NO dialect argument, and there is no `now()`/`defaultTo`
+ * helper (TDengine columns have no `DEFAULT`).
+ *
+ * TDengine caveat (AC6): DDL is non-transactional and some operations are
+ * irreversible (a `MODIFY` length-extension cannot be un-extended, a dropped
+ * column's data is gone) — `down()` is best-effort. Prefer idempotent DDL
+ * (`IF (NOT) EXISTS`, the `EonSchema` default) so a partially-applied migration
+ * re-runs cleanly.
+ *
+ *     import { Migration } from "@c9up/eon";
+ *
+ *     export default class CreateMeters extends Migration {
+ *       up() {
+ *         this.schema.createDatabase("metrics", { keep: "90d", duration: "10d" });
+ *         this.schema.createStable("meters", (t) => {
+ *           t.timestamp("ts");
+ *           t.float("current");
+ *           t.int("groupid").tag();
+ *         });
+ *       }
+ *       down() {
+ *         this.schema.dropStable("meters");
+ *       }
+ *     }
+ */
+import { EonSchema } from "./EonSchema.js";
+export declare abstract class Migration {
+    readonly schema: EonSchema;
+    constructor();
+    /** Apply the migration. */
+    abstract up(): Promise<void> | void;
+    /** Reverse the migration (best-effort on TDengine — see class docs). */
+    abstract down(): Promise<void> | void;
+    /** Queue a raw SQL statement verbatim (escape hatch for un-modelled DDL). */
+    raw(sql: string): void;
+    /** Compile the SQL statements this migration's `up()` produces. */
+    getUpSQL(): Promise<string[]>;
+    /** Compile the SQL statements this migration's `down()` produces. */
+    getDownSQL(): Promise<string[]>;
+}
+//# sourceMappingURL=Migration.d.ts.map

package/dist/schema/Migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migration.d.ts","sourceRoot":"","sources":["../../src/schema/Migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,8BAAsB,SAAS;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;;IAM3B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAEnC,wEAAwE;IACxE,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAErC,6EAA6E;IAC7E,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAItB,mEAAmE;IAC7D,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMnC,qEAAqE;IAC/D,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAKrC"}

package/dist/schema/Migration.js

@@ -0,0 +1,55 @@
+/**
+ * `Migration` — extend this to author a versioned eon (TDengine) migration.
+ *
+ * Mirrors atlas `Migration` (`schema/Migration.ts`): `up()`/`down()` drive a
+ * fluent `EonSchema`, and `getUpSQL()`/`getDownSQL()` replay the callback to
+ * collect the compiled SQL. Single-dialect (TDengine) so — unlike atlas — the
+ * constructor takes NO dialect argument, and there is no `now()`/`defaultTo`
+ * helper (TDengine columns have no `DEFAULT`).
+ *
+ * TDengine caveat (AC6): DDL is non-transactional and some operations are
+ * irreversible (a `MODIFY` length-extension cannot be un-extended, a dropped
+ * column's data is gone) — `down()` is best-effort. Prefer idempotent DDL
+ * (`IF (NOT) EXISTS`, the `EonSchema` default) so a partially-applied migration
+ * re-runs cleanly.
+ *
+ *     import { Migration } from "@c9up/eon";
+ *
+ *     export default class CreateMeters extends Migration {
+ *       up() {
+ *         this.schema.createDatabase("metrics", { keep: "90d", duration: "10d" });
+ *         this.schema.createStable("meters", (t) => {
+ *           t.timestamp("ts");
+ *           t.float("current");
+ *           t.int("groupid").tag();
+ *         });
+ *       }
+ *       down() {
+ *         this.schema.dropStable("meters");
+ *       }
+ *     }
+ */
+import { EonSchema } from "./EonSchema.js";
+export class Migration {
+    schema;
+    constructor() {
+        this.schema = new EonSchema();
+    }
+    /** Queue a raw SQL statement verbatim (escape hatch for un-modelled DDL). */
+    raw(sql) {
+        this.schema.raw(sql);
+    }
+    /** Compile the SQL statements this migration's `up()` produces. */
+    async getUpSQL() {
+        this.schema.reset();
+        await this.up();
+        return this.schema.toSQL();
+    }
+    /** Compile the SQL statements this migration's `down()` produces. */
+    async getDownSQL() {
+        this.schema.reset();
+        await this.down();
+        return this.schema.toSQL();
+    }
+}
+//# sourceMappingURL=Migration.js.map

package/dist/schema/Migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migration.js","sourceRoot":"","sources":["../../src/schema/Migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,OAAgB,SAAS;IACrB,MAAM,CAAY;IAE3B;QACC,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;IAC/B,CAAC;IAQD,6EAA6E;IAC7E,GAAG,CAAC,GAAW;QACd,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,QAAQ;QACb,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,UAAU;QACf,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACD"}

package/dist/schema/compile.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Assemble a `CreateStableSpec` from a decorated super-table class.
+ *
+ * Reads schema through the metadata getters ONLY (never `key in instance` — the
+ * `declare` pitfall, memory `project_atlas_declare_hydration`), places the
+ * timestamp column first (TDengine's PK rule), and normalises each logical type
+ * string to the compiler kind via `TYPE_KIND_MAP`. Mirror of atlas
+ * `TableBuilder.toStatements` spec-build.
+ */
+import { type CreateStableSpec } from "./CreateStableSpec.js";
+/** A decorated super-table class. Every constructor carries `.name` (`Function.name`). */
+export type SuperTableClass = (abstract new (...args: never[]) => object) & {
+    readonly name: string;
+};
+/** Resolve the super-table name for a class, or throw if it is undecorated. */
+export declare function requireSuperTableName(EntityClass: SuperTableClass): string;
+/**
+ * The stable's physical column order: timestamp first (TDengine's PK rule), then
+ * declaration order. The STMT columnar bind is POSITIONAL (the connector's
+ * prepare template omits the value-column list), so its bind order MUST match the
+ * order the STABLE was created with. Both `compileCreateStableSpec` (the DDL) and
+ * `SuperTableRepository`'s ingest plan derive their order from THIS one function
+ * so the two can never silently drift apart and write values into wrong columns.
+ */
+export declare function orderTimestampFirst<T extends {
+    propertyKey: string;
+}>(columns: readonly T[], tsColumn: T, tsProperty: string): T[];
+/**
+ * Build the `createStable` spec (ts column first). `ifNotExists` defaults to
+ * `false`; `syncSuperTable` overrides it to `true`.
+ */
+export declare function compileCreateStableSpec(EntityClass: SuperTableClass): CreateStableSpec;
+//# sourceMappingURL=compile.d.ts.map

package/dist/schema/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/schema/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,EACN,KAAK,gBAAgB,EAGrB,MAAM,uBAAuB,CAAC;AAE/B,0FAA0F;AAC1F,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,MACtC,GAAG,IAAI,EAAE,KAAK,EAAE,KACZ,MAAM,CAAC,GAAG;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,CAU1E;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EACpE,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,QAAQ,EAAE,CAAC,EACX,UAAU,EAAE,MAAM,GAChB,CAAC,EAAE,CAEL;AAmBD;;;GAGG;AACH,wBAAgB,uBAAuB,CACtC,WAAW,EAAE,eAAe,GAC1B,gBAAgB,CAyBlB"}

package/dist/schema/compile.js

@@ -0,0 +1,70 @@
+/**
+ * Assemble a `CreateStableSpec` from a decorated super-table class.
+ *
+ * Reads schema through the metadata getters ONLY (never `key in instance` — the
+ * `declare` pitfall, memory `project_atlas_declare_hydration`), places the
+ * timestamp column first (TDengine's PK rule), and normalises each logical type
+ * string to the compiler kind via `TYPE_KIND_MAP`. Mirror of atlas
+ * `TableBuilder.toStatements` spec-build.
+ */
+import { getColumnMetadata, getSuperTableMetadata, getTagMetadata, getTimestampColumn, } from "../decorators/superTable.js";
+import { TYPE_KIND_MAP, } from "./CreateStableSpec.js";
+/** Resolve the super-table name for a class, or throw if it is undecorated. */
+export function requireSuperTableName(EntityClass) {
+    const meta = getSuperTableMetadata(EntityClass);
+    if (!meta) {
+        const label = EntityClass.name.length > 0 ? EntityClass.name : "the given class";
+        throw new Error(`[E_EON_NOT_A_SUPERTABLE] ${label} is not decorated with @SuperTable`);
+    }
+    return meta.name;
+}
+/**
+ * The stable's physical column order: timestamp first (TDengine's PK rule), then
+ * declaration order. The STMT columnar bind is POSITIONAL (the connector's
+ * prepare template omits the value-column list), so its bind order MUST match the
+ * order the STABLE was created with. Both `compileCreateStableSpec` (the DDL) and
+ * `SuperTableRepository`'s ingest plan derive their order from THIS one function
+ * so the two can never silently drift apart and write values into wrong columns.
+ */
+export function orderTimestampFirst(columns, tsColumn, tsProperty) {
+    return [tsColumn, ...columns.filter((c) => c.propertyKey !== tsProperty)];
+}
+function toColumnSpec(meta) {
+    const logical = (meta.type ?? "").toLowerCase();
+    const kind = TYPE_KIND_MAP[logical];
+    if (!kind) {
+        throw new Error(`[E_EON_TYPE] column/tag '${meta.propertyKey}' has an unknown or missing type '${meta.type ?? ""}'`);
+    }
+    return {
+        name: meta.propertyKey,
+        kind,
+        length: meta.length ?? null,
+        precision: meta.precision ?? null,
+        scale: meta.scale ?? null,
+    };
+}
+/**
+ * Build the `createStable` spec (ts column first). `ifNotExists` defaults to
+ * `false`; `syncSuperTable` overrides it to `true`.
+ */
+export function compileCreateStableSpec(EntityClass) {
+    const name = requireSuperTableName(EntityClass);
+    const tsProperty = getTimestampColumn(EntityClass);
+    if (!tsProperty) {
+        throw new Error(`[E_EON_NO_TIMESTAMP] super-table '${name}' has no @Timestamp column`);
+    }
+    const columns = getColumnMetadata(EntityClass);
+    const tsColumn = columns.find((c) => c.propertyKey === tsProperty);
+    if (!tsColumn) {
+        throw new Error(`[E_EON_NO_TIMESTAMP] super-table '${name}' @Timestamp column '${tsProperty}' is not registered`);
+    }
+    const orderedColumns = orderTimestampFirst(columns, tsColumn, tsProperty);
+    return {
+        kind: "createStable",
+        name,
+        columns: orderedColumns.map(toColumnSpec),
+        tags: getTagMetadata(EntityClass).map(toColumnSpec),
+        ifNotExists: false,
+    };
+}
+//# sourceMappingURL=compile.js.map

package/dist/schema/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../src/schema/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAGN,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGN,aAAa,GACb,MAAM,uBAAuB,CAAC;AAS/B,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,WAA4B;IACjE,MAAM,IAAI,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,MAAM,KAAK,GACV,WAAW,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC;QACpE,MAAM,IAAI,KAAK,CACd,4BAA4B,KAAK,oCAAoC,CACrE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAClC,OAAqB,EACrB,QAAW,EACX,UAAkB;IAElB,OAAO,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,YAAY,CAAC,IAAwC;IAC7D,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACd,4BAA4B,IAAI,CAAC,WAAW,qCAAqC,IAAI,CAAC,IAAI,IAAI,EAAE,GAAG,CACnG,CAAC;IACH,CAAC;IACD,OAAO;QACN,IAAI,EAAE,IAAI,CAAC,WAAW;QACtB,IAAI;QACJ,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;KACzB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACtC,WAA4B;IAE5B,MAAM,IAAI,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACd,qCAAqC,IAAI,4BAA4B,CACrE,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC;IACnE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACd,qCAAqC,IAAI,wBAAwB,UAAU,qBAAqB,CAChG,CAAC;IACH,CAAC;IACD,MAAM,cAAc,GAAG,mBAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAE1E,OAAO;QACN,IAAI,EAAE,cAAc;QACpB,IAAI;QACJ,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC;QACzC,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;QACnD,WAAW,EAAE,KAAK;KAClB,CAAC;AACH,CAAC"}

package/dist/schema/sync.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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 type { EonConnection } from "../connection/EonConnection.js";
+import { type SuperTableClass } from "./compile.js";
+/** Create the super-table for a decorated class (`CREATE STABLE IF NOT EXISTS`). */
+export declare function syncSuperTable(conn: EonConnection, EntityClass: SuperTableClass): Promise<void>;
+/** Options for {@link createChildTable}: identify the stable by name or class. */
+export interface CreateChildTableOptions {
+    stable?: string;
+    EntityClass?: SuperTableClass;
+    name: string;
+    tags: unknown[];
+    ifNotExists?: boolean;
+}
+/**
+ * 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 declare function createChildTable(conn: EonConnection, options: CreateChildTableOptions): Promise<void>;
+/** Drop the super-table for a decorated class (`DROP STABLE IF EXISTS`). */
+export declare function dropSuperTable(conn: EonConnection, EntityClass: SuperTableClass): Promise<void>;
+/**
+ * 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 declare function childTableName(stableOrEntity: string | SuperTableClass, tagValues: unknown[]): string;
+/**
+ * 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 declare function stringifyTagValue(value: unknown): string;
+//# sourceMappingURL=sync.d.ts.map

package/dist/schema/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/schema/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAMpE,OAAO,EAGN,KAAK,eAAe,EACpB,MAAM,cAAc,CAAC;AAUtB,oFAAoF;AACpF,wBAAgB,cAAc,CAC7B,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,eAAe,GAC1B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,uBAAuB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAC7B,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,eAAe,GAC1B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,cAAc,EAAE,MAAM,GAAG,eAAe,EACxC,SAAS,EAAE,OAAO,EAAE,GAClB,MAAM,CAOR;AAcD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGxD"}