@acontplus/core 1.0.16 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 # @acontplus/core
 
-Core library for AcontPlus applications, providing essential utilities and functionalities for business logic, calculations, and configuration management.
+Core library for AcontPlus applications, providing essential utilities, domain models, clean architecture patterns, and business logic components following Domain-Driven Design (DDD) principles.
 
 ## Installation
 
@@ -10,19 +10,55 @@ npm install @acontplus/core
 
 ## Features
 
-- **Pricing Calculations**: Comprehensive pricing utilities including discount calculators, line item calculators, pricing calculators, profit calculators, and tax calculators
-- **Constants**: Predefined constants for SRI (Servicio de Rentas Internas) document types and separators
+- **Clean Architecture**: Ports and adapters pattern for external integrations
+- **Domain Models**: Base entities, value objects, and domain-specific models
+- **Pricing Engine**: Comprehensive pricing calculations with discount, tax, profit, and line item calculators
+- **HTTP Adapters**: Axios and Fetch adapters with HTTP client factory
+- **Use Cases**: Base use case pattern for business logic encapsulation
+- **Value Objects**: Money, EntityId, IdentificationNumber, and AuthTokens value objects
 - **Environment Configuration**: Type-safe environment configuration interfaces
-- **Models & Value Objects**: Domain models and value objects for business entities
-- **Ports & Adapters**: Clean architecture patterns with ports and adapters for external integrations
-- **Type Definitions**: Comprehensive TypeScript type definitions for type safety
+- **Constants**: Application constants including SRI document types
+- **Type Definitions**: Comprehensive TypeScript type definitions for pricing and business logic
+
+## Architecture
+
+This library follows Clean Architecture principles with clear separation of concerns:
+
+- **Adapters**: External service integrations (HTTP clients)
+- **Ports**: Interfaces for external dependencies
+- **Models**: Domain entities and data transfer objects
+- **Value Objects**: Immutable objects representing domain concepts
+- **Use Cases**: Business logic encapsulation
+- **Types**: TypeScript definitions for type safety
 
 ## Usage
 
+### HTTP Adapters
+
+```typescript
+import { HttpClientFactory, AxiosAdapter, FetchAdapter } from '@acontplus/core';
+
+// Create HTTP client with Axios
+const axiosClient = HttpClientFactory.create('axios');
+
+// Create HTTP client with Fetch
+const fetchClient = HttpClientFactory.create('fetch');
+
+// Use adapter directly
+const axiosAdapter = new AxiosAdapter();
+const response = await axiosAdapter.get('https://api.example.com/data');
+```
+
 ### Pricing Calculations
 
 ```typescript
-import { DiscountCalculator, TaxCalculator, PricingCalculator } from '@acontplus/core';
+import {
+  DiscountCalculator,
+  TaxCalculator,
+  PricingCalculator,
+  ProfitCalculator,
+  LineItemCalculator,
+} from '@acontplus/core';
 
 // Calculate discounts
 const discountCalc = new DiscountCalculator();
@@ -32,21 +68,105 @@ const discount = discountCalc.calculate(100, 10); // 10% discount on $100
 const taxCalc = new TaxCalculator();
 const tax = taxCalc.calculate(100, 0.12); // 12% tax on $100
 
+// Calculate profit margins
+const profitCalc = new ProfitCalculator();
+const profit = profitCalc.calculate(cost, sellingPrice);
+
+// Line item calculations
+const lineItemCalc = new LineItemCalculator();
+const lineTotal = lineItemCalc.calculate(quantity, unitPrice, discount, tax);
+
 // Complex pricing calculations
 const pricingCalc = new PricingCalculator();
 const finalPrice = pricingCalc.calculateTotal(items, discounts, taxes);
 ```
 
