ponder 0.9.4 → 0.9.5-debug.1

package/dist/types/indexing/service.d.ts

@@ -0,0 +1,73 @@
+import type { IndexingStore } from '../indexing-store/index.js';
+import type { Common } from '../internal/common.js';
+import type { Event, IndexingBuild, IndexingFunctions, Network, Schema, Source } from '../internal/types.js';
+import type { SyncStore } from '../sync-store/index.js';
+import type { Db } from '../types/db.js';
+import type { RequestQueue } from '../utils/requestQueue.js';
+import { type Abi, type Address } from "viem";
+import type { ReadOnlyClient } from "./ponderActions.js";
+export type Context = {
+    network: {
+        chainId: number;
+        name: string;
+    };
+    client: ReadOnlyClient;
+    db: Db<Schema>;
+    contracts: Record<string, {
+        abi: Abi;
+        address?: Address | readonly Address[];
+        startBlock?: number;
+        endBlock?: number;
+    }>;
+};
+export type Service = {
+    common: Common;
+    indexingFunctions: IndexingFunctions;
+    eventCount: {
+        [eventName: string]: number;
+    };
+    /**
+     * Reduce memory usage by reserving space for objects ahead of time
+     * instead of creating a new one for each event.
+     */
+    currentEvent: {
+        contextState: {
+            blockNumber: bigint;
+        };
+        context: Context;
+    };
+    networkByChainId: {
+        [chainId: number]: Network;
+    };
+    clientByChainId: {
+        [chainId: number]: Context["client"];
+    };
+    contractsByChainId: {
+        [chainId: number]: Context["contracts"];
+    };
+};
+export declare const create: ({ common, indexingBuild: { sources, networks, indexingFunctions }, requestQueues, syncStore, }: {
+    common: Common;
+    indexingBuild: Pick<IndexingBuild, "sources" | "networks" | "indexingFunctions">;
+    requestQueues: RequestQueue[];
+    syncStore: SyncStore;
+}) => Service;
+export declare const processSetupEvents: (indexingService: Service, { sources, networks, }: {
+    sources: Source[];
+    networks: Network[];
+}) => Promise<{
+    status: "error";
+    error: Error;
+} | {
+    status: "success";
+}>;
+export declare const processEvents: (indexingService: Service, { events }: {
+    events: Event[];
+}) => Promise<{
+    status: "error";
+    error: Error;
+} | {
+    status: "success";
+}>;
+export declare const setIndexingStore: (indexingService: Service, indexingStore: IndexingStore<"historical" | "realtime">) => void;
+//# sourceMappingURL=service.d.ts.map

package/dist/types/indexing/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/indexing/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAEV,KAAK,EACL,aAAa,EACb,iBAAiB,EACjB,OAAO,EACP,MAAM,EAEN,MAAM,EACP,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AASxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,OAAO,EAAgB,MAAM,MAAM,CAAC;AAG5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,MAAM,EAAE,cAAc,CAAC;IACvB,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IACf,SAAS,EAAE,MAAM,CACf,MAAM,EACN;QACE,GAAG,EAAE,GAAG,CAAC;QACT,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,OAAO,EAAE,CAAC;QACvC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CACF,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IAEpB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,iBAAiB,CAAC;IAGrC,UAAU,EAAE;QACV,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;KAC7B,CAAC;IAEF;;;OAGG;IACH,YAAY,EAAE;QACZ,YAAY,EAAE;YACZ,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;QACF,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IAGF,gBAAgB,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACjD,eAAe,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAC;IAC1D,kBAAkB,EAAE;QAAE,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;KAAE,CAAC;CACjE,CAAC;AAEF,eAAO,MAAM,MAAM;YAMT,MAAM;mBACC,KACb,aAAa,EACb,SAAS,GAAG,UAAU,GAAG,mBAAmB,CAC7C;mBACc,YAAY,EAAE;eAClB,SAAS;MAClB,OAyFH,CAAC;AAEF,eAAO,MAAM,kBAAkB,oBACZ,OAAO;aAKb,MAAM,EAAE;cACP,OAAO,EAAE;MAEpB,QAAQ;IAAE,QAAQ,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,QAAQ,SAAS,CAAA;CAAE,CAyCnE,CAAC;AAEF,eAAO,MAAM,aAAa,oBACP,OAAO;YACF,KAAK,EAAE;MAC5B,QAAQ;IAAE,QAAQ,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,QAAQ,SAAS,CAAA;CAAE,CAyBnE,CAAC;AAEF,eAAO,MAAM,gBAAgB,oBACV,OAAO,iBACT,cAAc,YAAY,GAAG,UAAU,CAAC,SASxD,CAAC"}

