@common-stack/store-mongo 7.0.4-alpha.6 → 7.1.1-alpha.14

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":["import DataLoader from 'dataloader';\nimport { injectable, unmanaged } from 'inversify';\nimport { FilterQuery } from 'mongoose';\nimport { IBaseService, IDataLoader, AsDomainType } 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":";AAMO,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.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';\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,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/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{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>;

package/lib/interfaces/getAllArgs.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @file get-all-args.ts
+ * @description Defines common types and interfaces used across the data access layer for MongoDB operations.
+ * This file contains essential type definitions that standardize how data is queried, transformed, and returned.
+ *
+ * Key components include:
+ * - GetAllArgs: Interface for pagination, sorting, and filtering when retrieving collections of documents
+ * - AsDomainType: Type transformer that converts MongoDB schema types (with _id) to domain types (with id)
+ * - GetAllWithCountResult: Type for paginated results that include both data and total count
+ * - CreateType/UpdateType: Utility types that define the shape of data for create and update operations
+ * - PAGINATION_OPTIONS: Default pagination settings used throughout the application
+ *
+ * Usage examples:
+ * 1. Retrieving paginated data:
+ *    const result = await repository.getAllWithCount({ limit: 10, skip: 0, sort: { createdAt: -1 } });
+ *
+ * 2. Converting MongoDB documents to domain objects:
+ *    const domainUser: AsDomainType<UserSchema> = { ...userDoc, id: userDoc._id.toString() };
+ *
+ * 3. Creating new documents with proper typing:
+ *    const newUser: CreateType<UserSchema> = { name: 'John', email: 'john@example.com' };
+ *
+ * These types ensure consistency across repositories and services, providing type safety and
+ * clear contracts for data manipulation throughout the application. They form the foundation
+ * of the data access pattern used across the entire system.
+ *
+ * @see IBaseRepository2 - Uses these types for repository operations
+ * @see IBaseService2 - Implements service methods using these types
+ * @see IDataLoader2 - Utilizes these types for efficient data loading
+ */
+import type { FilterQuery } from 'mongoose';
+import type { ISort } from 'common';
+/**
+ * Interface for the arguments used in the getAll method
+ *
+ * @property criteria - MongoDB filter query to narrow down results
+ * @property sort - Sorting configuration with field names and directions (1 for ascending, -1 for descending)
+ * @property skip - Number of documents to skip (for pagination)
+ * @property limit - Maximum number of documents to return (for pagination)
+ * @property selectedFields - String of space-separated field names to include in the results
+ *
+ * @example
+ * // Get active users, sorted by creation date, second page with 10 items per page
+ * const options: GetAllArgs<UserSchema> = {
+ *   criteria: { active: true },
+ *   sort: { createdAt: -1 },
+ *   skip: 10,
+ *   limit: 10,
+ *   selectedFields: 'name email createdAt'
+ * };
+ */
+export interface GetAllArgs<T> {
+    criteria?: FilterQuery<T>;
+    sort?: ISort;
+    skip?: number;
+    limit?: number;
+    selectedFields?: string;
+}
+/**
+ * Type that converts a schema type with _id to a domain type with id
+ * This transformation is essential for presenting MongoDB documents as domain objects
+ * throughout the application, hiding the database-specific _id field.
+ *
+ * @example
+ * // MongoDB document
+ * const userDoc = { _id: '123', name: 'John', email: 'john@example.com' };
+ *
+ * // Transformed domain object
+ * const user: AsDomainType<UserSchema> = { id: '123', name: 'John', email: 'john@example.com' };
+ */
+export type AsDomainType<SchemaType> = Omit<SchemaType, '_id'> & {
+    id: string;
+};
+/**
+ * Type for the result of getAllWithCount
+ * Provides both the paginated data and the total count of matching documents
+ * This is used for implementing pagination UI components that need to know
+ * the total number of pages or items.
+ *
+ * @property data - Array of domain objects matching the query criteria
+ * @property totalCount - Total number of documents that match the criteria (without pagination)
+ *
+ * @example
+ * const result: GetAllWithCountResult<UserSchema> = {
+ *   data: [{ id: '1', name: 'John' }, { id: '2', name: 'Jane' }],
+ *   totalCount: 50
+ * };
+ */
+export type GetAllWithCountResult<SchemaType> = {
+    data: AsDomainType<SchemaType>[];
+    totalCount: number;
+};
+/**
+ * Default pagination settings used throughout the application
+ * These values are used when no explicit pagination parameters are provided
+ */
+export declare enum PAGINATION_OPTIONS {
+    limit = 10,
+    skip = 0
+}
+/**
+ * Type for create operations - omits _id, id, and auto-generated fields
+ * This ensures that clients cannot specify fields that should be generated by the database
+ *
+ * @example
+ * // Valid create operation data
+ * const newUser: CreateType<UserSchema> = {
+ *   name: 'John Doe',
+ *   email: 'john@example.com',
+ *   role: 'user'
+ * };
+ *
+ * // The following fields will be generated automatically and should not be included:
+ * // - _id (MongoDB document ID)
+ * // - id (Domain object ID)
+ * // - createdAt (Creation timestamp)
+ * // - updatedAt (Last update timestamp)
+ */
+export type CreateType<SchemaType> = Omit<Partial<SchemaType>, '_id' | 'id' | 'createdAt' | 'updatedAt'>;
+/**
+ * Type for update operations - partial of the schema without _id
+ * This allows for partial updates where only changed fields are specified
+ *
+ * @example
+ * // Update a user's email and role
+ * const updateData: UpdateType<UserSchema> = {
+ *   email: 'new.email@example.com',
+ *   role: 'admin'
+ * };
+ *
+ * // Fields not specified will remain unchanged
+ */
+export type UpdateType<SchemaType> = Partial<Omit<SchemaType, '_id'>>;

