@smartsoft001/domain-core 1.1.91 → 2.26.0

package/README.md

@@ -1,7 +1,5 @@
-# shared-domain-core
+# @smartsoft001/domain-core
 
-This library was generated with [Nx](https://nx.dev).
+## Installation
 
-## Running unit tests
-
-Run `nx test shared-domain-core` to execute the unit tests.
+`npm i @smartsoft001/domain-core`

package/package.json

@@ -1,24 +1,14 @@
 {
   "name": "@smartsoft001/domain-core",
-  "version": "1.1.91",
+  "version": "2.26.0",
   "dependencies": {
-    "@angular/common": "16.1.3",
-    "@angular/core": "16.1.3",
-    "@angular/platform-browser-dynamic": "16.1.3",
-    "flatted": "^3.2.4",
-    "guid-typescript": "1.0.9",
-    "lodash": "^4.17.20",
-    "md5": "2.3.0",
-    "reflect-metadata": "0.1.13",
-    "rxjs": "7.8.1"
-  },
-  "peerDependencies": {
-    "@smartsoft001/models": "1.1.91",
-    "@smartsoft001/users": "1.1.91",
-    "@smartsoft001/utils": "1.1.91",
-    "util": "0.12.5",
-    "tslib": "2.5.3"
+    "tslib": "^2.3.0",
+    "@smartsoft001/models": "2.26.0",
+    "rxjs": "^7.8.1",
+    "@smartsoft001/users": "2.26.0"
   },
+  "type": "commonjs",
   "main": "./src/index.js",
+  "typings": "./src/index.d.ts",
   "types": "./src/index.d.ts"
-}
+}

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/shared/domain-core/src/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,uDAA6B;AAC7B,6DAAmC;AACnC,+DAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/shared/domain-core/src/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,uDAA6B;AAC7B,6DAAmC;AACnC,+DAAqC"}

package/src/lib/errors.d.ts

@@ -1,8 +1,8 @@
 export declare class DomainValidationError extends Error {
     type: typeof DomainValidationError;
-    constructor(msg: any);
+    constructor(msg: string);
 }
 export declare class DomainForbiddenError extends Error {
     type: typeof DomainForbiddenError;
-    constructor(msg: any);
+    constructor(msg: string);
 }

package/src/lib/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../../libs/shared/domain-core/src/lib/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,qBAAsB,SAAQ,KAAK;IAG5C,YAAY,GAAG;QACX,KAAK,CAAC,GAAG,CAAC,CAAC;QAHf,SAAI,GAAG,qBAAqB,CAAC;IAI7B,CAAC;CACJ;AAND,sDAMC;AAED,MAAa,oBAAqB,SAAQ,KAAK;IAG3C,YAAY,GAAG;QACX,KAAK,CAAC,GAAG,CAAC,CAAC;QAHf,SAAI,GAAG,oBAAoB,CAAC;IAI5B,CAAC;CACJ;AAND,oDAMC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../../packages/shared/domain-core/src/lib/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,qBAAsB,SAAQ,KAAK;IAG5C,YAAY,GAAW;QACnB,KAAK,CAAC,GAAG,CAAC,CAAC;QAHf,SAAI,GAAG,qBAAqB,CAAC;IAI7B,CAAC;CACJ;AAND,sDAMC;AAED,MAAa,oBAAqB,SAAQ,KAAK;IAG3C,YAAY,GAAW;QACnB,KAAK,CAAC,GAAG,CAAC,CAAC;QAHf,SAAI,GAAG,oBAAoB,CAAC;IAI5B,CAAC;CACJ;AAND,oDAMC"}

package/src/lib/interfaces.d.ts

@@ -9,8 +9,8 @@ export interface IAddress {
     zipCode: string;
 }
 export interface IDateRange {
-    start: string;
-    end: string;
+    start: `${string}-${string}-${string}`;
+    end: `${string}-${string}-${string}`;
 }
 export interface IFactory<T, TConfig> {
     create(config: NonNullable<TConfig>): Promise<T>;

package/src/lib/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../../../libs/shared/domain-core/src/lib/interfaces.ts"],"names":[],"mappings":""}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../../../packages/shared/domain-core/src/lib/interfaces.ts"],"names":[],"mappings":""}

package/src/lib/repositories.d.ts

