@common-stack/store-mongo 7.1.1-alpha.4 → 7.1.1-alpha.41

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,7 @@
+import DataLoader from 'dataloader';
+import { IBaseService, IDataLoader, AsDomainType } from 'common/server';
+export declare class BulkDataLoader2<SchemaType> extends DataLoader<string, AsDomainType<SchemaType> | null> implements IDataLoader<SchemaType> {
+    private readonly service;
+    constructor(service: IBaseService<SchemaType>);
+    withOptions: DataLoader<DataLoaderOptions<SchemaType>, AsDomainType<SchemaType>[], DataLoaderOptions<SchemaType>>;
+}

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

@@ -0,0 +1,34 @@
+import {__decorate,__param,__metadata}from'tslib';import DataLoader from'dataloader';import {injectable,unmanaged}from'inversify';import {IBaseService}from'common/server';var _a;
+let BulkDataLoader2 = class BulkDataLoader2 extends DataLoader {
+    service;
+    constructor(service) {
+        super(async (ids) => {
+            const data = await this.service.getByIds(ids);
+            return ids.map((id) => data.find((record) => record.id === id) || null);
+        });
+        this.service = service;
+    }
+    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()),
+    __metadata("design:paramtypes", [typeof (_a = typeof IBaseService !== "undefined" && IBaseService) === "function" ? _a : Object])
+], 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 } from 'mongoose';\nimport { IBaseService, IDataLoader, AsDomainType, DataLoaderOptions } from 'common/server';\n\n@injectable()\nexport class BulkDataLoader2<SchemaType>\n    extends DataLoader<string, AsDomainType<SchemaType> | null>\n    implements IDataLoader<SchemaType>\n{\n    constructor(@unmanaged() private readonly service: IBaseService<SchemaType>) {\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<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":";AAOO,IAAM,eAAe,GAArB,MAAM,eACT,SAAQ,UAAmD,CAAA;AAGjB,IAAA,OAAA,CAAA;AAA1C,IAAA,WAAA,CAA0C,OAAiC,EAAA;AACvE,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,CAA0B;KAK1E;IAED,WAAW,GAAG,IAAI,UAAU,CAA4D,OAAO,OAAO,KAAI;AACtG,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;;AAG/C,QAAA,MAAM,QAAQ,GAAG;AACb,YAAA,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;AACxB,YAAA,CAAC,SAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;SACX,CAAC;QAE7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;AACtC,YAAA,GAAG,IAAI;YACP,QAAQ;AACX,SAAA,CAAC,CAAC;AAEH,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,SAA2C,CAAC,EAAE,QAAQ,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;SACjG,CAAC,CACL,CAAC;AACN,KAAC,CAAC,CAAC;EACN;AAjCY,eAAe,GAAA,UAAA,CAAA;AAD3B,IAAA,UAAU,EAAE;IAKI,OAAA,CAAA,CAAA,EAAA,SAAS,EAAE,CAAA;AAA2B,IAAA,UAAA,CAAA,mBAAA,EAAA,CAAA,QAAA,EAAA,GAAA,OAAA,YAAY,oBAAZ,YAAY,CAAA,KAAA,UAAA,GAAA,EAAA,GAAA,MAAA,CAAA,CAAA;AAJtD,CAAA,EAAA,eAAe,CAiC3B"}

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

@@ -1,7 +1,9 @@
 import DataLoader from 'dataloader';
-import { DataLoaderOptions, IBaseService, IDataLoader, AsDomainType } from '../interfaces';
-export declare class BulkDataLoader<SchemaType> extends DataLoader<string, AsDomainType<SchemaType> | null> implements IDataLoader<SchemaType> {
+import { DataLoaderOptions, IBaseService, IDataLoader } from '../interfaces';
+export declare class BulkDataLoader<T extends {
+    id: string;
+}> extends DataLoader<string, T | null> implements IDataLoader<T> {
     private readonly service;
-    constructor(service: IBaseService<SchemaType>);
-    withOptions: DataLoader<DataLoaderOptions<SchemaType>, AsDomainType<SchemaType>[], DataLoaderOptions<SchemaType>>;
+    constructor(service: IBaseService<T>);
+    withOptions: DataLoader<DataLoaderOptions<T>, T[], DataLoaderOptions<T>>;
 }

package/lib/dataloaders/bulk-dataloader.js

@@ -10,19 +10,17 @@ import {__decorate,__param,__metadata}from'tslib';import DataLoader from'dataloa
     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,
+            criteria: {
+                ...rest.criteria,
+                [searchKey]: { $in: ids },
+            },
         });
         return options.map((option) => results.filter((item) => {
             if (typeof comparator === 'function')
                 return comparator(option, item);
-            return item[searchKey]?.toString() === option.id.toString();
+            return item[searchKey].toString() === option.id.toString();
         }));
     });
 };

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":"kIAMO,IAAM,cAAc,GAApB,MAAM,cACT,SAAQ,UAAmD,CAAA;AAGjB,IAAA,OAAA,CAAA;AAA1C,IAAA,WAAA,CAA0C,OAAiC,EAAA;AACvE,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,CAA0B;KAK1E;IAED,WAAW,GAAG,IAAI,UAAU,CAA4D,OAAO,OAAO,KAAI;AACtG,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;;AAG/C,QAAA,MAAM,QAAQ,GAAG;AACb,YAAA,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;AACxB,YAAA,CAAC,SAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;SACX,CAAC;QAE7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;AACtC,YAAA,GAAG,IAAI;YACP,QAAQ;AACX,SAAA,CAAC,CAAC;AAEH,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,SAA2C,CAAC,EAAE,QAAQ,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;SACjG,CAAC,CACL,CAAC;AACN,KAAC,CAAC,CAAC;EACN;AAjCY,cAAc,GAAA,UAAA,CAAA;AAD1B,IAAA,UAAU,EAAE;IAKI,OAAA,CAAA,CAAA,EAAA,SAAS,EAAE,CAAA;;AAJf,CAAA,EAAA,cAAc,CAiC1B"}
+{"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';\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/index.d.ts

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

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

@@ -1,16 +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,6 @@
-export * from './interfaces';
 export * from './helpers';
 export * from './services';
 export * from './store';
 export * from './dataloaders';
 export * from './mixins';
+export * from './interfaces';

package/lib/index.js

@@ -1 +1 @@
-export{PAGINATION_OPTIONS}from'./interfaces/get-all-args.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,commonModelSchemaOptions}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{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,26 +1,16 @@
-import { FilterQuery, Model, PipelineStage, UpdateQuery } from 'mongoose';
-import { AsDomainType, CreateType, GetAllArgs, UpdateType } from './get-all-args';
-export interface IBaseRepository<SchemaType> {
-    model: Model<SchemaType>;
-    count(conditions?: FilterQuery<SchemaType>): Promise<number>;
-    getAll(options: GetAllArgs<SchemaType>): Promise<AsDomainType<SchemaType>[]>;
-    getAllWithPipeline(options: GetAllArgs<SchemaType>, customPipeline?: PipelineStage[]): Promise<AsDomainType<SchemaType>[]>;
-    getAllWithCount(options: GetAllArgs<SchemaType>): Promise<{
-        data: AsDomainType<SchemaType>[];
-        totalCount: number;
-    }>;
-    getAllWithCountAndPipeline(options: GetAllArgs<SchemaType>, customPipeline?: PipelineStage[]): Promise<{
-        data: AsDomainType<SchemaType>[];
-        totalCount: number;
-    }>;
-    get(conditions?: FilterQuery<SchemaType>, selectedFields?: string): Promise<AsDomainType<SchemaType> | null>;
-    find(conditions: Partial<FilterQuery<SchemaType>>, selectedFields?: string): Promise<AsDomainType<SchemaType> | null>;
-    create<T = CreateType<SchemaType>>(data: T): Promise<AsDomainType<SchemaType>>;
-    upsert<T = UpdateType<SchemaType>>(conditions: FilterQuery<SchemaType>, update: T, options?: Record<string, unknown>): Promise<AsDomainType<SchemaType>>;
-    update<T = UpdateType<SchemaType>>(criteria: FilterQuery<SchemaType>, update: T | UpdateQuery<SchemaType>, options?: Record<string, unknown>): Promise<AsDomainType<SchemaType>>;
-    bulkUpdate<T = UpdateType<SchemaType>>(criteria: FilterQuery<SchemaType>, update: T | UpdateQuery<SchemaType>, options?: Record<string, unknown>): Promise<AsDomainType<SchemaType>[]>;
-    delete(criteria: FilterQuery<SchemaType>): Promise<boolean>;
-    bulkGet(ids: string[], selectedFields?: string): Promise<AsDomainType<SchemaType>[]>;
-    bulkCreate<T = CreateType<SchemaType>>(data: T[]): Promise<AsDomainType<SchemaType>[]>;
-    bulkDelete(criteria: FilterQuery<SchemaType>): Promise<number>;
+import { Document, FilterQuery, Model, UpdateQuery } from 'mongoose';
+import { GetAllArgs } from './getAllArgs';
+export interface IBaseRepository<T, D = Document<T>> {
+    model: Model<D>;
+    count(conditions?: FilterQuery<D>): Promise<number>;
+    getAll(options: GetAllArgs<D>): Promise<T[]>;
+    get(conditions?: FilterQuery<D>, selectedFields?: string): Promise<T>;
+    create<I>(data: I): Promise<T>;
+    upsert<I>(conditions: FilterQuery<D>, update: I, options: any): Promise<T>;
+    update<I>(criteria: FilterQuery<D>, update: UpdateQuery<D>, options?: any): Promise<T>;
+    bulkUpdate<I>(criteria: FilterQuery<D>, update: UpdateQuery<D>, options?: any): Promise<T[]>;
+    delete(criteria: FilterQuery<D>): Promise<boolean>;
+    bulkGet(ids: string[], selectedFields?: string): Promise<T[]>;
+    bulkCreate<I>(data: I[]): Promise<T[]>;
+    bulkDelete(criteria: FilterQuery<D>): Promise<number>;
 }

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

@@ -1,21 +1,22 @@
-import { FilterQuery } from 'mongoose';
-import { GetAllArgs, AsDomainType, CreateType, UpdateType } from './get-all-args';
-export interface IBaseService<SchemaType> {
-    getAllWithCount(options: GetAllArgs<SchemaType>): Promise<{
-        data: AsDomainType<SchemaType>[];
+import { FilterQuery, Document } from 'mongoose';
+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>;
+    get(conditions?: string | FilterQuery<Document<T>>): Promise<T>;
+    getByName(name: string): Promise<T>;
+    getAll(options?: GetAllArgs<Document<T>>): Promise<T[]>;
+    getByIds(ids: string[]): Promise<T[]>;
+    create(data: C): Promise<T>;
+    insert(data: (C | U) & {
+        id?: string;
+    }, overwrite?: boolean): Promise<T>;
+    bulkCreate(data: C[]): Promise<T[]>;
+    update(id: string, data: U, overwrite?: boolean): Promise<T>;
+    delete(id: string): Promise<boolean>;
+    delete(conditions: string | FilterQuery<Document<T>>): Promise<boolean>;
+    getAllWithCount(options: GetAllArgs<Document<T>>): Promise<{
+        data: T[];
         totalCount: number;
     }>;
-    count(conditions?: FilterQuery<SchemaType>): Promise<number>;
-    get(conditions: string | FilterQuery<SchemaType>): Promise<AsDomainType<SchemaType> | null>;
-    getByName(name: string): Promise<AsDomainType<SchemaType> | null>;
-    getAll(options: GetAllArgs<SchemaType>): Promise<AsDomainType<SchemaType>[]>;
-    getByIds(ids: string[]): Promise<AsDomainType<SchemaType>[]>;
-    create<T = CreateType<SchemaType>>(data: T): Promise<AsDomainType<SchemaType>>;
-    bulkCreate<T = CreateType<SchemaType>>(data: T[]): Promise<AsDomainType<SchemaType>[]>;
-    update<T = UpdateType<SchemaType>>(id: string, data: T, overwrite?: boolean): Promise<AsDomainType<SchemaType>>;
-    insert<T = CreateType<SchemaType>>(data: T & {
-        id?: string;
-    }, overwrite?: boolean): Promise<AsDomainType<SchemaType>>;
-    delete(id: string | FilterQuery<SchemaType>): Promise<boolean>;
-    bulkDelete(criteria: FilterQuery<SchemaType>): Promise<number>;
 }

package/lib/interfaces/dataloaders.d.ts

@@ -0,0 +1,10 @@
+import DataLoader from 'dataloader';
+import { IBaseService } from './base-service';
+export type DataLoaderOptions<T> = Parameters<IBaseService<T>['getAll']>[0] & {
+    id: string;
+    searchKey: keyof T;
+    comparator?: (source: Omit<DataLoaderOptions<T>, 'comparator'>, target: T) => boolean;
+};
+export type IDataLoader<T> = DataLoader<string, T> & {
+    withOptions: DataLoader<DataLoaderOptions<T>, T[]>;
+};