@polygonlabs/servercore 1.0.0-dev.4 → 1.0.0-dev.41

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 PT Services DMCC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/api/health-check.d.ts

@@ -0,0 +1,8 @@
+declare class HealthCheck {
+    private readonly urls;
+    constructor(urls: string[]);
+    checkHealth(): Promise<string>;
+}
+declare function setupHealthCheckServer(urls: string[], serverPort: number): void;
+
+export { HealthCheck, setupHealthCheckServer };

package/dist/api/health-check.js

@@ -0,0 +1,85 @@
+import { handleResponse, handleError } from "./response_handler";
+import { ApiError } from "../errors";
+class HealthCheck {
+  constructor(urls) {
+    this.urls = urls;
+  }
+  async checkHealth() {
+    try {
+      const results = await Promise.all(
+        this.urls.map(async (url) => {
+          const response = await fetch(`${url}`);
+          if (!response.ok) {
+            throw new Error(`Health check failed for ${url}`);
+          }
+          return response;
+        })
+      );
+      if (results.every((res) => res.ok)) {
+        return "ok";
+      }
+      throw new Error("One or more URLs failed the health check.");
+    } catch (error) {
+      const failedUrlChecks = await Promise.all(
+        this.urls.map(async (url) => {
+          try {
+            const response = await fetch(`${url}`);
+            return { url, failed: !response.ok };
+          } catch {
+            return { url, failed: true };
+          }
+        })
+      );
+      const failedUrls = failedUrlChecks.filter((check) => check.failed).map((check) => check.url);
+      throw new ApiError(
+        `Health check failed for the following URLs: ${failedUrls.join(
+          ", "
+        )}. Original error: ${error.message}`
+      );
+    }
+  }
+}
+function createResponseContext(c) {
+  c.status = c.status || 200;
+  return {
+    status: (statusCode) => {
+      c.status = statusCode;
+      return createResponseContext(c);
+    },
+    json: (body) => {
+      return new Response(JSON.stringify(body), {
+        status: c.status,
+        headers: { "Content-Type": "application/json" }
+      });
+    }
+  };
+}
+function setupHealthCheckServer(urls, serverPort) {
+  const healthCheck = new HealthCheck(urls);
+  Bun.serve({
+    port: serverPort,
+    routes: {
+      "/health-check": {
+        GET: async (c) => {
+          try {
+            await healthCheck.checkHealth();
+            return handleResponse(createResponseContext(c), "ok");
+          } catch (error) {
+            return handleError(
+              createResponseContext(c),
+              error
+            );
+          }
+        }
+      }
+    }
+  });
+  console.log(
+    `Health check server running on http://localhost:${serverPort}/health-check`
+  );
+}
+export {
+  HealthCheck,
+  setupHealthCheckServer
+};
+//# sourceMappingURL=health-check.js.map