package/dist/types/indexing-store/historical.d.ts

@@ -0,0 +1,19 @@
+import type { Database } from '../database/index.js';
+import type { Common } from '../internal/common.js';
+import type { SchemaBuild } from '../internal/types.js';
+import { type Column } from "drizzle-orm";
+import { type IndexingStore } from "./index.js";
+declare enum EntryType {
+    INSERT = 0,
+    UPDATE = 1,
+    FIND = 2
+}
+export declare const normalizeColumn: (column: Column, value: unknown, type: EntryType) => unknown;
+export declare const createHistoricalIndexingStore: ({ common, schemaBuild: { schema }, database, isDatabaseEmpty, }: {
+    common: Common;
+    schemaBuild: Pick<SchemaBuild, "schema">;
+    database: Database;
+    isDatabaseEmpty: boolean;
+}) => IndexingStore<"historical">;
+export {};
+//# sourceMappingURL=historical.d.ts.map

package/dist/types/indexing-store/historical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historical.d.ts","sourceRoot":"","sources":["../../../src/indexing-store/historical.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAUnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EACL,KAAK,MAAM,EAUZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,YAAY,CAAC;AAE/D,aAAK,SAAS;IACZ,MAAM,IAAI;IACV,MAAM,IAAI;IACV,IAAI,IAAI;CACT;AAgFD,eAAO,MAAM,eAAe,WAClB,MAAM,SACP,OAAO,QACR,SAAS,KAEd,OAmBF,CAAC;AAEF,eAAO,MAAM,6BAA6B;YAMhC,MAAM;iBACD,KAAK,WAAW,EAAE,QAAQ,CAAC;cAC9B,QAAQ;qBACD,OAAO;MACtB,cAAc,YAAY,CAgtB7B,CAAC"}

package/dist/types/indexing-store/index.d.ts

@@ -0,0 +1,10 @@
+import type { Schema } from '../internal/types.js';
+import type { Db } from '../types/db.js';
+export type IndexingStore<policy extends "historical" | "realtime"> = policy extends "realtime" ? Db<Schema> : Db<Schema> & {
+    /** Persist the cache to the database. */
+    flush: () => Promise<void>;
+    /** Return `true` if the cache size in bytes is above the limit specified by `option.indexingCacheMaxBytes`. */
+    isCacheFull: () => boolean;
+};
+export declare const parseSqlError: (e: any) => Error;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/indexing-store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/indexing-store/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,MAAM,aAAa,CAAC,MAAM,SAAS,YAAY,GAAG,UAAU,IAChE,MAAM,SAAS,UAAU,GACrB,EAAE,CAAC,MAAM,CAAC,GACV,EAAE,CAAC,MAAM,CAAC,GAAG;IACX,yCAAyC;IACzC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,+GAA+G;IAC/G,WAAW,EAAE,MAAM,OAAO,CAAC;CAC5B,CAAC;AAER,eAAO,MAAM,aAAa,MAAO,GAAG,KAAG,KAmBtC,CAAC"}

package/dist/types/indexing-store/metadata.d.ts

@@ -0,0 +1,10 @@
+import type { Database } from '../database/index.js';
+import type { Status } from '../internal/types.js';
+export type MetadataStore = {
+    setStatus: (status: Status) => Promise<void>;
+    getStatus: () => Promise<Status | null>;
+};
+export declare const getMetadataStore: ({ database, }: {
+    database: Database;
+}) => MetadataStore;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/types/indexing-store/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/indexing-store/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACzC,CAAC;AAEF,eAAO,MAAM,gBAAgB;cAGjB,QAAQ;MAChB,aAoDF,CAAC"}

