@polygonlabs/servercore 0.0.0

package/README.md

@@ -0,0 +1,15 @@
+# servercore
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.2.4. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.

package/dist/api/index.d.ts

@@ -0,0 +1,7 @@
+export { handleError, handleResponse } from './response_handler.js';
+export { validateBody, validateParams, validateQuery } from './zod_utils.js';
+import '../errors/api_errors.js';
+import '../errors/base_error.js';
+import '../errors/database_errors.js';
+import '../errors/external_dependency_error.js';
+import 'zod';

package/dist/api/index.js

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

package/dist/api/index.js.map

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

package/dist/api/response_handler.d.ts

@@ -0,0 +1,13 @@
+import { ApiError } from '../errors/api_errors.js';
+import { DatabaseError } from '../errors/database_errors.js';
+import { ExternalDependencyError } from '../errors/external_dependency_error.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;
+
+export { handleError, handleResponse };

package/dist/api/response_handler.js

@@ -0,0 +1,22 @@
+import { ApiError, DatabaseError, ExternalDependencyError } from "../errors";
+import { httpResposneCodes, errorCodes } from "../constants";
+const handleResponse = (c, data) => {
+  return c.status(httpResposneCodes.OK_RESPONSE).json({
+    status: "success",
+    data
+  });
+};
+const handleError = (c, error) => {
+  return c.status(error.code ?? errorCodes.api.INTERNAL_SERVER_ERROR).json({
+    status: "error",
+    message: error.message,
+    name: error.name,
+    code: error.code,
+    details: error.context
+  });
+};
+export {
+  handleError,
+  handleResponse
+};
+//# sourceMappingURL=response_handler.js.map

package/dist/api/response_handler.js.map

@@ -0,0 +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":[]}

package/dist/api/zod_utils.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+
+declare const validateBody: <T extends z.ZodTypeAny>(schema: T, data: unknown) => z.infer<T>;
+declare const validateQuery: <T extends z.ZodTypeAny>(schema: T, query: Record<string, unknown>) => z.infer<T>;
+declare const validateParams: <T extends z.ZodTypeAny>(schema: T, params: Record<string, string>) => z.infer<T>;
+
+export { validateBody, validateParams, validateQuery };

package/dist/api/zod_utils.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+const validateBody = (schema, data) => {
+  const result = schema.safeParse(data);
+  if (!result.success) {
+    throw new Error(
+      `Invalid body: ${JSON.stringify(result.error.format(), null, 2)}`
+    );
+  }
+  return result.data;
+};
+const validateQuery = (schema, query) => {
+  const result = schema.safeParse(query);
+  if (!result.success) {
+    throw new Error(
+      `Invalid query params: ${JSON.stringify(
+        result.error.format(),
+        null,
+        2
+      )}`
+    );
+  }
+  return result.data;
+};
+const validateParams = (schema, params) => {
+  const result = schema.safeParse(params);
+  if (!result.success) {
+    throw new Error(
+      `Invalid path params: ${JSON.stringify(
+        result.error.format(),
+        null,
+        2
+      )}`
+    );
+  }
+  return result.data;
+};
+export {
+  validateBody,
+  validateParams,
+  validateQuery
+};
+//# sourceMappingURL=zod_utils.js.map

package/dist/api/zod_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/zod_utils.ts"],"sourcesContent":["import { z } from \"zod\";\n\n// Utility function for validating the request body\nexport const validateBody = <T extends z.ZodTypeAny>(\n    schema: T,\n    data: unknown\n): z.infer<T> => {\n    const result = schema.safeParse(data);\n    if (!result.success) {\n        throw new Error(\n            `Invalid body: ${JSON.stringify(result.error.format(), null, 2)}`\n        );\n    }\n    return result.data;\n};\n\n// Utility function for validating query parameters\nexport const validateQuery = <T extends z.ZodTypeAny>(\n    schema: T,\n    query: Record<string, unknown>\n): z.infer<T> => {\n    const result = schema.safeParse(query);\n    if (!result.success) {\n        throw new Error(\n            `Invalid query params: ${JSON.stringify(\n                result.error.format(),\n                null,\n                2\n            )}`\n        );\n    }\n    return result.data;\n};\n\n// Utility function for validating path parameters\nexport const validateParams = <T extends z.ZodTypeAny>(\n    schema: T,\n    params: Record<string, string>\n): z.infer<T> => {\n    const result = schema.safeParse(params);\n    if (!result.success) {\n        throw new Error(\n            `Invalid path params: ${JSON.stringify(\n                result.error.format(),\n                null,\n                2\n            )}`\n        );\n    }\n    return result.data;\n};\n"],"mappings":"AAAA,SAAS,SAAS;AAGX,MAAM,eAAe,CACxB,QACA,SACa;AACb,QAAM,SAAS,OAAO,UAAU,IAAI;AACpC,MAAI,CAAC,OAAO,SAAS;AACjB,UAAM,IAAI;AAAA,MACN,iBAAiB,KAAK,UAAU,OAAO,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC;AAAA,IACnE;AAAA,EACJ;AACA,SAAO,OAAO;AAClB;AAGO,MAAM,gBAAgB,CACzB,QACA,UACa;AACb,QAAM,SAAS,OAAO,UAAU,KAAK;AACrC,MAAI,CAAC,OAAO,SAAS;AACjB,UAAM,IAAI;AAAA,MACN,yBAAyB,KAAK;AAAA,QAC1B,OAAO,MAAM,OAAO;AAAA,QACpB;AAAA,QACA;AAAA,MACJ,CAAC;AAAA,IACL;AAAA,EACJ;AACA,SAAO,OAAO;AAClB;AAGO,MAAM,iBAAiB,CAC1B,QACA,WACa;AACb,QAAM,SAAS,OAAO,UAAU,MAAM;AACtC,MAAI,CAAC,OAAO,SAAS;AACjB,UAAM,IAAI;AAAA,MACN,wBAAwB,KAAK;AAAA,QACzB,OAAO,MAAM,OAAO;AAAA,QACpB;AAAA,QACA;AAAA,MACJ,CAAC;AAAA,IACL;AAAA,EACJ;AACA,SAAO,OAAO;AAClB;","names":[]}