package/dist/api/health-check.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/health-check.ts"],"sourcesContent":["import { handleResponse, handleError } from \"./response_handler\";\nimport type { ResponseContext } from \"../types\";\nimport { ApiError } from \"../errors\";\n\nexport class HealthCheck {\n    constructor(private readonly urls: string[]) {}\n\n    async checkHealth(): Promise<string> {\n        try {\n            const results = await Promise.all(\n                this.urls.map(async (url) => {\n                    const response = await fetch(`${url}`);\n                    if (!response.ok) {\n                        throw new Error(`Health check failed for ${url}`);\n                    }\n                    return response;\n                })\n            );\n\n            if (results.every((res) => res.ok)) {\n                return \"ok\";\n            }\n            throw new Error(\"One or more URLs failed the health check.\");\n        } catch (error) {\n            const failedUrlChecks = await Promise.all(\n                this.urls.map(async (url) => {\n                    try {\n                        const response = await fetch(`${url}`);\n                        return { url, failed: !response.ok };\n                    } catch {\n                        return { url, failed: true };\n                    }\n                })\n            );\n            const failedUrls = failedUrlChecks\n                .filter(check => check.failed)\n                .map(check => check.url);\n            \n            throw new ApiError(\n                `Health check failed for the following URLs: ${failedUrls.join(\n                    \", \"\n                )}. Original error: ${(error as Error).message}`\n            );\n        }\n    }\n}\n\n// Utility to convert Bun context to ResponseContext\nfunction createResponseContext(c: any): ResponseContext {\n    c.status = c.status || 200; // Default status to 200 if undefined\n    return {\n        status: (statusCode: number) => {\n            c.status = statusCode;\n            return createResponseContext(c); // Return the updated context\n        },\n        json: (body: any) => {\n            return new Response(JSON.stringify(body), {\n                status: c.status,\n                headers: { \"Content-Type\": \"application/json\" },\n            });\n        },\n    };\n}\n\n// Setup Bun server with health check route\nexport function setupHealthCheckServer(\n    urls: string[],\n    serverPort: number\n): void {\n    const healthCheck = new HealthCheck(urls);\n\n    Bun.serve({\n        port: serverPort,\n        routes: {\n            \"/health-check\": {\n                GET: async (c: any) => {\n                    try {\n                        await healthCheck.checkHealth();\n                        return handleResponse(createResponseContext(c), \"ok\");\n                    } catch (error) {\n                        return handleError(\n                            createResponseContext(c),\n                            error as ApiError\n                        );\n                    }\n                },\n            },\n        },\n    });\n\n    console.log(\n        `Health check server running on http://localhost:${serverPort}/health-check`\n    );\n}\n"],"mappings":"AAAA,SAAS,gBAAgB,mBAAmB;AAE5C,SAAS,gBAAgB;AAElB,MAAM,YAAY;AAAA,EACrB,YAA6B,MAAgB;AAAhB;AAAA,EAAiB;AAAA,EAE9C,MAAM,cAA+B;AACjC,QAAI;AACA,YAAM,UAAU,MAAM,QAAQ;AAAA,QAC1B,KAAK,KAAK,IAAI,OAAO,QAAQ;AACzB,gBAAM,WAAW,MAAM,MAAM,GAAG,GAAG,EAAE;AACrC,cAAI,CAAC,SAAS,IAAI;AACd,kBAAM,IAAI,MAAM,2BAA2B,GAAG,EAAE;AAAA,UACpD;AACA,iBAAO;AAAA,QACX,CAAC;AAAA,MACL;AAEA,UAAI,QAAQ,MAAM,CAAC,QAAQ,IAAI,EAAE,GAAG;AAChC,eAAO;AAAA,MACX;AACA,YAAM,IAAI,MAAM,2CAA2C;AAAA,IAC/D,SAAS,OAAO;AACZ,YAAM,kBAAkB,MAAM,QAAQ;AAAA,QAClC,KAAK,KAAK,IAAI,OAAO,QAAQ;AACzB,cAAI;AACA,kBAAM,WAAW,MAAM,MAAM,GAAG,GAAG,EAAE;AACrC,mBAAO,EAAE,KAAK,QAAQ,CAAC,SAAS,GAAG;AAAA,UACvC,QAAQ;AACJ,mBAAO,EAAE,KAAK,QAAQ,KAAK;AAAA,UAC/B;AAAA,QACJ,CAAC;AAAA,MACL;AACA,YAAM,aAAa,gBACd,OAAO,WAAS,MAAM,MAAM,EAC5B,IAAI,WAAS,MAAM,GAAG;AAE3B,YAAM,IAAI;AAAA,QACN,+CAA+C,WAAW;AAAA,UACtD;AAAA,QACJ,CAAC,qBAAsB,MAAgB,OAAO;AAAA,MAClD;AAAA,IACJ;AAAA,EACJ;AACJ;AAGA,SAAS,sBAAsB,GAAyB;AACpD,IAAE,SAAS,EAAE,UAAU;AACvB,SAAO;AAAA,IACH,QAAQ,CAAC,eAAuB;AAC5B,QAAE,SAAS;AACX,aAAO,sBAAsB,CAAC;AAAA,IAClC;AAAA,IACA,MAAM,CAAC,SAAc;AACjB,aAAO,IAAI,SAAS,KAAK,UAAU,IAAI,GAAG;AAAA,QACtC,QAAQ,EAAE;AAAA,QACV,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAClD,CAAC;AAAA,IACL;AAAA,EACJ;AACJ;AAGO,SAAS,uBACZ,MACA,YACI;AACJ,QAAM,cAAc,IAAI,YAAY,IAAI;AAExC,MAAI,MAAM;AAAA,IACN,MAAM;AAAA,IACN,QAAQ;AAAA,MACJ,iBAAiB;AAAA,QACb,KAAK,OAAO,MAAW;AACnB,cAAI;AACA,kBAAM,YAAY,YAAY;AAC9B,mBAAO,eAAe,sBAAsB,CAAC,GAAG,IAAI;AAAA,UACxD,SAAS,OAAO;AACZ,mBAAO;AAAA,cACH,sBAAsB,CAAC;AAAA,cACvB;AAAA,YACJ;AAAA,UACJ;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ,CAAC;AAED,UAAQ;AAAA,IACJ,mDAAmD,UAAU;AAAA,EACjE;AACJ;","names":[]}

