@thru/indexer 0.2.29 → 0.2.31

package/dist/index.d.ts

@@ -369,6 +369,58 @@ interface EventStream<TSchema extends SchemaDefinition = SchemaDefinition> {
  */
 declare function defineEventStream<TSchema extends SchemaDefinition>(definition: EventStreamDefinition<TSchema>): EventStream<TSchema>;
 
+/**
+ * Runtime status and health types for the indexer supervisor.
+ */
+type IndexerStreamKind = "event" | "account";
+type IndexerStreamState = "idle" | "starting" | "running" | "retrying" | "stopped";
+type IndexerErrorPhase = "starting" | "backfill" | "live" | "parse" | "commit" | "filterBatch" | "onCommit" | "supervisor";
+interface NormalizedIndexerError {
+    name: string;
+    message: string;
+    code?: string | number;
+    phase: IndexerErrorPhase;
+    retryable: boolean;
+    streamName: string;
+    streamKind: IndexerStreamKind;
+    startSlot?: string;
+    checkpointSlot?: string;
+    endpointLabel?: string;
+}
+interface IndexerStreamCounters {
+    eventsReceived: number;
+    parserNulls: number;
+    parserErrors: number;
+    parseValidationErrors: number;
+    commitErrors: number;
+    filterBatchErrors: number;
+    onCommitErrors: number;
+    recordsProcessed: number;
+    batchesCommitted: number;
+}
+interface IndexerStreamStatus {
+    name: string;
+    kind: IndexerStreamKind;
+    state: IndexerStreamState;
+    checkpointSlot: string | null;
+    lastProcessedSlot: string | null;
+    lastEventAt: string | null;
+    stale: boolean;
+    restartCount: number;
+    lastStartedAt: string | null;
+    lastErrorAt: string | null;
+    lastError: NormalizedIndexerError | null;
+    counters: IndexerStreamCounters;
+}
+interface IndexerStatus {
+    running: boolean;
+    shutdownRequested: boolean;
+    startedAt: string | null;
+    uptimeMs: number;
+    healthy: boolean;
+    streams: IndexerStreamStatus[];
+}
+
 /**
  * Event stream processor.
  *
@@ -765,6 +817,14 @@ interface IndexerConfig {
     pageSize?: number;
     /** Log level (default: "info") */
     logLevel?: "debug" | "info" | "warn" | "error";
+    /** Human-readable endpoint label included in normalized stream errors */
+    endpointLabel?: string;
+    /** Initial supervisor restart backoff in milliseconds (default: 1000) */
+    supervisorInitialBackoffMs?: number;
+    /** Maximum supervisor restart backoff in milliseconds (default: 30000) */
+    supervisorMaxBackoffMs?: number;
+    /** Mark running streams unhealthy when no activity is seen for this long (default: 300000, disabled with 0) */
+    streamStaleMs?: number;
     /**
      * Validate parse output at runtime using Zod schemas.
      * Useful for development to catch type mismatches early.
@@ -829,6 +889,8 @@ declare class Indexer {
     private abortController;
     private running;
     private shutdownRequested;
+    private startedAtMs;
+    private streamStatuses;
     constructor(config: IndexerConfig);
     /**
      * Check if the checkpoint table exists in the database.
@@ -855,6 +917,22 @@ declare class Indexer {
      * Check if the indexer is currently running.
      */
     isRunning(): boolean;
+    /**
+     * Get the current in-memory runtime status for every configured stream.
+     */
+    getStatus(): IndexerStatus;
+    private initializeStreamStatuses;
+    private createInitialStreamStatus;
+    private statusKey;
+    private statusFor;
+    private resultForStream;
+    private createObserver;
+    private runEventStreamSupervisor;
+    private runAccountStreamSupervisor;
+    private runStreamSupervisor;
+    private supervisorBackoffMs;
+    private isStreamStale;
+    private delay;
 }
 
-export { type AccountStream, type AccountStreamDefinition, type AnyColumnDef, type ApiConfig, type Checkpoint, type ColumnBuilder, type ColumnDef, type Columns, type DatabaseClient, type EventStream, type EventStreamDefinition, type HookContext, Indexer, type IndexerConfig, type IndexerResult, type InferInsert, type InferRow, type SchemaDefinition, type StreamBatch, checkpointTable, columnBuilder, defineAccountStream, defineEventStream, deleteCheckpoint, generateZodSchema, getAllCheckpoints, getCheckpoint, getSchemaExports, t, updateCheckpoint, validateParsedData };
+export { type AccountStream, type AccountStreamDefinition, type AnyColumnDef, type ApiConfig, type Checkpoint, type ColumnBuilder, type ColumnDef, type Columns, type DatabaseClient, type EventStream, type EventStreamDefinition, type HookContext, Indexer, type IndexerConfig, type IndexerResult, type IndexerStatus, type IndexerStreamKind, type IndexerStreamState, type IndexerStreamStatus, type InferInsert, type InferRow, type NormalizedIndexerError, type SchemaDefinition, type StreamBatch, checkpointTable, columnBuilder, defineAccountStream, defineEventStream, deleteCheckpoint, generateZodSchema, getAllCheckpoints, getCheckpoint, getSchemaExports, t, updateCheckpoint, validateParsedData };