@polygonlabs/servercore 0.0.0 → 1.0.0-beta.1

package/dist/api/index.d.ts

@@ -4,4 +4,5 @@ import '../errors/api_errors.js';
 import '../errors/base_error.js';
 import '../errors/database_errors.js';
 import '../errors/external_dependency_error.js';
+import '../types/response_context.js';
 import 'zod';

package/dist/api/response_handler.d.ts

@@ -1,12 +1,9 @@
 import { ApiError } from '../errors/api_errors.js';
 import { DatabaseError } from '../errors/database_errors.js';
 import { ExternalDependencyError } from '../errors/external_dependency_error.js';
+import { ResponseContext } from '../types/response_context.js';
 import '../errors/base_error.js';
 
-type ResponseContext = {
-    status: (statusCode: number) => ResponseContext;
-    json: (body: any) => any;
-};
 declare const handleResponse: (c: ResponseContext, data: any) => any;
 declare const handleError: (c: ResponseContext, error: ApiError | ExternalDependencyError | DatabaseError) => any;
 

package/dist/api/response_handler.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/api/response_handler.ts"],"sourcesContent":["import { ApiError, DatabaseError, ExternalDependencyError } from \"../errors\"; // Define your error types\nimport { httpResposneCodes, errorCodes } from \"../constants\"; // Define your success codes\n\ntype ResponseContext = {\n    // Here we allow the user of this utility to pass the response methods depending on the API framework.\n    // For example, in Express, this would be `res` (response) object.\n    status: (statusCode: number) => ResponseContext;\n    json: (body: any) => any; // Define how to send JSON responses\n};\n\nexport const handleResponse = (c: ResponseContext, data: any) => {\n    // This method returns a success response with the status and data.\n    return c\n        .status(httpResposneCodes.OK_RESPONSE) // Use success code from httpResposneCodes\n        .json({\n            status: \"success\",\n            data: data,\n        });\n};\n\nexport const handleError = (\n    c: ResponseContext,\n    error: ApiError | ExternalDependencyError | DatabaseError\n) => {\n    // This method returns an error response with the error details.\n    return c\n        .status(error.code ?? errorCodes.api.INTERNAL_SERVER_ERROR) // Use error code or default to internal server error\n        .json({\n            status: \"error\",\n            message: error.message,\n            name: error.name,\n            code: error.code,\n            details: error.context,\n        });\n};\n"],"mappings":"AAAA,SAAS,UAAU,eAAe,+BAA+B;AACjE,SAAS,mBAAmB,kBAAkB;AASvC,MAAM,iBAAiB,CAAC,GAAoB,SAAc;AAE7D,SAAO,EACF,OAAO,kBAAkB,WAAW,EACpC,KAAK;AAAA,IACF,QAAQ;AAAA,IACR;AAAA,EACJ,CAAC;AACT;AAEO,MAAM,cAAc,CACvB,GACA,UACC;AAED,SAAO,EACF,OAAO,MAAM,QAAQ,WAAW,IAAI,qBAAqB,EACzD,KAAK;AAAA,IACF,QAAQ;AAAA,IACR,SAAS,MAAM;AAAA,IACf,MAAM,MAAM;AAAA,IACZ,MAAM,MAAM;AAAA,IACZ,SAAS,MAAM;AAAA,EACnB,CAAC;AACT;","names":[]}
+{"version":3,"sources":["../../src/api/response_handler.ts"],"sourcesContent":["import { ApiError, DatabaseError, ExternalDependencyError } from \"../errors\"; // Define your error types\nimport { httpResposneCodes, errorCodes } from \"../constants\"; // Define your success codes\nimport type { ResponseContext } from \"../types\";\n\nexport const handleResponse = (c: ResponseContext, data: any) => {\n    // This method returns a success response with the status and data.\n    return c\n        .status(httpResposneCodes.OK_RESPONSE) // Use success code from httpResposneCodes\n        .json({\n            status: \"success\",\n            data: data,\n        });\n};\n\nexport const handleError = (\n    c: ResponseContext,\n    error: ApiError | ExternalDependencyError | DatabaseError\n) => {\n    // This method returns an error response with the error details.\n    return c\n        .status(error.code ?? errorCodes.api.INTERNAL_SERVER_ERROR) // Use error code or default to internal server error\n        .json({\n            status: \"error\",\n            message: error.message,\n            name: error.name,\n            code: error.code,\n            details: error.context,\n        });\n};\n"],"mappings":"AAAA,SAAS,UAAU,eAAe,+BAA+B;AACjE,SAAS,mBAAmB,kBAAkB;AAGvC,MAAM,iBAAiB,CAAC,GAAoB,SAAc;AAE7D,SAAO,EACF,OAAO,kBAAkB,WAAW,EACpC,KAAK;AAAA,IACF,QAAQ;AAAA,IACR;AAAA,EACJ,CAAC;AACT;AAEO,MAAM,cAAc,CACvB,GACA,UACC;AAED,SAAO,EACF,OAAO,MAAM,QAAQ,WAAW,IAAI,qBAAqB,EACzD,KAAK;AAAA,IACF,QAAQ;AAAA,IACR,SAAS,MAAM;AAAA,IACf,MAAM,MAAM;AAAA,IACZ,MAAM,MAAM;AAAA,IACZ,SAAS,MAAM;AAAA,EACnB,CAAC;AACT;","names":[]}

package/dist/consumers/abstract_event_consumer.d.ts

@@ -0,0 +1,34 @@
+import { ConsumerError } from '../errors/consumer_errors.js';
+import { EventEmitter } from 'events';
+import '../errors/base_error.js';
+
+declare class AbstractEventConsumer extends EventEmitter {
+    constructor();
+    /**
+     * @public
+     *
+     * Method to register listener for events. The Abstract Event Consumer emits fatalError
+     * event.
+     *
+     * @param {"fatalError"} eventName - Event name to register listener for.
+     * @param listener - Listener to be called when emitting the event.
+     *
+     * @returns {this} - Returns an instance of the class.
+     */
+    on(eventName: "fatalError", listener: (error: Error | ConsumerError) => void): this;
+    /**
+     * @public
+     *
+     * Method to register listener for events that will be called only once. The Abstract Event Consumer emits fatalError
+     * event.
+     *
+     * @param {"fatalError"} eventName - Event name to register listener for.
+     * @param listener - Listener to be called when emitting the event.
+     *
+     * @returns {this} - Returns an instance of the class.
+     */
+    once(eventName: "fatalError", listener: (error: Error | ConsumerError) => void): this;
+    protected onFatalError(error: Error | ConsumerError): void;
+}
+
+export { AbstractEventConsumer };

