@ciscode/database-kit 1.0.0

package/dist/adapters/mongo.adapter.js

@@ -0,0 +1,146 @@
+"use strict";
+// src/adapters/mongo.adapter.ts
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var MongoAdapter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoAdapter = void 0;
+const mongoose_1 = __importDefault(require("mongoose"));
+const common_1 = require("@nestjs/common");
+/**
+ * MongoDB adapter for DatabaseKit.
+ * Handles MongoDB connection and repository creation via Mongoose.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new MongoAdapter({ type: 'mongo', connectionString: 'mongodb://...' });
+ * await adapter.connect();
+ * const repo = adapter.createRepository({ model: UserModel });
+ * ```
+ */
+let MongoAdapter = MongoAdapter_1 = class MongoAdapter {
+    constructor(config) {
+        this.logger = new common_1.Logger(MongoAdapter_1.name);
+        this.config = config;
+        mongoose_1.default.set('strictQuery', false);
+    }
+    /**
+     * Establishes connection to MongoDB.
+     * Connection is lazy-loaded and cached for reuse.
+     *
+     * @param options - Additional Mongoose connection options
+     * @returns Promise resolving to mongoose instance
+     */
+    async connect(options = {}) {
+        if (!this.connectionPromise) {
+            this.logger.log('Connecting to MongoDB...');
+            this.connectionPromise = mongoose_1.default.connect(this.config.connectionString, {
+                maxPoolSize: 10,
+                serverSelectionTimeoutMS: 5000,
+                ...options,
+            });
+            mongoose_1.default.connection.on('connected', () => {
+                this.logger.log('Successfully connected to MongoDB');
+            });
+            mongoose_1.default.connection.on('error', (err) => {
+                this.logger.error('MongoDB connection error', (err === null || err === void 0 ? void 0 : err.message) || err);
+            });
+            mongoose_1.default.connection.on('disconnected', () => {
+                this.logger.warn('MongoDB disconnected');
+            });
+        }
+        return this.connectionPromise;
+    }
+    /**
+     * Gracefully disconnects from MongoDB.
+     */
+    async disconnect() {
+        await mongoose_1.default.disconnect();
+        this.connectionPromise = undefined;
+        this.logger.log('Disconnected from MongoDB');
+    }
+    /**
+     * Checks if connected to MongoDB.
+     */
+    isConnected() {
+        return mongoose_1.default.connection.readyState === 1;
+    }
+    /**
+     * Creates a repository for a Mongoose model.
+     * The repository provides a standardized CRUD interface.
+     *
+     * @param opts - Options containing the Mongoose model
+     * @returns Repository instance with CRUD methods
+     */
+    createRepository(opts) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const model = opts.model;
+        const shapePage = (data, page, limit, total) => {
+            const pages = Math.max(1, Math.ceil((total || 0) / (limit || 1)));
+            return { data, page, limit, total, pages };
+        };
+        const repo = {
+            async create(data) {
+                var _a, _b, _c;
+                const doc = await model.create(data);
+                return (_c = (_b = (_a = doc).toObject) === null || _b === void 0 ? void 0 : _b.call(_a)) !== null && _c !== void 0 ? _c : doc;
+            },
+            async findById(id) {
+                const doc = await model.findById(id).lean().exec();
+                return doc;
+            },
+            async findAll(filter = {}) {
+                const docs = await model.find(filter).lean().exec();
+                return docs;
+            },
+            async findPage(options = {}) {
+                const { filter = {}, page = 1, limit = 10, sort } = options;
+                const skip = Math.max(0, (page - 1) * limit);
+                let query = model.find(filter).skip(skip).limit(limit);
+                if (sort) {
+                    query = query.sort(sort);
+                }
+                const [data, total] = await Promise.all([
+                    query.lean().exec(),
+                    model.countDocuments(filter).exec(),
+                ]);
+                return shapePage(data, page, limit, total);
+            },
+            async updateById(id, update) {
+                const doc = await model
+                    .findByIdAndUpdate(id, update, { new: true })
+                    .lean()
+                    .exec();
+                return doc;
+            },
+            async deleteById(id) {
+                const res = await model.findByIdAndDelete(id).lean().exec();
+                return !!res;
+            },
+            async count(filter = {}) {
+                return model.countDocuments(filter).exec();
+            },
+            async exists(filter = {}) {
+                const res = await model.exists(filter);
+                return !!res;
+            },
+        };
+        return repo;
+    }
+};
+exports.MongoAdapter = MongoAdapter;
+exports.MongoAdapter = MongoAdapter = MongoAdapter_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [Object])
+], MongoAdapter);
+//# sourceMappingURL=mongo.adapter.js.map

