@plyaz/types 1.7.8 → 1.7.10

package/dist/errors/constants/errors-codes.d.ts

@@ -0,0 +1,58 @@
+export declare const ERRORS_CODES: {
+    readonly validation_error: {
+        readonly status: 400;
+        readonly message: "errors.validation.error";
+    };
+    readonly unauthorized: {
+        readonly status: 401;
+        readonly message: "errors.auth.unauthorized";
+    };
+    readonly payment_failed: {
+        readonly status: 402;
+        readonly message: "errors.payment.failed";
+    };
+    readonly forbidden: {
+        readonly status: 403;
+        readonly message: "errors.auth.forbidden";
+    };
+    readonly not_found: {
+        readonly status: 404;
+        readonly message: "errors.common.notFound";
+    };
+    readonly method_not_allowed: {
+        readonly status: 405;
+        readonly message: "errors.common.methodNotAllowed";
+    };
+    readonly user_already_exists: {
+        readonly status: 409;
+        readonly message: "errors.user.alreadyExists";
+    };
+    readonly unprocessable_entity: {
+        readonly status: 422;
+        readonly message: "errors.validation.unprocessable";
+    };
+    readonly too_many_requests: {
+        readonly status: 429;
+        readonly message: "errors.rateLimit.tooManyRequests";
+    };
+    readonly internal_server_error: {
+        readonly status: 500;
+        readonly message: "errors.server.internal";
+    };
+    readonly not_implemented: {
+        readonly status: 501;
+        readonly message: "errors.server.notImplemented";
+    };
+    readonly bad_gateway: {
+        readonly status: 502;
+        readonly message: "errors.server.badGateway";
+    };
+    readonly service_unavailable: {
+        readonly status: 503;
+        readonly message: "errors.server.serviceUnavailable";
+    };
+    readonly gateway_timeout: {
+        readonly status: 504;
+        readonly message: "errors.server.gatewayTimeout";
+    };
+};

package/dist/errors/index.cjs

@@ -40,6 +40,67 @@ var ERROR_CATEGORY = {
   Validation: "validation"
 };
 
+// src/errors/constants/errors-codes.ts
+var ERRORS_CODES = {
+  validation_error: {
+    status: 400,
+    message: "errors.validation.error"
+  },
+  unauthorized: {
+    status: 401,
+    message: "errors.auth.unauthorized"
+  },
+  payment_failed: {
+    status: 402,
+    message: "errors.payment.failed"
+  },
+  forbidden: {
+    status: 403,
+    message: "errors.auth.forbidden"
+  },
+  not_found: {
+    status: 404,
+    message: "errors.common.notFound"
+  },
+  method_not_allowed: {
+    status: 405,
+    message: "errors.common.methodNotAllowed"
+  },
+  user_already_exists: {
+    status: 409,
+    message: "errors.user.alreadyExists"
+  },
+  unprocessable_entity: {
+    status: 422,
+    message: "errors.validation.unprocessable"
+  },
+  too_many_requests: {
+    status: 429,
+    message: "errors.rateLimit.tooManyRequests"
+  },
+  internal_server_error: {
+    status: 500,
+    message: "errors.server.internal"
+  },
+  not_implemented: {
+    status: 501,
+    message: "errors.server.notImplemented"
+  },
+  bad_gateway: {
+    status: 502,
+    message: "errors.server.badGateway"
+  },
+  service_unavailable: {
+    status: 503,
+    message: "errors.server.serviceUnavailable"
+  },
+  gateway_timeout: {
+    status: 504,
+    message: "errors.server.gatewayTimeout"
+  }
+};
+
+exports.ERRORS_CODES = ERRORS_CODES;
 exports.ERROR_CATEGORY = ERROR_CATEGORY;
 exports.ERROR_SEVERITY = ERROR_SEVERITY;
 exports.ERROR_TYPE = ERROR_TYPE;

