@notuslabs/yail 0.1.0

package/dist/db/internal.d.ts.map

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

package/dist/db/internal.js

@@ -0,0 +1,75 @@
+import { t, table } from "../schema/index.js";
+/** Per-chain indexing progress. `cursor` is the next block to index. */
+export const checkpoints = table("_yail_checkpoints", {
+    chain: t.string(),
+    cursor: t.uint64(),
+    head: t.uint64(),
+    updatedAt: t.dateTime64(3),
+}, { orderBy: ["chain"], engineArgs: ["updated_at"], indexMeta: false });
+/** Dynamic address registry. One row per (set, chain, address); latest version wins. */
+export const addresses = table("_yail_addresses", {
+    set: t.string(),
+    chain: t.string(),
+    address: t.address(),
+    status: t.enum(["pending", "backfilling", "live", "failed"]),
+    /** First block the address should be indexed from. */
+    fromBlock: t.uint64(),
+    /** True once the live loop has adopted the address (it is included in live queries from `adoptedAtBlock` on). */
+    adopted: t.bool().default("false"),
+    /** Block at which the live loop adopted the address; backfill covers [fromBlock, adoptedAtBlock). */
+    adoptedAtBlock: t.uint64(),
+    /** Optional user-defined label / metadata (JSON). */
+    meta: t.json().default("'{}'"),
+    error: t.string().default("''"),
+    registeredAt: t.dateTime64(3),
+    updatedAt: t.dateTime64(3),
+}, { orderBy: ["set", "chain", "address"], engineArgs: ["updated_at"], indexMeta: false });
+/** Durable job queue: address backfills and range re-indexes. */
+export const jobs = table("_yail_jobs", {
+    id: t.string(),
+    chain: t.string(),
+    kind: t.enum(["backfill_address", "reindex_range", "reindex_scope"]),
+    payload: t.json(),
+    status: t.enum(["pending", "running", "done", "failed"]),
+    attempts: t.uint32().default("0"),
+    error: t.string().default("''"),
+    createdAt: t.dateTime64(3),
+    updatedAt: t.dateTime64(3),
+}, { orderBy: ["id"], engineArgs: ["updated_at"], indexMeta: false });
+/** Optional cache of raw source batches (HyperSync/RPC pages), keyed by query shape. */
+export const sourceCache = table("_yail_source_cache", {
+    chain: t.string(),
+    queryHash: t.string(),
+    fromBlock: t.uint64(),
+    nextBlock: t.uint64(),
+    payload: t.string().codec("ZSTD(3)"),
+    createdAt: t.dateTime64(3),
+}, { orderBy: ["chain", "queryHash", "fromBlock"], engineArgs: ["created_at"], indexMeta: false });
+/** Cached HTTP responses for `context.http`. */
+export const httpCache = table("_yail_http_cache", {
+    key: t.string(),
+    url: t.string(),
+    status: t.uint16(),
+    headers: t.string().codec("ZSTD(3)"),
+    body: t.string().codec("ZSTD(3)"),
+    fetchedAt: t.dateTime64(3),
+    expiresAt: t.dateTime64(3),
+}, { orderBy: ["key"], engineArgs: ["fetched_at"], indexMeta: false });
+/** Cached `eth_call` results for `context.client.readContract`, keyed by block. */
+export const rpcCache = table("_yail_rpc_cache", {
+    chain: t.string(),
+    block: t.uint64(),
+    to: t.address(),
+    data: t.string(),
+    result: t.string(),
+    createdAt: t.dateTime64(3),
+}, { orderBy: ["chain", "block", "to", "data"], engineArgs: ["created_at"], indexMeta: false });
+/** Recent block hashes per chain, used to detect reorgs against the source's rollback guard. */
+export const blockHashes = table("_yail_block_hashes", {
+    chain: t.string(),
+    block: t.uint64(),
+    hash: t.hash(),
+    createdAt: t.dateTime64(3),
+}, { orderBy: ["chain", "block"], engineArgs: ["created_at"], indexMeta: false, ttl: "created_at + INTERVAL 7 DAY" });
+export const INTERNAL_TABLES = [checkpoints, addresses, jobs, sourceCache, httpCache, rpcCache, blockHashes];
+//# sourceMappingURL=internal.js.map

