av6-utils 1.0.0

package/.prettierignore

@@ -0,0 +1,4 @@
+node_modules
+build
+dist
+.vscode

package/.prettierrc

@@ -0,0 +1,6 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "trailingComma": "es5",
+  "printWidth": 120
+}

package/README.md

@@ -0,0 +1,234 @@
+# AV6 Core
+
+A comprehensive utility library for AV6 Node.js projects, providing common functionality for data operations, caching, and Excel handling.
+
+## Features
+
+- **Dynamic Data Operations**: Flexible search, fetch, and CRUD operations with support for dynamic models
+- **Caching Support**: Built-in Redis caching for improved performance
+- **Excel Import/Export**: Seamless Excel file handling for data import and export
+- **Pagination**: Built-in pagination for search results
+- **DTO Mapping**: Support for Data Transfer Object mapping
+- **Type Safety**: Written in TypeScript with comprehensive type definitions
+- **UIN Config Management**: Unique Identification Number generation with configurable segments and automatic reset policies
+
+## Installation
+
+```bash
+npm install av6-core
+```
+
+## Usage
+
+### Basic Setup
+
+To use the library, you need to provide the necessary dependencies:
+
+```typescript
+import { commonService, Deps } from 'av6-core';
+import { PrismaClient } from '@prisma/client';
+import winston from 'winston';
+import { AsyncLocalStorage } from 'async_hooks';
+
+// Initialize dependencies
+const deps: Deps = {
+  config: {
+    REDIS_PREFIX: 'your-prefix:',
+    CACHE_KEY_NAME: 'your-cache-key'
+  },
+  mapper: {
+    dtoMapping: {}, // Your DTO mapping functions
+    mappingExport: {}, // Your export mapping functions
+    mappingImport: {}, // Your import mapping functions
+  },
+  helpers: {
+    generateErrorMessage: (type, ...variables) => {
+      // Your error message generation logic
+    },
+    ErrorHandler: class ErrorHandler extends Error {
+      // Your error handler implementation
+    }
+  },
+  logger: winston.createLogger({
+    // Your logger configuration
+  }),
+  cacheAdapter: {
+    // Your cache adapter implementation
+  },
+  requestStorage: new AsyncLocalStorage(),
+  db: new PrismaClient()
+};
+
+// Initialize the service
+const service = commonService(deps);
+```
+
+### Search Operations
+
+```typescript
+// Perform a search operation
+const searchResult = await service.search({
+  pageNo: 1,
+  pageSize: 10,
+  shortCode: 'USER',
+  searchColumns: ['name', 'email'],
+  searchText: 'john',
+  sortBy: 'createdAt',
+  sortDir: 'DESC',
+  shortCodeData: {
+    shortCode: 'USER',
+    tableName: 'user',
+    isDTO: true,
+    isCacheable: true
+  }
+});
+```
+
+### Fetch Record
+
+```typescript
+// Fetch a specific record
+const record = await service.fetch({
+  shortCode: 'USER',
+  id: 123,
+  shortCodeData: {
+    shortCode: 'USER',
+    tableName: 'user',
+    isDTO: true,
+    isCacheable: true
+  }
+});
+```
+
+### Excel Operations
+
+```typescript
+// Import data from Excel
+const importResult = await service.commonExcelImport({
+  shortCode: 'USER',
+  file: excelFile, // File object from upload
+  shortCodeData: {
+    shortCode: 'USER',
+    tableName: 'user'
+  }
+});
+
+// Export data to Excel
+const workbook = await service.commonExcelExport({
+  shortCode: 'USER',
+  isSample: false,
+  shortCodeData: {
+    shortCode: 'USER',
+    tableName: 'user'
+  }
+});
+```
+
+### UIN Config Operations
+
+```typescript
+import { uinConfigService, UinDeps, UIN_RESET_POLICY, UinShortCode } from 'av6-core';
+
+// Initialize UIN Config dependencies
+const uinDeps: UinDeps = {
+  config: {
+    REDIS_PREFIX: 'your-prefix:',
+    CACHE_KEY_NAME: 'your-cache-key'
+  },
+  helpers: {
+    generateErrorMessage: (type, ...variables) => {
+      // Your error message generation logic
+    },
+    ErrorHandler: class ErrorHandler extends Error {
+      // Your error handler implementation
+    }
+  },
+  logger: winston.createLogger({
+    // Your logger configuration
+  }),
+  cacheAdapter: {
+    // Your cache adapter implementation
+  },
+  requestStorage: new AsyncLocalStorage(),
+  db: new PrismaClient(),
+  prisma: PrismaNamespace,
+  shortCode: 'UIN_CONFIG',
+  cacheKey: 'uin-config'
+};
+
+// Initialize the UIN Config service
+const uinService = uinConfigService(uinDeps);
+
+// Create a new UIN Config
+const newUinConfig = await uinService.createUINConfig({
+  shortCode: UinShortCode.INVOICE,
+  seqResetPolicy: UIN_RESET_POLICY.monthly,
+  description: 'Invoice number generator',
+  uinSegments: [
+    { order: 1, type: 'text', value: 'INV-' },
+    { order: 2, type: 'dateFormat', value: 'YYYYMM' },
+    { order: 3, type: 'separator', value: '-' },
+    { order: 4, type: 'sequenceNo', minSeqLength: 5 }
+  ]
+});
+
+// Generate a UIN preview
+const uinPreview = await uinService.previewUIN({
+  uinSegments: [
+    { order: 1, type: 'text', value: 'INV-' },
+    { order: 2, type: 'dateFormat', value: 'YYYYMM' },
+    { order: 3, type: 'separator', value: '-' },
+    { order: 4, type: 'sequenceNo', minSeqLength: 5 }
+  ]
+});
+
+// Get a UIN Config by ID
+const uinConfig = await uinService.getUINConfigById(1);
+
+// Generate a new UIN
+const generatedUin = await uinService.generateUIN(UinShortCode.INVOICE);
+```
+
+## API Reference
+
+### Common Service
+
+The library provides a comprehensive service for common operations:
+
+- `search`: Search records with pagination and filtering
+- `dropdownSearch`: Search records for dropdown components
+- `fixedSearch`: Search with fixed criteria
+- `fixedSearchWoPaginationService`: Search with fixed criteria without pagination
+- `commonExcelService`: Generate Excel workbooks
+- `fetch`: Fetch a specific record by ID
+- `commonExcelImport`: Import data from Excel files
+- `commonExcelExport`: Export data to Excel files
+- `delete`: Delete a record
+- `updateStatus`: Update the status of a record
+- `fetchImageStream`: Fetch an image as a stream
+
+### UIN Config Service
+
+The library provides a service for managing Unique Identification Numbers:
+
+- `createUINConfig`: Create a new UIN configuration
+- `updateUINConfig`: Update an existing UIN configuration
+- `getUINConfigById`: Retrieve a UIN configuration by ID
+- `getAllUINConfig`: Retrieve all UIN configurations
+- `deleteUINConfig`: Delete a UIN configuration
+- `generateUIN`: Generate a new UIN based on a shortcode
+- `previewUIN`: Preview a UIN based on segment configuration
+
+### Utility Functions
+
+The library also provides utility functions:
+
+- `customOmit`: Omit specific keys from an object
+- `objectTo2DArray`: Convert an object to a 2D array
+- `toRelativeImageUrl`: Convert an absolute path to a relative image URL
+
+## License
+
+ISC
+ 
+

