ia-common 1.1.1-beta.3 → 1.1.1-beta.31

package/build/src/utils/helper.fn.utils.d.ts

@@ -1,4 +1,4 @@
-import { Modify } from "../@type";
+import { EntityEnum, IEntitySearch, Modify } from "../@type";
 /**
  * Returns epoch time (ms) for today's date at the given local time (IST).
  */
@@ -83,3 +83,49 @@ export declare function toDateFromEpoch(epoch: number): Date;
  */
 export declare function deepMerge(existing: any, incoming: any): any;
 export declare function groupByOneToOneFunction<T, K>(list: T[], keyGetter: (input: T) => K): Map<K, T>;
+export declare function getPropertyFilterByPermissionFn<T extends EntityEnum>(permissionFilterConfig: {
+    [key: string]: () => Promise<IEntitySearch<T>>;
+}, propertyNames: string[], userPermission: string, filterDto: IEntitySearch<T>, emptyValue?: any): Promise<IEntitySearch<T>>;
+/**
+ * Returns the list of duplicate values from an array.
+ *
+ * @template T - The type of elements in the array.
+ *
+ * @param {T[]} arr - The array to check for duplicates.
+ *
+ * @returns {T[]} An array containing the values that appear more than once.
+ *                 Each duplicate value is included only once.
+ *
+ * @description
+ * This function scans the array and counts occurrences of each value using a Map.
+ * Any value with a count greater than 1 is considered a duplicate.
+ *
+ * @example
+ * getDuplicates([1, 2, 2, 3, 3, 3]);
+ * // Returns: [2, 3]
+ *
+ * @example
+ * getDuplicates(['a', 'b', 'b', 'c']);
+ * // Returns: ['b']
+ *
+ * @remarks
+ * - Works with all primitive types: number, string, boolean, undefined, null.
+ * - For objects, duplicates are based on **reference equality**, not deep equality.
+ */
+export declare function getDuplicates<T>(arr: T[]): T[];
+/**
+ * Derives permission group from permission name.
+ *
+ * Rules:
+ * - Entity is resolved using EntityEnum (longest prefix match)
+ * - Action is the part immediately after the entity name
+ * - Scope (ORG / SELF / BULK / etc.) is ignored
+ * - Group format: <entity>_<action> (lowercase)
+ *
+ * Examples:
+ *  CORPORATE_ACTIONS_CREATE_ORG          → corporate_actions_create
+ *  CORPORATE_ACTIONS_ADVICE_CREATE_ORG   → corporate_actions_advice_create
+ *  USER_EXPORT_EXCEL                      → user_export
+ *  USER_NAV                               → user_nav
+ */
+export declare function derivePermissionGroup(permissionName: string): string;

package/build/src/utils/helper.fn.utils.js

@@ -1,6 +1,18 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.groupByOneToOneFunction = exports.deepMerge = exports.toDateFromEpoch = exports.groupByFunction = exports.transformDate = exports.getStringValues = exports.getTodayISTEpoch = void 0;
+exports.derivePermissionGroup = exports.getDuplicates = exports.getPropertyFilterByPermissionFn = exports.groupByOneToOneFunction = exports.deepMerge = exports.toDateFromEpoch = exports.groupByFunction = exports.transformDate = exports.getStringValues = exports.getTodayISTEpoch = void 0;
+const _enum_1 = require("../@enum");
+const _type_1 = require("../@type");
+const model_1 = require("../model");
 /**
  * Returns epoch time (ms) for today's date at the given local time (IST).
  */
@@ -133,3 +145,140 @@ function groupByOneToOneFunction(list, keyGetter) {
     return map;
 }
 exports.groupByOneToOneFunction = groupByOneToOneFunction;