@@ -1,42 +1,272 @@
 import { Observable } from "rxjs";
 import { IUser } from "@smartsoft001/users";
 import { IEntity, ISpecification } from "./interfaces";
+/**
+ * ITransaction defines the structure of a transaction context that can be used to
+ * perform a series of database operations as a single atomic unit of work.
+ *
+ * @interface ITransaction
+ */
 export interface ITransaction {
+    /**
+     * The connection object that provides access to the database.
+     *
+     * This property typically represents the active database connection that is used
+     * to execute operations within the transaction. The exact type of the connection
+     * may vary depending on the database being used (e.g., MongoDB, SQL, etc.).
+     *
+     * @type {any}
+     */
     connection: any;
 }
+/**
+ * IUnitOfWork is an abstract class that defines the contract for managing transactional operations
+ * across multiple repositories or services. This pattern ensures that a set of operations either
+ * all succeed or all fail, maintaining data consistency.
+ *
+ * @interface IUnitOfWork
+ */
 export declare abstract class IUnitOfWork {
+    /**
+     * Executes a set of operations within a transactional scope.
+     *
+     * @param {function(ITransaction): Promise<void>} definition - A function that contains the operations to be executed within the transaction.
+     * The function receives an `ITransaction` object that provides the necessary context for the transaction.
+     *
+     * @returns {Promise<void>} - A promise that resolves when the transactional operations are completed successfully.
+     *
+     * @throws {Error} - Throws an error if the transaction fails, in which case all operations are rolled back.
+     *
+     * @example
+     * await this.unitOfWork.scope(async (tx) => {
+     *       await this.itemRepository.updatePartial(
+     *         {
+     *           id: id1,
+     *           status: "finished",
+     *         },
+     *         user,
+     *         { transaction: tx }
+     *       );
+     *
+     *       await this.itemRepository.updatePartial(
+     *           {
+     *             id: id2,
+     *             status: "finished",
+     *           },
+     *           user,
+     *           { transaction: tx }
+     *       );
+     * });
+     */
     abstract scope(definition: (transaction: ITransaction) => Promise<void>): Promise<void>;
 }
+/**
+ *
+ * @interface IItemRepositoryOptions
+ */
 export interface IItemRepositoryOptions {
     transaction: ITransaction;
 }