package/dist/types/indexing-store/realtime.d.ts

@@ -0,0 +1,10 @@
+import type { Database } from '../database/index.js';
+import type { Common } from '../internal/common.js';
+import type { SchemaBuild } from '../internal/types.js';
+import { type IndexingStore } from "./index.js";
+export declare const createRealtimeIndexingStore: ({ schemaBuild: { schema }, database, }: {
+    common: Common;
+    schemaBuild: Pick<SchemaBuild, "schema">;
+    database: Database;
+}) => IndexingStore<"realtime">;
+//# sourceMappingURL=realtime.d.ts.map

package/dist/types/indexing-store/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../../src/indexing-store/realtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAMnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAevD,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,YAAY,CAAC;AAqB/D,eAAO,MAAM,2BAA2B;YAI9B,MAAM;iBACD,KAAK,WAAW,EAAE,QAAQ,CAAC;cAC9B,QAAQ;MAChB,cAAc,UAAU,CAqW3B,CAAC"}

package/dist/types/internal/common.d.ts

@@ -0,0 +1,13 @@
+import type { Logger } from "./logger.js";
+import type { MetricsService } from "./metrics.js";
+import type { Options } from "./options.js";
+import type { Shutdown } from "./shutdown.js";
+import type { Telemetry } from "./telemetry.js";
+export type Common = {
+    options: Options;
+    logger: Logger;
+    metrics: MetricsService;
+    telemetry: Telemetry;
+    shutdown: Shutdown;
+};
+//# sourceMappingURL=common.d.ts.map

package/dist/types/internal/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/internal/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,MAAM,GAAG;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC"}

package/dist/types/internal/errors.d.ts