package/dist/errors/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/errors/enums.ts"],"names":[],"mappings":";;;;;AAgBO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,eAAA,EAAiB,kBAAA;AAAA;AAAA,EAGjB,qBAAA,EAAuB,yBAAA;AAAA;AAAA,EAGvB,aAAA,EAAe,uBAAA;AAAA;AAAA,EAGf,kBAAA,EAAoB,4BAAA;AAAA;AAAA,EAGpB,YAAA,EAAc,gBAAA;AAAA;AAAA,EAGd,iBAAA,EAAmB;AACrB;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,GAAA,EAAK,KAAA;AAAA;AAAA,EAGL,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,IAAA,EAAM,MAAA;AAAA;AAAA,EAGN,QAAA,EAAU;AACZ;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,UAAA,EAAY,YAAA;AAAA;AAAA,EAGZ,UAAA,EAAY;AACd","file":"index.cjs","sourcesContent":["/**\n * Enum representing standardized error types used across the application.\n * @description These error types help classify different categories of errors such as validation issues and system-level failures.\n *\n * @example\n * ```typescript\n * import { ERROR_TYPE } from '@plyaz/types';\n *\n * const errorType = ERROR_TYPE.ValidationError; // 'validation.error'\n *\n * // Error handling example\n * if (error.type === ERROR_TYPE.RateLimitExceeded) {\n *   // Handle rate limiting\n * }\n * ```\n */\nexport const ERROR_TYPE = {\n  /** A general validation error (e.g., form or input errors). */\n  ValidationError: 'validation.error',\n\n  /** Error related to schema validation, such as JSON schema or API payload checks. */\n  SchemaValidationError: 'validation.schema.error',\n\n  /** Unhandled or unexpected system error. */\n  InternalError: 'system.internal.error',\n\n  /** System dependency is currently unavailable (e.g., database or external API). */\n  ServiceUnavailable: 'system.service.unavailable',\n\n  /** The request took too long and timed out. */\n  TimeoutError: 'system.timeout',\n\n  /** Too many requests made in a short period of time. */\n  RateLimitExceeded: 'system.rate.limit.exceeded',\n} as const;\n\n/**\n * Enum representing the severity level of an error.\n * @description This allows categorization of errors by their potential impact on the system or user.\n *\n * @example\n * ```typescript\n * import { ERROR_SEVERITY } from '@plyaz/types';\n *\n * const severity = ERROR_SEVERITY.Critical; // 'critical'\n * const shouldAlert = severity === ERROR_SEVERITY.High || severity === ERROR_SEVERITY.Critical;\n * ```\n */\nexport const ERROR_SEVERITY = {\n  /** Low severity - does not impact functionality significantly. */\n  Low: 'low',\n\n  /** Medium severity - minor disruption or warning. */\n  Medium: 'medium',\n\n  /** High severity - major issue requiring attention. */\n  High: 'high',\n\n  /** Critical severity - blocking or crashing issue. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Enum representing the category or origin of an error.\n * @description Useful for filtering or logging errors based on their source or nature.\n *\n * @example\n * ```typescript\n * import { ERROR_CATEGORY } from '@plyaz/types';\n *\n * const category = ERROR_CATEGORY.Blockchain; // 'blockchain'\n * const isClientError = category === ERROR_CATEGORY.Client;\n * ```\n */\nexport const ERROR_CATEGORY = {\n  /** Client-side error (e.g., invalid request). */\n  Client: 'client',\n\n  /** Server-side error (e.g., logic failure or exception). */\n  Server: 'server',\n\n  /** Network-related error (e.g., unreachable endpoint). */\n  Network: 'network',\n\n  /** Blockchain-related error (e.g., transaction failure, gas limit). */\n  Blockchain: 'blockchain',\n\n  // Validation-specific error (e.g., failed constraints or field errors).\n  Validation: 'validation',\n} as const;\n"]}
+{"version":3,"sources":["../../src/errors/enums.ts","../../src/errors/constants/errors-codes.ts"],"names":[],"mappings":";;;;;AAgBO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,eAAA,EAAiB,kBAAA;AAAA;AAAA,EAGjB,qBAAA,EAAuB,yBAAA;AAAA;AAAA,EAGvB,aAAA,EAAe,uBAAA;AAAA;AAAA,EAGf,kBAAA,EAAoB,4BAAA;AAAA;AAAA,EAGpB,YAAA,EAAc,gBAAA;AAAA;AAAA,EAGd,iBAAA,EAAmB;AACrB;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,GAAA,EAAK,KAAA;AAAA;AAAA,EAGL,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,IAAA,EAAM,MAAA;AAAA;AAAA,EAGN,QAAA,EAAU;AACZ;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,UAAA,EAAY,YAAA;AAAA;AAAA,EAGZ,UAAA,EAAY;AACd;;;ACzFO,IAAM,YAAA,GAAe;AAAA,EAC1B,gBAAA,EAAkB;AAAA,IAChB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,YAAA,EAAc;AAAA,IACZ,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,cAAA,EAAgB;AAAA,IACd,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,SAAA,EAAW;AAAA,IACT,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,SAAA,EAAW;AAAA,IACT,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,kBAAA,EAAoB;AAAA,IAClB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,mBAAA,EAAqB;AAAA,IACnB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,oBAAA,EAAsB;AAAA,IACpB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,iBAAA,EAAmB;AAAA,IACjB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,qBAAA,EAAuB;AAAA,IACrB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,eAAA,EAAiB;AAAA,IACf,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,WAAA,EAAa;AAAA,IACX,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,mBAAA,EAAqB;AAAA,IACnB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,eAAA,EAAiB;AAAA,IACf,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA;AAEb","file":"index.cjs","sourcesContent":["/**\n * Enum representing standardized error types used across the application.\n * @description These error types help classify different categories of errors such as validation issues and system-level failures.\n *\n * @example\n * ```typescript\n * import { ERROR_TYPE } from '@plyaz/types';\n *\n * const errorType = ERROR_TYPE.ValidationError; // 'validation.error'\n *\n * // Error handling example\n * if (error.type === ERROR_TYPE.RateLimitExceeded) {\n *   // Handle rate limiting\n * }\n * ```\n */\nexport const ERROR_TYPE = {\n  /** A general validation error (e.g., form or input errors). */\n  ValidationError: 'validation.error',\n\n  /** Error related to schema validation, such as JSON schema or API payload checks. */\n  SchemaValidationError: 'validation.schema.error',\n\n  /** Unhandled or unexpected system error. */\n  InternalError: 'system.internal.error',\n\n  /** System dependency is currently unavailable (e.g., database or external API). */\n  ServiceUnavailable: 'system.service.unavailable',\n\n  /** The request took too long and timed out. */\n  TimeoutError: 'system.timeout',\n\n  /** Too many requests made in a short period of time. */\n  RateLimitExceeded: 'system.rate.limit.exceeded',\n} as const;\n\n/**\n * Enum representing the severity level of an error.\n * @description This allows categorization of errors by their potential impact on the system or user.\n *\n * @example\n * ```typescript\n * import { ERROR_SEVERITY } from '@plyaz/types';\n *\n * const severity = ERROR_SEVERITY.Critical; // 'critical'\n * const shouldAlert = severity === ERROR_SEVERITY.High || severity === ERROR_SEVERITY.Critical;\n * ```\n */\nexport const ERROR_SEVERITY = {\n  /** Low severity - does not impact functionality significantly. */\n  Low: 'low',\n\n  /** Medium severity - minor disruption or warning. */\n  Medium: 'medium',\n\n  /** High severity - major issue requiring attention. */\n  High: 'high',\n\n  /** Critical severity - blocking or crashing issue. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Enum representing the category or origin of an error.\n * @description Useful for filtering or logging errors based on their source or nature.\n *\n * @example\n * ```typescript\n * import { ERROR_CATEGORY } from '@plyaz/types';\n *\n * const category = ERROR_CATEGORY.Blockchain; // 'blockchain'\n * const isClientError = category === ERROR_CATEGORY.Client;\n * ```\n */\nexport const ERROR_CATEGORY = {\n  /** Client-side error (e.g., invalid request). */\n  Client: 'client',\n\n  /** Server-side error (e.g., logic failure or exception). */\n  Server: 'server',\n\n  /** Network-related error (e.g., unreachable endpoint). */\n  Network: 'network',\n\n  /** Blockchain-related error (e.g., transaction failure, gas limit). */\n  Blockchain: 'blockchain',\n\n  // Validation-specific error (e.g., failed constraints or field errors).\n  Validation: 'validation',\n} as const;\n","export const ERRORS_CODES = {\n  validation_error: {\n    status: 400,\n    message: 'errors.validation.error',\n  },\n  unauthorized: {\n    status: 401,\n    message: 'errors.auth.unauthorized',\n  },\n  payment_failed: {\n    status: 402,\n    message: 'errors.payment.failed',\n  },\n  forbidden: {\n    status: 403,\n    message: 'errors.auth.forbidden',\n  },\n  not_found: {\n    status: 404,\n    message: 'errors.common.notFound',\n  },\n  method_not_allowed: {\n    status: 405,\n    message: 'errors.common.methodNotAllowed',\n  },\n  user_already_exists: {\n    status: 409,\n    message: 'errors.user.alreadyExists',\n  },\n  unprocessable_entity: {\n    status: 422,\n    message: 'errors.validation.unprocessable',\n  },\n  too_many_requests: {\n    status: 429,\n    message: 'errors.rateLimit.tooManyRequests',\n  },\n  internal_server_error: {\n    status: 500,\n    message: 'errors.server.internal',\n  },\n  not_implemented: {\n    status: 501,\n    message: 'errors.server.notImplemented',\n  },\n  bad_gateway: {\n    status: 502,\n    message: 'errors.server.badGateway',\n  },\n  service_unavailable: {\n    status: 503,\n    message: 'errors.server.serviceUnavailable',\n  },\n  gateway_timeout: {\n    status: 504,\n    message: 'errors.server.gatewayTimeout',\n  },\n} as const;\n"]}

package/dist/errors/index.d.ts

@@ -1,2 +1,3 @@
 export * from './enums';
 export type * from './types';
+export * from "./constants/errors-codes";

package/dist/errors/index.js

@@ -38,6 +38,66 @@ var ERROR_CATEGORY = {
   Validation: "validation"
 };
 
-export { ERROR_CATEGORY, ERROR_SEVERITY, ERROR_TYPE };
+// src/errors/constants/errors-codes.ts
+var ERRORS_CODES = {
+  validation_error: {
+    status: 400,
+    message: "errors.validation.error"
+  },
+  unauthorized: {
+    status: 401,
+    message: "errors.auth.unauthorized"
+  },
+  payment_failed: {
+    status: 402,
+    message: "errors.payment.failed"
+  },
+  forbidden: {
+    status: 403,
+    message: "errors.auth.forbidden"
+  },
+  not_found: {
+    status: 404,
+    message: "errors.common.notFound"
+  },
+  method_not_allowed: {
+    status: 405,
+    message: "errors.common.methodNotAllowed"
+  },
+  user_already_exists: {
+    status: 409,
+    message: "errors.user.alreadyExists"
+  },
+  unprocessable_entity: {
+    status: 422,
+    message: "errors.validation.unprocessable"
+  },
+  too_many_requests: {
+    status: 429,
+    message: "errors.rateLimit.tooManyRequests"
+  },
+  internal_server_error: {
+    status: 500,
+    message: "errors.server.internal"
+  },
+  not_implemented: {
+    status: 501,
+    message: "errors.server.notImplemented"
+  },
+  bad_gateway: {
+    status: 502,
+    message: "errors.server.badGateway"
+  },
+  service_unavailable: {
+    status: 503,
+    message: "errors.server.serviceUnavailable"
+  },
+  gateway_timeout: {
+    status: 504,
+    message: "errors.server.gatewayTimeout"
+  }
+};
+
+export { ERRORS_CODES, ERROR_CATEGORY, ERROR_SEVERITY, ERROR_TYPE };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/errors/enums.ts"],"names":[],"mappings":";;;AAgBO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,eAAA,EAAiB,kBAAA;AAAA;AAAA,EAGjB,qBAAA,EAAuB,yBAAA;AAAA;AAAA,EAGvB,aAAA,EAAe,uBAAA;AAAA;AAAA,EAGf,kBAAA,EAAoB,4BAAA;AAAA;AAAA,EAGpB,YAAA,EAAc,gBAAA;AAAA;AAAA,EAGd,iBAAA,EAAmB;AACrB;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,GAAA,EAAK,KAAA;AAAA;AAAA,EAGL,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,IAAA,EAAM,MAAA;AAAA;AAAA,EAGN,QAAA,EAAU;AACZ;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,UAAA,EAAY,YAAA;AAAA;AAAA,EAGZ,UAAA,EAAY;AACd","file":"index.js","sourcesContent":["/**\n * Enum representing standardized error types used across the application.\n * @description These error types help classify different categories of errors such as validation issues and system-level failures.\n *\n * @example\n * ```typescript\n * import { ERROR_TYPE } from '@plyaz/types';\n *\n * const errorType = ERROR_TYPE.ValidationError; // 'validation.error'\n *\n * // Error handling example\n * if (error.type === ERROR_TYPE.RateLimitExceeded) {\n *   // Handle rate limiting\n * }\n * ```\n */\nexport const ERROR_TYPE = {\n  /** A general validation error (e.g., form or input errors). */\n  ValidationError: 'validation.error',\n\n  /** Error related to schema validation, such as JSON schema or API payload checks. */\n  SchemaValidationError: 'validation.schema.error',\n\n  /** Unhandled or unexpected system error. */\n  InternalError: 'system.internal.error',\n\n  /** System dependency is currently unavailable (e.g., database or external API). */\n  ServiceUnavailable: 'system.service.unavailable',\n\n  /** The request took too long and timed out. */\n  TimeoutError: 'system.timeout',\n\n  /** Too many requests made in a short period of time. */\n  RateLimitExceeded: 'system.rate.limit.exceeded',\n} as const;\n\n/**\n * Enum representing the severity level of an error.\n * @description This allows categorization of errors by their potential impact on the system or user.\n *\n * @example\n * ```typescript\n * import { ERROR_SEVERITY } from '@plyaz/types';\n *\n * const severity = ERROR_SEVERITY.Critical; // 'critical'\n * const shouldAlert = severity === ERROR_SEVERITY.High || severity === ERROR_SEVERITY.Critical;\n * ```\n */\nexport const ERROR_SEVERITY = {\n  /** Low severity - does not impact functionality significantly. */\n  Low: 'low',\n\n  /** Medium severity - minor disruption or warning. */\n  Medium: 'medium',\n\n  /** High severity - major issue requiring attention. */\n  High: 'high',\n\n  /** Critical severity - blocking or crashing issue. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Enum representing the category or origin of an error.\n * @description Useful for filtering or logging errors based on their source or nature.\n *\n * @example\n * ```typescript\n * import { ERROR_CATEGORY } from '@plyaz/types';\n *\n * const category = ERROR_CATEGORY.Blockchain; // 'blockchain'\n * const isClientError = category === ERROR_CATEGORY.Client;\n * ```\n */\nexport const ERROR_CATEGORY = {\n  /** Client-side error (e.g., invalid request). */\n  Client: 'client',\n\n  /** Server-side error (e.g., logic failure or exception). */\n  Server: 'server',\n\n  /** Network-related error (e.g., unreachable endpoint). */\n  Network: 'network',\n\n  /** Blockchain-related error (e.g., transaction failure, gas limit). */\n  Blockchain: 'blockchain',\n\n  // Validation-specific error (e.g., failed constraints or field errors).\n  Validation: 'validation',\n} as const;\n"]}
+{"version":3,"sources":["../../src/errors/enums.ts","../../src/errors/constants/errors-codes.ts"],"names":[],"mappings":";;;AAgBO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,eAAA,EAAiB,kBAAA;AAAA;AAAA,EAGjB,qBAAA,EAAuB,yBAAA;AAAA;AAAA,EAGvB,aAAA,EAAe,uBAAA;AAAA;AAAA,EAGf,kBAAA,EAAoB,4BAAA;AAAA;AAAA,EAGpB,YAAA,EAAc,gBAAA;AAAA;AAAA,EAGd,iBAAA,EAAmB;AACrB;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,GAAA,EAAK,KAAA;AAAA;AAAA,EAGL,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,IAAA,EAAM,MAAA;AAAA;AAAA,EAGN,QAAA,EAAU;AACZ;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,UAAA,EAAY,YAAA;AAAA;AAAA,EAGZ,UAAA,EAAY;AACd;;;ACzFO,IAAM,YAAA,GAAe;AAAA,EAC1B,gBAAA,EAAkB;AAAA,IAChB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,YAAA,EAAc;AAAA,IACZ,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,cAAA,EAAgB;AAAA,IACd,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,SAAA,EAAW;AAAA,IACT,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,SAAA,EAAW;AAAA,IACT,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,kBAAA,EAAoB;AAAA,IAClB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,mBAAA,EAAqB;AAAA,IACnB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,oBAAA,EAAsB;AAAA,IACpB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,iBAAA,EAAmB;AAAA,IACjB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,qBAAA,EAAuB;AAAA,IACrB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,eAAA,EAAiB;AAAA,IACf,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,WAAA,EAAa;AAAA,IACX,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,mBAAA,EAAqB;AAAA,IACnB,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA,GACX;AAAA,EACA,eAAA,EAAiB;AAAA,IACf,MAAA,EAAQ,GAAA;AAAA,IACR,OAAA,EAAS;AAAA;AAEb","file":"index.js","sourcesContent":["/**\n * Enum representing standardized error types used across the application.\n * @description These error types help classify different categories of errors such as validation issues and system-level failures.\n *\n * @example\n * ```typescript\n * import { ERROR_TYPE } from '@plyaz/types';\n *\n * const errorType = ERROR_TYPE.ValidationError; // 'validation.error'\n *\n * // Error handling example\n * if (error.type === ERROR_TYPE.RateLimitExceeded) {\n *   // Handle rate limiting\n * }\n * ```\n */\nexport const ERROR_TYPE = {\n  /** A general validation error (e.g., form or input errors). */\n  ValidationError: 'validation.error',\n\n  /** Error related to schema validation, such as JSON schema or API payload checks. */\n  SchemaValidationError: 'validation.schema.error',\n\n  /** Unhandled or unexpected system error. */\n  InternalError: 'system.internal.error',\n\n  /** System dependency is currently unavailable (e.g., database or external API). */\n  ServiceUnavailable: 'system.service.unavailable',\n\n  /** The request took too long and timed out. */\n  TimeoutError: 'system.timeout',\n\n  /** Too many requests made in a short period of time. */\n  RateLimitExceeded: 'system.rate.limit.exceeded',\n} as const;\n\n/**\n * Enum representing the severity level of an error.\n * @description This allows categorization of errors by their potential impact on the system or user.\n *\n * @example\n * ```typescript\n * import { ERROR_SEVERITY } from '@plyaz/types';\n *\n * const severity = ERROR_SEVERITY.Critical; // 'critical'\n * const shouldAlert = severity === ERROR_SEVERITY.High || severity === ERROR_SEVERITY.Critical;\n * ```\n */\nexport const ERROR_SEVERITY = {\n  /** Low severity - does not impact functionality significantly. */\n  Low: 'low',\n\n  /** Medium severity - minor disruption or warning. */\n  Medium: 'medium',\n\n  /** High severity - major issue requiring attention. */\n  High: 'high',\n\n  /** Critical severity - blocking or crashing issue. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Enum representing the category or origin of an error.\n * @description Useful for filtering or logging errors based on their source or nature.\n *\n * @example\n * ```typescript\n * import { ERROR_CATEGORY } from '@plyaz/types';\n *\n * const category = ERROR_CATEGORY.Blockchain; // 'blockchain'\n * const isClientError = category === ERROR_CATEGORY.Client;\n * ```\n */\nexport const ERROR_CATEGORY = {\n  /** Client-side error (e.g., invalid request). */\n  Client: 'client',\n\n  /** Server-side error (e.g., logic failure or exception). */\n  Server: 'server',\n\n  /** Network-related error (e.g., unreachable endpoint). */\n  Network: 'network',\n\n  /** Blockchain-related error (e.g., transaction failure, gas limit). */\n  Blockchain: 'blockchain',\n\n  // Validation-specific error (e.g., failed constraints or field errors).\n  Validation: 'validation',\n} as const;\n","export const ERRORS_CODES = {\n  validation_error: {\n    status: 400,\n    message: 'errors.validation.error',\n  },\n  unauthorized: {\n    status: 401,\n    message: 'errors.auth.unauthorized',\n  },\n  payment_failed: {\n    status: 402,\n    message: 'errors.payment.failed',\n  },\n  forbidden: {\n    status: 403,\n    message: 'errors.auth.forbidden',\n  },\n  not_found: {\n    status: 404,\n    message: 'errors.common.notFound',\n  },\n  method_not_allowed: {\n    status: 405,\n    message: 'errors.common.methodNotAllowed',\n  },\n  user_already_exists: {\n    status: 409,\n    message: 'errors.user.alreadyExists',\n  },\n  unprocessable_entity: {\n    status: 422,\n    message: 'errors.validation.unprocessable',\n  },\n  too_many_requests: {\n    status: 429,\n    message: 'errors.rateLimit.tooManyRequests',\n  },\n  internal_server_error: {\n    status: 500,\n    message: 'errors.server.internal',\n  },\n  not_implemented: {\n    status: 501,\n    message: 'errors.server.notImplemented',\n  },\n  bad_gateway: {\n    status: 502,\n    message: 'errors.server.badGateway',\n  },\n  service_unavailable: {\n    status: 503,\n    message: 'errors.server.serviceUnavailable',\n  },\n  gateway_timeout: {\n    status: 504,\n    message: 'errors.server.gatewayTimeout',\n  },\n} as const;\n"]}

package/dist/errors/types.d.ts

@@ -1,4 +1,5 @@
 import type { WithStatusCode, WithErrorCode, WithMessage, WithCorrelationId, WithTimestamp, WithValidationError } from '../common/types';
+import type { ERRORS_CODES } from './constants/errors-codes';
 /**
  * Represents the structure of an error response returned by the application.
  * @template ErrorDetails - The type of the `errors` array, defaults to `ErrorDetailsList`.
@@ -42,3 +43,5 @@ export type ErrorDetail<ValueGiven, AllowedValues, Constraints> = WithValidation
  * @description A flexible list of error details that can contain string, number, or boolean values along with structured allowed values and constraints.
  */
 export type ErrorDetailsList = readonly ErrorDetail<string | number | boolean, Record<string, string>, Record<string, string>>[];
+export type ErrorCodeKey = keyof typeof ERRORS_CODES;
+export type ErrorCodeValue = typeof ERRORS_CODES[ErrorCodeKey];

package/dist/index.cjs

@@ -76,6 +76,66 @@ var ERROR_CATEGORY = {
   Validation: "validation"
 };
 
+// src/errors/constants/errors-codes.ts
+var ERRORS_CODES = {
+  validation_error: {
+    status: 400,
+    message: "errors.validation.error"
+  },
+  unauthorized: {
+    status: 401,
+    message: "errors.auth.unauthorized"
+  },
+  payment_failed: {
+    status: 402,
+    message: "errors.payment.failed"
+  },
+  forbidden: {
+    status: 403,
+    message: "errors.auth.forbidden"
+  },
+  not_found: {
+    status: 404,
+    message: "errors.common.notFound"
+  },
+  method_not_allowed: {
+    status: 405,
+    message: "errors.common.methodNotAllowed"
+  },
+  user_already_exists: {
+    status: 409,
+    message: "errors.user.alreadyExists"
+  },
+  unprocessable_entity: {
+    status: 422,
+    message: "errors.validation.unprocessable"
+  },
+  too_many_requests: {
+    status: 429,
+    message: "errors.rateLimit.tooManyRequests"
+  },
+  internal_server_error: {
+    status: 500,
+    message: "errors.server.internal"
+  },
+  not_implemented: {
+    status: 501,
+    message: "errors.server.notImplemented"
+  },
+  bad_gateway: {
+    status: 502,
+    message: "errors.server.badGateway"
+  },
+  service_unavailable: {
+    status: 503,
+    message: "errors.server.serviceUnavailable"
+  },
+  gateway_timeout: {
+    status: 504,
+    message: "errors.server.gatewayTimeout"
+  }
+};
+
 // src/events/enums.ts
 var EVENT_TYPE = {
   /** Application initialization event. */
@@ -130,6 +190,7 @@ var CHAIN_ID = {
 
 exports.AUTH_PROVIDER = AUTH_PROVIDER;
 exports.CHAIN_ID = CHAIN_ID;
+exports.ERRORS_CODES = ERRORS_CODES;
 exports.ERROR_CATEGORY = ERROR_CATEGORY;
 exports.ERROR_SEVERITY = ERROR_SEVERITY;
 exports.ERROR_TYPE = ERROR_TYPE;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/auth/enums.ts","../src/errors/enums.ts","../src/events/enums.ts","../src/web3/enums.ts"],"names":[],"mappings":";;;;;AAYO,IAAM,SAAA,GAAY;AAAA;AAAA,EAEvB,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,IAAA,EAAM,MAAA;AAAA;AAAA,EAGN,GAAA,EAAK,KAAA;AAAA;AAAA,EAGL,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,UAAA,EAAY;AACd;AAcO,IAAM,WAAA,GAAc;AAAA;AAAA,EAEzB,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,QAAA,EAAU,UAAA;AAAA;AAAA,EAGV,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,SAAA,EAAW,WAAA;AAAA;AAAA,EAGX,MAAA,EAAQ;AACV;AAcO,IAAM,aAAA,GAAgB;AAAA;AAAA,EAE3B,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,MAAA,EAAQ;AACV;;;AClEO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,eAAA,EAAiB,kBAAA;AAAA;AAAA,EAGjB,qBAAA,EAAuB,yBAAA;AAAA;AAAA,EAGvB,aAAA,EAAe,uBAAA;AAAA;AAAA,EAGf,kBAAA,EAAoB,4BAAA;AAAA;AAAA,EAGpB,YAAA,EAAc,gBAAA;AAAA;AAAA,EAGd,iBAAA,EAAmB;AACrB;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,GAAA,EAAK,KAAA;AAAA;AAAA,EAGL,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,IAAA,EAAM,MAAA;AAAA;AAAA,EAGN,QAAA,EAAU;AACZ;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,UAAA,EAAY,YAAA;AAAA;AAAA,EAGZ,UAAA,EAAY;AACd;;;AC9EO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,OAAA,EAAS;AACX;AAaO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,GAAA,EAAK,KAAA;AAAA;AAAA,EAEL,MAAA,EAAQ,QAAA;AAAA;AAAA,EAER,IAAA,EAAM,MAAA;AAAA;AAAA,EAEN,QAAA,EAAU;AACZ;AAkBO,IAAM,YAAA,GAAe;AAAA;AAAA,EAE1B,OAAA,EAAS,SAAA;AAAA;AAAA,EAET,UAAA,EAAY,YAAA;AAAA;AAAA,EAEZ,SAAA,EAAW,WAAA;AAAA;AAAA,EAEX,MAAA,EAAQ,QAAA;AAAA;AAAA,EAER,QAAA,EAAU;AACZ;;;ACpDO,IAAM,QAAA,GAAW;AAAA;AAAA,EAEtB,eAAA,EAAiB,CAAA;AAAA;AAAA,EAGjB,eAAA,EAAiB,QAAA;AAAA;AAAA,EAGjB,QAAA,EAAU,EAAA;AAAA;AAAA,EAGV,eAAA,EAAiB,QAAA;AAAA;AAAA,EAGjB,QAAA,EAAU,KAAA;AAAA;AAAA,EAGV,eAAA,EAAiB,MAAA;AAAA;AAAA,EAGjB,OAAA,EAAS,GAAA;AAAA;AAAA,EAGT,WAAA,EAAa,KAAA;AAAA;AAAA,EAGb,IAAA,EAAM,IAAA;AAAA;AAAA,EAGN,WAAA,EAAa;AACf","file":"index.cjs","sourcesContent":["/**\n * Enum representing the different roles a user can have within the system.\n * @description Roles are used to determine access levels, permissions, and user-specific experiences.\n *\n * @example\n * ```typescript\n * import { USER_ROLE } from '@plyaz/types';\n *\n * const userRole = USER_ROLE.Athlete; // 'athlete'\n * const isAdmin = userRole === USER_ROLE.Admin || userRole === USER_ROLE.SuperAdmin;\n * ```\n */\nexport const USER_ROLE = {\n  /** A user who is an athlete and participates in sports activities. */\n  Athlete: 'athlete',\n\n  /** A user who scouts and discovers talent. */\n  Scout: 'scout',\n\n  /** A user who acts as an agent representing athletes or clubs. */\n  Agent: 'agent',\n\n  /** A user representing a sports club or organization. */\n  Club: 'club',\n\n  /** A fan or supporter of athletes or clubs. */\n  Fan: 'fan',\n\n  /** A system administrator with access to management tools. */\n  Admin: 'admin',\n\n  /** A super admin with the highest level of access and control. */\n  SuperAdmin: 'super.admin',\n} as const;\n\n/**\n * Enum representing the current status of a user account.\n * @description Statuses are used to determine login availability, visibility, and user flow.\n *\n * @example\n * ```typescript\n * import { USER_STATUS } from '@plyaz/types';\n *\n * const isAccessible = status === USER_STATUS.Active;\n * const needsReview = status === USER_STATUS.Pending;\n * ```\n */\nexport const USER_STATUS = {\n  /** Active user with full access. */\n  Active: 'active',\n\n  /** Inactive user, typically not currently using the platform. */\n  Inactive: 'inactive',\n\n  /** User account is awaiting approval or completion of setup. */\n  Pending: 'pending',\n\n  /** User has been temporarily suspended due to policy violations or manual review. */\n  Suspended: 'suspended',\n\n  /** User has been permanently banned from the platform. */\n  Banned: 'banned',\n} as const;\n\n/**\n * Enum representing the supported authentication providers for user login.\n * @description Auth Providers allowed such as Email, Wallet, etc.\n *\n * @example\n * ```typescript\n * import { AUTH_PROVIDER } from '@plyaz/types';\n *\n * const provider = AUTH_PROVIDER.Wallet; // 'wallet'\n * const isWeb3Auth = provider === AUTH_PROVIDER.Wallet;\n * ```\n */\nexport const AUTH_PROVIDER = {\n  /** Authentication via email and password. */\n  Email: 'email',\n\n  /** Authentication via connected blockchain wallet. */\n  Wallet: 'wallet',\n} as const;\n","/**\n * Enum representing standardized error types used across the application.\n * @description These error types help classify different categories of errors such as validation issues and system-level failures.\n *\n * @example\n * ```typescript\n * import { ERROR_TYPE } from '@plyaz/types';\n *\n * const errorType = ERROR_TYPE.ValidationError; // 'validation.error'\n *\n * // Error handling example\n * if (error.type === ERROR_TYPE.RateLimitExceeded) {\n *   // Handle rate limiting\n * }\n * ```\n */\nexport const ERROR_TYPE = {\n  /** A general validation error (e.g., form or input errors). */\n  ValidationError: 'validation.error',\n\n  /** Error related to schema validation, such as JSON schema or API payload checks. */\n  SchemaValidationError: 'validation.schema.error',\n\n  /** Unhandled or unexpected system error. */\n  InternalError: 'system.internal.error',\n\n  /** System dependency is currently unavailable (e.g., database or external API). */\n  ServiceUnavailable: 'system.service.unavailable',\n\n  /** The request took too long and timed out. */\n  TimeoutError: 'system.timeout',\n\n  /** Too many requests made in a short period of time. */\n  RateLimitExceeded: 'system.rate.limit.exceeded',\n} as const;\n\n/**\n * Enum representing the severity level of an error.\n * @description This allows categorization of errors by their potential impact on the system or user.\n *\n * @example\n * ```typescript\n * import { ERROR_SEVERITY } from '@plyaz/types';\n *\n * const severity = ERROR_SEVERITY.Critical; // 'critical'\n * const shouldAlert = severity === ERROR_SEVERITY.High || severity === ERROR_SEVERITY.Critical;\n * ```\n */\nexport const ERROR_SEVERITY = {\n  /** Low severity - does not impact functionality significantly. */\n  Low: 'low',\n\n  /** Medium severity - minor disruption or warning. */\n  Medium: 'medium',\n\n  /** High severity - major issue requiring attention. */\n  High: 'high',\n\n  /** Critical severity - blocking or crashing issue. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Enum representing the category or origin of an error.\n * @description Useful for filtering or logging errors based on their source or nature.\n *\n * @example\n * ```typescript\n * import { ERROR_CATEGORY } from '@plyaz/types';\n *\n * const category = ERROR_CATEGORY.Blockchain; // 'blockchain'\n * const isClientError = category === ERROR_CATEGORY.Client;\n * ```\n */\nexport const ERROR_CATEGORY = {\n  /** Client-side error (e.g., invalid request). */\n  Client: 'client',\n\n  /** Server-side error (e.g., logic failure or exception). */\n  Server: 'server',\n\n  /** Network-related error (e.g., unreachable endpoint). */\n  Network: 'network',\n\n  /** Blockchain-related error (e.g., transaction failure, gas limit). */\n  Blockchain: 'blockchain',\n\n  // Validation-specific error (e.g., failed constraints or field errors).\n  Validation: 'validation',\n} as const;\n","/**\n * Enum representing the types of events in the application.\n * Uses dot notation for event naming convention.\n *\n * @example\n * ```typescript\n * import { EVENT_TYPE } from '@plyaz/types';\n *\n * const eventType = EVENT_TYPE.AppInit; // 'app.init'\n * ```\n */\nexport const EVENT_TYPE = {\n  /** Application initialization event. */\n  AppInit: 'app.init',\n} as const;\n\n/**\n * Const representing the priority levels for events.\n * Used to determine processing order and resource allocation.\n *\n * @example\n * ```typescript\n * import { EVENT_PRIORITY } from '@plyaz/types';\n *\n * const priority = EVENT_PRIORITY.High; // 'high'\n * ```\n */\nexport const EVENT_PRIORITY = {\n  /** Low priority event. */\n  Low: 'low',\n  /** Normal priority event. */\n  Normal: 'normal',\n  /** High priority event. */\n  High: 'high',\n  /** Critical priority event. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Const representing the status of an event.\n * Tracks the lifecycle of event processing from creation to completion.\n *\n * @example\n * ```typescript\n * import { EVENT_STATUS } from '@plyaz/types';\n *\n * const status = EVENT_STATUS.Processing; // 'processing'\n *\n * // Typical event lifecycle:\n * // Pending -> Processing -> Completed\n * // or\n * // Pending -> Processing -> Failed -> Retrying -> Processing -> Completed\n * ```\n */\nexport const EVENT_STATUS = {\n  /** Event is pending and has not started processing. */\n  Pending: 'pending',\n  /** Event is currently being processed. */\n  Processing: 'processing',\n  /** Event has been completed successfully. */\n  Completed: 'completed',\n  /** Event processing failed. */\n  Failed: 'failed',\n  /** Event is being retried after a failure. */\n  Retrying: 'retrying',\n} as const;\n","/**\n * Enum representing supported EVM-compatible blockchain networks by their numeric chain IDs.\n * @description These IDs are used to identify the specific network when interacting with wallets or smart contracts.\n * @see https://chainlist.org for reference chain IDs\n *\n * @example\n * ```typescript\n * import { CHAIN_ID } from '@plyaz/types';\n *\n * const chainId = CHAIN_ID.EthereumMainnet; // 1\n * const isTestnet = chainId === CHAIN_ID.EthereumSepolia || chainId === CHAIN_ID.PolygonAmoy;\n * ```\n */\nexport const CHAIN_ID = {\n  /** Ethereum Mainnet (Chain ID: 1). */\n  EthereumMainnet: 1,\n\n  /** Ethereum Sepolia Testnet (Chain ID: 11155111). */\n  EthereumSepolia: 11_155_111,\n\n  /** Optimism Mainnet (Chain ID: 10). */\n  Optimism: 10,\n\n  /** Optimism Sepolia Testnet (Chain ID: 11155420). */\n  OptimismSepolia: 11_155_420,\n\n  /** Arbitrum One Mainnet (Chain ID: 42161). */\n  Arbitrum: 42_161,\n\n  /** Arbitrum Sepolia Testnet (Chain ID: 421614). */\n  ArbitrumSepolia: 421_614,\n\n  /** Polygon Mainnet (Chain ID: 137). */\n  Polygon: 137,\n\n  /** Polygon Amoy Testnet (Chain ID: 80002). */\n  PolygonAmoy: 80_002,\n\n  /** Base Mainnet (Chain ID: 8453). */\n  Base: 8_453,\n\n  /** Base Sepolia Testnet (Chain ID: 84532). */\n  BaseSepolia: 84_532,\n} as const;\n"]}
+{"version":3,"sources":["../src/auth/enums.ts","../src/errors/enums.ts","../src/errors/constants/errors-codes.ts","../src/events/enums.ts","../src/web3/enums.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Enum representing the different roles a user can have within the system.\n * @description Roles are used to determine access levels, permissions, and user-specific experiences.\n *\n * @example\n * ```typescript\n * import { USER_ROLE } from '@plyaz/types';\n *\n * const userRole = USER_ROLE.Athlete; // 'athlete'\n * const isAdmin = userRole === USER_ROLE.Admin || userRole === USER_ROLE.SuperAdmin;\n * ```\n */\nexport const USER_ROLE = {\n  /** A user who is an athlete and participates in sports activities. */\n  Athlete: 'athlete',\n\n  /** A user who scouts and discovers talent. */\n  Scout: 'scout',\n\n  /** A user who acts as an agent representing athletes or clubs. */\n  Agent: 'agent',\n\n  /** A user representing a sports club or organization. */\n  Club: 'club',\n\n  /** A fan or supporter of athletes or clubs. */\n  Fan: 'fan',\n\n  /** A system administrator with access to management tools. */\n  Admin: 'admin',\n\n  /** A super admin with the highest level of access and control. */\n  SuperAdmin: 'super.admin',\n} as const;\n\n/**\n * Enum representing the current status of a user account.\n * @description Statuses are used to determine login availability, visibility, and user flow.\n *\n * @example\n * ```typescript\n * import { USER_STATUS } from '@plyaz/types';\n *\n * const isAccessible = status === USER_STATUS.Active;\n * const needsReview = status === USER_STATUS.Pending;\n * ```\n */\nexport const USER_STATUS = {\n  /** Active user with full access. */\n  Active: 'active',\n\n  /** Inactive user, typically not currently using the platform. */\n  Inactive: 'inactive',\n\n  /** User account is awaiting approval or completion of setup. */\n  Pending: 'pending',\n\n  /** User has been temporarily suspended due to policy violations or manual review. */\n  Suspended: 'suspended',\n\n  /** User has been permanently banned from the platform. */\n  Banned: 'banned',\n} as const;\n\n/**\n * Enum representing the supported authentication providers for user login.\n * @description Auth Providers allowed such as Email, Wallet, etc.\n *\n * @example\n * ```typescript\n * import { AUTH_PROVIDER } from '@plyaz/types';\n *\n * const provider = AUTH_PROVIDER.Wallet; // 'wallet'\n * const isWeb3Auth = provider === AUTH_PROVIDER.Wallet;\n * ```\n */\nexport const AUTH_PROVIDER = {\n  /** Authentication via email and password. */\n  Email: 'email',\n\n  /** Authentication via connected blockchain wallet. */\n  Wallet: 'wallet',\n} as const;\n","/**\n * Enum representing standardized error types used across the application.\n * @description These error types help classify different categories of errors such as validation issues and system-level failures.\n *\n * @example\n * ```typescript\n * import { ERROR_TYPE } from '@plyaz/types';\n *\n * const errorType = ERROR_TYPE.ValidationError; // 'validation.error'\n *\n * // Error handling example\n * if (error.type === ERROR_TYPE.RateLimitExceeded) {\n *   // Handle rate limiting\n * }\n * ```\n */\nexport const ERROR_TYPE = {\n  /** A general validation error (e.g., form or input errors). */\n  ValidationError: 'validation.error',\n\n  /** Error related to schema validation, such as JSON schema or API payload checks. */\n  SchemaValidationError: 'validation.schema.error',\n\n  /** Unhandled or unexpected system error. */\n  InternalError: 'system.internal.error',\n\n  /** System dependency is currently unavailable (e.g., database or external API). */\n  ServiceUnavailable: 'system.service.unavailable',\n\n  /** The request took too long and timed out. */\n  TimeoutError: 'system.timeout',\n\n  /** Too many requests made in a short period of time. */\n  RateLimitExceeded: 'system.rate.limit.exceeded',\n} as const;\n\n/**\n * Enum representing the severity level of an error.\n * @description This allows categorization of errors by their potential impact on the system or user.\n *\n * @example\n * ```typescript\n * import { ERROR_SEVERITY } from '@plyaz/types';\n *\n * const severity = ERROR_SEVERITY.Critical; // 'critical'\n * const shouldAlert = severity === ERROR_SEVERITY.High || severity === ERROR_SEVERITY.Critical;\n * ```\n */\nexport const ERROR_SEVERITY = {\n  /** Low severity - does not impact functionality significantly. */\n  Low: 'low',\n\n  /** Medium severity - minor disruption or warning. */\n  Medium: 'medium',\n\n  /** High severity - major issue requiring attention. */\n  High: 'high',\n\n  /** Critical severity - blocking or crashing issue. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Enum representing the category or origin of an error.\n * @description Useful for filtering or logging errors based on their source or nature.\n *\n * @example\n * ```typescript\n * import { ERROR_CATEGORY } from '@plyaz/types';\n *\n * const category = ERROR_CATEGORY.Blockchain; // 'blockchain'\n * const isClientError = category === ERROR_CATEGORY.Client;\n * ```\n */\nexport const ERROR_CATEGORY = {\n  /** Client-side error (e.g., invalid request). */\n  Client: 'client',\n\n  /** Server-side error (e.g., logic failure or exception). */\n  Server: 'server',\n\n  /** Network-related error (e.g., unreachable endpoint). */\n  Network: 'network',\n\n  /** Blockchain-related error (e.g., transaction failure, gas limit). */\n  Blockchain: 'blockchain',\n\n  // Validation-specific error (e.g., failed constraints or field errors).\n  Validation: 'validation',\n} as const;\n","export const ERRORS_CODES = {\n  validation_error: {\n    status: 400,\n    message: 'errors.validation.error',\n  },\n  unauthorized: {\n    status: 401,\n    message: 'errors.auth.unauthorized',\n  },\n  payment_failed: {\n    status: 402,\n    message: 'errors.payment.failed',\n  },\n  forbidden: {\n    status: 403,\n    message: 'errors.auth.forbidden',\n  },\n  not_found: {\n    status: 404,\n    message: 'errors.common.notFound',\n  },\n  method_not_allowed: {\n    status: 405,\n    message: 'errors.common.methodNotAllowed',\n  },\n  user_already_exists: {\n    status: 409,\n    message: 'errors.user.alreadyExists',\n  },\n  unprocessable_entity: {\n    status: 422,\n    message: 'errors.validation.unprocessable',\n  },\n  too_many_requests: {\n    status: 429,\n    message: 'errors.rateLimit.tooManyRequests',\n  },\n  internal_server_error: {\n    status: 500,\n    message: 'errors.server.internal',\n  },\n  not_implemented: {\n    status: 501,\n    message: 'errors.server.notImplemented',\n  },\n  bad_gateway: {\n    status: 502,\n    message: 'errors.server.badGateway',\n  },\n  service_unavailable: {\n    status: 503,\n    message: 'errors.server.serviceUnavailable',\n  },\n  gateway_timeout: {\n    status: 504,\n    message: 'errors.server.gatewayTimeout',\n  },\n} as const;\n","/**\n * Enum representing the types of events in the application.\n * Uses dot notation for event naming convention.\n *\n * @example\n * ```typescript\n * import { EVENT_TYPE } from '@plyaz/types';\n *\n * const eventType = EVENT_TYPE.AppInit; // 'app.init'\n * ```\n */\nexport const EVENT_TYPE = {\n  /** Application initialization event. */\n  AppInit: 'app.init',\n} as const;\n\n/**\n * Const representing the priority levels for events.\n * Used to determine processing order and resource allocation.\n *\n * @example\n * ```typescript\n * import { EVENT_PRIORITY } from '@plyaz/types';\n *\n * const priority = EVENT_PRIORITY.High; // 'high'\n * ```\n */\nexport const EVENT_PRIORITY = {\n  /** Low priority event. */\n  Low: 'low',\n  /** Normal priority event. */\n  Normal: 'normal',\n  /** High priority event. */\n  High: 'high',\n  /** Critical priority event. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Const representing the status of an event.\n * Tracks the lifecycle of event processing from creation to completion.\n *\n * @example\n * ```typescript\n * import { EVENT_STATUS } from '@plyaz/types';\n *\n * const status = EVENT_STATUS.Processing; // 'processing'\n *\n * // Typical event lifecycle:\n * // Pending -> Processing -> Completed\n * // or\n * // Pending -> Processing -> Failed -> Retrying -> Processing -> Completed\n * ```\n */\nexport const EVENT_STATUS = {\n  /** Event is pending and has not started processing. */\n  Pending: 'pending',\n  /** Event is currently being processed. */\n  Processing: 'processing',\n  /** Event has been completed successfully. */\n  Completed: 'completed',\n  /** Event processing failed. */\n  Failed: 'failed',\n  /** Event is being retried after a failure. */\n  Retrying: 'retrying',\n} as const;\n","/**\n * Enum representing supported EVM-compatible blockchain networks by their numeric chain IDs.\n * @description These IDs are used to identify the specific network when interacting with wallets or smart contracts.\n * @see https://chainlist.org for reference chain IDs\n *\n * @example\n * ```typescript\n * import { CHAIN_ID } from '@plyaz/types';\n *\n * const chainId = CHAIN_ID.EthereumMainnet; // 1\n * const isTestnet = chainId === CHAIN_ID.EthereumSepolia || chainId === CHAIN_ID.PolygonAmoy;\n * ```\n */\nexport const CHAIN_ID = {\n  /** Ethereum Mainnet (Chain ID: 1). */\n  EthereumMainnet: 1,\n\n  /** Ethereum Sepolia Testnet (Chain ID: 11155111). */\n  EthereumSepolia: 11_155_111,\n\n  /** Optimism Mainnet (Chain ID: 10). */\n  Optimism: 10,\n\n  /** Optimism Sepolia Testnet (Chain ID: 11155420). */\n  OptimismSepolia: 11_155_420,\n\n  /** Arbitrum One Mainnet (Chain ID: 42161). */\n  Arbitrum: 42_161,\n\n  /** Arbitrum Sepolia Testnet (Chain ID: 421614). */\n  ArbitrumSepolia: 421_614,\n\n  /** Polygon Mainnet (Chain ID: 137). */\n  Polygon: 137,\n\n  /** Polygon Amoy Testnet (Chain ID: 80002). */\n  PolygonAmoy: 80_002,\n\n  /** Base Mainnet (Chain ID: 8453). */\n  Base: 8_453,\n\n  /** Base Sepolia Testnet (Chain ID: 84532). */\n  BaseSepolia: 84_532,\n} as const;\n"]}

package/dist/index.js

@@ -74,6 +74,66 @@ var ERROR_CATEGORY = {
   Validation: "validation"
 };
 
+// src/errors/constants/errors-codes.ts
+var ERRORS_CODES = {
+  validation_error: {
+    status: 400,
+    message: "errors.validation.error"
+  },
+  unauthorized: {
+    status: 401,
+    message: "errors.auth.unauthorized"
+  },
+  payment_failed: {
+    status: 402,
+    message: "errors.payment.failed"
+  },
+  forbidden: {
+    status: 403,
+    message: "errors.auth.forbidden"
+  },
+  not_found: {
+    status: 404,
+    message: "errors.common.notFound"
+  },
+  method_not_allowed: {
+    status: 405,
+    message: "errors.common.methodNotAllowed"
+  },
+  user_already_exists: {
+    status: 409,
+    message: "errors.user.alreadyExists"
+  },
+  unprocessable_entity: {
+    status: 422,
+    message: "errors.validation.unprocessable"
+  },
+  too_many_requests: {
+    status: 429,
+    message: "errors.rateLimit.tooManyRequests"
+  },
+  internal_server_error: {
+    status: 500,
+    message: "errors.server.internal"
+  },
+  not_implemented: {
+    status: 501,
+    message: "errors.server.notImplemented"
+  },
+  bad_gateway: {
+    status: 502,
+    message: "errors.server.badGateway"
+  },
+  service_unavailable: {
+    status: 503,
+    message: "errors.server.serviceUnavailable"
+  },
+  gateway_timeout: {
+    status: 504,
+    message: "errors.server.gatewayTimeout"
+  }
+};
+
 // src/events/enums.ts
 var EVENT_TYPE = {
   /** Application initialization event. */
@@ -126,6 +186,6 @@ var CHAIN_ID = {
   BaseSepolia: 84532
 };
 
-export { AUTH_PROVIDER, CHAIN_ID, ERROR_CATEGORY, ERROR_SEVERITY, ERROR_TYPE, EVENT_PRIORITY, EVENT_STATUS, EVENT_TYPE, USER_ROLE, USER_STATUS };
+export { AUTH_PROVIDER, CHAIN_ID, ERRORS_CODES, ERROR_CATEGORY, ERROR_SEVERITY, ERROR_TYPE, EVENT_PRIORITY, EVENT_STATUS, EVENT_TYPE, USER_ROLE, USER_STATUS };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/auth/enums.ts","../src/errors/enums.ts","../src/events/enums.ts","../src/web3/enums.ts"],"names":[],"mappings":";;;AAYO,IAAM,SAAA,GAAY;AAAA;AAAA,EAEvB,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,IAAA,EAAM,MAAA;AAAA;AAAA,EAGN,GAAA,EAAK,KAAA;AAAA;AAAA,EAGL,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,UAAA,EAAY;AACd;AAcO,IAAM,WAAA,GAAc;AAAA;AAAA,EAEzB,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,QAAA,EAAU,UAAA;AAAA;AAAA,EAGV,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,SAAA,EAAW,WAAA;AAAA;AAAA,EAGX,MAAA,EAAQ;AACV;AAcO,IAAM,aAAA,GAAgB;AAAA;AAAA,EAE3B,KAAA,EAAO,OAAA;AAAA;AAAA,EAGP,MAAA,EAAQ;AACV;;;AClEO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,eAAA,EAAiB,kBAAA;AAAA;AAAA,EAGjB,qBAAA,EAAuB,yBAAA;AAAA;AAAA,EAGvB,aAAA,EAAe,uBAAA;AAAA;AAAA,EAGf,kBAAA,EAAoB,4BAAA;AAAA;AAAA,EAGpB,YAAA,EAAc,gBAAA;AAAA;AAAA,EAGd,iBAAA,EAAmB;AACrB;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,GAAA,EAAK,KAAA;AAAA;AAAA,EAGL,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,IAAA,EAAM,MAAA;AAAA;AAAA,EAGN,QAAA,EAAU;AACZ;AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,MAAA,EAAQ,QAAA;AAAA;AAAA,EAGR,OAAA,EAAS,SAAA;AAAA;AAAA,EAGT,UAAA,EAAY,YAAA;AAAA;AAAA,EAGZ,UAAA,EAAY;AACd;;;AC9EO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,OAAA,EAAS;AACX;AAaO,IAAM,cAAA,GAAiB;AAAA;AAAA,EAE5B,GAAA,EAAK,KAAA;AAAA;AAAA,EAEL,MAAA,EAAQ,QAAA;AAAA;AAAA,EAER,IAAA,EAAM,MAAA;AAAA;AAAA,EAEN,QAAA,EAAU;AACZ;AAkBO,IAAM,YAAA,GAAe;AAAA;AAAA,EAE1B,OAAA,EAAS,SAAA;AAAA;AAAA,EAET,UAAA,EAAY,YAAA;AAAA;AAAA,EAEZ,SAAA,EAAW,WAAA;AAAA;AAAA,EAEX,MAAA,EAAQ,QAAA;AAAA;AAAA,EAER,QAAA,EAAU;AACZ;;;ACpDO,IAAM,QAAA,GAAW;AAAA;AAAA,EAEtB,eAAA,EAAiB,CAAA;AAAA;AAAA,EAGjB,eAAA,EAAiB,QAAA;AAAA;AAAA,EAGjB,QAAA,EAAU,EAAA;AAAA;AAAA,EAGV,eAAA,EAAiB,QAAA;AAAA;AAAA,EAGjB,QAAA,EAAU,KAAA;AAAA;AAAA,EAGV,eAAA,EAAiB,MAAA;AAAA;AAAA,EAGjB,OAAA,EAAS,GAAA;AAAA;AAAA,EAGT,WAAA,EAAa,KAAA;AAAA;AAAA,EAGb,IAAA,EAAM,IAAA;AAAA;AAAA,EAGN,WAAA,EAAa;AACf","file":"index.js","sourcesContent":["/**\n * Enum representing the different roles a user can have within the system.\n * @description Roles are used to determine access levels, permissions, and user-specific experiences.\n *\n * @example\n * ```typescript\n * import { USER_ROLE } from '@plyaz/types';\n *\n * const userRole = USER_ROLE.Athlete; // 'athlete'\n * const isAdmin = userRole === USER_ROLE.Admin || userRole === USER_ROLE.SuperAdmin;\n * ```\n */\nexport const USER_ROLE = {\n  /** A user who is an athlete and participates in sports activities. */\n  Athlete: 'athlete',\n\n  /** A user who scouts and discovers talent. */\n  Scout: 'scout',\n\n  /** A user who acts as an agent representing athletes or clubs. */\n  Agent: 'agent',\n\n  /** A user representing a sports club or organization. */\n  Club: 'club',\n\n  /** A fan or supporter of athletes or clubs. */\n  Fan: 'fan',\n\n  /** A system administrator with access to management tools. */\n  Admin: 'admin',\n\n  /** A super admin with the highest level of access and control. */\n  SuperAdmin: 'super.admin',\n} as const;\n\n/**\n * Enum representing the current status of a user account.\n * @description Statuses are used to determine login availability, visibility, and user flow.\n *\n * @example\n * ```typescript\n * import { USER_STATUS } from '@plyaz/types';\n *\n * const isAccessible = status === USER_STATUS.Active;\n * const needsReview = status === USER_STATUS.Pending;\n * ```\n */\nexport const USER_STATUS = {\n  /** Active user with full access. */\n  Active: 'active',\n\n  /** Inactive user, typically not currently using the platform. */\n  Inactive: 'inactive',\n\n  /** User account is awaiting approval or completion of setup. */\n  Pending: 'pending',\n\n  /** User has been temporarily suspended due to policy violations or manual review. */\n  Suspended: 'suspended',\n\n  /** User has been permanently banned from the platform. */\n  Banned: 'banned',\n} as const;\n\n/**\n * Enum representing the supported authentication providers for user login.\n * @description Auth Providers allowed such as Email, Wallet, etc.\n *\n * @example\n * ```typescript\n * import { AUTH_PROVIDER } from '@plyaz/types';\n *\n * const provider = AUTH_PROVIDER.Wallet; // 'wallet'\n * const isWeb3Auth = provider === AUTH_PROVIDER.Wallet;\n * ```\n */\nexport const AUTH_PROVIDER = {\n  /** Authentication via email and password. */\n  Email: 'email',\n\n  /** Authentication via connected blockchain wallet. */\n  Wallet: 'wallet',\n} as const;\n","/**\n * Enum representing standardized error types used across the application.\n * @description These error types help classify different categories of errors such as validation issues and system-level failures.\n *\n * @example\n * ```typescript\n * import { ERROR_TYPE } from '@plyaz/types';\n *\n * const errorType = ERROR_TYPE.ValidationError; // 'validation.error'\n *\n * // Error handling example\n * if (error.type === ERROR_TYPE.RateLimitExceeded) {\n *   // Handle rate limiting\n * }\n * ```\n */\nexport const ERROR_TYPE = {\n  /** A general validation error (e.g., form or input errors). */\n  ValidationError: 'validation.error',\n\n  /** Error related to schema validation, such as JSON schema or API payload checks. */\n  SchemaValidationError: 'validation.schema.error',\n\n  /** Unhandled or unexpected system error. */\n  InternalError: 'system.internal.error',\n\n  /** System dependency is currently unavailable (e.g., database or external API). */\n  ServiceUnavailable: 'system.service.unavailable',\n\n  /** The request took too long and timed out. */\n  TimeoutError: 'system.timeout',\n\n  /** Too many requests made in a short period of time. */\n  RateLimitExceeded: 'system.rate.limit.exceeded',\n} as const;\n\n/**\n * Enum representing the severity level of an error.\n * @description This allows categorization of errors by their potential impact on the system or user.\n *\n * @example\n * ```typescript\n * import { ERROR_SEVERITY } from '@plyaz/types';\n *\n * const severity = ERROR_SEVERITY.Critical; // 'critical'\n * const shouldAlert = severity === ERROR_SEVERITY.High || severity === ERROR_SEVERITY.Critical;\n * ```\n */\nexport const ERROR_SEVERITY = {\n  /** Low severity - does not impact functionality significantly. */\n  Low: 'low',\n\n  /** Medium severity - minor disruption or warning. */\n  Medium: 'medium',\n\n  /** High severity - major issue requiring attention. */\n  High: 'high',\n\n  /** Critical severity - blocking or crashing issue. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Enum representing the category or origin of an error.\n * @description Useful for filtering or logging errors based on their source or nature.\n *\n * @example\n * ```typescript\n * import { ERROR_CATEGORY } from '@plyaz/types';\n *\n * const category = ERROR_CATEGORY.Blockchain; // 'blockchain'\n * const isClientError = category === ERROR_CATEGORY.Client;\n * ```\n */\nexport const ERROR_CATEGORY = {\n  /** Client-side error (e.g., invalid request). */\n  Client: 'client',\n\n  /** Server-side error (e.g., logic failure or exception). */\n  Server: 'server',\n\n  /** Network-related error (e.g., unreachable endpoint). */\n  Network: 'network',\n\n  /** Blockchain-related error (e.g., transaction failure, gas limit). */\n  Blockchain: 'blockchain',\n\n  // Validation-specific error (e.g., failed constraints or field errors).\n  Validation: 'validation',\n} as const;\n","/**\n * Enum representing the types of events in the application.\n * Uses dot notation for event naming convention.\n *\n * @example\n * ```typescript\n * import { EVENT_TYPE } from '@plyaz/types';\n *\n * const eventType = EVENT_TYPE.AppInit; // 'app.init'\n * ```\n */\nexport const EVENT_TYPE = {\n  /** Application initialization event. */\n  AppInit: 'app.init',\n} as const;\n\n/**\n * Const representing the priority levels for events.\n * Used to determine processing order and resource allocation.\n *\n * @example\n * ```typescript\n * import { EVENT_PRIORITY } from '@plyaz/types';\n *\n * const priority = EVENT_PRIORITY.High; // 'high'\n * ```\n */\nexport const EVENT_PRIORITY = {\n  /** Low priority event. */\n  Low: 'low',\n  /** Normal priority event. */\n  Normal: 'normal',\n  /** High priority event. */\n  High: 'high',\n  /** Critical priority event. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Const representing the status of an event.\n * Tracks the lifecycle of event processing from creation to completion.\n *\n * @example\n * ```typescript\n * import { EVENT_STATUS } from '@plyaz/types';\n *\n * const status = EVENT_STATUS.Processing; // 'processing'\n *\n * // Typical event lifecycle:\n * // Pending -> Processing -> Completed\n * // or\n * // Pending -> Processing -> Failed -> Retrying -> Processing -> Completed\n * ```\n */\nexport const EVENT_STATUS = {\n  /** Event is pending and has not started processing. */\n  Pending: 'pending',\n  /** Event is currently being processed. */\n  Processing: 'processing',\n  /** Event has been completed successfully. */\n  Completed: 'completed',\n  /** Event processing failed. */\n  Failed: 'failed',\n  /** Event is being retried after a failure. */\n  Retrying: 'retrying',\n} as const;\n","/**\n * Enum representing supported EVM-compatible blockchain networks by their numeric chain IDs.\n * @description These IDs are used to identify the specific network when interacting with wallets or smart contracts.\n * @see https://chainlist.org for reference chain IDs\n *\n * @example\n * ```typescript\n * import { CHAIN_ID } from '@plyaz/types';\n *\n * const chainId = CHAIN_ID.EthereumMainnet; // 1\n * const isTestnet = chainId === CHAIN_ID.EthereumSepolia || chainId === CHAIN_ID.PolygonAmoy;\n * ```\n */\nexport const CHAIN_ID = {\n  /** Ethereum Mainnet (Chain ID: 1). */\n  EthereumMainnet: 1,\n\n  /** Ethereum Sepolia Testnet (Chain ID: 11155111). */\n  EthereumSepolia: 11_155_111,\n\n  /** Optimism Mainnet (Chain ID: 10). */\n  Optimism: 10,\n\n  /** Optimism Sepolia Testnet (Chain ID: 11155420). */\n  OptimismSepolia: 11_155_420,\n\n  /** Arbitrum One Mainnet (Chain ID: 42161). */\n  Arbitrum: 42_161,\n\n  /** Arbitrum Sepolia Testnet (Chain ID: 421614). */\n  ArbitrumSepolia: 421_614,\n\n  /** Polygon Mainnet (Chain ID: 137). */\n  Polygon: 137,\n\n  /** Polygon Amoy Testnet (Chain ID: 80002). */\n  PolygonAmoy: 80_002,\n\n  /** Base Mainnet (Chain ID: 8453). */\n  Base: 8_453,\n\n  /** Base Sepolia Testnet (Chain ID: 84532). */\n  BaseSepolia: 84_532,\n} as const;\n"]}
+{"version":3,"sources":["../src/auth/enums.ts","../src/errors/enums.ts","../src/errors/constants/errors-codes.ts","../src/events/enums.ts","../src/web3/enums.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Enum representing the different roles a user can have within the system.\n * @description Roles are used to determine access levels, permissions, and user-specific experiences.\n *\n * @example\n * ```typescript\n * import { USER_ROLE } from '@plyaz/types';\n *\n * const userRole = USER_ROLE.Athlete; // 'athlete'\n * const isAdmin = userRole === USER_ROLE.Admin || userRole === USER_ROLE.SuperAdmin;\n * ```\n */\nexport const USER_ROLE = {\n  /** A user who is an athlete and participates in sports activities. */\n  Athlete: 'athlete',\n\n  /** A user who scouts and discovers talent. */\n  Scout: 'scout',\n\n  /** A user who acts as an agent representing athletes or clubs. */\n  Agent: 'agent',\n\n  /** A user representing a sports club or organization. */\n  Club: 'club',\n\n  /** A fan or supporter of athletes or clubs. */\n  Fan: 'fan',\n\n  /** A system administrator with access to management tools. */\n  Admin: 'admin',\n\n  /** A super admin with the highest level of access and control. */\n  SuperAdmin: 'super.admin',\n} as const;\n\n/**\n * Enum representing the current status of a user account.\n * @description Statuses are used to determine login availability, visibility, and user flow.\n *\n * @example\n * ```typescript\n * import { USER_STATUS } from '@plyaz/types';\n *\n * const isAccessible = status === USER_STATUS.Active;\n * const needsReview = status === USER_STATUS.Pending;\n * ```\n */\nexport const USER_STATUS = {\n  /** Active user with full access. */\n  Active: 'active',\n\n  /** Inactive user, typically not currently using the platform. */\n  Inactive: 'inactive',\n\n  /** User account is awaiting approval or completion of setup. */\n  Pending: 'pending',\n\n  /** User has been temporarily suspended due to policy violations or manual review. */\n  Suspended: 'suspended',\n\n  /** User has been permanently banned from the platform. */\n  Banned: 'banned',\n} as const;\n\n/**\n * Enum representing the supported authentication providers for user login.\n * @description Auth Providers allowed such as Email, Wallet, etc.\n *\n * @example\n * ```typescript\n * import { AUTH_PROVIDER } from '@plyaz/types';\n *\n * const provider = AUTH_PROVIDER.Wallet; // 'wallet'\n * const isWeb3Auth = provider === AUTH_PROVIDER.Wallet;\n * ```\n */\nexport const AUTH_PROVIDER = {\n  /** Authentication via email and password. */\n  Email: 'email',\n\n  /** Authentication via connected blockchain wallet. */\n  Wallet: 'wallet',\n} as const;\n","/**\n * Enum representing standardized error types used across the application.\n * @description These error types help classify different categories of errors such as validation issues and system-level failures.\n *\n * @example\n * ```typescript\n * import { ERROR_TYPE } from '@plyaz/types';\n *\n * const errorType = ERROR_TYPE.ValidationError; // 'validation.error'\n *\n * // Error handling example\n * if (error.type === ERROR_TYPE.RateLimitExceeded) {\n *   // Handle rate limiting\n * }\n * ```\n */\nexport const ERROR_TYPE = {\n  /** A general validation error (e.g., form or input errors). */\n  ValidationError: 'validation.error',\n\n  /** Error related to schema validation, such as JSON schema or API payload checks. */\n  SchemaValidationError: 'validation.schema.error',\n\n  /** Unhandled or unexpected system error. */\n  InternalError: 'system.internal.error',\n\n  /** System dependency is currently unavailable (e.g., database or external API). */\n  ServiceUnavailable: 'system.service.unavailable',\n\n  /** The request took too long and timed out. */\n  TimeoutError: 'system.timeout',\n\n  /** Too many requests made in a short period of time. */\n  RateLimitExceeded: 'system.rate.limit.exceeded',\n} as const;\n\n/**\n * Enum representing the severity level of an error.\n * @description This allows categorization of errors by their potential impact on the system or user.\n *\n * @example\n * ```typescript\n * import { ERROR_SEVERITY } from '@plyaz/types';\n *\n * const severity = ERROR_SEVERITY.Critical; // 'critical'\n * const shouldAlert = severity === ERROR_SEVERITY.High || severity === ERROR_SEVERITY.Critical;\n * ```\n */\nexport const ERROR_SEVERITY = {\n  /** Low severity - does not impact functionality significantly. */\n  Low: 'low',\n\n  /** Medium severity - minor disruption or warning. */\n  Medium: 'medium',\n\n  /** High severity - major issue requiring attention. */\n  High: 'high',\n\n  /** Critical severity - blocking or crashing issue. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Enum representing the category or origin of an error.\n * @description Useful for filtering or logging errors based on their source or nature.\n *\n * @example\n * ```typescript\n * import { ERROR_CATEGORY } from '@plyaz/types';\n *\n * const category = ERROR_CATEGORY.Blockchain; // 'blockchain'\n * const isClientError = category === ERROR_CATEGORY.Client;\n * ```\n */\nexport const ERROR_CATEGORY = {\n  /** Client-side error (e.g., invalid request). */\n  Client: 'client',\n\n  /** Server-side error (e.g., logic failure or exception). */\n  Server: 'server',\n\n  /** Network-related error (e.g., unreachable endpoint). */\n  Network: 'network',\n\n  /** Blockchain-related error (e.g., transaction failure, gas limit). */\n  Blockchain: 'blockchain',\n\n  // Validation-specific error (e.g., failed constraints or field errors).\n  Validation: 'validation',\n} as const;\n","export const ERRORS_CODES = {\n  validation_error: {\n    status: 400,\n    message: 'errors.validation.error',\n  },\n  unauthorized: {\n    status: 401,\n    message: 'errors.auth.unauthorized',\n  },\n  payment_failed: {\n    status: 402,\n    message: 'errors.payment.failed',\n  },\n  forbidden: {\n    status: 403,\n    message: 'errors.auth.forbidden',\n  },\n  not_found: {\n    status: 404,\n    message: 'errors.common.notFound',\n  },\n  method_not_allowed: {\n    status: 405,\n    message: 'errors.common.methodNotAllowed',\n  },\n  user_already_exists: {\n    status: 409,\n    message: 'errors.user.alreadyExists',\n  },\n  unprocessable_entity: {\n    status: 422,\n    message: 'errors.validation.unprocessable',\n  },\n  too_many_requests: {\n    status: 429,\n    message: 'errors.rateLimit.tooManyRequests',\n  },\n  internal_server_error: {\n    status: 500,\n    message: 'errors.server.internal',\n  },\n  not_implemented: {\n    status: 501,\n    message: 'errors.server.notImplemented',\n  },\n  bad_gateway: {\n    status: 502,\n    message: 'errors.server.badGateway',\n  },\n  service_unavailable: {\n    status: 503,\n    message: 'errors.server.serviceUnavailable',\n  },\n  gateway_timeout: {\n    status: 504,\n    message: 'errors.server.gatewayTimeout',\n  },\n} as const;\n","/**\n * Enum representing the types of events in the application.\n * Uses dot notation for event naming convention.\n *\n * @example\n * ```typescript\n * import { EVENT_TYPE } from '@plyaz/types';\n *\n * const eventType = EVENT_TYPE.AppInit; // 'app.init'\n * ```\n */\nexport const EVENT_TYPE = {\n  /** Application initialization event. */\n  AppInit: 'app.init',\n} as const;\n\n/**\n * Const representing the priority levels for events.\n * Used to determine processing order and resource allocation.\n *\n * @example\n * ```typescript\n * import { EVENT_PRIORITY } from '@plyaz/types';\n *\n * const priority = EVENT_PRIORITY.High; // 'high'\n * ```\n */\nexport const EVENT_PRIORITY = {\n  /** Low priority event. */\n  Low: 'low',\n  /** Normal priority event. */\n  Normal: 'normal',\n  /** High priority event. */\n  High: 'high',\n  /** Critical priority event. */\n  Critical: 'critical',\n} as const;\n\n/**\n * Const representing the status of an event.\n * Tracks the lifecycle of event processing from creation to completion.\n *\n * @example\n * ```typescript\n * import { EVENT_STATUS } from '@plyaz/types';\n *\n * const status = EVENT_STATUS.Processing; // 'processing'\n *\n * // Typical event lifecycle:\n * // Pending -> Processing -> Completed\n * // or\n * // Pending -> Processing -> Failed -> Retrying -> Processing -> Completed\n * ```\n */\nexport const EVENT_STATUS = {\n  /** Event is pending and has not started processing. */\n  Pending: 'pending',\n  /** Event is currently being processed. */\n  Processing: 'processing',\n  /** Event has been completed successfully. */\n  Completed: 'completed',\n  /** Event processing failed. */\n  Failed: 'failed',\n  /** Event is being retried after a failure. */\n  Retrying: 'retrying',\n} as const;\n","/**\n * Enum representing supported EVM-compatible blockchain networks by their numeric chain IDs.\n * @description These IDs are used to identify the specific network when interacting with wallets or smart contracts.\n * @see https://chainlist.org for reference chain IDs\n *\n * @example\n * ```typescript\n * import { CHAIN_ID } from '@plyaz/types';\n *\n * const chainId = CHAIN_ID.EthereumMainnet; // 1\n * const isTestnet = chainId === CHAIN_ID.EthereumSepolia || chainId === CHAIN_ID.PolygonAmoy;\n * ```\n */\nexport const CHAIN_ID = {\n  /** Ethereum Mainnet (Chain ID: 1). */\n  EthereumMainnet: 1,\n\n  /** Ethereum Sepolia Testnet (Chain ID: 11155111). */\n  EthereumSepolia: 11_155_111,\n\n  /** Optimism Mainnet (Chain ID: 10). */\n  Optimism: 10,\n\n  /** Optimism Sepolia Testnet (Chain ID: 11155420). */\n  OptimismSepolia: 11_155_420,\n\n  /** Arbitrum One Mainnet (Chain ID: 42161). */\n  Arbitrum: 42_161,\n\n  /** Arbitrum Sepolia Testnet (Chain ID: 421614). */\n  ArbitrumSepolia: 421_614,\n\n  /** Polygon Mainnet (Chain ID: 137). */\n  Polygon: 137,\n\n  /** Polygon Amoy Testnet (Chain ID: 80002). */\n  PolygonAmoy: 80_002,\n\n  /** Base Mainnet (Chain ID: 8453). */\n  Base: 8_453,\n\n  /** Base Sepolia Testnet (Chain ID: 84532). */\n  BaseSepolia: 84_532,\n} as const;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/types",
-  "version": "1.7.8",
+  "version": "1.7.10",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared TypeScript types and schema utilities for validation and parsing in the @playz ecosystem.",