+/**
+ * IItemRepository is an abstract class that defines the contract for a repository
+ * responsible for managing entities of type `T` in a storage system. This repository
+ * interface provides a set of methods for creating, updating, deleting, and querying
+ * entities, with support for transactional operations and various query criteria.
+ *
+ * @template T - The type of entity that this repository will manage. The entity should extend `IEntity<string>`.
+ *
+ * @interface IItemRepository
+ */
 export declare abstract class IItemRepository<T extends IEntity<string>> {
+    /**
+     * Creates a new entity in the storage system.
+     *
+     * @param {T} item - The entity to be created.
+     * @param {IUser} user - The user performing the operation.
+     * @param {IItemRepositoryOptions} [options] - Optional parameters for the operation, including transaction context.
+     *
+     * @returns {Promise<void>} - A promise that resolves when the entity is successfully created.
+     */
     abstract create(item: T, user: IUser, options?: IItemRepositoryOptions): Promise<void>;
+    /**
+     * Creates multiple entities in the storage system.
+     *
+     * @param {T[]} list - The list of entities to be created.
+     * @param {IUser} user - The user performing the operation.
+     * @param {IItemRepositoryOptions} [options] - Optional parameters for the operation, including transaction context.
+     *
+     * @returns {Promise<void>} - A promise that resolves when all entities are successfully created.
+     */
     abstract createMany(list: T[], user: IUser, options?: IItemRepositoryOptions): Promise<void>;
+    /**
+     * Updates an existing entity in the storage system.
+     *
+     * @param {T} item - The entity to be updated.
+     * @param {IUser} user - The user performing the operation.
+     * @param {IItemRepositoryOptions} [options] - Optional parameters for the operation, including transaction context.
+     *
+     * @returns {Promise<void>} - A promise that resolves when the entity is successfully updated.
+     */
     abstract update(item: T, user: IUser, options?: IItemRepositoryOptions): Promise<void>;
+    /**
+     * Partially updates an existing entity in the storage system.
+     *
+     * @param {Partial<T> & { id: string }} item - The partial entity data to be updated along with the entity's ID.
+     * @param {IUser} user - The user performing the operation.
+     * @param {IItemRepositoryOptions} [options] - Optional parameters for the operation, including transaction context.
+     *
+     * @returns {Promise<void>} - A promise that resolves when the entity is successfully updated.
+     */
     abstract updatePartial(item: Partial<T> & {
         id: string;
     }, user: IUser, options?: IItemRepositoryOptions): Promise<void>;
+    /**
+     * Partially updates multiple entities that match the specified criteria.
+     *
+     * @param {any} criteria - The criteria used to select the entities to be updated.
+     * @param {Partial<T>} set - The partial data to be set on the matching entities.
+     * @param {IUser} user - The user performing the operation.
+     * @param {IItemRepositoryOptions} [options] - Optional parameters for the operation, including transaction context.
+     *
+     * @returns {Promise<void>} - A promise that resolves when the entities are successfully updated.
+     */
     abstract updatePartialManyByCriteria(criteria: any, set: Partial<T>, user: IUser, options?: IItemRepositoryOptions): Promise<void>;
+    /**
+     * Partially updates multiple entities that match the specified specification.
+     *
+     * @param {ISpecification} spec - The specification used to select the entities to be updated.
+     * @param {Partial<T>} set - The partial data to be set on the matching entities.
+     * @param {IUser} user - The user performing the operation.
+     * @param {IItemRepositoryOptions} [options] - Optional parameters for the operation, including transaction context.
+     *
+     * @returns {Promise<void>} - A promise that resolves when the entities are successfully updated.
+     */
     abstract updatePartialManyBySpecification(spec: ISpecification, set: Partial<T>, user: IUser, options?: IItemRepositoryOptions): Promise<void>;
+    /**
+     * Deletes an entity from the storage system by its ID.
+     *
+     * @param {string} id - The ID of the entity to be deleted.
+     * @param {IUser} user - The user performing the operation.
+     * @param {IItemRepositoryOptions} [options] - Optional parameters for the operation, including transaction context.
+     *
+     * @returns {Promise<void>} - A promise that resolves when the entity is successfully deleted.
+     */
     abstract delete(id: string, user: IUser, options?: IItemRepositoryOptions): Promise<void>;
+    /**
+     * Retrieves an entity from the storage system by its ID.
+     *
+     * @param {string} id - The ID of the entity to be retrieved.
+     * @param {IItemRepositoryOptions} [repoOptions] - Optional parameters for the operation, including transaction context.
+     *
+     * @returns {Promise<T>} - A promise that resolves to the retrieved entity.
+     */
     abstract getById(id: string, repoOptions?: IItemRepositoryOptions): Promise<T>;
+    /**
+     * Retrieves entities from the storage system that match the specified criteria.
+     *
+     * @param {any} criteria - The criteria used to select the entities.
+     * @param {any} [options] - Optional parameters for the operation, such as pagination or sorting.
+     *
+     * @returns {Promise<{ data: T[]; totalCount: number }>} - A promise that resolves to an object containing the matching entities and the total count.
+     */
     abstract getByCriteria(criteria: any, options?: any): Promise<{
         data: T[];
         totalCount: number;
     }>;
+    /**
+     * Retrieves entities from the storage system that match the specified specification.
+     *
+     * @param {ISpecification} spec - The specification used to select the entities.
+     * @param {any} [options] - Optional parameters for the operation, such as pagination or sorting.
+     *
+     * @returns {Promise<{ data: T[]; totalCount: number }>} - A promise that resolves to an object containing the matching entities and the total count.
+     */
     abstract getBySpecification(spec: ISpecification, options?: any): Promise<{
         data: T[];
         totalCount: number;
     }>;
+    /**
+     * Counts the number of entities in the storage system that match the specified criteria.
+     *
+     * @param {any} criteria - The criteria used to count the entities.
+     *
+     * @returns {Promise<number>} - A promise that resolves to the count of matching entities.
+     */
     abstract countByCriteria(criteria: any): Promise<number>;
+    /**
+     * Counts the number of entities in the storage system that match the specified specification.
+     *
+     * @param {ISpecification} spec - The specification used to count the entities.
+     *
+     * @returns {Promise<number>} - A promise that resolves to the count of matching entities.
+     */
     abstract countBySpecification(spec: ISpecification): Promise<number>;
+    /**
+     * Clears all entities from the storage system.
+     *
+     * @param user
+     *
+     * @returns {Promise<void>} - A promise that resolves when the storage system is cleared.
+     */
     abstract clear(user: IUser | IItemRepositoryOptions): Promise<void>;
+    /**
+     * Returns an observable that emits changes to entities that match the specified criteria.
+     *
+     * @param {any} criteria - The criteria used to select the entities to observe.
+     *
+     * @returns {Observable<any>} - An observable that emits changes to the matching entities.
+     */
     abstract changesByCriteria(criteria: {
         id?: string;
     }): Observable<any>;
 }