package/dist/api/index.d.ts

@@ -1,7 +1,9 @@
 export { handleError, handleResponse } from './response_handler.js';
 export { validateBody, validateParams, validateQuery } from './zod_utils.js';
+export { HealthCheck, setupHealthCheckServer } from './health-check.js';
 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/index.js

@@ -1,3 +1,4 @@
 export * from "./response_handler";
 export * from "./zod_utils";
+export * from "./health-check";
 //# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/api/index.ts"],"sourcesContent":["export * from \"./response_handler\";\nexport * from \"./zod_utils\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../../src/api/index.ts"],"sourcesContent":["export * from \"./response_handler\";\nexport * from \"./zod_utils\";\nexport * from \"./health-check\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

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_cron_event_consumer.d.ts

@@ -0,0 +1,23 @@
+import { AbstractEventConsumer } from './abstract_event_consumer.js';
+import '../errors/consumer_errors.js';
+import '../errors/base_error.js';
+import 'events';
+
+declare abstract class AbstractCronEventConsumer extends AbstractEventConsumer {
+    private cronJob;
+    /**
+     * Start the cron job with the given cron expression.
+     * @param cronExpr Cron expression string
+     */
+    startCron(cronExpr: string): void;
+    /**
+     * Stop the cron job.
+     */
+    stopCron(): void;
+    /**
+     * Implement this in subclasses to define what happens on each cron tick.
+     */
+    protected abstract onTick(): Promise<void>;
+}
+
+export { AbstractCronEventConsumer };

package/dist/consumers/abstract_cron_event_consumer.js

@@ -0,0 +1,30 @@
+import { Cron } from "croner";
+import { AbstractEventConsumer } from "./abstract_event_consumer";
+class AbstractCronEventConsumer extends AbstractEventConsumer {
+  cronJob = null;
+  /**
+   * Start the cron job with the given cron expression.
+   * @param cronExpr Cron expression string
+   */
+  startCron(cronExpr) {
+    if (this.cronJob) {
+      this.cronJob.stop();
+    }
+    this.cronJob = new Cron(cronExpr, { protect: true }, async () => {
+      await this.onTick();
+    });
+  }
+  /**
+   * Stop the cron job.
+   */
+  stopCron() {
+    if (this.cronJob) {
+      this.cronJob.stop();
+      this.cronJob = null;
+    }
+  }
+}
+export {
+  AbstractCronEventConsumer
+};
+//# sourceMappingURL=abstract_cron_event_consumer.js.map