package/dist/constants/error_codes.d.ts

@@ -0,0 +1,29 @@
+declare const errorCodes: {
+    base: {
+        BASE_ERROR: number;
+    };
+    consumer: {
+        UNKNOWN_CONSUMER_ERR: number;
+    };
+    datastore: {
+        UNKNOWN_DATASTORE_ERR: number;
+        DATASTORE_AUTH_ERR: number;
+        DATASTORE_READ_ERROR: number;
+        DATASTORE_WRITE_ERROR: number;
+    };
+    external: {
+        UNKNOWN_EXTERNAL_DEPENDENCY_ERROR: number;
+    };
+    api: {
+        BAD_REQUEST: number;
+        UNAUTHORIZED: number;
+        FORBIDDEN: number;
+        NOT_FOUND: number;
+        TOO_MANY_REQUESTS: number;
+        INTERNAL_SERVER_ERROR: number;
+        GATEWAY_ERROR: number;
+        TIMEOUT_ERROR: number;
+    };
+};
+
+export { errorCodes };

package/dist/constants/error_codes.js

@@ -0,0 +1,34 @@
+const errorCodes = {
+  // Base error identifier
+  base: { BASE_ERROR: 100 },
+  // Consumer related error codes
+  consumer: {
+    UNKNOWN_CONSUMER_ERR: 1e3
+  },
+  // Datastore related error codes
+  datastore: {
+    UNKNOWN_DATASTORE_ERR: 2e3,
+    DATASTORE_AUTH_ERR: 2001,
+    DATASTORE_READ_ERROR: 2002,
+    DATASTORE_WRITE_ERROR: 2003
+  },
+  // External dependencies errors codes
+  external: {
+    UNKNOWN_EXTERNAL_DEPENDENCY_ERROR: 3e3
+  },
+  // API related error codes
+  api: {
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    FORBIDDEN: 403,
+    NOT_FOUND: 404,
+    TOO_MANY_REQUESTS: 429,
+    INTERNAL_SERVER_ERROR: 500,
+    GATEWAY_ERROR: 502,
+    TIMEOUT_ERROR: 504
+  }
+};
+export {
+  errorCodes
+};
+//# sourceMappingURL=error_codes.js.map