package/lib/interfaces/getAllArgs.js

@@ -0,0 +1,39 @@
+/**
+ * @file get-all-args.ts
+ * @description Defines common types and interfaces used across the data access layer for MongoDB operations.
+ * This file contains essential type definitions that standardize how data is queried, transformed, and returned.
+ *
+ * Key components include:
+ * - GetAllArgs: Interface for pagination, sorting, and filtering when retrieving collections of documents
+ * - AsDomainType: Type transformer that converts MongoDB schema types (with _id) to domain types (with id)
+ * - GetAllWithCountResult: Type for paginated results that include both data and total count
+ * - CreateType/UpdateType: Utility types that define the shape of data for create and update operations
+ * - PAGINATION_OPTIONS: Default pagination settings used throughout the application
+ *
+ * Usage examples:
+ * 1. Retrieving paginated data:
+ *    const result = await repository.getAllWithCount({ limit: 10, skip: 0, sort: { createdAt: -1 } });
+ *
+ * 2. Converting MongoDB documents to domain objects:
+ *    const domainUser: AsDomainType<UserSchema> = { ...userDoc, id: userDoc._id.toString() };
+ *
+ * 3. Creating new documents with proper typing:
+ *    const newUser: CreateType<UserSchema> = { name: 'John', email: 'john@example.com' };
+ *
+ * These types ensure consistency across repositories and services, providing type safety and
+ * clear contracts for data manipulation throughout the application. They form the foundation
+ * of the data access pattern used across the entire system.
+ *
+ * @see IBaseRepository2 - Uses these types for repository operations
+ * @see IBaseService2 - Implements service methods using these types
+ * @see IDataLoader2 - Utilizes these types for efficient data loading
+ */
+/**
+ * Default pagination settings used throughout the application
+ * These values are used when no explicit pagination parameters are provided
+ */
+var PAGINATION_OPTIONS;
+(function (PAGINATION_OPTIONS) {
+    PAGINATION_OPTIONS[PAGINATION_OPTIONS["limit"] = 10] = "limit";
+    PAGINATION_OPTIONS[PAGINATION_OPTIONS["skip"] = 0] = "skip";
+})(PAGINATION_OPTIONS || (PAGINATION_OPTIONS = {}));export{PAGINATION_OPTIONS};//# sourceMappingURL=getAllArgs.js.map