package/dist/db/internal.js.map

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

package/dist/db/migrate.d.ts

@@ -0,0 +1,22 @@
+import { type MaterializedView, type Table } from "../schema/index.js";
+import type { Db } from "./client.js";
+export type SchemaModule = Record<string, unknown>;
+export declare function collectSchema(schema: SchemaModule | ReadonlyArray<Table<any> | MaterializedView>): {
+    tables: Table<any>[];
+    views: MaterializedView[];
+};
+export interface MigrateOptions {
+    /** Re-run each materialized view's SELECT as INSERT into its target (backfills MVs over existing data). */
+    populate?: boolean;
+    /** Drop and recreate user tables/views (dev only). Internal tables are kept. */
+    reset?: boolean;
+    log?: (msg: string) => void;
+}
+/**
+ * Create the database, internal bookkeeping tables, user tables and
+ * materialized views. Idempotent (`CREATE ... IF NOT EXISTS`).
+ */
+export declare function migrate(db: Db, schema: SchemaModule | ReadonlyArray<Table<any> | MaterializedView>, options?: MigrateOptions): Promise<void>;
+/** Ordered DDL statements, useful for review or applying with another tool. */
+export declare function schemaDdl(schema: SchemaModule | ReadonlyArray<Table<any> | MaterializedView>, database?: string): string[];
+//# sourceMappingURL=migrate.d.ts.map

package/dist/db/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/db/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2F,KAAK,gBAAgB,EAAE,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChK,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAGtC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,GAAG;IAClG,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACrB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B,CAoBA;AAED,MAAM,WAAW,cAAc;IAC7B,2GAA2G;IAC3G,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCtJ;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAO1H"}

package/dist/db/migrate.js

@@ -0,0 +1,72 @@
+import { isMaterializedView, isTable, materializedViewDdl, materializedViewPopulateSql, tableDdl } from "../schema/index.js";
+import { INTERNAL_TABLES } from "./internal.js";
+export function collectSchema(schema) {
+    let values;
+    if (Array.isArray(schema))
+        values = [...schema];
+    else
+        values = Object.values(schema);
+    const tables = [];
+    const views = [];
+    const seen = new Set();
+    for (const v of values) {
+        if (isTable(v) && !seen.has(v.name)) {
+            seen.add(v.name);
+            tables.push(v);
+        }
+        else if (isMaterializedView(v)) {
+            views.push(v);
+            if (!seen.has(v.to.name)) {
+                seen.add(v.to.name);
+                tables.push(v.to);
+            }
+        }
+    }
+    return { tables, views };
+}
+/**
+ * Create the database, internal bookkeeping tables, user tables and
+ * materialized views. Idempotent (`CREATE ... IF NOT EXISTS`).
+ */
+export async function migrate(db, schema, options = {}) {
+    const log = options.log ?? (() => { });
+    const { tables, views } = collectSchema(schema);
+    await db.createDatabase();
+    for (const t of INTERNAL_TABLES) {
+        await db.command(tableDdl(t, db.database));
+    }
+    if (options.reset) {
+        for (const v of views) {
+            log(`drop view ${v.name}`);
+            await db.command(`DROP VIEW IF EXISTS \`${db.database}\`.\`${v.name}\``);
+        }
+        for (const t of tables) {
+            log(`drop table ${t.name}`);
+            await db.command(`DROP TABLE IF EXISTS \`${db.database}\`.\`${t.name}\``);
+        }
+    }
+    for (const t of tables) {
+        log(`create table ${t.name}`);
+        await db.command(tableDdl(t, db.database));
+    }
+    for (const v of views) {
+        log(`create materialized view ${v.name}`);
+        await db.command(materializedViewDdl(v, db.database));
+    }
+    if (options.populate) {
+        for (const v of views) {
+            log(`populate ${v.name} -> ${v.to.name}`);
+            await db.command(materializedViewPopulateSql(v, db.database));
+        }
+    }
+}
+/** Ordered DDL statements, useful for review or applying with another tool. */
+export function schemaDdl(schema, database) {
+    const { tables, views } = collectSchema(schema);
+    return [
+        ...INTERNAL_TABLES.map((t) => tableDdl(t, database)),
+        ...tables.map((t) => tableDdl(t, database)),
+        ...views.map((v) => materializedViewDdl(v, database)),
+    ];
+}
+//# sourceMappingURL=migrate.js.map

