@eclesia/indexer-engine 2.14.4 → 2.16.0

package/dist/types/index.d.cts

@@ -1,4 +1,4 @@
-import { EcleciaIndexer } from "../indexer/index.cjs";
+import { EclesiaIndexer } from "../indexer/index.cjs";
 import { CircularBuffer } from "../promise-queue/index.cjs";
 import { BlockResponse, BlockResultsResponse } from "@cosmjs/tendermint-rpc";
 import { BlockResultsResponse as BlockResultsResponse$1, Event } from "@cosmjs/tendermint-rpc/build/comet38/responses";
@@ -7,10 +7,10 @@ import { TxBody } from "cosmjs-types/cosmos/tx/v1beta1/tx";
 
 //#region src/types/index.d.ts
 declare namespace index_d_exports {
-  export { BlockQueue, EcleciaIndexerConfig, EmitFunc, Events, FullBlockQueue, IndexingModule, LogEvent, MinimalBlockQueue, TxResult, UUIDEvent, WithHeightAndUUID };
+  export { BlockQueue, EcleciaIndexerConfig, EclesiaIndexerConfig, EmitFunc, Events, FullBlockQueue, IndexingModule, LogEvent, MinimalBlockQueue, TxResult, UUIDEvent, WithHeightAndUUID };
 }
 /** Configuration interface for the Eclesia indexer */
