@xbg.solutions/backend-core 1.0.0

package/lib/core/src/middleware/validation.middleware.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Validation Middleware
+ * Input validation and sanitization
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validate = validate;
+exports.sanitizeBody = sanitizeBody;
+exports.validatePagination = validatePagination;
+exports.validateUUID = validateUUID;
+const express_validator_1 = require("express-validator");
+const utils_logger_1 = require("@xbg/utils-logger");
+/**
+ * Validation middleware factory
+ * Runs express-validator chains and returns errors
+ */
+function validate(validations) {
+    return async (req, res, next) => {
+        // Run all validations
+        await Promise.all(validations.map((validation) => validation.run(req)));
+        // Check for errors
+        const errors = (0, express_validator_1.validationResult)(req);
+        if (!errors.isEmpty()) {
+            utils_logger_1.logger.warn('Validation failed', {
+                path: req.path,
+                errors: errors.array(),
+            });
+            return res.status(400).json({
+                success: false,
+                error: {
+                    code: 'VALIDATION_ERROR',
+                    message: 'Input validation failed',
+                    details: errors.array().map((error) => ({
+                        field: error.type === 'field' ? error.path : undefined,
+                        message: error.msg,
+                    })),
+                },
+            });
+        }
+        return next();
+    };
+}
+/**
+ * Sanitize request body
+ * Remove potentially dangerous characters
+ */
+function sanitizeBody() {
+    return (req, _res, next) => {
+        if (req.body && typeof req.body === 'object') {
+            req.body = sanitizeObject(req.body);
+        }
+        return next();
+    };
+}
+/**
+ * Recursively sanitize object
+ */
+function sanitizeObject(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map(sanitizeObject);
+    }
+    if (obj !== null && typeof obj === 'object') {
+        const sanitized = {};
+        for (const [key, value] of Object.entries(obj)) {
+            sanitized[key] = sanitizeObject(value);
+        }
+        return sanitized;
+    }
+    if (typeof obj === 'string') {
+        return sanitizeString(obj);
+    }
+    return obj;
+}
+/**
+ * Sanitize string value
+ */
+function sanitizeString(str) {
+    // Remove null bytes
+    str = str.replace(/\0/g, '');
+    return str.trim();
+}
+/**
+ * Validate pagination parameters
+ */
+function validatePagination() {
+    return (req, res, next) => {
+        if (req.query.page) {
+            const page = parseInt(req.query.page);
+            if (isNaN(page) || page < 1) {
+                return res.status(400).json({
+                    success: false,
+                    error: {
+                        code: 'INVALID_PARAMETER',
+                        message: 'Page must be a positive integer',
+                    },
+                });
+            }
+        }
+        if (req.query.pageSize) {
+            const pageSize = parseInt(req.query.pageSize);
+            if (isNaN(pageSize) || pageSize < 1 || pageSize > 100) {
+                return res.status(400).json({
+                    success: false,
+                    error: {
+                        code: 'INVALID_PARAMETER',
+                        message: 'Page size must be between 1 and 100',
+                    },
+                });
+            }
+        }
+        return next();
+    };
+}
+/**
+ * Validate UUID parameter
+ */
+function validateUUID(paramName = 'id') {
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    return (req, res, next) => {
+        const id = req.params[paramName];
+        if (!id || !uuidRegex.test(id)) {
+            return res.status(400).json({
+                success: false,
+                error: {
+                    code: 'INVALID_PARAMETER',
+                    message: `Invalid ${paramName} format`,
+                },
+            });
+        }
+        return next();
+    };
+}
+//# sourceMappingURL=validation.middleware.js.map

package/lib/core/src/middleware/validation.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.middleware.js","sourceRoot":"","sources":["../../../../src/middleware/validation.middleware.ts"],"names":[],"mappings":"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"}