package/dist/constants/error_codes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants/error_codes.ts"],"sourcesContent":["export const errorCodes = {\n    // Base error identifier\n    base: { BASE_ERROR: 100 },\n\n    // Consumer related error codes\n    consumer: {\n        UNKNOWN_CONSUMER_ERR: 1000,\n    },\n\n    // Datastore related error codes\n    datastore: {\n        UNKNOWN_DATASTORE_ERR: 2000,\n        DATASTORE_AUTH_ERR: 2001,\n        DATASTORE_READ_ERROR: 2002,\n        DATASTORE_WRITE_ERROR: 2003,\n    },\n\n    // External dependencies errors codes\n    external: {\n        UNKNOWN_EXTERNAL_DEPENDENCY_ERROR: 3000,\n    },\n\n    // API related error codes\n    api: {\n        BAD_REQUEST: 400,\n        UNAUTHORIZED: 401,\n        FORBIDDEN: 403,\n        NOT_FOUND: 404,\n        TOO_MANY_REQUESTS: 429,\n        INTERNAL_SERVER_ERROR: 500,\n        GATEWAY_ERROR: 502,\n        TIMEOUT_ERROR: 504,\n    },\n};\n"],"mappings":"AAAO,MAAM,aAAa;AAAA;AAAA,EAEtB,MAAM,EAAE,YAAY,IAAI;AAAA;AAAA,EAGxB,UAAU;AAAA,IACN,sBAAsB;AAAA,EAC1B;AAAA;AAAA,EAGA,WAAW;AAAA,IACP,uBAAuB;AAAA,IACvB,oBAAoB;AAAA,IACpB,sBAAsB;AAAA,IACtB,uBAAuB;AAAA,EAC3B;AAAA;AAAA,EAGA,UAAU;AAAA,IACN,mCAAmC;AAAA,EACvC;AAAA;AAAA,EAGA,KAAK;AAAA,IACD,aAAa;AAAA,IACb,cAAc;AAAA,IACd,WAAW;AAAA,IACX,WAAW;AAAA,IACX,mBAAmB;AAAA,IACnB,uBAAuB;AAAA,IACvB,eAAe;AAAA,IACf,eAAe;AAAA,EACnB;AACJ;","names":[]}

package/dist/constants/http_success_codes.d.ts

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

package/dist/constants/http_success_codes.js

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

package/dist/constants/http_success_codes.js.map

@@ -0,0 +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":[]}

package/dist/constants/index.d.ts

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

package/dist/constants/index.js

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

package/dist/constants/index.js.map

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

package/dist/database/db_interface.d.ts

@@ -0,0 +1,13 @@
+import { IQueryFilterOperationParams, IDocumentConditionalModifications, IQueryOrderOperationParams } from '../types/database.js';
+
+interface Database {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    addDocuments(collectionPaths: string[], docDatas: any[], docIds?: string[]): Promise<void>;
+    updateDocuments(collectionPaths: string[], docDatas: any[], docIds: string[]): Promise<void>;
+    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>;
+}
+
+export type { Database };

package/dist/database/db_interface.js

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

package/dist/database/db_interface.js.map

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

package/dist/database/index.d.ts

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

package/dist/database/index.js

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

package/dist/database/index.js.map

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

package/dist/errors/api_errors.d.ts

@@ -0,0 +1,32 @@
+import { BaseError } from './base_error.js';
+
+declare class ApiError extends BaseError {
+    constructor(message: string, { name, code, isFatal, origin, context, }?: {
+        name?: string;
+        code?: number;
+        isFatal?: boolean;
+        origin?: string;
+        context?: Record<string, any>;
+    });
+}
+declare class UnauthorizedError extends ApiError {
+    constructor(message?: string, context?: Record<string, any>, origin?: string);
+}
+declare class ForbiddenError extends ApiError {
+    constructor(message?: string, context?: Record<string, any>, origin?: string);
+}
+declare class BadRequestError extends ApiError {
+    readonly validationErrors: Record<string, string[]>;
+    constructor(message?: string, validationErrors?: Record<string, any>, context?: Record<string, any>, origin?: string);
+}
+declare class NotFoundError extends ApiError {
+    constructor(entity?: string, identifier?: string | number, context?: Record<string, any>, origin?: string);
+}
+declare class RateLimitError extends ApiError {
+    constructor(message?: string, context?: Record<string, any>, origin?: string);
+}
+declare class TimeoutError extends ApiError {
+    constructor(operation: string, timeoutMs: number, context?: Record<string, any>, origin?: string);
+}
+
+export { ApiError, BadRequestError, ForbiddenError, NotFoundError, RateLimitError, TimeoutError, UnauthorizedError };

package/dist/errors/api_errors.js

@@ -0,0 +1,94 @@
+import { BaseError } from "./base_error";
+import { errorCodes } from "../constants";
+class ApiError extends BaseError {
+  constructor(message, {
+    name = "INTERNAL_SERVER_ERROR",
+    code = errorCodes.api.INTERNAL_SERVER_ERROR,
+    isFatal = true,
+    origin = "api_errors",
+    context = {}
+  } = {}) {
+    super(name, code, message, isFatal, origin, context);
+    Error.captureStackTrace(this, this.constructor);
+  }
+}
+class UnauthorizedError extends ApiError {
+  constructor(message = "Invalid auth credentials", context = {}, origin = "api_errors") {
+    super(message, {
+      name: "UNAUTHORIZED",
+      code: errorCodes.api.UNAUTHORIZED,
+      isFatal: true,
+      origin,
+      context
+    });
+  }
+}
+class ForbiddenError extends ApiError {
+  constructor(message = "You do not have permission to perform this action", context = {}, origin = "api_errors") {
+    super(message, {
+      name: "FORBIDDEN",
+      code: errorCodes.api.FORBIDDEN,
+      isFatal: true,
+      origin,
+      context
+    });
+  }
+}
+class BadRequestError extends ApiError {
+  validationErrors;
+  constructor(message = "Malformed or invalid request", validationErrors = {}, context = {}, origin = "api_errors") {
+    super(message, {
+      name: "BAD_REQUEST",
+      code: errorCodes.api.BAD_REQUEST,
+      isFatal: true,
+      origin,
+      context
+    });
+    this.validationErrors = validationErrors;
+  }
+}
+class NotFoundError extends ApiError {
+  constructor(entity = "Path", identifier, context = {}, origin = "api_errors") {
+    const message = identifier ? `${entity} with identifier ${identifier} not found` : `${entity} not found`;
+    super(message, {
+      name: "NOT_FOUND",
+      code: errorCodes.api.NOT_FOUND,
+      isFatal: true,
+      origin,
+      context: { entity, identifier, ...context }
+    });
+  }
+}
+class RateLimitError extends ApiError {
+  constructor(message = "Rate limit exceeded", context = {}, origin = "api_errors") {
+    super(message, {
+      name: "RATE_LIMIT",
+      code: errorCodes.api.TOO_MANY_REQUESTS,
+      isFatal: true,
+      origin,
+      context
+    });
+  }
+}
+class TimeoutError extends ApiError {
+  constructor(operation, timeoutMs, context = {}, origin = "api_errors") {
+    super(`Operation '${operation}' timed out after ${timeoutMs}ms`, {
+      name: "TIMEOUT",
+      code: errorCodes.api.TIMEOUT_ERROR,
+      // Gateway Timeout
+      isFatal: true,
+      origin,
+      context: { operation, timeoutMs, ...context }
+    });
+  }
+}
+export {
+  ApiError,
+  BadRequestError,
+  ForbiddenError,
+  NotFoundError,
+  RateLimitError,
+  TimeoutError,
+  UnauthorizedError
+};
+//# sourceMappingURL=api_errors.js.map

package/dist/errors/api_errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/api_errors.ts"],"sourcesContent":["import { BaseError } from \"./base_error\";\nimport { errorCodes } from \"../constants\";\n\nexport class ApiError extends BaseError {\n    constructor(\n        message: string,\n        {\n            name = \"INTERNAL_SERVER_ERROR\",\n            code = errorCodes.api.INTERNAL_SERVER_ERROR,\n            isFatal = true,\n            origin = \"api_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\nexport class UnauthorizedError extends ApiError {\n    constructor(\n        message: string = \"Invalid auth credentials\",\n        context: Record<string, any> = {},\n        origin: string = \"api_errors\"\n    ) {\n        super(message, {\n            name: \"UNAUTHORIZED\",\n            code: errorCodes.api.UNAUTHORIZED,\n            isFatal: true,\n            origin,\n            context,\n        });\n    }\n}\n\nexport class ForbiddenError extends ApiError {\n    constructor(\n        message: string = \"You do not have permission to perform this action\",\n        context: Record<string, any> = {},\n        origin: string = \"api_errors\"\n    ) {\n        super(message, {\n            name: \"FORBIDDEN\",\n            code: errorCodes.api.FORBIDDEN,\n            isFatal: true,\n            origin,\n            context,\n        });\n    }\n}\n\nexport class BadRequestError extends ApiError {\n    public readonly validationErrors: Record<string, string[]>;\n\n    constructor(\n        message: string = \"Malformed or invalid request\",\n        validationErrors: Record<string, any> = {},\n        context: Record<string, any> = {},\n        origin: string = \"api_errors\"\n    ) {\n        super(message, {\n            name: \"BAD_REQUEST\",\n            code: errorCodes.api.BAD_REQUEST,\n            isFatal: true,\n            origin,\n            context,\n        });\n        this.validationErrors = validationErrors;\n    }\n}\n\nexport class NotFoundError extends ApiError {\n    constructor(\n        entity: string = \"Path\",\n        identifier?: string | number,\n        context: Record<string, any> = {},\n        origin: string = \"api_errors\"\n    ) {\n        const message = identifier\n            ? `${entity} with identifier ${identifier} not found`\n            : `${entity} not found`;\n\n        super(message, {\n            name: \"NOT_FOUND\",\n            code: errorCodes.api.NOT_FOUND,\n            isFatal: true,\n            origin,\n            context: { entity, identifier, ...context },\n        });\n    }\n}\n\nexport class RateLimitError extends ApiError {\n    constructor(\n        message: string = \"Rate limit exceeded\",\n        context: Record<string, any> = {},\n        origin: string = \"api_errors\"\n    ) {\n        super(message, {\n            name: \"RATE_LIMIT\",\n            code: errorCodes.api.TOO_MANY_REQUESTS,\n            isFatal: true,\n            origin,\n            context,\n        });\n    }\n}\n\nexport class TimeoutError extends ApiError {\n    constructor(\n        operation: string,\n        timeoutMs: number,\n        context: Record<string, any> = {},\n        origin: string = \"api_errors\"\n    ) {\n        super(`Operation '${operation}' timed out after ${timeoutMs}ms`, {\n            name: \"TIMEOUT\",\n            code: errorCodes.api.TIMEOUT_ERROR, // Gateway Timeout\n            isFatal: true,\n            origin,\n            context: { operation, timeoutMs, ...context },\n        });\n    }\n}\n"],"mappings":"AAAA,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAEpB,MAAM,iBAAiB,UAAU;AAAA,EACpC,YACI,SACA;AAAA,IACI,OAAO;AAAA,IACP,OAAO,WAAW,IAAI;AAAA,IACtB,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;AAEO,MAAM,0BAA0B,SAAS;AAAA,EAC5C,YACI,UAAkB,4BAClB,UAA+B,CAAC,GAChC,SAAiB,cACnB;AACE,UAAM,SAAS;AAAA,MACX,MAAM;AAAA,MACN,MAAM,WAAW,IAAI;AAAA,MACrB,SAAS;AAAA,MACT;AAAA,MACA;AAAA,IACJ,CAAC;AAAA,EACL;AACJ;AAEO,MAAM,uBAAuB,SAAS;AAAA,EACzC,YACI,UAAkB,qDAClB,UAA+B,CAAC,GAChC,SAAiB,cACnB;AACE,UAAM,SAAS;AAAA,MACX,MAAM;AAAA,MACN,MAAM,WAAW,IAAI;AAAA,MACrB,SAAS;AAAA,MACT;AAAA,MACA;AAAA,IACJ,CAAC;AAAA,EACL;AACJ;AAEO,MAAM,wBAAwB,SAAS;AAAA,EAC1B;AAAA,EAEhB,YACI,UAAkB,gCAClB,mBAAwC,CAAC,GACzC,UAA+B,CAAC,GAChC,SAAiB,cACnB;AACE,UAAM,SAAS;AAAA,MACX,MAAM;AAAA,MACN,MAAM,WAAW,IAAI;AAAA,MACrB,SAAS;AAAA,MACT;AAAA,MACA;AAAA,IACJ,CAAC;AACD,SAAK,mBAAmB;AAAA,EAC5B;AACJ;AAEO,MAAM,sBAAsB,SAAS;AAAA,EACxC,YACI,SAAiB,QACjB,YACA,UAA+B,CAAC,GAChC,SAAiB,cACnB;AACE,UAAM,UAAU,aACV,GAAG,MAAM,oBAAoB,UAAU,eACvC,GAAG,MAAM;AAEf,UAAM,SAAS;AAAA,MACX,MAAM;AAAA,MACN,MAAM,WAAW,IAAI;AAAA,MACrB,SAAS;AAAA,MACT;AAAA,MACA,SAAS,EAAE,QAAQ,YAAY,GAAG,QAAQ;AAAA,IAC9C,CAAC;AAAA,EACL;AACJ;AAEO,MAAM,uBAAuB,SAAS;AAAA,EACzC,YACI,UAAkB,uBAClB,UAA+B,CAAC,GAChC,SAAiB,cACnB;AACE,UAAM,SAAS;AAAA,MACX,MAAM;AAAA,MACN,MAAM,WAAW,IAAI;AAAA,MACrB,SAAS;AAAA,MACT;AAAA,MACA;AAAA,IACJ,CAAC;AAAA,EACL;AACJ;AAEO,MAAM,qBAAqB,SAAS;AAAA,EACvC,YACI,WACA,WACA,UAA+B,CAAC,GAChC,SAAiB,cACnB;AACE,UAAM,cAAc,SAAS,qBAAqB,SAAS,MAAM;AAAA,MAC7D,MAAM;AAAA,MACN,MAAM,WAAW,IAAI;AAAA;AAAA,MACrB,SAAS;AAAA,MACT;AAAA,MACA,SAAS,EAAE,WAAW,WAAW,GAAG,QAAQ;AAAA,IAChD,CAAC;AAAA,EACL;AACJ;","names":[]}