package/dist/consumers/abstract_cron_event_consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/consumers/abstract_cron_event_consumer.ts"],"sourcesContent":["import { Cron } from \"croner\";\nimport { AbstractEventConsumer } from \"./abstract_event_consumer\";\n\nexport abstract class AbstractCronEventConsumer extends AbstractEventConsumer {\n    private cronJob: Cron | null = null;\n\n    /**\n     * Start the cron job with the given cron expression.\n     * @param cronExpr Cron expression string\n     */\n    public startCron(cronExpr: string): void {\n        if (this.cronJob) {\n            this.cronJob.stop();\n        }\n        this.cronJob = new Cron(cronExpr, { protect: true }, async () => {\n            await this.onTick();\n        });\n    }\n\n    /**\n     * Stop the cron job.\n     */\n    public stopCron(): void {\n        if (this.cronJob) {\n            this.cronJob.stop();\n            this.cronJob = null;\n        }\n    }\n\n    /**\n     * Implement this in subclasses to define what happens on each cron tick.\n     */\n    protected abstract onTick(): Promise<void>;\n}\n"],"mappings":"AAAA,SAAS,YAAY;AACrB,SAAS,6BAA6B;AAE/B,MAAe,kCAAkC,sBAAsB;AAAA,EAClE,UAAuB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMxB,UAAU,UAAwB;AACrC,QAAI,KAAK,SAAS;AACd,WAAK,QAAQ,KAAK;AAAA,IACtB;AACA,SAAK,UAAU,IAAI,KAAK,UAAU,EAAE,SAAS,KAAK,GAAG,YAAY;AAC7D,YAAM,KAAK,OAAO;AAAA,IACtB,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA,EAKO,WAAiB;AACpB,QAAI,KAAK,SAAS;AACd,WAAK,QAAQ,KAAK;AAClB,WAAK,UAAU;AAAA,IACnB;AAAA,EACJ;AAMJ;","names":[]}

package/dist/consumers/abstract_event_consumer.d.ts

@@ -3,6 +3,7 @@ import { EventEmitter } from 'events';
 import '../errors/base_error.js';
 
 declare class AbstractEventConsumer extends EventEmitter {
+    constructor();
     /**
      * @public
      *

package/dist/consumers/abstract_event_consumer.js

@@ -1,5 +1,8 @@
 import { EventEmitter } from "events";
 class AbstractEventConsumer extends EventEmitter {
+  constructor() {
+    super();
+  }
   /**
    * @public
    *

package/dist/consumers/abstract_event_consumer.js.map

@@ -1 +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    /**\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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYpD,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":[]}
+{"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

@@ -1,4 +1,4 @@
-import { PublicClient } from 'viem';
+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';
@@ -7,18 +7,20 @@ import '../errors/base_error.js';
 import 'events';
 
 declare class EventConsumer<T, U> extends AbstractEventConsumer {
-    private config;
-    private consumerRunning;
+    private readonly config;
     protected client: PublicClient | null;
-    protected observer: IObserver<object, ConsumerError, object> | 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}
      */
-    private onDisconnect;
+    onDisconnect(): void;
 }
 
 export { EventConsumer };

package/dist/consumers/event_consumer.js

@@ -1,3 +1,4 @@
+import { Logger } from "../logger";
 import { createPublicClient, http } from "viem";
 import { ConsumerError, ExternalDependencyError } from "../errors";
 import { AbstractEventConsumer } from "./abstract_event_consumer";
@@ -8,27 +9,84 @@ class EventConsumer extends AbstractEventConsumer {
     this.config = config;
     this.client = createPublicClient({
       chain: {
-        id: this.config.chainId,
+        id: config.chainId,
         name: "custom",
-        rpcUrls: { default: { http: [this.config.rpcUrl] } },
-        nativeCurrency: this.config.nativeCurrency
+        rpcUrls: { default: { http: [config.rpcUrl] } },
+        nativeCurrency: config.nativeCurrency
       },
-      transport: http(this.config.rpcUrl)
+      transport: http(config.rpcUrl)
     });
   }
-  consumerRunning = false;
   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.events = this.config.events;
