@common-stack/store-mongo 8.0.2-alpha.0 → 8.2.1-alpha.0

package/LICENSE

@@ -1,21 +1,34 @@
-The MIT License
-
-Copyright (c) 2017 CDMBase LLC.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+PROPRIETARY LICENSE
+
+Copyright (c) 2017-2025 CDMBase LLC. All Rights Reserved.
+
+This software and associated documentation files (the "Software") are the 
+proprietary and confidential information of CDMBase LLC ("Confidential Information").
+
+NOTICE: All information contained herein is, and remains the property of 
+CDMBase LLC. The intellectual and technical concepts contained herein are 
+proprietary to CDMBase LLC and may be covered by U.S. and Foreign Patents, 
+patents in process, and are protected by trade secret or copyright law.
+
+Dissemination of this information or reproduction of this material is strictly 
+forbidden unless prior written permission is obtained from CDMBase LLC.
+
+NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL 
+PROPERTY RIGHTS ARE GRANTED BY THIS DOCUMENT.
+
+RESTRICTIONS:
+1. You may NOT use, copy, modify, merge, publish, distribute, sublicense, 
+   and/or sell copies of the Software without explicit written permission 
+   from CDMBase LLC.
+2. You may NOT reverse engineer, decompile, or disassemble the Software.
+3. You may NOT remove or alter any proprietary notices or labels on the Software.
+4. The Software is licensed, not sold.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
+CDMBASE LLC BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN 
+AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN 
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+For licensing inquiries, please contact: legal@cdmbase.com

package/lib/containers/container.d.ts

@@ -0,0 +1,14 @@
+import { interfaces } from 'inversify';
+/**
+ * Local services and exposed microservices to serve remote connections.
+ * Operates within in the Gateway.
+ *
+ */
+export declare const localContainerModule: (settings: any) => interfaces.ContainerModule;
+/**
+ * Operates external to the Gateway. Usually a broker listen to calls and invoke this service
+ * local to the micro container.
+ *
+ * @param settings Settings
+ */
+export declare const externalContainerModule: (settings: any) => interfaces.ContainerModule;

package/lib/containers/container.js

@@ -0,0 +1,17 @@
+import {ContainerModule}from'inversify';import {SERVER_TYPES}from'common/server';import {BaseMongoRepository}from'../store/repositories/BaseMongoRepository.js';import'../store/repositories/base-repository.js';/**
+ * Local services and exposed microservices to serve remote connections.
+ * Operates within in the Gateway.
+ *
+ */
+const localContainerModule = () => new ContainerModule((bind) => {
+    bind(SERVER_TYPES.BaseMongoRepository).to(BaseMongoRepository).inSingletonScope().whenTargetIsDefault();
+});
+/**
+ * Operates external to the Gateway. Usually a broker listen to calls and invoke this service
+ * local to the micro container.
+ *
+ * @param settings Settings
+ */
+const externalContainerModule = () => new ContainerModule((bind) => {
+    bind(SERVER_TYPES.BaseMongoRepository).to(BaseMongoRepository).inSingletonScope().whenTargetIsDefault();
+});export{externalContainerModule,localContainerModule};//# sourceMappingURL=container.js.map

package/lib/containers/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sources":["../../src/containers/container.ts"],"sourcesContent":["import { ContainerModule, interfaces } from 'inversify';\nimport { SERVER_TYPES } from 'common/server';\nimport { BaseMongoRepository } from '../store';\n\n/**\n * Local services and exposed microservices to serve remote connections.\n * Operates within in the Gateway.\n *\n */\nexport const localContainerModule: (settings) => interfaces.ContainerModule = () =>\n    new ContainerModule((bind: interfaces.Bind) => {\n        bind(SERVER_TYPES.BaseMongoRepository).to(BaseMongoRepository).inSingletonScope().whenTargetIsDefault();\n    });\n\n/**\n * Operates external to the Gateway. Usually a broker listen to calls and invoke this service\n * local to the micro container.\n *\n * @param settings Settings\n */\nexport const externalContainerModule: (settings) => interfaces.ContainerModule = () =>\n    new ContainerModule((bind: interfaces.Bind) => {\n        bind(SERVER_TYPES.BaseMongoRepository).to(BaseMongoRepository).inSingletonScope().whenTargetIsDefault();\n    });\n"],"names":[],"mappings":"iNAIA;;;;AAIG;AACI,MAAM,oBAAoB,GAA6C,MAC1E,IAAI,eAAe,CAAC,CAAC,IAAqB,KAAI;AAC1C,IAAA,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,gBAAgB,EAAE,CAAC,mBAAmB,EAAE,CAAC;AAC5G,CAAC,EAAE;AAEP;;;;;AAKG;AACI,MAAM,uBAAuB,GAA6C,MAC7E,IAAI,eAAe,CAAC,CAAC,IAAqB,KAAI;AAC1C,IAAA,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,gBAAgB,EAAE,CAAC,mBAAmB,EAAE,CAAC;AAC5G,CAAC"}