package/lib/core/src/types/errors.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Custom error classes for adding metadata to errors
+ */
+/**
+ * Base error class with requestId
+ */
+export declare class RequestError extends Error {
+    requestId?: string;
+    error?: any;
+    constructor(message: string, requestId?: string, originalError?: any);
+}
+/**
+ * Repository error with collection metadata
+ */
+export declare class RepositoryError extends Error {
+    collection?: string;
+    constructor(message: string, collection?: string);
+}
+/**
+ * Service error with requestId metadata
+ */
+export declare class ServiceError extends Error {
+    requestId?: string;
+    constructor(message: string, requestId?: string);
+}
+/**
+ * Authentication error with error metadata
+ */
+export declare class AuthError extends Error {
+    error?: any;
+    constructor(message: string, originalError?: any);
+}
+/**
+ * Survey connector error with surveyId metadata
+ */
+export declare class SurveyError extends Error {
+    surveyId?: string;
+    responseId?: string;
+    error?: any;
+    constructor(message: string, metadata?: {
+        surveyId?: string;
+        responseId?: string;
+        error?: any;
+    });
+}
+/**
+ * Work management connector error with taskId/articleId metadata
+ */
+export declare class WorkMgmtError extends Error {
+    taskId?: string;
+    articleId?: string;
+    error?: any;
+    constructor(message: string, metadata?: {
+        taskId?: string;
+        articleId?: string;
+        error?: any;
+    });
+}
+/**
+ * Communication subscriber error with event metadata
+ */
+export declare class CommunicationError extends Error {
+    eventType?: string;
+    error?: any;
+    constructor(message: string, metadata?: {
+        eventType?: string;
+        error?: any;
+    });
+}
+/**
+ * CRM connector error with error metadata
+ */
+export declare class CRMError extends Error {
+    error?: any;
+    constructor(message: string, originalError?: any);
+}
+/**
+ * Analytics connector error with error metadata
+ */
+export declare class AnalyticsError extends Error {
+    error?: any;
+    constructor(message: string, originalError?: any);
+}
+/**
+ * Email connector error with error metadata
+ */
+export declare class EmailError extends Error {
+    error?: any;
+    constructor(message: string, originalError?: any);
+}
+/**
+ * Payment connector error with error metadata
+ */
+export declare class PaymentError extends Error {
+    error?: any;
+    constructor(message: string, originalError?: any);
+}
+/**
+ * Search connector error with error metadata
+ */
+export declare class SearchError extends Error {
+    error?: any;
+    constructor(message: string, originalError?: any);
+}
+/**
+ * SMS connector error with error metadata
+ */
+export declare class SMSError extends Error {
+    error?: any;
+    constructor(message: string, originalError?: any);
+}
+/**
+ * Storage connector error with error metadata
+ */
+export declare class StorageError extends Error {
+    error?: any;
+    constructor(message: string, originalError?: any);
+}
+//# sourceMappingURL=errors.d.ts.map

package/lib/core/src/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/types/errors.ts"],"names":[],"mappings":"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"}