package/dist/consumers/abstract_event_consumer.js

@@ -0,0 +1,41 @@
+import { EventEmitter } from "events";
+class AbstractEventConsumer extends EventEmitter {
+  constructor() {
+    super();
+  }
+  /**
+   * @public
+   *
+   * Method to register listener for events. The Abstract Event Consumer emits fatalError
+   * event.
+   *
+   * @param {"fatalError"} eventName - Event name to register listener for.
+   * @param listener - Listener to be called when emitting the event.
+   *
+   * @returns {this} - Returns an instance of the class.
+   */
+  on(eventName, listener) {
+    return super.on(eventName, listener);
+  }
+  /**
+   * @public
+   *
+   * Method to register listener for events that will be called only once. The Abstract Event Consumer emits fatalError
+   * event.
+   *
+   * @param {"fatalError"} eventName - Event name to register listener for.
+   * @param listener - Listener to be called when emitting the event.
+   *
+   * @returns {this} - Returns an instance of the class.
+   */
+  once(eventName, listener) {
+    return super.on(eventName, listener);
+  }
+  onFatalError(error) {
+    this.emit("fatalError", error);
+  }
+}
+export {
+  AbstractEventConsumer
+};
+//# sourceMappingURL=abstract_event_consumer.js.map

package/dist/consumers/abstract_event_consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/consumers/abstract_event_consumer.ts"],"sourcesContent":["import type { ConsumerError } from \"../errors\";\nimport { EventEmitter } from \"events\";\n\nexport class AbstractEventConsumer extends EventEmitter {\n    constructor() {\n        super();\n    }\n\n    /**\n     * @public\n     *\n     * Method to register listener for events. The Abstract Event Consumer emits fatalError\n     * event.\n     *\n     * @param {\"fatalError\"} eventName - Event name to register listener for.\n     * @param listener - Listener to be called when emitting the event.\n     *\n     * @returns {this} - Returns an instance of the class.\n     */\n    on(\n        eventName: \"fatalError\",\n        listener: (error: Error | ConsumerError) => void\n    ): this {\n        return super.on(eventName, listener);\n    }\n    /**\n     * @public\n     *\n     * Method to register listener for events that will be called only once. The Abstract Event Consumer emits fatalError\n     * event.\n     *\n     * @param {\"fatalError\"} eventName - Event name to register listener for.\n     * @param listener - Listener to be called when emitting the event.\n     *\n     * @returns {this} - Returns an instance of the class.\n     */\n    once(\n        eventName: \"fatalError\",\n        listener: (error: Error | ConsumerError) => void\n    ): this {\n        return super.on(eventName, listener);\n    }\n\n    protected onFatalError(error: Error | ConsumerError): void {\n        this.emit(\"fatalError\", error);\n    }\n}\n"],"mappings":"AACA,SAAS,oBAAoB;AAEtB,MAAM,8BAA8B,aAAa;AAAA,EACpD,cAAc;AACV,UAAM;AAAA,EACV;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,GACI,WACA,UACI;AACJ,WAAO,MAAM,GAAG,WAAW,QAAQ;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,KACI,WACA,UACI;AACJ,WAAO,MAAM,GAAG,WAAW,QAAQ;AAAA,EACvC;AAAA,EAEU,aAAa,OAAoC;AACvD,SAAK,KAAK,cAAc,KAAK;AAAA,EACjC;AACJ;","names":[]}

package/dist/consumers/event_consumer.d.ts

@@ -0,0 +1,26 @@
+import { PublicClient, WatchEventReturnType } from 'viem';
+import { ConsumerError } from '../errors/consumer_errors.js';
+import { IObserver } from '../types/observer.js';
+import { IEventConsumerConfig } from '../types/event_consumer_config.js';
+import { AbstractEventConsumer } from './abstract_event_consumer.js';
+import '../errors/base_error.js';
+import 'events';
+
+declare class EventConsumer<T, U> extends AbstractEventConsumer {
+    private config;
+    protected client: PublicClient | null;
+    protected observer: IObserver<T, ConsumerError, U> | null;
+    isBackfillingInProcess: boolean;
+    protected unWatchFunction: WatchEventReturnType | undefined;
+    constructor(config: IEventConsumerConfig);
+    private _backfillEvents;
+    start(observer: IObserver<T, ConsumerError, U>): Promise<void>;
+    /**
+     * Private method which updates the connection status of consumer to disconnected, and removes all listeners.
+     *
+     * @returns {void}
+     */
+    onDisconnect(): void;
+}
+
+export { EventConsumer };

package/dist/consumers/event_consumer.js

