@autologix-engineering/shared 1.2.263 → 1.2.265

package/src/lib/utilities/src/calculate.deducted.sharing.amount.js

@@ -0,0 +1,293 @@
+import { BenchmarkRateField, BusinessContextOwnerField, ClientPersonaField, InstantInvoiceBodyField, NumberedInvoiceField, NumberedInvoiceLineItemField, OrganizationField, RequestField, RuleCategoryField, TaxInvoiceField, VendorDeductionRuleField, VendorGlobalRulesField, } from '../../models/src/index';
+import { BillingType, BillTo, InvoiceType, RequestType, TripBillingDistanceNewEnum, } from '../../enums/src/index';
+/**
+ * Group a flat rules array by `BillingType` so the helper can do a single
+ * Map lookup per booking instead of filtering the whole array each time.
+ * Idempotent: rules with no BillingType land in their own (undefined-keyed)
+ * bucket which the helper's lookup never asks for, so they're skipped.
+ */
+export function groupDeductionRulesByBillingType(rules) {
+    const map = new Map();
+    for (const rule of rules) {
+        const key = rule?.[VendorDeductionRuleField.BillingType];
+        if (key == null)
+            continue;
+        const bucket = map.get(key);
+        if (bucket)
+            bucket.push(rule);
+        else
+            map.set(key, [rule]);
+    }
+    return map;
+}
+/**
+ * Compute the BA payout sharing amount for one booking, applying:
+ *   1. Benchmark-based deduction (percentage band, looked up from
+ *      `percentageRulesMap` by booking's BillingType).
+ *   2. Vendor global-rule deductions (per-component flat + percentage).
+ *   3. Client / garage / signup-city exemptions.
+ *
+ * Sign-aware for credit notes: when the source amount is negative,
+ * benchmark deduction magnitude uses `Math.abs` and is applied with the
+ * matching sign so an original-vs-CN pair nets symmetrically. Final
+ * clamp at 0 applies only to positive originals (CN rows stay signed).
+ *
+ * Side effect: appends to `book.Deductions[]` so the caller can render the
+ * per-line deduction breakdown. The function does NOT assign to
+ * `book.SharingAmount` — callers do that after the call if they want it.
+ *
+ * Lifted verbatim from the duplicated private methods on
+ * CalculateBusinessAssociatePayoutRowsController and
+ * ExportBAPayoutReportController. Two pre-existing cosmetic differences
+ * harmonised here:
+ *   - Fallback `invoice.SharingAmount` only triggers when all three of
+ *     BaseCost/ExtraKmCost/ExtraHrCost are null (the calculate path's
+ *     stricter `== null` check, not export's `!x` which also matched 0).
+ *   - Rules parameter is a Map keyed by BillingType (the export path's
+ *     pre-grouped shape). Use `groupDeductionRulesByBillingType` to convert.
+ */
+export function calculateDeductedSharingAmount(book, options) {
+    const { defaultDeduction, benchmarkMap, percentageRulesMap, exemptedClients, exemptedGarages, globalRules, exemptedSignupCityIds, debug, } = options;
+    // Reset Deductions unconditionally so the function is idempotent across
+    // retries and pre-populated bookings. Callers used to do this manually
+    // (or not at all, depending on which controller). The helper owns the
+    // invariant now.
+    book[RequestField.Deductions] = [];
+    // Get cost components: prefer invoice fields when an invoice is present,
+    // fall back to booking fields for non-invoiced bookings
+    const invoice = book?.[RequestField.Invoices]?.[0];
+    let baseCost;
+    let extraKmCost;
+    let extraHrCost;
+    if (invoice && !invoice?.[TaxInvoiceField.Consolidated]) {
+        baseCost = Number(invoice?.[TaxInvoiceField.BaseCost] ?? 0);
+        extraKmCost = Number(invoice?.[TaxInvoiceField.ExtraKmCost] ?? 0);
+        extraHrCost = Number(invoice?.[TaxInvoiceField.ExtraHrCost] ?? 0);
+        // Fallback: if invoice components not stored, use invoice SharingAmount
+        if (invoice?.[TaxInvoiceField.BaseCost] == null &&
+            invoice?.[TaxInvoiceField.ExtraKmCost] == null &&
+            invoice?.[TaxInvoiceField.ExtraHrCost] == null) {
+            baseCost = invoice?.[TaxInvoiceField.SharingAmount] || 0;
+        }
+    }
+    else {
+        baseCost = Number(book?.[RequestField.BaseCost] ?? 0);
+        extraKmCost = Number(book?.[RequestField.ExtraKmCost] ?? 0);
+        extraHrCost = Number(book?.[RequestField.ExtraHrCost] ?? 0);
+        // Fallback: if booking components not stored, use booking SharingAmount
+        if (book?.[RequestField.BaseCost] == null &&
+            book?.[RequestField.ExtraKmCost] == null &&
+            book?.[RequestField.ExtraHrCost] == null) {
+            baseCost = book?.[RequestField.SharingAmount] || 0;
+        }
+        if (!invoice) {
+            // Skip deductions for non-invoiced bookings
+            return Number((baseCost + extraKmCost + extraHrCost).toFixed(2));
+        }
+    }
+    // Consolidated CN/DN: cost components above came from `book.*` fields
+    // (positive originals), so flip at entry to express the cancellation.
+    // Covers both full-cancel and partial CN/DN — for partial the magnitude
+    // is over-stated (full original instead of partial reversal), but the
+    // sign is correct, which matches BA-report behaviour. Non-consolidated
+    // CN/DN already carry signed BaseCost/ExtraKmCost/ExtraHrCost on the
+    // TI itself; the invoice branch above picks up the negative directly,
+    // no flip needed for that path. Sign carries through deductions, global
+    // rules, and the final return.
+    const isCNOrDN = invoice?.[TaxInvoiceField.InvoiceType] === InvoiceType.CreditNote ||
+        invoice?.[TaxInvoiceField.InvoiceType] === InvoiceType.DebitNote;
+    const isConsolidatedCNDN = !!invoice && !!invoice?.[TaxInvoiceField.Consolidated] && isCNOrDN;
+    if (isConsolidatedCNDN) {
+        baseCost = -baseCost;
+        extraKmCost = -extraKmCost;
+        extraHrCost = -extraHrCost;
+    }
+    // Keep original amounts; compute each deduction separately, then subtract all at end
+    const originalBaseCost = baseCost;
+    const originalExtraKmCost = extraKmCost;
+    const originalExtraHrCost = extraHrCost;
+    const baseCostForDeduction = originalBaseCost + originalExtraKmCost + originalExtraHrCost;
+    let totalBaseDeduction = 0;
+    let totalExtraKmDeduction = 0;
+    let totalExtraHrDeduction = 0;
+    // Benchmark-based deduction: applies to baseCost only (from original)
+    let deductionPercent = defaultDeduction;
+    let bookingBillType;
+    if (invoice && !invoice?.[TaxInvoiceField.Consolidated]) {
+        bookingBillType =
+            invoice?.[TaxInvoiceField.ClientPersona]?.[ClientPersonaField.BillingMethods]?.[ClientPersonaField.DefaultBillingType];
+    }
+    else {
+        bookingBillType =
+            book?.[RequestField.NumberedInvoices]?.[0]?.[NumberedInvoiceField.InstantInvoiceBody]?.[InstantInvoiceBodyField.DistanceType];
+    }
+    debug?.(`[deduction] invoice NIs present: ${!!invoice?.[TaxInvoiceField.NumberedInvoices]?.length}`);
+    if (invoice &&
+        invoice?.[TaxInvoiceField.Consolidated] &&
+        invoice?.[TaxInvoiceField.NumberedInvoices]?.length > 0) {
+        bookingBillType = invoice?.[TaxInvoiceField.NumberedInvoices]?.find((e) => e?.[NumberedInvoiceField.InstantInvoiceBody]?.[InstantInvoiceBodyField.RequestNumber] === book?.[RequestField.RequestNumber])?.[NumberedInvoiceField.InstantInvoiceBody]?.[InstantInvoiceBodyField.DistanceType];
+    }
+    debug?.(`[deduction] bookingBillType: ${bookingBillType}`);
+    if (bookingBillType == null)
+        bookingBillType = TripBillingDistanceNewEnum.AutomatedGtoG;
+    const billingTypeForLookup = bookingBillType === TripBillingDistanceNewEnum.AutomatedGtoG
+        ? BillingType.GtoG
+        : BillingType.PtoP;
+    const benchMark = benchmarkMap?.get(`${billingTypeForLookup}-${book?.[RequestField.MasterCityId]}-${book?.[RequestField.VehicleGroupId]}-${book?.[RequestField.RequestType]}`);
+    const targetBenchmarkRate = benchMark?.[BenchmarkRateField.BenchMarkRate];
+    debug?.(`[deduction] targetBenchmarkRate: ${targetBenchmarkRate}`);
+    // Retrieve pre-filtered rules for this billing type (no per-booking filter needed)
+    const percentageRules = percentageRulesMap.get(billingTypeForLookup) ?? [];
+    let clientSignedAmount = book?.[RequestField.BenchmarkRate];
+    if (book?.[RequestField.RequestType] === RequestType.AirportTransfer) {
+        if (invoice && !invoice?.[TaxInvoiceField.Consolidated]) {
+            debug?.(`[deduction] airport invoice lineItems count: ${invoice?.[TaxInvoiceField.LineItems]?.length ?? 0}`);
+            clientSignedAmount = invoice?.[TaxInvoiceField.LineItems]?.find((e) => e?.[NumberedInvoiceLineItemField.Description]
+                ?.toLowerCase()
+                ?.includes('base cost'))?.[NumberedInvoiceLineItemField.TotalBeforeTax];
+        }
+        else {
+            clientSignedAmount = book?.[RequestField.NumberedInvoices]?.[0]?.[NumberedInvoiceField.LineItems]?.find((e) => e?.[NumberedInvoiceLineItemField.Description]
+                ?.toLowerCase()
+                ?.includes('base cost'))?.[NumberedInvoiceLineItemField.TotalBeforeTax];
+        }
+        debug?.(`[deduction] clientSignedAmount: ${clientSignedAmount}`);
+        if (invoice &&
+            invoice?.[TaxInvoiceField.Consolidated] &&
+            invoice?.[TaxInvoiceField.NumberedInvoices]?.length > 0) {
+            clientSignedAmount = invoice?.[TaxInvoiceField.NumberedInvoices]
+                ?.find((e) => e?.[NumberedInvoiceField.InstantInvoiceBody]?.[InstantInvoiceBodyField.RequestNumber] === book?.[RequestField.RequestNumber])?.[NumberedInvoiceField.LineItems]
+                ?.find((e) => e?.[NumberedInvoiceLineItemField.Description]
+                ?.toLowerCase()
+                ?.includes('base cost'))?.[NumberedInvoiceLineItemField.TotalBeforeTax];
+        }
+    }
+    if (clientSignedAmount &&
+        targetBenchmarkRate &&
+        percentageRules?.length > 0) {
+        const percentIncrease = clientSignedAmount === 0
+            ? null
+            : ((clientSignedAmount - targetBenchmarkRate) /
+                clientSignedAmount) *
+                100;
+        if (percentIncrease != null && percentIncrease > 0) {
+            const sortedRules = [...percentageRules].sort((a, b) => a?.[VendorDeductionRuleField.RangeStart] -
+                b?.[VendorDeductionRuleField.RangeStart]);
+            const deduction = sortedRules.find((e) => e?.[VendorDeductionRuleField.RangeStart] <=
+                percentIncrease &&
+                percentIncrease <
+                    e?.[VendorDeductionRuleField.RangeEnd]);
+            if (deduction) {
+                deductionPercent =
+                    deduction?.[VendorDeductionRuleField.DeductionPercentage];
+            }
+        }
+        else {
+            deductionPercent = 0;
+        }
+    }
+    if (exemptedClients.includes(book?.[RequestField.ClientPersonaId]) ||
+        exemptedGarages.includes(book?.[RequestField.GarageId])) {
+        deductionPercent = 0;
+    }
+    // For credit notes, baseCost is negative; use abs only when calculating
+    // benchmarkDeductionAmount for correct magnitude
+    if (deductionPercent > 0 && baseCostForDeduction !== 0) {
+        const benchmarkDeductionAmount = Number(((Math.abs(baseCostForDeduction) * deductionPercent) /
+            100).toFixed(2));
+        const signedDeduction = baseCostForDeduction >= 0
+            ? benchmarkDeductionAmount
+            : -benchmarkDeductionAmount;
+        totalBaseDeduction += signedDeduction;
+        book[RequestField.Deductions].push({
+            deductionName: 'Benchmark Deduction',
+            deductionAmount: signedDeduction,
+        });
+    }
+    // Apply vendor global rules deductions per component (each from original amounts)
+    const signupCityId = book?.[RequestField.ClientPersona]?.[ClientPersonaField.SignupCityId];
+    const hasExemption = !!signupCityId && exemptedSignupCityIds.has(signupCityId);
+    const paymentMode = book?.[RequestField.ModeOfPayment];
+    const orgType = book?.[RequestField.ClientPersona]?.[ClientPersonaField.PersonaOf]?.[BusinessContextOwnerField.Organization]?.[OrganizationField.ClientType];
+    const requestType = book?.[RequestField.RequestType];
+    const applicableGlobalRules = hasExemption
+        ? []
+        : globalRules.filter((rule) => (rule[VendorGlobalRulesField.AllCities] ||
+            rule[VendorGlobalRulesField.CityId] ===
+                book?.[RequestField.MasterCityId]) &&
+            (rule[VendorGlobalRulesField.AllClients] ||
+                rule[VendorGlobalRulesField.ClientId] ===
+                    book?.[RequestField.ClientPersonaId]) &&
+            (rule[VendorGlobalRulesField.AllVehicleGroups] ||
+                rule[VendorGlobalRulesField.VehicleGroupId] ===
+                    book?.[RequestField.VehicleGroupId]) &&
+            (rule[VendorGlobalRulesField.AllGarages] ||
+                rule[VendorGlobalRulesField.GarageId] ===
+                    book?.[RequestField.GarageId]) &&
+            (rule[VendorGlobalRulesField.RuleCategory]?.[RuleCategoryField.PaymentMode] === paymentMode ||
+                rule[VendorGlobalRulesField.RuleCategory]?.[RuleCategoryField.PaymentMode] === BillTo.Both) &&
+            rule[VendorGlobalRulesField.RuleCategory]?.[RuleCategoryField.ClientType]?.includes(orgType) &&
+            rule[VendorGlobalRulesField.RequestType]?.includes(requestType));
+    for (const rule of applicableGlobalRules) {
+        let ruleDeductionAmount = 0;
+        // Deduction can stay negative for credit notes; only
+        // benchmarkDeductionAmount uses abs
+        if (rule[VendorGlobalRulesField.BaseCost]) {
+            const d = rule[VendorGlobalRulesField.BaseCost];
+            totalBaseDeduction += d;
+            ruleDeductionAmount += d;
+        }
+        if (rule[VendorGlobalRulesField.BaseCostPercentage]) {
+            const d = Number(((originalBaseCost *
+                rule[VendorGlobalRulesField.BaseCostPercentage]) /
+                100).toFixed(2));
+            totalBaseDeduction += d;
+            ruleDeductionAmount += d;
+        }
+        if (rule[VendorGlobalRulesField.ExtraKm]) {
+            const d = rule[VendorGlobalRulesField.ExtraKm];
+            totalExtraKmDeduction += d;
+            ruleDeductionAmount += d;
+        }
+        if (rule[VendorGlobalRulesField.ExtraKmPercentage]) {
+            const d = Number(((originalExtraKmCost *
+                rule[VendorGlobalRulesField.ExtraKmPercentage]) /
+                100).toFixed(2));
+            totalExtraKmDeduction += d;
+            ruleDeductionAmount += d;
+        }
+        if (rule[VendorGlobalRulesField.ExtraHr]) {
+            const d = rule[VendorGlobalRulesField.ExtraHr];
+            totalExtraHrDeduction += d;
+            ruleDeductionAmount += d;
+        }
+        if (rule[VendorGlobalRulesField.ExtraHrPercentage]) {
+            const d = Number(((originalExtraHrCost *
+                rule[VendorGlobalRulesField.ExtraHrPercentage]) /
+                100).toFixed(2));
+            totalExtraHrDeduction += d;
+            ruleDeductionAmount += d;
+        }
+        book[RequestField.Deductions].push({
+            deductionName: rule[VendorGlobalRulesField.RuleCategory]?.[RuleCategoryField.CategoryName],
+            deductionAmount: Number(ruleDeductionAmount.toFixed(2)),
+        });
+    }
+    // Subtract all deductions at the end (credit notes can be negative;
+    // do not clamp to 0)
+    const rawBaseCost = Number((originalBaseCost - totalBaseDeduction).toFixed(2));
+    const rawExtraKmCost = Number((originalExtraKmCost - totalExtraKmDeduction).toFixed(2));
+    const rawExtraHrCost = Number((originalExtraHrCost - totalExtraHrDeduction).toFixed(2));
+    baseCost =
+        originalBaseCost >= 0 ? Math.max(0, rawBaseCost) : rawBaseCost;
+    extraKmCost =
+        originalExtraKmCost >= 0
+            ? Math.max(0, rawExtraKmCost)
+            : rawExtraKmCost;
+    extraHrCost =
+        originalExtraHrCost >= 0
+            ? Math.max(0, rawExtraHrCost)
+            : rawExtraHrCost;
+    return Number((baseCost + extraKmCost + extraHrCost).toFixed(2));
+}
+//# sourceMappingURL=calculate.deducted.sharing.amount.js.map