package/dist/index.d.mts

@@ -0,0 +1,113 @@
+declare function customOmit<T extends object, K extends keyof T>(obj: T, keys: K[]): {
+    rest: Omit<T, K>;
+    omitted: Pick<T, K>;
+};
+declare function getDynamicValue(obj: Record<string, any> | null | undefined, accessorKey: string): any | null;
+declare function objectTo2DArray<T>(obj: Record<string, T>, maxCols: number): (string | T)[][];
+declare function toNumberOrNull(value: unknown): number | null;
+declare const getPattern: {
+    [key: string]: RegExp;
+};
+declare const interpolate: (template: string, vars: Record<string, unknown>) => string;
+
+type DiscountMode = "PERCENTAGE" | "AMOUNT";
+type AdditionalDiscountMode = "PERCENTAGE" | "AMOUNT";
+type CoPayType = "PERCENTAGE" | "AMOUNT";
+type TaxMethod = "NONE" | "INCLUSIVE" | "EXCLUSIVE";
+type CoPayMode = "EXCLUSIVE-INCLUSIVE" | "PERCENTAGE-AMOUNT";
+declare const RoundFormat: {
+    readonly ROUND: "ROUND";
+    readonly SPECIAL_ROUND: "SPECIAL_ROUND";
+    readonly TO_FIXED: "TO_FIXED";
+    readonly CEIL: "CEIL";
+    readonly FLOOR: "FLOOR";
+    readonly TRUNC: "TRUNC";
+    readonly NONE: "NONE";
+};
+type RoundFormat = (typeof RoundFormat)[keyof typeof RoundFormat];
+interface ChildCalcInput {
+    qty: number;
+    rate: number;
+    otherCharge?: number;
+    addonPercentage?: number;
+    discountMode?: DiscountMode;
+    discountValue?: number;
+    taxMethod?: TaxMethod;
+    taxValue?: number;
+    /** Absolute insurer-covered at line level */
+    coPaymentType?: CoPayType;
+    coPayValue?: number;
+    coPayMethod?: "EXCLUSIVE" | "INCLUSIVE";
+}
+interface MasterAdditionalDiscount {
+    mode: AdditionalDiscountMode;
+    value: number;
+    coPayMode?: CoPayMode;
+}
+interface CalcOptions {
+    calculationMethod?: "STEP_WISE" | "FINAL_ONLY";
+    lineRound?: RoundFormat;
+    headerRound?: RoundFormat;
+    precision?: number;
+}
+interface ChildCalculated {
+    baseRate: number;
+    subtotalAmount: number;
+    otherChargeAmount: number;
+    discountMode: DiscountMode;
+    discountValue: number;
+    discountAmount: number;
+    taxMethod: TaxMethod;
+    taxValue: number;
+    taxAmount: number;
+    grossAmount: number;
+    netAmount: number;
+    roundOffAmount: number;
+    copayAmount: number;
+}
+interface MasterCalculated {
+    additionalDiscountMode: AdditionalDiscountMode;
+    additionalDiscountValue: number;
+    subtotalAmount: number;
+    otherChargeAmount: number;
+    discountTotalAmount: number;
+    taxAmount: number;
+    grossAmount: number;
+    netAmount: number;
+    roundOffAmount: number;
+    copayAmount: number;
+}
+interface BillingCalcResult {
+    master: MasterCalculated;
+    children: ChildCalculated[];
+}
+
+/**
+ * calculateBillingFromChildren (master-level additional discount applied AFTER child calculations)
+ * - Child: item discount -> tax (INCLUSIVE/EXCLUSIVE/NONE) -> coPay -> patient line net + line rounding
+ * - Master: sum children, compute patientRawTotal = gross - Σcopay
+ *           apply master additional discount ON patientRawTotal (no propagation to children)
+ *           then header rounding
+ */
+declare function calculateBillingFromChildren(inputs: ChildCalcInput[], masterExtra: MasterAdditionalDiscount, options?: CalcOptions): BillingCalcResult;
+declare function calculateSingleChild(it: ChildCalcInput, coPayMode: CoPayMode, options?: CalcOptions): ChildCalculated;
+
+interface CreateTransaction {
+    field: string;
+    changedFrom?: string | null;
+    changedTo?: string | null;
+}
+
+/**
+ * Compares two objects (including nested objects) by flattening them,
+ * and returns an array of differences. The returned array contains objects
+ * with the field name (underscores replaced by spaces), changedFrom, and
+ * changedTo values.
+ *
+ * @param obj1 - The first object.
+ * @param obj2 - The second object.
+ * @returns An array of DiffResult objects representing the differences.
+ */
+declare function findDifferences<T extends Record<string, any>>(obj1: T, obj2: T): CreateTransaction[];
+
+export { type AdditionalDiscountMode, type BillingCalcResult, type CalcOptions, type ChildCalcInput, type ChildCalculated, type CoPayMode, type CoPayType, type DiscountMode, type MasterAdditionalDiscount, type MasterCalculated, RoundFormat, type TaxMethod, calculateBillingFromChildren, calculateSingleChild, customOmit, findDifferences, getDynamicValue, getPattern, interpolate, objectTo2DArray, toNumberOrNull };

package/dist/index.d.ts