package/dist/adapters/mongo.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.adapter.js","sourceRoot":"","sources":["../../src/adapters/mongo.adapter.ts"],"names":[],"mappings":";AAAA,gCAAgC;;;;;;;;;;;;;;;;AAEhC,wDAA2D;AAC3D,2CAAoD;AASpD;;;;;;;;;;GAUG;AAEI,IAAM,YAAY,oBAAlB,MAAM,YAAY;IAKrB,YAAY,MAA2B;QAJtB,WAAM,GAAG,IAAI,eAAM,CAAC,cAAY,CAAC,IAAI,CAAC,CAAC;QAKpD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,kBAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,UAA0B,EAAE;QACtC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;YAE5C,IAAI,CAAC,iBAAiB,GAAG,kBAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;gBACpE,WAAW,EAAE,EAAE;gBACf,wBAAwB,EAAE,IAAI;gBAC9B,GAAG,OAAO;aACb,CAAC,CAAC;YAEH,kBAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;gBACrC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;YACzD,CAAC,CAAC,CAAC;YAEH,kBAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACpC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,CAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,OAAO,KAAI,GAAG,CAAC,CAAC;YACvE,CAAC,CAAC,CAAC;YAEH,kBAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;gBACxC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACZ,MAAM,kBAAQ,CAAC,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,WAAW;QACP,OAAO,kBAAQ,CAAC,UAAU,CAAC,UAAU,KAAK,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;OAMG;IACH,gBAAgB,CAAc,IAA4B;QACtD,8DAA8D;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAmB,CAAC;QACvC,MAAM,SAAS,GAAG,CACd,IAAS,EACT,IAAY,EACZ,KAAa,EACb,KAAa,EACA,EAAE;YACf,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAClE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC/C,CAAC,CAAC;QAEF,MAAM,IAAI,GAAkB;YACxB,KAAK,CAAC,MAAM,CAAC,IAAgB;;gBACzB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrC,OAAO,MAAA,MAAA,MAAC,GAA8B,EAAC,QAAQ,kDAAI,mCAAK,GAAS,CAAC;YACtE,CAAC;YAED,KAAK,CAAC,QAAQ,CAAC,EAAmB;gBAC9B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;gBACnD,OAAO,GAAe,CAAC;YAC3B,CAAC;YAED,KAAK,CAAC,OAAO,CAAC,SAAkC,EAAE;gBAC9C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;gBACpD,OAAO,IAAW,CAAC;YACvB,CAAC;YAED,KAAK,CAAC,QAAQ,CAAC,UAAuB,EAAE;gBACpC,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;gBAE5D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;gBAC7C,IAAI,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAEvD,IAAI,IAAI,EAAE,CAAC;oBACP,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAA8B,CAAC,CAAC;gBACvD,CAAC;gBAED,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;oBACpC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;oBACnB,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;iBACtC,CAAC,CAAC;gBAEH,OAAO,SAAS,CAAC,IAAW,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACtD,CAAC;YAED,KAAK,CAAC,UAAU,CAAC,EAAmB,EAAE,MAAkB;gBACpD,MAAM,GAAG,GAAG,MAAM,KAAK;qBAClB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;qBAC5C,IAAI,EAAE;qBACN,IAAI,EAAE,CAAC;gBACZ,OAAO,GAAe,CAAC;YAC3B,CAAC;YAED,KAAK,CAAC,UAAU,CAAC,EAAmB;gBAChC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;gBAC5D,OAAO,CAAC,CAAC,GAAG,CAAC;YACjB,CAAC;YAED,KAAK,CAAC,KAAK,CAAC,SAAkC,EAAE;gBAC5C,OAAO,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,CAAC;YAED,KAAK,CAAC,MAAM,CAAC,SAAkC,EAAE;gBAC7C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACvC,OAAO,CAAC,CAAC,GAAG,CAAC;YACjB,CAAC;SACJ,CAAC;QAEF,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ,CAAA;AA1IY,oCAAY;uBAAZ,YAAY;IADxB,IAAA,mBAAU,GAAE;;GACA,YAAY,CA0IxB"}