-type EcleciaIndexerConfig = {
+type EclesiaIndexerConfig = {
   startHeight?: number;
   endHeight?: number;
   batchSize: number;
@@ -18,6 +18,7 @@ type EcleciaIndexerConfig = {
   getNextHeight: () => number | PromiseLike<number>;
   logLevel: "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
   rpcUrl: string;
+  chainId?: string;
   shouldProcessGenesis: () => Promise<boolean>;
   genesisPath?: string;
   usePolling?: boolean;
@@ -27,10 +28,19 @@ type EcleciaIndexerConfig = {
   healthCheckPort?: number;
   enablePrometheus?: boolean;
   prometheusPort?: number;
+  healthCheckHost?: string;
+  prometheusHost?: string;
+  logFormat?: "text" | "json";
+  maxRetries?: number;
+  maxFailuresPerBlock?: number;
+  onGenesisStart?: () => Promise<void>;
+  onGenesisComplete?: () => Promise<void>;
   init?: () => Promise<void>;
   beginTransaction: () => Promise<void>;
   endTransaction: (status: boolean) => Promise<void>;
 };
+/** @deprecated Misspelling kept for compatibility, use EclesiaIndexerConfig. Removed in 3.0. */
+type EcleciaIndexerConfig = EclesiaIndexerConfig;
 /** Queue for full indexing mode with validator data */
 type FullBlockQueue = CircularBuffer<[BlockResponse, BlockResultsResponse, Uint8Array]>;
 /** Queue for minimal indexing mode without validator data */
@@ -61,6 +71,7 @@ type Events = {
     error: Error;
     message: string;
     retryCount?: number;
+    height?: number;
   };
   begin_block: {
     value: {
@@ -106,13 +117,25 @@ type TxResult<T> = {
 };
 /** Interface that all indexing modules must implement */
 interface IndexingModule {
-  indexer: EcleciaIndexer;
+  indexer: EclesiaIndexer;
   name: string;
   depends: string[];
   provides: string[];
   setup: () => Promise<void>;
   init: (...args: any[]) => void;
 }
+/**
+ * Global event map. Modules add their own events through declaration merging:
+ *
+ *   declare global { interface EventMap extends MyModule.Events {} }
+ *
+ * Declared in a regular module (not an ambient .d.ts) so it is emitted into the
+ * published declarations and consumers get typed events without extra setup.
+ */
+declare global {
+  interface EventMap extends Events {}
+}
+//# sourceMappingURL=index.d.ts.map
 //#endregion
-export { EcleciaIndexerConfig, EmitFunc, WithHeightAndUUID, index_d_exports };
+export { EclesiaIndexerConfig, EmitFunc, WithHeightAndUUID, index_d_exports };
 //# sourceMappingURL=index.d.cts.map

package/dist/types/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/types/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;KAsBY,oBAAA;;;;;gCAKoB;;;8BAGF;;;;;;;EARlB,gBAAA,CAAA,EAAA,OAAoB;EAKA,cAAA,CAAA,EAAA,MAAA;EAGF,IAAA,CAAA,EAAA,GAAA,GASf,OATe,CAAA,IAAA,CAAA;EASf,gBAAA,EAAA,GAAA,GACW,OADX,CAAA,IAAA,CAAA;EACW,cAAA,EAAA,CAAA,MAAA,EAAA,OAAA,EAAA,GACa,OADb,CAAA,IAAA,CAAA;CACa;;AAI3B,KAAA,cAAA,GAAiB,cAAH,CAAA,CAAmB,aAAnB,EAAkC,oBAAlC,EAAwD,UAAxD,CAAA,CAAA;;AAAkC,KAGhD,iBAAA,GAAoB,cAH4B,CAAA,CAGZ,aAHY,EAGG,oBAHH,CAAA,CAAA;;AAA/B,KAMjB,UAAA,GAAa,cANI,GAMa,iBANb;;AAGjB,KAMA,iBANiB,CAAA,CAAA,CAAA,GAAA,QAAmB,MAOlC,CAPkC,GAO9B,CAP8B,CAO5B,CAP4B,CAAA,GAAA;EAAe,IAAA,CAAA,EAAA,MAAA;EAA/B,MAAA,CAAA,EAAA,MAAA;EAAc,SAAA,CAAA,EAAA,MAAA;AAGlC,CAAA,EAGZ;;AACkB,KAQN,QARM,CAAA,YAAA,MAQmB,iBARnB,CAQqC,QARrC,CAAA,CAAA,GAAA,CAAA,CAAA,EASb,GATa,EAAA,CAAA,EAUb,iBAVa,CAUK,QAVL,CAAA,CAUe,GAVf,CAAA,EAAA,GAWb,OAXa,CAAA,IAAA,GAAA,IAAA,EAAA,CAAA;AAAE,KAaR,QAAA,GAbQ;EAAC,IAAA,EAAA,KAAA,GAAA,MAAA,GAAA,SAAA,GAAA,OAAA,GAAA,SAAA,GAAA,WAAA;EAQT,OAAA,EAAA,MAAQ;CAAmC;AAAlB,KASzB,SAAA,GATyB;EAChC,IAAA,EAAA,MAAA;EACkB,KAAA,CAAA,EAAA,MAAA;EAAlB,MAAA,EAAA,OAAA;CAA4B;AAC5B,KAWO,MAAA,GAXP;EAAO,GAAA,EAYL,QAZK;EAEA,IAAA,EAWJ,SAXY;EAIR,aAAS,EAAA;IAKT,KAAM,EAIP,KAJO;IACX,OAAA,EAAA,MAAA;IACC,UAAA,CAAA,EAAA,MAAA;EAEG,CAAA;EAMG,WAAA,EAAA;IAA2C,KAAA,EAAA;MACvC,MAAA,EADJ,oBACI,CAAA,kBAAA,CAAA,GADuC,sBACvC,CAAA,qBAAA,CAAA;MAML,UAAA,EANK,SAML,EAAA,GAAA,SAAA;IACQ,CAAA;EAAuB,CAAA;EAIjC,KAAA,EAAA;IAAyC,KAAA,EAAA;MAGzC,KAAA,EARE,aAQF;MAAkC,aAAA,EAPxB,oBAOwB,GAPD,sBAOC;IAK/B,CAAA;EAAM,CAAA;EAiBR,SAAA,EAAQ;IAMH,KAAA,EA/BN,oBAgCA,CAAA,gBAII,CAAA,GApCqC,sBAoC9B,CAAA,qBAAA,CAAA;;;WAjCX,kCAAkC;;;;;cAK/B;;;;;;;;;;;;;;;;;KAiBF;MACN;UACI;;;UAIO,cAAA;WACN;;;;eAII"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/types/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;KAsBY,oBAAA;;;;;gCAKoB;;;;8BAIF;;;;;;;EATlB,gBAAA,CAAA,EAAA,OAAoB;EAKA,cAAA,CAAA,EAAA,MAAA;EAIF,eAAA,CAAA,EAAA,MAAA;EAcL,cAAA,CAAA,EAAA,MAAA;EACG,SAAA,CAAA,EAAA,MAAA,GAAA,MAAA;EACb,UAAA,CAAA,EAAA,MAAA;EACW,mBAAA,CAAA,EAAA,MAAA;EACa,cAAA,CAAA,EAAA,GAAA,GAJd,OAIc,CAAA,IAAA,CAAA;EAAO,iBAAA,CAAA,EAAA,GAAA,GAHlB,OAGkB,CAAA,IAAA,CAAA;EAIlC,IAAA,CAAA,EAAA,GAAA,GANG,OAMH,CAAA,IAAoB,CAAA;EAGpB,gBAAA,EAAc,GAAA,GARA,OAQA,CAAA,IAAA,CAAA;EAAmB,cAAA,EAAA,CAAA,MAAA,EAAA,OAAA,EAAA,GAPN,OAOM,CAAA,IAAA,CAAA;CAAe;;AAA/B,KAHjB,oBAAA,GAAuB,oBAGN;;AAGjB,KAHA,cAAA,GAAiB,cAGA,CAAA,CAHgB,aAGhB,EAH+B,oBAG/B,EAHqD,UAGrD,CAAA,CAAA;;AAAkC,KAAnD,iBAAA,GAAoB,cAA+B,CAAA,CAAf,aAAe,EAAA,oBAAA,CAAA,CAAA;;AAAjB,KAGlC,UAAA,GAAa,cAHqB,GAGJ,iBAHI;AAG9C;AAGY,KAAA,iBAAiB,CAAA,CAAA,CAAA,GAAA,QACf,MAAA,CAAA,GAAI,CAAJ,CAAM,CAAN,CAAA,GAAA;EAAI,IAAA,CAAA,EAAA,MAAA;EAAE,MAAA,CAAA,EAAA,MAAA;EAAC,SAAA,CAAA,EAAA,MAAA;AAQT,CAAA,EAA2C;;AAClD,KADO,QACP,CAAA,YAAA,MADgC,iBAChC,CADkD,QAClD,CAAA,CAAA,GAAA,CAAA,CAAA,EAAA,GAAA,EAAA,CAAA,EACA,iBADA,CACkB,QADlB,CAAA,CAC4B,GAD5B,CAAA,EAAA,GAEA,OAFA,CAAA,IAAA,GAAA,IAAA,EAAA,CAAA;AACkB,KAGX,QAAA,GAHW;EAAlB,IAAA,EAAA,KAAA,GAAA,MAAA,GAAA,SAAA,GAAA,OAAA,GAAA,SAAA,GAAA,WAAA;EAA4B,OAAA,EAAA,MAAA;CAC5B;AAAO,KAMA,SAAA,GANA;EAEA,IAAA,EAAA,MAAQ;EAIR,KAAA,CAAA,EAAA,MAAS;EAKT,MAAA,EAAA,OAAM;CACX;AACC,KAFI,MAAA,GAEJ;EAEG,GAAA,EAHJ,QAGI;EAOG,IAAA,EATN,SASM;EAA2C,aAAA,EAAA;IACvC,KAAA,EARP,KAQO;IAML,OAAA,EAAA,MAAA;IACQ,UAAA,CAAA,EAAA,MAAA;IAAuB,MAAA,CAAA,EAAA,MAAA;EAIjC,CAAA;EAAyC,WAAA,EAAA;IAGzC,KAAA,EAAA;MAAkC,MAAA,EAf/B,oBAe+B,CAAA,kBAAA,CAAA,GAfY,sBAeZ,CAAA,qBAAA,CAAA;MAK/B,UAAA,EAnBI,SAmBJ,EAAA,GAAA,SAAA;IAAM,CAAA;EAiBR,CAAA;EAMK,KAAA,EAAA;IAQhB,KAAA,EAAA;MAAA,KAAA,EA5CY,aA4CZ;MAY4B,aAAM,EAvDd,oBAuDc,GAvDS,sBAuDT;IAAA,CAAA;EAAA,CAAA;;WAnDxB,yCAAyC;;;WAGzC,kCAAkC;;;;;cAK/B;;;;;;;;;;;;;;;;;KAiBF;MACN;UACI;;;UAIO,cAAA;WACN;;;;eAII;;;;;;;;;;;;6BAec"}

package/dist/types/index.d.mts

@@ -1,4 +1,4 @@
-import { EcleciaIndexer } from "../indexer/index.mjs";
+import { EclesiaIndexer } from "../indexer/index.mjs";
 import { CircularBuffer } from "../promise-queue/index.mjs";
 import { BlockResponse, BlockResultsResponse } from "@cosmjs/tendermint-rpc";
 import { BlockResultsResponse as BlockResultsResponse$1, Event } from "@cosmjs/tendermint-rpc/build/comet38/responses";
@@ -7,10 +7,10 @@ import { TxBody } from "cosmjs-types/cosmos/tx/v1beta1/tx";
 
 //#region src/types/index.d.ts
 declare namespace index_d_exports {
-  export { BlockQueue, EcleciaIndexerConfig, EmitFunc, Events, FullBlockQueue, IndexingModule, LogEvent, MinimalBlockQueue, TxResult, UUIDEvent, WithHeightAndUUID };
+  export { BlockQueue, EcleciaIndexerConfig, EclesiaIndexerConfig, EmitFunc, Events, FullBlockQueue, IndexingModule, LogEvent, MinimalBlockQueue, TxResult, UUIDEvent, WithHeightAndUUID };
 }
 /** Configuration interface for the Eclesia indexer */
-type EcleciaIndexerConfig = {
+type EclesiaIndexerConfig = {
   startHeight?: number;
   endHeight?: number;
   batchSize: number;
@@ -18,6 +18,7 @@ type EcleciaIndexerConfig = {
   getNextHeight: () => number | PromiseLike<number>;
   logLevel: "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
   rpcUrl: string;
+  chainId?: string;
   shouldProcessGenesis: () => Promise<boolean>;
   genesisPath?: string;
   usePolling?: boolean;
@@ -27,10 +28,19 @@ type EcleciaIndexerConfig = {
   healthCheckPort?: number;
   enablePrometheus?: boolean;
   prometheusPort?: number;
+  healthCheckHost?: string;
+  prometheusHost?: string;
+  logFormat?: "text" | "json";
+  maxRetries?: number;
+  maxFailuresPerBlock?: number;
+  onGenesisStart?: () => Promise<void>;
+  onGenesisComplete?: () => Promise<void>;
   init?: () => Promise<void>;
   beginTransaction: () => Promise<void>;
   endTransaction: (status: boolean) => Promise<void>;
 };
+/** @deprecated Misspelling kept for compatibility, use EclesiaIndexerConfig. Removed in 3.0. */
+type EcleciaIndexerConfig = EclesiaIndexerConfig;
 /** Queue for full indexing mode with validator data */
 type FullBlockQueue = CircularBuffer<[BlockResponse, BlockResultsResponse, Uint8Array]>;
 /** Queue for minimal indexing mode without validator data */
@@ -61,6 +71,7 @@ type Events = {
     error: Error;
     message: string;
     retryCount?: number;
+    height?: number;
   };
   begin_block: {
     value: {
@@ -106,13 +117,25 @@ type TxResult<T> = {
 };
 /** Interface that all indexing modules must implement */
 interface IndexingModule {
-  indexer: EcleciaIndexer;
+  indexer: EclesiaIndexer;
   name: string;
   depends: string[];
   provides: string[];
   setup: () => Promise<void>;
   init: (...args: any[]) => void;
 }
+/**
+ * Global event map. Modules add their own events through declaration merging:
+ *
+ *   declare global { interface EventMap extends MyModule.Events {} }
+ *
+ * Declared in a regular module (not an ambient .d.ts) so it is emitted into the
+ * published declarations and consumers get typed events without extra setup.
+ */
+declare global {
+  interface EventMap extends Events {}
+}
+//# sourceMappingURL=index.d.ts.map
 //#endregion
-export { EcleciaIndexerConfig, EmitFunc, WithHeightAndUUID, index_d_exports };
+export { EclesiaIndexerConfig, EmitFunc, WithHeightAndUUID, index_d_exports };
 //# sourceMappingURL=index.d.mts.map

package/dist/types/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/types/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;KAsBY,oBAAA;;;;;gCAKoB;;;8BAGF;;;;;;;EARlB,gBAAA,CAAA,EAAA,OAAoB;EAKA,cAAA,CAAA,EAAA,MAAA;EAGF,IAAA,CAAA,EAAA,GAAA,GASf,OATe,CAAA,IAAA,CAAA;EASf,gBAAA,EAAA,GAAA,GACW,OADX,CAAA,IAAA,CAAA;EACW,cAAA,EAAA,CAAA,MAAA,EAAA,OAAA,EAAA,GACa,OADb,CAAA,IAAA,CAAA;CACa;;AAI3B,KAAA,cAAA,GAAiB,cAAH,CAAA,CAAmB,aAAnB,EAAkC,oBAAlC,EAAwD,UAAxD,CAAA,CAAA;;AAAkC,KAGhD,iBAAA,GAAoB,cAH4B,CAAA,CAGZ,aAHY,EAGG,oBAHH,CAAA,CAAA;;AAA/B,KAMjB,UAAA,GAAa,cANI,GAMa,iBANb;;AAGjB,KAMA,iBANiB,CAAA,CAAA,CAAA,GAAA,QAAmB,MAOlC,CAPkC,GAO9B,CAP8B,CAO5B,CAP4B,CAAA,GAAA;EAAe,IAAA,CAAA,EAAA,MAAA;EAA/B,MAAA,CAAA,EAAA,MAAA;EAAc,SAAA,CAAA,EAAA,MAAA;AAGlC,CAAA,EAGZ;;AACkB,KAQN,QARM,CAAA,YAAA,MAQmB,iBARnB,CAQqC,QARrC,CAAA,CAAA,GAAA,CAAA,CAAA,EASb,GATa,EAAA,CAAA,EAUb,iBAVa,CAUK,QAVL,CAAA,CAUe,GAVf,CAAA,EAAA,GAWb,OAXa,CAAA,IAAA,GAAA,IAAA,EAAA,CAAA;AAAE,KAaR,QAAA,GAbQ;EAAC,IAAA,EAAA,KAAA,GAAA,MAAA,GAAA,SAAA,GAAA,OAAA,GAAA,SAAA,GAAA,WAAA;EAQT,OAAA,EAAA,MAAQ;CAAmC;AAAlB,KASzB,SAAA,GATyB;EAChC,IAAA,EAAA,MAAA;EACkB,KAAA,CAAA,EAAA,MAAA;EAAlB,MAAA,EAAA,OAAA;CAA4B;AAC5B,KAWO,MAAA,GAXP;EAAO,GAAA,EAYL,QAZK;EAEA,IAAA,EAWJ,SAXY;EAIR,aAAS,EAAA;IAKT,KAAM,EAIP,KAJO;IACX,OAAA,EAAA,MAAA;IACC,UAAA,CAAA,EAAA,MAAA;EAEG,CAAA;EAMG,WAAA,EAAA;IAA2C,KAAA,EAAA;MACvC,MAAA,EADJ,oBACI,CAAA,kBAAA,CAAA,GADuC,sBACvC,CAAA,qBAAA,CAAA;MAML,UAAA,EANK,SAML,EAAA,GAAA,SAAA;IACQ,CAAA;EAAuB,CAAA;EAIjC,KAAA,EAAA;IAAyC,KAAA,EAAA;MAGzC,KAAA,EARE,aAQF;MAAkC,aAAA,EAPxB,oBAOwB,GAPD,sBAOC;IAK/B,CAAA;EAAM,CAAA;EAiBR,SAAA,EAAQ;IAMH,KAAA,EA/BN,oBAgCA,CAAA,gBAII,CAAA,GApCqC,sBAoC9B,CAAA,qBAAA,CAAA;;;WAjCX,kCAAkC;;;;;cAK/B;;;;;;;;;;;;;;;;;KAiBF;MACN;UACI;;;UAIO,cAAA;WACN;;;;eAII"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/types/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;KAsBY,oBAAA;;;;;gCAKoB;;;;8BAIF;;;;;;;EATlB,gBAAA,CAAA,EAAA,OAAoB;EAKA,cAAA,CAAA,EAAA,MAAA;EAIF,eAAA,CAAA,EAAA,MAAA;EAcL,cAAA,CAAA,EAAA,MAAA;EACG,SAAA,CAAA,EAAA,MAAA,GAAA,MAAA;EACb,UAAA,CAAA,EAAA,MAAA;EACW,mBAAA,CAAA,EAAA,MAAA;EACa,cAAA,CAAA,EAAA,GAAA,GAJd,OAIc,CAAA,IAAA,CAAA;EAAO,iBAAA,CAAA,EAAA,GAAA,GAHlB,OAGkB,CAAA,IAAA,CAAA;EAIlC,IAAA,CAAA,EAAA,GAAA,GANG,OAMH,CAAA,IAAoB,CAAA;EAGpB,gBAAA,EAAc,GAAA,GARA,OAQA,CAAA,IAAA,CAAA;EAAmB,cAAA,EAAA,CAAA,MAAA,EAAA,OAAA,EAAA,GAPN,OAOM,CAAA,IAAA,CAAA;CAAe;;AAA/B,KAHjB,oBAAA,GAAuB,oBAGN;;AAGjB,KAHA,cAAA,GAAiB,cAGA,CAAA,CAHgB,aAGhB,EAH+B,oBAG/B,EAHqD,UAGrD,CAAA,CAAA;;AAAkC,KAAnD,iBAAA,GAAoB,cAA+B,CAAA,CAAf,aAAe,EAAA,oBAAA,CAAA,CAAA;;AAAjB,KAGlC,UAAA,GAAa,cAHqB,GAGJ,iBAHI;AAG9C;AAGY,KAAA,iBAAiB,CAAA,CAAA,CAAA,GAAA,QACf,MAAA,CAAA,GAAI,CAAJ,CAAM,CAAN,CAAA,GAAA;EAAI,IAAA,CAAA,EAAA,MAAA;EAAE,MAAA,CAAA,EAAA,MAAA;EAAC,SAAA,CAAA,EAAA,MAAA;AAQT,CAAA,EAA2C;;AAClD,KADO,QACP,CAAA,YAAA,MADgC,iBAChC,CADkD,QAClD,CAAA,CAAA,GAAA,CAAA,CAAA,EAAA,GAAA,EAAA,CAAA,EACA,iBADA,CACkB,QADlB,CAAA,CAC4B,GAD5B,CAAA,EAAA,GAEA,OAFA,CAAA,IAAA,GAAA,IAAA,EAAA,CAAA;AACkB,KAGX,QAAA,GAHW;EAAlB,IAAA,EAAA,KAAA,GAAA,MAAA,GAAA,SAAA,GAAA,OAAA,GAAA,SAAA,GAAA,WAAA;EAA4B,OAAA,EAAA,MAAA;CAC5B;AAAO,KAMA,SAAA,GANA;EAEA,IAAA,EAAA,MAAQ;EAIR,KAAA,CAAA,EAAA,MAAS;EAKT,MAAA,EAAA,OAAM;CACX;AACC,KAFI,MAAA,GAEJ;EAEG,GAAA,EAHJ,QAGI;EAOG,IAAA,EATN,SASM;EAA2C,aAAA,EAAA;IACvC,KAAA,EARP,KAQO;IAML,OAAA,EAAA,MAAA;IACQ,UAAA,CAAA,EAAA,MAAA;IAAuB,MAAA,CAAA,EAAA,MAAA;EAIjC,CAAA;EAAyC,WAAA,EAAA;IAGzC,KAAA,EAAA;MAAkC,MAAA,EAf/B,oBAe+B,CAAA,kBAAA,CAAA,GAfY,sBAeZ,CAAA,qBAAA,CAAA;MAK/B,UAAA,EAnBI,SAmBJ,EAAA,GAAA,SAAA;IAAM,CAAA;EAiBR,CAAA;EAMK,KAAA,EAAA;IAQhB,KAAA,EAAA;MAAA,KAAA,EA5CY,aA4CZ;MAY4B,aAAM,EAvDd,oBAuDc,GAvDS,sBAuDT;IAAA,CAAA;EAAA,CAAA;;WAnDxB,yCAAyC;;;WAGzC,kCAAkC;;;;;cAK/B;;;;;;;;;;;;;;;;;KAiBF;MACN;UACI;;;UAIO,cAAA;WACN;;;;eAII;;;;;;;;;;;;6BAec"}

package/dist/types/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/types/index.ts"],"sourcesContent":["/* eslint-disable @stylistic/no-multi-spaces */\nimport {\n  BlockResponse, BlockResultsResponse,\n} from \"@cosmjs/tendermint-rpc\";\nimport {\n  BlockResultsResponse as BlockResultsResponse38, Event,\n} from \"@cosmjs/tendermint-rpc/build/comet38/responses\";\nimport {\n  Validator,\n} from \"cosmjs-types/cosmos/staking/v1beta1/staking\";\nimport {\n  TxBody,\n} from \"cosmjs-types/cosmos/tx/v1beta1/tx\";\n\nimport {\n  EcleciaIndexer,\n} from \"../indexer\";\nimport {\n  CircularBuffer,\n} from \"../promise-queue\";\n\n/** Configuration interface for the Eclesia indexer */\nexport type EcleciaIndexerConfig = {\n  startHeight?: number                                           // Block height to start indexing from\n  endHeight?: number                                             // Block height to stop indexing at (optional)\n  batchSize: number                                              // Number of blocks to process in parallel\n  modules: string[]                                              // List of module names to enable\n  getNextHeight: () => number | PromiseLike<number>             // Function to determine next block to process\n  logLevel: \"error\" | \"warn\" | \"info\" | \"http\" | \"verbose\" | \"debug\" | \"silly\" // Logging verbosity level\n  rpcUrl: string                                                 // Tendermint RPC endpoint URL\n  shouldProcessGenesis: () => Promise<boolean>                   // Whether to process genesis state\n  genesisPath?: string                                           // Path to genesis file\n  usePolling?: boolean                                           // Use polling instead of WebSocket subscription\n  pollingInterval?: number                                       // Interval between polls in milliseconds\n  minimal?: boolean                                              // Use minimal indexing mode (blocks only)\n  enableHealthcheck?: boolean                                    // Enable health check HTTP server\n  healthCheckPort?: number                                       // Port for health check HTTP server (default: 8888)\n  enablePrometheus?: boolean                                     // Enable Prometheus metrics server\n  prometheusPort?: number                                        // Port for Prometheus metrics server (default: 9090)\n  init?: () => Promise<void>                                     // Custom initialization function\n  beginTransaction: () => Promise<void>                          // Function to begin database transaction\n  endTransaction: (status: boolean) => Promise<void>             // Function to end database transaction\n};\n\n/** Queue for full indexing mode with validator data */\nexport type FullBlockQueue = CircularBuffer<[BlockResponse, BlockResultsResponse, Uint8Array]>;\n\n/** Queue for minimal indexing mode without validator data */\nexport type MinimalBlockQueue = CircularBuffer<[BlockResponse, BlockResultsResponse]>;\n\n/** Union type for block queues */\nexport type BlockQueue = FullBlockQueue | MinimalBlockQueue;\n\n/** Utility type to add height, timestamp, and UUID to event types */\nexport type WithHeightAndUUID<T> = {\n  [K in keyof T]: T[K] & {\n    uuid?: string      // Unique identifier for event tracking\n    height?: number    // Block height when event occurred\n    timestamp?: string // Block timestamp when event occurred\n  };\n};\n\n/** Function signature for emitting events asynchronously */\nexport type EmitFunc<K extends keyof WithHeightAndUUID<EventMap>> = (\n  t: K,\n  e: WithHeightAndUUID<EventMap>[K],\n) => Promise<void | void[]>;\n\nexport type LogEvent = {\n  type: \"log\" | \"info\" | \"warning\" | \"error\" | \"verbose\" | \"transient\"\n  message: string\n};\nexport type UUIDEvent = {\n  uuid: string\n  error?: string\n  status: boolean\n};\nexport type Events = {\n  log: LogEvent\n  uuid: UUIDEvent\n  \"fatal-error\": {\n    error: Error\n    message: string\n    retryCount?: number\n  }\n  begin_block: {\n    value: {\n      events: BlockResultsResponse[\"beginBlockEvents\"] | BlockResultsResponse38[\"finalizeBlockEvents\"]\n      validators: Validator[] | undefined\n    }\n  }\n\n  block: {\n    value: {\n      block: BlockResponse\n      block_results: BlockResultsResponse | BlockResultsResponse38\n    }\n  }\n  end_block: {\n    value: BlockResultsResponse[\"endBlockEvents\"] | BlockResultsResponse38[\"finalizeBlockEvents\"]\n  }\n  tx_events: {\n    value: BlockResultsResponse[\"results\"] | BlockResultsResponse38[\"results\"]\n  }\n  tx_memo: {\n    value: {\n      txHash: string\n      txBody: TxBody\n    }\n  }\n  _unhandled: {\n    type: string\n    event: unknown\n  }\n  \"periodic/small\": {\n    value: null\n  }\n  \"periodic/medium\": {\n    value: null\n  }\n  \"periodic/large\": {\n    value: null\n  }\n};\nexport type TxResult<T> = {\n  tx: T\n  events: Event[]\n};\n\n/** Interface that all indexing modules must implement */\nexport interface IndexingModule {\n  indexer: EcleciaIndexer                    // Reference to the main indexer instance\n  name: string                               // Unique module name\n  depends: string[]                          // Array of module names this module depends on\n  provides: string[]                         // Array of capabilities this module provides\n  setup: () => Promise<void>                 // Async setup function for database schema initialization\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  init: (...args: any[]) => void            // Initialization function called by the indexer\n}\n"],"mappings":""}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/types/index.ts"],"sourcesContent":["/* eslint-disable @stylistic/no-multi-spaces */\nimport {\n  BlockResponse, BlockResultsResponse,\n} from \"@cosmjs/tendermint-rpc\";\nimport {\n  BlockResultsResponse as BlockResultsResponse38, Event,\n} from \"@cosmjs/tendermint-rpc/build/comet38/responses\";\nimport {\n  Validator,\n} from \"cosmjs-types/cosmos/staking/v1beta1/staking\";\nimport {\n  TxBody,\n} from \"cosmjs-types/cosmos/tx/v1beta1/tx\";\n\nimport {\n  EclesiaIndexer,\n} from \"../indexer\";\nimport {\n  CircularBuffer,\n} from \"../promise-queue\";\n\n/** Configuration interface for the Eclesia indexer */\nexport type EclesiaIndexerConfig = {\n  startHeight?: number                                           // Block height to start indexing from\n  endHeight?: number                                             // Block height to stop indexing at (optional)\n  batchSize: number                                              // Number of blocks to process in parallel\n  modules: string[]                                              // List of module names to enable\n  getNextHeight: () => number | PromiseLike<number>             // Function to determine next block to process\n  logLevel: \"error\" | \"warn\" | \"info\" | \"http\" | \"verbose\" | \"debug\" | \"silly\" // Logging verbosity level\n  rpcUrl: string                                                 // Tendermint RPC endpoint URL\n  chainId?: string                                               // Refuse to index if the RPC reports a different network\n  shouldProcessGenesis: () => Promise<boolean>                   // Whether to process genesis state\n  genesisPath?: string                                           // Path to genesis file\n  usePolling?: boolean                                           // Use polling instead of WebSocket subscription\n  pollingInterval?: number                                       // Interval between polls in milliseconds\n  minimal?: boolean                                              // Use minimal indexing mode (blocks only)\n  enableHealthcheck?: boolean                                    // Enable health check HTTP server\n  healthCheckPort?: number                                       // Port for health check HTTP server (default: 8888)\n  enablePrometheus?: boolean                                     // Enable Prometheus metrics server\n  prometheusPort?: number                                        // Port for Prometheus metrics server (default: 9090)\n  healthCheckHost?: string                                       // Address the health check server binds to (default: 0.0.0.0)\n  prometheusHost?: string                                        // Address the metrics server binds to (default: 0.0.0.0)\n  logFormat?: \"text\" | \"json\"                                    // Console log format (default: text)\n  maxRetries?: number                                            // Emit fatal-error after this many consecutive failed restarts; unlimited when unset\n  maxFailuresPerBlock?: number                                   // Consecutive processing failures on one block before fatal-error (default: 5)\n  onGenesisStart?: () => Promise<void>                           // Called before the genesis import begins, outside any transaction\n  onGenesisComplete?: () => Promise<void>                        // Called inside the final genesis transaction, right before it commits\n  init?: () => Promise<void>                                     // Custom initialization function\n  beginTransaction: () => Promise<void>                          // Function to begin database transaction\n  endTransaction: (status: boolean) => Promise<void>             // Function to end database transaction\n};\n\n/** @deprecated Misspelling kept for compatibility, use EclesiaIndexerConfig. Removed in 3.0. */\nexport type EcleciaIndexerConfig = EclesiaIndexerConfig;\n\n/** Queue for full indexing mode with validator data */\nexport type FullBlockQueue = CircularBuffer<[BlockResponse, BlockResultsResponse, Uint8Array]>;\n\n/** Queue for minimal indexing mode without validator data */\nexport type MinimalBlockQueue = CircularBuffer<[BlockResponse, BlockResultsResponse]>;\n\n/** Union type for block queues */\nexport type BlockQueue = FullBlockQueue | MinimalBlockQueue;\n\n/** Utility type to add height, timestamp, and UUID to event types */\nexport type WithHeightAndUUID<T> = {\n  [K in keyof T]: T[K] & {\n    uuid?: string      // Unique identifier for event tracking\n    height?: number    // Block height when event occurred\n    timestamp?: string // Block timestamp when event occurred\n  };\n};\n\n/** Function signature for emitting events asynchronously */\nexport type EmitFunc<K extends keyof WithHeightAndUUID<EventMap>> = (\n  t: K,\n  e: WithHeightAndUUID<EventMap>[K],\n) => Promise<void | void[]>;\n\nexport type LogEvent = {\n  type: \"log\" | \"info\" | \"warning\" | \"error\" | \"verbose\" | \"transient\"\n  message: string\n};\nexport type UUIDEvent = {\n  uuid: string\n  error?: string\n  status: boolean\n};\nexport type Events = {\n  log: LogEvent\n  uuid: UUIDEvent\n  \"fatal-error\": {\n    error: Error\n    message: string\n    retryCount?: number\n    height?: number   // Set when one block failed repeatedly\n  }\n  begin_block: {\n    value: {\n      events: BlockResultsResponse[\"beginBlockEvents\"] | BlockResultsResponse38[\"finalizeBlockEvents\"]\n      validators: Validator[] | undefined\n    }\n  }\n\n  block: {\n    value: {\n      block: BlockResponse\n      block_results: BlockResultsResponse | BlockResultsResponse38\n    }\n  }\n  end_block: {\n    value: BlockResultsResponse[\"endBlockEvents\"] | BlockResultsResponse38[\"finalizeBlockEvents\"]\n  }\n  tx_events: {\n    value: BlockResultsResponse[\"results\"] | BlockResultsResponse38[\"results\"]\n  }\n  tx_memo: {\n    value: {\n      txHash: string\n      txBody: TxBody\n    }\n  }\n  _unhandled: {\n    type: string\n    event: unknown\n  }\n  \"periodic/small\": {\n    value: null\n  }\n  \"periodic/medium\": {\n    value: null\n  }\n  \"periodic/large\": {\n    value: null\n  }\n};\nexport type TxResult<T> = {\n  tx: T\n  events: Event[]\n};\n\n/** Interface that all indexing modules must implement */\nexport interface IndexingModule {\n  indexer: EclesiaIndexer                    // Reference to the main indexer instance\n  name: string                               // Unique module name\n  depends: string[]                          // Array of module names this module depends on\n  provides: string[]                         // Array of capabilities this module provides\n  setup: () => Promise<void>                 // Async setup function for database schema initialization\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  init: (...args: any[]) => void            // Initialization function called by the indexer\n}\n\n/**\n * Global event map. Modules add their own events through declaration merging:\n *\n *   declare global { interface EventMap extends MyModule.Events {} }\n *\n * Declared in a regular module (not an ambient .d.ts) so it is emitted into the\n * published declarations and consumers get typed events without extra setup.\n */\ndeclare global {\n  // eslint-disable-next-line @typescript-eslint/no-empty-object-type\n  interface EventMap extends Events {\n  }\n}\n"],"mappings":""}

package/dist/utils/index.cjs

@@ -2,14 +2,19 @@ const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_bech32 = require('./bech32.cjs');
 const require_bigint = require('./bigint.cjs');
 const require_text = require('./text.cjs');
+const require_timeout = require('./timeout.cjs');
 
 //#region src/utils/index.ts
 var utils_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
 	chainAddressfromKeyhash: () => require_bech32.chainAddressfromKeyhash,
 	decodeAttr: () => require_text.decodeAttr,
+	hasBlockEventMode: () => require_text.hasBlockEventMode,
 	keyHashfromAddress: () => require_bech32.keyHashfromAddress,
+	redactUrl: () => require_text.redactUrl,
+	retryDelay: () => require_timeout.retryDelay,
 	toHexString: () => require_bech32.toHexString,
-	toPlainObject: () => require_bigint.toPlainObject
+	toPlainObject: () => require_bigint.toPlainObject,
+	withTimeout: () => require_timeout.withTimeout
 });
 
 //#endregion

package/dist/utils/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../../src/utils/index.ts"],"sourcesContent":["/* eslint-disable @stylistic/no-multi-spaces */\n// Utility function exports\nexport * from \"./bech32\";  // Bech32 address encoding/decoding utilities\nexport * from \"./bigint\";  // BigInt handling utilities\nexport * from \"./text\";    // Text processing and encoding utilities\n"],"mappings":""}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/utils/index.ts"],"sourcesContent":["/* eslint-disable @stylistic/no-multi-spaces */\n// Utility function exports\nexport * from \"./bech32\";  // Bech32 address encoding/decoding utilities\nexport * from \"./bigint\";  // BigInt handling utilities\nexport * from \"./text\";    // Text processing and encoding utilities\nexport * from \"./timeout\"; // Promise timeout helper\n"],"mappings":""}

package/dist/utils/index.d.cts

@@ -1,10 +1,11 @@
 import { chainAddressfromKeyhash, keyHashfromAddress, toHexString } from "./bech32.cjs";
 import { toPlainObject } from "./bigint.cjs";
-import { decodeAttr } from "./text.cjs";
+import { BlockEventMode, ModeTaggedEvent, decodeAttr, hasBlockEventMode, redactUrl } from "./text.cjs";
+import { retryDelay, withTimeout } from "./timeout.cjs";
 
 //#region src/utils/index.d.ts
 declare namespace index_d_exports {
-  export { chainAddressfromKeyhash, decodeAttr, keyHashfromAddress, toHexString, toPlainObject };
+  export { BlockEventMode, ModeTaggedEvent, chainAddressfromKeyhash, decodeAttr, hasBlockEventMode, keyHashfromAddress, redactUrl, retryDelay, toHexString, toPlainObject, withTimeout };
 }
 //#endregion
 export { index_d_exports };

package/dist/utils/index.d.mts

@@ -1,10 +1,11 @@
 import { chainAddressfromKeyhash, keyHashfromAddress, toHexString } from "./bech32.mjs";
 import { toPlainObject } from "./bigint.mjs";
-import { decodeAttr } from "./text.mjs";
+import { BlockEventMode, ModeTaggedEvent, decodeAttr, hasBlockEventMode, redactUrl } from "./text.mjs";
+import { retryDelay, withTimeout } from "./timeout.mjs";
 
 //#region src/utils/index.d.ts
 declare namespace index_d_exports {
-  export { chainAddressfromKeyhash, decodeAttr, keyHashfromAddress, toHexString, toPlainObject };
+  export { BlockEventMode, ModeTaggedEvent, chainAddressfromKeyhash, decodeAttr, hasBlockEventMode, keyHashfromAddress, redactUrl, retryDelay, toHexString, toPlainObject, withTimeout };
 }
 //#endregion
 export { index_d_exports };

package/dist/utils/index.mjs

@@ -1,15 +1,20 @@
 import { __export } from "../_virtual/rolldown_runtime.mjs";
 import { chainAddressfromKeyhash, keyHashfromAddress, toHexString } from "./bech32.mjs";
 import { toPlainObject } from "./bigint.mjs";
-import { decodeAttr } from "./text.mjs";
+import { decodeAttr, hasBlockEventMode, redactUrl } from "./text.mjs";
+import { retryDelay, withTimeout } from "./timeout.mjs";
 
 //#region src/utils/index.ts
 var utils_exports = /* @__PURE__ */ __export({
 	chainAddressfromKeyhash: () => chainAddressfromKeyhash,
 	decodeAttr: () => decodeAttr,
+	hasBlockEventMode: () => hasBlockEventMode,
 	keyHashfromAddress: () => keyHashfromAddress,
+	redactUrl: () => redactUrl,
+	retryDelay: () => retryDelay,
 	toHexString: () => toHexString,
-	toPlainObject: () => toPlainObject
+	toPlainObject: () => toPlainObject,
+	withTimeout: () => withTimeout
 });
 
 //#endregion

package/dist/utils/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/utils/index.ts"],"sourcesContent":["/* eslint-disable @stylistic/no-multi-spaces */\n// Utility function exports\nexport * from \"./bech32\";  // Bech32 address encoding/decoding utilities\nexport * from \"./bigint\";  // BigInt handling utilities\nexport * from \"./text\";    // Text processing and encoding utilities\n"],"mappings":""}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/utils/index.ts"],"sourcesContent":["/* eslint-disable @stylistic/no-multi-spaces */\n// Utility function exports\nexport * from \"./bech32\";  // Bech32 address encoding/decoding utilities\nexport * from \"./bigint\";  // BigInt handling utilities\nexport * from \"./text\";    // Text processing and encoding utilities\nexport * from \"./timeout\"; // Promise timeout helper\n"],"mappings":""}

package/dist/utils/text.cjs

@@ -11,7 +11,38 @@ const decodeAttr = (x) => {
 	else if (x instanceof Uint8Array) return Buffer.from(x).toString();
 	else return "";
 };
+const MODE_SPELLINGS = {
+	BeginBlock: ["BeginBlock", "begin_block"],
+	EndBlock: ["EndBlock", "end_block"]
+};
+/**
+* Checks whether a finalize_block event carries the given `mode` attribute.
+* The SDK emits `mode=BeginBlock` / `mode=EndBlock`; the snake_case spellings
+* are accepted as well so forks that lowercase the value keep working.
+* @param event - Event with an attributes array
+* @param mode - Which phase of the block the event must belong to
+* @returns true when the event has a matching `mode` attribute
+*/
+const hasBlockEventMode = (event, mode) => {
+	const accepted = MODE_SPELLINGS[mode];
+	return event.attributes.some((a) => decodeAttr(a.key) === "mode" && accepted.includes(decodeAttr(a.value)));
+};
+/**
+* Returns a URL that is safe to log: the password part of any credentials is masked.
+* Strings that do not parse as a URL are returned unchanged.
+*/
+const redactUrl = (url) => {
+	try {
+		const parsed = new URL(url);
+		if (parsed.password) parsed.password = "***";
+		return parsed.toString();
+	} catch (_e) {
+		return url;
+	}
+};
 
 //#endregion
 exports.decodeAttr = decodeAttr;
+exports.hasBlockEventMode = hasBlockEventMode;
+exports.redactUrl = redactUrl;
 //# sourceMappingURL=text.cjs.map

package/dist/utils/text.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"text.cjs","names":[],"sources":["../../src/utils/text.ts"],"sourcesContent":["/**\n * Decodes blockchain event attributes from various formats to strings\n * Handles both string and Uint8Array inputs from Tendermint events\n * @param x - The attribute value to decode (string or Uint8Array)\n * @returns Decoded string value\n */\nexport const decodeAttr = (x: Uint8Array | string) => {\n  if (typeof x === \"string\") {\n    return x;\n  }\n  else if (x instanceof Uint8Array) {\n    return Buffer.from(x).toString();\n  }\n  else {\n    return \"\";\n  }\n};\n"],"mappings":";;;;;;;;AAMA,MAAa,cAAc,MAA2B;AACpD,KAAI,OAAO,MAAM,SACf,QAAO;UAEA,aAAa,WACpB,QAAO,OAAO,KAAK,EAAE,CAAC,UAAU;KAGhC,QAAO"}
+{"version":3,"file":"text.cjs","names":["MODE_SPELLINGS: Record<BlockEventMode, readonly string[]>"],"sources":["../../src/utils/text.ts"],"sourcesContent":["/**\n * Decodes blockchain event attributes from various formats to strings\n * Handles both string and Uint8Array inputs from Tendermint events\n * @param x - The attribute value to decode (string or Uint8Array)\n * @returns Decoded string value\n */\nexport const decodeAttr = (x: Uint8Array | string) => {\n  if (typeof x === \"string\") {\n    return x;\n  }\n  else if (x instanceof Uint8Array) {\n    return Buffer.from(x).toString();\n  }\n  else {\n    return \"\";\n  }\n};\n\n/** Minimal shape of an ABCI event, compatible with both CometBFT 0.37 and 0.38 response types */\nexport type ModeTaggedEvent = {\n  attributes: readonly {\n    key: Uint8Array | string\n    value: Uint8Array | string\n  }[]\n};\n\n/** Values Cosmos SDK 0.50+ stamps on `finalize_block_events` to mark their origin (baseapp.go) */\nexport type BlockEventMode = \"BeginBlock\" | \"EndBlock\";\n\nconst MODE_SPELLINGS: Record<BlockEventMode, readonly string[]> = {\n  BeginBlock: [\"BeginBlock\", \"begin_block\"],\n  EndBlock: [\"EndBlock\", \"end_block\"],\n};\n\n/**\n * Checks whether a finalize_block event carries the given `mode` attribute.\n * The SDK emits `mode=BeginBlock` / `mode=EndBlock`; the snake_case spellings\n * are accepted as well so forks that lowercase the value keep working.\n * @param event - Event with an attributes array\n * @param mode - Which phase of the block the event must belong to\n * @returns true when the event has a matching `mode` attribute\n */\nexport const hasBlockEventMode = (event: ModeTaggedEvent, mode: BlockEventMode): boolean => {\n  const accepted = MODE_SPELLINGS[mode];\n  return event.attributes.some(a => decodeAttr(a.key) === \"mode\" && accepted.includes(decodeAttr(a.value)));\n};\n\n/**\n * Returns a URL that is safe to log: the password part of any credentials is masked.\n * Strings that do not parse as a URL are returned unchanged.\n */\nexport const redactUrl = (url: string): string => {\n  try {\n    const parsed = new URL(url);\n    if (parsed.password) {\n      parsed.password = \"***\";\n    }\n    return parsed.toString();\n  }\n  catch (_e) {\n    return url;\n  }\n};\n"],"mappings":";;;;;;;;AAMA,MAAa,cAAc,MAA2B;AACpD,KAAI,OAAO,MAAM,SACf,QAAO;UAEA,aAAa,WACpB,QAAO,OAAO,KAAK,EAAE,CAAC,UAAU;KAGhC,QAAO;;AAeX,MAAMA,iBAA4D;CAChE,YAAY,CAAC,cAAc,cAAc;CACzC,UAAU,CAAC,YAAY,YAAY;CACpC;;;;;;;;;AAUD,MAAa,qBAAqB,OAAwB,SAAkC;CAC1F,MAAM,WAAW,eAAe;AAChC,QAAO,MAAM,WAAW,MAAK,MAAK,WAAW,EAAE,IAAI,KAAK,UAAU,SAAS,SAAS,WAAW,EAAE,MAAM,CAAC,CAAC;;;;;;AAO3G,MAAa,aAAa,QAAwB;AAChD,KAAI;EACF,MAAM,SAAS,IAAI,IAAI,IAAI;AAC3B,MAAI,OAAO,SACT,QAAO,WAAW;AAEpB,SAAO,OAAO,UAAU;UAEnB,IAAI;AACT,SAAO"}

package/dist/utils/text.d.cts

@@ -6,6 +6,29 @@
  * @returns Decoded string value
  */
 declare const decodeAttr: (x: Uint8Array | string) => string;
+/** Minimal shape of an ABCI event, compatible with both CometBFT 0.37 and 0.38 response types */
+type ModeTaggedEvent = {
+  attributes: readonly {
+    key: Uint8Array | string;
+    value: Uint8Array | string;
+  }[];
+};
+/** Values Cosmos SDK 0.50+ stamps on `finalize_block_events` to mark their origin (baseapp.go) */
+type BlockEventMode = "BeginBlock" | "EndBlock";
+/**
+ * Checks whether a finalize_block event carries the given `mode` attribute.
+ * The SDK emits `mode=BeginBlock` / `mode=EndBlock`; the snake_case spellings
+ * are accepted as well so forks that lowercase the value keep working.
+ * @param event - Event with an attributes array
+ * @param mode - Which phase of the block the event must belong to
+ * @returns true when the event has a matching `mode` attribute
+ */
+declare const hasBlockEventMode: (event: ModeTaggedEvent, mode: BlockEventMode) => boolean;
+/**
+ * Returns a URL that is safe to log: the password part of any credentials is masked.
+ * Strings that do not parse as a URL are returned unchanged.
+ */
+declare const redactUrl: (url: string) => string;
 //#endregion
-export { decodeAttr };
+export { BlockEventMode, ModeTaggedEvent, decodeAttr, hasBlockEventMode, redactUrl };
 //# sourceMappingURL=text.d.cts.map

package/dist/utils/text.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.cts","names":[],"sources":["../../src/utils/text.ts"],"sourcesContent":[],"mappings":";;AAMA;;;;;cAAa,gBAAiB"}
+{"version":3,"file":"text.d.cts","names":[],"sources":["../../src/utils/text.ts"],"sourcesContent":[],"mappings":";;AAMA;AAaA;AAQA;AAeA;AASA;cA7Ca,gBAAiB;;KAalB,eAAA;;SAEH;WACE;;;;KAKC,cAAA;;;;;;;;;cAeC,2BAA4B,uBAAuB;;;;;cASnD"}

package/dist/utils/text.d.mts

@@ -6,6 +6,29 @@
  * @returns Decoded string value
  */
 declare const decodeAttr: (x: Uint8Array | string) => string;
+/** Minimal shape of an ABCI event, compatible with both CometBFT 0.37 and 0.38 response types */
+type ModeTaggedEvent = {
+  attributes: readonly {
+    key: Uint8Array | string;
+    value: Uint8Array | string;
+  }[];
+};
+/** Values Cosmos SDK 0.50+ stamps on `finalize_block_events` to mark their origin (baseapp.go) */
+type BlockEventMode = "BeginBlock" | "EndBlock";
+/**
+ * Checks whether a finalize_block event carries the given `mode` attribute.
+ * The SDK emits `mode=BeginBlock` / `mode=EndBlock`; the snake_case spellings
+ * are accepted as well so forks that lowercase the value keep working.
+ * @param event - Event with an attributes array
+ * @param mode - Which phase of the block the event must belong to
+ * @returns true when the event has a matching `mode` attribute
+ */
+declare const hasBlockEventMode: (event: ModeTaggedEvent, mode: BlockEventMode) => boolean;
+/**
+ * Returns a URL that is safe to log: the password part of any credentials is masked.
+ * Strings that do not parse as a URL are returned unchanged.
+ */
+declare const redactUrl: (url: string) => string;
 //#endregion
-export { decodeAttr };
+export { BlockEventMode, ModeTaggedEvent, decodeAttr, hasBlockEventMode, redactUrl };
 //# sourceMappingURL=text.d.mts.map

package/dist/utils/text.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.mts","names":[],"sources":["../../src/utils/text.ts"],"sourcesContent":[],"mappings":";;AAMA;;;;;cAAa,gBAAiB"}
+{"version":3,"file":"text.d.mts","names":[],"sources":["../../src/utils/text.ts"],"sourcesContent":[],"mappings":";;AAMA;AAaA;AAQA;AAeA;AASA;cA7Ca,gBAAiB;;KAalB,eAAA;;SAEH;WACE;;;;KAKC,cAAA;;;;;;;;;cAeC,2BAA4B,uBAAuB;;;;;cASnD"}

package/dist/utils/text.mjs

@@ -10,7 +10,36 @@ const decodeAttr = (x) => {
 	else if (x instanceof Uint8Array) return Buffer.from(x).toString();
 	else return "";
 };
+const MODE_SPELLINGS = {
+	BeginBlock: ["BeginBlock", "begin_block"],
+	EndBlock: ["EndBlock", "end_block"]
+};
+/**
+* Checks whether a finalize_block event carries the given `mode` attribute.
+* The SDK emits `mode=BeginBlock` / `mode=EndBlock`; the snake_case spellings
+* are accepted as well so forks that lowercase the value keep working.
+* @param event - Event with an attributes array
+* @param mode - Which phase of the block the event must belong to
+* @returns true when the event has a matching `mode` attribute
+*/
+const hasBlockEventMode = (event, mode) => {
+	const accepted = MODE_SPELLINGS[mode];
+	return event.attributes.some((a) => decodeAttr(a.key) === "mode" && accepted.includes(decodeAttr(a.value)));
+};
+/**
+* Returns a URL that is safe to log: the password part of any credentials is masked.
+* Strings that do not parse as a URL are returned unchanged.
+*/
+const redactUrl = (url) => {
+	try {
+		const parsed = new URL(url);
+		if (parsed.password) parsed.password = "***";
+		return parsed.toString();
+	} catch (_e) {
+		return url;
+	}
+};
 
 //#endregion
-export { decodeAttr };
+export { decodeAttr, hasBlockEventMode, redactUrl };
 //# sourceMappingURL=text.mjs.map

package/dist/utils/text.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"text.mjs","names":[],"sources":["../../src/utils/text.ts"],"sourcesContent":["/**\n * Decodes blockchain event attributes from various formats to strings\n * Handles both string and Uint8Array inputs from Tendermint events\n * @param x - The attribute value to decode (string or Uint8Array)\n * @returns Decoded string value\n */\nexport const decodeAttr = (x: Uint8Array | string) => {\n  if (typeof x === \"string\") {\n    return x;\n  }\n  else if (x instanceof Uint8Array) {\n    return Buffer.from(x).toString();\n  }\n  else {\n    return \"\";\n  }\n};\n"],"mappings":";;;;;;;AAMA,MAAa,cAAc,MAA2B;AACpD,KAAI,OAAO,MAAM,SACf,QAAO;UAEA,aAAa,WACpB,QAAO,OAAO,KAAK,EAAE,CAAC,UAAU;KAGhC,QAAO"}
+{"version":3,"file":"text.mjs","names":["MODE_SPELLINGS: Record<BlockEventMode, readonly string[]>"],"sources":["../../src/utils/text.ts"],"sourcesContent":["/**\n * Decodes blockchain event attributes from various formats to strings\n * Handles both string and Uint8Array inputs from Tendermint events\n * @param x - The attribute value to decode (string or Uint8Array)\n * @returns Decoded string value\n */\nexport const decodeAttr = (x: Uint8Array | string) => {\n  if (typeof x === \"string\") {\n    return x;\n  }\n  else if (x instanceof Uint8Array) {\n    return Buffer.from(x).toString();\n  }\n  else {\n    return \"\";\n  }\n};\n\n/** Minimal shape of an ABCI event, compatible with both CometBFT 0.37 and 0.38 response types */\nexport type ModeTaggedEvent = {\n  attributes: readonly {\n    key: Uint8Array | string\n    value: Uint8Array | string\n  }[]\n};\n\n/** Values Cosmos SDK 0.50+ stamps on `finalize_block_events` to mark their origin (baseapp.go) */\nexport type BlockEventMode = \"BeginBlock\" | \"EndBlock\";\n\nconst MODE_SPELLINGS: Record<BlockEventMode, readonly string[]> = {\n  BeginBlock: [\"BeginBlock\", \"begin_block\"],\n  EndBlock: [\"EndBlock\", \"end_block\"],\n};\n\n/**\n * Checks whether a finalize_block event carries the given `mode` attribute.\n * The SDK emits `mode=BeginBlock` / `mode=EndBlock`; the snake_case spellings\n * are accepted as well so forks that lowercase the value keep working.\n * @param event - Event with an attributes array\n * @param mode - Which phase of the block the event must belong to\n * @returns true when the event has a matching `mode` attribute\n */\nexport const hasBlockEventMode = (event: ModeTaggedEvent, mode: BlockEventMode): boolean => {\n  const accepted = MODE_SPELLINGS[mode];\n  return event.attributes.some(a => decodeAttr(a.key) === \"mode\" && accepted.includes(decodeAttr(a.value)));\n};\n\n/**\n * Returns a URL that is safe to log: the password part of any credentials is masked.\n * Strings that do not parse as a URL are returned unchanged.\n */\nexport const redactUrl = (url: string): string => {\n  try {\n    const parsed = new URL(url);\n    if (parsed.password) {\n      parsed.password = \"***\";\n    }\n    return parsed.toString();\n  }\n  catch (_e) {\n    return url;\n  }\n};\n"],"mappings":";;;;;;;AAMA,MAAa,cAAc,MAA2B;AACpD,KAAI,OAAO,MAAM,SACf,QAAO;UAEA,aAAa,WACpB,QAAO,OAAO,KAAK,EAAE,CAAC,UAAU;KAGhC,QAAO;;AAeX,MAAMA,iBAA4D;CAChE,YAAY,CAAC,cAAc,cAAc;CACzC,UAAU,CAAC,YAAY,YAAY;CACpC;;;;;;;;;AAUD,MAAa,qBAAqB,OAAwB,SAAkC;CAC1F,MAAM,WAAW,eAAe;AAChC,QAAO,MAAM,WAAW,MAAK,MAAK,WAAW,EAAE,IAAI,KAAK,UAAU,SAAS,SAAS,WAAW,EAAE,MAAM,CAAC,CAAC;;;;;;AAO3G,MAAa,aAAa,QAAwB;AAChD,KAAI;EACF,MAAM,SAAS,IAAI,IAAI,IAAI;AAC3B,MAAI,OAAO,SACT,QAAO,WAAW;AAEpB,SAAO,OAAO,UAAU;UAEnB,IAAI;AACT,SAAO"}

