@xbg.solutions/backend-core 1.0.0

package/lib/core/src/base/BaseEntity.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Base Entity Class
+ * All domain entities should extend this class
+ * Provides common fields and validation patterns
+ */
+import { FieldValue, Timestamp } from 'firebase-admin/firestore';
+export interface EntityMetadata {
+    createdAt: Timestamp;
+    updatedAt: Timestamp;
+    deletedAt?: Timestamp | null;
+    version: number;
+}
+export interface BaseEntityData {
+    id?: string;
+    createdAt?: Timestamp | FieldValue;
+    updatedAt?: Timestamp | FieldValue;
+    deletedAt?: Timestamp | FieldValue | null;
+    version?: number;
+}
+export declare abstract class BaseEntity {
+    id?: string;
+    createdAt: Timestamp | FieldValue;
+    updatedAt: Timestamp | FieldValue;
+    deletedAt?: Timestamp | FieldValue | null;
+    version: number;
+    constructor(data?: BaseEntityData);
+    /**
+     * Convert entity to plain object for Firestore
+     */
+    toFirestore(): Record<string, any>;
+    /**
+     * Get entity-specific data (override in subclasses)
+     */
+    protected abstract getEntityData(): Record<string, any>;
+    /**
+     * Create entity from Firestore document
+     */
+    static fromFirestore<T extends BaseEntity>(this: new (data: any) => T, id: string, data: Record<string, any>): T;
+    /**
+     * Mark entity as deleted (soft delete)
+     */
+    softDelete(): void;
+    /**
+     * Check if entity is deleted
+     */
+    isDeleted(): boolean;
+    /**
+     * Increment version for optimistic locking
+     */
+    incrementVersion(): void;
+    /**
+     * Validate entity (override in subclasses)
+     */
+    abstract validate(): ValidationResult;
+    /**
+     * Get entity identifier
+     */
+    getId(): string | undefined;
+    /**
+     * Check if entity is new (not persisted)
+     */
+    isNew(): boolean;
+    /**
+     * Clone entity
+     */
+    clone(): this;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: FieldValidationError[];
+}
+export interface FieldValidationError {
+    field: string;
+    message: string;
+    code: string;
+}
+/**
+ * Validation helper functions
+ */
+export declare class ValidationHelper {
+    static createError(field: string, message: string, code: string): FieldValidationError;
+    static isValidResult(errors: FieldValidationError[]): ValidationResult;
+    static required(value: any, field: string): FieldValidationError | null;
+    static minLength(value: string, minLen: number, field: string): FieldValidationError | null;
+    static maxLength(value: string, maxLen: number, field: string): FieldValidationError | null;
+    static email(value: string, field: string): FieldValidationError | null;
+    static pattern(value: string, pattern: RegExp, field: string, message?: string): FieldValidationError | null;
+    static range(value: number, min: number, max: number, field: string): FieldValidationError | null;
+    static oneOf(value: any, allowedValues: any[], field: string): FieldValidationError | null;
+    static collectErrors(...errors: (FieldValidationError | null)[]): FieldValidationError[];
+}
+//# sourceMappingURL=BaseEntity.d.ts.map

package/lib/core/src/base/BaseEntity.d.ts.map

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

