@xbg.solutions/backend-core 1.0.0

package/lib/utils-events/src/event-types.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Event Type Definitions
+ *
+ * Base event types for the internal event bus. These cover the standard
+ * lifecycle events that most applications need out of the box.
+ *
+ * ─── Extending with project-specific events ───────────────────────────
+ *
+ * The code generator adds entity-specific CRUD events automatically
+ * (e.g. ORDER_CREATED, PRODUCT_UPDATED) via BaseService.publishEvent().
+ * Those events are cast to EventType at runtime, so they work with the
+ * event bus without being listed here.
+ *
+ * To add custom domain events (e.g. ORDER_SHIPPED, PAYMENT_FAILED):
+ *
+ *   1. Add the new member to this enum.
+ *   2. Optionally define a typed payload interface below.
+ *   3. Add the mapping to EventPayloadMap for full type safety.
+ *   4. Subscribe in your service or in subscribers/.
+ *
+ * The enum is deliberately kept small so that new projects start clean
+ * and only grow the event catalogue as needed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventType = void 0;
+var EventType;
+(function (EventType) {
+    // ── User lifecycle ────────────────────────────────────────
+    EventType["USER_CREATED"] = "user.created";
+    EventType["USER_UPDATED"] = "user.updated";
+    EventType["USER_DELETED"] = "user.deleted";
+    // ── Authentication ────────────────────────────────────────
+    EventType["AUTH_LOGIN"] = "auth.login";
+    EventType["AUTH_LOGOUT"] = "auth.logout";
+    EventType["AUTH_TOKEN_REFRESHED"] = "auth.token_refreshed";
+    EventType["AUTH_TOKEN_BLACKLISTED"] = "auth.token_blacklisted";
+    EventType["AUTH_PASSWORD_CHANGED"] = "auth.password_changed";
+    // ── File / Storage ────────────────────────────────────────
+    EventType["FILE_UPLOADED"] = "file.uploaded";
+    EventType["FILE_DELETED"] = "file.deleted";
+    // ── Notifications ─────────────────────────────────────────
+    EventType["NOTIFICATION_SENT"] = "notification.sent";
+    EventType["NOTIFICATION_FAILED"] = "notification.failed";
+    // ── System ────────────────────────────────────────────────
+    /** Catch-all for external data changes (Firebase triggers, webhooks, etc.) */
+    EventType["EXTERNAL_DATA_CHANGE"] = "external.data.change";
+})(EventType || (exports.EventType = EventType = {}));
+//# sourceMappingURL=event-types.js.map

package/lib/utils-events/src/event-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.js","sourceRoot":"","sources":["../../../../utils-events/src/event-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAEH,IAAY,SAwBX;AAxBD,WAAY,SAAS;IACnB,6DAA6D;IAC7D,0CAA6B,CAAA;IAC7B,0CAA6B,CAAA;IAC7B,0CAA6B,CAAA;IAE7B,6DAA6D;IAC7D,sCAAyB,CAAA;IACzB,wCAA2B,CAAA;IAC3B,0DAA6C,CAAA;IAC7C,8DAAiD,CAAA;IACjD,4DAA+C,CAAA;IAE/C,6DAA6D;IAC7D,4CAA+B,CAAA;IAC/B,0CAA6B,CAAA;IAE7B,6DAA6D;IAC7D,oDAAuC,CAAA;IACvC,wDAA2C,CAAA;IAE3C,6DAA6D;IAC7D,8EAA8E;IAC9E,0DAA6C,CAAA;AAC/C,CAAC,EAxBW,SAAS,yBAAT,SAAS,QAwBpB"}

package/lib/utils-events/src/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Event utilities barrel export
+ */
+export { eventBus } from './event-bus';
+export { EventType } from './event-types';
+export type { BaseEventPayload, EntityCreatedPayload, EntityUpdatedPayload, EntityDeletedPayload, UserCreatedPayload, UserUpdatedPayload, UserDeletedPayload, AuthLoginPayload, AuthLogoutPayload, AuthTokenBlacklistedPayload, FileUploadedPayload, FileDeletedPayload, NotificationSentPayload, NotificationFailedPayload, ExternalDataChangePayload, EventPayloadMap, } from './event-types';
+//# sourceMappingURL=index.d.ts.map

package/lib/utils-events/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../utils-events/src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,eAAe,GAChB,MAAM,eAAe,CAAC"}

package/lib/utils-events/src/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Event utilities barrel export
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventType = exports.eventBus = void 0;
+var event_bus_1 = require("./event-bus");
+Object.defineProperty(exports, "eventBus", { enumerable: true, get: function () { return event_bus_1.eventBus; } });
+var event_types_1 = require("./event-types");
+Object.defineProperty(exports, "EventType", { enumerable: true, get: function () { return event_types_1.EventType; } });
+//# sourceMappingURL=index.js.map