@@ -0,0 +1,141 @@
+import { Logger } from "../logger";
+import { createPublicClient, http } from "viem";
+import { ConsumerError, ExternalDependencyError } from "../errors";
+import { AbstractEventConsumer } from "./abstract_event_consumer";
+import { errorCodes } from "../constants";
+class EventConsumer extends AbstractEventConsumer {
+  constructor(config) {
+    super();
+    this.config = config;
+    this.client = createPublicClient({
+      chain: {
+        id: config.chainId,
+        name: "custom",
+        rpcUrls: { default: { http: [config.rpcUrl] } },
+        nativeCurrency: config.nativeCurrency
+      },
+      transport: http(config.rpcUrl)
+    });
+  }
+  client = null;
+  observer = null;
+  isBackfillingInProcess = false;
+  unWatchFunction;
+  async _backfillEvents(fromBlock, toBlock, step) {
+    Logger.info({
+      location: "event_consumer",
+      functon: "_backfillEvents",
+      status: `[Backfill] Starting backfill from block ${fromBlock.toString()} to ${toBlock.toString()}`
+    });
+    for (let start = fromBlock; start <= toBlock; start += step) {
+      const end = start + step - 1n > toBlock ? toBlock : start + step - 1n;
+      Logger.debug({
+        location: "event_consumer",
+        functon: "_backfillEvents",
+        status: `[Backfill] Fetching logs from block ${start.toString()} to ${end.toString()}`
+      });
+      const getLogsConfig = {
+        address: this.config.contractAddress,
+        fromBlock: start,
+        toBlock: end
+      };
+      if (this.config.events.length > 1) {
+        getLogsConfig.event = this.config.events[0];
+      } else {
+        getLogsConfig.events = this.config.events;
+      }
+      const logs = await this.client?.getLogs(getLogsConfig);
+      Logger.debug({
+        location: "event_consumer",
+        functon: "_backfillEvents",
+        status: `[Backfill] ${logs?.length} logs from block ${start.toString()} to ${end.toString()}`
+      });
+      await this.observer?.next(logs);
+    }
+  }
+  async start(observer) {
+    try {
+      this.isBackfillingInProcess = true;
+      this.observer = observer;
+      const latestBlock = await this.client?.getBlockNumber() ?? BigInt(0);
+      Logger.debug({
+        location: "event_consumer",
+        functon: "start",
+        data: {
+          latestBlock: latestBlock.toString(),
+          startBlock: this.config.startBlock.toString(),
+          pollBatchSize: this.config.pollBatchSize.toString()
+        }
+      });
+      if (latestBlock - this.config.startBlock > BigInt(0)) {
+        await this._backfillEvents(
+          this.config.startBlock,
+          latestBlock,
+          this.config.pollBatchSize
+        );
+      }
+      this.isBackfillingInProcess = false;
+      Logger.debug({
+        location: "event_consumer",
+        functon: "start",
+        status: `Starting event subscription`
+      });
+      this.unWatchFunction = this.client?.watchEvent({
+        address: this.config.contractAddress,
+        events: this.config.events,
+        fromBlock: latestBlock,
+        onLogs: (logs) => {
+          const transformedLogs = logs;
+          this.observer?.next(transformedLogs);
+        },
+        onError: (error) => {
+          this.onDisconnect();
+          this.onFatalError(
+            new ConsumerError(error.name, {
+              name: "CONSUMER_ERROR",
+              code: 1001,
+              isFatal: true,
+              origin: "EventConsumer",
+              context: { eventName: this.config.events }
+            })
+          );
+        }
+      });
+      Logger.debug({
+        location: "event_consumer",
+        functon: "start",
+        status: `Subscribed to event`
+      });
+    } catch (error) {
+      this.onDisconnect();
+      this.onFatalError(
+        new ExternalDependencyError(
+          this.config.rpcUrl,
+          "Failed to start the event consumer",
+          {
+            externalCode: errorCodes.external.UNKNOWN_EXTERNAL_DEPENDENCY_ERROR,
+            rawError: error,
+            origin: "EventConsumer",
+            context: { eventName: this.config.events }
+          }
+        )
+      );
+    }
+  }
+  /**
+   * Private method which updates the connection status of consumer to disconnected, and removes all listeners.
+   *
+   * @returns {void}
+   */
+  onDisconnect() {
+    this.removeAllListeners();
+    if (this.unWatchFunction) {
+      this.unWatchFunction();
+    }
+    this.observer?.closed();
+  }
+}
+export {
+  EventConsumer
+};
+//# sourceMappingURL=event_consumer.js.map

package/dist/consumers/event_consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/consumers/event_consumer.ts"],"sourcesContent":["import { Logger } from \"../logger\";\nimport { createPublicClient, http, type PublicClient, type WatchEventReturnType } from \"viem\";\nimport { ConsumerError, ExternalDependencyError } from \"../errors\";\nimport type { IEventConsumerConfig, IObserver } from \"../types\";\nimport { AbstractEventConsumer } from \"./abstract_event_consumer\";\nimport { errorCodes } from \"../constants\";\n\nexport class EventConsumer<T, U> extends AbstractEventConsumer {\n    protected client: PublicClient | null = null;\n    protected observer: IObserver<T, ConsumerError, U> | null = null;\n    public isBackfillingInProcess: boolean = false;\n    protected unWatchFunction: WatchEventReturnType | undefined;\n\n    constructor(private config: IEventConsumerConfig) {\n        super();\n        this.client = createPublicClient({\n            chain: {\n                id: config.chainId,\n                name: \"custom\",\n                rpcUrls: { default: { http: [config.rpcUrl] } },\n                nativeCurrency: config.nativeCurrency,\n            },\n            transport: http(config.rpcUrl),\n        });\n    }\n\n    private async _backfillEvents(\n        fromBlock: bigint,\n        toBlock: bigint,\n        step: bigint\n    ): Promise<void> {\n        Logger.info({\n            location: \"event_consumer\",\n            functon: \"_backfillEvents\",\n            status: `[Backfill] Starting backfill from block ${fromBlock.toString()} to ${toBlock.toString()}`,\n        });\n\n        for (let start = fromBlock; start <= toBlock; start += step) {\n            const end =\n                start + step - 1n > toBlock ? toBlock : start + step - 1n;\n            Logger.debug({\n                location: \"event_consumer\",\n                functon: \"_backfillEvents\",\n                status: `[Backfill] Fetching logs from block ${start.toString()} to ${end.toString()}`,\n            });\n            const getLogsConfig: any = {\n                address: this.config.contractAddress,\n                fromBlock: start,\n                toBlock: end,\n            };\n            if (this.config.events.length > 1) {\n                getLogsConfig.event = this.config.events[0];\n            } else {\n                getLogsConfig.events = this.config.events;\n            }\n            const logs = await this.client?.getLogs(getLogsConfig);\n            Logger.debug({\n                location: \"event_consumer\",\n                functon: \"_backfillEvents\",\n                status: `[Backfill] ${logs?.length} logs from block ${start.toString()} to ${end.toString()}`,\n            });\n            await this.observer?.next(logs as T);\n        }\n    }\n\n    public async start(\n        observer: IObserver<T, ConsumerError, U>\n    ): Promise<void> {\n        try {\n            this.isBackfillingInProcess = true\n            this.observer = observer;\n            const latestBlock: bigint =\n                (await this.client?.getBlockNumber()) ?? BigInt(0);\n            Logger.debug({\n                location: \"event_consumer\",\n                functon: \"start\",\n                data: {\n                    latestBlock: latestBlock.toString(),\n                    startBlock: this.config.startBlock.toString(),\n                    pollBatchSize: this.config.pollBatchSize.toString(),\n                },\n            });\n            if (latestBlock - this.config.startBlock > BigInt(0)) {\n                await this._backfillEvents(\n                    this.config.startBlock,\n                    latestBlock,\n                    this.config.pollBatchSize\n                );\n            }\n            this.isBackfillingInProcess = false\n\n            Logger.debug({\n                location: \"event_consumer\",\n                functon: \"start\",\n                status: `Starting event subscription`,\n            });\n\n            this.unWatchFunction = this.client?.watchEvent({\n                address: this.config.contractAddress,\n                events: this.config.events,\n                fromBlock: latestBlock,\n                onLogs: (logs) => {\n                    const transformedLogs = logs as T;\n                    this.observer?.next(transformedLogs);\n                },\n                onError: (error) => {\n                    this.onDisconnect();\n                    this.onFatalError(\n                        new ConsumerError(error.name, {\n                            name: \"CONSUMER_ERROR\",\n                            code: 1001,\n                            isFatal: true,\n                            origin: \"EventConsumer\",\n                            context: { eventName: this.config.events },\n                        })\n                    );\n                },\n            });\n\n            Logger.debug({\n                location: \"event_consumer\",\n                functon: \"start\",\n                status: `Subscribed to event`,\n            });\n        } catch (error) {\n            this.onDisconnect();\n            this.onFatalError(\n                new ExternalDependencyError(\n                    this.config.rpcUrl,\n                    \"Failed to start the event consumer\",\n                    {\n                        externalCode:\n                            errorCodes.external\n                                .UNKNOWN_EXTERNAL_DEPENDENCY_ERROR,\n                        rawError: error as Error,\n                        origin: \"EventConsumer\",\n                        context: { eventName: this.config.events },\n                    }\n                )\n            );\n        }\n    }\n\n    /**\n     * Private method which updates the connection status of consumer to disconnected, and removes all listeners.\n     *\n     * @returns {void}\n     */\n    public onDisconnect(): void {\n        this.removeAllListeners();\n        if (this.unWatchFunction) {\n            this.unWatchFunction();\n        }\n        this.observer?.closed();\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/consumers/index.d.ts