package/dist/adapters/postgres.adapter.d.ts

@@ -0,0 +1,49 @@
+import { Knex } from 'knex';
+import { PostgresDatabaseConfig, PostgresEntityConfig, Repository } from '../contracts/database.contracts';
+/**
+ * PostgreSQL adapter for DatabaseKit.
+ * Handles PostgreSQL connection and repository creation via Knex.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new PostgresAdapter({ type: 'postgres', connectionString: 'postgresql://...' });
+ * adapter.connect();
+ * const repo = adapter.createRepository({ table: 'users', primaryKey: 'id' });
+ * ```
+ */
+export declare class PostgresAdapter {
+    private readonly logger;
+    private readonly config;
+    private knexInstance?;
+    constructor(config: PostgresDatabaseConfig);
+    /**
+     * Creates and returns the Knex instance for PostgreSQL.
+     * Connection is lazy-loaded and cached for reuse.
+     *
+     * @param overrides - Additional Knex configuration overrides
+     * @returns Knex instance
+     */
+    connect(overrides?: Knex.Config): Knex;
+    /**
+     * Gracefully destroys the connection pool.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Returns the Knex instance.
+     * Throws if not connected.
+     */
+    getKnex(): Knex;
+    /**
+     * Checks if connected to PostgreSQL.
+     */
+    isConnected(): boolean;
+    /**
+     * Creates a repository for a PostgreSQL table.
+     * The repository provides a standardized CRUD interface.
+     *
+     * @param cfg - Configuration for the entity/table
+     * @returns Repository instance with CRUD methods
+     */
+    createRepository<T = unknown>(cfg: PostgresEntityConfig): Repository<T>;
+}
+//# sourceMappingURL=postgres.adapter.d.ts.map

package/dist/adapters/postgres.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/postgres.adapter.ts"],"names":[],"mappings":"AAEA,OAAa,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,EACH,sBAAsB,EACtB,oBAAoB,EACpB,UAAU,EAGb,MAAM,iCAAiC,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,qBACa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,YAAY,CAAC,CAAO;gBAEhB,MAAM,EAAE,sBAAsB;IAI1C;;;;;;OAMG;IACH,OAAO,CAAC,SAAS,GAAE,IAAI,CAAC,MAAW,GAAG,IAAI;IAiB1C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;;OAGG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;OAMG;IACH,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,oBAAoB,GAAG,UAAU,CAAC,CAAC,CAAC;CA0J1E"}

package/dist/adapters/postgres.adapter.js