package/lib/utils-events/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../utils-events/src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AACjB,6CAA0C;AAAjC,wGAAA,SAAS,OAAA"}

package/lib/utils-logger/src/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Logger utility barrel export
+ */
+export * from './logger';
+export * from './logger-types';
+import { Logger } from './logger';
+/**
+ * Default logger instance for use outside request context
+ * For request-scoped logging, use the logger from req.logger
+ */
+export declare const logger: Logger;
+//# sourceMappingURL=index.d.ts.map

package/lib/utils-logger/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../utils-logger/src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,MAAM,QAAoD,CAAC"}

package/lib/utils-logger/src/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+/**
+ * Logger utility barrel export
+ */
+__exportStar(require("./logger"), exports);
+__exportStar(require("./logger-types"), exports);
+const logger_1 = require("./logger");
+/**
+ * Default logger instance for use outside request context
+ * For request-scoped logging, use the logger from req.logger
+ */
+exports.logger = new logger_1.Logger('system', { service: 'wishlist-api' });
+//# sourceMappingURL=index.js.map

package/lib/utils-logger/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../utils-logger/src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,2CAAyB;AACzB,iDAA+B;AAE/B,qCAAkC;AAElC;;;GAGG;AACU,QAAA,MAAM,GAAG,IAAI,eAAM,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC"}

package/lib/utils-logger/src/logger-types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Logger type definitions
+ */
+/**
+ * Base log context interface
+ * Represents metadata that can be attached to log messages
+ */
+export interface LogContext {
+    [key: string]: unknown;
+}
+/**
+ * Common context fields used across the application
+ */
+export interface BaseLogContext extends LogContext {
+    operation?: string;
+    userId?: string;
+    accountUID?: string;
+    listUID?: string;
+    itemUID?: string;
+    contactUID?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Log level enum (re-export for convenience)
+ */
+export declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+//# sourceMappingURL=logger-types.d.ts.map

package/lib/utils-logger/src/logger-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-types.d.ts","sourceRoot":"","sources":["../../../../utils-logger/src/logger-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB"}

package/lib/utils-logger/src/logger-types.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Logger type definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogLevel = void 0;
+/**
+ * Log level enum (re-export for convenience)
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["INFO"] = "info";
+    LogLevel["WARN"] = "warn";
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+//# sourceMappingURL=logger-types.js.map

package/lib/utils-logger/src/logger-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-types.js","sourceRoot":"","sources":["../../../../utils-logger/src/logger-types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAuBH;;GAEG;AACH,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,2BAAe,CAAA;AACjB,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB"}

package/lib/utils-logger/src/logger.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Structured Logger with Correlation IDs
+ *
+ * Integrates with Firebase Functions logging (GCP Cloud Logging)
+ * Never logs PII in plaintext - sanitizes metadata
+ */
+import { LogContext } from './logger-types';
+export { LogLevel } from './logger-types';
+export declare class Logger {
+    private readonly correlationId;
+    private readonly context;
+    constructor(correlationId: string, context?: LogContext);
+    /**
+     * Sanitize metadata to remove sensitive fields
+     */
+    private sanitizeMetadata;
+    /**
+     * Build log data structure
+     */
+    private buildLogData;
+    /**
+     * Log debug message (development only)
+     */
+    debug(message: string, meta?: LogContext): void;
+    /**
+     * Log info message
+     */
+    info(message: string, meta?: LogContext): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, meta?: LogContext): void;
+    /**
+     * Log error message with error object
+     */
+    error(message: string, error: Error, meta?: LogContext): void;
+    /**
+     * Create child logger with additional context
+     */
+    child(additionalContext: LogContext): Logger;
+}
+//# sourceMappingURL=logger.d.ts.map

package/lib/utils-logger/src/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../utils-logger/src/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAY,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAmC1C,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,UAAe;IAG3C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,IAAI;IAOnD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,IAAI;IAKlD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,IAAI;IAKlD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,UAAe,GAAG,IAAI;IAYjE;;OAEG;IACH,KAAK,CAAC,iBAAiB,EAAE,UAAU,GAAG,MAAM;CAM7C"}