package/src/lib/utilities/src/calculate.deducted.sharing.amount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate.deducted.sharing.amount.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/calculate.deducted.sharing.amount.ts"],"names":[],"mappings":"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"}

package/src/lib/utilities/src/find.ba.contract.for.booking.d.ts

@@ -0,0 +1,25 @@
+import { IBAContract, IRequest } from '../../models/src/index';
+/**
+ * Resolve the BA contract that owns a booking.
+ *
+ * Picks the contract whose active window contains the booking's pickup time.
+ * Returns `null` if no contract matches.
+ *
+ * Differences from the inline duplicates this replaces:
+ *   - Pickup time, not invoice-cut date. A booking on Apr 8 invoiced Apr 30 must
+ *     be attributed to the contract active on Apr 8, not the one active on
+ *     Apr 30. Fixes pre-contract and post-surrender bookings appearing under
+ *     the wrong contract row.
+ *   - Effective end = earlier of `ContractEndDate` and `SurrenderEffectiveDate`
+ *     (AND, not OR). The previous `||` accepted a contract whose original end
+ *     date was still in the future even after early surrender, so post-surrender
+ *     bookings stuck to the surrendered contract. This is also a behaviour
+ *     change for the export-report path, which previously used OR.
+ *   - Cancelled contracts are skipped. A `Cancelled` row with a future end date
+ *     used to match.
+ *   - Surrendered contracts without a populated `SurrenderEffectiveDate` are
+ *     skipped — without an effective date the surrender guard cannot be
+ *     enforced and the contract would silently fall back to matching on
+ *     `ContractEndDate` alone (the exact mis-attribution this helper fixes).
+ */
+export declare function findBAContractForBooking(booking: IRequest, contracts: IBAContract[] | undefined): IBAContract | null;