@@ -0,0 +1,113 @@
+declare function customOmit<T extends object, K extends keyof T>(obj: T, keys: K[]): {
+    rest: Omit<T, K>;
+    omitted: Pick<T, K>;
+};
+declare function getDynamicValue(obj: Record<string, any> | null | undefined, accessorKey: string): any | null;
+declare function objectTo2DArray<T>(obj: Record<string, T>, maxCols: number): (string | T)[][];
+declare function toNumberOrNull(value: unknown): number | null;
+declare const getPattern: {
+    [key: string]: RegExp;
+};
+declare const interpolate: (template: string, vars: Record<string, unknown>) => string;
+
+type DiscountMode = "PERCENTAGE" | "AMOUNT";
+type AdditionalDiscountMode = "PERCENTAGE" | "AMOUNT";
+type CoPayType = "PERCENTAGE" | "AMOUNT";
+type TaxMethod = "NONE" | "INCLUSIVE" | "EXCLUSIVE";
+type CoPayMode = "EXCLUSIVE-INCLUSIVE" | "PERCENTAGE-AMOUNT";
+declare const RoundFormat: {
+    readonly ROUND: "ROUND";
+    readonly SPECIAL_ROUND: "SPECIAL_ROUND";
+    readonly TO_FIXED: "TO_FIXED";
+    readonly CEIL: "CEIL";
+    readonly FLOOR: "FLOOR";
+    readonly TRUNC: "TRUNC";
+    readonly NONE: "NONE";
+};
+type RoundFormat = (typeof RoundFormat)[keyof typeof RoundFormat];
+interface ChildCalcInput {
+    qty: number;
+    rate: number;
+    otherCharge?: number;
+    addonPercentage?: number;
+    discountMode?: DiscountMode;
+    discountValue?: number;
+    taxMethod?: TaxMethod;
+    taxValue?: number;
+    /** Absolute insurer-covered at line level */
+    coPaymentType?: CoPayType;
+    coPayValue?: number;
+    coPayMethod?: "EXCLUSIVE" | "INCLUSIVE";
+}
+interface MasterAdditionalDiscount {
+    mode: AdditionalDiscountMode;
+    value: number;
+    coPayMode?: CoPayMode;
+}
+interface CalcOptions {
+    calculationMethod?: "STEP_WISE" | "FINAL_ONLY";
+    lineRound?: RoundFormat;
+    headerRound?: RoundFormat;
+    precision?: number;
+}
+interface ChildCalculated {
+    baseRate: number;
+    subtotalAmount: number;
+    otherChargeAmount: number;
+    discountMode: DiscountMode;
+    discountValue: number;
+    discountAmount: number;
+    taxMethod: TaxMethod;
+    taxValue: number;
+    taxAmount: number;
+    grossAmount: number;
+    netAmount: number;
+    roundOffAmount: number;
+    copayAmount: number;
+}
+interface MasterCalculated {
+    additionalDiscountMode: AdditionalDiscountMode;
+    additionalDiscountValue: number;
+    subtotalAmount: number;
+    otherChargeAmount: number;
+    discountTotalAmount: number;
+    taxAmount: number;
+    grossAmount: number;
+    netAmount: number;
+    roundOffAmount: number;
+    copayAmount: number;
+}
+interface BillingCalcResult {
+    master: MasterCalculated;
+    children: ChildCalculated[];
+}
+
+/**
+ * calculateBillingFromChildren (master-level additional discount applied AFTER child calculations)
+ * - Child: item discount -> tax (INCLUSIVE/EXCLUSIVE/NONE) -> coPay -> patient line net + line rounding
+ * - Master: sum children, compute patientRawTotal = gross - Σcopay
+ *           apply master additional discount ON patientRawTotal (no propagation to children)
+ *           then header rounding
+ */
+declare function calculateBillingFromChildren(inputs: ChildCalcInput[], masterExtra: MasterAdditionalDiscount, options?: CalcOptions): BillingCalcResult;
+declare function calculateSingleChild(it: ChildCalcInput, coPayMode: CoPayMode, options?: CalcOptions): ChildCalculated;
+
+interface CreateTransaction {
+    field: string;
+    changedFrom?: string | null;
+    changedTo?: string | null;
+}
+
+/**
+ * Compares two objects (including nested objects) by flattening them,
+ * and returns an array of differences. The returned array contains objects
+ * with the field name (underscores replaced by spaces), changedFrom, and
+ * changedTo values.
+ *
+ * @param obj1 - The first object.
+ * @param obj2 - The second object.
+ * @returns An array of DiffResult objects representing the differences.
+ */
+declare function findDifferences<T extends Record<string, any>>(obj1: T, obj2: T): CreateTransaction[];
+
+export { type AdditionalDiscountMode, type BillingCalcResult, type CalcOptions, type ChildCalcInput, type ChildCalculated, type CoPayMode, type CoPayType, type DiscountMode, type MasterAdditionalDiscount, type MasterCalculated, RoundFormat, type TaxMethod, calculateBillingFromChildren, calculateSingleChild, customOmit, findDifferences, getDynamicValue, getPattern, interpolate, objectTo2DArray, toNumberOrNull };

package/dist/index.js

