90dc-core 1.10.20 → 1.11.1

package/README.md

@@ -1,2 +1,361 @@
 # 90dc-core
-A package that contains utils and interfaces used to create 90dc
+
+Shared utilities, models, and middleware for 90 Day Challenge microservices.
+
+## Version 1.11.0 - NEW Features ✨
+
+This version adds **configuration validation** and **error handling middleware** to improve code quality across all services.
+
+### What's New
+
+- ✅ **Type-safe configuration** with Zod validation
+- ✅ **Consistent error handling** across all services
+- ✅ **Request validation middleware** with Zod
+- ✅ **Comprehensive error classes** (404, 400, 401, 403, 500, etc.)
+- ✅ **Fail-fast validation** on startup
+
+---
+
+## Installation
+
+```bash
+npm install 90dc-core@latest zod
+```
+
+---
+
+## Quick Start
+
+### 1. Configuration Validation
+
+```typescript
+import { BaseConfigSchema, ConfigValidator } from '90dc-core';
+import { z } from 'zod';
+
+// Extend base config with service-specific settings
+const ConfigSchema = BaseConfigSchema.extend({
+  GOOGLE_CLIENT_ID: z.string().min(1),
+  APPLE_TEAM_ID: z.string().min(1),
+  MOLLIE_API_KEY: z.string().min(1)
+});
+
+// Create validated config (fails fast on startup if invalid)
+const config = new ConfigValidator(ConfigSchema);
+
+// Use with type safety
+const port = config.get('PORT'); // Type: number
+const jwtSecret = config.get('JWT_SECRET'); // Type: string
+const googleClientId = config.get('GOOGLE_CLIENT_ID'); // Type: string
+```
+
+### 2. Error Handling Middleware
+
+```typescript
+import Koa from 'koa';
+import { createErrorMiddleware } from '90dc-core';
+
+const app = new Koa();
+
+// Add error middleware FIRST
+app.use(createErrorMiddleware({
+  exposeErrorDetails: config.isDevelopment()
+}));
+
+// Add your routes
+app.use(router.routes());
+```
+
+### 3. Throwing Errors
+
+```typescript
+import {
+  NotFoundError,
+  ValidationError,
+  ForbiddenError,
+  AuthenticationError
+} from '90dc-core';
+
+class UserController {
+  async getUser(ctx: Context) {
+    const user = await User.findByPk(ctx.params.id);
+
+    if (!user) {
+      throw new NotFoundError('User'); // Returns 404 with consistent format
+    }
+
+    ctx.body = { user };
+  }
+
+  async createUser(ctx: Context) {
+    const existing = await User.findOne({ where: { email } });
+
+    if (existing) {
+      throw new ConflictError('Email already registered'); // Returns 409
+    }
+
+    // ... create user
+  }
+}
+```
+
+### 4. Request Validation
+
+```typescript
+import { validateRequest } from '90dc-core';
+import { z } from 'zod';
+
+const CreateUserSchema = z.object({
+  email: z.string().email(),
+  password: z.string().min(8),
+  firstName: z.string().min(1).max(100)
+});
+
+router.post('/users',
+  validateRequest({ body: CreateUserSchema }),
+  async (ctx) => {
+    // ctx.request.body is now validated and typed
+    const user = await User.create(ctx.request.body);
+    ctx.body = { user };
+  }
+);
+```
+
+---
+
+## Error Response Format
+
+All errors return consistent JSON:
+
+```json
+{
+  "success": false,
+  "error": {
+    "code": "NOT_FOUND",
+    "message": "User not found"
+  }
+}
+```
+
+With details for validation errors:
+
+```json
+{
+  "success": false,
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Request validation failed",
+    "details": {
+      "validationErrors": [
+        {
+          "path": "email",
+          "message": "Invalid email",
+          "code": "invalid_string"
+        }
+      ]
+    }
+  }
+}
+```
+
+---
+
+## Available Error Types
+
+```typescript
+import {
+  ValidationError,         // 400 - Invalid data
+  AuthenticationError,     // 401 - Not authenticated
+  ForbiddenError,          // 403 - No permission
+  NotFoundError,           // 404 - Resource not found
+  ConflictError,           // 409 - Resource conflict
+  UnprocessableEntityError,// 422 - Semantic error
+  RateLimitError,          // 429 - Too many requests
+  InternalServerError,     // 500 - Server error
+  ServiceUnavailableError, // 503 - Service down
+  DatabaseError,           // 500 - Database issue
+  ExternalAPIError,        // 502 - External API failed
+} from '90dc-core';
+```
+
+---
+
+## Common Config Schemas
+
+Reusable schemas for common configurations:
+
+```typescript
+import { CommonSchemas } from '90dc-core';
+
+const ConfigSchema = BaseConfigSchema
+  .extend(CommonSchemas.redis.shape)
+  .extend(CommonSchemas.jwt.shape)
+  .extend(CommonSchemas.googleOAuth.shape);
+```
+
+Available common schemas:
+- `CommonSchemas.database` - PostgreSQL configuration
+- `CommonSchemas.redis` - Redis configuration
+- `CommonSchemas.jwt` - JWT authentication
+- `CommonSchemas.googleOAuth` - Google OAuth
+- `CommonSchemas.appleOAuth` - Apple OAuth
+- `CommonSchemas.serviceUrls` - Inter-service URLs
+- `CommonSchemas.featureFlags` - Feature flags
+
+---
+
+## Full Documentation
+
+See **[USAGE_EXAMPLES.md](./USAGE_EXAMPLES.md)** for:
+- Complete usage examples
+- Migration guide from old code
+- Best practices
+- Testing examples
+- All available features
+
+---
+
+## Exports
+
+### Configuration
+```typescript
+import {
+  ConfigValidator,
+  BaseConfigSchema,
+  CommonSchemas,
+  createConfig,
+  ConfigurationError
+} from '90dc-core';
+```
+
+### Errors
+```typescript
+import {
+  AppError,
+  ValidationError,
+  AuthenticationError,
+  ForbiddenError,
+  NotFoundError,
+  ConflictError,
+  UnprocessableEntityError,
+  RateLimitError,
+  InternalServerError,
+  ServiceUnavailableError,
+  DatabaseError,
+  ExternalAPIError,
+  isAppError,
+  isOperationalError,
+  toAppError
+} from '90dc-core';
+```
+
+### Middleware
+```typescript
+import {
+  createErrorMiddleware,
+  validateRequest,
+  asyncHandler,
+  type ErrorMiddlewareConfig
+} from '90dc-core';
+```
+
+### Database Models
+```typescript
+import {
+  PersistedUser,
+  Program,
+  Workout,
+  Exercise,
+  Badge,
+  // ... many more
+} from '90dc-core';
+```
+
+### Utilities
+```typescript
+import {
+  AuthenticationUtil,
+  NotificationsUtil,
+  NotificationClient
+} from '90dc-core';
+```
+
+---
+
+## Migration Steps
+
+1. **Install dependencies**:
+   ```bash
+   npm install 90dc-core@latest zod
+   ```
+
+2. **Add config validation**:
+   ```typescript
+   import { BaseConfigSchema, ConfigValidator } from '90dc-core';
+   const config = new ConfigValidator(BaseConfigSchema);
+   ```
+
+3. **Add error middleware**:
+   ```typescript
+   import { createErrorMiddleware } from '90dc-core';
+   app.use(createErrorMiddleware());
+   ```
+
+4. **Replace error handling**:
+   ```typescript
+   // Before
+   if (!user) {
+     ctx.status = 404;
+     ctx.body = { message: 'Not found' };
+     return;
+   }
+
+   // After
+   import { NotFoundError } from '90dc-core';
+   if (!user) {
+     throw new NotFoundError('User');
+   }
+   ```
+
+5. **Add request validation**:
+   ```typescript
+   import { validateRequest } from '90dc-core';
+   router.post('/users',
+     validateRequest({ body: CreateUserSchema }),
+     handler
+   );
+   ```
+
+See **[USAGE_EXAMPLES.md](./USAGE_EXAMPLES.md)** for detailed migration guide.
+
+---
+
+## Building & Publishing
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Publish to npm
+npm run publish:build
+```
+
+---
+
+## Changelog
+
+See **[CHANGELOG.md](./CHANGELOG.md)** for version history.
+
+---
+
+## License
+
+ISC
+
+---
+
+## Contributing
+
+This is part of the 90 Day Challenge microservices architecture. See the main refactor plan for contribution guidelines.

package/dist/index.d.ts

@@ -23,4 +23,9 @@ export * from "./lib/dbmodels/nonconsprogram/UserNonConsumableProgram.js";
 export { AuthenticationUtil } from "./lib/utils/AuthenticationUtil.js";
 export { NotificationsUtil } from "./lib/utils/NotificationsUtil.js";
 export { NotificationClient } from "./lib/utils/NotificationClient.js";
+export { Log } from "./lib/utils/Logger.js";
+export { ConfigValidator, BaseConfigSchema, CommonSchemas, createConfig, ConfigurationError, type BaseConfig } from "./lib/config/ConfigValidator.js";
+export { AppError, ValidationError, AuthenticationError, ForbiddenError, NotFoundError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, ServiceUnavailableError, DatabaseError, ExternalAPIError, isAppError, isOperationalError, toAppError } from "./lib/Errors/AppError.js";
+export { createErrorMiddleware, type ErrorMiddlewareConfig } from "./lib/middlewares/ErrorMiddleware.js";
+export { RedisClient } from "./lib/classes/Redis.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AAGvD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,mCAAmC,CAAA;AACjD,cAAc,mCAAmC,CAAA;AACjD,cAAc,oCAAoC,CAAA;AAClD,cAAc,0CAA0C,CAAA;AACxD,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mCAAmC,CAAA;AACjD,cAAc,uDAAuD,CAAA;AACrE,cAAc,2EAA2E,CAAA;AACzF,cAAc,8DAA8D,CAAA;AAC5E,cAAc,iEAAiE,CAAA;AAC/E,cAAc,2DAA2D,CAAA;AAIzE,OAAO,EAAC,kBAAkB,EAAC,MAAM,mCAAmC,CAAA;AACpE,OAAO,EAAC,iBAAiB,EAAC,MAAM,kCAAkC,CAAA;AAClE,OAAO,EAAC,kBAAkB,EAAC,MAAM,mCAAmC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AAGvD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,mCAAmC,CAAA;AACjD,cAAc,mCAAmC,CAAA;AACjD,cAAc,oCAAoC,CAAA;AAClD,cAAc,0CAA0C,CAAA;AACxD,cAAc,oCAAoC,CAAA;AAClD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mCAAmC,CAAA;AACjD,cAAc,uDAAuD,CAAA;AACrE,cAAc,2EAA2E,CAAA;AACzF,cAAc,8DAA8D,CAAA;AAC5E,cAAc,iEAAiE,CAAA;AAC/E,cAAc,2DAA2D,CAAA;AAGzE,OAAO,EAAC,kBAAkB,EAAC,MAAM,mCAAmC,CAAA;AACpE,OAAO,EAAC,iBAAiB,EAAC,MAAM,kCAAkC,CAAA;AAClE,OAAO,EAAC,kBAAkB,EAAC,MAAM,mCAAmC,CAAA;AACpE,OAAO,EAAC,GAAG,EAAC,MAAM,uBAAuB,CAAA;AAGzC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,KAAK,UAAU,EAChB,MAAM,iCAAiC,CAAA;AAGxC,OAAO,EACL,QAAQ,EACR,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,UAAU,EACX,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,EAC3B,MAAM,sCAAsC,CAAA;AAG7C,OAAO,EAAC,WAAW,EAAC,MAAM,wBAAwB,CAAA"}

package/dist/index.js

@@ -26,5 +26,13 @@ export * from "./lib/dbmodels/nonconsprogram/UserNonConsumableProgram.js";
 export { AuthenticationUtil } from "./lib/utils/AuthenticationUtil.js";
 export { NotificationsUtil } from "./lib/utils/NotificationsUtil.js";
 export { NotificationClient } from "./lib/utils/NotificationClient.js";
+export { Log } from "./lib/utils/Logger.js";
+//Config
+export { ConfigValidator, BaseConfigSchema, CommonSchemas, createConfig, ConfigurationError } from "./lib/config/ConfigValidator.js";
+//Errors
+export { AppError, ValidationError, AuthenticationError, ForbiddenError, NotFoundError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, ServiceUnavailableError, DatabaseError, ExternalAPIError, isAppError, isOperationalError, toAppError } from "./lib/Errors/AppError.js";
+//Middlewares
+export { createErrorMiddleware } from "./lib/middlewares/ErrorMiddleware.js";
+export { RedisClient } from "./lib/classes/Redis.js";
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["//Interfaces\nexport * from \"./lib/models/ProgramInterfaces.js\";\nexport * from \"./lib/models/ExerciseInterfaces.js\";\nexport * from \"./lib/models/WorkoutInterfaces.js\";\nexport * from \"./lib/models/UserInterfaces.js\";\nexport * from \"./lib/models/NotificationInterfaces.js\";\n\n//DB Models\nexport * from \"./lib/dbmodels/UsersFriends.js\"\nexport * from \"./lib/dbmodels/PersistedUser.js\"\nexport * from \"./lib/dbmodels/UserBadges.js\"\nexport * from \"./lib/dbmodels/UserStreaks.js\"\nexport * from \"./lib/dbmodels/Badge.js\"\nexport * from \"./lib/dbmodels/program/Program.js\"\nexport * from \"./lib/dbmodels/program/Workout.js\"\nexport * from \"./lib/dbmodels/program/Exercise.js\"\nexport * from \"./lib/dbmodels/program/ExerciseModels.js\"\nexport * from \"./lib/dbmodels/program/Superset.js\"\nexport * from \"./lib/dbmodels/Subscription.js\"\nexport * from \"./lib/dbmodels/SubscriptionLog.js\"\nexport * from \"./lib/dbmodels/nonconsprogram/NonConsumableProgram.js\"\nexport * from \"./lib/dbmodels/nonconsprogram/TranslatedNonConsumableProgramWebContent.js\"\nexport * from \"./lib/dbmodels/nonconsprogram/TranslatedConsumableProgram.js\"\nexport * from \"./lib/dbmodels/nonconsprogram/NonConsumableProgramWebContent.js\"\nexport * from \"./lib/dbmodels/nonconsprogram/UserNonConsumableProgram.js\"\n\n\n//Utils\nexport {AuthenticationUtil} from \"./lib/utils/AuthenticationUtil.js\"\nexport {NotificationsUtil} from \"./lib/utils/NotificationsUtil.js\"\nexport {NotificationClient} from \"./lib/utils/NotificationClient.js\"\n"],"names":["AuthenticationUtil","NotificationsUtil","NotificationClient"],"mappings":"AAAA,YAAY;AACZ,cAAc,oCAAoC;AAClD,cAAc,qCAAqC;AACnD,cAAc,oCAAoC;AAClD,cAAc,iCAAiC;AAC/C,cAAc,yCAAyC;AAEvD,WAAW;AACX,cAAc,iCAAgC;AAC9C,cAAc,kCAAiC;AAC/C,cAAc,+BAA8B;AAC5C,cAAc,gCAA+B;AAC7C,cAAc,0BAAyB;AACvC,cAAc,oCAAmC;AACjD,cAAc,oCAAmC;AACjD,cAAc,qCAAoC;AAClD,cAAc,2CAA0C;AACxD,cAAc,qCAAoC;AAClD,cAAc,iCAAgC;AAC9C,cAAc,oCAAmC;AACjD,cAAc,wDAAuD;AACrE,cAAc,4EAA2E;AACzF,cAAc,+DAA8D;AAC5E,cAAc,kEAAiE;AAC/E,cAAc,4DAA2D;AAGzE,OAAO;AACP,SAAQA,kBAAkB,QAAO,oCAAmC;AACpE,SAAQC,iBAAiB,QAAO,mCAAkC;AAClE,SAAQC,kBAAkB,QAAO,oCAAmC"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["//Interfaces\nexport * from \"./lib/models/ProgramInterfaces.js\";\nexport * from \"./lib/models/ExerciseInterfaces.js\";\nexport * from \"./lib/models/WorkoutInterfaces.js\";\nexport * from \"./lib/models/UserInterfaces.js\";\nexport * from \"./lib/models/NotificationInterfaces.js\";\n\n//DB Models\nexport * from \"./lib/dbmodels/UsersFriends.js\"\nexport * from \"./lib/dbmodels/PersistedUser.js\"\nexport * from \"./lib/dbmodels/UserBadges.js\"\nexport * from \"./lib/dbmodels/UserStreaks.js\"\nexport * from \"./lib/dbmodels/Badge.js\"\nexport * from \"./lib/dbmodels/program/Program.js\"\nexport * from \"./lib/dbmodels/program/Workout.js\"\nexport * from \"./lib/dbmodels/program/Exercise.js\"\nexport * from \"./lib/dbmodels/program/ExerciseModels.js\"\nexport * from \"./lib/dbmodels/program/Superset.js\"\nexport * from \"./lib/dbmodels/Subscription.js\"\nexport * from \"./lib/dbmodels/SubscriptionLog.js\"\nexport * from \"./lib/dbmodels/nonconsprogram/NonConsumableProgram.js\"\nexport * from \"./lib/dbmodels/nonconsprogram/TranslatedNonConsumableProgramWebContent.js\"\nexport * from \"./lib/dbmodels/nonconsprogram/TranslatedConsumableProgram.js\"\nexport * from \"./lib/dbmodels/nonconsprogram/NonConsumableProgramWebContent.js\"\nexport * from \"./lib/dbmodels/nonconsprogram/UserNonConsumableProgram.js\"\n\n//Utils\nexport {AuthenticationUtil} from \"./lib/utils/AuthenticationUtil.js\"\nexport {NotificationsUtil} from \"./lib/utils/NotificationsUtil.js\"\nexport {NotificationClient} from \"./lib/utils/NotificationClient.js\"\nexport {Log} from \"./lib/utils/Logger.js\"\n\n//Config\nexport {\n  ConfigValidator,\n  BaseConfigSchema,\n  CommonSchemas,\n  createConfig,\n  ConfigurationError,\n  type BaseConfig\n} from \"./lib/config/ConfigValidator.js\"\n\n//Errors\nexport {\n  AppError,\n  ValidationError,\n  AuthenticationError,\n  ForbiddenError,\n  NotFoundError,\n  ConflictError,\n  UnprocessableEntityError,\n  RateLimitError,\n  InternalServerError,\n  ServiceUnavailableError,\n  DatabaseError,\n  ExternalAPIError,\n  isAppError,\n  isOperationalError,\n  toAppError\n} from \"./lib/Errors/AppError.js\"\n\n//Middlewares\nexport {\n  createErrorMiddleware,\n  type ErrorMiddlewareConfig\n} from \"./lib/middlewares/ErrorMiddleware.js\"\n\n\nexport {RedisClient} from \"./lib/classes/Redis.js\""],"names":["AuthenticationUtil","NotificationsUtil","NotificationClient","Log","ConfigValidator","BaseConfigSchema","CommonSchemas","createConfig","ConfigurationError","AppError","ValidationError","AuthenticationError","ForbiddenError","NotFoundError","ConflictError","UnprocessableEntityError","RateLimitError","InternalServerError","ServiceUnavailableError","DatabaseError","ExternalAPIError","isAppError","isOperationalError","toAppError","createErrorMiddleware","RedisClient"],"mappings":"AAAA,YAAY;AACZ,cAAc,oCAAoC;AAClD,cAAc,qCAAqC;AACnD,cAAc,oCAAoC;AAClD,cAAc,iCAAiC;AAC/C,cAAc,yCAAyC;AAEvD,WAAW;AACX,cAAc,iCAAgC;AAC9C,cAAc,kCAAiC;AAC/C,cAAc,+BAA8B;AAC5C,cAAc,gCAA+B;AAC7C,cAAc,0BAAyB;AACvC,cAAc,oCAAmC;AACjD,cAAc,oCAAmC;AACjD,cAAc,qCAAoC;AAClD,cAAc,2CAA0C;AACxD,cAAc,qCAAoC;AAClD,cAAc,iCAAgC;AAC9C,cAAc,oCAAmC;AACjD,cAAc,wDAAuD;AACrE,cAAc,4EAA2E;AACzF,cAAc,+DAA8D;AAC5E,cAAc,kEAAiE;AAC/E,cAAc,4DAA2D;AAEzE,OAAO;AACP,SAAQA,kBAAkB,QAAO,oCAAmC;AACpE,SAAQC,iBAAiB,QAAO,mCAAkC;AAClE,SAAQC,kBAAkB,QAAO,oCAAmC;AACpE,SAAQC,GAAG,QAAO,wBAAuB;AAEzC,QAAQ;AACR,SACEC,eAAe,EACfC,gBAAgB,EAChBC,aAAa,EACbC,YAAY,EACZC,kBAAkB,QAEb,kCAAiC;AAExC,QAAQ;AACR,SACEC,QAAQ,EACRC,eAAe,EACfC,mBAAmB,EACnBC,cAAc,EACdC,aAAa,EACbC,aAAa,EACbC,wBAAwB,EACxBC,cAAc,EACdC,mBAAmB,EACnBC,uBAAuB,EACvBC,aAAa,EACbC,gBAAgB,EAChBC,UAAU,EACVC,kBAAkB,EAClBC,UAAU,QACL,2BAA0B;AAEjC,aAAa;AACb,SACEC,qBAAqB,QAEhB,uCAAsC;AAG7C,SAAQC,WAAW,QAAO,yBAAwB"}

package/dist/lib/Errors/AppError.d.ts

@@ -0,0 +1,47 @@
+export declare class AppError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly details?: unknown | undefined;
+    readonly isOperational: boolean;
+    constructor(code: string, message: string, statusCode: number, details?: unknown | undefined, isOperational?: boolean);
+    toJSON(): {
+        error: Record<string, unknown>;
+    };
+}
+export declare class ValidationError extends AppError {
+    constructor(message: string, details?: unknown);
+}
+export declare class AuthenticationError extends AppError {
+    constructor(message?: string);
+}
+export declare class ForbiddenError extends AppError {
+    constructor(message?: string);
+}
+export declare class NotFoundError extends AppError {
+    constructor(resource?: string);
+}
+export declare class ConflictError extends AppError {
+    constructor(message: string, details?: unknown);
+}
+export declare class UnprocessableEntityError extends AppError {
+    constructor(message: string, details?: unknown);
+}
+export declare class RateLimitError extends AppError {
+    constructor(message?: string);
+}
+export declare class InternalServerError extends AppError {
+    constructor(message?: string, details?: unknown);
+}
+export declare class ServiceUnavailableError extends AppError {
+    constructor(service?: string);
+}
+export declare class DatabaseError extends AppError {
+    constructor(message: string, details?: unknown);
+}
+export declare class ExternalAPIError extends AppError {
+    constructor(service: string, message: string, statusCode?: number, details?: unknown);
+}
+export declare function isAppError(error: unknown): error is AppError;
+export declare function isOperationalError(error: unknown): boolean;
+export declare function toAppError(error: unknown): AppError;
+//# sourceMappingURL=AppError.d.ts.map

package/dist/lib/Errors/AppError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppError.d.ts","sourceRoot":"","sources":["../../../src/lib/Errors/AppError.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;aAIb,IAAI,EAAE,MAAM;aAEZ,UAAU,EAAE,MAAM;aAClB,OAAO,CAAC,EAAE,OAAO;IANrC,SAAgB,aAAa,EAAE,OAAO,CAAC;gBAGnB,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,OAAO,YAAA,EACjC,aAAa,UAAO;IAQxB,MAAM;;;CAYP;AAGD,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAGD,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,GAAE,MAAkC;CAGxD;AAGD,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,GAAE,MAA2B;CAGjD;AAGD,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,QAAQ,GAAE,MAAmB;CAG1C;AAGD,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAGD,qBAAa,wBAAyB,SAAQ,QAAQ;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAED,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,GAAE,MAAoD;CAG1E;AAGD,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,GAAE,MAAgC,EAAE,OAAO,CAAC,EAAE,OAAO;CAGzE;AAGD,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,OAAO,GAAE,MAAkB;CAGxC;AAGD,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAGD,qBAAa,gBAAiB,SAAQ,QAAQ;gBAE1C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,MAAY,EACxB,OAAO,CAAC,EAAE,OAAO;CASpB;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAGD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK1D;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAenD"}

package/dist/lib/Errors/AppError.js

@@ -0,0 +1,104 @@
+export class AppError extends Error {
+    code;
+    statusCode;
+    details;
+    isOperational;
+    constructor(code, message, statusCode, details, isOperational = true){
+        super(message), this.code = code, this.statusCode = statusCode, this.details = details;
+        this.name = new.target.name;
+        this.isOperational = isOperational;
+        Error.captureStackTrace?.(this, new.target);
+    }
+    toJSON() {
+        const error = {
+            code: this.code,
+            message: this.message
+        };
+        if (this.details !== undefined) {
+            error.details = this.details;
+        }
+        return {
+            error
+        };
+    }
+}
+export class ValidationError extends AppError {
+    constructor(message, details){
+        super('VALIDATION_ERROR', message, 400, details);
+    }
+}
+export class AuthenticationError extends AppError {
+    constructor(message = 'Authentication required'){
+        super('AUTHENTICATION_ERROR', message, 401);
+    }
+}
+export class ForbiddenError extends AppError {
+    constructor(message = 'Access forbidden'){
+        super('FORBIDDEN', message, 403);
+    }
+}
+export class NotFoundError extends AppError {
+    constructor(resource = 'Resource'){
+        super('NOT_FOUND', `${resource} not found`, 404);
+    }
+}
+export class ConflictError extends AppError {
+    constructor(message, details){
+        super('CONFLICT', message, 409, details);
+    }
+}
+export class UnprocessableEntityError extends AppError {
+    constructor(message, details){
+        super('UNPROCESSABLE_ENTITY', message, 422, details);
+    }
+}
+export class RateLimitError extends AppError {
+    constructor(message = 'Too many requests, please try again later'){
+        super('RATE_LIMIT_EXCEEDED', message, 429);
+    }
+}
+export class InternalServerError extends AppError {
+    constructor(message = 'Internal server error', details){
+        super('INTERNAL_ERROR', message, 500, details, false);
+    }
+}
+export class ServiceUnavailableError extends AppError {
+    constructor(service = 'Service'){
+        super('SERVICE_UNAVAILABLE', `${service} is temporarily unavailable`, 503);
+    }
+}
+export class DatabaseError extends AppError {
+    constructor(message, details){
+        super('DATABASE_ERROR', message, 500, details, false);
+    }
+}
+export class ExternalAPIError extends AppError {
+    constructor(service, message, statusCode = 502, details){
+        super('EXTERNAL_API_ERROR', `${service}: ${message}`, statusCode, details);
+    }
+}
+export function isAppError(error) {
+    return error instanceof AppError;
+}
+export function isOperationalError(error) {
+    if (error instanceof AppError) {
+        return error.isOperational;
+    }
+    return false;
+}
+export function toAppError(error) {
+    if (error instanceof AppError) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return new InternalServerError(error.message, {
+            originalError: error.name,
+            stack: error.stack
+        });
+    }
+    return new InternalServerError('An unexpected error occurred', {
+        error: String(error)
+    });
+}
+
+//# sourceMappingURL=AppError.js.map

package/dist/lib/Errors/AppError.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/Errors/AppError.ts"],"sourcesContent":["export class AppError extends Error {\n  public readonly isOperational: boolean;\n\n  constructor(\n      public readonly code: string,\n      message: string,\n      public readonly statusCode: number,\n      public readonly details?: unknown,\n      isOperational = true\n  ) {\n    super(message);\n    this.name = new.target.name;\n    this.isOperational = isOperational;\n    Error.captureStackTrace?.(this, new.target);\n  }\n\n  toJSON() {\n    const error: Record<string, unknown> = {\n      code: this.code,\n      message: this.message,\n    };\n\n    if (this.details !== undefined) {\n      error.details = this.details;\n    }\n\n    return { error };\n  }\n}\n\n\nexport class ValidationError extends AppError {\n  constructor(message: string, details?: unknown) {\n    super('VALIDATION_ERROR', message, 400, details);\n  }\n}\n\n\nexport class AuthenticationError extends AppError {\n  constructor(message: string = 'Authentication required') {\n    super('AUTHENTICATION_ERROR', message, 401);\n  }\n}\n\n\nexport class ForbiddenError extends AppError {\n  constructor(message: string = 'Access forbidden') {\n    super('FORBIDDEN', message, 403);\n  }\n}\n\n\nexport class NotFoundError extends AppError {\n  constructor(resource: string = 'Resource') {\n    super('NOT_FOUND', `${resource} not found`, 404);\n  }\n}\n\n\nexport class ConflictError extends AppError {\n  constructor(message: string, details?: unknown) {\n    super('CONFLICT', message, 409, details);\n  }\n}\n\n\nexport class UnprocessableEntityError extends AppError {\n  constructor(message: string, details?: unknown) {\n    super('UNPROCESSABLE_ENTITY', message, 422, details);\n  }\n}\n\nexport class RateLimitError extends AppError {\n  constructor(message: string = 'Too many requests, please try again later') {\n    super('RATE_LIMIT_EXCEEDED', message, 429);\n  }\n}\n\n\nexport class InternalServerError extends AppError {\n  constructor(message: string = 'Internal server error', details?: unknown) {\n    super('INTERNAL_ERROR', message, 500, details, false);\n  }\n}\n\n\nexport class ServiceUnavailableError extends AppError {\n  constructor(service: string = 'Service') {\n    super('SERVICE_UNAVAILABLE', `${service} is temporarily unavailable`, 503);\n  }\n}\n\n\nexport class DatabaseError extends AppError {\n  constructor(message: string, details?: unknown) {\n    super('DATABASE_ERROR', message, 500, details, false);\n  }\n}\n\n\nexport class ExternalAPIError extends AppError {\n  constructor(\n    service: string,\n    message: string,\n    statusCode: number = 502,\n    details?: unknown\n  ) {\n    super(\n      'EXTERNAL_API_ERROR',\n      `${service}: ${message}`,\n      statusCode,\n      details\n    );\n  }\n}\n\n\nexport function isAppError(error: unknown): error is AppError {\n  return error instanceof AppError;\n}\n\n\nexport function isOperationalError(error: unknown): boolean {\n  if (error instanceof AppError) {\n    return error.isOperational;\n  }\n  return false;\n}\n\n\nexport function toAppError(error: unknown): AppError {\n  if (error instanceof AppError) {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    return new InternalServerError(error.message, {\n      originalError: error.name,\n      stack: error.stack,\n    });\n  }\n\n  return new InternalServerError('An unexpected error occurred', {\n    error: String(error),\n  });\n}\n"],"names":["AppError","Error","isOperational","code","message","statusCode","details","name","captureStackTrace","toJSON","error","undefined","ValidationError","AuthenticationError","ForbiddenError","NotFoundError","resource","ConflictError","UnprocessableEntityError","RateLimitError","InternalServerError","ServiceUnavailableError","service","DatabaseError","ExternalAPIError","isAppError","isOperationalError","toAppError","originalError","stack","String"],"mappings":"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"}

package/dist/lib/classes/Redis.d.ts

@@ -0,0 +1,13 @@
+import { Redis } from "ioredis";
+export declare class RedisClient {
+    private static instance;
+    private constructor();
+    static getInstance(): Redis;
+    static get(key: string): Promise<string | null>;
+    static set(key: string, value: string, expirySeconds?: number): Promise<string>;
+    static del(key: string): Promise<number>;
+    static getJSON<T>(key: string): Promise<T | null>;
+    static setJSON(key: string, value: any, expirySeconds?: number): Promise<string>;
+    static waitForFill<T>(key: string, timeoutMs?: number, pollMs?: number): Promise<T | null>;
+}
+//# sourceMappingURL=Redis.d.ts.map

package/dist/lib/classes/Redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Redis.d.ts","sourceRoot":"","sources":["../../../src/lib/classes/Redis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMhC,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAQ;IAE/B,OAAO;WAEO,WAAW,IAAI,KAAK;WA2Bd,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;WAKxC,GAAG,CACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC;WAQE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;WAKjC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;WAK1C,OAAO,CACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG,EACV,aAAa,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC;WAKE,WAAW,CAAC,CAAC,EAC7B,GAAG,EAAE,MAAM,EACX,SAAS,SAAO,EAChB,MAAM,SAAM,GACb,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CASvB"}

package/dist/lib/classes/Redis.js

@@ -0,0 +1,63 @@
+import { Redis } from "ioredis";
+import { Log } from "../utils/Logger.js";
+const logger = Log.getInstance().extend("redis-client");
+export class RedisClient {
+    static instance;
+    constructor(){}
+    static getInstance() {
+        if (!RedisClient.instance) {
+            const REDIS_HOST = process.env.REDIS_HOST || "localhost";
+            const REDIS_PORT = process.env.REDIS_PORT || 6379;
+            const options = {
+                host: REDIS_HOST,
+                port: Number(REDIS_PORT),
+                maxRetriesPerRequest: null,
+                enableAutoPipelining: true,
+                connectTimeout: 5000,
+                lazyConnect: false
+            };
+            RedisClient.instance = new Redis(options);
+            RedisClient.instance.on("connect", ()=>{
+                logger.info("Connected to Redis");
+            });
+            RedisClient.instance.on("error", (err)=>{
+                logger.error("Redis error:", err);
+            });
+            logger.info(`Redis status: ${RedisClient.instance.status}`);
+        }
+        return RedisClient.instance;
+    }
+    static async get(key) {
+        const client = this.getInstance();
+        return client.get(key);
+    }
+    static async set(key, value, expirySeconds) {
+        const client = this.getInstance();
+        if (expirySeconds) {
+            return client.set(key, value, "EX", expirySeconds);
+        }
+        return client.set(key, value);
+    }
+    static async del(key) {
+        const client = this.getInstance();
+        return client.del(key);
+    }
+    static async getJSON(key) {
+        const raw = await this.get(key);
+        return raw ? JSON.parse(raw) : null;
+    }
+    static async setJSON(key, value, expirySeconds) {
+        return this.set(key, JSON.stringify(value), expirySeconds);
+    }
+    static async waitForFill(key, timeoutMs = 8000, pollMs = 150) {
+        const start = Date.now();
+        while(Date.now() - start < timeoutMs){
+            const v = await this.getJSON(key);
+            if (v) return v;
+            await new Promise((r)=>setTimeout(r, pollMs));
+        }
+        return null;
+    }
+}
+
+//# sourceMappingURL=Redis.js.map

package/dist/lib/classes/Redis.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/classes/Redis.ts"],"sourcesContent":["import { Redis } from \"ioredis\";\nimport type { RedisOptions } from \"ioredis\";\nimport {Log} from \"../utils/Logger.js\";\n\nconst logger: Log = Log.getInstance().extend(\"redis-client\");\n\nexport class RedisClient {\n    private static instance: Redis;\n\n    private constructor() {}\n\n    public static getInstance(): Redis {\n        if (!RedisClient.instance) {\n            const REDIS_HOST = process.env.REDIS_HOST || \"localhost\";\n            const REDIS_PORT = process.env.REDIS_PORT || 6379;\n\n            const options: RedisOptions = {\n                host: REDIS_HOST,\n                port: Number(REDIS_PORT),\n                maxRetriesPerRequest: null,\n                enableAutoPipelining: true,\n                connectTimeout: 5000,\n                lazyConnect: false,\n            };\n\n            RedisClient.instance = new Redis(options);\n\n            RedisClient.instance.on(\"connect\", () => {\n                logger.info(\"Connected to Redis\");\n            });\n            RedisClient.instance.on(\"error\", (err) => {\n                logger.error(\"Redis error:\", err);\n            });\n            logger.info(`Redis status: ${RedisClient.instance.status}`);\n        }\n        return RedisClient.instance;\n    }\n\n    public static async get(key: string): Promise<string | null> {\n        const client = this.getInstance();\n        return client.get(key);\n    }\n\n    public static async set(\n        key: string,\n        value: string,\n        expirySeconds?: number,\n    ): Promise<string> {\n        const client = this.getInstance();\n        if (expirySeconds) {\n            return client.set(key, value, \"EX\", expirySeconds);\n        }\n        return client.set(key, value);\n    }\n\n    public static async del(key: string): Promise<number> {\n        const client = this.getInstance();\n        return client.del(key);\n    }\n\n    public static async getJSON<T>(key: string): Promise<T | null> {\n        const raw = await this.get(key);\n        return raw ? (JSON.parse(raw) as T) : null;\n    }\n\n    public static async setJSON(\n        key: string,\n        value: any,\n        expirySeconds?: number,\n    ): Promise<string> {\n        return this.set(key, JSON.stringify(value), expirySeconds);\n    }\n\n\n    public static async waitForFill<T>(\n        key: string,\n        timeoutMs = 8000,\n        pollMs = 150,\n    ): Promise<T | null> {\n        const start = Date.now();\n        while (Date.now() - start < timeoutMs) {\n            const v = await this.getJSON<T>(key);\n            if (v) return v;\n            await new Promise((r) => setTimeout(r, pollMs));\n        }\n        return null;\n    }\n}"],"names":["Redis","Log","logger","getInstance","extend","RedisClient","instance","REDIS_HOST","process","env","REDIS_PORT","options","host","port","Number","maxRetriesPerRequest","enableAutoPipelining","connectTimeout","lazyConnect","on","info","err","error","status","get","key","client","set","value","expirySeconds","del","getJSON","raw","JSON","parse","setJSON","stringify","waitForFill","timeoutMs","pollMs","start","Date","now","v","Promise","r","setTimeout"],"mappings":"AAAA,SAASA,KAAK,QAAQ,UAAU;AAEhC,SAAQC,GAAG,QAAO,qBAAqB;AAEvC,MAAMC,SAAcD,IAAIE,WAAW,GAAGC,MAAM,CAAC;AAE7C,OAAO,MAAMC;IACT,OAAeC,SAAgB;IAE/B,aAAsB,CAAC;IAEvB,OAAcH,cAAqB;QAC/B,IAAI,CAACE,YAAYC,QAAQ,EAAE;YACvB,MAAMC,aAAaC,QAAQC,GAAG,CAACF,UAAU,IAAI;YAC7C,MAAMG,aAAaF,QAAQC,GAAG,CAACC,UAAU,IAAI;YAE7C,MAAMC,UAAwB;gBAC1BC,MAAML;gBACNM,MAAMC,OAAOJ;gBACbK,sBAAsB;gBACtBC,sBAAsB;gBACtBC,gBAAgB;gBAChBC,aAAa;YACjB;YAEAb,YAAYC,QAAQ,GAAG,IAAIN,MAAMW;YAEjCN,YAAYC,QAAQ,CAACa,EAAE,CAAC,WAAW;gBAC/BjB,OAAOkB,IAAI,CAAC;YAChB;YACAf,YAAYC,QAAQ,CAACa,EAAE,CAAC,SAAS,CAACE;gBAC9BnB,OAAOoB,KAAK,CAAC,gBAAgBD;YACjC;YACAnB,OAAOkB,IAAI,CAAC,CAAC,cAAc,EAAEf,YAAYC,QAAQ,CAACiB,MAAM,EAAE;QAC9D;QACA,OAAOlB,YAAYC,QAAQ;IAC/B;IAEA,aAAoBkB,IAAIC,GAAW,EAA0B;QACzD,MAAMC,SAAS,IAAI,CAACvB,WAAW;QAC/B,OAAOuB,OAAOF,GAAG,CAACC;IACtB;IAEA,aAAoBE,IAChBF,GAAW,EACXG,KAAa,EACbC,aAAsB,EACP;QACf,MAAMH,SAAS,IAAI,CAACvB,WAAW;QAC/B,IAAI0B,eAAe;YACf,OAAOH,OAAOC,GAAG,CAACF,KAAKG,OAAO,MAAMC;QACxC;QACA,OAAOH,OAAOC,GAAG,CAACF,KAAKG;IAC3B;IAEA,aAAoBE,IAAIL,GAAW,EAAmB;QAClD,MAAMC,SAAS,IAAI,CAACvB,WAAW;QAC/B,OAAOuB,OAAOI,GAAG,CAACL;IACtB;IAEA,aAAoBM,QAAWN,GAAW,EAAqB;QAC3D,MAAMO,MAAM,MAAM,IAAI,CAACR,GAAG,CAACC;QAC3B,OAAOO,MAAOC,KAAKC,KAAK,CAACF,OAAa;IAC1C;IAEA,aAAoBG,QAChBV,GAAW,EACXG,KAAU,EACVC,aAAsB,EACP;QACf,OAAO,IAAI,CAACF,GAAG,CAACF,KAAKQ,KAAKG,SAAS,CAACR,QAAQC;IAChD;IAGA,aAAoBQ,YAChBZ,GAAW,EACXa,YAAY,IAAI,EAChBC,SAAS,GAAG,EACK;QACjB,MAAMC,QAAQC,KAAKC,GAAG;QACtB,MAAOD,KAAKC,GAAG,KAAKF,QAAQF,UAAW;YACnC,MAAMK,IAAI,MAAM,IAAI,CAACZ,OAAO,CAAIN;YAChC,IAAIkB,GAAG,OAAOA;YACd,MAAM,IAAIC,QAAQ,CAACC,IAAMC,WAAWD,GAAGN;QAC3C;QACA,OAAO;IACX;AACJ"}