package/dist/errors/base_error.d.ts

@@ -0,0 +1,22 @@
+/**
+ * BaseError used within the micro services that guarantees we don't loose the stack trace.
+ */
+declare class BaseError extends Error {
+    readonly name: string;
+    readonly code: number;
+    readonly isFatal: boolean;
+    readonly origin: string;
+    readonly context: Record<string, any>;
+    /**
+     * @param name {string} - The error name
+     * @param code {number} - The error code
+     * @param isFatal {boolean} - Flag to know if it is a fatal error
+     * @param message {string} - The actual error message
+     * @param origin {string} - The point this error originated
+     * @param context Record<string, any> - The stack trace
+     */
+    constructor(name: string, code: number, message?: string, isFatal?: boolean, origin?: string, context?: Record<string, any>);
+    identifier: number;
+}
+
+export { BaseError };

package/dist/errors/base_error.js

@@ -0,0 +1,30 @@
+import { errorCodes } from "../constants";
+class BaseError extends Error {
+  name;
+  code;
+  isFatal;
+  origin;
+  context;
+  /**
+   * @param name {string} - The error name
+   * @param code {number} - The error code
+   * @param isFatal {boolean} - Flag to know if it is a fatal error
+   * @param message {string} - The actual error message
+   * @param origin {string} - The point this error originated
+   * @param context Record<string, any> - The stack trace
+   */
+  constructor(name, code, message = "Unknown error", isFatal, origin, context) {
+    super(message);
+    this.name = name;
+    this.code = code;
+    this.isFatal = isFatal ?? true;
+    this.origin = origin ?? "base_error";
+    this.context = context ?? {};
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  identifier = errorCodes.base.BASE_ERROR;
+}
+export {
+  BaseError
+};
+//# sourceMappingURL=base_error.js.map

package/dist/errors/base_error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/base_error.ts"],"sourcesContent":["import { errorCodes } from \"../constants\";\n\n/**\n * BaseError used within the micro services that guarantees we don't loose the stack trace.\n */\nexport class BaseError extends Error {\n    public readonly name: string;\n    public readonly code: number;\n    public readonly isFatal: boolean;\n    public readonly origin: string;\n    public readonly context: Record<string, any>;\n    /**\n     * @param name {string} - The error name\n     * @param code {number} - The error code\n     * @param isFatal {boolean} - Flag to know if it is a fatal error\n     * @param message {string} - The actual error message\n     * @param origin {string} - The point this error originated\n     * @param context Record<string, any> - The stack trace\n     */\n    constructor(\n        name: string,\n        code: number,\n        message: string = \"Unknown error\",\n        isFatal?: boolean,\n        origin?: string,\n        context?: Record<string, any>\n    ) {\n        super(message);\n        this.name = name;\n        this.code = code;\n        this.isFatal = isFatal ?? true;\n        this.origin = origin ?? \"base_error\";\n        this.context = context ?? {};\n        Object.setPrototypeOf(this, new.target.prototype);\n    }\n    identifier: number = errorCodes.base.BASE_ERROR;\n}\n"],"mappings":"AAAA,SAAS,kBAAkB;AAKpB,MAAM,kBAAkB,MAAM;AAAA,EACjB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAShB,YACI,MACA,MACA,UAAkB,iBAClB,SACA,QACA,SACF;AACE,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,UAAU,WAAW;AAC1B,SAAK,SAAS,UAAU;AACxB,SAAK,UAAU,WAAW,CAAC;AAC3B,WAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EACpD;AAAA,EACA,aAAqB,WAAW,KAAK;AACzC;","names":[]}