@@ -0,0 +1,229 @@
+"use strict";
+// src/adapters/postgres.adapter.ts
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var PostgresAdapter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresAdapter = void 0;
+const knex_1 = __importDefault(require("knex"));
+const common_1 = require("@nestjs/common");
+/**
+ * PostgreSQL adapter for DatabaseKit.
+ * Handles PostgreSQL connection and repository creation via Knex.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new PostgresAdapter({ type: 'postgres', connectionString: 'postgresql://...' });
+ * adapter.connect();
+ * const repo = adapter.createRepository({ table: 'users', primaryKey: 'id' });
+ * ```
+ */
+let PostgresAdapter = PostgresAdapter_1 = class PostgresAdapter {
+    constructor(config) {
+        this.logger = new common_1.Logger(PostgresAdapter_1.name);
+        this.config = config;
+    }
+    /**
+     * Creates and returns the Knex instance for PostgreSQL.
+     * Connection is lazy-loaded and cached for reuse.
+     *
+     * @param overrides - Additional Knex configuration overrides
+     * @returns Knex instance
+     */
+    connect(overrides = {}) {
+        if (!this.knexInstance) {
+            this.logger.log('Creating PostgreSQL connection pool...');
+            this.knexInstance = (0, knex_1.default)({
+                client: 'pg',
+                connection: this.config.connectionString,
+                pool: { min: 0, max: 10 },
+                ...overrides,
+            });
+            this.logger.log('PostgreSQL connection pool created');
+        }
+        return this.knexInstance;
+    }
+    /**
+     * Gracefully destroys the connection pool.
+     */
+    async disconnect() {
+        if (this.knexInstance) {
+            await this.knexInstance.destroy();
+            this.knexInstance = undefined;
+            this.logger.log('PostgreSQL connection pool destroyed');
+        }
+    }
+    /**
+     * Returns the Knex instance.
+     * Throws if not connected.
+     */
+    getKnex() {
+        if (!this.knexInstance) {
+            throw new Error('PostgreSQL not connected. Call connect() first.');
+        }
+        return this.knexInstance;
+    }
+    /**
+     * Checks if connected to PostgreSQL.
+     */
+    isConnected() {
+        return !!this.knexInstance;
+    }
+    /**
+     * Creates a repository for a PostgreSQL table.
+     * The repository provides a standardized CRUD interface.
+     *
+     * @param cfg - Configuration for the entity/table
+     * @returns Repository instance with CRUD methods
+     */
+    createRepository(cfg) {
+        const kx = this.getKnex();
+        const table = cfg.table;
+        const pk = cfg.primaryKey || 'id';
+        const allowed = cfg.columns || [];
+        const baseFilter = cfg.defaultFilter || {};
+        const assertFieldAllowed = (field) => {
+            if (allowed.length && !allowed.includes(field)) {
+                throw new Error(`Field "${field}" is not allowed for table "${table}". Add it to columns[] in config.`);
+            }
+        };
+        const applyFilter = (qb, filter) => {
+            Object.entries(filter).forEach(([key, value]) => {
+                assertFieldAllowed(key);
+                if (value && typeof value === 'object' && !Array.isArray(value)) {
+                    const ops = value;
+                    if (ops.eq !== undefined)
+                        qb.where(key, ops.eq);
+                    if (ops.ne !== undefined)
+                        qb.whereNot(key, ops.ne);
+                    if (ops.gt !== undefined)
+                        qb.where(key, '>', ops.gt);
+                    if (ops.gte !== undefined)
+                        qb.where(key, '>=', ops.gte);
+                    if (ops.lt !== undefined)
+                        qb.where(key, '<', ops.lt);
+                    if (ops.lte !== undefined)
+                        qb.where(key, '<=', ops.lte);
+                    if (ops.in)
+                        qb.whereIn(key, ops.in);
+                    if (ops.nin)
+                        qb.whereNotIn(key, ops.nin);
+                    if (ops.like)
+                        qb.whereILike(key, `${ops.like}`);
+                    if (ops.isNull === true)
+                        qb.whereNull(key);
+                    if (ops.isNotNull === true)
+                        qb.whereNotNull(key);
+                }
+                else {
+                    qb.where(key, value);
+                }
+            });
+        };
+        const applySort = (qb, sort) => {
+            if (!sort)
+                return;
+            if (typeof sort === 'string') {
+                const parts = sort.split(',');
+                for (const p of parts) {
+                    const dir = p.startsWith('-') ? 'desc' : 'asc';
+                    const col = p.replace(/^[-+]/, '');
+                    assertFieldAllowed(col);
+                    qb.orderBy(col, dir);
+                }
+            }
+            else {
+                Object.entries(sort).forEach(([col, dir]) => {
+                    assertFieldAllowed(col);
+                    const direction = dir === -1 || String(dir).toLowerCase() === 'desc' ? 'desc' : 'asc';
+                    qb.orderBy(col, direction);
+                });
+            }
+        };
+        const shapePage = (data, page, limit, total) => {
+            const pages = Math.max(1, Math.ceil((total || 0) / (limit || 1)));
+            return { data, page, limit, total, pages };
+        };
+        const repo = {
+            async create(data) {
+                const [row] = await kx(table).insert(data).returning('*');
+                return row;
+            },
+            async findById(id) {
+                const row = await kx(table)
+                    .select('*')
+                    .where({ [pk]: id, ...baseFilter })
+                    .first();
+                return row || null;
+            },
+            async findAll(filter = {}) {
+                const mergedFilter = { ...baseFilter, ...filter };
+                const qb = kx(table).select('*');
+                applyFilter(qb, mergedFilter);
+                const rows = await qb;
+                return rows;
+            },
+            async findPage(options = {}) {
+                var _a;
+                const { filter = {}, page = 1, limit = 10, sort } = options;
+                const mergedFilter = { ...baseFilter, ...filter };
+                const offset = Math.max(0, (page - 1) * limit);
+                const qb = kx(table).select('*');
+                applyFilter(qb, mergedFilter);
+                applySort(qb, sort);
+                const data = (await qb.clone().limit(limit).offset(offset));
+                const countRow = await kx(table)
+                    .count({ count: '*' })
+                    .modify((q) => applyFilter(q, mergedFilter));
+                const total = Number(((_a = countRow[0]) === null || _a === void 0 ? void 0 : _a.count) || 0);
+                return shapePage(data, page, limit, total);
+            },
+            async updateById(id, update) {
+                const [row] = await kx(table)
+                    .where({ [pk]: id })
+                    .update(update)
+                    .returning('*');
+                return row || null;
+            },
+            async deleteById(id) {
+                const [row] = await kx(table)
+                    .where({ [pk]: id })
+                    .delete()
+                    .returning('*');
+                return !!row;
+            },
+            async count(filter = {}) {
+                const mergedFilter = { ...baseFilter, ...filter };
+                const [{ count }] = await kx(table)
+                    .count({ count: '*' })
+                    .modify((q) => applyFilter(q, mergedFilter));
+                return Number(count || 0);
+            },
+            async exists(filter = {}) {
+                const mergedFilter = { ...baseFilter, ...filter };
+                const row = await kx(table)
+                    .select([pk])
+                    .modify((q) => applyFilter(q, mergedFilter))
+                    .first();
+                return !!row;
+            },
+        };
+        return repo;
+    }
+};
+exports.PostgresAdapter = PostgresAdapter;
+exports.PostgresAdapter = PostgresAdapter = PostgresAdapter_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [Object])
+], PostgresAdapter);
+//# sourceMappingURL=postgres.adapter.js.map