package/dist/db/migrate.js.map

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

package/dist/db/serialize.d.ts

@@ -0,0 +1,14 @@
+import type { Column } from "../schema/column.js";
+import { type Table } from "../schema/table.js";
+export interface RowMeta {
+    chain?: string;
+    block?: number | bigint;
+    version?: number | bigint;
+}
+/** Convert a TS row into the JSONEachRow representation ClickHouse accepts. */
+export declare function serializeRow(table: Table<any>, row: Record<string, unknown>, meta?: RowMeta): Record<string, unknown>;
+export declare function serializeValue(col: Column, value: unknown, path: string): unknown;
+/** Parse a JSONEachRow row (with `date_time_output_format='iso'`) back into TS values. */
+export declare function deserializeRow<T extends Table<any>>(table: T, raw: Record<string, unknown>): Record<string, unknown>;
+export declare function deserializeValue(col: Column, v: unknown): unknown;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/db/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/db/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAsB,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAIpE,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBrH;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAyCjF;AAQD,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQpH;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CA2BjE"}

package/dist/db/serialize.js

@@ -0,0 +1,133 @@
+import { INDEX_META_COLUMNS } from "../schema/table.js";
+import { formatDateTime64 } from "./sql.js";
+import { bigintReplacer } from "../util.js";
+/** Convert a TS row into the JSONEachRow representation ClickHouse accepts. */
+export function serializeRow(table, row, meta) {
+    const out = {};
+    for (const key of table.columnKeys) {
+        const col = table.columns[key];
+        const value = row[key];
+        if (value === undefined) {
+            if (col.hasDefault || col.isNullable)
+                continue;
+            throw new Error(`Table "${table.name}": missing required column "${key}"`);
+        }
+        out[table.columnName(key)] = serializeValue(col, value, `${table.name}.${key}`);
+    }
+    if (table.options.indexMeta !== false) {
+        out[INDEX_META_COLUMNS.chain] = meta?.chain ?? "";
+        let block = 0;
+        if (meta?.block !== undefined)
+            block = Number(meta.block);
+        let version = "0";
+        if (meta?.version !== undefined)
+            version = meta.version.toString();
+        out[INDEX_META_COLUMNS.block] = block;
+        out[INDEX_META_COLUMNS.version] = version;
+    }
+    return out;
+}
+export function serializeValue(col, value, path) {
+    if (value === null) {
+        if (!col.isNullable)
+            throw new Error(`Column ${path} is not nullable`);
+        return null;
+    }
+    switch (col.kind) {
+        case "string":
+        case "hash":
+            return String(value);
+        case "address": {
+            const text = String(value);
+            if (text.startsWith("0x"))
+                return text.toLowerCase();
+            return text;
+        }
+        case "bool":
+            return Boolean(value);
+        case "int":
+        case "float":
+            if (typeof value === "bigint")
+                return Number(value);
+            return value;
+        case "bigint": {
+            if (typeof value === "bigint")
+                return value.toString();
+            if (typeof value === "number")
+                return Math.trunc(value).toString();
+            if (typeof value === "string")
+                return BigInt(value).toString();
+            throw new Error(`Column ${path}: expected bigint, got ${typeof value}`);
+        }
+        case "date": {
+            const d = toDate(value);
+            if (Number.isNaN(d.getTime()))
+                throw new Error(`Column ${path}: invalid date ${String(value)}`);
+            if (col.chType === "Date")
+                return d.toISOString().slice(0, 10);
+            if (col.chType.startsWith("DateTime64"))
+                return formatDateTime64(d);
+            return Math.floor(d.getTime() / 1000);
+        }
+        case "enum":
+            return String(value);
+        case "json":
+            if (typeof value === "string")
+                return value;
+            return JSON.stringify(value, bigintReplacer);
+        case "array":
+            return value.map((v) => serializeValue(col.items, v, path + "[]"));
+    }
+}
+function toDate(value) {
+    if (value instanceof Date)
+        return value;
+    if (typeof value === "number" && value < 1e12)
+        return new Date(value * 1000);
+    return new Date(value);
+}
+/** Parse a JSONEachRow row (with `date_time_output_format='iso'`) back into TS values. */
+export function deserializeRow(table, raw) {
+    const out = {};
+    for (const key of table.columnKeys) {
+        const col = table.columns[key];
+        const v = raw[table.columnName(key)];
+        out[key] = deserializeValue(col, v);
+    }
+    return out;
+}
+export function deserializeValue(col, v) {
+    if (v === null || v === undefined)
+        return null;
+    switch (col.kind) {
+        case "bigint":
+            return BigInt(v);
+        case "int":
+        case "float":
+            return Number(v);
+        case "bool":
+            if (typeof v === "string")
+                return v === "true" || v === "1";
+            return Boolean(v);
+        case "date": {
+            if (typeof v === "number")
+                return new Date(v * 1000);
+            const s = String(v);
+            // 'iso' output: 2024-01-01T00:00:00Z or 2024-01-01 (Date); 'simple': 2024-01-01 00:00:00
+            if (/^\d{4}-\d{2}-\d{2}$/.test(s))
+                return new Date(s + "T00:00:00Z");
+            if (s.includes("T"))
+                return new Date(s);
+            return new Date(s.replace(" ", "T") + "Z");
+        }
+        case "json":
+            if (typeof v === "string")
+                return JSON.parse(v);
+            return v;
+        case "array":
+            return v.map((x) => deserializeValue(col.items, x));
+        default:
+            return v;
+    }
+}
+//# sourceMappingURL=serialize.js.map