package/lib/core/src/types/errors.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * Custom error classes for adding metadata to errors
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageError = exports.SMSError = exports.SearchError = exports.PaymentError = exports.EmailError = exports.AnalyticsError = exports.CRMError = exports.CommunicationError = exports.WorkMgmtError = exports.SurveyError = exports.AuthError = exports.ServiceError = exports.RepositoryError = exports.RequestError = void 0;
+/**
+ * Base error class with requestId
+ */
+class RequestError extends Error {
+    constructor(message, requestId, originalError) {
+        super(message);
+        this.name = 'RequestError';
+        this.requestId = requestId;
+        this.error = originalError;
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, RequestError);
+        }
+    }
+}
+exports.RequestError = RequestError;
+/**
+ * Repository error with collection metadata
+ */
+class RepositoryError extends Error {
+    constructor(message, collection) {
+        super(message);
+        this.name = 'RepositoryError';
+        this.collection = collection;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, RepositoryError);
+        }
+    }
+}
+exports.RepositoryError = RepositoryError;
+/**
+ * Service error with requestId metadata
+ */
+class ServiceError extends Error {
+    constructor(message, requestId) {
+        super(message);
+        this.name = 'ServiceError';
+        this.requestId = requestId;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ServiceError);
+        }
+    }
+}
+exports.ServiceError = ServiceError;
+/**
+ * Authentication error with error metadata
+ */
+class AuthError extends Error {
+    constructor(message, originalError) {
+        super(message);
+        this.name = 'AuthError';
+        this.error = originalError;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, AuthError);
+        }
+    }
+}
+exports.AuthError = AuthError;
+/**
+ * Survey connector error with surveyId metadata
+ */
+class SurveyError extends Error {
+    constructor(message, metadata) {
+        super(message);
+        this.name = 'SurveyError';
+        this.surveyId = metadata === null || metadata === void 0 ? void 0 : metadata.surveyId;
+        this.responseId = metadata === null || metadata === void 0 ? void 0 : metadata.responseId;
+        this.error = metadata === null || metadata === void 0 ? void 0 : metadata.error;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, SurveyError);
+        }
+    }
+}
+exports.SurveyError = SurveyError;
+/**
+ * Work management connector error with taskId/articleId metadata
+ */
+class WorkMgmtError extends Error {
+    constructor(message, metadata) {
+        super(message);
+        this.name = 'WorkMgmtError';
+        this.taskId = metadata === null || metadata === void 0 ? void 0 : metadata.taskId;
+        this.articleId = metadata === null || metadata === void 0 ? void 0 : metadata.articleId;
+        this.error = metadata === null || metadata === void 0 ? void 0 : metadata.error;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, WorkMgmtError);
+        }
+    }
+}
+exports.WorkMgmtError = WorkMgmtError;
+/**
+ * Communication subscriber error with event metadata
+ */
+class CommunicationError extends Error {
+    constructor(message, metadata) {
+        super(message);
+        this.name = 'CommunicationError';
+        this.eventType = metadata === null || metadata === void 0 ? void 0 : metadata.eventType;
+        this.error = metadata === null || metadata === void 0 ? void 0 : metadata.error;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, CommunicationError);
+        }
+    }
+}
+exports.CommunicationError = CommunicationError;
+/**
+ * CRM connector error with error metadata
+ */
+class CRMError extends Error {
+    constructor(message, originalError) {
+        super(message);
+        this.name = 'CRMError';
+        this.error = originalError;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, CRMError);
+        }
+    }
+}
+exports.CRMError = CRMError;
+/**
+ * Analytics connector error with error metadata
+ */
+class AnalyticsError extends Error {
+    constructor(message, originalError) {
+        super(message);
+        this.name = 'AnalyticsError';
+        this.error = originalError;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, AnalyticsError);
+        }
+    }
+}
+exports.AnalyticsError = AnalyticsError;
+/**
+ * Email connector error with error metadata
+ */
+class EmailError extends Error {
+    constructor(message, originalError) {
+        super(message);
+        this.name = 'EmailError';
+        this.error = originalError;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, EmailError);
+        }
+    }
+}
+exports.EmailError = EmailError;
+/**
+ * Payment connector error with error metadata
+ */
+class PaymentError extends Error {
+    constructor(message, originalError) {
+        super(message);
+        this.name = 'PaymentError';
+        this.error = originalError;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, PaymentError);
+        }
+    }
+}
+exports.PaymentError = PaymentError;
+/**
+ * Search connector error with error metadata
+ */
+class SearchError extends Error {
+    constructor(message, originalError) {
+        super(message);
+        this.name = 'SearchError';
+        this.error = originalError;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, SearchError);
+        }
+    }
+}
+exports.SearchError = SearchError;
+/**
+ * SMS connector error with error metadata
+ */
+class SMSError extends Error {
+    constructor(message, originalError) {
+        super(message);
+        this.name = 'SMSError';
+        this.error = originalError;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, SMSError);
+        }
+    }
+}
+exports.SMSError = SMSError;
+/**
+ * Storage connector error with error metadata
+ */
+class StorageError extends Error {
+    constructor(message, originalError) {
+        super(message);
+        this.name = 'StorageError';
+        this.error = originalError;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, StorageError);
+        }
+    }
+}
+exports.StorageError = StorageError;
+//# sourceMappingURL=errors.js.map

package/lib/core/src/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/types/errors.ts"],"names":[],"mappings":"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"}