package/dist/errors/consumer_errors.d.ts

@@ -0,0 +1,13 @@
+import { BaseError } from './base_error.js';
+
+declare class ConsumerError extends BaseError {
+    constructor(message: string, { name, code, isFatal, origin, context, }?: {
+        name?: string;
+        code?: number;
+        isFatal?: boolean;
+        origin?: string;
+        context?: Record<string, any>;
+    });
+}
+
+export { ConsumerError };

package/dist/errors/consumer_errors.js

@@ -0,0 +1,18 @@
+import { BaseError } from "./base_error";
+import { errorCodes } from "../constants";
+class ConsumerError extends BaseError {
+  constructor(message, {
+    name = "CONSUMER_ERROR",
+    code = errorCodes.consumer.UNKNOWN_CONSUMER_ERR,
+    isFatal = true,
+    origin = "consumer_errors",
+    context = {}
+  } = {}) {
+    super(name, code, message, isFatal, origin, context);
+    Error.captureStackTrace(this, this.constructor);
+  }
+}
+export {
+  ConsumerError
+};
+//# sourceMappingURL=consumer_errors.js.map

package/dist/errors/consumer_errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/consumer_errors.ts"],"sourcesContent":["import { BaseError } from \"./base_error\";\nimport { errorCodes } from \"../constants\";\n\nexport class ConsumerError extends BaseError {\n    constructor(\n        message: string,\n        {\n            name = \"CONSUMER_ERROR\",\n            code = errorCodes.consumer.UNKNOWN_CONSUMER_ERR,\n            isFatal = true,\n            origin = \"consumer_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;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/errors/database_errors.d.ts