package/src/lib/utilities/src/find.ba.contract.for.booking.js

@@ -0,0 +1,66 @@
+import { BAContractField, RequestField, TripField, } from '../../models/src/index';
+import { BAContractStatus } from '../../enums/src/index';
+/**
+ * Resolve the BA contract that owns a booking.
+ *
+ * Picks the contract whose active window contains the booking's pickup time.
+ * Returns `null` if no contract matches.
+ *
+ * Differences from the inline duplicates this replaces:
+ *   - Pickup time, not invoice-cut date. A booking on Apr 8 invoiced Apr 30 must
+ *     be attributed to the contract active on Apr 8, not the one active on
+ *     Apr 30. Fixes pre-contract and post-surrender bookings appearing under
+ *     the wrong contract row.
+ *   - Effective end = earlier of `ContractEndDate` and `SurrenderEffectiveDate`
+ *     (AND, not OR). The previous `||` accepted a contract whose original end
+ *     date was still in the future even after early surrender, so post-surrender
+ *     bookings stuck to the surrendered contract. This is also a behaviour
+ *     change for the export-report path, which previously used OR.
+ *   - Cancelled contracts are skipped. A `Cancelled` row with a future end date
+ *     used to match.
+ *   - Surrendered contracts without a populated `SurrenderEffectiveDate` are
+ *     skipped — without an effective date the surrender guard cannot be
+ *     enforced and the contract would silently fall back to matching on
+ *     `ContractEndDate` alone (the exact mis-attribution this helper fixes).
+ */
+export function findBAContractForBooking(booking, contracts) {
+    if (!contracts?.length)
+        return null;
+    const trip = booking?.[RequestField.Trip];
+    const bookingDateRaw = trip?.[TripField.StartGarageDate] ??
+        booking?.[RequestField.PickupTime] ??
+        booking?.[RequestField.InvoiceDate];
+    if (!bookingDateRaw)
+        return null;
+    const bookingDate = new Date(bookingDateRaw);
+    return (contracts.find((c) => {
+        const status = c?.[BAContractField.Status];
+        if (status === BAContractStatus.Cancelled)
+            return false;
+        if (status === BAContractStatus.Surrendered &&
+            !c?.[BAContractField.SurrenderEffectiveDate]) {
+            return false;
+        }
+        const start = c?.[BAContractField.ContractStartDate]
+            ? new Date(c[BAContractField.ContractStartDate])
+            : null;
+        if (!start || start > bookingDate)
+            return false;
+        const endDate = c?.[BAContractField.ContractEndDate]
+            ? new Date(c[BAContractField.ContractEndDate])
+            : null;
+        const surrenderDate = c?.[BAContractField.SurrenderEffectiveDate]
+            ? new Date(c[BAContractField.SurrenderEffectiveDate])
+            : null;
+        // Contract must have some end boundary, and the booking must fall on
+        // or before the earlier of (ContractEndDate, SurrenderEffectiveDate).
+        if (!endDate && !surrenderDate)
+            return false;
+        if (endDate && endDate < bookingDate)
+            return false;
+        if (surrenderDate && surrenderDate < bookingDate)
+            return false;
+        return true;
+    }) ?? null);
+}
+//# sourceMappingURL=find.ba.contract.for.booking.js.map