package/dist/utils/timeout.cjs

@@ -0,0 +1,32 @@
+
+//#region src/utils/timeout.ts
+/**
+* Races a promise against a timer and clears the timer however the race settles,
+* so a finished operation never leaves a pending timeout keeping the event loop alive.
+* @param promise - The operation to bound
+* @param ms - Milliseconds to wait before rejecting
+* @param error - Error to reject with when the timer wins
+* @returns The promise's value, or a rejection with `error` on timeout
+*/
+const withTimeout = (promise, ms, error) => {
+	let handle;
+	const timeout = new Promise((_resolve, reject) => {
+		handle = setTimeout(() => reject(error), ms);
+	});
+	return Promise.race([promise, timeout]).finally(() => {
+		if (handle) clearTimeout(handle);
+	});
+};
+/**
+* Restart delay for the n-th consecutive failure: exponential from `baseMs`, capped at `maxMs`.
+* @param attempt - 1 for the first restart, 2 for the second, and so on
+*/
+const retryDelay = (attempt, baseMs, maxMs) => {
+	const exponent = Math.max(0, attempt - 1);
+	return Math.min(baseMs * Math.pow(2, exponent), maxMs);
+};
+
+//#endregion
+exports.retryDelay = retryDelay;
+exports.withTimeout = withTimeout;
+//# sourceMappingURL=timeout.cjs.map