@@ -0,0 +1,55 @@
+export declare class BaseError extends Error {
+    name: string;
+    meta: string[];
+    constructor(message?: string | undefined);
+}
+export declare function getBaseError(err: any): BaseError;
+export declare class BuildError extends BaseError {
+    name: string;
+    constructor(message?: string | undefined);
+}
+export declare class NonRetryableError extends BaseError {
+    name: string;
+    constructor(message?: string | undefined);
+}
+export declare class StoreError extends NonRetryableError {
+    name: string;
+    constructor(message?: string | undefined);
+}
+export declare class UniqueConstraintError extends NonRetryableError {
+    name: string;
+    constructor(message?: string | undefined);
+}
+export declare class NotNullConstraintError extends NonRetryableError {
+    name: string;
+    constructor(message?: string | undefined);
+}
+export declare class RecordNotFoundError extends NonRetryableError {
+    name: string;
+    constructor(message?: string | undefined);
+}
+export declare class CheckConstraintError extends NonRetryableError {
+    name: string;
+    constructor(message?: string | undefined);
+}
+export declare class InvalidStoreMethodError extends NonRetryableError {
+    name: string;
+    constructor(message?: string | undefined);
+}
+export declare class UndefinedTableError extends NonRetryableError {
+    name: string;
+    constructor(message?: string | undefined);
+}
+export declare class BigIntSerializationError extends NonRetryableError {
+    name: string;
+    constructor(message?: string | undefined);
+}
+export declare class FlushError extends NonRetryableError {
+    name: string;
+    constructor(message?: string | undefined);
+}
+export declare class ShutdownError extends NonRetryableError {
+    name: string;
+    constructor(message?: string | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/internal/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/internal/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;IACzB,IAAI,SAAe;IAE5B,IAAI,EAAE,MAAM,EAAE,CAAM;gBAER,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAIzC;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,aAMpC;AAED,qBAAa,UAAW,SAAQ,SAAS;IAC9B,IAAI,SAAgB;gBAEjB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAIzC;AAED,qBAAa,iBAAkB,SAAQ,SAAS;IACrC,IAAI,SAAuB;gBAExB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAIzC;AAID,qBAAa,UAAW,SAAQ,iBAAiB;IACtC,IAAI,SAAgB;gBAEjB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAIzC;AAED,qBAAa,qBAAsB,SAAQ,iBAAiB;IACjD,IAAI,SAA2B;gBAE5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAIzC;AAED,qBAAa,sBAAuB,SAAQ,iBAAiB;IAClD,IAAI,SAA4B;gBAE7B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAIzC;AAED,qBAAa,mBAAoB,SAAQ,iBAAiB;IAC/C,IAAI,SAAyB;gBAE1B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAIzC;AAED,qBAAa,oBAAqB,SAAQ,iBAAiB;IAChD,IAAI,SAA0B;gBAE3B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAIzC;AAED,qBAAa,uBAAwB,SAAQ,iBAAiB;IACnD,IAAI,SAA6B;gBAE9B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAIzC;AAED,qBAAa,mBAAoB,SAAQ,iBAAiB;IAC/C,IAAI,SAAyB;gBAE1B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAIzC;AAED,qBAAa,wBAAyB,SAAQ,iBAAiB;IACpD,IAAI,SAA8B;gBAE/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAIzC;AAED,qBAAa,UAAW,SAAQ,iBAAiB;IACtC,IAAI,SAAgB;gBAEjB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAIzC;AAED,qBAAa,aAAc,SAAQ,iBAAiB;IACzC,IAAI,SAAmB;gBAEpB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAIzC"}

package/dist/types/internal/logger.d.ts

@@ -0,0 +1,26 @@
+import type { Prettify } from '../types/utils.js';
+import { type LevelWithSilent } from "pino";
+export type LogMode = "pretty" | "json";
+export type LogLevel = Prettify<LevelWithSilent>;
+export type Logger = ReturnType<typeof createLogger>;
+type Log = {
+    level: 60 | 50 | 40 | 30 | 20 | 10;
+    time: number;
+    service: string;
+    msg: string;
+    error?: Error;
+};
+export declare function createLogger({ level, mode, }: {
+    level: LogLevel;
+    mode?: LogMode;
+}): {
+    fatal(options: Omit<Log, "level" | "time">): void;
+    error(options: Omit<Log, "level" | "time">): void;
+    warn(options: Omit<Log, "level" | "time">): void;
+    info(options: Omit<Log, "level" | "time">): void;
+    debug(options: Omit<Log, "level" | "time">): void;
+    trace(options: Omit<Log, "level" | "time">): void;
+    flush: () => Promise<unknown>;
+};
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/types/internal/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/internal/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAA0B,KAAK,eAAe,EAAQ,MAAM,MAAM,CAAC;AAE1E,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AACxC,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;AACjD,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AAErD,KAAK,GAAG,GAAG;IAET,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IAEZ,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,IAAe,GAChB,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE;mBAkCnB,KAAK,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC;mBAG3B,KAAK,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC;kBAG5B,KAAK,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC;kBAG3B,KAAK,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC;mBAG1B,KAAK,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC;mBAG3B,KAAK,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC;;EAK7C"}

package/dist/types/internal/metrics.d.ts

@@ -0,0 +1,77 @@
+import prometheus from "prom-client";
+export declare class MetricsService {
+    registry: prometheus.Registry;
+    start_timestamp: number;
+    rps: {
+        [network: string]: {
+            count: number;
+            timestamp: number;
+        }[];
+    };
+    ponder_historical_total_indexing_seconds: prometheus.Gauge<"network">;
+    ponder_historical_cached_indexing_seconds: prometheus.Gauge<"network">;
+    ponder_historical_completed_indexing_seconds: prometheus.Gauge<"network">;
+    ponder_indexing_timestamp: prometheus.Gauge<"network">;
+    ponder_indexing_has_error: prometheus.Gauge<"network">;
+    ponder_indexing_completed_events: prometheus.Gauge<"event">;
+    ponder_indexing_function_duration: prometheus.Histogram<"event">;
+    ponder_indexing_abi_decoding_duration: prometheus.Histogram;
+    ponder_sync_block: prometheus.Gauge<"network">;
+    ponder_sync_is_realtime: prometheus.Gauge<"network">;
+    ponder_sync_is_complete: prometheus.Gauge<"network">;
+    ponder_historical_duration: prometheus.Histogram<"network">;
+    ponder_historical_total_blocks: prometheus.Gauge<"network">;
+    ponder_historical_cached_blocks: prometheus.Gauge<"network">;
+    ponder_historical_completed_blocks: prometheus.Gauge<"network">;
+    ponder_realtime_reorg_total: prometheus.Counter<"network">;
+    ponder_realtime_latency: prometheus.Histogram<"network">;
+    ponder_database_method_duration: prometheus.Histogram<"service" | "method">;
+    ponder_database_method_error_total: prometheus.Counter<"service" | "method">;
+    ponder_http_server_port: prometheus.Gauge;
+    ponder_http_server_active_requests: prometheus.Gauge<"method" | "path">;
+    ponder_http_server_request_duration_ms: prometheus.Histogram<"method" | "path" | "status">;
+    ponder_http_server_request_size_bytes: prometheus.Histogram<"method" | "path" | "status">;
+    ponder_http_server_response_size_bytes: prometheus.Histogram<"method" | "path" | "status">;
+    ponder_rpc_request_duration: prometheus.Histogram<"network" | "method">;
+    ponder_rpc_request_lag: prometheus.Histogram<"network" | "method">;
+    ponder_postgres_query_total: prometheus.Counter<"pool">;
+    ponder_postgres_query_queue_size: prometheus.Gauge<"pool">;
+    ponder_postgres_pool_connections: prometheus.Gauge<"pool" | "kind">;
+    constructor();
+    /**
+     * Get string representation for all metrics.
+     * @returns Metrics encoded using Prometheus v0.0.4 format.
+     */
+    getMetrics(): Promise<string>;
+    resetIndexingMetrics(): void;
+    resetApiMetrics(): void;
+}
+export declare function getSyncProgress(metrics: MetricsService): Promise<{
+    networkName: string;
+    block: number | undefined;
+    status: "historical" | "realtime" | "complete";
+    progress: number;
+    eta: number | undefined;
+    rps: number;
+}[]>;
+export declare function getIndexingProgress(metrics: MetricsService): Promise<{
+    hasError: boolean;
+    overall: {
+        totalSeconds: number;
+        cachedSeconds: number;
+        completedSeconds: number;
+        progress: number;
+        totalEvents: number;
+    };
+    events: {
+        eventName: string;
+        count: number;
+        averageDuration: number;
+    }[];
+}>;
+export declare function getAppProgress(metrics: MetricsService): Promise<{
+    mode: "historical" | "realtime" | undefined;
+    progress: number;
+    eta: number | undefined;
+}>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/types/internal/metrics.d.ts.map

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

package/dist/types/internal/options.d.ts

@@ -0,0 +1,59 @@
+import type { CliOptions } from '../bin/ponder.js';
+import type { LevelWithSilent } from "pino";
+export type Options = {
+    command: "dev" | "start" | "serve" | "codegen" | "list";
+    configFile: string;
+    schemaFile: string;
+    apiDir: string;
+    apiFile: string;
+    rootDir: string;
+    indexingDir: string;
+    generatedDir: string;
+    ponderDir: string;
+    logDir: string;
+    port: number;
+    hostname?: string;
+    telemetryUrl: string;
+    telemetryDisabled: boolean;
+    telemetryConfigDir: string | undefined;
+    logLevel: LevelWithSilent;
+    logFormat: "json" | "pretty";
+    databaseHeartbeatInterval: number;
+    databaseHeartbeatTimeout: number;
+    databaseMaxQueryParameters: number;
+    factoryAddressCountThreshold: number;
+    indexingCacheMaxBytes: number;
+    indexingCacheFlushRatio: number;
+    syncEventsQuerySize: number;
+    syncHandoffStaleSeconds: number;
+};
+export declare const buildOptions: ({ cliOptions }: {
+    cliOptions: CliOptions;
+}) => {
+    command: "codegen" | "dev" | "start" | "serve";
+    rootDir: string;
+    configFile: string;
+    schemaFile: string;
+    apiDir: string;
+    apiFile: string;
+    indexingDir: string;
+    generatedDir: string;
+    ponderDir: string;
+    logDir: string;
+    port: number;
+    hostname: string | undefined;
+    telemetryUrl: string;
+    telemetryDisabled: boolean;
+    telemetryConfigDir: undefined;
+    logLevel: import("pino").default.LevelWithSilent;
+    logFormat: "json" | "pretty";
+    databaseHeartbeatInterval: number;
+    databaseHeartbeatTimeout: number;
+    databaseMaxQueryParameters: number;
+    factoryAddressCountThreshold: number;
+    indexingCacheMaxBytes: number;
+    indexingCacheFlushRatio: number;
+    syncEventsQuerySize: number;
+    syncHandoffStaleSeconds: number;
+};
+//# sourceMappingURL=options.d.ts.map

package/dist/types/internal/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/internal/options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAE5C,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAExD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IAEf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC;IAE7B,yBAAyB,EAAE,MAAM,CAAC;IAClC,wBAAwB,EAAE,MAAM,CAAC;IACjC,0BAA0B,EAAE,MAAM,CAAC;IAEnC,4BAA4B,EAAE,MAAM,CAAC;IAErC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAEhC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,YAAY;gBAAkC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwFpE,CAAC"}

package/dist/types/internal/shutdown.d.ts

@@ -0,0 +1,8 @@
+export type Shutdown = {
+    add: (callback: () => unknown | Promise<unknown>) => void;
+    kill: () => Promise<void>;
+    isKilled: boolean;
+    abortController: AbortController;
+};
+export declare const createShutdown: () => Shutdown;
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/types/internal/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../../src/internal/shutdown.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC1D,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,eAAe,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,QAiBjC,CAAC"}

package/dist/types/internal/telemetry.d.ts

@@ -0,0 +1,43 @@
+import type { Options } from './options.js';
+import type { Logger } from "./logger.js";
+import type { Shutdown } from "./shutdown.js";
+import type { IndexingBuild } from "./types.js";
+import type { PreBuild, SchemaBuild } from "./types.js";
+type TelemetryEvent = {
+    name: "lifecycle:session_start";
+    properties: {
+        cli_command: string;
+    };
+} | {
+    name: "lifecycle:session_end";
+    properties: {
+        duration_seconds: number;
+    };
+} | {
+    name: "lifecycle:heartbeat_send";
+    properties: {
+        duration_seconds: number;
+    };
+};
+export type Telemetry = ReturnType<typeof createTelemetry>;
+export declare function createTelemetry({ options, logger, shutdown, }: {
+    options: Options;
+    logger: Logger;
+    shutdown: Shutdown;
+}): {
+    record: (_event: TelemetryEvent) => void;
+    flush: () => Promise<void>;
+};
+export declare function buildPayload({ preBuild, schemaBuild, indexingBuild, }: {
+    preBuild: PreBuild;
+    schemaBuild?: SchemaBuild;
+    indexingBuild?: IndexingBuild;
+}): {
+    database_kind: "pglite" | "postgres" | "pglite_test";
+    contract_count: number;
+    network_count: number;
+    table_count: number;
+    indexing_function_count: number;
+};
+export {};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/types/internal/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/internal/telemetry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAMrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIxD,KAAK,cAAc,GACf;IACE,IAAI,EAAE,yBAAyB,CAAC;IAChC,UAAU,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACrC,GACD;IACE,IAAI,EAAE,uBAAuB,CAAC;IAC9B,UAAU,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C,GACD;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,UAAU,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C,CAAC;AAgCN,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAE3D,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,MAAM,EACN,QAAQ,GACT,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE;qBAGpC,cAAc;;EA0JpC;AAmDD,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,WAAW,EACX,aAAa,GACd,EAAE;IACD,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;;;;;;EAgBA"}