package/src/lib/utilities/src/find.ba.contract.for.booking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.ba.contract.for.booking.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/find.ba.contract.for.booking.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EAGf,YAAY,EACZ,SAAS,GACT,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,wBAAwB,CACvC,OAAiB,EACjB,SAAoC;IAEpC,IAAI,CAAC,SAAS,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,cAAc,GACnB,IAAI,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC;QACjC,OAAO,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC;QAClC,OAAO,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC;IAE7C,OAAO,CACN,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACpB,MAAM,MAAM,GAAG,CAAC,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,MAAM,KAAK,gBAAgB,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QACxD,IACC,MAAM,KAAK,gBAAgB,CAAC,WAAW;YACvC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,sBAAsB,CAAC,EAC3C,CAAC;YACF,OAAO,KAAK,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC,eAAe,CAAC,iBAAiB,CAAC;YACnD,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;YAChD,CAAC,CAAC,IAAI,CAAC;QACR,IAAI,CAAC,KAAK,IAAI,KAAK,GAAG,WAAW;YAAE,OAAO,KAAK,CAAC;QAEhD,MAAM,OAAO,GAAG,CAAC,EAAE,CAAC,eAAe,CAAC,eAAe,CAAC;YACnD,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;YAC9C,CAAC,CAAC,IAAI,CAAC;QACR,MAAM,aAAa,GAAG,CAAC,EAAE,CAAC,eAAe,CAAC,sBAAsB,CAAC;YAChE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,sBAAsB,CAAC,CAAC;YACrD,CAAC,CAAC,IAAI,CAAC;QAER,qEAAqE;QACrE,sEAAsE;QACtE,IAAI,CAAC,OAAO,IAAI,CAAC,aAAa;YAAE,OAAO,KAAK,CAAC;QAC7C,IAAI,OAAO,IAAI,OAAO,GAAG,WAAW;YAAE,OAAO,KAAK,CAAC;QACnD,IAAI,aAAa,IAAI,aAAa,GAAG,WAAW;YAAE,OAAO,KAAK,CAAC;QAE/D,OAAO,IAAI,CAAC;IACb,CAAC,CAAC,IAAI,IAAI,CACV,CAAC;AACH,CAAC"}