@@ -0,0 +1,13 @@
+import { BaseError } from './base_error.js';
+
+declare class DatabaseError extends BaseError {
+    constructor(message: string, originalError?: Error, { name, code, isFatal, origin, context, }?: {
+        name?: string;
+        code?: number;
+        isFatal?: boolean;
+        origin?: string;
+        context?: Record<string, any>;
+    });
+}
+
+export { DatabaseError };

package/dist/errors/database_errors.js

@@ -0,0 +1,18 @@
+import { BaseError } from "./base_error";
+import { errorCodes } from "../constants";
+class DatabaseError extends BaseError {
+  constructor(message, originalError, {
+    name = "CONSUMER_ERROR",
+    code = errorCodes.consumer.UNKNOWN_CONSUMER_ERR,
+    isFatal = true,
+    origin = "databse_errors",
+    context = {}
+  } = {}) {
+    super(name, code, message, isFatal, origin, context);
+    Error.captureStackTrace(this, this.constructor);
+  }
+}
+export {
+  DatabaseError
+};
+//# sourceMappingURL=database_errors.js.map

package/dist/errors/database_errors.js.map

@@ -0,0 +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":[]}

package/dist/errors/external_dependency_error.d.ts

@@ -0,0 +1,15 @@
+import { BaseError } from './base_error.js';
+
+declare class ExternalDependencyError extends BaseError {
+    readonly apiName: string;
+    readonly externalCode?: string | number;
+    readonly rawError?: any;
+    constructor(apiName: string, message: string, { externalCode, rawError, context, origin, }?: {
+        externalCode?: string | number;
+        rawError?: any;
+        context?: Record<string, any>;
+        origin?: string;
+    });
+}
+
+export { ExternalDependencyError };

package/dist/errors/external_dependency_error.js

@@ -0,0 +1,29 @@
+import { BaseError } from "./base_error";
+import { errorCodes } from "../constants";
+class ExternalDependencyError extends BaseError {
+  apiName;
+  externalCode;
+  rawError;
+  constructor(apiName, message, {
+    externalCode,
+    rawError,
+    context = {},
+    origin = "external_dependency_error"
+  } = {}) {
+    super(
+      "EXTERNAL_DEPENDENCY_ERROR",
+      errorCodes.external.UNKNOWN_EXTERNAL_DEPENDENCY_ERROR,
+      `${apiName} API error: ${message}`,
+      false,
+      origin,
+      { apiName, externalCode, ...context }
+    );
+    this.apiName = apiName;
+    this.externalCode = externalCode;
+    this.rawError = rawError;
+  }
+}
+export {
+  ExternalDependencyError
+};
+//# sourceMappingURL=external_dependency_error.js.map

