@geniehr/utilities 1.0.5

package/dist/secrets/aws.js

@@ -0,0 +1,193 @@
+import { SSMClient, GetParameterCommand, GetParametersByPathCommand, } from '@aws-sdk/client-ssm';
+import { fromIni } from '@aws-sdk/credential-providers';
+import { AppException } from '../shared/exceptions/index.js';
+import { S3Client, PutObjectCommand, GetObjectCommand } from '@aws-sdk/client-s3';
+import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
+import { CognitoIdentityProviderClient, AdminUpdateUserAttributesCommand, AdminGetUserCommand } from '@aws-sdk/client-cognito-identity-provider';
+let ssm;
+let rand = Math.random().toString();
+const env = process.env.NODE_ENV || rand;
+if (env == rand)
+    throw new AppException('Invalid Environment', 'E-Invalid-Environment');
+import { RekognitionClient, IndexFacesCommand, SearchFacesByImageCommand } from '@aws-sdk/client-rekognition';
+const rekognition = new RekognitionClient({ region: 'ap-south-1', credentials: env === 'local' ? fromIni({ profile: 'ghr-aws-dev-profile' }) : undefined });
+const s3 = new S3Client({
+    region: 'ap-south-1',
+    credentials: env === 'local' ? fromIni({ profile: 'ghr-aws-dev-profile' }) : undefined
+});
+const client = new CognitoIdentityProviderClient({
+    region: 'ap-south-1',
+    credentials: env === 'local' ? fromIni({ profile: 'ghr-aws-dev-profile' }) : undefined
+});
+/**
+ * Fetch a single parameter or all parameters under a prefix.
+ * @param nameOrPrefix Full name (e.g. /dev/mysql/person) or prefix (e.g. /dev/mysql/)
+ */
+export async function getAWSParameters(nameOrPrefix) {
+    ssm = new SSMClient({
+        region: 'ap-south-1',
+        credentials: process.env.NODE_ENV == 'local' ? fromIni({ profile: 'ghr-aws-dev-profile' }) : undefined,
+    });
+    const result = {};
+    const isPrefix = nameOrPrefix.endsWith('/');
+    if (!isPrefix) {
+        const command = new GetParameterCommand({
+            Name: nameOrPrefix,
+            WithDecryption: true,
+        });
+        const res = await ssm.send(command);
+        if (res.Parameter?.Name && res.Parameter?.Value !== undefined) {
+            const name = res.Parameter.Name.split('/').pop();
+            result[name] = res.Parameter.Value;
+        }
+        return result;
+    }
+    // handle prefix mode
+    let nextToken = undefined;
+    do {
+        const input = {
+            Path: nameOrPrefix,
+            Recursive: true,
+            WithDecryption: true,
+            NextToken: nextToken,
+        };
+        const command = new GetParametersByPathCommand(input);
+        const response = await ssm.send(command);
+        for (const param of response.Parameters || []) {
+            if (param.Name && param.Value !== undefined) {
+                const key = param.Name.replace(nameOrPrefix, '').replace(/^\//, '');
+                result[key] = param.Value;
+            }
+        }
+        nextToken = response.NextToken;
+    } while (nextToken);
+    return result;
+}
+export async function matchFace(imageInBase64) {
+    const command = new SearchFacesByImageCommand({
+        CollectionId: 'employee_faces',
+        Image: { Bytes: Buffer.from(imageInBase64, 'base64') },
+        MaxFaces: 1,
+        FaceMatchThreshold: 95,
+    });
+    const result = await rekognition.send(command);
+    return result;
+}
+export async function registerFace(employeeId, imageInBase64) {
+    const command = new IndexFacesCommand({
+        CollectionId: 'employee_faces',
+        ExternalImageId: employeeId,
+        Image: { Bytes: Buffer.from(imageInBase64, 'base64') },
+        DetectionAttributes: ['DEFAULT'],
+    });
+    const result = await rekognition.send(command);
+    return result;
+}
+export async function generatePresignedUrl(entity, fileName, bucketName, idToken, action, expiresIn = 3600) {
+    let token = idToken?.startsWith("Bearer ") ? idToken.split(" ")[1] : idToken;
+    const payload = JSON.parse(Buffer.from(token.split(".")[1], "base64").toString());
+    const userId = Number(payload["custom:id"]);
+    if (!userId)
+        throw new AppException("User ID not found in token", "E-User-ID-Not-Found");
+    const REGION = "ap-south-1";
+    const s3 = new S3Client({ region: REGION });
+    const key = `${userId}/${entity}/${fileName}`;
+    let command;
+    switch (action) {
+        case 'put':
+            command = new PutObjectCommand({
+                Bucket: bucketName,
+                Key: key,
+            });
+            break;
+        case 'get': command = new GetObjectCommand({
+            Bucket: bucketName,
+            Key: key,
+        });
+    }
+    try {
+        return await getSignedUrl(s3, command, { expiresIn });
+    }
+    catch (error) {
+        throw new AppException(`Failed to generate presigned URL: ${error instanceof Error ? error.message : "Unknown error"}`, "E-Presigned-URL-Generation-Failed");
+    }
+}
+export async function executeS3Action(action, bucketName, key, body, contentType) {
+    try {
+        let command;
+        switch (action) {
+            case "put":
+                if (!body)
+                    throw new AppException("Missing file body for PUT operation", "E-Missing-Body");
+                const putParams = {
+                    Bucket: bucketName,
+                    Key: key,
+                    Body: body,
+                    ContentType: contentType || "application/octet-stream",
+                };
+                command = new PutObjectCommand(putParams);
+                break;
+            case "get":
+                const getParams = {
+                    Bucket: bucketName,
+                    Key: key,
+                };
+                command = new GetObjectCommand(getParams);
+                break;
+            default:
+                throw new AppException("Invalid S3 action type", "E-Invalid-Action");
+        }
+        const result = await s3.send(command);
+        return result;
+    }
+    catch (error) {
+        throw new AppException(`S3 operation failed: ${error instanceof Error ? error.message : "Unknown error"}`, "E-S3-Operation-Failed");
+    }
+}
+export async function updateCustomAttribute(username, userPoolId, attributeName, attributeValue) {
+    try {
+        const command = new AdminUpdateUserAttributesCommand({
+            UserPoolId: userPoolId,
+            Username: username,
+            UserAttributes: [
+                {
+                    Name: attributeName,
+                    Value: attributeValue
+                }
+            ]
+        });
+        await client.send(command);
+        return {
+            success: true,
+            message: `Custom attribute '${attributeName}' updated successfully for user '${username}'.`
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Error updating custom attribute: ${error.message}`
+        };
+    }
+}
+export async function getCustomAttribute(username, userPoolId, attributeName) {
+    try {
+        const command = new AdminGetUserCommand({
+            UserPoolId: userPoolId,
+            Username: username
+        });
+        const response = await client.send(command);
+        const customAttribute = response.UserAttributes?.find((attr) => attr.Name === attributeName);
+        const value = customAttribute?.Value;
+        return {
+            success: true,
+            value,
+            message: value ? `Value for custom attribute '${attributeName}' is '${value}'.` : `Custom attribute '${attributeName}' not found.`
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Error getting custom attribute: ${error.message}`
+        };
+    }
+}

package/dist/shared/context/index.d.ts

@@ -0,0 +1,6 @@
+import { AsyncLocalStorage } from 'async_hooks';
+import { GHRContext } from '../../types/GHRContext.js';
+export declare const context: AsyncLocalStorage<GHRContext>;
+export declare function getContext(): GHRContext;
+export declare function setExtras(key: string, value: any): void;
+export declare function setContext(initial: GHRContext, fn: () => Promise<void> | void): void | Promise<void>;

package/dist/shared/context/index.js

@@ -0,0 +1,15 @@
+import { AsyncLocalStorage } from 'async_hooks';
+export const context = new AsyncLocalStorage();
+export function getContext() {
+    return context.getStore() ?? {};
+}
+export function setExtras(key, value) {
+    const ctx = context.getStore();
+    if (ctx) {
+        ctx.extras = ctx.extras || {};
+        ctx.extras[key] = value;
+    }
+}
+export function setContext(initial, fn) {
+    return context.run(initial, fn);
+}

package/dist/shared/enums/Environments.d.ts

@@ -0,0 +1,6 @@
+export declare enum Environment {
+    LOCAL = 0,
+    DEV = 1,
+    UAT = 2,
+    PROD = 3
+}

package/dist/shared/enums/Environments.js

@@ -0,0 +1,7 @@
+export var Environment;
+(function (Environment) {
+    Environment[Environment["LOCAL"] = 0] = "LOCAL";
+    Environment[Environment["DEV"] = 1] = "DEV";
+    Environment[Environment["UAT"] = 2] = "UAT";
+    Environment[Environment["PROD"] = 3] = "PROD";
+})(Environment || (Environment = {}));

package/dist/shared/enums/HttpStatusCodes.d.ts

@@ -0,0 +1,23 @@
+export declare enum HttpStatusCode {
+    CONTINUE = 100,
+    SWITCHING_PROTOCOLS = 101,
+    PROCESSING = 102,
+    OK = 200,
+    CREATED = 201,
+    ACCEPTED = 202,
+    NO_CONTENT = 204,
+    MOVED_PERMANENTLY = 301,
+    FOUND = 302,
+    NOT_MODIFIED = 304,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    CONFLICT = 409,
+    UNPROCESSABLE_ENTITY = 422,
+    INTERNAL_SERVER_ERROR = 500,
+    NOT_IMPLEMENTED = 501,
+    BAD_GATEWAY = 502,
+    SERVICE_UNAVAILABLE = 503,
+    GATEWAY_TIMEOUT = 504
+}

package/dist/shared/enums/HttpStatusCodes.js

@@ -0,0 +1,29 @@
+export var HttpStatusCode;
+(function (HttpStatusCode) {
+    // 1xx Informational
+    HttpStatusCode[HttpStatusCode["CONTINUE"] = 100] = "CONTINUE";
+    HttpStatusCode[HttpStatusCode["SWITCHING_PROTOCOLS"] = 101] = "SWITCHING_PROTOCOLS";
+    HttpStatusCode[HttpStatusCode["PROCESSING"] = 102] = "PROCESSING";
+    // 2xx Success
+    HttpStatusCode[HttpStatusCode["OK"] = 200] = "OK";
+    HttpStatusCode[HttpStatusCode["CREATED"] = 201] = "CREATED";
+    HttpStatusCode[HttpStatusCode["ACCEPTED"] = 202] = "ACCEPTED";
+    HttpStatusCode[HttpStatusCode["NO_CONTENT"] = 204] = "NO_CONTENT";
+    // 3xx Redirection
+    HttpStatusCode[HttpStatusCode["MOVED_PERMANENTLY"] = 301] = "MOVED_PERMANENTLY";
+    HttpStatusCode[HttpStatusCode["FOUND"] = 302] = "FOUND";
+    HttpStatusCode[HttpStatusCode["NOT_MODIFIED"] = 304] = "NOT_MODIFIED";
+    // 4xx Client Errors
+    HttpStatusCode[HttpStatusCode["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    HttpStatusCode[HttpStatusCode["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    HttpStatusCode[HttpStatusCode["FORBIDDEN"] = 403] = "FORBIDDEN";
+    HttpStatusCode[HttpStatusCode["NOT_FOUND"] = 404] = "NOT_FOUND";
+    HttpStatusCode[HttpStatusCode["CONFLICT"] = 409] = "CONFLICT";
+    HttpStatusCode[HttpStatusCode["UNPROCESSABLE_ENTITY"] = 422] = "UNPROCESSABLE_ENTITY";
+    // 5xx Server Errors
+    HttpStatusCode[HttpStatusCode["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+    HttpStatusCode[HttpStatusCode["NOT_IMPLEMENTED"] = 501] = "NOT_IMPLEMENTED";
+    HttpStatusCode[HttpStatusCode["BAD_GATEWAY"] = 502] = "BAD_GATEWAY";
+    HttpStatusCode[HttpStatusCode["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
+    HttpStatusCode[HttpStatusCode["GATEWAY_TIMEOUT"] = 504] = "GATEWAY_TIMEOUT";
+})(HttpStatusCode || (HttpStatusCode = {}));

package/dist/shared/exceptions/index.d.ts

@@ -0,0 +1,13 @@
+export declare class AppException extends Error {
+    errorCode?: string | undefined;
+    details?: any;
+    constructor(message: string, errorCode?: string | undefined, details?: any);
+}
+export declare class InvalidEnvironmentException extends Error {
+    constructor();
+}
+export declare class InvalidRequestException extends Error {
+    errorCode?: string | undefined;
+    details?: any;
+    constructor(message: string[] | string, errorCode?: string | undefined, details?: any);
+}

package/dist/shared/exceptions/index.js

@@ -0,0 +1,27 @@
+export class AppException extends Error {
+    errorCode;
+    details;
+    constructor(message, errorCode, details) {
+        super(message);
+        this.errorCode = errorCode;
+        this.details = details;
+        this.name = 'RequestInvalid';
+    }
+}
+// test
+export class InvalidEnvironmentException extends Error {
+    constructor() {
+        super();
+        this.name = `Invalid Environment ${process.env.NODE_ENV}`;
+    }
+}
+export class InvalidRequestException extends Error {
+    errorCode;
+    details;
+    constructor(message, errorCode, details) {
+        super(Array.isArray(message) ? message.join(", ") : message);
+        this.errorCode = errorCode;
+        this.details = details;
+        this.name = 'Bad Request';
+    }
+}

package/dist/shared/helper/ImageCompressor.d.ts

@@ -0,0 +1,3 @@
+export declare class ImageCompressor {
+    static compressImage(buffer: Buffer, width?: number, height?: number, quality?: number): Promise<Buffer>;
+}

package/dist/shared/helper/ImageCompressor.js

@@ -0,0 +1,16 @@
+import sharp from "sharp";
+import { AppException } from '../exceptions/index.js';
+export class ImageCompressor {
+    static async compressImage(buffer, width = 64, height = 96, quality = 70) {
+        try {
+            return await sharp(buffer)
+                .resize(width, height)
+                .jpeg({ quality })
+                .toBuffer();
+        }
+        catch (error) {
+            console.error("Sharp compression failed:", error);
+            throw new AppException("Image compression failed", "E-COMPRESSION-FAILED");
+        }
+    }
+}

package/dist/shared/services.d.ts

@@ -0,0 +1 @@
+export declare const services: Record<string, Record<string, string>>;

package/dist/shared/services.js

@@ -0,0 +1,31 @@
+export const services = {
+    'local': {
+        'bff-ms': 'http://localhost:3000',
+        'people-ms': 'http://localhost:3001',
+        'iam-ms': 'http://localhost:3002',
+        'mdm-ms': 'http://localhost:3003',
+        'orgs-ms': 'http://localhost:3004',
+        'shifts-ms': 'http://localhost:3005',
+        'document-ms': 'http://localhost:3006',
+        'claim-ms': 'http://localhost:3007',
+        'external-ms': 'http://localhost:3008',
+        'cache-ms': 'http://localhost:3009',
+        'migration-ms': 'http://localhost:3010',
+        'search-ms': 'http://localhost:3011'
+    },
+    'dev': {
+        'bff-ms': 'http://bff-ms-dev:3000',
+        'people-ms': 'http://people-ms-dev:3001',
+        'iam-ms': 'http://iam-ms-dev:3002',
+        'mdm-ms': 'http://mdm-ms-dev:3003',
+        'orgs-ms': 'http://orgs-ms-dev:3004',
+        'shifts-ms': 'http://shifts-ms-dev:3005',
+        'document-ms': 'http://document-ms-dev:3006',
+        'claim-ms': 'http://claim-ms-dev:3007',
+        'external-ms': 'http://external-ms-dev:3008',
+        'cache-ms': 'http://cache-ms-dev:3009',
+        'migration-ms': 'http://migration-ms-dev:3010',
+        'search-ms': 'http://search-ms-dev:3011'
+    },
+    'uat': {}
+};

package/dist/types/GHRContext.d.ts

@@ -0,0 +1,10 @@
+import type { MQClient } from '../mq/client.js';
+import Redis from 'ioredis';
+export type GHRContext<TPrismaClient = any> = {
+    service?: string;
+    correlationId?: string;
+    mq?: MQClient;
+    prisma?: TPrismaClient;
+    redis?: Redis;
+    extras?: Record<string, any>;
+};

package/dist/types/GHRContext.js

@@ -0,0 +1 @@
+export {};

package/dist/types/logTypes.d.ts

@@ -0,0 +1,23 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface BaseLogPayload {
+    message: string | Record<string, any>;
+    correlationId: string;
+    userId?: string;
+    [key: string]: any;
+}
+export interface ErrorLogPayload extends BaseLogPayload {
+    errorCode: string;
+    errorStack?: string;
+}
+export type LogPayloadByLevel = {
+    debug?: BaseLogPayload;
+    info?: BaseLogPayload;
+    warn?: BaseLogPayload;
+    error?: ErrorLogPayload;
+};
+export type ErrorInput = {
+    ex: unknown;
+    correlationId: string;
+    service?: string;
+    [key: string]: any;
+};

package/dist/types/logTypes.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@geniehr/utilities",
+  "version": "1.0.5",
+  "description": "",
+  "homepage": "https://github.com/Genie-HR/ghr-utilities#readme",
+  "bugs": {
+    "url": "https://github.com/Genie-HR/ghr-utilities/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Genie-HR/ghr-utilities.git"
+  },
+  "license": "ISC",
+  "author": "",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc -p tsconfig.json --watch",
+    "prepare": "test $HUSKY_SKIP != 'true' && husky install || echo 'Skipping husky install'"
+  },
+  "dependencies": {
+    "@aws-sdk/client-cognito-identity-provider": "^3.859.0",
+    "@aws-sdk/client-rekognition": "^3.846.0",
+    "@aws-sdk/client-s3": "^3.848.0",
+    "@aws-sdk/client-ssm": "^3.839.0",
+    "@aws-sdk/credential-providers": "^3.839.0",
+    "@aws-sdk/s3-request-presigner": "^3.848.0",
+    "@prisma/client": "^6.11.1",
+    "amqplib": "^0.10.8",
+    "axios": "^1.10.0",
+    "express": "^5.1.0",
+    "ioredis": "^5.8.2",
+    "sharp": "^0.34.4",
+    "winston": "^3.17.0",
+    "winston-cloudwatch": "^6.3.0",
+    "zod": "^3.25.74",
+    "zod-error": "^1.5.0"
+  },
+  "devDependencies": {
+    "@types/amqplib": "^0.10.7",
+    "@types/express": "^5.0.3",
+    "@types/node": "^24.0.12",
+    "husky": "^9.1.7",
+    "tsx": "^4.20.3",
+    "typescript": "^5.4.0"
+  }
+}