package/dist/adapters/postgres.adapter.js.map

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

package/dist/config/database.config.d.ts

@@ -0,0 +1,55 @@
+import { DatabaseConfig } from '../contracts/database.contracts';
+/**
+ * Helper class for environment-driven database configuration.
+ * Implements fail-fast pattern with clear error messages.
+ */
+export declare class DatabaseConfigHelper {
+    /**
+     * Gets an environment variable value.
+     * Throws an error if the variable is not set.
+     *
+     * @param name - Environment variable name
+     * @returns The environment variable value
+     * @throws Error if the variable is not configured
+     */
+    static getEnv(name: string): string;
+    /**
+     * Gets an optional environment variable value.
+     *
+     * @param name - Environment variable name
+     * @param defaultValue - Default value if not set
+     * @returns The environment variable value or default
+     */
+    static getEnvOrDefault(name: string, defaultValue: string): string;
+    /**
+     * Gets an environment variable as a number.
+     *
+     * @param name - Environment variable name
+     * @param defaultValue - Default value if not set
+     * @returns The parsed number value
+     */
+    static getEnvAsNumber(name: string, defaultValue: number): number;
+    /**
+     * Builds a database configuration from environment variables.
+     *
+     * @returns DatabaseConfig object
+     * @throws Error if required environment variables are missing
+     */
+    static fromEnv(): DatabaseConfig;
+    /**
+     * Validates a database configuration.
+     *
+     * @param config - The configuration to validate
+     * @throws Error if configuration is invalid
+     */
+    static validate(config: DatabaseConfig): void;
+    /**
+     * Gets the pool size from environment or default.
+     */
+    static getPoolSize(): number;
+    /**
+     * Gets the connection timeout from environment or default.
+     */
+    static getConnectionTimeout(): number;
+}
+//# sourceMappingURL=database.config.d.ts.map

package/dist/config/database.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.config.d.ts","sourceRoot":"","sources":["../../src/config/database.config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAgB,MAAM,iCAAiC,CAAC;AAG/E;;;GAGG;AACH,qBAAa,oBAAoB;IAC7B;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAWnC;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAIlE;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAajE;;;;;OAKG;IACH,MAAM,CAAC,OAAO,IAAI,cAAc;IAsBhC;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAsC7C;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM;IAI5B;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,MAAM;CAMxC"}

package/dist/config/database.config.js