package/dist/utils/timeout.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.cjs","names":["handle: NodeJS.Timeout | undefined"],"sources":["../../src/utils/timeout.ts"],"sourcesContent":["/**\n * Races a promise against a timer and clears the timer however the race settles,\n * so a finished operation never leaves a pending timeout keeping the event loop alive.\n * @param promise - The operation to bound\n * @param ms - Milliseconds to wait before rejecting\n * @param error - Error to reject with when the timer wins\n * @returns The promise's value, or a rejection with `error` on timeout\n */\nexport const withTimeout = <T>(promise: Promise<T>, ms: number, error: Error): Promise<T> => {\n  let handle: NodeJS.Timeout | undefined;\n  const timeout = new Promise<never>((_resolve, reject) => {\n    handle = setTimeout(() => reject(error), ms);\n  });\n  return Promise.race([promise, timeout]).finally(() => {\n    if (handle) {\n      clearTimeout(handle);\n    }\n  });\n};\n\n/**\n * Restart delay for the n-th consecutive failure: exponential from `baseMs`, capped at `maxMs`.\n * @param attempt - 1 for the first restart, 2 for the second, and so on\n */\nexport const retryDelay = (attempt: number, baseMs: number, maxMs: number): number => {\n  const exponent = Math.max(0, attempt - 1);\n  return Math.min(baseMs * Math.pow(2, exponent), maxMs);\n};\n"],"mappings":";;;;;;;;;;AAQA,MAAa,eAAkB,SAAqB,IAAY,UAA6B;CAC3F,IAAIA;CACJ,MAAM,UAAU,IAAI,SAAgB,UAAU,WAAW;AACvD,WAAS,iBAAiB,OAAO,MAAM,EAAE,GAAG;GAC5C;AACF,QAAO,QAAQ,KAAK,CAAC,SAAS,QAAQ,CAAC,CAAC,cAAc;AACpD,MAAI,OACF,cAAa,OAAO;GAEtB;;;;;;AAOJ,MAAa,cAAc,SAAiB,QAAgB,UAA0B;CACpF,MAAM,WAAW,KAAK,IAAI,GAAG,UAAU,EAAE;AACzC,QAAO,KAAK,IAAI,SAAS,KAAK,IAAI,GAAG,SAAS,EAAE,MAAM"}