package/src/lib/utilities/src/index.d.ts

@@ -22,3 +22,7 @@ export * from './build.cleartax.pay.dtls';
 export * from './resolve.cleartax.driver.sac.hsn';
 export * from './resolve.passenger.display.name';
 export * from './remove.null.filter';
+export * from './calculate.deducted.sharing.amount';
+export * from './find.ba.contract.for.booking';
+export * from './pick.numbered.invoice.for.booking';
+export * from './pick.incentive.amount';

package/src/lib/utilities/src/index.js

@@ -22,4 +22,8 @@ export * from './build.cleartax.pay.dtls';
 export * from './resolve.cleartax.driver.sac.hsn';
 export * from './resolve.passenger.display.name';
 export * from './remove.null.filter';
+export * from './calculate.deducted.sharing.amount';
+export * from './find.ba.contract.for.booking';
+export * from './pick.numbered.invoice.for.booking';
+export * from './pick.incentive.amount';
 //# sourceMappingURL=index.js.map

package/src/lib/utilities/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,oCAAoC,CAAC;AACnD,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,OAAO,CAAC;AACtB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,oCAAoC,CAAC;AACnD,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wCAAwC,CAAC;AACvD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,OAAO,CAAC;AACtB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC"}

package/src/lib/utilities/src/ist.d.ts