+      } else {
+        getLogsConfig.event = this.config.events[0];
+      }
+      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.client?.watchContractEvent({
+      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,
-        abi: this.config.abi,
-        eventName: this.config.eventName,
-        fromBlock: this.config.startBlock,
+        events: this.config.events,
+        fromBlock: latestBlock,
         onLogs: (logs) => {
           const transformedLogs = logs;
-          observer.next(transformedLogs);
+          this.observer?.next(transformedLogs);
         },
         onError: (error) => {
           this.onDisconnect();
@@ -38,11 +96,16 @@ class EventConsumer extends AbstractEventConsumer {
               code: 1001,
               isFatal: true,
               origin: "EventConsumer",
-              context: { eventName: this.config.eventName }
+              context: { eventName: this.config.events }
             })
           );
         }
       });
+      Logger.debug({
+        location: "event_consumer",
+        functon: "start",
+        status: `Subscribed to event`
+      });
     } catch (error) {
       this.onDisconnect();
       this.onFatalError(
@@ -53,7 +116,7 @@ class EventConsumer extends AbstractEventConsumer {
             externalCode: errorCodes.external.UNKNOWN_EXTERNAL_DEPENDENCY_ERROR,
             rawError: error,
             origin: "EventConsumer",
-            context: { eventName: this.config.eventName }
+            context: { eventName: this.config.events }
           }
         )
       );