+/**
+ * IAttachmentRepository is an abstract class that defines the contract for managing file attachments
+ * in a storage system. This interface can be implemented to work with various storage backends, such as
+ * MongoDB GridFS, Amazon S3, Google Cloud Storage, or any other file storage solution.
+ *
+ * @template T - The type of the entity that this repository will manage. The entity should extend `IEntity<string>`.
+ *
+ * @interface IAttachmentRepository
+ */
 export declare abstract class IAttachmentRepository<T extends IEntity<string>> {
+    /**
+     * Uploads a file to the storage system.
+     *
+     * @param {Object} data - The data required to upload the file.
+     * @param {string} data.id - A unique identifier for the file.
+     * @param {string} data.fileName - The name of the file to be uploaded.
+     * @param {Stream} data.stream - The stream of the file to be uploaded.
+     * @param {string} data.mimeType - The MIME type of the file.
+     * @param {string} data.encoding - The encoding of the file.
+     *
+     * @param {Object} [options] - Optional parameters for the upload.
+     * @param {Function} [options.streamCallback] - A callback function that gets invoked with the upload stream.
+     *
+     * @returns {Promise<void>} - A promise that resolves when the upload is complete.
+     *
+     * @throws {Error} - Throws an error if the upload fails.
+     *
+     * @example
+     * // Example usage with MongoDB implementation:
+     * const repository = new MongoAttachmentRepository(config);
+     *
+     * const fileStream = fs.createReadStream('/path/to/file');
+     *
+     * await repository.upload({
+     *   id: 'unique-file-id',
+     *   fileName: 'example.txt',
+     *   stream: fileStream,
+     *   mimeType: 'text/plain',
+     *   encoding: 'utf-8'
+     * }, {
+     *   streamCallback: (writeStream) => {
+     *     console.log('Upload started');
+     *   }
+     * });
+     *
+     * console.log('File uploaded successfully');
+     */
     abstract upload(data: {
         id: string;
         fileName: string;
@@ -46,14 +276,45 @@ export declare abstract class IAttachmentRepository<T extends IEntity<string>> {
     }, options?: {
         streamCallback?: (r: any) => void;
     }): Promise<void>;
+    /**
+     * Retrieves metadata information about a file stored in the storage system.
+     *
+     * @param {string} id - The unique identifier of the file.
+     *
+     * @returns {Promise<{ fileName: string, contentType: string, length: number } | null>}
+     * - A promise that resolves to an object containing file metadata, or `null` if the file is not found.
+     *
+     * @throws {Error} - Throws an error if retrieving the file information fails.
+     */
     abstract getInfo(id: string): Promise<{
         fileName: string;
         contentType: string;
         length: number;
     }>;
+    /**
+     * Retrieves a stream for downloading a file from the storage system.
+     *
+     * @param {string} id - The unique identifier of the file.
+     * @param {Object} [options] - Optional parameters for retrieving a specific range of the file.
+     * @param {number} [options.start] - The starting byte position for the stream.
+     * @param {number} [options.end] - The ending byte position for the stream.
+     *
+     * @returns {Promise<any>} - A promise that resolves to a readable stream of the file.
+     *
+     * @throws {Error} - Throws an error if retrieving the file stream fails.
+     */
     abstract getStream(id: string, options?: {
         start: number;
         end: number;
     }): Promise<any>;
+    /**
+     * Deletes a file from the storage system.
+     *
+     * @param {string} id - The unique identifier of the file to be deleted.
+     *
+     * @returns {Promise<void>} - A promise that resolves when the file has been successfully deleted.
+     *
+     * @throws {Error} - Throws an error if the deletion fails.
+     */
     abstract delete(id: string): Promise<void>;
 }

package/src/lib/repositories.js

@@ -1,13 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IAttachmentRepository = exports.IItemRepository = exports.IUnitOfWork = void 0;
-;
+/**
+ * IUnitOfWork is an abstract class that defines the contract for managing transactional operations
+ * across multiple repositories or services. This pattern ensures that a set of operations either
+ * all succeed or all fail, maintaining data consistency.
+ *
+ * @interface IUnitOfWork
+ */
 class IUnitOfWork {
 }
 exports.IUnitOfWork = IUnitOfWork;
+/**
+ * IItemRepository is an abstract class that defines the contract for a repository
+ * responsible for managing entities of type `T` in a storage system. This repository
+ * interface provides a set of methods for creating, updating, deleting, and querying
+ * entities, with support for transactional operations and various query criteria.
+ *
+ * @template T - The type of entity that this repository will manage. The entity should extend `IEntity<string>`.
+ *
+ * @interface IItemRepository
+ */
 class IItemRepository {
 }
 exports.IItemRepository = IItemRepository;
+/**
+ * IAttachmentRepository is an abstract class that defines the contract for managing file attachments
+ * in a storage system. This interface can be implemented to work with various storage backends, such as
+ * MongoDB GridFS, Amazon S3, Google Cloud Storage, or any other file storage solution.
+ *
+ * @template T - The type of the entity that this repository will manage. The entity should extend `IEntity<string>`.
+ *
+ * @interface IAttachmentRepository
+ */
 class IAttachmentRepository {
 }
 exports.IAttachmentRepository = IAttachmentRepository;

package/src/lib/repositories.js.map

@@ -1 +1 @@
-{"version":3,"file":"repositories.js","sourceRoot":"","sources":["../../../../../../libs/shared/domain-core/src/lib/repositories.ts"],"names":[],"mappings":";;;AASC,CAAC;AAEF,MAAsB,WAAW;CAEhC;AAFD,kCAEC;AAOD,MAAsB,eAAe;CA8CpC;AA9CD,0CA8CC;AAED,MAAsB,qBAAqB;CAW1C;AAXD,sDAWC"}
+{"version":3,"file":"repositories.js","sourceRoot":"","sources":["../../../../../../packages/shared/domain-core/src/lib/repositories.ts"],"names":[],"mappings":";;;AAyBA;;;;;;GAMG;AACH,MAAsB,WAAW;CAiChC;AAjCD,kCAiCC;AAUD;;;;;;;;;GASG;AACH,MAAsB,eAAe;CAmKpC;AAnKD,0CAmKC;AAED;;;;;;;;GAQG;AACH,MAAsB,qBAAqB;CA+E1C;AA/ED,sDA+EC"}

package/src/lib/specifications.d.ts

@@ -1,13 +1,77 @@
 import { ISpecification } from "./interfaces";
-export declare class MergeSpecification implements ISpecification {
-    criteria: any;
-    constructor(...spec: Array<ISpecification>);
+/**
+ * BasicSpecification is a class that implements the `ISpecification` interface and serves as a base
+ * class for defining basic query criteria. It holds a single set of criteria that can be used to
+ * filter entities in a repository or database.
+ *
+ * This class can be extended to create more complex specifications by combining or modifying the
+ * base criteria.
+ *
+ * @class BasicSpecification
+ * @implements {ISpecification}
+ */
+export declare class BasicSpecification implements ISpecification {
+    readonly criteria: any;
+    /**
+     * Creates an instance of BasicSpecification.
+     *
+     * @param {any} criteria - The criteria used to filter entities.
+     */
+    constructor(criteria: any);
+}
+/**
+ * MergeSpecification is a class that extends `BasicSpecification` and allows for the merging of multiple
+ * specifications into a single specification. The resulting specification combines the criteria of all provided
+ * specifications using a shallow merge.
+ *
+ * This class is useful when you need to apply multiple specifications to a query in a way that combines their criteria.
+ *
+ * @class MergeSpecification
+ * @extends {BasicSpecification}
+ */
+export declare class MergeSpecification extends BasicSpecification {
+    /**
+     * Creates an instance of MergeSpecification.
+     *
+     * @param {...ISpecification[]} specs - An array of specifications to be merged.
+     */
+    constructor(...specs: Array<ISpecification>);
 }
-export declare class OrSpecification implements ISpecification {
-    criteria: any;
+/**
+ * OrSpecification is a class that extends `BasicSpecification` and allows for the combination of
+ * multiple specifications using a logical OR operation. The resulting specification matches entities that satisfy
+ * at least one of the provided specifications.
+ *
+ * This class is useful when you need to apply multiple specifications to a query in a way that matches entities
+ * that meet any of the specified criteria.
+ *
+ * @class OrSpecification
+ * @extends {BasicSpecification}
+ */
+export declare class OrSpecification extends BasicSpecification {
+    /**
+     * Creates an instance of OrSpecification.
+     *
+     * @param {...ISpecification[]} spec - An array of specifications to be combined using a logical OR.
+     */
     constructor(...spec: Array<ISpecification>);
 }
-export declare class AndSpecification implements ISpecification {
-    criteria: any;
+/**
+ * AndSpecification is a class that extends `BasicSpecification` and allows for the combination of
+ * multiple specifications using a logical AND operation. The resulting specification matches entities that satisfy
+ * all the provided specifications.
+ *
+ * This class is useful when you need to apply multiple specifications to a query in a way that matches entities
+ * that meet all the specified criteria.
+ *
+ * @class AndSpecification
+ * @extends {BasicSpecification}
+ */
+export declare class AndSpecification extends BasicSpecification {
+    /**
+     * Creates an instance of AndSpecification.
+     *
+     * @param {...ISpecification[]} spec - An array of specifications to be combined using a logical AND.
+     */
     constructor(...spec: Array<ISpecification>);
 }

package/src/lib/specifications.js

@@ -1,28 +1,98 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AndSpecification = exports.OrSpecification = exports.MergeSpecification = void 0;
-class MergeSpecification {
-    constructor(...spec) {
-        this.criteria = {};
-        spec.forEach(s => {
-            this.criteria = Object.assign(Object.assign({}, this.criteria), s.criteria);
+exports.AndSpecification = exports.OrSpecification = exports.MergeSpecification = exports.BasicSpecification = void 0;
+/**
+ * BasicSpecification is a class that implements the `ISpecification` interface and serves as a base
+ * class for defining basic query criteria. It holds a single set of criteria that can be used to
+ * filter entities in a repository or database.
+ *
+ * This class can be extended to create more complex specifications by combining or modifying the
+ * base criteria.
+ *
+ * @class BasicSpecification
+ * @implements {ISpecification}
+ */
+class BasicSpecification {
+    /**
+     * Creates an instance of BasicSpecification.
+     *
+     * @param {any} criteria - The criteria used to filter entities.
+     */
+    constructor(criteria) {
+        this.criteria = criteria;
+    }
+}
+exports.BasicSpecification = BasicSpecification;
+/**
+ * MergeSpecification is a class that extends `BasicSpecification` and allows for the merging of multiple
+ * specifications into a single specification. The resulting specification combines the criteria of all provided
+ * specifications using a shallow merge.
+ *
+ * This class is useful when you need to apply multiple specifications to a query in a way that combines their criteria.
+ *
+ * @class MergeSpecification
+ * @extends {BasicSpecification}
+ */
+class MergeSpecification extends BasicSpecification {
+    /**
+     * Creates an instance of MergeSpecification.
+     *
+     * @param {...ISpecification[]} specs - An array of specifications to be merged.
+     */
+    constructor(...specs) {
+        let criteria = {};
+        specs.forEach(spec => {
+            criteria = Object.assign(Object.assign({}, criteria), spec.criteria);
         });
+        super(criteria);
     }
 }
 exports.MergeSpecification = MergeSpecification;
-class OrSpecification {
+/**
+ * OrSpecification is a class that extends `BasicSpecification` and allows for the combination of
+ * multiple specifications using a logical OR operation. The resulting specification matches entities that satisfy
+ * at least one of the provided specifications.
+ *
+ * This class is useful when you need to apply multiple specifications to a query in a way that matches entities
+ * that meet any of the specified criteria.
+ *
+ * @class OrSpecification
+ * @extends {BasicSpecification}
+ */
+class OrSpecification extends BasicSpecification {
+    /**
+     * Creates an instance of OrSpecification.
+     *
+     * @param {...ISpecification[]} spec - An array of specifications to be combined using a logical OR.
+     */
     constructor(...spec) {
-        this.criteria = {
+        super({
             $or: spec.map(c => c.criteria)
-        };
+        });
     }
 }
 exports.OrSpecification = OrSpecification;
-class AndSpecification {
+/**
+ * AndSpecification is a class that extends `BasicSpecification` and allows for the combination of
+ * multiple specifications using a logical AND operation. The resulting specification matches entities that satisfy
+ * all the provided specifications.
+ *
+ * This class is useful when you need to apply multiple specifications to a query in a way that matches entities
+ * that meet all the specified criteria.
+ *
+ * @class AndSpecification
+ * @extends {BasicSpecification}
+ */
+class AndSpecification extends BasicSpecification {
+    /**
+     * Creates an instance of AndSpecification.
+     *
+     * @param {...ISpecification[]} spec - An array of specifications to be combined using a logical AND.
+     */
     constructor(...spec) {
-        this.criteria = {
+        super({
             $and: spec.map(c => c.criteria)
-        };
+        });
     }
 }
 exports.AndSpecification = AndSpecification;

package/src/lib/specifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"specifications.js","sourceRoot":"","sources":["../../../../../../libs/shared/domain-core/src/lib/specifications.ts"],"names":[],"mappings":";;;AAEA,MAAa,kBAAkB;IAG3B,YAAY,GAAG,IAA2B;QACtC,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QAEnB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACd,IAAI,CAAC,QAAQ,mCACN,IAAI,CAAC,QAAQ,GACb,CAAC,CAAC,QAAQ,CAChB,CAAA;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AAbD,gDAaC;AAED,MAAa,eAAe;IAGxB,YAAY,GAAG,IAA2B;QACtC,IAAI,CAAC,QAAQ,GAAG;YACZ,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;SACjC,CAAC;IACN,CAAC;CACJ;AARD,0CAQC;AAED,MAAa,gBAAgB;IAGzB,YAAY,GAAG,IAA2B;QACtC,IAAI,CAAC,QAAQ,GAAG;YACZ,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;SAClC,CAAC;IACN,CAAC;CACJ;AARD,4CAQC"}
+{"version":3,"file":"specifications.js","sourceRoot":"","sources":["../../../../../../packages/shared/domain-core/src/lib/specifications.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;GAUG;AACH,MAAa,kBAAkB;IAE3B;;;;OAIG;IACH,YAA4B,QAAa;QAAb,aAAQ,GAAR,QAAQ,CAAK;IAAI,CAAC;CACjD;AARD,gDAQC;AAED;;;;;;;;;GASG;AACH,MAAa,kBAAmB,SAAQ,kBAAkB;IAEtD;;;;OAIG;IACH,YAAY,GAAG,KAA4B;QACvC,IAAI,QAAQ,GAAG,EAAE,CAAC;QAElB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YAClB,QAAQ,mCACD,QAAQ,GACR,IAAI,CAAC,QAAQ,CACnB,CAAA;QACJ,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;CACJ;AAnBD,gDAmBC;AAED;;;;;;;;;;GAUG;AACH,MAAa,eAAgB,SAAQ,kBAAkB;IAEnD;;;;OAIG;IACH,YAAY,GAAG,IAA2B;QACtC,KAAK,CAAC;YACF,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;SACjC,CAAC,CAAC;IACP,CAAC;CACJ;AAZD,0CAYC;AAED;;;;;;;;;;GAUG;AACH,MAAa,gBAAiB,SAAQ,kBAAkB;IAEpD;;;;OAIG;IACH,YAAY,GAAG,IAA2B;QACtC,KAAK,CAAC;YACF,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;SAClC,CAAC,CAAC;IACP,CAAC;CACJ;AAZD,4CAYC"}

package/test-setup.js

@@ -1 +0,0 @@
-//# sourceMappingURL=test-setup.js.map

package/test-setup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"test-setup.js","sourceRoot":"","sources":["../../../../libs/shared/domain-core/test-setup.ts"],"names":[],"mappings":""}