@@ -1,5 +1,11 @@
 export declare const IST_OFFSET_MS: number;
 export declare function addIstOffset(d: Date): Date;
+/**
+ * Normalizes any date/string to IST start-of-day (00:00:00 IST = 18:30:00 UTC previous day).
+ * Returns null for missing/invalid input so callers can guard rather than writing bad data.
+ * Safe regardless of whether the input carries a UTC offset, IST offset, or none.
+ */
+export declare function toISTStartOfDay(d: Date | string | null | undefined): Date | null;
 /**
  * Returns a UTC-midnight Date anchored to the IST calendar day, suitable
  * for ExcelJS (and downstream xlsx writers) that serialise Dates via UTC.

package/src/lib/utilities/src/ist.js

@@ -2,6 +2,21 @@ export const IST_OFFSET_MS = 5.5 * 60 * 60 * 1000;
 export function addIstOffset(d) {
     return new Date(d.getTime() + IST_OFFSET_MS);
 }
+/**
+ * Normalizes any date/string to IST start-of-day (00:00:00 IST = 18:30:00 UTC previous day).
+ * Returns null for missing/invalid input so callers can guard rather than writing bad data.
+ * Safe regardless of whether the input carries a UTC offset, IST offset, or none.
+ */
+export function toISTStartOfDay(d) {
+    if (d === null || d === undefined || d === '')
+        return null;
+    const parsed = new Date(d);
+    if (Number.isNaN(parsed.getTime()))
+        return null;
+    const istDate = new Date(parsed.getTime() + IST_OFFSET_MS);
+    return new Date(Date.UTC(istDate.getUTCFullYear(), istDate.getUTCMonth(), istDate.getUTCDate())
+        - IST_OFFSET_MS);
+}
 /**
  * Returns a UTC-midnight Date anchored to the IST calendar day, suitable
  * for ExcelJS (and downstream xlsx writers) that serialise Dates via UTC.

package/src/lib/utilities/src/ist.js.map

@@ -1 +1 @@
-{"version":3,"file":"ist.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/ist.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAElD,MAAM,UAAU,YAAY,CAAC,CAAO;IACnC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,aAAa,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAC7B,GAAqC;IAErC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACjE,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,IAAI,IAAI,CACd,IAAI,CAAC,GAAG,CACP,OAAO,CAAC,cAAc,EAAE,EACxB,OAAO,CAAC,WAAW,EAAE,EACrB,OAAO,CAAC,UAAU,EAAE,CACpB,CACD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAsC;IAC/D,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAsC;IACnE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,aAAa,CAAC;SAC1C,WAAW,EAAE;SACb,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;SACjB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAC9B,KAAU,EACV,IAA8C;IAE9C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC3D,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC9C,CAAC;IACD,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAC/D,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAAE,OAAO,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACrB,OAAO,IAAI,IAAI,CACd,OAAO,CAAC,WAAW,EAAE,EACrB,OAAO,CAAC,QAAQ,EAAE,EAClB,OAAO,CAAC,OAAO,EAAE,CACjB,CAAC;QACH,CAAC;QACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACrB,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACvD,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACzD,OAAO,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;QACtB,CAAC;QACD,OAAO,OAAO,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}
+{"version":3,"file":"ist.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/ist.ts"],"names":[],"mappings":"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"}

package/src/lib/utilities/src/pick.incentive.amount.d.ts

@@ -0,0 +1,20 @@
+import { BAIncentiveCriteriaType } from '../../enums/src/index';
+export interface IIncentiveEligibleRule {
+    minBenchmarkRevenue: number;
+    attendance: number;
+    criteria: BAIncentiveCriteriaType;
+    incentive: number;
+}
+/**
+ * Resolve the highest incentive amount across the eligible rules.
+ * AND rule fires when revenue AND attendance both meet the rule's
+ * thresholds; OR rule fires when either meets. Result is the max
+ * incentive across all firing rules — zero when none fire.
+ *
+ * Shared between Orion (initial computation in
+ * CalculateBusinessAssociatePayoutRowsController) and Iris
+ * (reactive recompute when the user edits revenue inputs in
+ * preview.payout.component.tsx). Keep this function pure — no IO,
+ * no date math — so both runtimes get identical answers.
+ */
+export declare function pickIncentiveAmount(eligibleRules: IIncentiveEligibleRule[], revenue: number, dayCount: number): number;