package/lib/interfaces/getAllArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAllArgs.js","sources":["../../src/interfaces/getAllArgs.ts"],"sourcesContent":["/**\n * @file get-all-args.ts\n * @description Defines common types and interfaces used across the data access layer for MongoDB operations.\n * This file contains essential type definitions that standardize how data is queried, transformed, and returned.\n *\n * Key components include:\n * - GetAllArgs: Interface for pagination, sorting, and filtering when retrieving collections of documents\n * - AsDomainType: Type transformer that converts MongoDB schema types (with _id) to domain types (with id)\n * - GetAllWithCountResult: Type for paginated results that include both data and total count\n * - CreateType/UpdateType: Utility types that define the shape of data for create and update operations\n * - PAGINATION_OPTIONS: Default pagination settings used throughout the application\n *\n * Usage examples:\n * 1. Retrieving paginated data:\n *    const result = await repository.getAllWithCount({ limit: 10, skip: 0, sort: { createdAt: -1 } });\n *\n * 2. Converting MongoDB documents to domain objects:\n *    const domainUser: AsDomainType<UserSchema> = { ...userDoc, id: userDoc._id.toString() };\n *\n * 3. Creating new documents with proper typing:\n *    const newUser: CreateType<UserSchema> = { name: 'John', email: 'john@example.com' };\n *\n * These types ensure consistency across repositories and services, providing type safety and\n * clear contracts for data manipulation throughout the application. They form the foundation\n * of the data access pattern used across the entire system.\n *\n * @see IBaseRepository2 - Uses these types for repository operations\n * @see IBaseService2 - Implements service methods using these types\n * @see IDataLoader2 - Utilizes these types for efficient data loading\n */\n\nimport type { FilterQuery } from 'mongoose';\nimport type { ISort } from 'common';\n\n/**\n * Interface for the arguments used in the getAll method\n *\n * @property criteria - MongoDB filter query to narrow down results\n * @property sort - Sorting configuration with field names and directions (1 for ascending, -1 for descending)\n * @property skip - Number of documents to skip (for pagination)\n * @property limit - Maximum number of documents to return (for pagination)\n * @property selectedFields - String of space-separated field names to include in the results\n *\n * @example\n * // Get active users, sorted by creation date, second page with 10 items per page\n * const options: GetAllArgs<UserSchema> = {\n *   criteria: { active: true },\n *   sort: { createdAt: -1 },\n *   skip: 10,\n *   limit: 10,\n *   selectedFields: 'name email createdAt'\n * };\n */\nexport interface GetAllArgs<T> {\n    criteria?: FilterQuery<T>;\n    sort?: ISort;\n    skip?: number;\n    limit?: number;\n    selectedFields?: string;\n}\n\n/**\n * Type that converts a schema type with _id to a domain type with id\n * This transformation is essential for presenting MongoDB documents as domain objects\n * throughout the application, hiding the database-specific _id field.\n *\n * @example\n * // MongoDB document\n * const userDoc = { _id: '123', name: 'John', email: 'john@example.com' };\n *\n * // Transformed domain object\n * const user: AsDomainType<UserSchema> = { id: '123', name: 'John', email: 'john@example.com' };\n */\nexport type AsDomainType<SchemaType> = Omit<SchemaType, '_id'> & { id: string };\n\n/**\n * Type for the result of getAllWithCount\n * Provides both the paginated data and the total count of matching documents\n * This is used for implementing pagination UI components that need to know\n * the total number of pages or items.\n *\n * @property data - Array of domain objects matching the query criteria\n * @property totalCount - Total number of documents that match the criteria (without pagination)\n *\n * @example\n * const result: GetAllWithCountResult<UserSchema> = {\n *   data: [{ id: '1', name: 'John' }, { id: '2', name: 'Jane' }],\n *   totalCount: 50\n * };\n */\nexport type GetAllWithCountResult<SchemaType> = {\n    data: AsDomainType<SchemaType>[];\n    totalCount: number;\n};\n\n/**\n * Default pagination settings used throughout the application\n * These values are used when no explicit pagination parameters are provided\n */\nexport enum PAGINATION_OPTIONS {\n    limit = 10,\n    skip = 0,\n}\n\n/**\n * Type for create operations - omits _id, id, and auto-generated fields\n * This ensures that clients cannot specify fields that should be generated by the database\n *\n * @example\n * // Valid create operation data\n * const newUser: CreateType<UserSchema> = {\n *   name: 'John Doe',\n *   email: 'john@example.com',\n *   role: 'user'\n * };\n *\n * // The following fields will be generated automatically and should not be included:\n * // - _id (MongoDB document ID)\n * // - id (Domain object ID)\n * // - createdAt (Creation timestamp)\n * // - updatedAt (Last update timestamp)\n */\nexport type CreateType<SchemaType> = Omit<Partial<SchemaType>, '_id' | 'id' | 'createdAt' | 'updatedAt'>;\n\n/**\n * Type for update operations - partial of the schema without _id\n * This allows for partial updates where only changed fields are specified\n *\n * @example\n * // Update a user's email and role\n * const updateData: UpdateType<UserSchema> = {\n *   email: 'new.email@example.com',\n *   role: 'admin'\n * };\n *\n * // Fields not specified will remain unchanged\n */\nexport type UpdateType<SchemaType> = Partial<Omit<SchemaType, '_id'>>;\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BG;AAkEH;;;AAGG;IACS,mBAGX;AAHD,CAAA,UAAY,kBAAkB,EAAA;AAC1B,IAAA,kBAAA,CAAA,kBAAA,CAAA,OAAA,CAAA,GAAA,EAAA,CAAA,GAAA,OAAU,CAAA;AACV,IAAA,kBAAA,CAAA,kBAAA,CAAA,MAAA,CAAA,GAAA,CAAA,CAAA,GAAA,MAAQ,CAAA;AACZ,CAAC,EAHW,kBAAkB,KAAlB,kBAAkB,GAG7B,EAAA,CAAA,CAAA"}