package/lib/core/src/base/BaseEntity.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Base Entity Class
+ * All domain entities should extend this class
+ * Provides common fields and validation patterns
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationHelper = exports.BaseEntity = void 0;
+const firestore_1 = require("firebase-admin/firestore");
+class BaseEntity {
+    constructor(data = {}) {
+        this.id = data.id;
+        this.createdAt = data.createdAt || firestore_1.FieldValue.serverTimestamp();
+        this.updatedAt = data.updatedAt || firestore_1.FieldValue.serverTimestamp();
+        this.deletedAt = data.deletedAt || null;
+        this.version = data.version || 1;
+    }
+    /**
+     * Convert entity to plain object for Firestore
+     */
+    toFirestore() {
+        const data = Object.assign(Object.assign({}, this.getEntityData()), { createdAt: this.createdAt, updatedAt: firestore_1.FieldValue.serverTimestamp(), version: this.version });
+        // Only include deletedAt if it's set
+        if (this.deletedAt) {
+            data.deletedAt = this.deletedAt;
+        }
+        // Remove undefined values
+        Object.keys(data).forEach((key) => {
+            if (data[key] === undefined) {
+                delete data[key];
+            }
+        });
+        return data;
+    }
+    /**
+     * Create entity from Firestore document
+     */
+    static fromFirestore(id, data) {
+        return new this(Object.assign({ id }, data));
+    }
+    /**
+     * Mark entity as deleted (soft delete)
+     */
+    softDelete() {
+        this.deletedAt = firestore_1.FieldValue.serverTimestamp();
+        this.updatedAt = firestore_1.FieldValue.serverTimestamp();
+    }
+    /**
+     * Check if entity is deleted
+     */
+    isDeleted() {
+        return !!this.deletedAt && this.deletedAt !== null;
+    }
+    /**
+     * Increment version for optimistic locking
+     */
+    incrementVersion() {
+        this.version += 1;
+        this.updatedAt = firestore_1.FieldValue.serverTimestamp();
+    }
+    /**
+     * Get entity identifier
+     */
+    getId() {
+        return this.id;
+    }
+    /**
+     * Check if entity is new (not persisted)
+     */
+    isNew() {
+        return !this.id;
+    }
+    /**
+     * Clone entity
+     */
+    clone() {
+        const constructor = this.constructor;
+        return new constructor(Object.assign(Object.assign({}, this.toFirestore()), { id: this.id }));
+    }
+}
+exports.BaseEntity = BaseEntity;
+/**
+ * Validation helper functions
+ */
+class ValidationHelper {
+    static createError(field, message, code) {
+        return { field, message, code };
+    }
+    static isValidResult(errors) {
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    static required(value, field) {
+        if (value === undefined || value === null || value === '') {
+            return this.createError(field, `${field} is required`, 'REQUIRED');
+        }
+        return null;
+    }
+    static minLength(value, minLen, field) {
+        if (value && value.length < minLen) {
+            return this.createError(field, `${field} must be at least ${minLen} characters`, 'MIN_LENGTH');
+        }
+        return null;
+    }
+    static maxLength(value, maxLen, field) {
+        if (value && value.length > maxLen) {
+            return this.createError(field, `${field} must be at most ${maxLen} characters`, 'MAX_LENGTH');
+        }
+        return null;
+    }
+    static email(value, field) {
+        const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+        if (value && !emailRegex.test(value)) {
+            return this.createError(field, `${field} must be a valid email`, 'INVALID_EMAIL');
+        }
+        return null;
+    }
+    static pattern(value, pattern, field, message) {
+        if (value && !pattern.test(value)) {
+            return this.createError(field, message || `${field} has invalid format`, 'INVALID_FORMAT');
+        }
+        return null;
+    }
+    static range(value, min, max, field) {
+        if (value !== undefined && (value < min || value > max)) {
+            return this.createError(field, `${field} must be between ${min} and ${max}`, 'OUT_OF_RANGE');
+        }
+        return null;
+    }
+    static oneOf(value, allowedValues, field) {
+        if (value !== undefined && !allowedValues.includes(value)) {
+            return this.createError(field, `${field} must be one of: ${allowedValues.join(', ')}`, 'INVALID_VALUE');
+        }
+        return null;
+    }
+    static collectErrors(...errors) {
+        return errors.filter((e) => e !== null);
+    }
+}
+exports.ValidationHelper = ValidationHelper;
+//# sourceMappingURL=BaseEntity.js.map

package/lib/core/src/base/BaseEntity.js.map

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

package/lib/core/src/base/BaseRepository.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Base Repository Class
+ * Provides common CRUD operations with Firestore
+ * All repositories should extend this class
+ */
+import { Firestore, CollectionReference, DocumentData } from 'firebase-admin/firestore';
+import { BaseEntity } from './BaseEntity';
+import { RepositoryCacheConfig, CacheOptions, CacheProviderType } from '@xbg/utils-cache-connector';
+export interface QueryOptions {
+    limit?: number;
+    offset?: number;
+    orderBy?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    }[];
+    where?: WhereClause[];
+    includeSoftDeleted?: boolean;
+}
+export interface WhereClause {
+    field: string;
+    operator: FirebaseFirestore.WhereFilterOp;
+    value: any;
+}
+export interface PaginationResult<T> {
+    data: T[];
+    total: number;
+    page: number;
+    pageSize: number;
+    hasMore: boolean;
+}
+export declare abstract class BaseRepository<T extends BaseEntity> {
+    protected abstract collectionName: string;
+    protected db: Firestore;
+    /**
+     * Cache configuration for this repository
+     * Override in subclasses to enable caching
+     */
+    protected cacheConfig: RepositoryCacheConfig;
+    constructor(db: Firestore);
+    /**
+     * Get collection reference
+     */
+    protected getCollection(): CollectionReference<DocumentData>;
+    /**
+     * Check if caching is enabled for this repository
+     * Respects both global and repository-level settings
+     */
+    protected isCacheEnabled(): boolean;
+    /**
+     * Get effective cache provider for this repository
+     */
+    protected getCacheProvider(): CacheProviderType;
+    /**
+     * Get effective TTL for this repository
+     */
+    protected getCacheTTL(override?: number): number;
+    /**
+     * Build cache key with repository prefix
+     */
+    protected buildCacheKey(type: string, identifier: string): string;
+    /**
+     * Build cache tags for invalidation
+     */
+    protected buildCacheTags(entity: T, additionalTags?: string[]): string[];
+    /**
+     * Invalidate cache for a specific entity
+     * Called automatically on update/delete
+     */
+    protected invalidateEntityCache(id: string): Promise<void>;
+    /**
+     * Log cache hit
+     */
+    protected logCacheHit(key: string): void;
+    /**
+     * Log cache miss
+     */
+    protected logCacheMiss(key: string): void;
+    /**
+     * Create a new entity
+     */
+    create(entity: T): Promise<T>;
+    /**
+     * Find entity by ID
+     */
+    findById(id: string, includeSoftDeleted?: boolean): Promise<T | null>;
+    /**
+     * Find entity by ID with caching
+     * Only uses cache if enabled at both global and repository levels
+     */
+    findByIdCached(id: string, options?: CacheOptions): Promise<T | null>;
+    /**
+     * Find all entities with optional filtering
+     */
+    findAll(options?: QueryOptions): Promise<T[]>;
+    /**
+     * Find with pagination
+     */
+    findPaginated(page: number, pageSize: number, options?: Omit<QueryOptions, 'limit' | 'offset'>): Promise<PaginationResult<T>>;
+    /**
+     * Update an entity
+     */
+    update(entity: T): Promise<T>;
+    /**
+     * Delete an entity (soft delete by default)
+     */
+    delete(id: string, hardDelete?: boolean): Promise<void>;
+    /**
+     * Count entities
+     */
+    count(options?: Omit<QueryOptions, 'limit' | 'offset'>): Promise<number>;
+    /**
+     * Check if entity exists
+     */
+    exists(id: string): Promise<boolean>;
+    /**
+     * Batch create entities
+     */
+    batchCreate(entities: T[]): Promise<T[]>;
+    /**
+     * Convert Firestore document to entity (must be implemented by subclasses)
+     */
+    protected abstract fromFirestore(id: string, data: DocumentData): T;
+}
+//# sourceMappingURL=BaseRepository.d.ts.map

package/lib/core/src/base/BaseRepository.d.ts.map

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