@@ -0,0 +1,363 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  RoundFormat: () => RoundFormat,
+  calculateBillingFromChildren: () => calculateBillingFromChildren,
+  calculateSingleChild: () => calculateSingleChild,
+  customOmit: () => customOmit,
+  findDifferences: () => findDifferences,
+  getDynamicValue: () => getDynamicValue,
+  getPattern: () => getPattern,
+  interpolate: () => interpolate,
+  objectTo2DArray: () => objectTo2DArray,
+  toNumberOrNull: () => toNumberOrNull
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/utils/helper.utils.ts
+function customOmit(obj, keys) {
+  const rest = { ...obj };
+  const omitted = {};
+  for (const key of keys) {
+    if (key in obj) {
+      omitted[key] = obj[key];
+      delete rest[key];
+    }
+  }
+  return { rest, omitted };
+}
+function getDynamicValue(obj, accessorKey) {
+  if (!accessorKey || obj == null || typeof obj !== "object") {
+    return null;
+  }
+  const keys = accessorKey.split(".");
+  let result = obj;
+  for (const key of keys) {
+    if (result == null || typeof result !== "object" || !(key in result)) {
+      return null;
+    }
+    result = result[key];
+  }
+  return result === void 0 ? null : result;
+}
+function objectTo2DArray(obj, maxCols) {
+  if (maxCols < 2) {
+    throw new Error("maxCols must be at least 2");
+  }
+  const rows = [];
+  let currentRow = [];
+  for (const [key, value] of Object.entries(obj)) {
+    const pair = [key, value];
+    if (currentRow.length + pair.length > maxCols) {
+      if (currentRow.length > 0) {
+        rows.push(currentRow);
+      }
+      currentRow = [];
+    }
+    currentRow.push(...pair);
+  }
+  if (currentRow.length > 0) {
+    rows.push(currentRow);
+  }
+  return rows;
+}
+function toNumberOrNull(value) {
+  if (typeof value === "number") {
+    return value;
+  }
+  const converted = Number(value);
+  return isNaN(converted) ? null : converted;
+}
+var getPattern = {
+  stringBaseNum: /^[1-9][0-9]*$/,
+  licenseTitle: /^(?=.{3,100}$)[A-Za-z0-9][A-Za-z0-9\s\-/&,.()]*$/,
+  categoryName: /^(?=.*[A-Za-z])(?=.*\d)(?=.*[!@#$%^&*()_+\-=[\]{};'":\\|,.<>/?]).{3,30}$/,
+  namePattern: /^[A-Za-z\s]+$/,
+  skuPattern: /^[A-Z0-9_-]+$/i,
+  SlNoPattern: /^[A-Za-z0-9_-]+$/,
+  nameWithNumPattern: /^[A-Za-z0-9\s]+$/,
+  emailPattern: /^[\w-]+(\.[\w-]+)*@([\w-]+\.)+[a-zA-Z]{2,7}$/,
+  // phonePattern:
+  //   /^(?:\+?(\d{1,3})[\s.-]?)?(?:\(?(\d{3})\)?[\s.-]?)?(\d{3})[\s.-]?(\d{4})(?:\s*(?:x|ext)\s*(\d+))?$/,
+  phonePattern: /^\d{9}$/,
+  postalCodePattern: /^[0-9]{5}$/,
+  alphanumericPattern: /^[a-zA-Z0-9]+$/,
+  numericPattern: /^[0-9]+$/,
+  datePattern: /^(0[1-9]|1[0-2])\/(0[1-9]|1\d|2\d|3[01])\/(19|20)\d{2}$/,
+  timePattern: /^(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9])$/,
+  uuidPattern: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
+  passwordPattern: /^(?=.*\d)(?=.*[a-z])(?=.*[A-Z])(?=.*[^a-zA-Z0-9]).{8,}$/,
+  jsonPattern: /^(\[.+?\]|\{.+?\})$/,
+  ipPattern: /^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$/,
+  macAddressPattern: /^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$/,
+  hexColorPattern: /^#?([a-f0-9]{6}|[a-f0-9]{3})$/,
+  hexPattern: /^[0-9A-Fa-f]+$/,
+  binaryPattern: /^[01]+$/,
+  base64Pattern: /^([A-Za-z0-9+/]{4})*([A-Za-z0-9+/]{4}|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{2}==)$/,
+  alphanumericDashPattern: /^[a-zA-Z0-9-]+$/,
+  alphanumericDotPattern: /^[a-zA-Z0-9.]+$/,
+  alphanumericUnderscorePattern: /^[a-zA-Z0-9_]+$/,
+  alphanumericPlusPattern: /^[a-zA-Z0-9+]+$/,
+  alphanumericSlashPattern: /^[a-zA-Z0-9/]+$/,
+  alphanumericColonPattern: /^[a-zA-Z0-9:]+$/,
+  alphanumericQuestionMarkPattern: /^[a-zA-Z0-9?]+$/,
+  alphanumericAtPattern: /^[a-zA-Z0-9@]+$/,
+  alphanumericHashPattern: /^[a-zA-Z0-9#]+$/,
+  alphanumericDollarPattern: /^[a-zA-Z0-9$]+$/,
+  alphanumericPercentPattern: /^[a-zA-Z0-9%]+$/,
+  alphanumericAmpersandPattern: /^[a-zA-Z0-9&]+$/,
+  alphanumericVerticalBarPattern: /^[a-zA-Z0-9|]+$/,
+  alphanumericTildePattern: /^[a-zA-Z0-9~]+$/,
+  alphanumericExclamationPattern: /^[a-zA-Z0-9!]+$/,
+  alphanumericAndPattern: /^[a-zA-Z0-9&]+$/,
+  alphanumericAsteriskPattern: /^[a-zA-Z0-9*]+$/,
+  imagePattern: /^.*\.(jpe?g|png|gif)$/i,
+  videoPattern: /\.(mp4|webm|ogg)$/i,
+  audioPattern: /\.(mp3|wav)$/i,
+  pdfPattern: /\.(pdf)$/i,
+  docPattern: /\.(doc|docx)$/i,
+  xlsPattern: /\.(xls|xlsx)$/i,
+  pptPattern: /\.(ppt|pptx)$/i,
+  zipPattern: /\.(zip)$/i,
+  rarPattern: /\.(rar)$/i,
+  tarPattern: /\.(tar)$/i,
+  gzipPattern: /\.(gz|gzip)$/i,
+  bz2Pattern: /\.(bz2)$/i,
+  isoPattern: /\.(iso)$/i,
+  txtPattern: /\.(txt)$/i
+};
+var interpolate = (template, vars) => {
+  return template.replace(/\{\{\s*([^}]+)\s*\}\}/g, (match, key) => {
+    key = key.trim();
+    return key in vars ? String(vars[key]) : "";
+  });
+};
+
+// src/types/calculation.ts
+var RoundFormat = {
+  ROUND: "ROUND",
+  SPECIAL_ROUND: "SPECIAL_ROUND",
+  TO_FIXED: "TO_FIXED",
+  CEIL: "CEIL",
+  FLOOR: "FLOOR",
+  TRUNC: "TRUNC",
+  NONE: "NONE"
+};
+
+// src/utils/calculation.utils.ts
+function applyRound(value, format, precision = 2) {
+  switch (format) {
+    case RoundFormat.NONE:
+      return value;
+    case RoundFormat.ROUND:
+      return Math.round(value);
+    case RoundFormat.SPECIAL_ROUND:
+      return value < 1 ? Math.ceil(value) : Math.round(value);
+    case RoundFormat.CEIL:
+      return Math.ceil(value);
+    case RoundFormat.FLOOR:
+      return Math.floor(value);
+    case RoundFormat.TRUNC:
+      return Math.trunc(value);
+    case RoundFormat.TO_FIXED:
+    default:
+      return Number(value.toFixed(Math.max(0, precision | 0)));
+  }
+}
+var maybeStep = (v, stepwise, fmt, p) => stepwise ? applyRound(v, fmt, p) : v;
+function clamp(n, min, max) {
+  return Math.max(min, Math.min(max, n));
+}
+var percentage = (amount, percentage2) => {
+  return amount * percentage2 / 100;
+};
+function calculateBillingFromChildren(inputs, masterExtra, options = {}) {
+  const stepwise = options.calculationMethod === "STEP_WISE";
+  const lineFmt = options.lineRound ?? RoundFormat.TO_FIXED;
+  const headFmt = options.headerRound ?? lineFmt;
+  const precision = options.precision ?? 2;
+  const children = inputs.map((it) => {
+    return calculateSingleChild(it, masterExtra.coPayMode ?? "PERCENTAGE-AMOUNT", options);
+  });
+  const subtotalAmount = children.reduce((a, c) => a + c.subtotalAmount, 0);
+  const otherChargeAmount = children.reduce((a, c) => a + c.otherChargeAmount, 0);
+  const itemDiscountSum = children.reduce((a, c) => a + c.discountAmount, 0);
+  const taxAmount = children.reduce((a, c) => a + c.taxAmount, 0);
+  const grossAmount = children.reduce((a, c) => a + c.grossAmount, 0);
+  const copayAmount = children.reduce((a, c) => a + c.copayAmount, 0);
+  const patientRawTotal = grossAmount - copayAmount;
+  let masterExtraApplied = 0;
+  if (masterExtra.mode === "PERCENTAGE") {
+    masterExtraApplied = percentage(patientRawTotal, masterExtra.value);
+  } else if (masterExtra.mode === "AMOUNT") {
+    masterExtraApplied = Math.min(masterExtra.value, patientRawTotal);
+  }
+  masterExtraApplied = maybeStep(masterExtraApplied, stepwise, headFmt, precision);
+  const discountTotalAmount = maybeStep(itemDiscountSum + masterExtraApplied, stepwise, headFmt, precision);
+  const patientAfterExtra = applyRound(Math.max(0, patientRawTotal - masterExtraApplied), "TO_FIXED", 2);
+  const netAmount = applyRound(patientAfterExtra, headFmt, precision);
+  const roundOffAmount = netAmount - patientAfterExtra;
+  const master = {
+    additionalDiscountMode: masterExtra.mode,
+    additionalDiscountValue: masterExtra.value,
+    subtotalAmount: applyRound(subtotalAmount, headFmt, precision),
+    otherChargeAmount: applyRound(otherChargeAmount, headFmt, precision),
+    discountTotalAmount: applyRound(discountTotalAmount, headFmt, precision),
+    // includes master extra
+    taxAmount: applyRound(taxAmount, headFmt, precision),
+    grossAmount: applyRound(grossAmount, headFmt, precision),
+    netAmount,
+    // patient payable after master extra + rounding
+    roundOffAmount: applyRound(roundOffAmount, "TO_FIXED", 2),
+    // rounded - raw
+    copayAmount: applyRound(copayAmount, headFmt, precision)
+    // Σ line copay (insurer covered)
+  };
+  return { master, children };
+}
+function calculateSingleChild(it, coPayMode, options = {}) {
+  const stepwise = options.calculationMethod === "STEP_WISE";
+  const lineFmt = options.lineRound ?? RoundFormat.TO_FIXED;
+  const precision = options.precision ?? 2;
+  let baseRate = it.rate;
+  if (it.addonPercentage) {
+    baseRate = baseRate + percentage(baseRate, it.addonPercentage);
+    baseRate = applyRound(baseRate, lineFmt, precision);
+  }
+  const subtotal = applyRound(it.qty * baseRate, lineFmt, precision);
+  const other = applyRound(it.otherCharge ?? 0, lineFmt, precision);
+  const basePreTax = applyRound(subtotal + other, lineFmt, precision);
+  let copayAmount = 0;
+  if (coPayMode === "PERCENTAGE-AMOUNT") {
+    const copayType = it.coPaymentType ?? "AMOUNT";
+    const copayValue = it.coPayValue ?? 0;
+    copayAmount = copayType === "PERCENTAGE" ? percentage(subtotal, copayValue) : Math.min(copayValue, subtotal);
+  }
+  const dMode = it.discountMode ?? "AMOUNT";
+  const dVal = it.discountValue ?? 0;
+  const tMethod = it.taxMethod ?? "NONE";
+  const tVal = Math.max(0, it.taxValue ?? 0);
+  let baseAfterTaxDisc = basePreTax;
+  if (tMethod === "INCLUSIVE") {
+    const inclusiveTaxMultiplier = (100 + tVal) / 100;
+    baseAfterTaxDisc = basePreTax / inclusiveTaxMultiplier;
+  }
+  baseAfterTaxDisc = maybeStep(baseAfterTaxDisc, stepwise, lineFmt, precision);
+  const inclDiff = applyRound(basePreTax - baseAfterTaxDisc, lineFmt, precision);
+  let discountValue = 0;
+  if (dMode === "AMOUNT") {
+    discountValue = dVal;
+  } else if (dMode === "PERCENTAGE") {
+    discountValue = percentage(baseAfterTaxDisc, dVal);
+  }
+  discountValue = maybeStep(discountValue, stepwise, lineFmt, precision);
+  let afterDisc = Math.max(0, baseAfterTaxDisc - discountValue);
+  afterDisc = maybeStep(afterDisc, stepwise, lineFmt, precision);
+  let calculatedTax = percentage(afterDisc, tVal);
+  calculatedTax = maybeStep(calculatedTax, stepwise, lineFmt, precision);
+  let grossAmount = afterDisc + calculatedTax;
+  grossAmount = maybeStep(grossAmount, stepwise, lineFmt, precision);
+  if (coPayMode === "EXCLUSIVE-INCLUSIVE" && it.coPayMethod === "INCLUSIVE") {
+    copayAmount = grossAmount;
+  }
+  copayAmount = applyRound(copayAmount, lineFmt, precision);
+  const copay = clamp(Math.max(0, copayAmount), 0, grossAmount);
+  const patientRaw = applyRound(grossAmount - copay, RoundFormat.TO_FIXED, 2);
+  const patientRounded = applyRound(patientRaw, lineFmt, precision);
+  const lineRoundOff = applyRound(patientRounded - patientRaw, RoundFormat.TO_FIXED, 2);
+  return {
+    // include baseRate if your ChildCalculated type has it (as in your bulk function)
+    baseRate: applyRound(baseRate, lineFmt, precision),
+    subtotalAmount: applyRound(subtotal + other - inclDiff, lineFmt, precision),
+    otherChargeAmount: other,
+    discountMode: dMode,
+    discountValue: dVal,
+    discountAmount: applyRound(discountValue, lineFmt, precision),
+    taxMethod: tMethod,
+    taxValue: tVal,
+    taxAmount: applyRound(calculatedTax, lineFmt, precision),
+    grossAmount: applyRound(grossAmount, lineFmt, precision),
+    netAmount: patientRounded,
+    roundOffAmount: lineRoundOff,
+    copayAmount: copay
+  };
+}
+
+// src/utils/audit.utils.ts
+function isValidDate(value) {
+  if (value instanceof Date) {
+    return !isNaN(value.getTime());
+  }
+  if (typeof value === "string" || typeof value === "number") {
+    const parsed = new Date(value);
+    return !isNaN(parsed.getTime());
+  }
+  return false;
+}
+function flattenObject(obj, parentKey = "") {
+  const result = {};
+  for (const key of Object.keys(obj)) {
+    const raw = obj[key];
+    const newKey = parentKey ? `${parentKey}_${key}` : key;
+    if (typeof raw !== "number" && isValidDate(raw)) {
+      const date = raw instanceof Date ? raw : new Date(raw);
+      result[newKey] = date.toISOString().split("T")[0];
+      continue;
+    }
+    if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+      Object.assign(result, flattenObject(raw, newKey));
+      continue;
+    }
+    result[newKey] = raw;
+  }
+  return result;
+}
+function findDifferences(obj1, obj2) {
+  const flatObj1 = flattenObject(obj1);
+  const flatObj2 = flattenObject(obj2);
+  const differences = [];
+  const allKeys = /* @__PURE__ */ new Set([...Object.keys(flatObj1)]);
+  allKeys.forEach((key) => {
+    if (flatObj1[key] !== flatObj2[key]) {
+      differences.push({
+        // Replace underscores with spaces for a nicer field output
+        field: key.replace(/_/g, " "),
+        changedFrom: typeof flatObj1[key] !== "string" ? JSON.stringify(flatObj1[key]) : flatObj1[key],
+        changedTo: typeof flatObj2[key] !== "string" ? JSON.stringify(flatObj2[key]) : flatObj2[key]
+      });
+    }
+  });
+  return differences;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RoundFormat,
+  calculateBillingFromChildren,
+  calculateSingleChild,
+  customOmit,
+  findDifferences,
+  getDynamicValue,
+  getPattern,
+  interpolate,
+  objectTo2DArray,
+  toNumberOrNull
+});