package/dist/utils/timeout.d.cts

@@ -0,0 +1,18 @@
+//#region src/utils/timeout.d.ts
+/**
+ * Races a promise against a timer and clears the timer however the race settles,
+ * so a finished operation never leaves a pending timeout keeping the event loop alive.
+ * @param promise - The operation to bound
+ * @param ms - Milliseconds to wait before rejecting
+ * @param error - Error to reject with when the timer wins
+ * @returns The promise's value, or a rejection with `error` on timeout
+ */
+declare const withTimeout: <T>(promise: Promise<T>, ms: number, error: Error) => Promise<T>;
+/**
+ * Restart delay for the n-th consecutive failure: exponential from `baseMs`, capped at `maxMs`.
+ * @param attempt - 1 for the first restart, 2 for the second, and so on
+ */
+declare const retryDelay: (attempt: number, baseMs: number, maxMs: number) => number;
+//#endregion
+export { retryDelay, withTimeout };
+//# sourceMappingURL=timeout.d.cts.map

package/dist/utils/timeout.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.cts","names":[],"sources":["../../src/utils/timeout.ts"],"sourcesContent":[],"mappings":";;AAQA;;;;;;;AAgBa,cAhBA,WAmBZ,EAAA,CAAA,CAAA,CAAA,CAAA,OAAA,EAnBuC,OAmBvC,CAnB+C,CAmB/C,CAAA,EAAA,EAAA,EAAA,MAAA,EAAA,KAAA,EAnBsE,KAmBtE,EAAA,GAnB8E,OAmB9E,CAnBsF,CAmBtF,CAAA;;;;;cAHY"}