package/lib/containers/index.d.ts

@@ -0,0 +1 @@
+export * from './container';

package/lib/dataloaders/bulk-dataloader-v2.d.ts

@@ -0,0 +1,40 @@
+import DataLoader from 'dataloader';
+import { IBaseService, IDataLoader, AsDomainType } from 'common/server';
+/**
+ * BulkDataLoader2 with Dual ID System Support
+ *
+ * Supports both ObjectId and UUID lookups:
+ * - ObjectId: MongoDB's native `_id` field
+ * - UUID: External identifier stored as `<collection>Id` (e.g., projectId, organizationId)
+ *
+ * The loader automatically detects the ID format and queries appropriately:
+ * - UUIDs contain hyphens (e.g., "550e8400-e29b-41d4-a957-446655440000")
+ * - ObjectIds are 24-character hex strings (e.g., "507f1f77bcf86cd799439011")
+ */
+export declare class BulkDataLoader2<SchemaType> extends DataLoader<string, AsDomainType<SchemaType> | null> implements IDataLoader<SchemaType> {
+    private readonly service;
+    /**
+     * Optional UUID field name for this collection (e.g., 'projectId', 'organizationId')
+     * If not provided, the loader will only support ObjectId lookups
+     */
+    private readonly uuidFieldName?;
+    constructor(service: IBaseService<SchemaType>, uuidFieldName?: string);
+    /**
+     * Detects if an ID is a UUID (contains hyphens) or ObjectId (24-char hex)
+     */
+    private isUUID;
+    /**
+     * Detects if an ID is a valid ObjectId
+     */
+    private isObjectId;
+    /**
+     * Loads records by IDs, supporting both UUID and ObjectId formats
+     * Performs a single query with $or conditions for efficient lookup
+     */
+    private loadByIds;
+    /**
+     * Finds a record by ID, checking both ObjectId and UUID fields
+     */
+    private findRecordById;
+    withOptions: DataLoader<DataLoaderOptions<SchemaType>, AsDomainType<SchemaType>[], DataLoaderOptions<SchemaType>>;
+}

package/lib/dataloaders/bulk-dataloader-v2.js

