@notuslabs/yail 0.1.0

package/dist/observability/logger.js

@@ -0,0 +1,72 @@
+import { createLogger, initLogger, log as evlog } from "evlog";
+import { createMemoryDrain, readMemoryLogs } from "evlog/memory";
+import { createOTLPDrain } from "evlog/otlp";
+import { createClickHouseDrain } from "evlog/clickhouse";
+import { Metrics } from "./metrics.js";
+import { decodeOr } from "../util.js";
+let initialized = false;
+const LOGS_TABLE_DDL = `CREATE TABLE IF NOT EXISTS {db}.\`_yail_logs\` (
+  timestamp DateTime64(3),
+  level LowCardinality(String),
+  service LowCardinality(String),
+  environment LowCardinality(String),
+  request_id String,
+  trace_id String,
+  span_id String,
+  method LowCardinality(String),
+  path String,
+  status Nullable(UInt16),
+  duration String,
+  duration_ms UInt32,
+  error_name String,
+  error_message String,
+  data String CODEC(ZSTD(3))
+) ENGINE = MergeTree PARTITION BY toYYYYMM(timestamp) ORDER BY (service, timestamp) TTL toDateTime(timestamp) + INTERVAL 30 DAY`;
+export async function initObservability(config = {}, deps = {}) {
+    const serviceName = config.serviceName ?? "yail";
+    const drains = [createMemoryDrain({ store: "yail", maxEvents: 2000 })];
+    const otlpEndpoint = config.otlpEndpoint ?? process.env.OTEL_EXPORTER_OTLP_ENDPOINT ?? process.env.OTLP_ENDPOINT;
+    if (otlpEndpoint) {
+        drains.push(createOTLPDrain({ endpoint: otlpEndpoint, serviceName, headers: config.otlpHeaders, recordShape: "compact" }));
+    }
+    if (config.logsToClickHouse && deps.db && deps.dbConfig) {
+        await deps.db.command(LOGS_TABLE_DDL.replace("{db}", `\`${deps.db.database}\``));
+        const u = new URL(deps.dbConfig.url);
+        const username = deps.dbConfig.username ?? decodeOr(u.username, "default");
+        const password = deps.dbConfig.password ?? decodeOr(u.password, "");
+        u.username = "";
+        u.password = "";
+        u.pathname = "/";
+        drains.push(createClickHouseDrain({ endpoint: u.toString().replace(/\/$/, ""), database: deps.db.database, table: "_yail_logs", username, password }));
+    }
+    const drain = async (ctx) => {
+        await Promise.allSettled(drains.map((d) => d(ctx)));
+    };
+    if (!initialized) {
+        initLogger({
+            env: { service: serviceName, environment: process.env.NODE_ENV ?? "development" },
+            pretty: config.pretty ?? process.env.NODE_ENV !== "production",
+            minLevel: config.logLevel,
+            // YAIL_QUIET=1 is set by one-shot CLI commands whose stdout must stay machine-readable.
+            silent: process.env.YAIL_QUIET === "1",
+            drain,
+            _suppressDrainWarning: true,
+        });
+        initialized = true;
+    }
+    const metrics = new Metrics(serviceName);
+    return {
+        config: { ...config, serviceName, batchEvents: config.batchEvents ?? true },
+        log: evlog,
+        metrics,
+        wide(context) {
+            return createLogger(context);
+        },
+        recentEvents(limit = 100) {
+            return readMemoryLogs({ store: "yail", limit });
+        },
+    };
+}
+/** Structured error with the evlog fields (`why`, `fix`) so alerts explain themselves. */
+export { createError } from "evlog";
+//# sourceMappingURL=logger.js.map

package/dist/observability/logger.js.map

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

package/dist/observability/metrics.d.ts