-### Constants
+### Value Objects
 
 ```typescript
-import { SRI_DOCUMENT_TYPE, SEPARATOR_KEY_CODE } from '@acontplus/core';
+import { Money, EntityId, IdentificationNumber, AuthTokens } from '@acontplus/core';
+
+// Money value object for financial calculations
+const price = new Money(99.99, 'USD');
+const discountedPrice = price.subtract(new Money(10.0, 'USD'));
 
-// Use SRI document types for Ecuadorian tax system
-const documentType = SRI_DOCUMENT_TYPE.RUC; // '04'
+// Entity ID for domain entities
+const customerId = new EntityId(12345);
 
-// Use separator constants
-const separator = SEPARATOR_KEY_CODE.SLASH; // '|'
+// Identification number with validation
+const ecuadorianId = new IdentificationNumber('1234567890');
+
+// Authentication tokens
+const tokens = new AuthTokens('access_token', 'refresh_token');
+```
+
+### Domain Models
+
+```typescript
+import { BaseEntity, ApiResponse, PaginatedResult } from '@acontplus/core';
+
+// Base entity for domain objects
+class Customer extends BaseEntity {
+  constructor(
+    id: number,
+    public readonly name: string,
+    public readonly email: string,
+  ) {
+    super(id);
+  }
+}
+
+// API response handling
+const response: ApiResponse<Customer> = {
+  success: true,
+  data: customer,
+  message: 'Customer retrieved successfully',
+};
+
+// Paginated results
+const paginatedCustomers: PaginatedResult<Customer> = {
+  items: customers,
+  totalCount: 100,
+  pageSize: 10,
+  currentPage: 1,
+};
+```
+
+### Use Cases
+
+```typescript
+import { UseCase } from '@acontplus/core';
+
+// Business logic encapsulation
+class CreateCustomerUseCase extends UseCase<CreateCustomerRequest, Customer> {
+  constructor(private customerRepository: CustomerRepository) {
+    super();
+  }
+
+  async execute(request: CreateCustomerRequest): Promise<Customer> {
+    // Validate business rules
+    this.validateRequest(request);
+
+    // Execute business logic
+    return await this.customerRepository.create(request);
+  }
+
+  private validateRequest(request: CreateCustomerRequest): void {
+    if (!request.name || request.name.trim().length === 0) {
+      throw new Error('Customer name is required');
+    }
+  }
+}
+```
+
+### Constants
+
+```typescript
+import { APP_CONSTANTS } from '@acontplus/core';
+
+// Application constants
+const maxRetries = APP_CONSTANTS.MAX_RETRY_ATTEMPTS;
+const timeout = APP_CONSTANTS.DEFAULT_TIMEOUT;
 ```
 
 ### Environment Configuration