package/lib/interfaces/index.d.ts

@@ -1,5 +1,5 @@
 export * from './mongoose-settings';
-export * from './get-all-args';
+export * from './getAllArgs';
 export * from './base-repository';
 export * from './base-service';
 export * from './dataloaders';

package/lib/mixins/BaseServiceMixin.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @file BaseServiceMixin.ts
+ * @description Provides a mixin function that adds standardized service methods to Moleculer service schemas.
+ * This mixin implements the IBaseService interface and connects it to Moleculer's service framework,
+ * creating action handlers for all standard service operations.
+ *
+ * The mixin pattern allows for composable service functionality, where multiple mixins can be combined
+ * to create feature-rich services without code duplication. This particular mixin handles the core CRUD
+ * operations and emits events when data changes.
+ *
+ * Key features:
+ * - Automatic action creation for all IBaseService methods
+ * - Event emission for data changes (create, update, delete)
+ * - Parameter validation for all actions
+ * - Consistent error handling
+ * - Type safety through generics
+ *
+ * @see IBaseService - The interface this mixin implements
+ * @see IBaseMongoRepository - The repository interface used for data access
+ */
+import { ServiceBroker, ServiceSchema } from 'moleculer';
+import { IBaseService, BaseServiceCommands } from 'common';
+/**
+ * Creates a mixin that implements the IBaseService interface as Moleculer actions
+ *
+ * @param service - Implementation of IBaseService that will handle the actual business logic
+ * @param broker - Moleculer service broker for event emission
+ * @param name - Service name used for event naming
+ * @param events - List of operations that should emit events
+ * @returns A partial ServiceSchema that can be merged with other service definitions
+ *
+ * @example
+ * // Create a user service with the base service mixin
+ * const UserService: ServiceSchema = {
+ *   name: "users",
+ *   mixins: [
+ *     BaseServiceMixin(userService, broker, "users")
+ *   ],
+ *   // Additional service-specific actions and methods
+ *   actions: {
+ *     changePassword: { ... }
+ *   }
+ * };
+ */
+export declare const BaseServiceMixin: <T>(service: IBaseService<T>, broker?: ServiceBroker, name?: string, events?: BaseServiceCommands[]) => Partial<ServiceSchema>;