@@ -65,11 +128,11 @@ class EventConsumer extends AbstractEventConsumer {
    * @returns {void}
    */
   onDisconnect() {
-    if (this.consumerRunning) {
-      this.consumerRunning = false;
-      this.observer?.closed();
-      this.removeAllListeners();
+    this.removeAllListeners();
+    if (this.unWatchFunction) {
+      this.unWatchFunction();
     }
+    this.observer?.closed();
   }
 }
 export {

package/dist/consumers/event_consumer.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/consumers/event_consumer.ts"],"sourcesContent":["import { createPublicClient, http, type PublicClient } 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    private consumerRunning: boolean = false;\n    protected client: PublicClient | null = null;\n    protected observer: IObserver<object, ConsumerError, object> | null = null;\n\n    constructor(private config: IEventConsumerConfig) {\n        super();\n        this.client = createPublicClient({\n            chain: {\n                id: this.config.chainId,\n                name: \"custom\",\n                rpcUrls: { default: { http: [this.config.rpcUrl] } },\n                nativeCurrency: this.config.nativeCurrency,\n            },\n            transport: http(this.config.rpcUrl),\n        });\n    }\n\n    public async start(\n        observer: IObserver<T, ConsumerError, U>\n    ): Promise<void> {\n        try {\n            this.client?.watchContractEvent({\n                address: this.config.contractAddress,\n                abi: this.config.abi,\n                eventName: this.config.eventName,\n                fromBlock: this.config.startBlock,\n                onLogs: (logs) => {\n                    const transformedLogs = logs as T;\n                    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.eventName },\n                        })\n                    );\n                },\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.eventName },\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    private onDisconnect(): void {\n        if (this.consumerRunning) {\n            this.consumerRunning = false;\n            this.observer?.closed();\n            this.removeAllListeners();\n        }\n    }\n}\n"],"mappings":"AAAA,SAAS,oBAAoB,YAA+B;AAC5D,SAAS,eAAe,+BAA+B;AAEvD,SAAS,6BAA6B;AACtC,SAAS,kBAAkB;AAEpB,MAAM,sBAA4B,sBAAsB;AAAA,EAK3D,YAAoB,QAA8B;AAC9C,UAAM;AADU;AAEhB,SAAK,SAAS,mBAAmB;AAAA,MAC7B,OAAO;AAAA,QACH,IAAI,KAAK,OAAO;AAAA,QAChB,MAAM;AAAA,QACN,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,OAAO,MAAM,EAAE,EAAE;AAAA,QACnD,gBAAgB,KAAK,OAAO;AAAA,MAChC;AAAA,MACA,WAAW,KAAK,KAAK,OAAO,MAAM;AAAA,IACtC,CAAC;AAAA,EACL;AAAA,EAfQ,kBAA2B;AAAA,EACzB,SAA8B;AAAA,EAC9B,WAA4D;AAAA,EAetE,MAAa,MACT,UACa;AACb,QAAI;AACA,WAAK,QAAQ,mBAAmB;AAAA,QAC5B,SAAS,KAAK,OAAO;AAAA,QACrB,KAAK,KAAK,OAAO;AAAA,QACjB,WAAW,KAAK,OAAO;AAAA,QACvB,WAAW,KAAK,OAAO;AAAA,QACvB,QAAQ,CAAC,SAAS;AACd,gBAAM,kBAAkB;AACxB,mBAAS,KAAK,eAAe;AAAA,QACjC;AAAA,QACA,SAAS,CAAC,UAAU;AAChB,eAAK,aAAa;AAClB,eAAK;AAAA,YACD,IAAI,cAAc,MAAM,MAAM;AAAA,cAC1B,MAAM;AAAA,cACN,MAAM;AAAA,cACN,SAAS;AAAA,cACT,QAAQ;AAAA,cACR,SAAS,EAAE,WAAW,KAAK,OAAO,UAAU;AAAA,YAChD,CAAC;AAAA,UACL;AAAA,QACJ;AAAA,MACJ,CAAC;AAAA,IACL,SAAS,OAAO;AACZ,WAAK,aAAa;AAClB,WAAK;AAAA,QACD,IAAI;AAAA,UACA,KAAK,OAAO;AAAA,UACZ;AAAA,UACA;AAAA,YACI,cACI,WAAW,SACN;AAAA,YACT,UAAU;AAAA,YACV,QAAQ;AAAA,YACR,SAAS,EAAE,WAAW,KAAK,OAAO,UAAU;AAAA,UAChD;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,eAAqB;AACzB,QAAI,KAAK,iBAAiB;AACtB,WAAK,kBAAkB;AACvB,WAAK,UAAU,OAAO;AACtB,WAAK,mBAAmB;AAAA,IAC5B;AAAA,EACJ;AACJ;","names":[]}
+{"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 readonly 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.events = this.config.events;\n            } else {\n                getLogsConfig.event = this.config.events[0];\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

@@ -1,4 +1,6 @@
 export { EventConsumer } from './event_consumer.js';
+export { RestAPIConsumer } from './rest_api_consumer.js';
+export { AbstractCronEventConsumer } from './abstract_cron_event_consumer.js';
 import 'viem';
 import '../errors/consumer_errors.js';
 import '../errors/base_error.js';
@@ -6,3 +8,4 @@ import '../types/observer.js';
 import '../types/event_consumer_config.js';
 import './abstract_event_consumer.js';
 import 'events';
+import '../types/rest_api_consumer_config.js';

package/dist/consumers/index.js

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

package/dist/consumers/index.js.map

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

package/dist/consumers/rest_api_consumer.d.ts

@@ -0,0 +1,30 @@
+import { ConsumerError } from '../errors/consumer_errors.js';
+import { IObserver } from '../types/observer.js';
+import { IRestAPIConsumerConfig } from '../types/rest_api_consumer_config.js';
+import { AbstractCronEventConsumer } from './abstract_cron_event_consumer.js';
+import '../errors/base_error.js';
+import './abstract_event_consumer.js';
+import 'events';
+
+declare class RestAPIConsumer<T, U> extends AbstractCronEventConsumer {
+    private readonly config;
+    protected observer: IObserver<T, ConsumerError, U> | null;
+    private currentPage;
+    private highestValueSeen;
+    constructor(config: IRestAPIConsumerConfig);
+    start(observer: IObserver<T, ConsumerError, U>): Promise<void>;
+    stop(): void;
+    protected onTick(): Promise<void>;
+    private fetchPage;
+    private getValueByPath;
+    private processDataForCurrentCountValue;
+    /**
+     * Updates the start count value to a specific value.
+     * This allows reprocessing data from a specified point.
+     *
+     * @param value The value to set as the new start count
+     */
+    setStartValue(value: number): void;
+}
+
+export { RestAPIConsumer };