@c9up/eon 0.1.0

package/dist/repository/SuperTableRepository.d.ts

@@ -0,0 +1,80 @@
+/**
+ * `SuperTableRepository<TPoint>` — the Atlas-shaped ingest API for a TDengine
+ * super-table (story 58.4).
+ *
+ * Mirrors `@c9up/atlas` `BaseRepository` naming: `ingest` (≙ `create`) and
+ * `ingestMany` (≙ `createMany`, the bulk primitive), plus two extra write paths
+ * TDengine adds — `ingestSql` (literal INSERT) and `ingestSchemaless` (line
+ * protocol). It deliberately OMITS everything TDengine has no analogue for
+ * (AC8): no `save`/`upsert`/`firstOrCreate`, no `useTransaction`/BEGIN-COMMIT,
+ * no `RETURNING`, no DB-generated-PK hydrate-back. TDengine writes are
+ * append / last-write-wins by the caller-supplied timestamp.
+ *
+ * Schema is read ONLY through the 58.3 decorator metadata getters — never
+ * `key in instance` (the `@Column() declare x` pitfall, memory
+ * `project_atlas_declare_hydration`). The connection is injected structurally
+ * (agnostic leaf, AD1 — no `@c9up/ream` import).
+ */
+import type { EonConnection, EonSchemalessOptions } from "../connection/EonConnection.js";
+import { type IngestPoint } from "../ingest/stmt.js";
+import { TimeSeriesQuery } from "../query/TimeSeriesQuery.js";
+import { type SuperTableClass } from "../schema/compile.js";
+/** Options for {@link SuperTableRepository}. */
+export interface SuperTableRepositoryOptions {
+    /** STMT chunk size (rows per child per bind). Default {@link DEFAULT_BATCH_SIZE}. */
+    readonly batchSize?: number;
+}
+/**
+ * Repository for a TDengine super-table — atlas `BaseRepository` parity for the
+ * time-series model. NAMED deviation from atlas (prime directive: name any
+ * divergence): atlas types reads by constructing `new Entity()` instances; eon
+ * reads plain records and never constructs instances, so typed reads are opt-in
+ * through `query(mapPoint)` — the caller supplies the row → `E` mapper, composed
+ * on top of the bigint/timestamp-reviving base hydrator (no `as`, the decode
+ * stays honest). Called without a mapper, points stay `Record<string, unknown>`.
+ */
+export declare class SuperTableRepository {
+    #private;
+    constructor(entityClass: SuperTableClass, conn: EonConnection, options?: SuperTableRepositoryOptions);
+    /**
+     * A fluent time-series read builder bound to this repository's connection and
+     * the entity's 58.3 schema metadata. Rows hydrate through a metadata-driven
+     * closure — declared columns by their `@Column`/`@Tag` metadata (bigint /
+     * timestamp revived as `bigint`), NEVER `key in instance` (the `declare`-field
+     * pitfall), and window pseudo-columns / aggregate aliases attached raw.
+     *
+     * Pass `mapPoint` to project each decoded row into a typed `E` (atlas-parity
+     * typed reads, no `as`): the mapper composes on top of the base hydrator so
+     * bigint/timestamp revival still happens first. Without a mapper, points stay
+     * `Record<string, unknown>`.
+     */
+    query(): TimeSeriesQuery<Record<string, unknown>>;
+    query<E extends object>(mapPoint: (row: Record<string, unknown>) => E): TimeSeriesQuery<E>;
+    /** Ingest a single point (≙ atlas `create`). */
+    ingest(point: IngestPoint): Promise<void>;
+    /**
+     * Bulk ingest via the columnar STMT path (≙ atlas `createMany`) — the default
+     * high-throughput, injection-safe write. Groups by child table, binds SoA
+     * columns once per batch. Returns total rows affected. `async` so a plan
+     * error (e.g. an unsafe-integer timestamp) surfaces as a rejection, not a
+     * synchronous throw at the call site.
+     */
+    ingestMany(points: readonly IngestPoint[]): Promise<{
+        rowsAffected: number;
+    }>;
+    /**
+     * Bulk ingest via literal SQL INSERT (AC5) — a convenience/fallback path run
+     * through `exec`. One `INSERT … USING … TAGS … VALUES` per child table; all
+     * value literals are rendered by the Rust compiler (no TS interpolation).
+     */
+    ingestSql(points: readonly IngestPoint[]): Promise<{
+        rowsAffected: number;
+    }>;
+    /**
+     * Bulk ingest via schemaless line protocol (AC4) — a documented ~8–10× slower
+     * helper, NOT the default bulk path. Renders points to InfluxDB line protocol
+     * from the entity metadata and passes them to the transport.
+     */
+    ingestSchemaless(points: readonly IngestPoint[], options?: EonSchemalessOptions): Promise<void>;
+}
+//# sourceMappingURL=SuperTableRepository.d.ts.map

