@polygonlabs/servercore 1.0.0-dev.9 → 1.1.0

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/README.md

@@ -1,15 +1,115 @@
-# servercore
+# @polygonlabs/servercore
 
-To install dependencies:
+Core server framework for building scalable TypeScript applications with built-in logging, error handling, API utilities, and event processing.
+
+## Features
+
+- **API Framework**: Health checks, response handlers, and Zod validation utilities
+- **Event Consumers**: Abstract base classes for REST API and cron job consumers
+- **Error Handling**: Comprehensive error system with custom error types
+- **Logging**: Winston-based logging with Sentry integration
+- **Storage Interfaces**: Abstract interfaces for databases and queues
+- **Utilities**: ULID generation, data decoders, and type utilities
+
+## Installation
 
 ```bash
-bun install
+npm install @polygonlabs/servercore
+# or
+bun add @polygonlabs/servercore
+```
+
+## Usage
+
+### API Framework
+
+```typescript
+import { healthCheck, handleResponse } from '@polygonlabs/servercore/api';
+import { validateInput } from '@polygonlabs/servercore/api';
+import { z } from 'zod';
+
+// Health check endpoint
+const health = healthCheck();
+
+// Response handling
+const response = handleResponse(data, 200);
+
+// Input validation
+const schema = z.object({ name: z.string() });
+const validatedData = validateInput(schema, input);
+```
+
+### Event Consumers
+
+```typescript
+import { RestApiConsumer, CronEventConsumer } from '@polygonlabs/servercore/consumers';
+
+class MyApiConsumer extends RestApiConsumer {
+  async processEvent(event: any) {
+    // Process API event
+  }
+}
+
+class MyCronConsumer extends CronEventConsumer {
+  async processEvent() {
+    // Process scheduled event
+  }
+}
 ```
 
-To run:
+### Logging
+
+```typescript
+import { createLogger } from '@polygonlabs/servercore/logger';
+
+const logger = createLogger({
+  level: 'info',
+  service: 'my-service'
+});
+
+logger.info('Application started');
+logger.error('Something went wrong', { error });
+```
+
+### Error Handling
+
+```typescript
+import { 
+  ApiError, 
+  DatabaseError, 
+  ExternalDependencyError 
+} from '@polygonlabs/servercore/errors';
+
+// Throw specific errors
+throw new ApiError('Invalid request', 'INVALID_REQUEST');
+throw new DatabaseError('Connection failed');
+throw new ExternalDependencyError('Service unavailable');
+```
+
+## Development
 
 ```bash
-bun run index.ts
+# Install dependencies
+bun install
+
+# Build the package
+bun run build
+
+# Run type checking
+bun run typecheck
+
+# Run tests
+bun run tests
 ```
 
-This project was created using `bun init` in bun v1.2.4. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.
+## Dependencies
+
+- **croner**: Cron job scheduling
+- **ulid**: Unique identifier generation  
+- **viem**: Ethereum utilities
+- **winston**: Logging framework
+- **zod**: Schema validation
+
+## License
+
+MIT

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,5 +1,6 @@
 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';

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

@@ -4,7 +4,12 @@ import { ExternalDependencyError } from '../errors/external_dependency_error.js'
 import { ResponseContext } from '../types/response_context.js';
 import '../errors/base_error.js';
 
-declare const handleResponse: (c: ResponseContext, data: any) => any;
+declare const handleResponse: (c: ResponseContext, data: any, pagination?: {
+    total: number;
+    limit: number;
+    offset?: number;
+    nextStartAfterCursor?: string | number;
+}) => any;
 declare const handleError: (c: ResponseContext, error: ApiError | ExternalDependencyError | DatabaseError) => any;
 
 export { handleError, handleResponse };

package/dist/api/response_handler.js

@@ -1,9 +1,10 @@
 import { ApiError, DatabaseError, ExternalDependencyError } from "../errors";