@@ -64,6 +184,16 @@ const environment: Environment = {
 };
 ```
 
-## Running unit tests
+### Pricing Types
 
-Run `nx test core` to execute the unit tests.
+```typescript
+import { PricingTypes } from '@acontplus/core';
+
+// Type-safe pricing calculations
+const calculation: PricingTypes.PricingCalculation = {
+  basePrice: 100,
+  discounts: [{ type: 'percentage', value: 10 }],
+  taxes: [{ type: 'percentage', value: 8.25 }],
+  finalPrice: 97.43,
+};
+```

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@acontplus/core",
-  "version": "1.0.16",
-  "description": "Core library for Acontplus projects, providing essential utilities and functionalities.",
+  "version": "1.1.0",
+  "description": "Enterprise-grade core library implementing Domain-Driven Design (DDD) and Clean Architecture patterns. Provides value objects, use cases, entities, HTTP adapters, pricing calculations, API response handling, and foundational utilities for Angular applications.",
   "dependencies": {
-    "@acontplus/utils": "^1.0.8",
+    "@acontplus/utils": "^1.0.10",
     "tslib": "^2.8.1",
     "uuid": "^13.0.0"
   },
@@ -30,11 +30,26 @@
     "test": "nx test core"
   },
   "keywords": [
+    "acontplus",
+    "core",
+    "ddd",
+    "domain-driven-design",
+    "clean-architecture",
+    "use-cases",
+    "value-objects",
+    "entities",
+    "adapters",
+    "ports",
+    "pricing",
     "calculations",
     "constants",
     "environment",
-    "pricing",
-    "typescript"
+    "http-client",
+    "api-response",
+    "pagination",
+    "jwt",
+    "typescript",
+    "library"
   ],
   "author": "Ivan Paz <ifer343@gmail.com>",
   "license": "MIT",

package/src/lib/constants/app.constants.d.ts

@@ -0,0 +1,20 @@
+export declare enum SRI_DOCUMENT_TYPE {
+    RUC = "04",
+    CEDULA = "05",
+    PASSPORT = "06",
+    CONSUMIDOR_FINAL = "07",
+    IDENTIFICACION_EXTERIOR = "08"
+}
+export declare enum SRI_DOCUMENT_TYPE_CUSTOM {
+    RUC = "R",
+    CEDULA = "C",
+    PASSPORT = "P",
+    CONSUMIDOR_FINAL = "CF",
+    IDENTIFICACION_EXTERIOR = "IE"
+}
+export declare enum SEPARATOR_KEY_CODE {
+    SLASH = "|",
+    PUNTO_COMA = ";",
+    DOS_PUNTOS = ":"
+}
+export declare const SEPARADORES_REGEX: RegExp;

package/src/lib/constants/app.constants.js

@@ -0,0 +1,24 @@
+export var SRI_DOCUMENT_TYPE;
+(function (SRI_DOCUMENT_TYPE) {
+    SRI_DOCUMENT_TYPE["RUC"] = "04";
+    SRI_DOCUMENT_TYPE["CEDULA"] = "05";
+    SRI_DOCUMENT_TYPE["PASSPORT"] = "06";
+    SRI_DOCUMENT_TYPE["CONSUMIDOR_FINAL"] = "07";
+    SRI_DOCUMENT_TYPE["IDENTIFICACION_EXTERIOR"] = "08";
+})(SRI_DOCUMENT_TYPE || (SRI_DOCUMENT_TYPE = {}));
+export var SRI_DOCUMENT_TYPE_CUSTOM;
+(function (SRI_DOCUMENT_TYPE_CUSTOM) {
+    SRI_DOCUMENT_TYPE_CUSTOM["RUC"] = "R";
+    SRI_DOCUMENT_TYPE_CUSTOM["CEDULA"] = "C";
+    SRI_DOCUMENT_TYPE_CUSTOM["PASSPORT"] = "P";
+    SRI_DOCUMENT_TYPE_CUSTOM["CONSUMIDOR_FINAL"] = "CF";
+    SRI_DOCUMENT_TYPE_CUSTOM["IDENTIFICACION_EXTERIOR"] = "IE";
+})(SRI_DOCUMENT_TYPE_CUSTOM || (SRI_DOCUMENT_TYPE_CUSTOM = {}));
+export var SEPARATOR_KEY_CODE;
+(function (SEPARATOR_KEY_CODE) {
+    SEPARATOR_KEY_CODE["SLASH"] = "|";
+    SEPARATOR_KEY_CODE["PUNTO_COMA"] = ";";
+    SEPARATOR_KEY_CODE["DOS_PUNTOS"] = ":";
+})(SEPARATOR_KEY_CODE || (SEPARATOR_KEY_CODE = {}));
+export const SEPARADORES_REGEX = new RegExp(`[${Object.values(SEPARATOR_KEY_CODE).join('')}]`);
+//# sourceMappingURL=app.constants.js.map

package/src/lib/constants/app.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.constants.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/constants/app.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,iBAMX;AAND,WAAY,iBAAiB;IAC3B,+BAAU,CAAA;IACV,kCAAa,CAAA;IACb,oCAAe,CAAA;IACf,4CAAuB,CAAA;IACvB,mDAA8B,CAAA;AAChC,CAAC,EANW,iBAAiB,KAAjB,iBAAiB,QAM5B;AAED,MAAM,CAAN,IAAY,wBAMX;AAND,WAAY,wBAAwB;IAClC,qCAAS,CAAA;IACT,wCAAY,CAAA;IACZ,0CAAc,CAAA;IACd,mDAAuB,CAAA;IACvB,0DAA8B,CAAA;AAChC,CAAC,EANW,wBAAwB,KAAxB,wBAAwB,QAMnC;AAED,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,iCAAW,CAAA;IACX,sCAAgB,CAAA;IAChB,sCAAgB,CAAA;AAClB,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B;AACD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC"}

package/src/lib/constants/index.d.ts

@@ -1 +1 @@
-export * from './constants';
+export * from './app.constants';

package/src/lib/constants/index.js

@@ -1,2 +1,2 @@
-export * from './constants';
+export * from './app.constants';
 //# sourceMappingURL=index.js.map

package/src/lib/constants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/src/lib/models/core-config.d.ts

@@ -0,0 +1,19 @@
+export interface CoreConfig {
+    apiBaseUrl?: string;
+    apiTimeout?: number;
+    retryAttempts?: number;
+    retryDelay?: number;
+    enableCorrelationTracking?: boolean;
+    enableRequestLogging?: boolean;
+    enableErrorLogging?: boolean;
+    enableToastNotifications?: boolean;
+    includeAuthToken?: boolean;
+    authTokenHeader?: string;
+    enableMultiTenancy?: boolean;
+    tenantIdHeader?: string;
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    enableConsoleLogging?: boolean;
+    customHeaders?: Record<string, string | (() => string)>;
+    excludeUrls?: string[];
+    excludeMethods?: string[];
+}

package/src/lib/models/core-config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=core-config.js.map

package/src/lib/models/core-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-config.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/models/core-config.ts"],"names":[],"mappings":""}

package/src/lib/models/index.d.ts

@@ -1,6 +1,8 @@
 export * from './api-response';
-export * from './jwt';
 export * from './base-entity';
-export * from './paginated-result';
+export * from './core-config';
+export * from './jwt';
 export * from './pagination-params';
+export * from './paginated-result';
+export * from './repository-config';
 export * from './user-data';

package/src/lib/models/index.js

@@ -1,7 +1,9 @@
 export * from './api-response';
-export * from './jwt';
 export * from './base-entity';
-export * from './paginated-result';
+export * from './core-config';
+export * from './jwt';
 export * from './pagination-params';
+export * from './paginated-result';
+export * from './repository-config';
 export * from './user-data';
 //# sourceMappingURL=index.js.map

package/src/lib/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC;AACtB,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC"}

package/src/lib/models/repository-config.d.ts

@@ -0,0 +1,5 @@
+export interface RepositoryConfig {
+    endpoint: string;
+    baseUrl?: string;
+    version?: string;
+}

package/src/lib/models/repository-config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=repository-config.js.map

package/src/lib/models/repository-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-config.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/models/repository-config.ts"],"names":[],"mappings":""}