package/dist/errors/external_dependency_error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/external_dependency_error.ts"],"sourcesContent":["import { BaseError } from \"./base_error\";\nimport { errorCodes } from \"../constants\";\n\nexport class ExternalDependencyError extends BaseError {\n    public readonly apiName: string;\n\n    public readonly externalCode?: string | number;\n\n    public readonly rawError?: any;\n\n    constructor(\n        apiName: string,\n        message: string,\n        {\n            externalCode,\n            rawError,\n            context = {},\n            origin = \"external_dependency_error\",\n        }: {\n            externalCode?: string | number;\n            rawError?: any;\n            context?: Record<string, any>;\n            origin?: string;\n        } = {}\n    ) {\n        super(\n            \"EXTERNAL_DEPENDENCY_ERROR\",\n            errorCodes.external.UNKNOWN_EXTERNAL_DEPENDENCY_ERROR,\n            `${apiName} API error: ${message}`,\n            false,\n            origin,\n            { apiName, externalCode, ...context }\n        );\n\n        this.apiName = apiName;\n        this.externalCode = externalCode;\n        this.rawError = rawError;\n    }\n}\n"],"mappings":"AAAA,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAEpB,MAAM,gCAAgC,UAAU;AAAA,EACnC;AAAA,EAEA;AAAA,EAEA;AAAA,EAEhB,YACI,SACA,SACA;AAAA,IACI;AAAA,IACA;AAAA,IACA,UAAU,CAAC;AAAA,IACX,SAAS;AAAA,EACb,IAKI,CAAC,GACP;AACE;AAAA,MACI;AAAA,MACA,WAAW,SAAS;AAAA,MACpB,GAAG,OAAO,eAAe,OAAO;AAAA,MAChC;AAAA,MACA;AAAA,MACA,EAAE,SAAS,cAAc,GAAG,QAAQ;AAAA,IACxC;AAEA,SAAK,UAAU;AACf,SAAK,eAAe;AACpB,SAAK,WAAW;AAAA,EACpB;AACJ;","names":[]}

package/dist/errors/index.d.ts

@@ -0,0 +1,5 @@
+export { ApiError, BadRequestError, ForbiddenError, NotFoundError, RateLimitError, TimeoutError, UnauthorizedError } from './api_errors.js';
+export { DatabaseError } from './database_errors.js';
+export { ExternalDependencyError } from './external_dependency_error.js';
+export { BaseError } from './base_error.js';
+export { ConsumerError } from './consumer_errors.js';

package/dist/errors/index.js

@@ -0,0 +1,6 @@
+export * from "./api_errors";
+export * from "./database_errors";
+export * from "./external_dependency_error";
+export * from "./base_error";
+export * from "./consumer_errors";
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/index.ts"],"sourcesContent":["export * from \"./api_errors\";\nexport * from \"./database_errors\";\nexport * from \"./external_dependency_error\";\nexport * from \"./base_error\";\nexport * from \"./consumer_errors\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { handleError, handleResponse } from './api/response_handler.js';
+export { validateBody, validateParams, validateQuery } from './api/zod_utils.js';
+export { Logger } from './logger/logger.js';
+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 { 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';
+import 'zod';
+import 'winston';

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./api";
+export * from "./logger";
+export * from "./constants";
+export * from "./types";
+export * from "./errors";
+export * from "./database";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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":[]}

package/dist/logger/index.d.ts

@@ -0,0 +1,3 @@
+export { Logger } from './logger.js';
+import '../types/logger_config.js';
+import 'winston';

package/dist/logger/index.js

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

package/dist/logger/index.js.map

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

package/dist/logger/logger.d.ts

@@ -0,0 +1,52 @@
+import { ILoggerConfig } from '../types/logger_config.js';
+import 'winston';
+
+declare class 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
+     * Method to log for level - "info", this should not be called if it has been custom levels are
+     * set which does not include "info"
+     *
+     * @param {string|object} message - String or object to log.
+     */
+    static info(message: string | object): void;
+    /**
+     * @static
+     * Method to log for level - "debug", this should not be called if it has been custom levels are
+     * set which does not include "debug"
+     *
+     * @param {string|object} message - String or object to log.
+     */
+    static debug(message: string | object): void;
+    /**
+     * @static
+     * Method to log for level - "error", this should not be called if it has been custom levels are
+     * set which does not include "error"
+     *
+     * @param {string|object} error - String or object to log.
+     */
+    static error(error: string | object): void;
+    /**
+     * @static
+     * Method to log for level - "warn", this should not be called if it has been custom levels are
+     * set which does not include "warn"
+     *
+     * @param {string|object} message - String or object to log.
+     */
+    static warn(message: string | object): void;
+    /**
+     * @static
+     * Method to log for any level, which should be used to log all custom levels that may be added.
+     *
+     * @param {string|object} message - String or object to log.
+     */
+    static log(level: string, message: string | object): void;
+}
+
+export { Logger };

package/dist/logger/logger.js

