@techextensor/tab-core-utility 2.2.194 → 2.2.196

package/lib/tab-core-utility/app/helpers/common/dsq.helpers.d.ts

@@ -3,8 +3,11 @@ import { AccessType } from '../../enums/permission.enum';
 import * as i0 from "@angular/core";
 export declare class DSQHelper {
     private readonly apiService;
+    private readonly metadataHelper;
     /**
      * Executes a query based on the query type
+     * NOTE: INSERT, UPDATE, and DELETE now use new /records/* endpoints
+     * This helper now only handles legacy endpoints: BulkInsert and Select
      * @param data The data to be executed
      * @param queryType The type of query to be executed
      * @returns The result of the query execution

package/lib/tab-core-utility/app/helpers/common/meta-data.helpers.d.ts

@@ -27,9 +27,9 @@ export declare class MetadataHelper {
      * the given condition, it creates a new model using the given model factory and adds it to the map.
      * @param map The map to search in.
      * @param key The key to search for.
-     * @param sourceList The list of items to search in.
-     * @param matchFn The condition to match.
-     * @param modelFactory The factory to create a new model if the key does not exist.
+     * @param sourceList The list of raw items to search in.
+     * @param matchFn The condition to match against raw items.
+     * @param modelFactory The factory to create a new model from raw item.
      * @returns The value associated with the given key, or null if no match is found.
      */
     private getFromMapOrCreate;

package/lib/tab-core-utility/app/helpers/common/req-res.helpers.d.ts

@@ -1,21 +1,7 @@
-import { APIBulkInsertFieldsValueSets, APIFilterCriteria, APIValueSets } from '../../models/api-query.class';
+import { APIBulkInsertFieldsValueSets, APIFilterCriteria } from '../../models/api-query.class';
 import { QueryType } from '../../enums/query.enum';
 import * as i0 from "@angular/core";
 export declare class RequestResponseHelper {
-    /**
-     * Generates the payload for inserting data into a table
-     * @param table The table name to insert data into
-     * @param whereClause The filter criteria for the insert operation
-     * @param value The value sets to be inserted
-     * @returns The payload for the insert operation
-     */
-    insertPayload(table: string, whereClause: APIFilterCriteria, value: APIValueSets[]): {
-        QueryObjectID: string;
-        QueryType: QueryType;
-        Joins: never[];
-        WhereClause: APIFilterCriteria;
-        Values: APIValueSets[];
-    };
     /**
      * Generates the payload for inserting data into a table in bulk
      * @param table The table name to insert data into
@@ -34,44 +20,14 @@ export declare class RequestResponseHelper {
     };
     /**
      * Generates the payload for deleting data from a table
-     * @param tableName The table name to delete data from
-     * @param whereClause The filter criteria for the delete operation
-     * @returns The payload for the delete operation
+     * NEW: Returns new format for /records/delete endpoint
+     * @param tableName The table name (entityName) to delete data from
+     * @param whereClause The filter criteria for the delete operation (NEW format with lowercase)
+     * @returns The payload for the delete operation in NEW format
      */
     deletePayload(tableName: string, whereClause: APIFilterCriteria): {
-        QueryObjectID: string;
-        QueryType: QueryType;
-        Joins: never[];
-        WhereClause: APIFilterCriteria;
-    };
-    /**
-     * Generates the payload for updating data in a table
-     * @param tableName The table name to update data in
-     * @param whereClause The filter criteria for the update operation
-     * @param value The value sets to be updated
-     * @returns The payload for the update operation
-     */
-    updateRequestPayload(tableName: string, whereClause: APIFilterCriteria, value: APIValueSets[]): {
-        QueryObjectID: string;
-        QueryType: QueryType;
-        Joins: never[];
-        WhereClause: APIFilterCriteria;
-        Values: APIValueSets[];
-    };
-    /**
-     * Creates a payload object based on the input parameters
-     * @param table The table name for the payload
-     * @param whereClause The filter criteria for the payload
-     * @param value The value sets for the payload
-     * @param queryType The type of query for the payload
-     * @returns The payload object with QueryObjectID, QueryType, Joins, WhereClause, and Values
-     */
-    createPayload(table: string, whereClause: APIFilterCriteria, value: APIValueSets[], queryType: QueryType): {
-        QueryObjectID: string;
-        QueryType: QueryType;
-        Joins: never[];
-        WhereClause: APIFilterCriteria;
-        Values: APIValueSets[];
+        entityName: string;
+        whereClause: APIFilterCriteria;
     };
     /**
      * Creates a payload object for bulk insert operations

package/lib/tab-core-utility/app/helpers/common/where-clause.helpers.d.ts

@@ -1,6 +1,7 @@
 import { APIFilterCriteria } from '../../models/api-query.class';
 import * as i0 from "@angular/core";
 export declare class WhereClauseHelper {
+    private readonly metadataHelper;
     /**
      * Binds the where clause for deleting records based on field, value, field name, and CRUD table name
      * @param fields The fields to bind the where clause

package/lib/tab-core-utility/app/helpers/login-response.adapter.d.ts

@@ -0,0 +1,29 @@
+import { CommonApiResponse } from '../interfaces/common.interface';
+/**
+ * LoginResponseAdapter - Transforms new login API response to legacy format
+ *
+ * The new identity service returns a flat response structure with camelCase fields.
+ * This adapter converts it to the old nested structure expected by the application.
+ *
+ * New format (flat):
+ *   { userId, email, userName, accessToken, refreshToken, expiresIn, roles, ... }
+ *
+ * Old format (nested):
+ *   { user: { Id, UserName, Roles, PersonData, Attributes, ... }, Token, RefreshToken, RefreshTokenExpiry }
+ */
+export declare class LoginResponseAdapter {
+    /**
+     * Transforms the normalized CommonApiResponse's Result from new flat format to old nested format.
+     * If the Result is already in old format (has .user or .Token), returns as-is.
+     *
+     * @param response - The CommonApiResponse (already top-level normalized by ResponseAdapter)
+     * @returns The response with Result transformed to legacy nested format
+     */
+    static normalize(response: CommonApiResponse): CommonApiResponse;
+    /**
+     * Transforms roles from new camelCase format to old PascalCase format.
+     * Structure: { tenantId: { appId: { envId: [{ id, roleName, description }] } } }
+     * becomes:   { tenantId: { appId: { envId: [{ ID, RoleName, Description }] } } }
+     */
+    private static transformRoles;
+}

package/lib/tab-core-utility/app/helpers/response.adapter.d.ts

@@ -0,0 +1,22 @@
+import { CommonApiResponse, StandardApiResponse } from '../interfaces/common.interface';
+/**
+ * ResponseAdapter - Transforms new API response format to legacy format
+ *
+ * This adapter maintains backward compatibility by converting the new camelCase
+ * response format from the backend to the old PascalCase format expected by
+ * existing application code.
+ *
+ * @example
+ * // Auto-detect and normalize response
+ * return this.apiService.postToService(...).pipe(
+ *   map(response => ResponseAdapter.normalize(response))
+ * );
+ */
+export declare class ResponseAdapter {
+    /**
+     * Normalizes a StandardApiResponse to CommonApiResponse format.
+     * @param newResponse The response object in the new API format.
+     * @returns The normalized response in the legacy format.
+     */
+    static normalize(newResponse: StandardApiResponse): CommonApiResponse;
+}

package/lib/tab-core-utility/app/helpers/screen/grid.helpers.d.ts

@@ -2,6 +2,7 @@ import { AppObject } from '../../models/app-object.class';
 import { JqWidghtModel } from '../../interfaces/grid.interface';
 import * as i0 from "@angular/core";
 export declare class GridHelper {
+    private readonly metadataHelper;
     /**
      * Generates a grid schema for the master app object.
      * @param masterAppObj The master app object.
@@ -28,7 +29,7 @@ export declare class GridHelper {
         key: any;
         input: boolean;
         redrawOn: any;
-        'customOptions.dataSourceQueryId': any;
+        'customOptions.dataSourceQueryId': string;
         logic: {
             name: string;
             trigger: {

package/lib/tab-core-utility/app/helpers/screen/media-upload.helpers.d.ts

@@ -8,7 +8,7 @@ export declare class MediaUploadHelper {
      * @param payload An array of media objects to upload.
      * @returns An Observable that emits the response from the server.
      */
-    uploadMediaFiles(payload: UploadMediaFilesPayload, headers?: any): Observable<CommonApiResponse>;
+    uploadMediaFiles(payload: UploadMediaFilesPayload, headers?: any): Observable<any>;
     /**
      * Removes a file from the server by its media ID.
      * @param mediaId The ID of the media file to remove.

package/lib/tab-core-utility/app/helpers/screen/screen.helpers.d.ts

@@ -1,5 +1,6 @@
 import * as i0 from "@angular/core";
 export declare class ScreenHelper {
+    private readonly metadataHelper;
     /**
      * Retrieves screen data based on the provided screen ID.
      * @param screenId The ID of the screen to retrieve.

package/lib/tab-core-utility/app/helpers/transition-response.adapter.d.ts

@@ -0,0 +1,30 @@
+import { CommonApiResponse } from '../interfaces/common.interface';
+/**
+ * TransitionResponseAdapter - Transforms new transition API response (camelCase)
+ * to legacy PascalCase format expected by existing application code.
+ *
+ * Handles both GetNextStatus and UpdateStatus responses from the new
+ * crud.techextensor.com/api/v1/status/* endpoints.
+ */
+export declare class TransitionResponseAdapter {
+    /**
+     * Normalizes the inner Result of a GetNextStatus response from camelCase to PascalCase.
+     * @param response - The CommonApiResponse (already wrapper-normalized by ResponseAdapter)
+     * @returns The response with inner Result transformed to legacy PascalCase format
+     */
+    static normalize(response: CommonApiResponse): CommonApiResponse;
+    /**
+     * Transforms the toStatusList array from camelCase to PascalCase.
+     */
+    private static transformToStatusList;
+    /**
+     * Transforms a single transition hook from new format to old format.
+     * New format: { filters: null, actions: [] }
+     * Old format: null (when empty) or { Actions: [...] }
+     */
+    private static transformHook;
+    /**
+     * Transforms actions array from camelCase to PascalCase.
+     */
+    private static transformActions;
+}

package/lib/tab-core-utility/app/interfaces/auth.interface.d.ts

@@ -4,7 +4,7 @@ export interface NewUserRequest {
     password: string;
 }
 export interface LoginUserRequest {
-    email: string;
+    username: string;
     password: string;
 }
 export interface ResetPasswordUserRequest {

package/lib/tab-core-utility/app/interfaces/common.interface.d.ts

@@ -14,15 +14,14 @@ export interface RecordInfo {
     primaryKey: string;
 }
 export interface CommonApiResponse {
-    RequestId: string;
     IsSuccess: boolean;
     Result: any;
-    StatusCode: string;
     RecordAffectted: number;
     TotalRecords: number;
     TotalExecutionTime: number;
     Log: any[];
     Errors: any[];
+    CorrelationId?: string;
 }
 export interface GetScreenConfig {
     layoutId?: string;
@@ -40,6 +39,7 @@ export interface TemplateParsePayload {
 export interface NextStatusPayload {
     recordId: string;
     appObjectId?: string;
+    appObjectName?: string;
 }
 export interface UpdateStatusPayload extends NextStatusPayload {
     nextPossibleStatusId: string;
@@ -69,11 +69,12 @@ export interface RefreshRecordInfoDataPayload {
     QueryObjectID: string;
 }
 export interface UploadMediaFilePayload {
-    Base64String: string;
-    FileName: string;
+    fileName: string;
+    base64Content: string;
 }
 export interface UploadMediaFilesPayload {
-    UploadFiles: UploadMediaFilePayload[];
+    path?: string;
+    files: UploadMediaFilePayload[];
 }
 export interface ReportPayload {
     DataReportId: string;
@@ -135,10 +136,10 @@ export interface GetPayload {
     dataSourceQueryIdOrName: string;
     criteria: any;
 }
-export interface ImprotDataPayload {
-    ImportObjectMappingId: string;
-    File: string;
-    ImportType: number;
+export interface ImportDataPayload {
+    ImportMappingId: string;
+    FileId: string;
+    ExecutionType: number;
 }
 export interface SearchDataPayload {
     searchQuery: string;
@@ -165,3 +166,54 @@ export interface executeTABWorkflowPayload {
     AppObjectId: string;
     Reqtokens?: any;
 }
+/**
+ * Standard API response format (camelCase - NEW BACKEND)
+ * All new APIs return this consistent structure
+ */
+export interface StandardApiResponse {
+    /** Indicates if the request was successful */
+    isSuccess: boolean;
+    /** Error information (null if successful) */
+    error: ApiError | null;
+    /** Response data (null if error) */
+    result: any | null;
+    /** Request execution time in milliseconds */
+    executionTimeMs: number;
+    /** Log entries from the request */
+    logs: string[];
+    /** Additional metadata about the request */
+    metadata: Record<string, any>;
+    /** Number of records affected (for mutations) */
+    affectedRecords?: number;
+    /** Total number of records (for queries) */
+    totalRecords?: number;
+    /** Correlation ID for async operations (null for sync operations) */
+    correlationId?: string;
+}
+/**
+ * Error information in new API format
+ */
+export interface ApiError {
+    /** Error code (e.g., "UNEXPECTED_ERROR", "VALIDATION_ERROR") */
+    code: string;
+    /** User-friendly error message */
+    message: string;
+    /** Technical error details for debugging */
+    details: string;
+}
+/**
+ * Microservice URLs configuration
+ */
+export interface APIServiceUrls {
+    crudService: string;
+    metadataService: string;
+    formioService: string;
+    identityService: string;
+    codeExecutorService: string;
+    notificationService: string;
+    workflowService: string;
+    kibanaService: string;
+    reportService: string;
+    fileManagerService: string;
+}
+export type APIServiceName = keyof APIServiceUrls;

package/lib/tab-core-utility/app/interfaces/signalr.interface.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Raw SignalR message wrapper
+ */
+export interface SignalRMessage {
+    type: number;
+    target: string;
+    arguments: CrudNotification[];
+}
+/**
+ * CRUD notification payload received from SignalR hub
+ */
+export interface CrudNotification {
+    correlationId: string;
+    result: any;
+    entityName: string;
+    appObjectId: string;
+    isSuccess: boolean;
+    errorMessage: string | null;
+    errorCode: string | null;
+    executionTimeMs: number;
+    affectedRecords: number | null;
+    operation?: CrudOperation;
+    receivedAt?: Date;
+}
+/**
+ * Pending async operation tracked by OperationTrackerService
+ */
+export interface PendingOperation {
+    correlationId: string;
+    timestamp: Date;
+    timeout: number;
+}
+/**
+ * Callback function type for component notifications
+ */
+export type NotificationCallback = (notification: CrudNotification) => void;
+/**
+ * CRUD operation types
+ */
+export type CrudOperation = typeof CRUD_OPERATION[keyof typeof CRUD_OPERATION];
+/**
+ * SignalR connection state types
+ */
+export type ConnectionState = typeof CONNECTION_STATE[keyof typeof CONNECTION_STATE];
+/**
+ * SignalR hub method names
+ */
+export declare const SIGNALR_HUB_METHODS: {
+    readonly JOIN_GROUP: "JoinGroupAsync";
+    readonly LEAVE_GROUP: "LeaveGroupAsync";
+};
+/**
+ * SignalR event names from backend
+ */
+export declare const SIGNALR_EVENTS: {
+    readonly INSERT_COMPLETED: "InsertOperationCompleted";
+    readonly UPDATE_COMPLETED: "UpdateOperationCompleted";
+    readonly DELETE_COMPLETED: "DeleteOperationCompleted";
+};
+/**
+ * CRUD operation types
+ */
+export declare const CRUD_OPERATION: {
+    readonly INSERT: "INSERT";
+    readonly UPDATE: "UPDATE";
+    readonly DELETE: "DELETE";
+};
+/**
+ * SignalR connection states
+ */
+export declare const CONNECTION_STATE: {
+    readonly DISCONNECTED: "Disconnected";
+    readonly CONNECTING: "Connecting";
+    readonly CONNECTED: "Connected";
+    readonly RECONNECTING: "Reconnecting";
+    readonly FAILED: "Failed";
+};
+/**
+ * SignalR configuration constants
+ */
+export declare const SIGNALR_CONFIG: {
+    readonly DEFAULT_TIMEOUT: 120000;
+    readonly RECONNECT_DELAYS: readonly [0, 2000, 10000, 30000, 60000];
+};

package/lib/tab-core-utility/app/models/api-query.class.d.ts

@@ -37,20 +37,19 @@ export declare class ChildRelationShip {
     childDetails: LookUpDetails;
 }
 export declare class APIFilterCriteria {
-    Filters: APIFilter[] | any;
-    FilterLogic: string | any;
+    filters: APIFilter[] | any;
+    filterLogic: string | any;
     SQLQuery: string | any;
 }
 export declare class APIFilter {
-    ConjuctionClause: ConjuctionClause | any;
-    FieldID: string | any;
-    RelationalOperator: RelationalOperator | any;
-    ValueType: FilterValueType | any;
+    conjunction: ConjuctionClause | any;
+    fieldName: string | any;
+    operator: RelationalOperator | any;
+    valueType: FilterValueType | any;
     value: string | any;
-    Sequence: number | any;
-    GroupID: number | any;
+    sequence: number | any;
+    groupId: number | any;
     parameterName: string | any;
-    Value: string | any;
 }
 export declare class APIValueSets {
     AppFieldID: string | any;
@@ -72,3 +71,49 @@ export declare class APIParameters {
     DataSourceQueryID: string | any;
     MappingFieldName: string | any;
 }
+/**
+ * New CRUD API Select Query Payload
+ * Used for the new microservice-based select query endpoint
+ */
+export declare class CRUDSelectPayload {
+    EntityName: string | any;
+    SelectedFields: string[];
+    includes?: any[];
+    Pager?: CRUDPager;
+    whereClause?: CRUDWhereClause;
+    Distinct?: boolean;
+    Sort?: CRUDSort[];
+}
+/**
+ * Pager configuration for CRUD API
+ */
+export declare class CRUDPager {
+    pageNumber: number;
+    pageSize: number;
+    returnTotalCount: boolean;
+}
+/**
+ * Where clause structure for CRUD API
+ */
+export declare class CRUDWhereClause {
+    filters: CRUDFilter[];
+}
+/**
+ * Filter structure for CRUD API
+ */
+export declare class CRUDFilter {
+    fieldName: string | any;
+    operator: number | any;
+    value: any;
+    valueType: number | any;
+    conjunction: number | any;
+    groupId: number | any;
+    sequence: number | any;
+}
+/**
+ * Sort structure for CRUD API
+ */
+export declare class CRUDSort {
+    FieldName: string | any;
+    Direction: number | any;
+}

package/lib/tab-core-utility/app/models/app-field.model.d.ts

@@ -49,8 +49,10 @@ export declare class AppFieldModel {
      */
     search(term: string): boolean;
     /**
-     * Converts the AppFieldModel instance to a JSON representation.
-     * @returns {any} The raw data of the instance.
+     * Converts the AppFieldModel instance to JSON in the old API format (PascalCase).
+     * This ensures backward compatibility with code expecting the old format.
+     *
+     * @returns {any} The data in old API format.
      */
     toJSON(): any;
 }

package/lib/tab-core-utility/app/models/app-object.model.d.ts

@@ -40,13 +40,14 @@ export declare class AppObjectModel {
     readonly AccessList: Array<ObjectAccess>;
     readonly Resources: Array<Resources>;
     readonly ChildRelationShips: Array<ChildRelationShip>;
-    readonly parsedAppObjectConfiguration: any;
     readonly AppId: string | null;
     private readonly fieldMap;
     private readonly dsqMap;
     private allFields;
     private allDSQs;
+    private parsedAppObjectJson;
     constructor(raw: any, metadataHelper: MetadataHelper);
+    private parseAppObjectJson;
     /**
      * Returns all fields associated with this AppObject. The fields are cached so that subsequent calls
      * are faster. The cache is stored in a map by ID.
@@ -121,9 +122,10 @@ export declare class AppObjectModel {
         dsqs: DataSourceQueryModel[];
     };
     /**
-     * Converts the current object to a JSON object.
+     * Converts the current object to JSON in the old API format (PascalCase).
+     * This ensures backward compatibility with code expecting the old format.
      *
-     * @returns {any} The raw data as a JSON object.
+     * @returns {any} The data in old API format.
      */
     toJSON(): any;
 }

package/lib/tab-core-utility/app/models/app-screen.model.d.ts

@@ -25,9 +25,9 @@ export declare class AppScreenModel {
      */
     search(term: string): boolean;
     /**
-     * Converts the current object to a JSON object.
+     * Converts the model to JSON in the old API format (PascalCase).
      *
-     * @returns A JSON representation of the current object.
+     * @returns A JSON representation in old format.
      */
     toJSON(): any;
 }

package/lib/tab-core-utility/app/models/data-source-query.model.d.ts

@@ -18,9 +18,12 @@ export declare class DataSourceQueryModel {
     private cachedParameters;
     private cachedFilters;
     private cachedSorts;
+    private parsedConfiguration;
     constructor(raw: any, parentAppObject: AppObjectModel, metadataHelper: MetadataHelper);
+    private parseConfiguration;
     /**
      * Gets the fields for the data source query. The fields are enriched with the corresponding `AppFieldModel` objects.
+     * Handles both old format (array of objects) and new format (array of field ID strings).
      * @returns {DataSourceQueries_Fields[]} The array of enriched fields.
      */
     fields(): DataSourceQueries_Fields[];
@@ -64,8 +67,10 @@ export declare class DataSourceQueryModel {
      */
     search(term: string): boolean;
     /**
-     * Converts the DataSourceQueryModel instance to a JSON representation.
-     * @returns {any} The raw data in JSON format.
+     * Converts the DataSourceQueryModel instance to JSON in the old API format (PascalCase).
+     * This ensures backward compatibility with code expecting the old format.
+     *
+     * @returns {any} The data in old API format.
      */
     toJSON(): any;
 }

package/lib/tab-core-utility/app/models/filter.model.d.ts

@@ -13,9 +13,9 @@ export declare class FilterModel {
     readonly FieldID: string;
     constructor(raw: any);
     /**
-     * Converts the current object to a JSON object.
+     * Converts the model to JSON in the old API format (PascalCase).
      *
-     * @returns A JSON representation of the current object.
+     * @returns A JSON representation in old format.
      */
     toJSON(): any;
 }

package/lib/tab-core-utility/app/models/parameter.model.d.ts

@@ -7,8 +7,8 @@ export declare class ParameterModel {
     readonly IsMandatory: boolean;
     constructor(raw: any);
     /**
-     * Converts the model to JSON.
-     * @returns {any} The model as a JSON object.
+     * Converts the model to JSON in the old API format (PascalCase).
+     * @returns {any} The model as a JSON object in old format.
      */
     toJSON(): any;
 }

package/lib/tab-core-utility/app/models/sort.model.d.ts

@@ -9,7 +9,7 @@ export declare class SortModel {
     readonly AppFieldID: string;
     constructor(raw: any);
     /**
-     * Get raw data for this app object
+     * Converts the model to JSON in the old API format (PascalCase).
      */
     toJSON(): any;
 }

package/lib/tab-core-utility/app/utils/json.util.d.ts

@@ -5,9 +5,10 @@
  */
 export declare function validateJSON(str: string): boolean;
 /**
- * Creates dynamic data based on the input object
+ * Creates dynamic data based on the input object for new API format
+ * Transforms object into array of {fieldName, value} pairs
  * @param obj The input object to create dynamic data from
- * @returns The formatted array
+ * @returns The formatted array with {fieldName, value} pairs
  */
 export declare function createDynamicData(obj: any): any;
 /**