package/dist/utils/timeout.d.mts

@@ -0,0 +1,18 @@
+//#region src/utils/timeout.d.ts
+/**
+ * Races a promise against a timer and clears the timer however the race settles,
+ * so a finished operation never leaves a pending timeout keeping the event loop alive.
+ * @param promise - The operation to bound
+ * @param ms - Milliseconds to wait before rejecting
+ * @param error - Error to reject with when the timer wins
+ * @returns The promise's value, or a rejection with `error` on timeout
+ */
+declare const withTimeout: <T>(promise: Promise<T>, ms: number, error: Error) => Promise<T>;
+/**
+ * Restart delay for the n-th consecutive failure: exponential from `baseMs`, capped at `maxMs`.
+ * @param attempt - 1 for the first restart, 2 for the second, and so on
+ */
+declare const retryDelay: (attempt: number, baseMs: number, maxMs: number) => number;
+//#endregion
+export { retryDelay, withTimeout };
+//# sourceMappingURL=timeout.d.mts.map

package/dist/utils/timeout.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.mts","names":[],"sources":["../../src/utils/timeout.ts"],"sourcesContent":[],"mappings":";;AAQA;;;;;;;AAgBa,cAhBA,WAmBZ,EAAA,CAAA,CAAA,CAAA,CAAA,OAAA,EAnBuC,OAmBvC,CAnB+C,CAmB/C,CAAA,EAAA,EAAA,EAAA,MAAA,EAAA,KAAA,EAnBsE,KAmBtE,EAAA,GAnB8E,OAmB9E,CAnBsF,CAmBtF,CAAA;;;;;cAHY"}