package/dist/db/serialize.js.map

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

package/dist/db/sql.d.ts

@@ -0,0 +1,44 @@
+import { type Table } from "../schema/table.js";
+export type SqlValue = string | number | bigint | boolean | Date | null | undefined | SqlValue[];
+export interface SqlFragment {
+    readonly __brand: "yail.sql";
+    readonly strings: ReadonlyArray<string>;
+    readonly values: ReadonlyArray<SqlValue | SqlFragment | Table<any> | SqlRaw>;
+}
+export interface SqlRaw {
+    readonly __brand: "yail.sqlRaw";
+    readonly text: string;
+}
+export declare function isSqlFragment(v: unknown): v is SqlFragment;
+/**
+ * Tagged template for parameterized ClickHouse SQL.
+ *
+ * Interpolated tables render as identifiers, nested fragments are inlined,
+ * everything else becomes a typed `{pN:Type}` query parameter.
+ *
+ * @example
+ * sql`SELECT * FROM ${ledger} WHERE wallet = ${wallet} AND block_number > ${100n}`
+ */
+export declare function sql(strings: TemplateStringsArray, ...values: SqlFragment["values"][number][]): SqlFragment;
+export declare namespace sql {
+    var raw: (text: string) => SqlRaw;
+    var identifier: (name: string) => SqlRaw;
+    var join: (fragments: ReadonlyArray<SqlFragment | SqlRaw>, separator?: string) => SqlFragment;
+    var empty: () => SqlFragment;
+}
+export interface RenderedSql {
+    text: string;
+    params: Record<string, unknown>;
+}
+export interface RenderOptions {
+    /** Inline literals instead of `{pN:Type}` placeholders (needed for DDL such as materialized views). */
+    inline?: boolean;
+    /** Optional database to qualify table identifiers with. */
+    database?: string;
+}
+export declare function renderSql(input: SqlFragment | string, options?: RenderOptions): RenderedSql;
+export declare function literal(v: SqlValue): string;
+/** Backtick-quote a table name, optionally qualified with its database. */
+export declare function qualify(name: string, database?: string): string;
+export declare function formatDateTime64(d: Date): string;
+//# sourceMappingURL=sql.d.ts.map