-import { httpResposneCodes, errorCodes } from "../constants";
-const handleResponse = (c, data) => {
-  return c.status(httpResposneCodes.OK_RESPONSE).json({
+import { httpResponseCodes, errorCodes } from "../constants";
+const handleResponse = (c, data, pagination) => {
+  return c.status(httpResponseCodes.OK_RESPONSE).json({
     status: "success",
-    data
+    data,
+    pagination
   });
 };
 const handleError = (c, error) => {

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\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":[]}
+{"version":3,"sources":["../../src/api/response_handler.ts"],"sourcesContent":["import { ApiError, DatabaseError, ExternalDependencyError } from \"../errors\"; // Define your error types\nimport { httpResponseCodes, errorCodes } from \"../constants\"; // Define your success codes\nimport type { ResponseContext } from \"../types\";\n\nexport const handleResponse = (\n    c: ResponseContext,\n    data: any,\n    pagination?: {\n        total: number;\n        limit: number;\n        offset?: number;\n        nextStartAfterCursor?: string | number;\n    }\n) => {\n    // This method returns a success response with the status and data.\n    return c\n        .status(httpResponseCodes.OK_RESPONSE) // Use success code from httpResponseCodes\n        .json({\n            status: \"success\",\n            data: data,\n            pagination,\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,CAC1B,GACA,MACA,eAMC;AAED,SAAO,EACF,OAAO,kBAAkB,WAAW,EACpC,KAAK;AAAA,IACF,QAAQ;AAAA,IACR;AAAA,IACA;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/constants/http_success_codes.d.ts

@@ -1,5 +1,5 @@
-declare const httpResposneCodes: {
+declare const httpResponseCodes: {
     OK_RESPONSE: number;
 };
 
-export { httpResposneCodes };
+export { httpResponseCodes };

package/dist/constants/http_success_codes.js

@@ -1,7 +1,7 @@
-const httpResposneCodes = {
+const httpResponseCodes = {
   OK_RESPONSE: 200
 };
 export {
-  httpResposneCodes
+  httpResponseCodes
 };
 //# sourceMappingURL=http_success_codes.js.map

package/dist/constants/http_success_codes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/constants/http_success_codes.ts"],"sourcesContent":["export const httpResposneCodes = {\n    OK_RESPONSE: 200,\n};\n"],"mappings":"AAAO,MAAM,oBAAoB;AAAA,EAC7B,aAAa;AACjB;","names":[]}
+{"version":3,"sources":["../../src/constants/http_success_codes.ts"],"sourcesContent":["export const httpResponseCodes = {\n    OK_RESPONSE: 200,\n};\n"],"mappings":"AAAO,MAAM,oBAAoB;AAAA,EAC7B,aAAa;AACjB;","names":[]}

package/dist/constants/index.d.ts

@@ -1,2 +1,2 @@
 export { errorCodes } from './error_codes.js';
-export { httpResposneCodes } from './http_success_codes.js';
+export { httpResponseCodes } from './http_success_codes.js';

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/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,10 +7,11 @@ 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<T, ConsumerError, U> | null;
+    isBackfillingInProcess: boolean;
+    protected unWatchFunction: WatchEventReturnType | undefined;
     constructor(config: IEventConsumerConfig);
     private _backfillEvents;
     start(observer: IObserver<T, ConsumerError, U>): Promise<void>;
@@ -19,7 +20,7 @@ declare class EventConsumer<T, U> extends AbstractEventConsumer {
      *
      * @returns {void}
      */
-    private onDisconnect;
+    onDisconnect(): void;
 }
 
 export { EventConsumer };

package/dist/consumers/event_consumer.js

@@ -17,21 +17,22 @@ class EventConsumer extends AbstractEventConsumer {
       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} to ${toBlock}`
+      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} to ${end}`
+        status: `[Backfill] Fetching logs from block ${start.toString()} to ${end.toString()}`
       });
       const getLogsConfig = {
         address: this.config.contractAddress,
@@ -39,48 +40,50 @@ class EventConsumer extends AbstractEventConsumer {
         toBlock: end
       };
       if (this.config.events.length > 1) {
-        getLogsConfig.event = this.config.events[0];
-      } else {
         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} to ${end}`
+        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,
-          startBlock: this.config.startBlock,
-          pollBatchSize: this.config.pollBatchSize
+          latestBlock: latestBlock.toString(),
+          startBlock: this.config.startBlock.toString(),
+          pollBatchSize: this.config.pollBatchSize.toString()
         }
       });
-      if (latestBlock - this.config.startBlock > this.config.pollBatchSize) {
+      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.client?.watchEvent({
+      this.unWatchFunction = this.client?.watchEvent({
         address: this.config.contractAddress,
         events: this.config.events,
-        fromBlock: this.config.startBlock,
+        fromBlock: latestBlock,
         onLogs: (logs) => {
           const transformedLogs = logs;
           this.observer?.next(transformedLogs);
@@ -125,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 { Logger } from \"../logger\";\nimport { 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<T, ConsumerError, U> | null = null;\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} to ${toBlock}`,\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} to ${end}`,\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} to ${end}`,\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.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,\n                    startBlock: this.config.startBlock,\n                    pollBatchSize: this.config.pollBatchSize,\n                },\n            });\n            if (\n                latestBlock - this.config.startBlock >\n                this.config.pollBatchSize\n            ) {\n                await this._backfillEvents(\n                    this.config.startBlock,\n                    latestBlock,\n                    this.config.pollBatchSize\n                );\n            }\n\n            Logger.debug({\n                location: \"event_consumer\",\n                functon: \"start\",\n                status: `Starting event subscription`,\n            });\n\n            this.client?.watchEvent({\n                address: this.config.contractAddress,\n                events: this.config.events,\n                fromBlock: this.config.startBlock,\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    private onDisconnect(): void {\n        if (this.consumerRunning) {\n            this.consumerRunning = false;\n            this.observer?.closed();\n            this.removeAllListeners();\n        }\n    }\n}\n"],"mappings":"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","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 };