package/dist/utils/timeout.mjs

@@ -0,0 +1,30 @@
+//#region src/utils/timeout.ts
+/**
+* Races a promise against a timer and clears the timer however the race settles,
+* so a finished operation never leaves a pending timeout keeping the event loop alive.
+* @param promise - The operation to bound
+* @param ms - Milliseconds to wait before rejecting
+* @param error - Error to reject with when the timer wins
+* @returns The promise's value, or a rejection with `error` on timeout
+*/
+const withTimeout = (promise, ms, error) => {
+	let handle;
+	const timeout = new Promise((_resolve, reject) => {
+		handle = setTimeout(() => reject(error), ms);
+	});
+	return Promise.race([promise, timeout]).finally(() => {
+		if (handle) clearTimeout(handle);
+	});
+};
+/**
+* Restart delay for the n-th consecutive failure: exponential from `baseMs`, capped at `maxMs`.
+* @param attempt - 1 for the first restart, 2 for the second, and so on
+*/
+const retryDelay = (attempt, baseMs, maxMs) => {
+	const exponent = Math.max(0, attempt - 1);
+	return Math.min(baseMs * Math.pow(2, exponent), maxMs);
+};
+
+//#endregion
+export { retryDelay, withTimeout };
+//# sourceMappingURL=timeout.mjs.map