package/dist/repository/SuperTableRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SuperTableRepository.d.ts","sourceRoot":"","sources":["../../src/repository/SuperTableRepository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,oBAAoB,EACpB,MAAM,gCAAgC,CAAC;AASxC,OAAO,EAKN,KAAK,WAAW,EAGhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAEN,KAAK,eAAe,EACpB,MAAM,sBAAsB,CAAC;AAE9B,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC3C,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;;gBAM/B,WAAW,EAAE,eAAe,EAC5B,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,2BAA2B;IActC;;;;;;;;;;;OAWG;IACH,KAAK,IAAI,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,KAAK,CAAC,CAAC,SAAS,MAAM,EACrB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,GAC3C,eAAe,CAAC,CAAC,CAAC;IAqBrB,gDAAgD;IAC1C,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;;;;;OAMG;IACG,UAAU,CACf,MAAM,EAAE,SAAS,WAAW,EAAE,GAC5B,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAKpC;;;;OAIG;IACG,SAAS,CACd,MAAM,EAAE,SAAS,WAAW,EAAE,GAC5B,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAUpC;;;;OAIG;IACG,gBAAgB,CACrB,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC;CAIhB"}

package/dist/repository/SuperTableRepository.js

@@ -0,0 +1,232 @@
+/**
+ * `SuperTableRepository<TPoint>` — the Atlas-shaped ingest API for a TDengine
+ * super-table (story 58.4).
+ *
+ * Mirrors `@c9up/atlas` `BaseRepository` naming: `ingest` (≙ `create`) and
+ * `ingestMany` (≙ `createMany`, the bulk primitive), plus two extra write paths
+ * TDengine adds — `ingestSql` (literal INSERT) and `ingestSchemaless` (line
+ * protocol). It deliberately OMITS everything TDengine has no analogue for
+ * (AC8): no `save`/`upsert`/`firstOrCreate`, no `useTransaction`/BEGIN-COMMIT,
+ * no `RETURNING`, no DB-generated-PK hydrate-back. TDengine writes are
+ * append / last-write-wins by the caller-supplied timestamp.
+ *
+ * Schema is read ONLY through the 58.3 decorator metadata getters — never
+ * `key in instance` (the `@Column() declare x` pitfall, memory
+ * `project_atlas_declare_hydration`). The connection is injected structurally
+ * (agnostic leaf, AD1 — no `@c9up/ream` import).
+ */
+import { getColumnMetadata, getSuperTableMetadata, getTagMetadata, getTimestampColumn, } from "../decorators/superTable.js";
+import { toLineProtocol } from "../ingest/schemaless.js";
+import { buildLiteralInserts } from "../ingest/sql.js";
+import { buildColumnarIngest, compileStmtTemplate, DEFAULT_BATCH_SIZE, toBindKind, } from "../ingest/stmt.js";
+import { TimeSeriesQuery } from "../query/TimeSeriesQuery.js";
+import { orderTimestampFirst, } from "../schema/compile.js";
+/**
+ * Repository for a TDengine super-table — atlas `BaseRepository` parity for the
+ * time-series model. NAMED deviation from atlas (prime directive: name any
+ * divergence): atlas types reads by constructing `new Entity()` instances; eon
+ * reads plain records and never constructs instances, so typed reads are opt-in
+ * through `query(mapPoint)` — the caller supplies the row → `E` mapper, composed
+ * on top of the bigint/timestamp-reviving base hydrator (no `as`, the decode
+ * stays honest). Called without a mapper, points stay `Record<string, unknown>`.
+ */
+export class SuperTableRepository {
+    #conn;
+    #plan;
+    #querySchema;
+    constructor(entityClass, conn, options) {
+        // Fail loud on a null/undefined connection — almost always a failed IoC
+        // injection (atlas `BaseRepository.ts:245` parity), not a runtime NPE later.
+        if (conn === null || conn === undefined) {
+            throw new Error(`[E_EON_MISSING_CONNECTION] SuperTableRepository for '${entityClass?.name ?? "<unknown entity>"}' requires an EonConnection (got ${conn === null ? "null" : "undefined"}). Check IoC constructor injection is wired.`);
+        }
+        this.#conn = conn;
+        this.#plan = buildPlan(entityClass, options);
+        this.#querySchema = buildQuerySchema(entityClass);
+    }
+    query(mapPoint) {
+        const base = this.#querySchema.hydrate;
+        if (mapPoint) {
+            return new TimeSeriesQuery(this.#querySchema.stable, this.#conn, (row) => mapPoint(base(row)), this.#querySchema.known);
+        }
+        return new TimeSeriesQuery(this.#querySchema.stable, this.#conn, base, this.#querySchema.known);
+    }
+    /** Ingest a single point (≙ atlas `create`). */
+    async ingest(point) {
+        await this.ingestMany([point]);
+    }
+    /**
+     * Bulk ingest via the columnar STMT path (≙ atlas `createMany`) — the default
+     * high-throughput, injection-safe write. Groups by child table, binds SoA
+     * columns once per batch. Returns total rows affected. `async` so a plan
+     * error (e.g. an unsafe-integer timestamp) surfaces as a rejection, not a
+     * synchronous throw at the call site.
+     */
+    async ingestMany(points) {
+        if (points.length === 0)
+            return { rowsAffected: 0 };
+        return this.#conn.ingestColumnar(buildColumnarIngest(this.#plan, points));
+    }
+    /**
+     * Bulk ingest via literal SQL INSERT (AC5) — a convenience/fallback path run
+     * through `exec`. One `INSERT … USING … TAGS … VALUES` per child table; all
+     * value literals are rendered by the Rust compiler (no TS interpolation).
+     */
+    async ingestSql(points) {
+        if (points.length === 0)
+            return { rowsAffected: 0 };
+        let rowsAffected = 0;
+        for (const sql of buildLiteralInserts(this.#plan, points)) {
+            const result = await this.#conn.exec(sql);
+            rowsAffected += result.rowsAffected;
+        }
+        return { rowsAffected };
+    }
+    /**
+     * Bulk ingest via schemaless line protocol (AC4) — a documented ~8–10× slower
+     * helper, NOT the default bulk path. Renders points to InfluxDB line protocol
+     * from the entity metadata and passes them to the transport.
+     */
+    async ingestSchemaless(points, options) {
+        if (points.length === 0)
+            return;
+        await this.#conn.schemaless(toLineProtocol(this.#plan, points), options);
+    }
+}
+/** Resolve the immutable ingest plan from a decorated super-table class. */
+function buildPlan(entityClass, options) {
+    const meta = getSuperTableMetadata(entityClass);
+    if (!meta) {
+        throw new Error(`[E_EON_NOT_A_SUPERTABLE] ${entityClass.name} is not decorated with @SuperTable`);
+    }
+    const tsProperty = getTimestampColumn(entityClass);
+    if (!tsProperty) {
+        throw new Error(`[E_EON_NO_TIMESTAMP] super-table '${meta.name}' has no @Timestamp column`);
+    }
+    const columnMeta = getColumnMetadata(entityClass);
+    const tsColumn = columnMeta.find((c) => c.propertyKey === tsProperty);
+    if (!tsColumn) {
+        throw new Error(`[E_EON_NO_TIMESTAMP] super-table '${meta.name}' @Timestamp column '${tsProperty}' is not registered`);
+    }
+    // Timestamp first, from the SAME shared ordering the STABLE was created with
+    // (`orderTimestampFirst`), so the positional STMT bind lines up with the
+    // STABLE's physical columns and can never drift.
+    const ordered = orderTimestampFirst(columnMeta, tsColumn, tsProperty);
+    const columns = ordered.map((c) => ({
+        property: c.propertyKey,
+        kind: toBindKind(c.type, c.propertyKey),
+    }));
+    const tags = getTagMetadata(entityClass).map((t) => ({
+        property: t.propertyKey,
+        kind: toBindKind(t.type, t.propertyKey),
+    }));
+    if (tags.length === 0) {
+        throw new Error(`[E_EON_NO_TAGS] super-table '${meta.name}' has no @Tag columns; a child table cannot be routed without tags`);
+    }
+    const batchSize = options?.batchSize ?? DEFAULT_BATCH_SIZE;
+    if (!Number.isInteger(batchSize) || batchSize <= 0) {
+        throw new Error(`[E_EON_BATCH_SIZE] batchSize must be a positive integer (got ${batchSize})`);
+    }
+    const templateSql = compileStmtTemplate(meta.name, tags.map((t) => t.property), columns.map((c) => c.property));
+    return {
+        stable: meta.name,
+        templateSql,
+        tsProperty,
+        columns,
+        tags,
+        batchSize,
+    };
+}
+/**
+ * Build the read-side schema from the 58.3 decorator getters. The `@Column`/
+ * `@Tag` metadata is the ONLY source of truth — never `key in instance` (the
+ * `@Column() declare x` pitfall, memory `project_atlas_declare_hydration`).
+ */
+function buildQuerySchema(entityClass) {
+    const meta = getSuperTableMetadata(entityClass);
+    if (!meta) {
+        throw new Error(`[E_EON_NOT_A_SUPERTABLE] ${entityClass.name} is not decorated with @SuperTable`);
+    }
+    const tsProperty = getTimestampColumn(entityClass);
+    if (!tsProperty) {
+        throw new Error(`[E_EON_NO_TIMESTAMP] super-table '${meta.name}' has no @Timestamp column`);
+    }
+    const columns = getColumnMetadata(entityClass);
+    const tags = getTagMetadata(entityClass);
+    const known = new Set([
+        ...columns.map((c) => c.propertyKey),
+        ...tags.map((t) => t.propertyKey),
+    ]);
+    // A column reads back as `bigint` when it is the timestamp primary column or
+    // its logical type is a 64-bit integer — parity with the compile-boundary
+    // precision guard, so a nanosecond `ts` or a BIGINT metric never narrows to a
+    // lossy double.
+    const bigintColumns = new Set();
+    for (const column of columns) {
+        if (column.propertyKey === tsProperty || isBigintLogicalType(column.type)) {
+            bigintColumns.add(column.propertyKey);
+        }
+    }
+    for (const tag of tags) {
+        if (isBigintLogicalType(tag.type))
+            bigintColumns.add(tag.propertyKey);
+    }
+    const hydrate = (row) => {
+        // Decode by metadata membership, iterating the raw row's own keys — never
+        // `for (key in instance)` (a `declare` field is not an own property).
+        const point = {};
+        for (const [key, value] of Object.entries(row)) {
+            if (!known.has(key))
+                continue;
+            // `defineProperty`, not assignment: a column named `__proto__`/`constructor`
+            // would otherwise hit the inherited accessor and re-parent `point`.
+            Object.defineProperty(point, key, {
+                value: bigintColumns.has(key) ? reviveBigInt(value) : value,
+                writable: true,
+                enumerable: true,
+                configurable: true,
+            });
+        }
+        return point;
+    };
+    return { stable: meta.name, hydrate, known };
+}
+/**
+ * Logical types that read back as 64-bit integers. Matched case-insensitively
+ * and including the `bigInteger` alias, so it stays in lock-step with the DDL /
+ * bind side (`TYPE_KIND_MAP` accepts `bigint`/`bigInteger`/any-case `BIGINT`) —
+ * a divergence here would read a genuine BIGINT column back as a lossy `number`.
+ */
+function isBigintLogicalType(type) {
+    if (type === undefined)
+        return false;
+    const t = type.toLowerCase();
+    return t === "bigint" || t === "biginteger" || t === "timestamp";
+}
+/**
+ * Revive a raw column value into a `bigint` for a timestamp / BIGINT column.
+ * Accepts an existing `bigint`, an integer `number`, or an all-digits string;
+ * passes `null`/`undefined` through (a nullable window aggregate). Anything else
+ * — a fractional number, an unexpected type — fails loud rather than silently
+ * narrowing precision.
+ */
+function reviveBigInt(value) {
+    if (typeof value === "bigint")
+        return value;
+    if (typeof value === "number") {
+        if (!Number.isInteger(value)) {
+            throw new Error(`[E_EON_HYDRATE_BIGINT] expected an integer for a bigint/timestamp column, got the non-integer ${value}`);
+        }
+        if (!Number.isSafeInteger(value)) {
+            throw new Error(`[E_EON_HYDRATE_BIGINT] integer ${value} exceeds the JS safe-integer range (2^53) and has already lost precision; the transport must hand a bigint/timestamp column back as bigint or a string, not a lossy number`);
+        }
+        return BigInt(value);
+    }
+    if (typeof value === "string" && /^-?\d+$/.test(value)) {
+        return BigInt(value);
+    }
+    if (value === null || value === undefined)
+        return value;
+    throw new Error(`[E_EON_HYDRATE_BIGINT] cannot revive a bigint/timestamp column from a ${typeof value}`);
+}
+//# sourceMappingURL=SuperTableRepository.js.map

package/dist/repository/SuperTableRepository.js.map

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

package/dist/schema/CreateStableSpec.d.ts

@@ -0,0 +1,140 @@
+/**
+ * TypeScript spec shapes mirroring the Rust `crates/eon-query/src/ddl.rs`
+ * structs, plus the logical → compiler-kind type map (parallel to atlas
+ * `schema/types.ts`).
+ *
+ * The facade assembles these plain JSON objects from decorator metadata and
+ * hands them to `compileStatementNative`; the Rust compiler owns all quoting,
+ * type-mapping, and schema-rule validation — the TS side never string-builds
+ * SQL (D1, the injection seam stays in Rust).
+ */
+/** The user-facing logical type strings accepted on `@Column`/`@Tag`/`@Timestamp`. */
+export type EonLogicalType = "timestamp" | "int" | "integer" | "bigint" | "biginteger" | "smallint" | "tinyint" | "float" | "double" | "bool" | "boolean" | "string" | "varchar" | "nchar" | "binary" | "varbinary" | "json" | "decimal";
+export declare const TYPE_KIND_MAP: Record<string, string>;
+/** A column or tag definition — the flattened `StableColumnDef` + `ColumnTypeSpec`. */
+export interface EonColumnSpec {
+    name: string;
+    kind: string;
+    length: number | null;
+    precision: number | null;
+    scale: number | null;
+}
+export interface CreateStableSpec {
+    kind: "createStable";
+    name: string;
+    columns: EonColumnSpec[];
+    tags: EonColumnSpec[];
+    ifNotExists: boolean;
+    /** Optional STABLE `KEEP` retention (a 3.3.x+ TDengine feature). Validated as a duration in Rust. */
+    keep?: string;
+}
+/** One `ALTER STABLE` change — tagged on `op`, mirroring the Rust `AlterChange`. */
+export type AlterChange = {
+    op: "addColumn";
+    name: string;
+    type: Omit<EonColumnSpec, "name">;
+} | {
+    op: "dropColumn";
+    name: string;
+} | {
+    op: "modifyColumn";
+    name: string;
+    type: Omit<EonColumnSpec, "name">;
+} | {
+    op: "addTag";
+    name: string;
+    type: Omit<EonColumnSpec, "name">;
+} | {
+    op: "dropTag";
+    name: string;
+} | {
+    op: "modifyTag";
+    name: string;
+    type: Omit<EonColumnSpec, "name">;
+} | {
+    op: "renameTag";
+    from: string;
+    to: string;
+};
+export interface AlterStableSpec {
+    kind: "alterStable";
+    name: string;
+    changes: AlterChange[];
+}
+export interface CreateChildTableSpec {
+    kind: "createChildTable";
+    name: string;
+    using: string;
+    tags: unknown[];
+    ifNotExists: boolean;
+    /** Inline tag values as SQL literals (58.3 `exec`) vs `?` placeholders (STMT, 58.4). */
+    literal: boolean;
+    /** Optional child-table `TTL` in whole days (`>= 0`, a 3.3.x+ TDengine feature). */
+    ttl?: number;
+}
+export interface DropStableSpec {
+    kind: "dropStable";
+    name: string;
+    ifExists: boolean;
+}
+/** TDengine timestamp precision — the create-only `PRECISION` database option. */
+export type EonPrecision = "ms" | "us" | "ns";
+/** TDengine `CACHEMODEL` allowlist. */
+export type EonCacheModel = "none" | "last_row" | "last_value" | "both";
+/**
+ * `CREATE DATABASE` options (retention / storage). Every value is validated in
+ * Rust (durations, precision/cachemodel/wal-level allowlists, `KEEP >= 3x
+ * DURATION`). Options are emitted only when present, in a fixed order.
+ */
+export interface EonDatabaseOptions {
+    /** Retention duration (e.g. `"90d"`). Must be `>= 3 x DURATION` when both are set with the same unit. */
+    keep?: string;
+    /** Per-file time span (e.g. `"10d"`). Create-only — cannot be altered. */
+    duration?: string;
+    /** Timestamp precision. Create-only — cannot be altered. */
+    precision?: EonPrecision;
+    /** Write buffer size in MB. */
+    buffer?: number;
+    /** WAL level (1 or 2). */
+    walLevel?: 1 | 2;
+    /** Row cache mode. */
+    cachemodel?: EonCacheModel;
+}
+export interface CreateDatabaseSpec extends EonDatabaseOptions {
+    kind: "createDatabase";
+    name: string;
+    ifNotExists: boolean;
+}
+/**
+ * `ALTER DATABASE` — TDengine changes exactly ONE option per statement, so
+ * exactly one field must be set. Create-only options (`PRECISION`/`DURATION`)
+ * are intentionally absent here.
+ */
+export interface EonAlterDatabaseOptions {
+    keep?: string;
+    buffer?: number;
+    walLevel?: 1 | 2;
+    cachemodel?: EonCacheModel;
+    replica?: number;
+    minrows?: number;
+}
+export interface AlterDatabaseSpec {
+    kind: "alterDatabase";
+    name: string;
+    /** The Rust-side option name (e.g. `"keep"`, `"wal_level"`). */
+    option: string;
+    value: string | number;
+}
+/** A basic (non-super) table: first column `TIMESTAMP`, then columns, no `TAGS`. */
+export interface CreateTableSpec {
+    kind: "createTable";
+    name: string;
+    columns: EonColumnSpec[];
+    ifNotExists: boolean;
+}
+export interface DropTableSpec {
+    kind: "dropTable";
+    name: string;
+    ifExists: boolean;
+}
+//# sourceMappingURL=CreateStableSpec.d.ts.map

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

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

package/dist/schema/CreateStableSpec.js

@@ -0,0 +1,41 @@
+/**
+ * TypeScript spec shapes mirroring the Rust `crates/eon-query/src/ddl.rs`
+ * structs, plus the logical → compiler-kind type map (parallel to atlas
+ * `schema/types.ts`).
+ *
+ * The facade assembles these plain JSON objects from decorator metadata and
+ * hands them to `compileStatementNative`; the Rust compiler owns all quoting,
+ * type-mapping, and schema-rule validation — the TS side never string-builds
+ * SQL (D1, the injection seam stays in Rust).
+ */
+/**
+ * Map a logical type string to the compiler's `ColumnTypeKind` (serde
+ * camelCase). Common aliases collapse onto one kind (`int`/`integer` → `int`,
+ * `string`/`varchar` → `varchar`, `binary`/`varbinary` → `varbinary`). Physical
+ * TDengine types are resolved from these kinds in Rust (`Dialect::map_column_type`).
+ */
+const TYPE_KIND_ENTRIES = {
+    timestamp: "timestamp",
+    int: "int",
+    integer: "int",
+    bigint: "bigInt",
+    biginteger: "bigInt",
+    smallint: "smallInt",
+    tinyint: "tinyInt",
+    float: "float",
+    double: "double",
+    bool: "bool",
+    boolean: "bool",
+    string: "varchar",
+    varchar: "varchar",
+    nchar: "nchar",
+    binary: "varbinary",
+    varbinary: "varbinary",
+    json: "json",
+    decimal: "decimal",
+    // `satisfies` makes this exhaustive + exact against EonLogicalType (a missing
+    // or stray key is a compile error) while the exported map stays string-keyed
+    // so an arbitrary logical string can be looked up without a cast.
+};
+export const TYPE_KIND_MAP = TYPE_KIND_ENTRIES;
+//# sourceMappingURL=CreateStableSpec.js.map

package/dist/schema/CreateStableSpec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateStableSpec.js","sourceRoot":"","sources":["../../src/schema/CreateStableSpec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuBH;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG;IACzB,SAAS,EAAE,WAAW;IACtB,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,8EAA8E;IAC9E,6EAA6E;IAC7E,kEAAkE;CACzB,CAAC;AAE3C,MAAM,CAAC,MAAM,aAAa,GAA2B,iBAAiB,CAAC"}

package/dist/schema/EonMigrationRunner.d.ts

@@ -0,0 +1,71 @@
+/**
+ * `EonMigrationRunner` — discovers, executes, and tracks eon (TDengine)
+ * migrations. Mirrors atlas `MigrationRunner` (`schema/MigrationRunner.ts`):
+ * sorted-file discovery, a `ream_`-prefixed tracking table, batch-based
+ * rollback, `init/status/migrate/rollback/reset/refresh/fresh/dryRun`.
+ *
+ * ── TWO named TDengine deviations from atlas (AC6) ──────────────────────────
+ *
+ *  1. **No transactions / no engine rollback.** TDengine DDL is non-transactional
+ *     — a batch CANNOT be applied atomically. The runner executes statements
+ *     **sequentially**; a mid-migration failure leaves earlier statements
+ *     applied. The mitigation is idempotent DDL (`IF (NOT) EXISTS`, the
+ *     `EonSchema` default) so a re-run converges. There is NO `runInTransaction`.
+ *
+ *  2. **No `UNIQUE`, no auto-increment.** The tracking table is a basic table
+ *     `ream_eon_migrations(executed_at TIMESTAMP, name VARCHAR(255), batch INT)`;
+ *     the applied-set is de-duped **by name in JS**, and each record is written
+ *     with a strictly-increasing `executed_at` so rollback can delete it by that
+ *     unique timestamp key (TDengine only allows a `DELETE` predicate on the
+ *     primary timestamp column).
+ *
+ * Agnostic leaf: takes the connection structurally and a plain directory path —
+ * no `@c9up/ream` import, no app helper (`project_package_extraction`).
+ */
+import type { EonConnection } from "../connection/EonConnection.js";
+export interface EonMigrationOptions {
+    /** Directory holding migration files. Default `database/eon-migrations`. */
+    migrationsDir?: string;
+    /**
+     * Tracking-table name. Default `ream_eon_migrations`. Must match
+     * `/^[A-Za-z_][A-Za-z0-9_]*$/`. The `ream_` prefix marks it a framework/system
+     * table (`feedback_underscore_policy`) — keep it so cleanup helpers skip it.
+     */
+    tableName?: string;
+}
+export type MigrationState = "applied" | "pending";
+export interface MigrationStatus {
+    name: string;
+    state: MigrationState;
+    batch?: number;
+}
+export declare class EonMigrationRunner {
+    #private;
+    constructor(conn: EonConnection, options?: EonMigrationOptions);
+    /** Create the tracking table (`IF NOT EXISTS`) via the basic-table DDL path. */
+    init(): Promise<void>;
+    /** The status of every discovered migration (applied vs pending). */
+    status(): Promise<MigrationStatus[]>;
+    /** Run every pending migration (filename order), recording each. */
+    migrate(): Promise<string[]>;
+    /** Roll back the most-recent batch (files in reverse order), running `down()`. */
+    rollback(): Promise<string[]>;
+    /** Roll back every applied batch (Lucid `migrate:reset`). */
+    reset(): Promise<string[]>;
+    /** Reset then re-run every migration (Lucid `migrate:refresh`). */
+    refresh(): Promise<{
+        rolled: string[];
+        executed: string[];
+    }>;
+    /** Alias of {@link refresh} (Lucid `migrate:fresh`). */
+    fresh(): Promise<{
+        rolled: string[];
+        executed: string[];
+    }>;
+    /** Compute the SQL each pending migration would emit, WITHOUT executing it. */
+    dryRun(): Promise<Array<{
+        name: string;
+        sql: string[];
+    }>>;
+}
+//# sourceMappingURL=EonMigrationRunner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EonMigrationRunner.d.ts","sourceRoot":"","sources":["../../src/schema/EonMigrationRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAUpE,MAAM,WAAW,mBAAmB;IACnC,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AASD,qBAAa,kBAAkB;;gBAKlB,IAAI,EAAE,aAAa,EAAE,OAAO,GAAE,mBAAwB;IAYlE,gFAAgF;IAC1E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC3B,qEAAqE;IAC/D,MAAM,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAa1C,oEAAoE;IAC9D,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BlC,kFAAkF;IAC5E,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA2BnC,6DAA6D;IACvD,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAYhC,mEAAmE;IAC7D,OAAO,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAMlE,wDAAwD;IACxD,KAAK,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAI1D,+EAA+E;IACzE,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAyI/D"}