package/dist/db/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/db/sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,EAAE,CAAC;AAEjG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAE1D;AAKD;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,WAAW,CAE1G;yBAFe,GAAG;oBAKF,MAAM,KAAG,MAAM;2BAGR,MAAM,KAAG,MAAM;0BAGhB,aAAa,CAAC,WAAW,GAAG,MAAM,CAAC,yBAAqB,WAAW;qBAW1E,WAAW;;AAE3B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,uGAAuG;IACvG,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,WAAW,CA2B/F;AAqBD,wBAAgB,OAAO,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAY3C;AAED,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAEhD"}

package/dist/db/sql.js

@@ -0,0 +1,122 @@
+import { isTable } from "../schema/table.js";
+export function isSqlFragment(v) {
+    return typeof v === "object" && v !== null && v.__brand === "yail.sql";
+}
+function isRaw(v) {
+    return typeof v === "object" && v !== null && v.__brand === "yail.sqlRaw";
+}
+/**
+ * Tagged template for parameterized ClickHouse SQL.
+ *
+ * Interpolated tables render as identifiers, nested fragments are inlined,
+ * everything else becomes a typed `{pN:Type}` query parameter.
+ *
+ * @example
+ * sql`SELECT * FROM ${ledger} WHERE wallet = ${wallet} AND block_number > ${100n}`
+ */
+export function sql(strings, ...values) {
+    return { __brand: "yail.sql", strings: [...strings], values };
+}
+/** Insert raw SQL text without parameterization. Use only for trusted, static text. */
+sql.raw = (text) => ({ __brand: "yail.sqlRaw", text });
+/** Quote an identifier (column/table name). */
+sql.identifier = (name) => ({ __brand: "yail.sqlRaw", text: `\`${name.replace(/`/g, "``")}\`` });
+/** Join fragments with a separator (default `, `). */
+sql.join = (fragments, separator = ", ") => {
+    const strings = [""];
+    const values = [];
+    fragments.forEach((f, i) => {
+        if (i > 0)
+            strings[strings.length - 1] += separator;
+        values.push(f);
+        strings.push("");
+    });
+    return { __brand: "yail.sql", strings, values };
+};
+sql.empty = () => ({ __brand: "yail.sql", strings: [""], values: [] });
+export function renderSql(input, options = {}) {
+    if (typeof input === "string")
+        return { text: input, params: {} };
+    const params = {};
+    let counter = 0;
+    const next = () => `p${counter++}`;
+    const render = (frag) => {
+        let out = "";
+        frag.strings.forEach((s, i) => {
+            out += s;
+            if (i < frag.values.length)
+                out += renderValue(frag.values[i]);
+        });
+        return out;
+    };
+    const renderValue = (v) => {
+        if (isSqlFragment(v))
+            return render(v);
+        if (isRaw(v))
+            return v.text;
+        if (isTable(v))
+            return qualify(v.name, options.database);
+        if (options.inline)
+            return literal(v);
+        const name = next();
+        const { type, value } = paramType(v);
+        params[name] = value;
+        return `{${name}:${type}}`;
+    };
+    return { text: render(input), params };
+}
+function paramType(v) {
+    if (v === null || v === undefined)
+        return { type: "Nullable(String)", value: null };
+    if (typeof v === "string")
+        return { type: "String", value: v };
+    if (typeof v === "boolean")
+        return { type: "Bool", value: v };
+    if (typeof v === "bigint")
+        return { type: "Int256", value: v.toString() };
+    if (typeof v === "number") {
+        if (Number.isInteger(v))
+            return { type: "Int64", value: v };
+        return { type: "Float64", value: v };
+    }
+    if (v instanceof Date)
+        return { type: "DateTime64(3)", value: formatDateTime64(v) };
+    if (Array.isArray(v)) {
+        const first = v.find((x) => x !== null && x !== undefined);
+        let inner = "String";
+        if (first !== undefined)
+            inner = paramType(first).type;
+        return { type: `Array(${inner})`, value: v.map((x) => paramType(x).value) };
+    }
+    throw new Error(`Unsupported SQL parameter: ${String(v)}`);
+}
+export function literal(v) {
+    if (v === null || v === undefined)
+        return "NULL";
+    if (typeof v === "string")
+        return `'${v.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+    if (typeof v === "boolean")
+        return String(v);
+    if (typeof v === "bigint")
+        return v.toString();
+    if (typeof v === "number") {
+        if (Number.isFinite(v))
+            return String(v);
+        return "NULL";
+    }
+    if (v instanceof Date)
+        return `'${formatDateTime64(v)}'`;
+    if (Array.isArray(v))
+        return `[${v.map((x) => literal(x)).join(", ")}]`;
+    throw new Error(`Unsupported SQL literal: ${String(v)}`);
+}
+/** Backtick-quote a table name, optionally qualified with its database. */
+export function qualify(name, database) {
+    if (database)
+        return `\`${database}\`.\`${name}\``;
+    return `\`${name}\``;
+}
+export function formatDateTime64(d) {
+    return d.toISOString().replace("T", " ").replace("Z", "");
+}
+//# sourceMappingURL=sql.js.map