package/lib/utils-cache-connector/src/cache-connector.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Cache Connector
+ *
+ * Main facade class for the caching system.
+ * Provides a unified API for all cache operations and manages multiple cache providers.
+ *
+ * Features:
+ * - Multi-provider support (memory, firestore, redis)
+ * - Lazy provider initialization
+ * - Global enable/disable switch
+ * - Provider-specific routing
+ * - Automatic fallback to no-op when disabled
+ *
+ * Usage:
+ * ```typescript
+ * const cache = getCacheConnector();
+ * await cache.set('key', value, { ttl: 300, provider: 'memory' });
+ * const cached = await cache.get<User>('key', { provider: 'memory' });
+ * ```
+ */
+import { CacheConfig, CacheProviderType, CacheSetOptions, CacheGetOptions, CacheInvalidateOptions, CacheEntry, CacheStats } from './types';
+export declare class CacheConnector {
+    private config;
+    private providers;
+    private noopProvider;
+    constructor(config: CacheConfig);
+    /**
+     * Check if caching is enabled globally
+     */
+    isEnabled(): boolean;
+    /**
+     * Get or create a provider instance
+     */
+    private getProvider;
+    /**
+     * Create a new provider instance based on type
+     */
+    private createProvider;
+    /**
+     * Resolve provider from options or use default
+     */
+    private resolveProvider;
+    /**
+     * Get a value from cache
+     *
+     * @param key - Cache key
+     * @param options - Get options (provider override, metadata, etc.)
+     * @returns Cached value or null if not found/expired
+     */
+    get<T>(key: string, options?: CacheGetOptions): Promise<T | null>;
+    /**
+     * Get a value with metadata from cache
+     *
+     * @param key - Cache key
+     * @param options - Get options
+     * @returns Cache entry with metadata or null
+     */
+    getWithMetadata<T>(key: string, options?: CacheGetOptions): Promise<CacheEntry<T> | null>;
+    /**
+     * Set a value in cache
+     *
+     * @param key - Cache key
+     * @param value - Value to cache
+     * @param options - Set options (TTL, tags, provider, etc.)
+     */
+    set<T>(key: string, value: T, options?: CacheSetOptions): Promise<void>;
+    /**
+     * Delete a specific cache entry
+     *
+     * @param key - Cache key to delete
+     * @param options - Invalidate options
+     * @returns True if entry was deleted
+     */
+    delete(key: string, options?: CacheInvalidateOptions): Promise<boolean>;
+    /**
+     * Check if a cache entry exists
+     *
+     * @param key - Cache key to check
+     * @param options - Get options
+     * @returns True if entry exists and is not expired
+     */
+    has(key: string, options?: CacheGetOptions): Promise<boolean>;
+    /**
+     * Invalidate cache entries by tags
+     *
+     * @param tags - Array of tags to invalidate
+     * @param options - Invalidate options
+     * @returns Number of entries invalidated
+     */
+    invalidateByTags(tags: string[], options?: CacheInvalidateOptions): Promise<number>;
+    /**
+     * Invalidate cache entries by key pattern
+     *
+     * @param pattern - Pattern to match
+     * @param options - Invalidate options
+     * @returns Number of entries invalidated
+     */
+    invalidateByPattern(pattern: string, options?: CacheInvalidateOptions): Promise<number>;
+    /**
+     * Clear all cache entries
+     *
+     * @param options - Invalidate options
+     */
+    clear(options?: CacheInvalidateOptions): Promise<void>;
+    /**
+     * Clear all cache entries across all providers
+     */
+    clearAll(): Promise<void>;
+    /**
+     * Get cache statistics
+     *
+     * @param options - Get options
+     * @returns Cache statistics
+     */
+    getStats(options?: CacheGetOptions): Promise<CacheStats>;
+    /**
+     * Get statistics for all active providers
+     */
+    getAllStats(): Promise<Record<CacheProviderType, CacheStats>>;
+    /**
+     * Manually trigger cleanup of expired entries
+     *
+     * @param options - Get options
+     * @returns Number of entries cleaned up
+     */
+    cleanup(options?: CacheGetOptions): Promise<number>;
+    /**
+     * Build a namespaced cache key
+     *
+     * @param parts - Key parts to join
+     * @returns Namespaced cache key
+     */
+    buildKey(...parts: string[]): string;
+    /**
+     * Destroy all providers and cleanup resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=cache-connector.d.ts.map

package/lib/utils-cache-connector/src/cache-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-connector.d.ts","sourceRoot":"","sources":["../../../../utils-cache-connector/src/cache-connector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,WAAW,EACX,iBAAiB,EAEjB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,UAAU,EACX,MAAM,SAAS,CAAC;AAOjB,qBAAa,cAAc;IAIb,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,YAAY,CAAiB;gBAEjB,MAAM,EAAE,WAAW;IAWvC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiCnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK3E;;;;;;OAMG;IACG,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAKnG;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjF;;;;;;OAMG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjF;;;;;;OAMG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAKvE;;;;;;OAMG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7F;;;;;;OAMG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,MAAM,CAAC;IAQjG;;;;OAIG;IACG,KAAK,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB/B;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAKlE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;IAiBnE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAU7D;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAIpC;;OAEG;IACH,OAAO,IAAI,IAAI;CAahB"}