package/dist/index.mjs

@@ -0,0 +1,327 @@
+// src/utils/helper.utils.ts
+function customOmit(obj, keys) {
+  const rest = { ...obj };
+  const omitted = {};
+  for (const key of keys) {
+    if (key in obj) {
+      omitted[key] = obj[key];
+      delete rest[key];
+    }
+  }
+  return { rest, omitted };
+}
+function getDynamicValue(obj, accessorKey) {
+  if (!accessorKey || obj == null || typeof obj !== "object") {
+    return null;
+  }
+  const keys = accessorKey.split(".");
+  let result = obj;
+  for (const key of keys) {
+    if (result == null || typeof result !== "object" || !(key in result)) {
+      return null;
+    }
+    result = result[key];
+  }
+  return result === void 0 ? null : result;
+}
+function objectTo2DArray(obj, maxCols) {
+  if (maxCols < 2) {
+    throw new Error("maxCols must be at least 2");
+  }
+  const rows = [];
+  let currentRow = [];
+  for (const [key, value] of Object.entries(obj)) {
+    const pair = [key, value];
+    if (currentRow.length + pair.length > maxCols) {
+      if (currentRow.length > 0) {
+        rows.push(currentRow);
+      }
+      currentRow = [];
+    }
+    currentRow.push(...pair);
+  }
+  if (currentRow.length > 0) {
+    rows.push(currentRow);
+  }
+  return rows;
+}
+function toNumberOrNull(value) {
+  if (typeof value === "number") {
+    return value;
+  }
+  const converted = Number(value);
+  return isNaN(converted) ? null : converted;
+}
+var getPattern = {
+  stringBaseNum: /^[1-9][0-9]*$/,
+  licenseTitle: /^(?=.{3,100}$)[A-Za-z0-9][A-Za-z0-9\s\-/&,.()]*$/,
+  categoryName: /^(?=.*[A-Za-z])(?=.*\d)(?=.*[!@#$%^&*()_+\-=[\]{};'":\\|,.<>/?]).{3,30}$/,
+  namePattern: /^[A-Za-z\s]+$/,
+  skuPattern: /^[A-Z0-9_-]+$/i,
+  SlNoPattern: /^[A-Za-z0-9_-]+$/,
+  nameWithNumPattern: /^[A-Za-z0-9\s]+$/,
+  emailPattern: /^[\w-]+(\.[\w-]+)*@([\w-]+\.)+[a-zA-Z]{2,7}$/,
+  // phonePattern:
+  //   /^(?:\+?(\d{1,3})[\s.-]?)?(?:\(?(\d{3})\)?[\s.-]?)?(\d{3})[\s.-]?(\d{4})(?:\s*(?:x|ext)\s*(\d+))?$/,
+  phonePattern: /^\d{9}$/,
+  postalCodePattern: /^[0-9]{5}$/,
+  alphanumericPattern: /^[a-zA-Z0-9]+$/,
+  numericPattern: /^[0-9]+$/,
+  datePattern: /^(0[1-9]|1[0-2])\/(0[1-9]|1\d|2\d|3[01])\/(19|20)\d{2}$/,
+  timePattern: /^(0[0-9]|1[0-9]|2[0-3]):([0-5][0-9])$/,
+  uuidPattern: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
+  passwordPattern: /^(?=.*\d)(?=.*[a-z])(?=.*[A-Z])(?=.*[^a-zA-Z0-9]).{8,}$/,
+  jsonPattern: /^(\[.+?\]|\{.+?\})$/,
+  ipPattern: /^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$/,
+  macAddressPattern: /^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$/,
+  hexColorPattern: /^#?([a-f0-9]{6}|[a-f0-9]{3})$/,
+  hexPattern: /^[0-9A-Fa-f]+$/,
+  binaryPattern: /^[01]+$/,
+  base64Pattern: /^([A-Za-z0-9+/]{4})*([A-Za-z0-9+/]{4}|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{2}==)$/,
+  alphanumericDashPattern: /^[a-zA-Z0-9-]+$/,
+  alphanumericDotPattern: /^[a-zA-Z0-9.]+$/,
+  alphanumericUnderscorePattern: /^[a-zA-Z0-9_]+$/,
+  alphanumericPlusPattern: /^[a-zA-Z0-9+]+$/,
+  alphanumericSlashPattern: /^[a-zA-Z0-9/]+$/,
+  alphanumericColonPattern: /^[a-zA-Z0-9:]+$/,
+  alphanumericQuestionMarkPattern: /^[a-zA-Z0-9?]+$/,
+  alphanumericAtPattern: /^[a-zA-Z0-9@]+$/,
+  alphanumericHashPattern: /^[a-zA-Z0-9#]+$/,
+  alphanumericDollarPattern: /^[a-zA-Z0-9$]+$/,
+  alphanumericPercentPattern: /^[a-zA-Z0-9%]+$/,
+  alphanumericAmpersandPattern: /^[a-zA-Z0-9&]+$/,
+  alphanumericVerticalBarPattern: /^[a-zA-Z0-9|]+$/,
+  alphanumericTildePattern: /^[a-zA-Z0-9~]+$/,
+  alphanumericExclamationPattern: /^[a-zA-Z0-9!]+$/,
+  alphanumericAndPattern: /^[a-zA-Z0-9&]+$/,
+  alphanumericAsteriskPattern: /^[a-zA-Z0-9*]+$/,
+  imagePattern: /^.*\.(jpe?g|png|gif)$/i,
+  videoPattern: /\.(mp4|webm|ogg)$/i,
+  audioPattern: /\.(mp3|wav)$/i,
+  pdfPattern: /\.(pdf)$/i,
+  docPattern: /\.(doc|docx)$/i,
+  xlsPattern: /\.(xls|xlsx)$/i,
+  pptPattern: /\.(ppt|pptx)$/i,
+  zipPattern: /\.(zip)$/i,
+  rarPattern: /\.(rar)$/i,
+  tarPattern: /\.(tar)$/i,
+  gzipPattern: /\.(gz|gzip)$/i,
+  bz2Pattern: /\.(bz2)$/i,
+  isoPattern: /\.(iso)$/i,
+  txtPattern: /\.(txt)$/i
+};
+var interpolate = (template, vars) => {
+  return template.replace(/\{\{\s*([^}]+)\s*\}\}/g, (match, key) => {
+    key = key.trim();
+    return key in vars ? String(vars[key]) : "";
+  });
+};
+
+// src/types/calculation.ts
+var RoundFormat = {
+  ROUND: "ROUND",
+  SPECIAL_ROUND: "SPECIAL_ROUND",
+  TO_FIXED: "TO_FIXED",
+  CEIL: "CEIL",
+  FLOOR: "FLOOR",
+  TRUNC: "TRUNC",
+  NONE: "NONE"
+};
+
+// src/utils/calculation.utils.ts
+function applyRound(value, format, precision = 2) {
+  switch (format) {
+    case RoundFormat.NONE:
+      return value;
+    case RoundFormat.ROUND:
+      return Math.round(value);
+    case RoundFormat.SPECIAL_ROUND:
+      return value < 1 ? Math.ceil(value) : Math.round(value);
+    case RoundFormat.CEIL:
+      return Math.ceil(value);
+    case RoundFormat.FLOOR:
+      return Math.floor(value);
+    case RoundFormat.TRUNC:
+      return Math.trunc(value);
+    case RoundFormat.TO_FIXED:
+    default:
+      return Number(value.toFixed(Math.max(0, precision | 0)));
+  }
+}
+var maybeStep = (v, stepwise, fmt, p) => stepwise ? applyRound(v, fmt, p) : v;
+function clamp(n, min, max) {
+  return Math.max(min, Math.min(max, n));
+}
+var percentage = (amount, percentage2) => {
+  return amount * percentage2 / 100;
+};
+function calculateBillingFromChildren(inputs, masterExtra, options = {}) {
+  const stepwise = options.calculationMethod === "STEP_WISE";
+  const lineFmt = options.lineRound ?? RoundFormat.TO_FIXED;
+  const headFmt = options.headerRound ?? lineFmt;
+  const precision = options.precision ?? 2;
+  const children = inputs.map((it) => {
+    return calculateSingleChild(it, masterExtra.coPayMode ?? "PERCENTAGE-AMOUNT", options);
+  });
+  const subtotalAmount = children.reduce((a, c) => a + c.subtotalAmount, 0);
+  const otherChargeAmount = children.reduce((a, c) => a + c.otherChargeAmount, 0);
+  const itemDiscountSum = children.reduce((a, c) => a + c.discountAmount, 0);
+  const taxAmount = children.reduce((a, c) => a + c.taxAmount, 0);
+  const grossAmount = children.reduce((a, c) => a + c.grossAmount, 0);
+  const copayAmount = children.reduce((a, c) => a + c.copayAmount, 0);
+  const patientRawTotal = grossAmount - copayAmount;
+  let masterExtraApplied = 0;
+  if (masterExtra.mode === "PERCENTAGE") {
+    masterExtraApplied = percentage(patientRawTotal, masterExtra.value);
+  } else if (masterExtra.mode === "AMOUNT") {
+    masterExtraApplied = Math.min(masterExtra.value, patientRawTotal);
+  }
+  masterExtraApplied = maybeStep(masterExtraApplied, stepwise, headFmt, precision);
+  const discountTotalAmount = maybeStep(itemDiscountSum + masterExtraApplied, stepwise, headFmt, precision);
+  const patientAfterExtra = applyRound(Math.max(0, patientRawTotal - masterExtraApplied), "TO_FIXED", 2);
+  const netAmount = applyRound(patientAfterExtra, headFmt, precision);
+  const roundOffAmount = netAmount - patientAfterExtra;
+  const master = {
+    additionalDiscountMode: masterExtra.mode,
+    additionalDiscountValue: masterExtra.value,
+    subtotalAmount: applyRound(subtotalAmount, headFmt, precision),
+    otherChargeAmount: applyRound(otherChargeAmount, headFmt, precision),
+    discountTotalAmount: applyRound(discountTotalAmount, headFmt, precision),
+    // includes master extra
+    taxAmount: applyRound(taxAmount, headFmt, precision),
+    grossAmount: applyRound(grossAmount, headFmt, precision),
+    netAmount,
+    // patient payable after master extra + rounding
+    roundOffAmount: applyRound(roundOffAmount, "TO_FIXED", 2),
+    // rounded - raw
+    copayAmount: applyRound(copayAmount, headFmt, precision)
+    // Σ line copay (insurer covered)
+  };
+  return { master, children };
+}
+function calculateSingleChild(it, coPayMode, options = {}) {
+  const stepwise = options.calculationMethod === "STEP_WISE";
+  const lineFmt = options.lineRound ?? RoundFormat.TO_FIXED;
+  const precision = options.precision ?? 2;
+  let baseRate = it.rate;
+  if (it.addonPercentage) {
+    baseRate = baseRate + percentage(baseRate, it.addonPercentage);
+    baseRate = applyRound(baseRate, lineFmt, precision);
+  }
+  const subtotal = applyRound(it.qty * baseRate, lineFmt, precision);
+  const other = applyRound(it.otherCharge ?? 0, lineFmt, precision);
+  const basePreTax = applyRound(subtotal + other, lineFmt, precision);
+  let copayAmount = 0;
+  if (coPayMode === "PERCENTAGE-AMOUNT") {
+    const copayType = it.coPaymentType ?? "AMOUNT";
+    const copayValue = it.coPayValue ?? 0;
+    copayAmount = copayType === "PERCENTAGE" ? percentage(subtotal, copayValue) : Math.min(copayValue, subtotal);
+  }
+  const dMode = it.discountMode ?? "AMOUNT";
+  const dVal = it.discountValue ?? 0;
+  const tMethod = it.taxMethod ?? "NONE";
+  const tVal = Math.max(0, it.taxValue ?? 0);
+  let baseAfterTaxDisc = basePreTax;
+  if (tMethod === "INCLUSIVE") {
+    const inclusiveTaxMultiplier = (100 + tVal) / 100;
+    baseAfterTaxDisc = basePreTax / inclusiveTaxMultiplier;
+  }
+  baseAfterTaxDisc = maybeStep(baseAfterTaxDisc, stepwise, lineFmt, precision);
+  const inclDiff = applyRound(basePreTax - baseAfterTaxDisc, lineFmt, precision);
+  let discountValue = 0;
+  if (dMode === "AMOUNT") {
+    discountValue = dVal;
+  } else if (dMode === "PERCENTAGE") {
+    discountValue = percentage(baseAfterTaxDisc, dVal);
+  }
+  discountValue = maybeStep(discountValue, stepwise, lineFmt, precision);
+  let afterDisc = Math.max(0, baseAfterTaxDisc - discountValue);
+  afterDisc = maybeStep(afterDisc, stepwise, lineFmt, precision);
+  let calculatedTax = percentage(afterDisc, tVal);
+  calculatedTax = maybeStep(calculatedTax, stepwise, lineFmt, precision);
+  let grossAmount = afterDisc + calculatedTax;
+  grossAmount = maybeStep(grossAmount, stepwise, lineFmt, precision);
+  if (coPayMode === "EXCLUSIVE-INCLUSIVE" && it.coPayMethod === "INCLUSIVE") {
+    copayAmount = grossAmount;
+  }
+  copayAmount = applyRound(copayAmount, lineFmt, precision);
+  const copay = clamp(Math.max(0, copayAmount), 0, grossAmount);
+  const patientRaw = applyRound(grossAmount - copay, RoundFormat.TO_FIXED, 2);
+  const patientRounded = applyRound(patientRaw, lineFmt, precision);
+  const lineRoundOff = applyRound(patientRounded - patientRaw, RoundFormat.TO_FIXED, 2);
+  return {
+    // include baseRate if your ChildCalculated type has it (as in your bulk function)
+    baseRate: applyRound(baseRate, lineFmt, precision),
+    subtotalAmount: applyRound(subtotal + other - inclDiff, lineFmt, precision),
+    otherChargeAmount: other,
+    discountMode: dMode,
+    discountValue: dVal,
+    discountAmount: applyRound(discountValue, lineFmt, precision),
+    taxMethod: tMethod,
+    taxValue: tVal,
+    taxAmount: applyRound(calculatedTax, lineFmt, precision),
+    grossAmount: applyRound(grossAmount, lineFmt, precision),
+    netAmount: patientRounded,
+    roundOffAmount: lineRoundOff,
+    copayAmount: copay
+  };
+}
+
+// src/utils/audit.utils.ts
+function isValidDate(value) {
+  if (value instanceof Date) {
+    return !isNaN(value.getTime());
+  }
+  if (typeof value === "string" || typeof value === "number") {
+    const parsed = new Date(value);
+    return !isNaN(parsed.getTime());
+  }
+  return false;
+}
+function flattenObject(obj, parentKey = "") {
+  const result = {};
+  for (const key of Object.keys(obj)) {
+    const raw = obj[key];
+    const newKey = parentKey ? `${parentKey}_${key}` : key;
+    if (typeof raw !== "number" && isValidDate(raw)) {
+      const date = raw instanceof Date ? raw : new Date(raw);
+      result[newKey] = date.toISOString().split("T")[0];
+      continue;
+    }
+    if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+      Object.assign(result, flattenObject(raw, newKey));
+      continue;
+    }
+    result[newKey] = raw;
+  }
+  return result;
+}
+function findDifferences(obj1, obj2) {
+  const flatObj1 = flattenObject(obj1);
+  const flatObj2 = flattenObject(obj2);
+  const differences = [];
+  const allKeys = /* @__PURE__ */ new Set([...Object.keys(flatObj1)]);
+  allKeys.forEach((key) => {
+    if (flatObj1[key] !== flatObj2[key]) {
+      differences.push({
+        // Replace underscores with spaces for a nicer field output
+        field: key.replace(/_/g, " "),
+        changedFrom: typeof flatObj1[key] !== "string" ? JSON.stringify(flatObj1[key]) : flatObj1[key],
+        changedTo: typeof flatObj2[key] !== "string" ? JSON.stringify(flatObj2[key]) : flatObj2[key]
+      });
+    }
+  });
+  return differences;
+}
+export {
+  RoundFormat,
+  calculateBillingFromChildren,
+  calculateSingleChild,
+  customOmit,
+  findDifferences,
+  getDynamicValue,
+  getPattern,
+  interpolate,
+  objectTo2DArray,
+  toNumberOrNull
+};

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "av6-utils",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "description": "All utility function for av6 node js projects.",
+  "author": "Aniket Sarkar",
+  "license": "ISC",
+  "scripts": {
+    "build": "npm run format && tsup",
+    "format": "prettier --write **/*.ts"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {},
+  "dependencies": {
+    "prettier": "^3.6.2"
+  }
+}