@@ -0,0 +1,61 @@
+import { type Meter, type Tracer, type Attributes } from "@opentelemetry/api";
+/**
+ * OpenTelemetry instruments + an in-process snapshot. The OTEL API is a no-op
+ * until an SDK is registered (see `yail/otel`), the snapshot always works and
+ * feeds `GET /status`.
+ */
+export interface ChainStats {
+    cursor: number;
+    head: number;
+    finalized: number;
+    lagBlocks: number;
+    blocksIndexed: number;
+    eventsProcessed: number;
+    batches: number;
+    errors: number;
+    lastBatchMs: number;
+    lastBatchAt?: string;
+    caughtUp: boolean;
+}
+export declare class Metrics {
+    readonly meter: Meter;
+    readonly tracer: Tracer;
+    readonly chains: Map<string, ChainStats>;
+    readonly counters: {
+        sourceRequests: number;
+        cacheHits: number;
+        cacheMisses: number;
+        httpCacheHits: number;
+        httpCacheMisses: number;
+        rpcCacheHits: number;
+        rpcCacheMisses: number;
+        rowsFlushed: number;
+        jobsDone: number;
+        jobsFailed: number;
+    };
+    private blocksIndexed;
+    private eventsProcessed;
+    private batchDuration;
+    private handlerDuration;
+    private flushRows;
+    private flushDuration;
+    private errors;
+    private cacheEvents;
+    private jobEvents;
+    private sourceDuration;
+    constructor(serviceName?: string);
+    chain(name: string): ChainStats;
+    setProgress(chain: string, cursor: number, head: number, finalized: number): void;
+    recordBatch(chain: string, blocks: number, events: number, ms: number, sourceMs: number): void;
+    recordEvent(chain: string, name: string, ms: number): void;
+    recordFlush(table: string, rows: number, ms: number): void;
+    recordError(chain: string | undefined, stage: string): void;
+    recordCache(cache: "source" | "http" | "rpc", hit: boolean): void;
+    recordJob(kind: string, outcome: "done" | "failed"): void;
+    snapshot(): {
+        chains: Record<string, ChainStats>;
+        counters: Metrics["counters"];
+    };
+    span<T>(name: string, attributes: Attributes, fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/observability/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE7G;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AASD,qBAAa,OAAO;IAClB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,0BAAiC;IAChD,QAAQ,CAAC,QAAQ;QAAK,cAAc;QAAK,SAAS;QAAK,WAAW;QAAK,aAAa;QAAK,eAAe;QAAK,YAAY;QAAK,cAAc;QAAK,WAAW;QAAK,QAAQ;QAAK,UAAU;MAAM;IAE9L,OAAO,CAAC,aAAa,CAAC;IACtB,OAAO,CAAC,eAAe,CAAC;IACxB,OAAO,CAAC,aAAa,CAAC;IACtB,OAAO,CAAC,eAAe,CAAC;IACxB,OAAO,CAAC,SAAS,CAAC;IAClB,OAAO,CAAC,aAAa,CAAC;IACtB,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,WAAW,CAAC;IACpB,OAAO,CAAC,SAAS,CAAC;IAClB,OAAO,CAAC,cAAc,CAAC;IAEvB,YAAY,WAAW,SAAS,EA2B/B;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAO9B;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAOhF;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAU7F;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAGzD;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAIzD;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAG1D;IAED,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAUhE;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAIxD;IAED,QAAQ,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;KAAE,CAEhF;IAED,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAY9E;CACF"}

package/dist/observability/metrics.js

@@ -0,0 +1,131 @@
+import { metrics as otelMetrics, trace } from "@opentelemetry/api";
+const CACHE_COUNTERS = {
+    source: ["cacheHits", "cacheMisses"],
+    http: ["httpCacheHits", "httpCacheMisses"],
+    rpc: ["rpcCacheHits", "rpcCacheMisses"],
+};
+export class Metrics {
+    meter;
+    tracer;
+    chains = new Map();
+    counters = { sourceRequests: 0, cacheHits: 0, cacheMisses: 0, httpCacheHits: 0, httpCacheMisses: 0, rpcCacheHits: 0, rpcCacheMisses: 0, rowsFlushed: 0, jobsDone: 0, jobsFailed: 0 };
+    blocksIndexed;
+    eventsProcessed;
+    batchDuration;
+    handlerDuration;
+    flushRows;
+    flushDuration;
+    errors;
+    cacheEvents;
+    jobEvents;
+    sourceDuration;
+    constructor(serviceName = "yail") {
+        this.meter = otelMetrics.getMeter(serviceName);
+        this.tracer = trace.getTracer(serviceName);
+        const m = this.meter;
+        this.blocksIndexed = m.createCounter("yail.blocks.indexed", { description: "Blocks indexed", unit: "{block}" });
+        this.eventsProcessed = m.createCounter("yail.events.processed", { description: "Events dispatched to handlers", unit: "{event}" });
+        this.batchDuration = m.createHistogram("yail.batch.duration", { description: "Source batch end-to-end processing time", unit: "ms" });
+        this.handlerDuration = m.createHistogram("yail.handler.duration", { description: "Handler execution time", unit: "ms" });
+        this.flushRows = m.createCounter("yail.flush.rows", { description: "Rows written to ClickHouse", unit: "{row}" });
+        this.flushDuration = m.createHistogram("yail.flush.duration", { description: "ClickHouse insert time per table", unit: "ms" });
+        this.errors = m.createCounter("yail.errors", { description: "Errors by stage" });
+        this.cacheEvents = m.createCounter("yail.cache.events", { description: "Cache hits/misses by cache" });
+        this.jobEvents = m.createCounter("yail.jobs", { description: "Backfill / reindex jobs by outcome" });
+        this.sourceDuration = m.createHistogram("yail.source.duration", { description: "Time waiting on the data source per batch", unit: "ms" });
+        m.createObservableGauge("yail.chain.head", { description: "Source head block" }).addCallback((r) => {
+            for (const [chain, s] of this.chains)
+                r.observe(s.head, { chain });
+        });
+        m.createObservableGauge("yail.chain.cursor", { description: "Next block to index" }).addCallback((r) => {
+            for (const [chain, s] of this.chains)
+                r.observe(s.cursor, { chain });
+        });
+        m.createObservableGauge("yail.chain.lag_blocks", { description: "finalized head - cursor. Alert when this grows." }).addCallback((r) => {
+            for (const [chain, s] of this.chains)
+                r.observe(s.lagBlocks, { chain });
+        });
+        m.createObservableGauge("yail.chain.caught_up", { description: "1 when the chain is at the finalized head" }).addCallback((r) => {
+            for (const [chain, s] of this.chains)
+                r.observe(Number(s.caughtUp), { chain });
+        });
+    }
+    chain(name) {
+        let s = this.chains.get(name);
+        if (!s) {
+            s = { cursor: 0, head: 0, finalized: 0, lagBlocks: 0, blocksIndexed: 0, eventsProcessed: 0, batches: 0, errors: 0, lastBatchMs: 0, caughtUp: false };
+            this.chains.set(name, s);
+        }
+        return s;
+    }
+    setProgress(chain, cursor, head, finalized) {
+        const s = this.chain(chain);
+        s.cursor = cursor;
+        s.head = head;
+        s.finalized = finalized;
+        s.lagBlocks = Math.max(0, finalized + 1 - cursor);
+        s.caughtUp = cursor > finalized;
+    }
+    recordBatch(chain, blocks, events, ms, sourceMs) {
+        const s = this.chain(chain);
+        s.blocksIndexed += blocks;
+        s.eventsProcessed += events;
+        s.batches++;
+        s.lastBatchMs = ms;
+        s.lastBatchAt = new Date().toISOString();
+        this.blocksIndexed.add(blocks, { chain });
+        this.batchDuration.record(ms, { chain });
+        this.sourceDuration.record(sourceMs, { chain });
+    }
+    recordEvent(chain, name, ms) {
+        this.eventsProcessed.add(1, { chain, event: name });
+        this.handlerDuration.record(ms, { chain, event: name });
+    }
+    recordFlush(table, rows, ms) {
+        this.counters.rowsFlushed += rows;
+        this.flushRows.add(rows, { table });
+        this.flushDuration.record(ms, { table });
+    }
+    recordError(chain, stage) {
+        if (chain)
+            this.chain(chain).errors++;
+        this.errors.add(1, { chain: chain ?? "", stage });
+    }
+    recordCache(cache, hit) {
+        const [hitCounter, missCounter] = CACHE_COUNTERS[cache];
+        let result = "miss";
+        let counter = missCounter;
+        if (hit) {
+            result = "hit";
+            counter = hitCounter;
+        }
+        this.counters[counter]++;
+        this.cacheEvents.add(1, { cache, result });
+    }
+    recordJob(kind, outcome) {
+        if (outcome === "done")
+            this.counters.jobsDone++;
+        else
+            this.counters.jobsFailed++;
+        this.jobEvents.add(1, { kind, outcome });
+    }
+    snapshot() {
+        return { chains: Object.fromEntries(this.chains), counters: { ...this.counters } };
+    }
+    span(name, attributes, fn) {
+        return this.tracer.startActiveSpan(name, { attributes }, async (span) => {
+            try {
+                return await fn();
+            }
+            catch (err) {
+                span.recordException(err);
+                span.setStatus({ code: 2, message: err.message });
+                throw err;
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/observability/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,KAAK,EAA4C,MAAM,oBAAoB,CAAC;AAsB7G,MAAM,cAAc,GAAkE;IACpF,MAAM,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC;IACpC,IAAI,EAAE,CAAC,eAAe,EAAE,iBAAiB,CAAC;IAC1C,GAAG,EAAE,CAAC,cAAc,EAAE,gBAAgB,CAAC;CACxC,CAAC;AAEF,MAAM,OAAO,OAAO;IACT,KAAK,CAAQ;IACb,MAAM,CAAS;IACf,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IACvC,QAAQ,GAAG,EAAE,cAAc,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAEtL,aAAa,CAAC;IACd,eAAe,CAAC;IAChB,aAAa,CAAC;IACd,eAAe,CAAC;IAChB,SAAS,CAAC;IACV,aAAa,CAAC;IACd,MAAM,CAAC;IACP,WAAW,CAAC;IACZ,SAAS,CAAC;IACV,cAAc,CAAC;IAEvB,YAAY,WAAW,GAAG,MAAM;QAC9B,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC,qBAAqB,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAChH,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,aAAa,CAAC,uBAAuB,EAAE,EAAE,WAAW,EAAE,+BAA+B,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACnI,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,eAAe,CAAC,qBAAqB,EAAE,EAAE,WAAW,EAAE,yCAAyC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACtI,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,eAAe,CAAC,uBAAuB,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACzH,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,aAAa,CAAC,iBAAiB,EAAE,EAAE,WAAW,EAAE,4BAA4B,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAClH,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,eAAe,CAAC,qBAAqB,EAAE,EAAE,WAAW,EAAE,kCAAkC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/H,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,aAAa,CAAC,aAAa,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACjF,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,mBAAmB,EAAE,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC,CAAC;QACvG,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC,CAAC;QACrG,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,eAAe,CAAC,sBAAsB,EAAE,EAAE,WAAW,EAAE,2CAA2C,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1I,CAAC,CAAC,qBAAqB,CAAC,iBAAiB,EAAE,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;YACjG,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM;gBAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,qBAAqB,CAAC,mBAAmB,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;YACrG,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM;gBAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,qBAAqB,CAAC,uBAAuB,EAAE,EAAE,WAAW,EAAE,iDAAiD,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;YACrI,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM;gBAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,qBAAqB,CAAC,sBAAsB,EAAE,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;YAC9H,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM;gBAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YACrJ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,WAAW,CAAC,KAAa,EAAE,MAAc,EAAE,IAAY,EAAE,SAAiB;QACxE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;QAClB,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;QACd,CAAC,CAAC,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QAClD,CAAC,CAAC,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAClC,CAAC;IAED,WAAW,CAAC,KAAa,EAAE,MAAc,EAAE,MAAc,EAAE,EAAU,EAAE,QAAgB;QACrF,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC,CAAC,aAAa,IAAI,MAAM,CAAC;QAC1B,CAAC,CAAC,eAAe,IAAI,MAAM,CAAC;QAC5B,CAAC,CAAC,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,WAAW,GAAG,EAAE,CAAC;QACnB,CAAC,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,WAAW,CAAC,KAAa,EAAE,IAAY,EAAE,EAAU;QACjD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,WAAW,CAAC,KAAa,EAAE,IAAY,EAAE,EAAU;QACjD,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,IAAI,CAAC;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,WAAW,CAAC,KAAyB,EAAE,KAAa;QAClD,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,WAAW,CAAC,KAAgC,EAAE,GAAY;QACxD,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,MAAM,GAAG,MAAM,CAAC;QACpB,IAAI,OAAO,GAAG,WAAW,CAAC;QAC1B,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,GAAG,KAAK,CAAC;YACf,OAAO,GAAG,UAAU,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,OAA0B;QAChD,IAAI,OAAO,KAAK,MAAM;YAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;;YAC5C,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;IACrF,CAAC;IAED,IAAI,CAAI,IAAY,EAAE,UAAsB,EAAE,EAAoB;QAChE,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtE,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAC;YACpB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,eAAe,CAAC,GAAY,CAAC,CAAC;gBACnC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC7D,MAAM,GAAG,CAAC;YACZ,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/observability/otel.d.ts

@@ -0,0 +1,28 @@
+import { type MetricReader } from "@opentelemetry/sdk-metrics";
+export interface TelemetryOptions {
+    serviceName?: string;
+    serviceVersion?: string;
+    /** OTLP HTTP base endpoint, e.g. http://localhost:4318. Falls back to OTEL_EXPORTER_OTLP_ENDPOINT. */
+    endpoint?: string;
+    headers?: Record<string, string>;
+    /** Metric export interval in ms. Default 15000. */
+    metricsIntervalMs?: number;
+    /** Extra metric readers (e.g. a Prometheus exporter). */
+    metricReaders?: MetricReader[];
+    /** Extra resource attributes (deployment.environment, ...). */
+    resourceAttributes?: Record<string, string>;
+}
+/**
+ * Register the OpenTelemetry SDK so `yail` metrics and traces are exported over
+ * OTLP/HTTP. Call this once at process start (before `indexer.start()`).
+ * Logs go through evlog's OTLP drain, configured by `observability.otlpEndpoint`.
+ *
+ * @example
+ * import { startTelemetry } from "@notuslabs/yail/otel";
+ * const telemetry = startTelemetry({ serviceName: "wallet-ledger", endpoint: "http://otel-collector:4318" });
+ * process.on("SIGTERM", () => telemetry.shutdown());
+ */
+export declare function startTelemetry(options?: TelemetryOptions): {
+    shutdown(): Promise<void>;
+};
+//# sourceMappingURL=otel.d.ts.map

package/dist/observability/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../../src/observability/otel.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI9F,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sGAAsG;IACtG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG;IAAE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAmB5F"}

package/dist/observability/otel.js

@@ -0,0 +1,49 @@
+import { NodeSDK } from "@opentelemetry/sdk-node";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from "@opentelemetry/semantic-conventions";
+/**
+ * Register the OpenTelemetry SDK so `yail` metrics and traces are exported over
+ * OTLP/HTTP. Call this once at process start (before `indexer.start()`).
+ * Logs go through evlog's OTLP drain, configured by `observability.otlpEndpoint`.
+ *
+ * @example
+ * import { startTelemetry } from "@notuslabs/yail/otel";
+ * const telemetry = startTelemetry({ serviceName: "wallet-ledger", endpoint: "http://otel-collector:4318" });
+ * process.on("SIGTERM", () => telemetry.shutdown());
+ */
+export function startTelemetry(options = {}) {
+    const endpoint = (options.endpoint ?? process.env.OTEL_EXPORTER_OTLP_ENDPOINT ?? "http://localhost:4318").replace(/\/$/, "");
+    const serviceName = options.serviceName ?? process.env.OTEL_SERVICE_NAME ?? "yail";
+    const headers = options.headers ?? parseHeaders(process.env.OTEL_EXPORTER_OTLP_HEADERS);
+    const attributes = { [ATTR_SERVICE_NAME]: serviceName, ...(options.resourceAttributes ?? {}) };
+    if (options.serviceVersion)
+        attributes[ATTR_SERVICE_VERSION] = options.serviceVersion;
+    const sdk = new NodeSDK({
+        resource: resourceFromAttributes(attributes),
+        traceExporter: new OTLPTraceExporter({ url: `${endpoint}/v1/traces`, headers }),
+        metricReaders: [
+            new PeriodicExportingMetricReader({
+                exporter: new OTLPMetricExporter({ url: `${endpoint}/v1/metrics`, headers }),
+                exportIntervalMillis: options.metricsIntervalMs ?? 15_000,
+            }),
+            ...(options.metricReaders ?? []),
+        ],
+    });
+    sdk.start();
+    return { shutdown: () => sdk.shutdown() };
+}
+function parseHeaders(raw) {
+    if (!raw)
+        return undefined;
+    const out = {};
+    for (const pair of raw.split(",")) {
+        const [k, ...rest] = pair.split("=");
+        if (k && rest.length)
+            out[k.trim()] = decodeURIComponent(rest.join("=").trim());
+    }
+    return out;
+}
+//# sourceMappingURL=otel.js.map

package/dist/observability/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.js","sourceRoot":"","sources":["../../src/observability/otel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,6BAA6B,EAAqB,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAgB9F;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO,GAAqB,EAAE;IAC3D,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,uBAAuB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7H,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM,CAAC;IACnF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACxF,MAAM,UAAU,GAA2B,EAAE,CAAC,iBAAiB,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAC,EAAE,CAAC;IACvH,IAAI,OAAO,CAAC,cAAc;QAAE,UAAU,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IACtF,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC;QACtB,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC;QAC5C,aAAa,EAAE,IAAI,iBAAiB,CAAC,EAAE,GAAG,EAAE,GAAG,QAAQ,YAAY,EAAE,OAAO,EAAE,CAAC;QAC/E,aAAa,EAAE;YACb,IAAI,6BAA6B,CAAC;gBAChC,QAAQ,EAAE,IAAI,kBAAkB,CAAC,EAAE,GAAG,EAAE,GAAG,QAAQ,aAAa,EAAE,OAAO,EAAE,CAAC;gBAC5E,oBAAoB,EAAE,OAAO,CAAC,iBAAiB,IAAI,MAAM;aAC1D,CAAC;YACF,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;SACjC;KACF,CAAC,CAAC;IACH,GAAG,CAAC,KAAK,EAAE,CAAC;IACZ,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM;YAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/rpc/cached-client.d.ts

@@ -0,0 +1,33 @@
+import { decodeFunctionResult, type Abi, type ContractFunctionArgs, type ContractFunctionName, type PublicClient } from "viem";
+import type { Db } from "../db/client.js";
+export interface ReadContractParams<abi extends Abi, fn extends ContractFunctionName<abi, "pure" | "view">> {
+    address: string;
+    abi: abi;
+    functionName: fn;
+    args?: ContractFunctionArgs<abi, "pure" | "view", fn>;
+    /** Block to read at. Defaults to the block of the event being processed. */
+    blockNumber?: number | bigint;
+    /** Bypass the cache for this call. */
+    noCache?: boolean;
+}
+export interface CachedClient {
+    /** Underlying viem client for anything else. */
+    readonly raw: PublicClient;
+    /** `eth_call` cached by (chain, block, to, calldata) in ClickHouse. Typed like viem's readContract. */
+    readContract<abi extends Abi, fn extends ContractFunctionName<abi, "pure" | "view">>(params: ReadContractParams<abi, fn>): Promise<ReturnType<typeof decodeFunctionResult<abi, fn>>>;
+    /** Contract reads with the same block/cache semantics, run in parallel. */
+    multicall<T extends ReadonlyArray<ReadContractParams<any, any>>>(calls: T): Promise<{
+        [K in keyof T]: unknown;
+    }>;
+}
+export interface CachedClientOptions {
+    chain: string;
+    url: string;
+    db?: Db;
+    persist?: boolean;
+    onCache?: (hit: boolean) => void;
+    /** Provided by the runtime: the block currently being processed. */
+    currentBlock?: () => number | undefined;
+}
+export declare function createCachedClient(options: CachedClientOptions): CachedClient;
+//# sourceMappingURL=cached-client.d.ts.map

package/dist/rpc/cached-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-client.d.ts","sourceRoot":"","sources":["../../src/rpc/cached-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,oBAAoB,EAA4B,KAAK,GAAG,EAAE,KAAK,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAC7K,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAI1C,MAAM,WAAW,kBAAkB,CAAC,GAAG,SAAS,GAAG,EAAE,EAAE,SAAS,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACxG,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,GAAG,CAAC;IACT,YAAY,EAAE,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;IACtD,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,uGAAuG;IACvG,YAAY,CAAC,GAAG,SAAS,GAAG,EAAE,EAAE,SAAS,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,EACjF,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,EAAE,CAAC,GAClC,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,2EAA2E;IAC3E,SAAS,CAAC,CAAC,SAAS,aAAa,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO;KAAE,CAAC,CAAC;CAClH;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CA6C7E"}

package/dist/rpc/cached-client.js

@@ -0,0 +1,50 @@
+import { createPublicClient, decodeFunctionResult, encodeFunctionData, http } from "viem";
+import { rpcCache } from "../db/internal.js";
+import { sql } from "../db/sql.js";
+export function createCachedClient(options) {
+    const raw = createPublicClient({ transport: http(options.url, { batch: true, retryCount: 4 }) });
+    const persist = options.persist !== false && options.db !== undefined;
+    const memory = new Map();
+    async function readContract(params) {
+        const data = encodeFunctionData({ abi: params.abi, functionName: params.functionName, args: params.args });
+        const blockNumber = params.blockNumber ?? options.currentBlock?.();
+        const to = params.address.toLowerCase();
+        let block;
+        if (blockNumber !== undefined)
+            block = Number(blockNumber);
+        let key;
+        if (block !== undefined)
+            key = `${block}:${to}:${data}`;
+        let result;
+        if (key && !params.noCache) {
+            result = memory.get(key);
+            if (result === undefined && persist) {
+                const rows = await options.db.query(sql `SELECT result FROM ${rpcCache} FINAL WHERE chain = ${options.chain} AND block = ${block} AND to = ${to} AND data = ${data} LIMIT 1`);
+                result = rows[0]?.result;
+                if (result !== undefined)
+                    memory.set(key, result);
+            }
+            options.onCache?.(result !== undefined);
+        }
+        if (result === undefined) {
+            let blockTag;
+            if (block !== undefined)
+                blockTag = BigInt(block);
+            const res = await raw.call({ to: to, data, blockNumber: blockTag });
+            result = res.data ?? "0x";
+            if (key && !params.noCache) {
+                memory.set(key, result);
+                if (persist) {
+                    await options.db.insert(rpcCache).values({ chain: options.chain, block: BigInt(block), to, data, result, createdAt: new Date() });
+                }
+            }
+        }
+        return decodeFunctionResult({ abi: params.abi, functionName: params.functionName, data: result });
+    }
+    return {
+        raw,
+        readContract: readContract,
+        multicall: (calls) => Promise.all(calls.map((c) => readContract(c))),
+    };
+}
+//# sourceMappingURL=cached-client.js.map

package/dist/rpc/cached-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-client.js","sourceRoot":"","sources":["../../src/rpc/cached-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,IAAI,EAAqF,MAAM,MAAM,CAAC;AAE7K,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAkCnC,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACjG,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK,IAAI,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC;IACtE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,KAAK,UAAU,YAAY,CAAC,MAAoC;QAC9D,MAAM,IAAI,GAAG,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,IAAW,EAAE,CAAC,CAAC;QAClH,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;QACnE,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,KAAyB,CAAC;QAC9B,IAAI,WAAW,KAAK,SAAS;YAAE,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,GAAuB,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,GAAG,GAAG,KAAK,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QACxD,IAAI,MAA0B,CAAC;QAC/B,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,EAAE,CAAC;gBACpC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,EAAG,CAAC,KAAK,CAClC,GAAG,CAAA,sBAAsB,QAAQ,wBAAwB,OAAO,CAAC,KAAK,gBAAgB,KAAM,aAAa,EAAE,eAAe,IAAI,UAAU,CACzI,CAAC;gBACF,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;gBACzB,IAAI,MAAM,KAAK,SAAS;oBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,QAA4B,CAAC;YACjC,IAAI,KAAK,KAAK,SAAS;gBAAE,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAClD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAmB,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;YACrF,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC;YAC1B,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBACxB,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,OAAO,CAAC,EAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;gBACtI,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,oBAAoB,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,MAAuB,EAAE,CAAC,CAAC;IACrH,CAAC;IAED,OAAO;QACL,GAAG;QACH,YAAY,EAAE,YAA4C;QAC1D,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAQ;KAC5E,CAAC;AACJ,CAAC"}

package/dist/schema/column.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Column builders for the YAIL schema DSL.
+ *
+ * Each builder carries two things: the ClickHouse type it maps to, and a
+ * phantom TypeScript type used to infer row types (`InferRow<typeof table>`).
+ * Serialization to/from ClickHouse's JSONEachRow format is driven by `kind`.
+ */
+export type ColumnKind = "string" | "address" | "hash" | "bool" | "int" | "bigint" | "float" | "date" | "enum" | "json" | "array";
+export interface Column<T = unknown, Nullable extends boolean = boolean, HasDefault extends boolean = boolean> {
+    readonly __type?: T;
+    readonly kind: ColumnKind;
+    readonly chType: string;
+    readonly isNullable: Nullable;
+    readonly hasDefault: HasDefault;
+    readonly defaultSql?: string;
+    readonly codecSql?: string;
+    readonly isLowCardinality: boolean;
+    readonly items?: Column;
+}
+type Builder<T, N extends boolean, D extends boolean> = Column<T, N, D> & {
+    nullable(): Builder<T, true, D>;
+    /** Column default (raw ClickHouse expression). Rows may omit the column on insert. */
+    default(sql: string): Builder<T, N, true>;
+    codec(codec: string): Builder<T, N, D>;
+    lowCardinality(): Builder<T, N, D>;
+};
+export declare const t: {
+    readonly string: () => Builder<string, false, false>;
+    /** Lowercased hex address (EVM) or plain address string (Bitcoin). */
+    readonly address: () => Builder<string, false, false>;
+    /** 0x-prefixed hex hash. */
+    readonly hash: () => Builder<string, false, false>;
+    readonly bool: () => Builder<boolean, false, false>;
+    readonly uint8: () => Builder<number, false, false>;
+    readonly uint16: () => Builder<number, false, false>;
+    readonly uint32: () => Builder<number, false, false>;
+    readonly int8: () => Builder<number, false, false>;
+    readonly int16: () => Builder<number, false, false>;
+    readonly int32: () => Builder<number, false, false>;
+    readonly uint64: () => Builder<bigint, false, false>;
+    readonly int64: () => Builder<bigint, false, false>;
+    readonly uint128: () => Builder<bigint, false, false>;
+    readonly int128: () => Builder<bigint, false, false>;
+    readonly uint256: () => Builder<bigint, false, false>;
+    readonly int256: () => Builder<bigint, false, false>;
+    /** Alias for int256: the safe default for any EVM amount, signed so deltas fit. */
+    readonly bigint: () => Builder<bigint, false, false>;
+    readonly float32: () => Builder<number, false, false>;
+    readonly float64: () => Builder<number, false, false>;
+    /** Decimal with given precision/scale, exposed as string to avoid float loss. */
+    readonly decimal: (precision: number, scale: number) => Builder<string, false, false>;
+    readonly date: () => Builder<Date, false, false>;
+    readonly dateTime: () => Builder<Date, false, false>;
+    readonly dateTime64: (precision?: number) => Builder<Date, false, false>;
+    readonly enum: <const V extends readonly string[]>(values: V) => Builder<V[number], false, false>;
+    readonly json: <T = unknown>() => Builder<T, false, false>;
+    readonly array: <C extends Column<any, boolean, boolean>>(items: C) => Builder<NonNullable<C["__type"]>[], false, false>;
+};
+export declare function columnTypeSql(col: Column): string;
+export {};
+//# sourceMappingURL=column.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"column.d.ts","sourceRoot":"","sources":["../../src/schema/column.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,SAAS,GACT,MAAM,GACN,MAAM,GACN,KAAK,GACL,QAAQ,GACR,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,SAAS,OAAO,GAAG,OAAO,EAAE,UAAU,SAAS,OAAO,GAAG,OAAO;IAC3G,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,OAAO,IAAI,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG;IACxE,QAAQ,IAAI,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChC,sFAAsF;IACtF,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACvC,cAAc,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;CACpC,CAAC;AAgCF,eAAO,MAAM,CAAC;aACZ,MAAM;IACN,sEAAsE;aACtE,OAAO;IACP,4BAA4B;aAC5B,IAAI;aACJ,IAAI;aACJ,KAAK;aACL,MAAM;aACN,MAAM;aACN,IAAI;aACJ,KAAK;aACL,KAAK;aACL,MAAM;aACN,KAAK;aACL,OAAO;aACP,MAAM;aACN,OAAO;aACP,MAAM;IACN,mFAAmF;aACnF,MAAM;aACN,OAAO;aACP,OAAO;IACP,iFAAiF;aACjF,OAAO,cAAc,MAAM,SAAS,MAAM;aAC1C,IAAI;aACJ,QAAQ;aACR,UAAU;aACV,IAAI,GAAG,KAAK,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,UAAU,CAAC;aAEnD,IAAI,GAAG,CAAC,GAAG,OAAO;aAClB,KAAK,GAAG,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC;CAEjD,CAAC;AAEX,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKjD"}

package/dist/schema/column.js

@@ -0,0 +1,76 @@
+/**
+ * Column builders for the YAIL schema DSL.
+ *
+ * Each builder carries two things: the ClickHouse type it maps to, and a
+ * phantom TypeScript type used to infer row types (`InferRow<typeof table>`).
+ * Serialization to/from ClickHouse's JSONEachRow format is driven by `kind`.
+ */
+function make(kind, chType, extra = {}) {
+    const col = {
+        kind,
+        chType,
+        isNullable: false,
+        hasDefault: false,
+        isLowCardinality: false,
+        ...extra,
+    };
+    return withMethods(col);
+}
+function withMethods(col) {
+    return {
+        ...col,
+        nullable() {
+            return withMethods({ ...col, isNullable: true });
+        },
+        default(sql) {
+            return withMethods({ ...col, hasDefault: true, defaultSql: sql });
+        },
+        codec(codec) {
+            return withMethods({ ...col, codecSql: codec });
+        },
+        lowCardinality() {
+            return withMethods({ ...col, isLowCardinality: true });
+        },
+    };
+}
+export const t = {
+    string: () => make("string", "String"),
+    /** Lowercased hex address (EVM) or plain address string (Bitcoin). */
+    address: () => make("address", "String"),
+    /** 0x-prefixed hex hash. */
+    hash: () => make("hash", "String"),
+    bool: () => make("bool", "Bool"),
+    uint8: () => make("int", "UInt8"),
+    uint16: () => make("int", "UInt16"),
+    uint32: () => make("int", "UInt32"),
+    int8: () => make("int", "Int8"),
+    int16: () => make("int", "Int16"),
+    int32: () => make("int", "Int32"),
+    uint64: () => make("bigint", "UInt64"),
+    int64: () => make("bigint", "Int64"),
+    uint128: () => make("bigint", "UInt128"),
+    int128: () => make("bigint", "Int128"),
+    uint256: () => make("bigint", "UInt256"),
+    int256: () => make("bigint", "Int256"),
+    /** Alias for int256: the safe default for any EVM amount, signed so deltas fit. */
+    bigint: () => make("bigint", "Int256"),
+    float32: () => make("float", "Float32"),
+    float64: () => make("float", "Float64"),
+    /** Decimal with given precision/scale, exposed as string to avoid float loss. */
+    decimal: (precision, scale) => make("string", `Decimal(${precision}, ${scale})`),
+    date: () => make("date", "Date"),
+    dateTime: () => make("date", "DateTime"),
+    dateTime64: (precision = 3) => make("date", `DateTime64(${precision})`),
+    enum: (values) => make("enum", `Enum8(${values.map((v, i) => `'${v}' = ${i + 1}`).join(", ")})`),
+    json: () => make("json", "String"),
+    array: (items) => make("array", `Array(${columnTypeSql(items)})`, { items }),
+};
+export function columnTypeSql(col) {
+    let type = col.chType;
+    if (col.isLowCardinality)
+        type = `LowCardinality(${type})`;
+    if (col.isNullable)
+        type = `Nullable(${type})`;
+    return type;
+}
+//# sourceMappingURL=column.js.map

package/dist/schema/column.js.map

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