package/dist/utils/timeout.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.mjs","names":["handle: NodeJS.Timeout | undefined"],"sources":["../../src/utils/timeout.ts"],"sourcesContent":["/**\n * Races a promise against a timer and clears the timer however the race settles,\n * so a finished operation never leaves a pending timeout keeping the event loop alive.\n * @param promise - The operation to bound\n * @param ms - Milliseconds to wait before rejecting\n * @param error - Error to reject with when the timer wins\n * @returns The promise's value, or a rejection with `error` on timeout\n */\nexport const withTimeout = <T>(promise: Promise<T>, ms: number, error: Error): Promise<T> => {\n  let handle: NodeJS.Timeout | undefined;\n  const timeout = new Promise<never>((_resolve, reject) => {\n    handle = setTimeout(() => reject(error), ms);\n  });\n  return Promise.race([promise, timeout]).finally(() => {\n    if (handle) {\n      clearTimeout(handle);\n    }\n  });\n};\n\n/**\n * Restart delay for the n-th consecutive failure: exponential from `baseMs`, capped at `maxMs`.\n * @param attempt - 1 for the first restart, 2 for the second, and so on\n */\nexport const retryDelay = (attempt: number, baseMs: number, maxMs: number): number => {\n  const exponent = Math.max(0, attempt - 1);\n  return Math.min(baseMs * Math.pow(2, exponent), maxMs);\n};\n"],"mappings":";;;;;;;;;AAQA,MAAa,eAAkB,SAAqB,IAAY,UAA6B;CAC3F,IAAIA;CACJ,MAAM,UAAU,IAAI,SAAgB,UAAU,WAAW;AACvD,WAAS,iBAAiB,OAAO,MAAM,EAAE,GAAG;GAC5C;AACF,QAAO,QAAQ,KAAK,CAAC,SAAS,QAAQ,CAAC,CAAC,cAAc;AACpD,MAAI,OACF,cAAa,OAAO;GAEtB;;;;;;AAOJ,MAAa,cAAc,SAAiB,QAAgB,UAA0B;CACpF,MAAM,WAAW,KAAK,IAAI,GAAG,UAAU,EAAE;AACzC,QAAO,KAAK,IAAI,SAAS,KAAK,IAAI,GAAG,SAAS,EAAE,MAAM"}