@@ -0,0 +1,125 @@
+import winston from "winston";
+import * as SentryImport from "winston-transport-sentry-node";
+const Sentry = SentryImport.default;
+let logger;
+class 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(
+        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}`
+              )
+            ),
+            transports: [
+              new winston.transports.Console({
+                level: config.console?.level || "info"
+              }),
+              new Sentry({
+                sentry: {
+                  dsn: config.sentry?.dsn
+                },
+                level: config.sentry?.level || "error"
+              })
+            ]
+          },
+          config.winston
+        )
+      );
+    }
+  }
+  /**
+   * @static
+   * Method to log for level - "info", this should not be called if it has been custom levels are
+   * set which does not include "info"
+   *
+   * @param {string|object} message - String or object to log.
+   */
+  static info(message) {
+    if (typeof message === "string") {
+      logger?.info(message);
+    } else {
+      logger?.info(JSON.stringify(message));
+    }
+  }
+  /**
+   * @static
+   * Method to log for level - "debug", this should not be called if it has been custom levels are
+   * set which does not include "debug"
+   *
+   * @param {string|object} message - String or object to log.
+   */
+  static debug(message) {
+    if (typeof message === "string") {
+      logger?.debug(message);
+    } else {
+      logger?.debug(JSON.stringify(message));
+    }
+  }
+  /**
+   * @static
+   * Method to log for level - "error", this should not be called if it has been custom levels are
+   * set which does not include "error"
+   *
+   * @param {string|object} error - String or object to log.
+   */
+  static error(error) {
+    if (typeof error === "string") {
+      logger?.error(error);
+    } else {
+      logger?.error(
+        `${error.message ? `${error.message} : ` : ""}${JSON.stringify(error)}`
+      );
+    }
+  }
+  /**
+   * @static
+   * Method to log for level - "warn", this should not be called if it has been custom levels are
+   * set which does not include "warn"
+   *
+   * @param {string|object} message - String or object to log.
+   */
+  static warn(message) {
+    if (typeof message === "string") {
+      logger?.warn(message);
+    } else {
+      logger?.warn(JSON.stringify(message));
+    }
+  }
+  /**
+   * @static
+   * Method to log for any level, which should be used to log all custom levels that may be added.
+   *
+   * @param {string|object} message - String or object to log.
+   */
+  static log(level, message) {
+    if (typeof message === "string") {
+      logger?.log(level, message);
+    } else {
+      logger?.log(level, JSON.stringify(message));
+    }
+  }
+}
+export {
+  Logger
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger/logger.js.map

@@ -0,0 +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":[]}

package/dist/types/database.d.ts

@@ -0,0 +1,23 @@
+type WhereFilterOp = "<" | "<=" | "==" | "!=" | ">=" | ">" | "array-contains" | "in" | "not-in" | "array-contains-any";
+type OrderByDirection = "desc" | "asc";
+interface IQueryOrderOperationParams {
+    field: string;
+    order: OrderByDirection;
+}
+interface IDocumentConditionalModifications {
+    field: string;
+    value: string | number | boolean;
+    defaultValue: string | number | boolean;
+}
+interface IQueryFilterOperationParams {
+    field: string;
+    operator: WhereFilterOp;
+    value: string | number | boolean | string[] | number[];
+}
+interface IQueryFilterOperationParams {
+    field: string;
+    operator: WhereFilterOp;
+    value: string | number | boolean | string[] | number[];
+}
+
+export type { IDocumentConditionalModifications, IQueryFilterOperationParams, IQueryOrderOperationParams, OrderByDirection, WhereFilterOp };

package/dist/types/database.js

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

package/dist/types/database.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export { ILoggerConfig } from './logger_config.js';
+export { IDocumentConditionalModifications, IQueryFilterOperationParams, IQueryOrderOperationParams, OrderByDirection, WhereFilterOp } from './database.js';
+import 'winston';

package/dist/types/index.js

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

package/dist/types/index.js.map

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

package/dist/types/logger_config.d.ts

@@ -0,0 +1,18 @@
+import winston from 'winston';
+
+/**
+ * Logger configuration interface
+ */
+interface ILoggerConfig {
+    sentry?: {
+        dsn?: string;
+        level?: string;
+        environment?: string;
+    };
+    console?: {
+        level?: string;
+    };
+    winston?: winston.LoggerOptions;
+}
+
+export type { ILoggerConfig };

package/dist/types/logger_config.js

@@ -0,0 +1,2 @@
+import winston from "winston";
+//# sourceMappingURL=logger_config.js.map

package/dist/types/logger_config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/logger_config.ts"],"sourcesContent":["import winston from \"winston\";\n\n/**\n * Logger configuration interface\n */\nexport interface ILoggerConfig {\n    sentry?: {\n        dsn?: string;\n        level?: string;\n        environment?: string;\n    };\n    console?: {\n        level?: string;\n    };\n    winston?: winston.LoggerOptions;\n}\n"],"mappings":"AAAA,OAAO,aAAa;","names":[]}

package/package.json

@@ -0,0 +1,44 @@
+{
+    "name": "@polygonlabs/servercore",
+    "version": "0.0.0",
+    "publishConfig": {
+        "access": "public"
+    },
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "scripts": {
+        "tests": "echo 'Hello unit tests'",
+        "tests:integration": "echo 'Hello integration tests'",
+        "build": "tsup"
+    },
+    "files": [
+        "./dist/**",
+        "README.md",
+        "LICENSE"
+    ],
+    "type": "module",
+    "devDependencies": {
+        "@semantic-release/changelog": "^6.0.3",
+        "@semantic-release/commit-analyzer": "^13.0.1",
+        "@semantic-release/git": "^10.0.1",
+        "@semantic-release/npm": "^12.0.1",
+        "@semantic-release/release-notes-generator": "^14.0.3",
+        "@types/bun": "latest",
+        "semantic-release": "^24.2.3",
+        "tsup": "^8.4.0"
+    },
+    "peerDependencies": {
+        "typescript": "^5"
+    },
+    "dependencies": {
+        "winston": "^3.17.0",
+        "winston-transport-sentry-node": "^3.0.0",
+        "zod": "^3.24.2"
+    }
+}