@codex-ts/core-lib 1.1.4 → 1.1.6

package/lib/services/base-entity.service.d.ts

@@ -0,0 +1,80 @@
+import { Observable } from 'rxjs';
+import { HttpUtilityService } from './http-utility.service';
+import { UtilsService } from './utils.service';
+import { MessageService } from 'primeng/api';
+import { Page } from '../models/pagination/page.interface';
+import { PageRequest } from '../models/pagination/page-request.interface';
+import { EntityService } from './entity-service.interface';
+import { ReferenceDto } from '../models/reference-dto.interface';
+import { BaseModel } from '../models/base.model';
+export declare abstract class BaseEntityService<T extends BaseModel> implements EntityService<T> {
+    protected httpUtility: HttpUtilityService;
+    protected utilsService: UtilsService;
+    protected resourcePath: string;
+    protected backendBaseUrl: string;
+    protected messageService: MessageService | undefined;
+    get loading$(): Observable<boolean>;
+    protected apiUrl: string;
+    /**
+     * Creates an instance of BaseCrudService.
+     * @param httpUtility - Service for making HTTP requests
+     * @param utilsService - Utility service for common operations
+     * @param resourcePath - API resource path (e.g., 'customers', 'products')
+     * @param backendBaseUrl - Base URL for the backend API
+     * @param messageService - Optional service for showing messages
+     */
+    protected constructor(httpUtility: HttpUtilityService, utilsService: UtilsService, resourcePath: string, backendBaseUrl: string, messageService: MessageService | undefined);
+    /**
+     * Find entities by createdBy with pagination using PageRequest and filters.
+     * POST /page with { ...pageRequest, filters: [{ field: 'createdBy', value: createdBy }] }
+     */
+    findByCreatedBy(createdBy: string, pageRequest?: PageRequest): Observable<Page<T>>;
+    /**
+     * Get all entities with pagination.
+     * POST /page with pageRequest
+     */
+    getAll(pageRequest?: PageRequest): Observable<Page<T>>;
+    /**
+     * Joins URL parts ensuring no double slashes
+     */
+    private joinUrls;
+    getById(uuid: string): Observable<T>;
+    create(entity: Omit<T, 'uuid'>): Observable<T>;
+    update(uuid: string, entity: Omit<T, 'uuid'>): Observable<T>;
+    delete(uuid: string): Observable<void>;
+    /**
+     * Get all entities without pagination.
+     * GET /
+     */
+    findAll(): Observable<T[]>;
+    /**
+     * Get detailed entity information by UUID.
+     * GET /{uuid}/detailed
+     */
+    findDetailedByUuid(uuid: string): Observable<T>;
+    /**
+     * Partially update an entity with the specified field values.
+     * PATCH /{uuid}
+     */
+    patch(uuid: string, updates: Partial<T>): Observable<T>;
+    /**
+     * Get all entities as reference data.
+     * GET /reference
+     */
+    findAllReference(): Observable<ReferenceDto[]>;
+    /**
+     * Get paginated reference data.
+     * POST /reference/page
+     */
+    findAllReferencePaginated(pageRequest?: PageRequest): Observable<Page<ReferenceDto>>;
+    /**
+     * Get all entities with filters (non-paginated).
+     * GET /search?field=value&...
+     */
+    findAllWithFilters(filters: Record<string, string>): Observable<T[]>;
+    /**
+     * Get a single entity by filters (non-paginated).
+     * GET /search-one?field=value&...
+     */
+    findOneWithFilters(filters: Record<string, string>): Observable<T | null>;
+}

package/lib/services/base-error.service.d.ts

