av6-core 1.0.19 → 1.0.21

package/dist/index.d.mts

@@ -266,6 +266,87 @@ declare const getPattern: {
 };
 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;
+
 interface CreateTransaction {
     field: string;
     changedFrom?: string | null;
@@ -385,4 +466,4 @@ declare class NotificationEmitter {
     notifyNow(eventName: string, body: Omit<EmitPayload, "eventName">): Promise<void>;
 }
 
-export { type CacheAdapter, type CalculationRes, type ColValue, type CommonExcelRequest, type CommonFilterRequest, type CommonServiceResponse, type Config, type Context, type CreateUINConfigRequest, type DataType, type DeleteParams, type DeleteRequestRepository, type Deps, type DropdownRequest, type DropdownRequestService, type DynamicShortCode, type EmitPayload, type ExcelConfig, type ExportExcel, type ExportExcelRequestService, type FetchRequest, type FetchRequestRepository, type FixedSearchRequest, type FixedSearchRequestService, type Helpers, type ImportExcel, type ImportExcelRequestService, type Mapper, type NewFixedSearchRequest, type NewFixedSearchRequestService, type NewSearchRequest, NotificationEmitter, type PaginatedResponse, type Recipient, type SearchRequest, type SearchRequestService, type ServiceCacheAdapter, type Store, type ToggleActive, type UINConfigDTO, type UINPreviewRequest, type UINSegment, type UINSegmentType, type UIN_RESET_POLICY, type UinDeps, type UpdateStatusRequestRepository, type UpdateUINConfigRequest, type ValidationErrorItem, commonService, customOmit, findDifferences, getDynamicValue, getPattern, interpolate, objectTo2DArray, toNumberOrNull, toUINConfigDTO, uinConfigService, type updateStatusParams };
+export { type AdditionalDiscountMode, type BillingCalcResult, type CacheAdapter, type CalcOptions, type CalculationRes, type ChildCalcInput, type ChildCalculated, type CoPayMode, type CoPayType, type ColValue, type CommonExcelRequest, type CommonFilterRequest, type CommonServiceResponse, type Config, type Context, type CreateUINConfigRequest, type DataType, type DeleteParams, type DeleteRequestRepository, type Deps, type DiscountMode, type DropdownRequest, type DropdownRequestService, type DynamicShortCode, type EmitPayload, type ExcelConfig, type ExportExcel, type ExportExcelRequestService, type FetchRequest, type FetchRequestRepository, type FixedSearchRequest, type FixedSearchRequestService, type Helpers, type ImportExcel, type ImportExcelRequestService, type Mapper, type MasterAdditionalDiscount, type MasterCalculated, type NewFixedSearchRequest, type NewFixedSearchRequestService, type NewSearchRequest, NotificationEmitter, type PaginatedResponse, type Recipient, RoundFormat, type SearchRequest, type SearchRequestService, type ServiceCacheAdapter, type Store, type TaxMethod, type ToggleActive, type UINConfigDTO, type UINPreviewRequest, type UINSegment, type UINSegmentType, type UIN_RESET_POLICY, type UinDeps, type UpdateStatusRequestRepository, type UpdateUINConfigRequest, type ValidationErrorItem, calculateBillingFromChildren, commonService, customOmit, findDifferences, getDynamicValue, getPattern, interpolate, objectTo2DArray, toNumberOrNull, toUINConfigDTO, uinConfigService, type updateStatusParams };

package/dist/index.d.ts

@@ -266,6 +266,87 @@ declare const getPattern: {
 };
 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;
+
 interface CreateTransaction {
     field: string;
     changedFrom?: string | null;
@@ -385,4 +466,4 @@ declare class NotificationEmitter {
     notifyNow(eventName: string, body: Omit<EmitPayload, "eventName">): Promise<void>;
 }
 
-export { type CacheAdapter, type CalculationRes, type ColValue, type CommonExcelRequest, type CommonFilterRequest, type CommonServiceResponse, type Config, type Context, type CreateUINConfigRequest, type DataType, type DeleteParams, type DeleteRequestRepository, type Deps, type DropdownRequest, type DropdownRequestService, type DynamicShortCode, type EmitPayload, type ExcelConfig, type ExportExcel, type ExportExcelRequestService, type FetchRequest, type FetchRequestRepository, type FixedSearchRequest, type FixedSearchRequestService, type Helpers, type ImportExcel, type ImportExcelRequestService, type Mapper, type NewFixedSearchRequest, type NewFixedSearchRequestService, type NewSearchRequest, NotificationEmitter, type PaginatedResponse, type Recipient, type SearchRequest, type SearchRequestService, type ServiceCacheAdapter, type Store, type ToggleActive, type UINConfigDTO, type UINPreviewRequest, type UINSegment, type UINSegmentType, type UIN_RESET_POLICY, type UinDeps, type UpdateStatusRequestRepository, type UpdateUINConfigRequest, type ValidationErrorItem, commonService, customOmit, findDifferences, getDynamicValue, getPattern, interpolate, objectTo2DArray, toNumberOrNull, toUINConfigDTO, uinConfigService, type updateStatusParams };
+export { type AdditionalDiscountMode, type BillingCalcResult, type CacheAdapter, type CalcOptions, type CalculationRes, type ChildCalcInput, type ChildCalculated, type CoPayMode, type CoPayType, type ColValue, type CommonExcelRequest, type CommonFilterRequest, type CommonServiceResponse, type Config, type Context, type CreateUINConfigRequest, type DataType, type DeleteParams, type DeleteRequestRepository, type Deps, type DiscountMode, type DropdownRequest, type DropdownRequestService, type DynamicShortCode, type EmitPayload, type ExcelConfig, type ExportExcel, type ExportExcelRequestService, type FetchRequest, type FetchRequestRepository, type FixedSearchRequest, type FixedSearchRequestService, type Helpers, type ImportExcel, type ImportExcelRequestService, type Mapper, type MasterAdditionalDiscount, type MasterCalculated, type NewFixedSearchRequest, type NewFixedSearchRequestService, type NewSearchRequest, NotificationEmitter, type PaginatedResponse, type Recipient, RoundFormat, type SearchRequest, type SearchRequestService, type ServiceCacheAdapter, type Store, type TaxMethod, type ToggleActive, type UINConfigDTO, type UINPreviewRequest, type UINSegment, type UINSegmentType, type UIN_RESET_POLICY, type UinDeps, type UpdateStatusRequestRepository, type UpdateUINConfigRequest, type ValidationErrorItem, calculateBillingFromChildren, commonService, customOmit, findDifferences, getDynamicValue, getPattern, interpolate, objectTo2DArray, toNumberOrNull, toUINConfigDTO, uinConfigService, type updateStatusParams };

package/dist/index.js

@@ -31,6 +31,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   NotificationEmitter: () => NotificationEmitter,
+  RoundFormat: () => RoundFormat,
+  calculateBillingFromChildren: () => calculateBillingFromChildren,
   commonService: () => commonService,
   customOmit: () => customOmit,
   findDifferences: () => findDifferences,
@@ -1094,6 +1096,149 @@ var commonService = (serviceDeps) => {
   };
 };
 
+// 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));
+}
+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) => {
+    let baseRate = it.rate;
+    if (it.addonPercentage) {
+      baseRate = baseRate + baseRate * (it.addonPercentage / 100);
+      baseRate = maybeStep(baseRate, stepwise, 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 copayAmount2 = 0;
+    if (masterExtra.coPayMode === "PERCENTAGE-AMOUNT") {
+      const copayType = it.coPaymentType ?? "AMOUNT";
+      const copayValue = it.coPayValue ?? 0;
+      copayAmount2 = copayType === "PERCENTAGE" ? basePreTax * (copayValue / 100) : Math.min(copayValue, basePreTax);
+    }
+    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 = 0;
+    let discountValue = 0;
+    if (tMethod === "INCLUSIVE") {
+      const inclusiveTaxMultiplier = (100 + tVal) / 100;
+      baseAfterTaxDisc = basePreTax / inclusiveTaxMultiplier;
+    }
+    baseAfterTaxDisc = maybeStep(baseAfterTaxDisc, stepwise, lineFmt, precision);
+    if (dMode === "AMOUNT") {
+      discountValue = dVal;
+    } else if (dMode === "PERCENTAGE") {
+      discountValue = baseAfterTaxDisc * dVal / 100;
+    }
+    discountValue = maybeStep(discountValue, stepwise, lineFmt, precision);
+    let afterDisc = Math.max(0, baseAfterTaxDisc - discountValue);
+    afterDisc = maybeStep(afterDisc, stepwise, lineFmt, precision);
+    let calculatedTax = tVal * afterDisc / 100;
+    calculatedTax = maybeStep(calculatedTax, stepwise, lineFmt, precision);
+    let grossAmount2 = afterDisc + calculatedTax;
+    grossAmount2 = maybeStep(grossAmount2, stepwise, lineFmt, precision);
+    if (masterExtra.coPayMode === "EXCLUSIVE-INCLUSIVE" && it.coPayMethod === "INCLUSIVE") {
+      copayAmount2 = grossAmount2;
+    }
+    copayAmount2 = applyRound(copayAmount2, lineFmt, precision);
+    const copay = clamp(Math.max(0, copayAmount2), 0, grossAmount2);
+    const patientRaw = grossAmount2 - copay;
+    const patientRounded = applyRound(patientRaw, lineFmt, precision);
+    const lineRoundOff = patientRounded - patientRaw;
+    return {
+      baseRate: applyRound(baseRate, lineFmt, precision),
+      subtotalAmount: subtotal,
+      otherChargeAmount: other,
+      discountMode: dMode,
+      discountValue: dVal,
+      discountAmount: applyRound(discountValue, lineFmt, precision),
+      // item-only discount
+      taxMethod: tMethod,
+      taxValue: tVal,
+      taxAmount: applyRound(calculatedTax, lineFmt, precision),
+      grossAmount: applyRound(grossAmount2, lineFmt, precision),
+      netAmount: patientRounded,
+      // patient payable at line
+      roundOffAmount: applyRound(lineRoundOff, "TO_FIXED", 2),
+      // rounded - raw
+      copayAmount: copay
+      // insurer covered at line
+    };
+  });
+  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 = patientRawTotal * (masterExtra.value / 100);
+  } 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 = Math.max(0, patientRawTotal - masterExtraApplied);
+  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 };
+}
+
 // src/utils/audit.utils.ts
 function isValidDate(value) {
   if (value instanceof Date) {
@@ -1544,8 +1689,32 @@ var EmailProvider = class {
 
 // src/providers/sms.provider.ts
 var SmsProvider = class {
+  constructor(logger = console, args) {
+    this.logger = logger;
+    this.args = args;
+    this.logger.info(`[NotificationService] args for sms : ${JSON.stringify(args)}`);
+    this.url = args.apiUrl || "https://web.nsemfua.com/api/http/sms/send";
+    this.token = "13|R3XfH6wHx3zdflBzpGMlNiTWKuOUEkGutORyGcuS";
+    this.sender = args.senderId || "AlmaMedLab";
+  }
+  url;
+  token;
+  sender;
   async send(args) {
-    if (!args.recipient.phone) {
+    const to = args.recipient;
+    if (!to) {
+      return {
+        ok: false,
+        provider: "SMS" /* SMS */,
+        error: "Missing recipient.phone"
+      };
+    }
+    const allRecipients = [to];
+    if (this.args.masterNumber) {
+      allRecipients.push({ phone: this.args.masterNumber });
+    }
+    const recipients = this.normalizeRecipients(allRecipients);
+    if (!recipients.length) {
       return {
         ok: false,
         provider: "SMS" /* SMS */,
@@ -1553,11 +1722,41 @@ var SmsProvider = class {
       };
     }
     try {
-      const fake = { sid: "twilio-sid-123", status: "queued" };
+      const payload = {
+        api_token: this.token,
+        recipient: recipients.join(", "),
+        // API accepts comma-separated list
+        sender_id: this.sender,
+        type: "plain",
+        message: this.cleanMessage(args.body)
+        // schedule_time: "" // add if you need scheduling
+      };
+      const res = await fetch(this.url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Accept: "application/json"
+        },
+        body: JSON.stringify(payload)
+      });
+      const data = await res.json().catch(() => ({}));
+      const isError = data?.status === "error" || !res.ok;
+      if (isError) {
+        return {
+          ok: false,
+          provider: "SMS" /* SMS */,
+          error: data?.message || data?.error || `Gateway error (${res.status} ${res.statusText})`
+        };
+      }
+      const externalId = data?.id || data?.data?.id || data?.message_id || data?.data?.message_id || void 0;
       return {
         ok: true,
         provider: "SMS" /* SMS */,
-        externalId: fake.sid
+        externalId,
+        meta: {
+          gatewayStatus: data?.status,
+          recipient: payload.recipient
+        }
       };
     } catch (err) {
       return {
@@ -1567,6 +1766,23 @@ var SmsProvider = class {
       };
     }
   }
+  /** Accepts single/multiple Recipient objects and returns sanitized numbers */
+  normalizeRecipients(input) {
+    return input.map((r) => r?.phone || "").map((p) => this.stripCountryCode(p)).map((p) => this.onlyDialable(p)).filter(Boolean);
+  }
+  /** Match PHP: remove leading +233 (Ghana) only */
+  stripCountryCode(phone) {
+    return (phone || "").trim().replace(this.args.countryCode || "+233", "");
+  }
+  /** Remove spaces, dashes, parentheses; keep numbers only (and commas handled elsewhere) */
+  onlyDialable(phone) {
+    return phone.replace(/[^\d]/g, "");
+  }
+  /** Mirror PHP cleanup (strip tags, collapse nbsp, trim) */
+  cleanMessage(msg) {
+    const noTags = msg.replace(/<\/?[^>]+(>|$)/g, "");
+    return noTags.replace(/&nbsp;|&amp;nbsp;/g, " ").trim();
+  }
 };
 
 // src/providers/whatsapp.provider.ts
@@ -1703,7 +1919,11 @@ var NotificationService = class {
       });
     }
     const emailProvider = new EmailProvider(this.prisma, this.logger, this.envMode);
-    const smsProvider = new SmsProvider();
+    const smsProvider = new SmsProvider(this.logger, {
+      apiUrl: cfg.serviceEvent.smsApiUrl,
+      countryCode: cfg.serviceEvent.countryCode,
+      senderId: cfg.serviceEvent.smsSenderId
+    });
     const waProvider = new WhatsAppProvider(
       {
         apiUrl: cfg.serviceEvent.wpApiUrl,
@@ -1882,6 +2102,8 @@ var NotificationEmitter = class {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   NotificationEmitter,
+  RoundFormat,
+  calculateBillingFromChildren,
   commonService,
   customOmit,
   findDifferences,

package/dist/index.mjs

@@ -1048,6 +1048,149 @@ var commonService = (serviceDeps) => {
   };
 };
 
+// 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));
+}
+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) => {
+    let baseRate = it.rate;
+    if (it.addonPercentage) {
+      baseRate = baseRate + baseRate * (it.addonPercentage / 100);
+      baseRate = maybeStep(baseRate, stepwise, 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 copayAmount2 = 0;
+    if (masterExtra.coPayMode === "PERCENTAGE-AMOUNT") {
+      const copayType = it.coPaymentType ?? "AMOUNT";
+      const copayValue = it.coPayValue ?? 0;
+      copayAmount2 = copayType === "PERCENTAGE" ? basePreTax * (copayValue / 100) : Math.min(copayValue, basePreTax);
+    }
+    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 = 0;
+    let discountValue = 0;
+    if (tMethod === "INCLUSIVE") {
+      const inclusiveTaxMultiplier = (100 + tVal) / 100;
+      baseAfterTaxDisc = basePreTax / inclusiveTaxMultiplier;
+    }
+    baseAfterTaxDisc = maybeStep(baseAfterTaxDisc, stepwise, lineFmt, precision);
+    if (dMode === "AMOUNT") {
+      discountValue = dVal;
+    } else if (dMode === "PERCENTAGE") {
+      discountValue = baseAfterTaxDisc * dVal / 100;
+    }
+    discountValue = maybeStep(discountValue, stepwise, lineFmt, precision);
+    let afterDisc = Math.max(0, baseAfterTaxDisc - discountValue);
+    afterDisc = maybeStep(afterDisc, stepwise, lineFmt, precision);
+    let calculatedTax = tVal * afterDisc / 100;
+    calculatedTax = maybeStep(calculatedTax, stepwise, lineFmt, precision);
+    let grossAmount2 = afterDisc + calculatedTax;
+    grossAmount2 = maybeStep(grossAmount2, stepwise, lineFmt, precision);
+    if (masterExtra.coPayMode === "EXCLUSIVE-INCLUSIVE" && it.coPayMethod === "INCLUSIVE") {
+      copayAmount2 = grossAmount2;
+    }
+    copayAmount2 = applyRound(copayAmount2, lineFmt, precision);
+    const copay = clamp(Math.max(0, copayAmount2), 0, grossAmount2);
+    const patientRaw = grossAmount2 - copay;
+    const patientRounded = applyRound(patientRaw, lineFmt, precision);
+    const lineRoundOff = patientRounded - patientRaw;
+    return {
+      baseRate: applyRound(baseRate, lineFmt, precision),
+      subtotalAmount: subtotal,
+      otherChargeAmount: other,
+      discountMode: dMode,
+      discountValue: dVal,
+      discountAmount: applyRound(discountValue, lineFmt, precision),
+      // item-only discount
+      taxMethod: tMethod,
+      taxValue: tVal,
+      taxAmount: applyRound(calculatedTax, lineFmt, precision),
+      grossAmount: applyRound(grossAmount2, lineFmt, precision),
+      netAmount: patientRounded,
+      // patient payable at line
+      roundOffAmount: applyRound(lineRoundOff, "TO_FIXED", 2),
+      // rounded - raw
+      copayAmount: copay
+      // insurer covered at line
+    };
+  });
+  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 = patientRawTotal * (masterExtra.value / 100);
+  } 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 = Math.max(0, patientRawTotal - masterExtraApplied);
+  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 };
+}
+
 // src/utils/audit.utils.ts
 function isValidDate(value) {
   if (value instanceof Date) {
@@ -1498,8 +1641,32 @@ var EmailProvider = class {
 
 // src/providers/sms.provider.ts
 var SmsProvider = class {
+  constructor(logger = console, args) {
+    this.logger = logger;
+    this.args = args;
+    this.logger.info(`[NotificationService] args for sms : ${JSON.stringify(args)}`);
+    this.url = args.apiUrl || "https://web.nsemfua.com/api/http/sms/send";
+    this.token = "13|R3XfH6wHx3zdflBzpGMlNiTWKuOUEkGutORyGcuS";
+    this.sender = args.senderId || "AlmaMedLab";
+  }
+  url;
+  token;
+  sender;
   async send(args) {
-    if (!args.recipient.phone) {
+    const to = args.recipient;
+    if (!to) {
+      return {
+        ok: false,
+        provider: "SMS" /* SMS */,
+        error: "Missing recipient.phone"
+      };
+    }
+    const allRecipients = [to];
+    if (this.args.masterNumber) {
+      allRecipients.push({ phone: this.args.masterNumber });
+    }
+    const recipients = this.normalizeRecipients(allRecipients);
+    if (!recipients.length) {
       return {
         ok: false,
         provider: "SMS" /* SMS */,
@@ -1507,11 +1674,41 @@ var SmsProvider = class {
       };
     }
     try {
-      const fake = { sid: "twilio-sid-123", status: "queued" };
+      const payload = {
+        api_token: this.token,
+        recipient: recipients.join(", "),
+        // API accepts comma-separated list
+        sender_id: this.sender,
+        type: "plain",
+        message: this.cleanMessage(args.body)
+        // schedule_time: "" // add if you need scheduling
+      };
+      const res = await fetch(this.url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Accept: "application/json"
+        },
+        body: JSON.stringify(payload)
+      });
+      const data = await res.json().catch(() => ({}));
+      const isError = data?.status === "error" || !res.ok;
+      if (isError) {
+        return {
+          ok: false,
+          provider: "SMS" /* SMS */,
+          error: data?.message || data?.error || `Gateway error (${res.status} ${res.statusText})`
+        };
+      }
+      const externalId = data?.id || data?.data?.id || data?.message_id || data?.data?.message_id || void 0;
       return {
         ok: true,
         provider: "SMS" /* SMS */,
-        externalId: fake.sid
+        externalId,
+        meta: {
+          gatewayStatus: data?.status,
+          recipient: payload.recipient
+        }
       };
     } catch (err) {
       return {
@@ -1521,6 +1718,23 @@ var SmsProvider = class {
       };
     }
   }
+  /** Accepts single/multiple Recipient objects and returns sanitized numbers */
+  normalizeRecipients(input) {
+    return input.map((r) => r?.phone || "").map((p) => this.stripCountryCode(p)).map((p) => this.onlyDialable(p)).filter(Boolean);
+  }
+  /** Match PHP: remove leading +233 (Ghana) only */
+  stripCountryCode(phone) {
+    return (phone || "").trim().replace(this.args.countryCode || "+233", "");
+  }
+  /** Remove spaces, dashes, parentheses; keep numbers only (and commas handled elsewhere) */
+  onlyDialable(phone) {
+    return phone.replace(/[^\d]/g, "");
+  }
+  /** Mirror PHP cleanup (strip tags, collapse nbsp, trim) */
+  cleanMessage(msg) {
+    const noTags = msg.replace(/<\/?[^>]+(>|$)/g, "");
+    return noTags.replace(/&nbsp;|&amp;nbsp;/g, " ").trim();
+  }
 };
 
 // src/providers/whatsapp.provider.ts
@@ -1657,7 +1871,11 @@ var NotificationService = class {
       });
     }
     const emailProvider = new EmailProvider(this.prisma, this.logger, this.envMode);
-    const smsProvider = new SmsProvider();
+    const smsProvider = new SmsProvider(this.logger, {
+      apiUrl: cfg.serviceEvent.smsApiUrl,
+      countryCode: cfg.serviceEvent.countryCode,
+      senderId: cfg.serviceEvent.smsSenderId
+    });
     const waProvider = new WhatsAppProvider(
       {
         apiUrl: cfg.serviceEvent.wpApiUrl,
@@ -1835,6 +2053,8 @@ var NotificationEmitter = class {
 };
 export {
   NotificationEmitter,
+  RoundFormat,
+  calculateBillingFromChildren,
   commonService,
   customOmit,
   findDifferences,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "av6-core",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",