package/src/lib/utilities/src/pick.incentive.amount.js

@@ -0,0 +1,30 @@
+import { BAIncentiveCriteriaType } from '../../enums/src/index';
+/**
+ * Resolve the highest incentive amount across the eligible rules.
+ * AND rule fires when revenue AND attendance both meet the rule's
+ * thresholds; OR rule fires when either meets. Result is the max
+ * incentive across all firing rules — zero when none fire.
+ *
+ * Shared between Orion (initial computation in
+ * CalculateBusinessAssociatePayoutRowsController) and Iris
+ * (reactive recompute when the user edits revenue inputs in
+ * preview.payout.component.tsx). Keep this function pure — no IO,
+ * no date math — so both runtimes get identical answers.
+ */
+export function pickIncentiveAmount(eligibleRules, revenue, dayCount) {
+    let incentive = 0;
+    for (const rule of eligibleRules ?? []) {
+        const revenueMatch = revenue >= rule.minBenchmarkRevenue;
+        const dayMatch = dayCount >= rule.attendance;
+        const fires = rule.criteria === BAIncentiveCriteriaType.AND
+            ? revenueMatch && dayMatch
+            : rule.criteria === BAIncentiveCriteriaType.OR
+                ? revenueMatch || dayMatch
+                : false;
+        if (fires && rule.incentive > incentive) {
+            incentive = rule.incentive;
+        }
+    }
+    return incentive;
+}
+//# sourceMappingURL=pick.incentive.amount.js.map