@@ -0,0 +1,118 @@
+import {__decorate,__param,__metadata}from'tslib';import DataLoader from'dataloader';import {injectable,unmanaged}from'inversify';import {Types}from'mongoose';import {IBaseService}from'common/server';var _a;
+/**
+ * BulkDataLoader2 with Dual ID System Support
+ *
+ * Supports both ObjectId and UUID lookups:
+ * - ObjectId: MongoDB's native `_id` field
+ * - UUID: External identifier stored as `<collection>Id` (e.g., projectId, organizationId)
+ *
+ * The loader automatically detects the ID format and queries appropriately:
+ * - UUIDs contain hyphens (e.g., "550e8400-e29b-41d4-a957-446655440000")
+ * - ObjectIds are 24-character hex strings (e.g., "507f1f77bcf86cd799439011")
+ */
+let BulkDataLoader2 = class BulkDataLoader2 extends DataLoader {
+    service;
+    /**
+     * Optional UUID field name for this collection (e.g., 'projectId', 'organizationId')
+     * If not provided, the loader will only support ObjectId lookups
+     */
+    uuidFieldName;
+    constructor(service, uuidFieldName) {
+        super(async (ids) => {
+            const data = await this.loadByIds(ids);
+            return ids.map((id) => this.findRecordById(data, id));
+        });
+        this.service = service;
+        this.uuidFieldName = uuidFieldName;
+    }
+    /**
+     * Detects if an ID is a UUID (contains hyphens) or ObjectId (24-char hex)
+     */
+    isUUID(id) {
+        return id.includes('-');
+    }
+    /**
+     * Detects if an ID is a valid ObjectId
+     */
+    isObjectId(id) {
+        return Types.ObjectId.isValid(id) && !this.isUUID(id);
+    }
+    /**
+     * Loads records by IDs, supporting both UUID and ObjectId formats
+     * Performs a single query with $or conditions for efficient lookup
+     */
+    async loadByIds(ids) {
+        // Separate UUIDs and ObjectIds for optimized querying
+        const uuidIds = [];
+        const objectIds = [];
+        ids.forEach((id) => {
+            if (this.isUUID(id)) {
+                uuidIds.push(id);
+            }
+            else if (this.isObjectId(id)) {
+                objectIds.push(id);
+            }
+        });
+        // If no UUID field is configured, only support ObjectId lookups
+        if (!this.uuidFieldName && uuidIds.length > 0) {
+            console.warn(`[BulkDataLoader2] UUID IDs detected but no uuidFieldName configured. UUIDs will not be resolved: ${uuidIds.join(', ')}`);
+        }
+        // Build query criteria using $or for mixed ID types
+        const criteria = [];
+        if (objectIds.length > 0) {
+            // Query by _id (ObjectId)
+            criteria.push({ _id: { $in: objectIds } });
+        }
+        if (uuidIds.length > 0 && this.uuidFieldName) {
+            // Query by UUID field (e.g., projectId, organizationId)
+            criteria.push({ [this.uuidFieldName]: { $in: uuidIds } });
+        }
+        // If no valid IDs, return empty array
+        if (criteria.length === 0) {
+            return [];
+        }
+        // Execute query with $or combining both lookup strategies
+        const query = criteria.length === 1 ? criteria[0] : { $or: criteria };
+        return await this.service.getAll({ criteria: query });
+    }
+    /**
+     * Finds a record by ID, checking both ObjectId and UUID fields
+     */
+    findRecordById(records, id) {
+        return (records.find((record) => {
+            // Check if ID matches the record's id field (transformed from _id)
+            if (record.id === id) {
+                return true;
+            }
+            // If UUID field is configured, check that field too
+            if (this.uuidFieldName && record[this.uuidFieldName] === id) {
+                return true;
+            }
+            return false;
+        }) || null);
+    }
+    withOptions = new DataLoader(async (options) => {
+        const [{ searchKey, comparator, ...rest }] = options;
+        const ids = options.map((option) => option.id);
+        // Create a properly typed criteria object with explicit type assertion
+        const criteria = {
+            ...(rest.criteria || {}),
+            [searchKey]: { $in: ids },
+        };
+        const results = await this.service.getAll({
+            ...rest,
+            criteria,
+        });
+        return options.map((option) => results.filter((item) => {
+            if (typeof comparator === 'function')
+                return comparator(option, item);
+            return item[searchKey]?.toString() === option.id.toString();
+        }));
+    });
+};
+BulkDataLoader2 = __decorate([
+    injectable(),
+    __param(0, unmanaged()),
+    __param(1, unmanaged()),
+    __metadata("design:paramtypes", [typeof (_a = typeof IBaseService !== "undefined" && IBaseService) === "function" ? _a : Object, String])
+], BulkDataLoader2);export{BulkDataLoader2};//# sourceMappingURL=bulk-dataloader-v2.js.map