package/dist/db/sql.js.map

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

package/dist/http/client.d.ts

@@ -0,0 +1,40 @@
+import type { Db } from "../db/client.js";
+export interface HttpCacheOptions {
+    /** Cache the response. `true` caches forever (right for historical lookups); a number is a TTL in ms. */
+    cache?: boolean | number;
+    /** Extra string mixed into the cache key (e.g. a schema version) to invalidate old entries. */
+    cacheKey?: string;
+}
+export interface HttpResponse {
+    status: number;
+    ok: boolean;
+    headers: Record<string, string>;
+    body: string;
+    cached: boolean;
+    json<T = unknown>(): T;
+}
+/** `fetch` init without the browser `cache` mode, plus YAIL's cache options. */
+export type HttpRequestInit = Omit<RequestInit, "cache"> & HttpCacheOptions;
+export interface HttpClient {
+    get(url: string, init?: HttpRequestInit): Promise<HttpResponse>;
+    post(url: string, body: unknown, init?: HttpRequestInit): Promise<HttpResponse>;
+    fetch(url: string, init?: HttpRequestInit): Promise<HttpResponse>;
+}
+export interface HttpClientOptions {
+    db?: Db;
+    /** Persist to ClickHouse (`_yail_http_cache`). When false, only the in-memory LRU is used. */
+    persist?: boolean;
+    /** In-memory entries. Default 5000. */
+    memorySize?: number;
+    fetch?: typeof fetch;
+    onCache?: (hit: boolean) => void;
+    /** Retries on 429/5xx/network errors. Default 3. */
+    retries?: number;
+}
+/**
+ * HTTP client with an optional response cache. Cached calls are deterministic
+ * across re-indexes, which is what you want for price lookups, swap
+ * classification via aggregator APIs, token metadata, etc.
+ */
+export declare function createHttpClient(options?: HttpClientOptions): HttpClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/http/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAI1C,MAAM,WAAW,gBAAgB;IAC/B,yGAAyG;IACzG,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,CAAC;CACxB;AAED,gFAAgF;AAChF,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC;AAE5E,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAChE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAChF,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,8FAA8F;IAC9F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CA0F5E"}