@@ -0,0 +1,8 @@
+export { EventConsumer } from './event_consumer.js';
+import 'viem';
+import '../errors/consumer_errors.js';
+import '../errors/base_error.js';
+import '../types/observer.js';
+import '../types/event_consumer_config.js';
+import './abstract_event_consumer.js';
+import 'events';

package/dist/consumers/index.js

@@ -0,0 +1,2 @@
+export * from "./event_consumer";
+//# sourceMappingURL=index.js.map

package/dist/consumers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/consumers/index.ts"],"sourcesContent":["export * from \"./event_consumer\";\n"],"mappings":"AAAA,cAAc;","names":[]}

package/dist/errors/database_errors.js

@@ -2,7 +2,7 @@ import { BaseError } from "./base_error";
 import { errorCodes } from "../constants";
 class DatabaseError extends BaseError {
   constructor(message, originalError, {
-    name = "CONSUMER_ERROR",
+    name = "DATABASE_ERROR",
     code = errorCodes.consumer.UNKNOWN_CONSUMER_ERR,
     isFatal = true,
     origin = "databse_errors",

package/dist/errors/database_errors.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/errors/database_errors.ts"],"sourcesContent":["import { BaseError } from \"./base_error\";\nimport { errorCodes } from \"../constants\";\n\nexport class DatabaseError extends BaseError {\n    constructor(\n        message: string,\n        originalError?: Error,\n        {\n            name = \"CONSUMER_ERROR\",\n            code = errorCodes.consumer.UNKNOWN_CONSUMER_ERR,\n            isFatal = true,\n            origin = \"databse_errors\",\n            context = {},\n        }: {\n            name?: string;\n            code?: number;\n            isFatal?: boolean;\n            origin?: string;\n            context?: Record<string, any>;\n        } = {}\n    ) {\n        super(name, code, message, isFatal, origin, context);\n        Error.captureStackTrace(this, this.constructor);\n    }\n}\n"],"mappings":"AAAA,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAEpB,MAAM,sBAAsB,UAAU;AAAA,EACzC,YACI,SACA,eACA;AAAA,IACI,OAAO;AAAA,IACP,OAAO,WAAW,SAAS;AAAA,IAC3B,UAAU;AAAA,IACV,SAAS;AAAA,IACT,UAAU,CAAC;AAAA,EACf,IAMI,CAAC,GACP;AACE,UAAM,MAAM,MAAM,SAAS,SAAS,QAAQ,OAAO;AACnD,UAAM,kBAAkB,MAAM,KAAK,WAAW;AAAA,EAClD;AACJ;","names":[]}
+{"version":3,"sources":["../../src/errors/database_errors.ts"],"sourcesContent":["import { BaseError } from \"./base_error\";\nimport { errorCodes } from \"../constants\";\n\nexport class DatabaseError extends BaseError {\n    constructor(\n        message: string,\n        originalError?: Error,\n        {\n            name = \"DATABASE_ERROR\",\n            code = errorCodes.consumer.UNKNOWN_CONSUMER_ERR,\n            isFatal = true,\n            origin = \"databse_errors\",\n            context = {},\n        }: {\n            name?: string;\n            code?: number;\n            isFatal?: boolean;\n            origin?: string;\n            context?: Record<string, any>;\n        } = {}\n    ) {\n        super(name, code, message, isFatal, origin, context);\n        Error.captureStackTrace(this, this.constructor);\n    }\n}\n"],"mappings":"AAAA,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAEpB,MAAM,sBAAsB,UAAU;AAAA,EACzC,YACI,SACA,eACA;AAAA,IACI,OAAO;AAAA,IACP,OAAO,WAAW,SAAS;AAAA,IAC3B,UAAU;AAAA,IACV,SAAS;AAAA,IACT,UAAU,CAAC;AAAA,EACf,IAMI,CAAC,GACP;AACE,UAAM,MAAM,MAAM,SAAS,SAAS,QAAQ,OAAO;AACnD,UAAM,kBAAkB,MAAM,KAAK,WAAW;AAAA,EAClD;AACJ;","names":[]}

package/dist/index.d.ts

@@ -5,11 +5,21 @@ export { errorCodes } from './constants/error_codes.js';
 export { httpResposneCodes } from './constants/http_success_codes.js';
 export { ILoggerConfig } from './types/logger_config.js';
 export { IDocumentConditionalModifications, IQueryFilterOperationParams, IQueryOrderOperationParams, OrderByDirection, WhereFilterOp } from './types/database.js';
+export { IObserver } from './types/observer.js';
+export { ChainNativeCurrency, IEventConsumerConfig } from './types/event_consumer_config.js';
+export { ResponseContext } from './types/response_context.js';
+export { JobOpts } from './types/queue_job_opts.js';
 export { ApiError, BadRequestError, ForbiddenError, NotFoundError, RateLimitError, TimeoutError, UnauthorizedError } from './errors/api_errors.js';
 export { DatabaseError } from './errors/database_errors.js';
 export { ExternalDependencyError } from './errors/external_dependency_error.js';
 export { BaseError } from './errors/base_error.js';
 export { ConsumerError } from './errors/consumer_errors.js';
-export { Database } from './database/db_interface.js';
+export { Database } from './storage/db_interface.js';
+export { IQueue } from './storage/queue_interface.js';
+export { EventConsumer } from './consumers/event_consumer.js';
+export { parseEventLog } from './utils/decoder.js';
 import 'zod';
 import 'winston';
+import 'viem';
+import './consumers/abstract_event_consumer.js';
+import 'events';

package/dist/index.js

@@ -3,5 +3,7 @@ export * from "./logger";
 export * from "./constants";
 export * from "./types";
 export * from "./errors";
-export * from "./database";
+export * from "./storage";
+export * from "./consumers";
+export * from "./utils";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./api\";\nexport * from \"./logger\";\nexport * from \"./constants\";\nexport * from \"./types\";\nexport * from \"./errors\";\nexport * from \"./database\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./api\";\nexport * from \"./logger\";\nexport * from \"./constants\";\nexport * from \"./types\";\nexport * from \"./errors\";\nexport * from \"./storage\";\nexport * from \"./consumers\";\nexport * from \"./utils\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/logger/logger.d.ts

@@ -2,12 +2,14 @@ import { ILoggerConfig } from '../types/logger_config.js';
 import 'winston';
 
 declare class Logger {
+    private static logger;
     /**
      * @static
      * Create method must first be called before using the logger. It creates a singleton, which will then
      * be referred to throughout the application.
      */
     static create(config: ILoggerConfig): void;
+    static ensureInitialized(): void;
     /**
      * @static
      * Method to log for level - "info", this should not be called if it has been custom levels are

package/dist/logger/logger.js

@@ -1,35 +1,21 @@
 import winston from "winston";
 import * as SentryImport from "winston-transport-sentry-node";
+import { BaseError } from "../errors";
+import { errorCodes } from "../constants";
 const Sentry = SentryImport.default;
-let logger;
 class Logger {
+  static logger;
   /**
    * @static
    * Create method must first be called before using the logger. It creates a singleton, which will then
    * be referred to throughout the application.
    */
   static create(config) {
-    if (!logger) {
-      logger = winston.createLogger(
+    if (!this.logger) {
+      this.logger = winston.createLogger(
         Object.assign(
           {
-            format: winston.format.combine(
-              winston.format.timestamp({
-                format: "YYYY-MM-DD HH:mm:ss:ms"
-              }),
-              winston.format.colorize({
-                all: true,
-                colors: {
-                  error: "red",
-                  warn: "yellow",
-                  info: "green",
-                  debug: "white"
-                }
-              }),
-              winston.format.printf(
-                (info) => `${info.timestamp} ${info.level}: ${info.message}`
-              )
-            ),
+            format: winston.format.json(),
             transports: [
               new winston.transports.Console({
                 level: config.console?.level || "info"
@@ -47,6 +33,18 @@ class Logger {
       );
     }
   }
+  static ensureInitialized() {
+    if (!this.logger) {
+      throw new BaseError(
+        "LOGGER_ERROR",
+        errorCodes.base.BASE_ERROR,
+        "Logger not initialized. Please call Logger.create() first.",
+        true,
+        "Logger",
+        void 0
+      );
+    }
+  }
   /**
    * @static
    * Method to log for level - "info", this should not be called if it has been custom levels are
@@ -55,10 +53,11 @@ class Logger {
    * @param {string|object} message - String or object to log.
    */
   static info(message) {
+    this.ensureInitialized();
     if (typeof message === "string") {
-      logger?.info(message);
+      this.logger.info(message);
     } else {
-      logger?.info(JSON.stringify(message));
+      this.logger.info(JSON.stringify(message));
     }
   }
   /**
@@ -69,10 +68,11 @@ class Logger {
    * @param {string|object} message - String or object to log.
    */
   static debug(message) {
+    this.ensureInitialized();
     if (typeof message === "string") {
-      logger?.debug(message);
+      this.logger?.debug(message);
     } else {
-      logger?.debug(JSON.stringify(message));
+      this.logger?.debug(JSON.stringify(message));
     }
   }
   /**
@@ -83,10 +83,11 @@ class Logger {
    * @param {string|object} error - String or object to log.
    */
   static error(error) {
+    this.ensureInitialized();
     if (typeof error === "string") {
-      logger?.error(error);
+      this.logger?.error(error);
     } else {
-      logger?.error(
+      this.logger?.error(
         `${error.message ? `${error.message} : ` : ""}${JSON.stringify(error)}`
       );
     }
@@ -99,10 +100,11 @@ class Logger {
    * @param {string|object} message - String or object to log.
    */
   static warn(message) {
+    this.ensureInitialized();
     if (typeof message === "string") {
-      logger?.warn(message);
+      this.logger?.warn(message);
     } else {
-      logger?.warn(JSON.stringify(message));
+      this.logger?.warn(JSON.stringify(message));
     }
   }
   /**
@@ -112,10 +114,11 @@ class Logger {
    * @param {string|object} message - String or object to log.
    */
   static log(level, message) {
+    this.ensureInitialized();
     if (typeof message === "string") {
-      logger?.log(level, message);
+      this.logger?.log(level, message);
     } else {
-      logger?.log(level, JSON.stringify(message));
+      this.logger?.log(level, JSON.stringify(message));
     }
   }
 }

package/dist/logger/logger.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/logger/logger.ts"],"sourcesContent":["import winston from \"winston\";\nimport type { ILoggerConfig } from \"../types\";\nimport * as SentryImport from \"winston-transport-sentry-node\";\nconst Sentry = SentryImport.default;\n\nlet logger: winston.Logger;\n\nexport class Logger {\n    /**\n     * @static\n     * Create method must first be called before using the logger. It creates a singleton, which will then\n     * be referred to throughout the application.\n     */\n    static create(config: ILoggerConfig) {\n        if (!logger) {\n            logger = winston.createLogger(\n                Object.assign(\n                    {\n                        format: winston.format.combine(\n                            winston.format.timestamp({\n                                format: \"YYYY-MM-DD HH:mm:ss:ms\",\n                            }),\n                            winston.format.colorize({\n                                all: true,\n                                colors: {\n                                    error: \"red\",\n                                    warn: \"yellow\",\n                                    info: \"green\",\n                                    debug: \"white\",\n                                },\n                            }),\n                            winston.format.printf(\n                                (info) =>\n                                    `${info.timestamp} ${info.level}: ${info.message}`\n                            )\n                        ),\n                        transports: [\n                            new winston.transports.Console({\n                                level: config.console?.level || \"info\",\n                            }),\n                            new Sentry({\n                                sentry: {\n                                    dsn: config.sentry?.dsn,\n                                },\n                                level: config.sentry?.level || \"error\",\n                            }),\n                        ],\n                    },\n                    config.winston\n                )\n            );\n        }\n    }\n\n    /**\n     * @static\n     * Method to log for level - \"info\", this should not be called if it has been custom levels are\n     * set which does not include \"info\"\n     *\n     * @param {string|object} message - String or object to log.\n     */\n    static info(message: string | object) {\n        if (typeof message === \"string\") {\n            logger?.info(message);\n        } else {\n            logger?.info(JSON.stringify(message));\n        }\n    }\n\n    /**\n     * @static\n     * Method to log for level - \"debug\", this should not be called if it has been custom levels are\n     * set which does not include \"debug\"\n     *\n     * @param {string|object} message - String or object to log.\n     */\n    static debug(message: string | object) {\n        if (typeof message === \"string\") {\n            logger?.debug(message);\n        } else {\n            logger?.debug(JSON.stringify(message));\n        }\n    }\n\n    /**\n     * @static\n     * Method to log for level - \"error\", this should not be called if it has been custom levels are\n     * set which does not include \"error\"\n     *\n     * @param {string|object} error - String or object to log.\n     */\n    static error(error: string | object) {\n        if (typeof error === \"string\") {\n            logger?.error(error);\n        } else {\n            logger?.error(\n                `${\n                    (error as Error).message\n                        ? `${(error as Error).message} : `\n                        : \"\"\n                }${JSON.stringify(error)}`\n            );\n        }\n    }\n\n    /**\n     * @static\n     * Method to log for level - \"warn\", this should not be called if it has been custom levels are\n     * set which does not include \"warn\"\n     *\n     * @param {string|object} message - String or object to log.\n     */\n    static warn(message: string | object) {\n        if (typeof message === \"string\") {\n            logger?.warn(message);\n        } else {\n            logger?.warn(JSON.stringify(message));\n        }\n    }\n\n    /**\n     * @static\n     * Method to log for any level, which should be used to log all custom levels that may be added.\n     *\n     * @param {string|object} message - String or object to log.\n     */\n    static log(level: string, message: string | object) {\n        if (typeof message === \"string\") {\n            logger?.log(level, message);\n        } else {\n            logger?.log(level, JSON.stringify(message));\n        }\n    }\n}\n"],"mappings":"AAAA,OAAO,aAAa;AAEpB,YAAY,kBAAkB;AAC9B,MAAM,SAAS,aAAa;AAE5B,IAAI;AAEG,MAAM,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMhB,OAAO,OAAO,QAAuB;AACjC,QAAI,CAAC,QAAQ;AACT,eAAS,QAAQ;AAAA,QACb,OAAO;AAAA,UACH;AAAA,YACI,QAAQ,QAAQ,OAAO;AAAA,cACnB,QAAQ,OAAO,UAAU;AAAA,gBACrB,QAAQ;AAAA,cACZ,CAAC;AAAA,cACD,QAAQ,OAAO,SAAS;AAAA,gBACpB,KAAK;AAAA,gBACL,QAAQ;AAAA,kBACJ,OAAO;AAAA,kBACP,MAAM;AAAA,kBACN,MAAM;AAAA,kBACN,OAAO;AAAA,gBACX;AAAA,cACJ,CAAC;AAAA,cACD,QAAQ,OAAO;AAAA,gBACX,CAAC,SACG,GAAG,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,KAAK,OAAO;AAAA,cACxD;AAAA,YACJ;AAAA,YACA,YAAY;AAAA,cACR,IAAI,QAAQ,WAAW,QAAQ;AAAA,gBAC3B,OAAO,OAAO,SAAS,SAAS;AAAA,cACpC,CAAC;AAAA,cACD,IAAI,OAAO;AAAA,gBACP,QAAQ;AAAA,kBACJ,KAAK,OAAO,QAAQ;AAAA,gBACxB;AAAA,gBACA,OAAO,OAAO,QAAQ,SAAS;AAAA,cACnC,CAAC;AAAA,YACL;AAAA,UACJ;AAAA,UACA,OAAO;AAAA,QACX;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,KAAK,SAA0B;AAClC,QAAI,OAAO,YAAY,UAAU;AAC7B,cAAQ,KAAK,OAAO;AAAA,IACxB,OAAO;AACH,cAAQ,KAAK,KAAK,UAAU,OAAO,CAAC;AAAA,IACxC;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,MAAM,SAA0B;AACnC,QAAI,OAAO,YAAY,UAAU;AAC7B,cAAQ,MAAM,OAAO;AAAA,IACzB,OAAO;AACH,cAAQ,MAAM,KAAK,UAAU,OAAO,CAAC;AAAA,IACzC;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,MAAM,OAAwB;AACjC,QAAI,OAAO,UAAU,UAAU;AAC3B,cAAQ,MAAM,KAAK;AAAA,IACvB,OAAO;AACH,cAAQ;AAAA,QACJ,GACK,MAAgB,UACX,GAAI,MAAgB,OAAO,QAC3B,EACV,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA,MAC5B;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,KAAK,SAA0B;AAClC,QAAI,OAAO,YAAY,UAAU;AAC7B,cAAQ,KAAK,OAAO;AAAA,IACxB,OAAO;AACH,cAAQ,KAAK,KAAK,UAAU,OAAO,CAAC;AAAA,IACxC;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,IAAI,OAAe,SAA0B;AAChD,QAAI,OAAO,YAAY,UAAU;AAC7B,cAAQ,IAAI,OAAO,OAAO;AAAA,IAC9B,OAAO;AACH,cAAQ,IAAI,OAAO,KAAK,UAAU,OAAO,CAAC;AAAA,IAC9C;AAAA,EACJ;AACJ;","names":[]}
+{"version":3,"sources":["../../src/logger/logger.ts"],"sourcesContent":["import winston from \"winston\";\nimport type { ILoggerConfig } from \"../types\";\nimport * as SentryImport from \"winston-transport-sentry-node\";\nimport { BaseError } from \"../errors\";\nimport { errorCodes } from \"../constants\";\nconst Sentry = SentryImport.default;\n\nexport class Logger {\n    private static logger: winston.Logger;\n\n    /**\n     * @static\n     * Create method must first be called before using the logger. It creates a singleton, which will then\n     * be referred to throughout the application.\n     */\n    static create(config: ILoggerConfig) {\n        if (!this.logger) {\n            this.logger = winston.createLogger(\n                Object.assign(\n                    {\n                        format: winston.format.json(),\n                        transports: [\n                            new winston.transports.Console({\n                                level: config.console?.level || \"info\",\n                            }),\n                            new Sentry({\n                                sentry: {\n                                    dsn: config.sentry?.dsn,\n                                },\n                                level: config.sentry?.level || \"error\",\n                            }),\n                        ],\n                    },\n                    config.winston\n                )\n            );\n        }\n    }\n\n    static ensureInitialized(): void {\n        if (!this.logger) {\n            throw new BaseError(\n                \"LOGGER_ERROR\",\n                errorCodes.base.BASE_ERROR,\n                \"Logger not initialized. Please call Logger.create() first.\",\n                true,\n                \"Logger\",\n                undefined\n            );\n        }\n    }\n\n    /**\n     * @static\n     * Method to log for level - \"info\", this should not be called if it has been custom levels are\n     * set which does not include \"info\"\n     *\n     * @param {string|object} message - String or object to log.\n     */\n    static info(message: string | object) {\n        this.ensureInitialized();\n        if (typeof message === \"string\") {\n            this.logger.info(message);\n        } else {\n            this.logger.info(JSON.stringify(message));\n        }\n    }\n\n    /**\n     * @static\n     * Method to log for level - \"debug\", this should not be called if it has been custom levels are\n     * set which does not include \"debug\"\n     *\n     * @param {string|object} message - String or object to log.\n     */\n    static debug(message: string | object) {\n        this.ensureInitialized();\n        if (typeof message === \"string\") {\n            this.logger?.debug(message);\n        } else {\n            this.logger?.debug(JSON.stringify(message));\n        }\n    }\n\n    /**\n     * @static\n     * Method to log for level - \"error\", this should not be called if it has been custom levels are\n     * set which does not include \"error\"\n     *\n     * @param {string|object} error - String or object to log.\n     */\n    static error(error: string | object) {\n        this.ensureInitialized();\n        if (typeof error === \"string\") {\n            this.logger?.error(error);\n        } else {\n            this.logger?.error(\n                `${(error as Error).message\n                    ? `${(error as Error).message} : `\n                    : \"\"\n                }${JSON.stringify(error)}`\n            );\n        }\n    }\n\n    /**\n     * @static\n     * Method to log for level - \"warn\", this should not be called if it has been custom levels are\n     * set which does not include \"warn\"\n     *\n     * @param {string|object} message - String or object to log.\n     */\n    static warn(message: string | object) {\n        this.ensureInitialized();\n        if (typeof message === \"string\") {\n            this.logger?.warn(message);\n        } else {\n            this.logger?.warn(JSON.stringify(message));\n        }\n    }\n\n    /**\n     * @static\n     * Method to log for any level, which should be used to log all custom levels that may be added.\n     *\n     * @param {string|object} message - String or object to log.\n     */\n    static log(level: string, message: string | object) {\n        this.ensureInitialized();\n        if (typeof message === \"string\") {\n            this.logger?.log(level, message);\n        } else {\n            this.logger?.log(level, JSON.stringify(message));\n        }\n    }\n}\n"],"mappings":"AAAA,OAAO,aAAa;AAEpB,YAAY,kBAAkB;AAC9B,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAC3B,MAAM,SAAS,aAAa;AAErB,MAAM,OAAO;AAAA,EAChB,OAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOf,OAAO,OAAO,QAAuB;AACjC,QAAI,CAAC,KAAK,QAAQ;AACd,WAAK,SAAS,QAAQ;AAAA,QAClB,OAAO;AAAA,UACH;AAAA,YACI,QAAQ,QAAQ,OAAO,KAAK;AAAA,YAC5B,YAAY;AAAA,cACR,IAAI,QAAQ,WAAW,QAAQ;AAAA,gBAC3B,OAAO,OAAO,SAAS,SAAS;AAAA,cACpC,CAAC;AAAA,cACD,IAAI,OAAO;AAAA,gBACP,QAAQ;AAAA,kBACJ,KAAK,OAAO,QAAQ;AAAA,gBACxB;AAAA,gBACA,OAAO,OAAO,QAAQ,SAAS;AAAA,cACnC,CAAC;AAAA,YACL;AAAA,UACJ;AAAA,UACA,OAAO;AAAA,QACX;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,OAAO,oBAA0B;AAC7B,QAAI,CAAC,KAAK,QAAQ;AACd,YAAM,IAAI;AAAA,QACN;AAAA,QACA,WAAW,KAAK;AAAA,QAChB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,KAAK,SAA0B;AAClC,SAAK,kBAAkB;AACvB,QAAI,OAAO,YAAY,UAAU;AAC7B,WAAK,OAAO,KAAK,OAAO;AAAA,IAC5B,OAAO;AACH,WAAK,OAAO,KAAK,KAAK,UAAU,OAAO,CAAC;AAAA,IAC5C;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,MAAM,SAA0B;AACnC,SAAK,kBAAkB;AACvB,QAAI,OAAO,YAAY,UAAU;AAC7B,WAAK,QAAQ,MAAM,OAAO;AAAA,IAC9B,OAAO;AACH,WAAK,QAAQ,MAAM,KAAK,UAAU,OAAO,CAAC;AAAA,IAC9C;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,MAAM,OAAwB;AACjC,SAAK,kBAAkB;AACvB,QAAI,OAAO,UAAU,UAAU;AAC3B,WAAK,QAAQ,MAAM,KAAK;AAAA,IAC5B,OAAO;AACH,WAAK,QAAQ;AAAA,QACT,GAAI,MAAgB,UACd,GAAI,MAAgB,OAAO,QAC3B,EACN,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA,MAC5B;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,KAAK,SAA0B;AAClC,SAAK,kBAAkB;AACvB,QAAI,OAAO,YAAY,UAAU;AAC7B,WAAK,QAAQ,KAAK,OAAO;AAAA,IAC7B,OAAO;AACH,WAAK,QAAQ,KAAK,KAAK,UAAU,OAAO,CAAC;AAAA,IAC7C;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,IAAI,OAAe,SAA0B;AAChD,SAAK,kBAAkB;AACvB,QAAI,OAAO,YAAY,UAAU;AAC7B,WAAK,QAAQ,IAAI,OAAO,OAAO;AAAA,IACnC,OAAO;AACH,WAAK,QAAQ,IAAI,OAAO,KAAK,UAAU,OAAO,CAAC;AAAA,IACnD;AAAA,EACJ;AACJ;","names":[]}

package/dist/{database → storage}/db_interface.d.ts

@@ -8,6 +8,7 @@ interface Database {
     conditionalUpdateDocuments(collectionPaths: string[], docDatas: any[], docIds: string[], conditions: IQueryFilterOperationParams[], conditionModifications: IDocumentConditionalModifications[]): Promise<void>;
     getDocuments(collectionPath: string, filter?: IQueryFilterOperationParams[] | undefined, limit?: number | undefined, order?: IQueryOrderOperationParams[] | undefined, startAfterCursor?: string | number | undefined): Promise<any[]>;
     getDocument(collectionId: string, docId: string): Promise<any | null>;
+    getCollectionGroup(groupId: string, filter?: IQueryFilterOperationParams[]): Promise<any | null>;
 }
 
 export type { Database };

package/dist/storage/index.d.ts

@@ -0,0 +1,4 @@
+export { Database } from './db_interface.js';
+export { IQueue } from './queue_interface.js';
+import '../types/database.js';
+import '../types/queue_job_opts.js';

package/dist/storage/index.js

@@ -0,0 +1,3 @@
+export * from "./db_interface";
+export * from "./queue_interface";
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/index.ts"],"sourcesContent":["export * from \"./db_interface\";\nexport * from \"./queue_interface\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;","names":[]}

package/dist/storage/queue_interface.d.ts

@@ -0,0 +1,11 @@
+import { JobOpts } from '../types/queue_job_opts.js';
+
+interface IQueue<JobData = any, JobResult = any> {
+    addJob(name: string, data: JobData, jobOpts?: JobOpts): Promise<void>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    clean(type: "completed" | "failed" | "wait" | "delayed"): Promise<void>;
+    getJobCounts(): Promise<Record<string, number>>;
+}
+
+export type { IQueue };

package/dist/storage/queue_interface.js

@@ -0,0 +1 @@
+//# sourceMappingURL=queue_interface.js.map

package/dist/storage/queue_interface.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/event_consumer_config.d.ts

@@ -0,0 +1,19 @@
+import { Address, AbiEvent } from 'viem';
+
+type ChainNativeCurrency = {
+    name: string;
+    symbol: string;
+    decimals: number;
+};
+interface IEventConsumerConfig {
+    contractAddress: Address | Address[];
+    events: AbiEvent[];
+    chainId: number;
+    rpcUrl: string;
+    nativeCurrency: ChainNativeCurrency;
+    startBlock: bigint;
+    pollBatchSize: bigint;
+    pollInterval: number;
+}
+
+export type { ChainNativeCurrency, IEventConsumerConfig };

package/dist/types/event_consumer_config.js

@@ -0,0 +1 @@
+//# sourceMappingURL=event_consumer_config.js.map

package/dist/types/event_consumer_config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/index.d.ts

@@ -1,3 +1,8 @@
 export { ILoggerConfig } from './logger_config.js';
 export { IDocumentConditionalModifications, IQueryFilterOperationParams, IQueryOrderOperationParams, OrderByDirection, WhereFilterOp } from './database.js';
+export { IObserver } from './observer.js';
+export { ChainNativeCurrency, IEventConsumerConfig } from './event_consumer_config.js';
+export { ResponseContext } from './response_context.js';
+export { JobOpts } from './queue_job_opts.js';
 import 'winston';
+import 'viem';

package/dist/types/index.js

@@ -1,3 +1,7 @@
 export * from "./logger_config";
 export * from "./database";
+export * from "./observer";
+export * from "./event_consumer_config";
+export * from "./response_context";
+export * from "./queue_job_opts";
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["export * from \"./logger_config\";\nexport * from \"./database\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["export * from \"./logger_config\";\nexport * from \"./database\";\nexport * from \"./observer\";\nexport * from \"./event_consumer_config\";\nexport * from \"./response_context\";\nexport * from \"./queue_job_opts\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/types/observer.d.ts

@@ -0,0 +1,8 @@
+interface IObserver<T, E, U> {
+    next: (value: T) => Promise<void> | void;
+    summary: (value: U) => Promise<void> | void;
+    error: (value: E) => void;
+    closed: () => void;
+}
+
+export type { IObserver };

package/dist/types/observer.js

@@ -0,0 +1 @@
+//# sourceMappingURL=observer.js.map

package/dist/types/observer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/queue_job_opts.d.ts

@@ -0,0 +1,5 @@
+type JobOpts = {
+    replace?: boolean;
+};
+
+export type { JobOpts };

package/dist/types/queue_job_opts.js

@@ -0,0 +1 @@
+//# sourceMappingURL=queue_job_opts.js.map

package/dist/types/queue_job_opts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/response_context.d.ts

@@ -0,0 +1,6 @@
+type ResponseContext = {
+    status: (statusCode: number) => ResponseContext;
+    json: (body: any) => any;
+};
+
+export type { ResponseContext };

package/dist/types/response_context.js

@@ -0,0 +1 @@
+//# sourceMappingURL=response_context.js.map

package/dist/types/response_context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/utils/decoder.d.ts

@@ -0,0 +1,6 @@
+declare const parseEventLog: (eventSignature: string[], data: `0x${string}`, topics: any) => {
+    eventName: undefined;
+    args: readonly unknown[] | undefined;
+};
+
+export { parseEventLog };

package/dist/utils/decoder.js

@@ -0,0 +1,8 @@
+import { decodeEventLog, parseAbi } from "viem";
+const parseEventLog = (eventSignature, data, topics) => {
+  return decodeEventLog({ abi: parseAbi(eventSignature), data, topics });
+};
+export {
+  parseEventLog
+};
+//# sourceMappingURL=decoder.js.map

package/dist/utils/decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/decoder.ts"],"sourcesContent":["import { decodeEventLog, parseAbi } from \"viem\";\n\nexport const parseEventLog = (\n    eventSignature: string[],\n    data: `0x${string}`,\n    topics: any\n) => {\n    return decodeEventLog({ abi: parseAbi(eventSignature), data, topics });\n};\n"],"mappings":"AAAA,SAAS,gBAAgB,gBAAgB;AAElC,MAAM,gBAAgB,CACzB,gBACA,MACA,WACC;AACD,SAAO,eAAe,EAAE,KAAK,SAAS,cAAc,GAAG,MAAM,OAAO,CAAC;AACzE;","names":[]}

package/dist/utils/index.d.ts

@@ -0,0 +1 @@
+export { parseEventLog } from './decoder.js';

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export * from "./decoder";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/index.ts"],"sourcesContent":["export * from \"./decoder\";\n"],"mappings":"AAAA,cAAc;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@polygonlabs/servercore",
-    "version": "0.0.0",
+    "version": "1.0.0-beta.1",
     "publishConfig": {
         "access": "public"
     },
@@ -37,6 +37,7 @@
         "typescript": "^5"
     },
     "dependencies": {
+        "viem": "^2.26.3",
         "winston": "^3.17.0",
         "winston-transport-sentry-node": "^3.0.0",
         "zod": "^3.24.2"

package/dist/database/index.d.ts

@@ -1,2 +0,0 @@
-export { Database } from './db_interface.js';
-import '../types/database.js';

package/dist/database/index.js

@@ -1,2 +0,0 @@
-export * from "./db_interface";
-//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/database/index.ts"],"sourcesContent":["export * from \"./db_interface\";\n"],"mappings":"AAAA,cAAc;","names":[]}