package/lib/dataloaders/bulk-dataloader-v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-dataloader-v2.js","sources":["../../src/dataloaders/bulk-dataloader-v2.ts"],"sourcesContent":["/* eslint-disable import/no-extraneous-dependencies */\nimport DataLoader from 'dataloader';\nimport { injectable, unmanaged } from 'inversify';\nimport { FilterQuery, Types } from 'mongoose';\nimport { IBaseService, IDataLoader, AsDomainType, DataLoaderOptions } from 'common/server';\n\n/**\n * BulkDataLoader2 with Dual ID System Support\n *\n * Supports both ObjectId and UUID lookups:\n * - ObjectId: MongoDB's native `_id` field\n * - UUID: External identifier stored as `<collection>Id` (e.g., projectId, organizationId)\n *\n * The loader automatically detects the ID format and queries appropriately:\n * - UUIDs contain hyphens (e.g., \"550e8400-e29b-41d4-a957-446655440000\")\n * - ObjectIds are 24-character hex strings (e.g., \"507f1f77bcf86cd799439011\")\n */\n@injectable()\nexport class BulkDataLoader2<SchemaType>\n    extends DataLoader<string, AsDomainType<SchemaType> | null>\n    implements IDataLoader<SchemaType>\n{\n    /**\n     * Optional UUID field name for this collection (e.g., 'projectId', 'organizationId')\n     * If not provided, the loader will only support ObjectId lookups\n     */\n    private readonly uuidFieldName?: string;\n\n    constructor(\n        @unmanaged() private readonly service: IBaseService<SchemaType>,\n        @unmanaged() uuidFieldName?: string,\n    ) {\n        super(async (ids: string[]) => {\n            const data = await this.loadByIds(ids);\n            return ids.map((id) => this.findRecordById(data, id));\n        });\n        this.uuidFieldName = uuidFieldName;\n    }\n\n    /**\n     * Detects if an ID is a UUID (contains hyphens) or ObjectId (24-char hex)\n     */\n    private isUUID(id: string): boolean {\n        return id.includes('-');\n    }\n\n    /**\n     * Detects if an ID is a valid ObjectId\n     */\n    private isObjectId(id: string): boolean {\n        return Types.ObjectId.isValid(id) && !this.isUUID(id);\n    }\n\n    /**\n     * Loads records by IDs, supporting both UUID and ObjectId formats\n     * Performs a single query with $or conditions for efficient lookup\n     */\n    private async loadByIds(ids: string[]): Promise<AsDomainType<SchemaType>[]> {\n        // Separate UUIDs and ObjectIds for optimized querying\n        const uuidIds: string[] = [];\n        const objectIds: string[] = [];\n\n        ids.forEach((id) => {\n            if (this.isUUID(id)) {\n                uuidIds.push(id);\n            } else if (this.isObjectId(id)) {\n                objectIds.push(id);\n            }\n        });\n\n        // If no UUID field is configured, only support ObjectId lookups\n        if (!this.uuidFieldName && uuidIds.length > 0) {\n            console.warn(\n                `[BulkDataLoader2] UUID IDs detected but no uuidFieldName configured. UUIDs will not be resolved: ${uuidIds.join(', ')}`,\n            );\n        }\n\n        // Build query criteria using $or for mixed ID types\n        const criteria: FilterQuery<SchemaType>[] = [];\n\n        if (objectIds.length > 0) {\n            // Query by _id (ObjectId)\n            criteria.push({ _id: { $in: objectIds } } as FilterQuery<SchemaType>);\n        }\n\n        if (uuidIds.length > 0 && this.uuidFieldName) {\n            // Query by UUID field (e.g., projectId, organizationId)\n            criteria.push({ [this.uuidFieldName]: { $in: uuidIds } } as FilterQuery<SchemaType>);\n        }\n\n        // If no valid IDs, return empty array\n        if (criteria.length === 0) {\n            return [];\n        }\n\n        // Execute query with $or combining both lookup strategies\n        const query: FilterQuery<SchemaType> =\n            criteria.length === 1 ? criteria[0] : ({ $or: criteria } as FilterQuery<SchemaType>);\n\n        return await this.service.getAll({ criteria: query });\n    }\n\n    /**\n     * Finds a record by ID, checking both ObjectId and UUID fields\n     */\n    private findRecordById(records: AsDomainType<SchemaType>[], id: string): AsDomainType<SchemaType> | null {\n        return (\n            records.find((record) => {\n                // Check if ID matches the record's id field (transformed from _id)\n                if (record.id === id) {\n                    return true;\n                }\n\n                // If UUID field is configured, check that field too\n                if (this.uuidFieldName && (record as any)[this.uuidFieldName] === id) {\n                    return true;\n                }\n\n                return false;\n            }) || null\n        );\n    }\n\n    withOptions = new DataLoader<DataLoaderOptions<SchemaType>, AsDomainType<SchemaType>[]>(async (options) => {\n        const [{ searchKey, comparator, ...rest }] = options;\n        const ids = options.map((option) => option.id);\n\n        // Create a properly typed criteria object with explicit type assertion\n        const criteria = {\n            ...(rest.criteria || {}),\n            [searchKey as string]: { $in: ids },\n        } as FilterQuery<SchemaType>;\n\n        const results = await this.service.getAll({\n            ...rest,\n            criteria,\n        });\n\n        return options.map((option) =>\n            results.filter((item) => {\n                if (typeof comparator === 'function') return comparator(option, item);\n                return item[searchKey as keyof AsDomainType<SchemaType>]?.toString() === option.id.toString();\n            }),\n        );\n    });\n}\n"],"names":[],"mappings":"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"}

package/lib/dataloaders/bulk-dataloader-v2.test.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/lib/dataloaders/bulk-dataloader.d.ts

@@ -1,5 +1,5 @@
 import DataLoader from 'dataloader';
-import { DataLoaderOptions, IBaseService, IDataLoader } from '../interfaces';
+import { DataLoaderOptions, IBaseService, IDataLoader } from '../interfaces/index.old';
 export declare class BulkDataLoader<T extends {
     id: string;
 }> extends DataLoader<string, T | null> implements IDataLoader<T> {

package/lib/dataloaders/bulk-dataloader.js.map

@@ -1 +1 @@
-{"version":3,"file":"bulk-dataloader.js","sources":["../../src/dataloaders/bulk-dataloader.ts"],"sourcesContent":[null],"names":[],"mappings":"kIAKO,IAAM,cAAc,GAApB,MAAM,cAAyC,SAAQ,UAA4B,CAAA;AAC5C,IAAA,OAAA,CAAA;AAA1C,IAAA,WAAA,CAA0C,OAAwB,EAAA;AAC9D,QAAA,KAAK,CAAC,OAAO,GAAa,KAAI;YAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC;AAC5E,SAAC,CAAC,CAAC;QAJmC,IAAO,CAAA,OAAA,GAAP,OAAO,CAAiB;KAKjE;IAED,WAAW,GAAG,IAAI,UAAU,CAA4B,OAAO,OAAO,KAAI;AACtE,QAAA,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;AACrD,QAAA,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;AACtC,YAAA,GAAG,IAAI;AACP,YAAA,QAAQ,EAAE;gBACN,GAAG,IAAI,CAAC,QAAQ;AAChB,gBAAA,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;AAC5B,aAAA;AACJ,SAAA,CAAC,CAAC;AACH,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,KACtB,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,KAAI;YACpB,IAAI,OAAO,UAAU,KAAK,UAAU;AAAE,gBAAA,OAAO,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACtE,YAAA,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;SAC9D,CAAC,CACL,CAAC;AACN,KAAC,CAAC,CAAC;EACN;AAzBY,cAAc,GAAA,UAAA,CAAA;AAD1B,IAAA,UAAU,EAAE;IAEI,OAAA,CAAA,CAAA,EAAA,SAAS,EAAE,CAAA;;AADf,CAAA,EAAA,cAAc,CAyB1B"}
+{"version":3,"file":"bulk-dataloader.js","sources":["../../src/dataloaders/bulk-dataloader.ts"],"sourcesContent":["import DataLoader from 'dataloader';\nimport { injectable, unmanaged } from 'inversify';\nimport { DataLoaderOptions, IBaseService, IDataLoader } from '../interfaces/index.old';\n\n@injectable()\nexport class BulkDataLoader<T extends { id: string }> extends DataLoader<string, T | null> implements IDataLoader<T> {\n    constructor(@unmanaged() private readonly service: IBaseService<T>) {\n        super(async (ids: string[]) => {\n            const data = await this.service.getByIds(ids);\n            return ids.map((id) => data.find((record) => record.id === id) || null);\n        });\n    }\n\n    withOptions = new DataLoader<DataLoaderOptions<T>, T[]>(async (options) => {\n        const [{ searchKey, comparator, ...rest }] = options;\n        const ids = options.map((option) => option.id);\n        const results = await this.service.getAll({\n            ...rest,\n            criteria: {\n                ...rest.criteria,\n                [searchKey]: { $in: ids },\n            },\n        });\n        return options.map((option) =>\n            results.filter((item) => {\n                if (typeof comparator === 'function') return comparator(option, item);\n                return item[searchKey].toString() === option.id.toString();\n            }),\n        );\n    });\n}\n"],"names":[],"mappings":"kIAKO,IAAM,cAAc,GAApB,MAAM,cAAyC,SAAQ,UAA4B,CAAA;AAC5C,IAAA,OAAA,CAAA;AAA1C,IAAA,WAAA,CAA0C,OAAwB,EAAA;AAC9D,QAAA,KAAK,CAAC,OAAO,GAAa,KAAI;YAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC;AAC5E,SAAC,CAAC,CAAC;QAJmC,IAAO,CAAA,OAAA,GAAP,OAAO,CAAiB;KAKjE;IAED,WAAW,GAAG,IAAI,UAAU,CAA4B,OAAO,OAAO,KAAI;AACtE,QAAA,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;AACrD,QAAA,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;AACtC,YAAA,GAAG,IAAI;AACP,YAAA,QAAQ,EAAE;gBACN,GAAG,IAAI,CAAC,QAAQ;AAChB,gBAAA,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;AAC5B,aAAA;AACJ,SAAA,CAAC,CAAC;AACH,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,KACtB,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,KAAI;YACpB,IAAI,OAAO,UAAU,KAAK,UAAU;AAAE,gBAAA,OAAO,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACtE,YAAA,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;SAC9D,CAAC,CACL,CAAC;AACN,KAAC,CAAC,CAAC;EACN;AAzBY,cAAc,GAAA,UAAA,CAAA;AAD1B,IAAA,UAAU,EAAE;IAEI,OAAA,CAAA,CAAA,EAAA,SAAS,EAAE,CAAA;;AADf,CAAA,EAAA,cAAc,CAyB1B"}

package/lib/dataloaders/bulk-dataloader.test.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/lib/dataloaders/index.d.ts

@@ -1 +1,2 @@
+export * from './bulk-dataloader-v2';
 export * from './bulk-dataloader';

package/lib/graphql/schema/base-services.graphql

@@ -1,15 +1,253 @@
+"""
+Standard service commands that represent the core CRUD operations available in the BaseServiceMixin.
+These commands are used as action names in Moleculer services and for event emission.
+They provide a consistent API across all services for common data operations.
+"""
 enum BaseServiceCommands {
+    """
+    Count documents matching criteria
+    
+    This command counts entities matching the provided filter criteria.
+    It maps to the IBaseService.count method and handles parameter validation.
+    
+    Example:
+    ```
+    // Count active users
+    const count = await broker.call('users.count', { 
+      criteria: { active: true } 
+    });
+    ```
+    """
     count
+    
+    """
+    Get a single document by ID or criteria
+    
+    This command retrieves a single entity by its unique identifier.
+    It maps to the IBaseService.get method and handles parameter validation.
+    
+    Example:
+    ```
+    // Get user by ID
+    const user = await broker.call('users.get', { id: '123' });
+    
+    // Get user by email
+    const user = await broker.call('users.get', { 
+      criteria: { email: 'user@example.com' } 
+    });
+    ```
+    """
     get
+    
+    """
+    Get documents with pagination
+    
+    This command retrieves multiple entities with filtering, sorting, and pagination.
+    It maps to the IBaseService.getAll method and handles parameter validation.
+    
+    Example:
+    ```
+    // Get active users sorted by creation date
+    const users = await broker.call('users.getAll', {
+      criteria: { active: true },
+      sort: { createdAt: -1 },
+      skip: 0,
+      limit: 10
+    });
+    ```
+    """
     getAll
+    
+    """
+    Get a single document by name field
+    
+    This command retrieves a single entity by its name field.
+    It maps to the IBaseService.getByName method and handles parameter validation.
+    Commonly used for entities that have a unique name identifier.
+    
+    Example:
+    ```
+    // Get product by name
+    const product = await broker.call('products.getByName', { 
+      name: 'Premium Subscription' 
+    });
+    ```
+    """
     getByName
+    
+    """
+    Get multiple documents by their IDs
+    
+    This command retrieves multiple entities by their unique identifiers.
+    It maps to the IBaseService.getByIds method and handles parameter validation.
+    Useful for retrieving a specific set of entities in a single operation.
+    
+    Example:
+    ```
+    // Get multiple users by their IDs
+    const users = await broker.call('users.getByIds', { 
+      ids: ['user1', 'user2', 'user3'] 
+    });
+    ```
+    """
     getByIds
+    
+    """
+    Create a single document
+    
+    This command creates a single entity.
+    It maps to the IBaseService.create method and handles parameter validation.
+    It also emits an event for the created entity if configured.
+    
+    Example:
+    ```
+    // Create a new user
+    const user = await broker.call('users.create', {
+      data: { name: 'John', email: 'john@example.com' }
+    });
+    ```
+    """
     create
+    
+    """
+    Create or update a document
+    
+    This command creates a new entity or updates an existing one if an ID is provided.
+    It maps to the IBaseService.insert method and handles parameter validation.
+    It also emits an event for the created or updated entity if configured.
+    
+    Example:
+    ```
+    // Create a new product
+    const newProduct = await broker.call('products.insert', {
+      data: { name: 'New Product', price: 99.99 }
+    });
+    
+    // Update an existing product
+    const updatedProduct = await broker.call('products.insert', {
+      data: { id: 'product123', name: 'Updated Product', price: 129.99 }
+    });
+    ```
+    """
     insert
+    
+    """
+    Create multiple documents
+    
+    This command creates multiple entities in a single operation.
+    It maps to the IBaseService.bulkCreate method and handles parameter validation.
+    It also emits events for the created entities if configured.
+    
+    Example:
+    ```
+    // Create multiple users
+    const users = await broker.call('users.bulkCreate', {
+      data: [
+        { name: 'John', email: 'john@example.com' },
+        { name: 'Jane', email: 'jane@example.com' }
+      ]
+    });
+    ```
+    """
     bulkCreate
+    
+    """
+    Update a document by ID
+    
+    This command updates an existing entity by its unique identifier.
+    It maps to the IBaseService.update method and handles parameter validation.
+    It also emits an event for the updated entity if configured.
+    
+    Example:
+    ```
+    // Update a user's role
+    const updatedUser = await broker.call('users.update', {
+      id: 'user123',
+      data: { role: 'admin', active: true }
+    });
+    
+    // Replace a user document entirely
+    const replacedUser = await broker.call('users.update', {
+      id: 'user123',
+      data: { name: 'New Name', email: 'new@example.com', role: 'user' },
+      overwrite: true
+    });
+    ```
+    """
     update
+    
+    """
+    Delete a document by ID
+    
+    This command deletes a single entity by its unique identifier.
+    It maps to the IBaseService.delete method and handles parameter validation.
+    It also emits an event for the deleted entity if configured.
+    
+    Example:
+    ```
+    // Delete a user
+    const success = await broker.call('users.delete', { id: '123' });
+    ```
+    """
     delete
+    
+    """
+    Delete multiple documents by IDs
+    
+    This command deletes multiple entities by their unique identifiers.
+    It maps to the IBaseService.bulkDelete method and handles parameter validation.
+    It also emits events for the deleted entities if configured.
+    
+    Example:
+    ```
+    // Delete multiple users
+    const deletedCount = await broker.call('users.BulkDelete', { 
+      ids: ['user1', 'user2', 'user3'] 
+    });
+    ```
+    """
+    BulkDelete
+    
+    """
+    Delete multiple documents matching criteria
+    
+    This command deletes multiple entities matching the provided filter criteria.
+    It maps to the IBaseService.delete method and handles parameter validation.
+    It also emits an event with the deletion criteria if configured.
+    
+    Example:
+    ```
+    // Delete all inactive users
+    const deletedCount = await broker.call('users.deleteMany', {
+      criteria: { active: false }
+    });
+    
+    // Delete users with a specific role
+    const deletedCount = await broker.call('users.deleteMany', {
+      criteria: { role: 'guest' }
+    });
+    ```
+    """
     deleteMany
+    
+    """
+    Get documents with pagination and total count
+    
+    This command retrieves multiple entities with filtering, sorting, pagination,
+    and includes the total count of matching documents (useful for UI pagination).
+    It maps to the IBaseService.getAllWithCount method and handles parameter validation.
+    
+    Example:
+    ```
+    // Get paginated users with total count for UI pagination
+    const { data, totalCount } = await broker.call('users.getAllWithCount', {
+      criteria: { role: 'user' },
+      skip: 20,
+      limit: 10,
+      sort: { createdAt: -1 }
+    });
+    ```
+    """
     getAllWithCount
 }
 

package/lib/helpers/mongoose-connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"mongoose-connection.js","sources":["../../src/helpers/mongoose-connection.ts"],"sourcesContent":[null],"names":[],"mappings":"kCAEA,MAAM,aAAa,GAAqC,CAAC,QAAQ,KAAI;;IAEjE,QAAQ;AACH,SAAA,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,IAAI,CAAC,MAAK;AACP,QAAA,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;;;AAG9C,KAAC,CAAC;AACD,SAAA,KAAK,CAAC,CAAC,GAAmB,KAAI;AAC3B,QAAA,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;;AAEjD,QAAA,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC9B,KAAC,CAAC,CAAC;;AAEP,IAAA,MAAM,kBAAkB,GAAwB,QAAQ,CAAC,UAAU,CAAC;AAEpE,IAAA,OAAO,kBAAkB,CAAC;AAC9B"}
+{"version":3,"file":"mongoose-connection.js","sources":["../../src/helpers/mongoose-connection.ts"],"sourcesContent":["import * as mongoose from 'mongoose';\n\nconst generateMongo: (monoUrl) => mongoose.Connection = (mongoUrl) => {\n    // creates default connection\n    mongoose\n        .connect(mongoUrl, {})\n        .then(() => {\n            console.info('mogoose connect - success');\n            // console.info(`uri - ${uri}`);\n            // console.info(`connectionOptions - ${connectionOptions}`);\n        })\n        .catch((err: mongoose.Error) => {\n            console.error('mogoose connect - error - ', err);\n            // throw err;\n            process.kill(process.pid);\n        });\n    // to access default connection\n    const mongooseConnection: mongoose.Connection = mongoose.connection;\n\n    return mongooseConnection;\n};\n\nexport { generateMongo };\n"],"names":[],"mappings":"kCAEA,MAAM,aAAa,GAAqC,CAAC,QAAQ,KAAI;;IAEjE,QAAQ;AACH,SAAA,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,IAAI,CAAC,MAAK;AACP,QAAA,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;;;AAG9C,KAAC,CAAC;AACD,SAAA,KAAK,CAAC,CAAC,GAAmB,KAAI;AAC3B,QAAA,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;;AAEjD,QAAA,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC9B,KAAC,CAAC,CAAC;;AAEP,IAAA,MAAM,kBAAkB,GAAwB,QAAQ,CAAC,UAAU,CAAC;AAEpE,IAAA,OAAO,kBAAkB,CAAC;AAC9B"}

package/lib/index.d.ts

@@ -1,6 +1,7 @@
-export * from './interfaces';
 export * from './helpers';
 export * from './services';
 export * from './store';
 export * from './dataloaders';
 export * from './mixins';
+export * from './interfaces';
+export * from './interfaces/index.old';

package/lib/index.js

@@ -1 +1 @@
-export{PAGINATION_OPTIONS}from'./interfaces/base-repository.js';export{generateMongo}from'./helpers/mongoose-connection.js';export{BaseService}from'./services/base-service.js';export{BaseProxyService}from'./services/base-proxy-service.js';export{addIdVirtualFields,commonModeSchemaOptions}from'./store/models/common-options.js';export{BaseRepository}from'./store/repositories/base-repository.js';export{BulkDataLoader}from'./dataloaders/bulk-dataloader.js';export{BaseServiceMixin}from'./mixins/base-service-mixin.js';//# sourceMappingURL=index.js.map
+export{generateMongo}from'./helpers/mongoose-connection.js';export{BaseService2}from'./services/BaseService.js';export{BaseProxyService2}from'./services/BaseProxyService.js';export{ConnectionPoolManager}from'./services/ConnectionPoolManager.js';export{BaseService}from'./services/base-service.js';export{BaseProxyService}from'./services/base-proxy-service.js';export{addIdVirtualFields2,commonModelSchemaOptions2}from'./store/models/common-options-v2.js';export{addIdVirtualFields,commonModeSchemaOptions}from'./store/models/common-options.js';export{BaseMongoRepository}from'./store/repositories/BaseMongoRepository.js';export{BaseRepository}from'./store/repositories/base-repository.js';export{BulkDataLoader2}from'./dataloaders/bulk-dataloader-v2.js';export{BulkDataLoader}from'./dataloaders/bulk-dataloader.js';export{BaseServiceMixin as BaseServiceMixin2}from'./mixins/BaseServiceMixin.js';export{BaseServiceMixin}from'./mixins/base-service-mixin.js';export{PAGINATION_OPTIONS}from'./interfaces/getAllArgs.js';//# sourceMappingURL=index.js.map

package/lib/interfaces/base-repository.d.ts

@@ -1,9 +1,5 @@
 import { Document, FilterQuery, Model, UpdateQuery } from 'mongoose';
-import { GetAllArgs } from './get-all-args';
-export declare enum PAGINATION_OPTIONS {
-    limit = 10,
-    skip = 0
-}
+import { GetAllArgs } from './getAllArgs';
 export interface IBaseRepository<T, D = Document<T>> {
     model: Model<D>;
     count(conditions?: FilterQuery<D>): Promise<number>;

package/lib/interfaces/base-service.d.ts

@@ -1,5 +1,5 @@
 import { FilterQuery, Document } from 'mongoose';
-import { GetAllArgs } from './get-all-args';
+import { GetAllArgs } from './getAllArgs';
 export interface IBaseService<T, C = Omit<T, 'id'>, U = C> {
     count(conditions?: FilterQuery<Document<T>>): Promise<number>;
     get(id: string): Promise<T>;