@@ -0,0 +1,122 @@
+"use strict";
+// src/config/database.config.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseConfigHelper = void 0;
+const database_constants_1 = require("./database.constants");
+/**
+ * Helper class for environment-driven database configuration.
+ * Implements fail-fast pattern with clear error messages.
+ */
+class DatabaseConfigHelper {
+    /**
+     * Gets an environment variable value.
+     * Throws an error if the variable is not set.
+     *
+     * @param name - Environment variable name
+     * @returns The environment variable value
+     * @throws Error if the variable is not configured
+     */
+    static getEnv(name) {
+        const value = process.env[name];
+        if (!value) {
+            throw new Error(`Environment variable ${name} is not configured. ` +
+                `Please set it in your .env file or environment.`);
+        }
+        return value;
+    }
+    /**
+     * Gets an optional environment variable value.
+     *
+     * @param name - Environment variable name
+     * @param defaultValue - Default value if not set
+     * @returns The environment variable value or default
+     */
+    static getEnvOrDefault(name, defaultValue) {
+        return process.env[name] || defaultValue;
+    }
+    /**
+     * Gets an environment variable as a number.
+     *
+     * @param name - Environment variable name
+     * @param defaultValue - Default value if not set
+     * @returns The parsed number value
+     */
+    static getEnvAsNumber(name, defaultValue) {
+        const value = process.env[name];
+        if (!value)
+            return defaultValue;
+        const parsed = parseInt(value, 10);
+        if (isNaN(parsed)) {
+            throw new Error(`Environment variable ${name} must be a valid number. Got: ${value}`);
+        }
+        return parsed;
+    }
+    /**
+     * Builds a database configuration from environment variables.
+     *
+     * @returns DatabaseConfig object
+     * @throws Error if required environment variables are missing
+     */
+    static fromEnv() {
+        const type = this.getEnv(database_constants_1.ENV_KEYS.DATABASE_TYPE);
+        if (type !== 'mongo' && type !== 'postgres') {
+            throw new Error(`Invalid DATABASE_TYPE: "${String(type)}". Must be "mongo" or "postgres".`);
+        }
+        if (type === 'mongo') {
+            return {
+                type: 'mongo',
+                connectionString: this.getEnv(database_constants_1.ENV_KEYS.MONGO_URI),
+            };
+        }
+        return {
+            type: 'postgres',
+            connectionString: this.getEnv(database_constants_1.ENV_KEYS.POSTGRES_URI),
+        };
+    }
+    /**
+     * Validates a database configuration.
+     *
+     * @param config - The configuration to validate
+     * @throws Error if configuration is invalid
+     */
+    static validate(config) {
+        // Cast to unknown for runtime validation since config may come from external sources
+        const rawConfig = config;
+        if (!rawConfig.type) {
+            throw new Error('Database configuration must include a type');
+        }
+        if (rawConfig.type !== 'mongo' && rawConfig.type !== 'postgres') {
+            throw new Error(`Invalid database type: "${rawConfig.type}". Must be "mongo" or "postgres".`);
+        }
+        if (!rawConfig.connectionString) {
+            throw new Error('Database configuration must include a connectionString');
+        }
+        // Basic connection string validation
+        if (config.type === 'mongo') {
+            if (!config.connectionString.startsWith('mongodb://') &&
+                !config.connectionString.startsWith('mongodb+srv://')) {
+                throw new Error('MongoDB connection string must start with "mongodb://" or "mongodb+srv://"');
+            }
+        }
+        if (config.type === 'postgres') {
+            if (!config.connectionString.startsWith('postgresql://') &&
+                !config.connectionString.startsWith('postgres://')) {
+                throw new Error('PostgreSQL connection string must start with "postgresql://" or "postgres://"');
+            }
+        }
+    }
+    /**
+     * Gets the pool size from environment or default.
+     */
+    static getPoolSize() {
+        return this.getEnvAsNumber(database_constants_1.ENV_KEYS.POOL_SIZE, database_constants_1.DEFAULTS.POOL_SIZE);
+    }
+    /**
+     * Gets the connection timeout from environment or default.
+     */
+    static getConnectionTimeout() {
+        return this.getEnvAsNumber(database_constants_1.ENV_KEYS.CONNECTION_TIMEOUT, database_constants_1.DEFAULTS.CONNECTION_TIMEOUT);
+    }
+}
+exports.DatabaseConfigHelper = DatabaseConfigHelper;
+//# sourceMappingURL=database.config.js.map

package/dist/config/database.config.js.map

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