package/src/lib/utilities/src/pick.incentive.amount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.incentive.amount.js","sourceRoot":"","sources":["../../../../../../../libs/shared/src/lib/utilities/src/pick.incentive.amount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAShE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAClC,aAAuC,EACvC,OAAe,EACf,QAAgB;IAEhB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,IAAI,IAAI,aAAa,IAAI,EAAE,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,OAAO,IAAI,IAAI,CAAC,mBAAmB,CAAC;QACzD,MAAM,QAAQ,GAAG,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC;QAC7C,MAAM,KAAK,GACV,IAAI,CAAC,QAAQ,KAAK,uBAAuB,CAAC,GAAG;YAC5C,CAAC,CAAC,YAAY,IAAI,QAAQ;YAC1B,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,uBAAuB,CAAC,EAAE;gBAC7C,CAAC,CAAC,YAAY,IAAI,QAAQ;gBAC1B,CAAC,CAAC,KAAK,CAAC;QACX,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,GAAG,SAAS,EAAE,CAAC;YACzC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAC5B,CAAC;IACF,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/src/lib/utilities/src/pick.numbered.invoice.for.booking.d.ts

@@ -0,0 +1,37 @@
+import { INumberedInvoice, IRequest, ITaxInvoice } from '../../models/src/index';
+export interface PickNumberedInvoiceResult {
+    ni: INumberedInvoice | undefined;
+    lineItems: any[] | undefined;
+    /**
+     * True when the caller should sign-flip downstream amounts:
+     * a full-cancel CN/DN against a consolidated parent was resolved
+     * by walking to the parent's per-booking NI, so the picked
+     * lineItems carry the original (positive) values. The caller
+     * negates to express the cancellation in the row.
+     */
+    negateForFullCancel: boolean;
+}
+/**
+ * Resolve the per-booking NumberedInvoice and the right line-item slice
+ * for a (request, taxInvoice) pair, with CN/DN, full-cancel, and
+ * consolidated cases handled.
+ *
+ *   - CN/DN: source NI from `ti.ReferenceInvoice` (the parent TI), not
+ *     the CN itself. CN entities don't carry their own NumberedInvoice
+ *     for the original sale — only the reversal.
+ *   - Consolidated source: walk `sourceTI.NumberedInvoices` and pick
+ *     the one whose `instantInvBody.tripId` matches the request's
+ *     `Trip.TripId`. Single-child fallback when no tripId match.
+ *   - Non-consolidated source: use `sourceTI.NumberedInvoice` (direct
+ *     ManyToOne FK on the TI entity).
+ *   - Consolidated full-cancel CN/DN: returns the parent NI's
+ *     lineItems (positive originals) and `negateForFullCancel=true`
+ *     so the caller sign-flips. If per-booking NI can't be resolved,
+ *     returns empty lineItems rather than surfacing the consolidated
+ *     whole-invoice total once per booking.
+ *
+ * Mirrors `VendorKnockOffCalculationService.pickNumberedInvoiceAndLineItems`
+ * — kept in shared so BA-payout / booking-report / vendor-KO can all
+ * use one source of truth.
+ */
+export declare function pickNumberedInvoiceForBooking(request: IRequest, taxInvoice?: ITaxInvoice, debug?: (msg: string) => void): PickNumberedInvoiceResult;