+function getPropertyFilterByPermissionFn(permissionFilterConfig, propertyNames, userPermission, filterDto, emptyValue = []) {
+    var _a, _b;
+    return __awaiter(this, void 0, void 0, function* () {
+        const permissionFilterData = yield permissionFilterConfig[userPermission]();
+        const result = {
+            name: filterDto.name,
+            include: {},
+        };
+        for (const propertyName of propertyNames) {
+            const dtoInclude = (_a = filterDto.include) !== null && _a !== void 0 ? _a : {};
+            const dtoFilter = dtoInclude[propertyName];
+            const permissionInclude = (_b = permissionFilterData.include) !== null && _b !== void 0 ? _b : {};
+            const permissionFilter = permissionInclude[propertyName];
+            const isDtoPresent = Array.isArray(dtoFilter) && dtoFilter.length > 0;
+            const isPermissionPresent = Array.isArray(permissionFilter) && permissionFilter.length > 0;
+            // --------- CASE 1: Permission says allow all ([]) ----------
+            if (Array.isArray(permissionFilter) && permissionFilter.length === 0) {
+                result.include[propertyName] = dtoFilter !== null && dtoFilter !== void 0 ? dtoFilter : []; // allow everything
+                continue;
+            }
+            // --------- CASE 2: Permission has restriction ----------
+            if (isPermissionPresent) {
+                if (isDtoPresent) {
+                    const intersection = (0, _type_1.arrayIntersection)(permissionFilter, dtoFilter);
+                    result.include[propertyName] =
+                        intersection.length > 0 ? intersection : emptyValue;
+                }
+                else {
+                    // no dto filter → use full permission filter
+                    result.include[propertyName] = permissionFilter;
+                }
+                continue;
+            }
+            // --------- CASE 3: No permission restriction → use dto filter ----------
+            if (Array.isArray(dtoFilter)) {
+                result.include[propertyName] = dtoFilter;
+            }
+        }
+        return result;
+    });
+}
+exports.getPropertyFilterByPermissionFn = getPropertyFilterByPermissionFn;
+/**
+ * Returns the list of duplicate values from an array.
+ *
+ * @template T - The type of elements in the array.
+ *
+ * @param {T[]} arr - The array to check for duplicates.
+ *
+ * @returns {T[]} An array containing the values that appear more than once.
+ *                 Each duplicate value is included only once.
+ *
+ * @description
+ * This function scans the array and counts occurrences of each value using a Map.
+ * Any value with a count greater than 1 is considered a duplicate.
+ *
+ * @example
+ * getDuplicates([1, 2, 2, 3, 3, 3]);
+ * // Returns: [2, 3]
+ *
+ * @example
+ * getDuplicates(['a', 'b', 'b', 'c']);
+ * // Returns: ['b']
+ *
+ * @remarks
+ * - Works with all primitive types: number, string, boolean, undefined, null.
+ * - For objects, duplicates are based on **reference equality**, not deep equality.
+ */
+function getDuplicates(arr) {
+    const countMap = new Map();
+    for (const item of arr) {
+        countMap.set(item, (countMap.get(item) || 0) + 1);
+    }
+    const duplicates = [];
+    for (const [value, count] of countMap.entries()) {
+        if (count > 1)
+            duplicates.push(value);
+    }
+    return duplicates;
+}
+exports.getDuplicates = getDuplicates;
+/**
+ * Derives permission group from permission name.
+ *
+ * Rules:
+ * - Entity is resolved using EntityEnum (longest prefix match)
+ * - Action is the part immediately after the entity name
+ * - Scope (ORG / SELF / BULK / etc.) is ignored
+ * - Group format: <entity>_<action> (lowercase)
+ *
+ * Examples:
+ *  CORPORATE_ACTIONS_CREATE_ORG          → corporate_actions_create
+ *  CORPORATE_ACTIONS_ADVICE_CREATE_ORG   → corporate_actions_advice_create
+ *  USER_EXPORT_EXCEL                      → user_export
+ *  USER_NAV                               → user_nav
+ */
+function derivePermissionGroup(permissionName) {
+    const parts = permissionName.split("_");
+    // handle NAV permissions first
+    if (parts[parts.length - 1] === "NAV") {
+        return `${parts.slice(0, -1).join("_").toLowerCase()}_nav`;
+    }
+    // resolve entity (longest match from EntityEnum)
+    let matchedEntityKey = null;
+    let matchedLength = 0;
+    for (const key of Object.keys(_type_1.EntityEnum)) {
+        const entityParts = key.split("_");
+        const matches = entityParts.every((part, idx) => parts[idx] === part);
+        if (matches && entityParts.length > matchedLength) {
+            matchedEntityKey = key;
+            matchedLength = entityParts.length;
+        }
+    }
+    if (!matchedEntityKey) {
+        throw new model_1.AppBadRequestException({
+            key: _enum_1.ErrorKeyEnum.PERMISSION_NAME,
+            message: [
+                `Invalid permission name (entity not found): ${permissionName}`,
+            ],
+        });
+    }
+    // the action is the first part after the entity
+    const remainingParts = parts.slice(matchedLength);
+    if (remainingParts.length === 0) {
+        throw new model_1.AppBadRequestException({
+            key: _enum_1.ErrorKeyEnum.PERMISSION_NAME,
+            message: [
+                `Invalid permission name (action not found): ${permissionName}`,
+            ],
+        });
+    }
+    const action = remainingParts[0];
+    // build group
+    const entity = _type_1.EntityEnum[matchedEntityKey];
+    return `${entity}_${action.toLowerCase()}`;
+}
+exports.derivePermissionGroup = derivePermissionGroup;

package/build/src/utils/validate-utils.d.ts

@@ -1,4 +1,4 @@
-import { CorporateActionsType } from "../@enum";
+import { CorporateActionsType } from "../enum/corporate-actions/corporate-actions-type.enum";
 export declare class ValidateUtils {
     static validateCorporateActionType(corporateActionType: CorporateActionsType, expectedType: CorporateActionsType): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ia-common",
-  "version": "1.1.1-beta.3",
+  "version": "1.1.1-beta.31",
   "description": "",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
@@ -10,13 +10,14 @@
   "scripts": {
     "clean": "rm -rf build",
     "build": "npm run clean && tsc",
-    "version:deploy:beta": "npm version prerelease --preid beta && git push && npm run build && npm publish --tag beta",
-    "version:deploy:patch": "npm version patch && git push && npm run build && npm publish",
-    "version:deploy:minor": "npm version minor && git push && npm run build && npm publish",
+    "publish:beta": "npm version prerelease --preid beta && git push && npm run build && npm publish --tag beta",
+    "publish:patch": "npm version patch && git push && npm run build && npm publish",
+    "publish:minor": "npm version minor && git push && npm run build && npm publish",
     "test": "echo \"Error: no test specified\" && exit 1",
     "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" 2>&1| tee eslint.log",
     "lint:fix": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
-    "link": "npm run build && npm link"
+    "link": "npm run build && npm link",
+    "pull:link": "git pull && npm run link"
   },
   "repository": {
     "type": "git",