package/lib/utils-logger/src/logger.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * Structured Logger with Correlation IDs
+ *
+ * Integrates with Firebase Functions logging (GCP Cloud Logging)
+ * Never logs PII in plaintext - sanitizes metadata
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = exports.LogLevel = void 0;
+const firebase_functions_1 = require("firebase-functions");
+const logger_types_1 = require("./logger-types");
+var logger_types_2 = require("./logger-types");
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_types_2.LogLevel; } });
+/**
+ * Sensitive field names that should never be logged
+ */
+const SENSITIVE_FIELDS = [
+    'password',
+    'token',
+    'secret',
+    'key',
+    'apiKey',
+    'api_key',
+    'accessToken',
+    'access_token',
+    'refreshToken',
+    'refresh_token',
+    'email',
+    'phoneNumber',
+    'phone',
+    'address',
+    'addressLine1',
+    'addressLine2',
+    'city',
+    'state',
+    'postalCode',
+    'postal_code',
+    'ssn',
+    'creditCard',
+    'credit_card',
+    'cardNumber',
+    'card_number',
+    'cvv',
+    'authorization',
+];
+class Logger {
+    constructor(correlationId, context = {}) {
+        this.correlationId = correlationId;
+        this.context = context;
+    }
+    /**
+     * Sanitize metadata to remove sensitive fields
+     */
+    sanitizeMetadata(meta) {
+        const sanitized = {};
+        for (const [key, value] of Object.entries(meta)) {
+            // Check if field name is sensitive
+            const lowerKey = key.toLowerCase();
+            const isSensitive = SENSITIVE_FIELDS.some((field) => lowerKey.includes(field.toLowerCase()));
+            if (isSensitive) {
+                sanitized[key] = '[REDACTED]';
+            }
+            else if (value && typeof value === 'object' && !Array.isArray(value)) {
+                // Recursively sanitize nested objects
+                sanitized[key] = this.sanitizeMetadata(value);
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+    /**
+     * Build log data structure
+     */
+    buildLogData(level, message, meta = {}) {
+        const sanitizedMeta = this.sanitizeMetadata(meta);
+        return Object.assign({ correlationId: this.correlationId, timestamp: new Date().toISOString(), level,
+            message, context: this.context }, sanitizedMeta);
+    }
+    /**
+     * Log debug message (development only)
+     */
+    debug(message, meta = {}) {
+        if (process.env.LOG_LEVEL === 'debug' || process.env.NODE_ENV === 'development') {
+            const logData = this.buildLogData(logger_types_1.LogLevel.DEBUG, message, meta);
+            firebase_functions_1.logger.debug(logData);
+        }
+    }
+    /**
+     * Log info message
+     */
+    info(message, meta = {}) {
+        const logData = this.buildLogData(logger_types_1.LogLevel.INFO, message, meta);
+        firebase_functions_1.logger.info(logData);
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, meta = {}) {
+        const logData = this.buildLogData(logger_types_1.LogLevel.WARN, message, meta);
+        firebase_functions_1.logger.warn(logData);
+    }
+    /**
+     * Log error message with error object
+     */
+    error(message, error, meta = {}) {
+        const logData = this.buildLogData(logger_types_1.LogLevel.ERROR, message, Object.assign({ error: {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            } }, meta));
+        firebase_functions_1.logger.error(logData);
+    }
+    /**
+     * Create child logger with additional context
+     */
+    child(additionalContext) {
+        return new Logger(this.correlationId, Object.assign(Object.assign({}, this.context), additionalContext));
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/lib/utils-logger/src/logger.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@xbg.solutions/backend-core",
+  "version": "1.0.0",
+  "description": "XBG Backend Core - Base classes, middleware, config, and code generator",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "src/templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf lib",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@xbg/utils-logger": "^1.0.0",
+    "@xbg/utils-events": "^1.0.0",
+    "@xbg/utils-cache-connector": "^1.0.0",
+    "@xbg/utils-firebase-event-bridge": "^1.0.0",
+    "@xbg/utils-firestore-connector": "^1.0.0",
+    "@xbg/utils-token-handler": "^1.0.0",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
+    "express-rate-limit": "^7.1.5",
+    "express-validator": "^7.0.1",
+    "firebase-admin": "^12.0.0",
+    "firebase-functions": "^4.6.0",
+    "handlebars": "^4.7.8",
+    "helmet": "^7.1.0",
+    "joi": "^17.11.0",
+    "uuid": "^9.0.1"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.11.0",
+    "@types/uuid": "^9.0.7",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": "22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/templates/controller.hbs

@@ -0,0 +1,48 @@
+/**
+ * {{entityName}} Controller
+ * Generated from data model specification
+ */
+
+import { Router } from 'express';
+import { BaseController } from '@xbg/backend-core';
+import { {{entityName}} } from '../entities/{{entityName}}';
+import { {{entityName}}Service } from '../services/{{entityName}}Service';
+
+export class {{entityName}}Controller extends BaseController<{{entityName}}> {
+  constructor(service: {{entityName}}Service, basePath = '/{{entityNameLower}}s') {
+    super(service, basePath);
+  }
+
+  /**
+   * Register custom routes
+   */
+  protected registerRoutes(): void {
+    // Register standard CRUD routes
+    super.registerRoutes();
+
+    // Add custom routes here
+{{#each fields}}
+{{#if unique}}
+    // this.router.get('/by-{{name}}/:{{name}}', this.handleFindBy{{capitalize name}}.bind(this));
+{{/if}}
+{{/each}}
+  }
+
+{{#each fields}}
+{{#if unique}}
+  /**
+   * Find {{../../entityName}} by {{name}}
+   */
+  // protected async handleFindBy{{capitalize name}}(req: Request, res: Response, next: NextFunction): Promise<void> {
+  //   try {
+  //     const context = this.createContext(req);
+  //     const { {{name}} } = req.params;
+  //
+  //     // Implementation here
+  //   } catch (error) {
+  //     next(error);
+  //   }
+  // }
+{{/if}}
+{{/each}}
+}

package/src/templates/entity.hbs

@@ -0,0 +1,80 @@
+/**
+ * {{entityName}} Entity
+ * Generated from data model specification
+ */
+
+{{#each imports}}
+{{{this}}}
+{{/each}}
+
+export interface {{entityName}}Data extends BaseEntityData {
+{{#each fields}}
+  {{name}}{{#unless required}}?{{/unless}}: {{{tsType}}};
+{{/each}}
+}
+
+export class {{entityName}} extends BaseEntity {
+{{#each fields}}
+  {{name}}{{#unless required}}?{{/unless}}: {{{tsType}}};
+{{/each}}
+
+  constructor(data: {{entityName}}Data) {
+    super(data);
+{{#each fields}}
+    this.{{name}} = data.{{name}}{{#if hasDefault}} || {{{defaultValue}}}{{/if}};
+{{/each}}
+  }
+
+  /**
+   * Get entity-specific data for Firestore
+   */
+  protected getEntityData(): Record<string, any> {
+    return {
+{{#each fields}}
+      {{name}}: this.{{name}},
+{{/each}}
+    };
+  }
+
+  /**
+   * Validate entity
+   */
+  validate(): ValidationResult {
+    const errors = ValidationHelper.collectErrors(
+{{#each fields}}
+  {{#each validation}}
+      {{{this}}},
+  {{/each}}
+{{/each}}
+    );
+
+    return ValidationHelper.isValidResult(errors);
+  }
+
+  /**
+   * Create entity from Firestore document
+   */
+  static fromFirestore(id: string, data: Record<string, any>): {{entityName}} {
+    return new {{entityName}}({
+      id,
+      ...data,
+    });
+  }
+
+  /**
+   * Convert to plain object for API responses
+   */
+  toJSON(): Record<string, any> {
+    return {
+      id: this.id,
+{{#each fields}}
+      {{name}}: this.{{name}},
+{{/each}}
+      createdAt: this.createdAt,
+      updatedAt: this.updatedAt,
+      {{#if hasSoftDelete}}
+      deletedAt: this.deletedAt,
+      {{/if}}
+    };
+  }
+}

package/src/templates/repository.hbs

@@ -0,0 +1,56 @@
+/**
+ * {{entityName}} Repository
+ * Generated from data model specification
+ */
+
+import { Firestore, DocumentData } from 'firebase-admin/firestore';
+import { BaseRepository } from '@xbg/backend-core';
+import { {{entityName}} } from '../entities/{{entityName}}';
+
+export class {{entityName}}Repository extends BaseRepository<{{entityName}}> {
+  protected collectionName = '{{collectionName}}';
+
+  constructor(db: Firestore) {
+    super(db);
+  }
+
+  /**
+   * Convert Firestore document to entity
+   */
+  protected fromFirestore(id: string, data: DocumentData): {{entityName}} {
+    return {{entityName}}.fromFirestore(id, data);
+  }
+
+{{#each fields}}
+{{#if unique}}
+  /**
+   * Find {{../../entityName}} by {{name}}
+   */
+  async findBy{{capitalize name}}({{name}}: {{{tsType}}}): Promise<{{../../entityName}} | null> {
+    const snapshot = await this.getCollection()
+      .where('{{name}}', '==', {{name}})
+      .where('deletedAt', '==', null)
+      .limit(1)
+      .get();
+
+    if (snapshot.empty) {
+      return null;
+    }
+
+    const doc = snapshot.docs[0];
+    return this.fromFirestore(doc.id, doc.data());
+  }
+{{/if}}
+{{/each}}
+
+{{#each relationships}}
+  /**
+   * Get {{name}} for {{../../entityName}}
+   */
+  async get{{capitalize name}}({{../../entityNameLower}}Id: string): Promise<{{entity}}[]> {
+    // Implementation depends on relationship type
+    // TODO: Implement relationship query
+    return [];
+  }
+{{/each}}
+}