@@ -0,0 +1,24 @@
+import { InjectionToken, Signal } from '@angular/core';
+import { HttpErrorResponse } from '@angular/common/http';
+import * as i0 from "@angular/core";
+export interface ErrorState {
+    type: string;
+    message: string;
+    code?: string | number;
+    [key: string]: any;
+}
+export declare class BaseErrorService {
+    private readonly _error;
+    private readonly router;
+    private readonly messageService;
+    get error(): Signal<ErrorState | null>;
+    /**
+     * Handle HTTP and other errors in the application
+     */
+    handleError(error: HttpErrorResponse | Error): void;
+    setError(error: ErrorState): void;
+    clearError(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BaseErrorService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<BaseErrorService>;
+}
+export declare const ERROR_SERVICE: InjectionToken<BaseErrorService>;

package/lib/services/base-task.service.d.ts

@@ -3,38 +3,33 @@ import { HttpUtilityService } from './http-utility.service';
 import { UtilsService } from './utils.service';
 import { MessageService } from 'primeng/api';
 import { Page } from '../models/pagination/page.interface';
-import { PageRequest } from '../models/pagination/page-request.interface';
-import { BaseCrudService } from './base-crud.service';
+import { BaseEntityService } from './base-entity.service';
+import { KeycloakService } from '../keycloak/keycloak.service';
+import { BaseTask } from '../models/base-task.model';
+import { TaskEntityService } from './task-entity-service.interface';
 import * as i0 from "@angular/core";
 /**
  * Base service for task-related operations that extends the BaseCrudService.
  * Implements endpoints defined in Java BaseTaskController.
  */
-export declare abstract class BaseTaskService<T extends {
-    uuid: string;
-}> extends BaseCrudService<T> {
+export declare abstract class BaseTaskService<T extends BaseTask, AU = any, S extends string = string, E extends string = string> extends BaseEntityService<T> implements TaskEntityService<T, S, E> {
     protected httpUtility: HttpUtilityService;
     protected utilsService: UtilsService;
     protected resourcePath: string;
     protected backendBaseUrl: string;
     protected messageService: MessageService | undefined;
-    constructor(httpUtility: HttpUtilityService, utilsService: UtilsService, resourcePath: string, backendBaseUrl: string, messageService: MessageService | undefined);
-    /**
-     * Find tasks by department with pagination
-     * Maps to GET /department/{department} endpoint
-     */
-    findByDepartment(department: string, pageRequest?: PageRequest): Observable<Page<T>>;
-    /**
-     * Find tasks by assigned user with pagination
-     * Maps to GET /user/{userId} endpoint
-     */
-    findByAssignedUser(userId: string, pageRequest?: PageRequest): Observable<Page<T>>;
+    readonly keycloakService: KeycloakService;
+    constructor(httpUtility: HttpUtilityService, utilsService: UtilsService, resourcePath: string, backendBaseUrl: string, messageService: MessageService | undefined, keycloakService: KeycloakService);
     /**
      * Send an event for a task
      * Maps to PUT /{uuid}/event/{event} endpoint
      * For ASSIGN events, userId and department are required
      */
-    sendEvent(uuid: string, event: string, userId?: string, department?: string): Observable<T>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<BaseTaskService<any>, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<BaseTaskService<any>>;
+    sendEvent(uuid: string, event: E, userId?: string, department?: string): Observable<T>;
+    /**
+     * Calls POST /current-assignees-in endpoint to fetch tasks by assignees with pagination.
+     */
+    getByCurrentAssigneesIn(assigneeIds: string[], pageable?: any): Observable<Page<T>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BaseTaskService<any, any, any, any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<BaseTaskService<any, any, any, any>>;
 }

package/lib/services/entity-registry.service.d.ts

@@ -0,0 +1,21 @@
+import { Observable } from 'rxjs';
+import { HttpUtilityService } from './http-utility.service';
+import { ReferenceDataProviderService } from './reference-data-provider.service';
+import * as i0 from "@angular/core";
+export declare class EntityRegistryService {
+    private httpUtility;
+    private dataProvider;
+    constructor(httpUtility: HttpUtilityService, dataProvider: ReferenceDataProviderService);
+    /**
+     * Gets reference options for an entity, suitable for select/dropdown components
+     * @param entityName The name of the entity (e.g., 'customers', 'departments')
+     * @returns Observable of options array with label/value pairs
+     */
+    getEntityOptions(entityName: string): Observable<{
+        label: string;
+        value: string;
+        data?: any;
+    }[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EntityRegistryService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<EntityRegistryService>;
+}

package/lib/services/entity-service.interface.d.ts

@@ -0,0 +1,22 @@
+import { Observable } from 'rxjs';
+import { Page } from '../models/pagination/page.interface';
+import { PageRequest } from '../models/pagination/page-request.interface';
+import { ReferenceDto } from '../models/reference-dto.interface';
+import { BaseModel } from '../models/base.model';
+/**
+ * Base interface for CRUD operations that all entity services must implement
+ * @template T - The entity type
+ */
+export interface EntityService<T extends BaseModel> {
+    create(data: Omit<T, 'uuid'>): Observable<T>;
+    update(uuid: string, data: Omit<T, 'uuid'>): Observable<T>;
+    delete(uuid: string): Observable<void>;
+    getById(uuid: string): Observable<T>;
+    getAll(pageRequest?: PageRequest): Observable<Page<T>>;
+    findAll(): Observable<T[]>;
+    findAllReference(): Observable<ReferenceDto[]>;
+    findAllReferencePaginated(pageRequest?: PageRequest): Observable<Page<ReferenceDto>>;
+    findByCreatedBy(createdBy: string, pageRequest?: PageRequest): Observable<Page<T>>;
+    patch(uuid: string, updates: Partial<T>): Observable<T>;
+    findDetailedByUuid(uuid: string): Observable<T>;
+}

package/lib/services/form.service.d.ts

@@ -1,20 +1,22 @@
 import { Observable } from 'rxjs';
 import { PageMode } from '../constants/app.constants';
 import { FormComponentState } from '../states/form-component.state';
-import { EntityService } from './entity.service';
+import { EntityService } from './entity-service.interface';
 import { FormlyConfigService } from './formly-config.service';
 import { NotificationService } from './notification.service';
-export declare class FormService<T extends {
-    uuid: string;
-}> {
+import { BaseModel } from '../models/base.model';
+export declare class FormService<T extends BaseModel> {
     private entityService;
     private formlyConfigService;
     private notificationService;
     private entityName;
     private jsonFields;
     private dropdownOptions;
-    protected formState: FormComponentState<T>;
+    formState: FormComponentState<T>;
     constructor(entityService: EntityService<T>, formlyConfigService: FormlyConfigService, notificationService: NotificationService, entityName: string, jsonFields: any, dropdownOptions?: Record<string, any>);
+    private handleFormChange;
+    private updateState;
+    private calculateHasChanges;
     private initializeForm;
     private getFormlyFieldConfig;
     loadData(uuid?: string): Observable<void>;
@@ -25,7 +27,4 @@ export declare class FormService<T extends {
     setMode(mode: PageMode): void;
     getState(): FormComponentState<T>;
     patchValue(value: Partial<T>): void;
-    private updateCurrentData;
-    private checkFormChanges;
-    private hasFormChanges;
 }

package/lib/services/http-utility.service.d.ts

@@ -61,6 +61,21 @@ export declare class HttpUtilityService {
         retries?: number;
         timeoutMs?: number;
     }): Observable<T>;
+    /**
+     * Perform a PATCH request with enhanced options
+     * @param url The endpoint URL
+     * @param body The request payload
+     * @param options Additional request options
+     * @returns An observable of the response
+     */
+    patch<T>(url: string, body: any, options?: {
+        params?: HttpParams | Record<string, string | number | boolean | readonly (string | number | boolean)[]>;
+        headers?: HttpHeaders | Record<string, string | string[]>;
+        responseType?: 'json';
+        withCredentials?: boolean;
+        retries?: number;
+        timeoutMs?: number;
+    }): Observable<T>;
     /**
      * Perform a DELETE request with enhanced options
      * @param url The endpoint URL

package/lib/services/master-data-service.interface.d.ts

@@ -0,0 +1,5 @@
+import { Observable } from 'rxjs';
+import { IDepartment } from '../models/department.interface';
+export interface MasterDataService {
+    getDepartments(): Observable<IDepartment[]>;
+}

package/lib/services/task-entity-service.interface.d.ts

@@ -0,0 +1,21 @@
+import { Observable } from "rxjs";
+import { EntityService } from "./entity-service.interface";
+import { BaseTask } from "../models/base-task.model";
+/**
+ * Interface for task-specific operations
+ * @template T - The entity type (must extend BaseTaskModel)
+ * @template S - The status enum type (for task status)
+ * @template E - The event enum type (for task events)
+ */
+export interface TaskEntityService<T extends BaseTask, S extends string = string, E extends string = string> extends EntityService<T> {
+    /**
+     * Send an event for a task.
+     * Maps to PUT /{uuid}/event/{event} endpoint.
+     * For ASSIGN events, userId and department are required.
+     * @param uuid The task UUID.
+     * @param event The event enum value.
+     * @param userId Optional user ID for assignment.
+     * @param department Optional department for assignment.
+     */
+    sendEvent(uuid: string, event: E, userId?: string, department?: string): Observable<T>;
+}

package/lib/validators/common-validators.d.ts

@@ -0,0 +1,61 @@
+import { AbstractControl, ValidationErrors, ValidatorFn } from '@angular/forms';
+import { FormlyFieldConfig } from '@ngx-formly/core';
+/**
+ * Common Validators for form fields
+ */
+export declare class CommonValidators {
+    /**
+     * Email validator pattern
+     * Matches standard email format with @ and domain
+     */
+    static readonly EMAIL_PATTERN: RegExp;
+    /**
+     * Indian mobile number validator pattern
+     * Matches 10-digit numbers, optionally starting with +91 or 0
+     */
+    static readonly MOBILE_PATTERN: RegExp;
+    /**
+     * PAN card validator pattern
+     * Format: AAAAA0000A (5 letters, 4 numbers, 1 letter)
+     */
+    static readonly PAN_PATTERN: RegExp;
+    /**
+     * Returns a validator function to check if the value matches the given pattern
+     * @param pattern - Regular expression to test
+     * @param errorMessage - Optional custom error message
+     */
+    static patternValidator(pattern: RegExp, errorMessage?: string): ValidatorFn;
+    /**
+     * Email validator function
+     */
+    static email(control: AbstractControl): ValidationErrors | null;
+    /**
+     * Mobile number validator function
+     */
+    static mobileNumber(control: AbstractControl): ValidationErrors | null;
+    /**
+     * PAN card validator function
+     */
+    static panCard(control: AbstractControl): ValidationErrors | null;
+    /**
+     * Generate formly validator configuration for email
+     */
+    static formlyEmailValidator(): {
+        expression: (fc: AbstractControl) => boolean;
+        message: (error: any, field: FormlyFieldConfig) => string;
+    };
+    /**
+     * Generate formly validator configuration for mobile number
+     */
+    static formlyMobileValidator(): {
+        expression: (fc: AbstractControl) => boolean;
+        message: (error: any, field: FormlyFieldConfig) => string;
+    };
+    /**
+     * Generate formly validator configuration for PAN card
+     */
+    static formlyPanValidator(): {
+        expression: (fc: AbstractControl) => boolean;
+        message: (error: any, field: FormlyFieldConfig) => string;
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codex-ts/core-lib",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "peerDependencies": {
@@ -26,4 +26,4 @@
       "default": "./fesm2022/codex-ts-core-lib.mjs"
     }
   }
-}
+}

package/public-api.d.ts

@@ -1,40 +1,58 @@
-export * from './lib/constants/app.constants';
-export * from './lib/constants/app.messages';
-export * from './lib/enums/component-context.enum';
-export * from './lib/enums/tabbed-form-type.enum';
-export * from './lib/enums/task-role.enum';
+export * from './lib/components/base-form.component';
+export * from './lib/components/base-list-page.component';
+export * from './lib/components/base-list-tabbed-form.component';
+export * from './lib/components/base-page.component';
+export * from './lib/components/base-tabbed-form.component';
+export * from './lib/components/base-table.component';
+export * from './lib/components/base-task-dashboard.component';
+export * from './lib/components/base-task-details.component';
+export * from './lib/keycloak/keycloak-config.interface';
+export * from './lib/keycloak/keycloak.interface';
+export * from './lib/keycloak/keycloak-service.token';
+export * from './lib/keycloak/keycloak.guard';
+export * from './lib/keycloak/keycloak.providers';
+export * from './lib/keycloak/keycloak.service';
+export * from './lib/keycloak/keycloak.token';
+export * from './lib/models/department.interface';
+export * from './lib/services/master-data-service.interface';
+export * from './lib/services/base-error.service';
+export * from './lib/services/base-entity.service';
+export * from './lib/services/base-task.service';
+export * from './lib/services/entity-service.interface';
+export * from './lib/services/task-entity-service.interface';
+export * from './lib/services/entity-service.interface';
+export * from './lib/services/entity-registry.service';
+export * from './lib/services/enum-registry.service';
+export * from './lib/services/form.service';
+export * from './lib/services/formly-config.service';
+export * from './lib/services/http-utility.service';
+export * from './lib/services/notification.service';
+export * from './lib/services/reference-data-provider.service';
+export * from './lib/services/utils.service';
+export * from './lib/pipes/indian-date.pipe';
 export * from './lib/models/base.model';
-export * from './lib/models/base-task.model';
 export * from './lib/models/base-request.model';
 export * from './lib/models/base-response.model';
+export * from './lib/models/base-task.model';
+export * from './lib/models/base.comment.model';
 export * from './lib/models/base-create-request.model';
 export * from './lib/models/base-update-request.model';
-export * from './lib/models/pagination/page.interface';
+export * from './lib/models/pagination/filter-criteria.interface';
+export * from './lib/models/pagination/table-column-datatype.enum';
 export * from './lib/models/pagination/page-request.interface';
-export { KEYCLOAK_CONFIG } from './lib/keycloak/keycloak.token';
-export * from './lib/keycloak/keycloak-config.interface';
-export * from './lib/keycloak/keycloak.service';
-export { provideKeycloak } from './lib/keycloak/keycloak.providers';
-export { KeycloakAuthGuard } from './lib/keycloak/keycloak.guard';
-export * from './lib/services/http-utility.service';
-export * from './lib/services/utils.service';
-export * from './lib/services/notification.service';
-export * from './lib/services/entity.service';
-export * from './lib/services/base-crud.service';
-export * from './lib/services/base-task.service';
-export * from './lib/services/formly-config.service';
-export * from './lib/services/form.service';
+export * from './lib/models/pagination/page.interface';
+export * from './lib/models/pagination/sort-criteria.interface';
+export * from './lib/enums/component-context.enum';
+export * from './lib/enums/tabbed-form-type.enum';
+export * from './lib/enums/task-role.enum';
+export * from './lib/constants/app.constants';
+export * from './lib/constants/app.messages';
 export * from './lib/components/formly/core-formly.module';
-export * from './lib/components/base-form.component';
-export * from './lib/components/base-page.component';
-export * from './lib/components/base-list-page.component';
-export * from './lib/components/base-tabbed-form.component';
-export * from './lib/components/base-list-tabbed-form.component';
-export * from './lib/components/base-task-details.component';
-export * from './lib/components/base-task-dashboard.component';
-export * from './lib/states/form.state';
-export * from './lib/states/form-component.state';
-export * from './lib/states/tabbed-form.state';
-export * from './lib/states/list-tabbed-form.state';
-export * from './lib/services/reference-data-provider.service';
-export * from './lib/pipes/indian-date.pipe';
+export * from './lib/components/formly/field.interface';
+export * from './lib/components/formly/form-field.wrapper';
+export * from './lib/components/formly/formly.constants';
+export * from './lib/components/formly/primeng-formly.module';
+export * from './lib/validators/common-validators';
+export * from './lib/components/keycloak-error-banner/keycloak-error-page.component';
+export * from './lib/components/not-found/not-found.component';
+export * from './lib/components/unauthorized/unauthorized.component';

package/lib/services/base-crud.service.d.ts

@@ -1,36 +0,0 @@
-import { Observable } from 'rxjs';
-import { HttpUtilityService } from './http-utility.service';
-import { UtilsService } from './utils.service';
-import { MessageService } from 'primeng/api';
-import { Page } from '../models/pagination/page.interface';
-import { PageRequest } from '../models/pagination/page-request.interface';
-import { EntityService } from './entity.service';
-export declare abstract class BaseCrudService<T extends {
-    uuid: string;
-}> implements EntityService<T> {
-    protected httpUtility: HttpUtilityService;
-    protected utilsService: UtilsService;
-    protected resourcePath: string;
-    protected backendBaseUrl: string;
-    protected messageService: MessageService | undefined;
-    get loading$(): Observable<boolean>;
-    protected apiUrl: string;
-    /**
-     * Creates an instance of BaseCrudService.
-     * @param httpUtility - Service for making HTTP requests
-     * @param utilsService - Utility service for common operations
-     * @param resourcePath - API resource path (e.g., 'customers', 'products')
-     * @param backendBaseUrl - Base URL for the backend API
-     * @param messageService - Optional service for showing messages
-     */
-    protected constructor(httpUtility: HttpUtilityService, utilsService: UtilsService, resourcePath: string, backendBaseUrl: string, messageService: MessageService | undefined);
-    /**
-     * Joins URL parts ensuring no double slashes
-     */
-    private joinUrls;
-    getAll(pageRequest?: PageRequest): Observable<Page<T>>;
-    getById(uuid: string): Observable<T>;
-    create(entity: Omit<T, 'uuid'>): Observable<T>;
-    update(uuid: string, entity: Omit<T, 'uuid'>): Observable<T>;
-    delete(uuid: string): Observable<void>;
-}

package/lib/services/entity.service.d.ts

@@ -1,9 +0,0 @@
-import { Observable } from 'rxjs';
-/**
- * Interface for basic CRUD operations that all entity services must implement
- */
-export interface EntityService<T> {
-    create(data: Omit<T, 'uuid'>): Observable<T>;
-    update(uuid: string, data: Omit<T, 'uuid'>): Observable<T>;
-    getById(uuid: string): Observable<T>;
-}