@bisondesk/core-sdk 1.0.592 → 1.0.593

package/src/utils/country-pricing.test.ts

@@ -0,0 +1,82 @@
+import { Categories } from '../constants.js';
+import { CountryPricingRule } from '../types/country-pricing.js';
+import {
+  convertFromBranchCurrency,
+  getApplicableDeliveryCost,
+  shouldApplyDeliveryCost,
+} from './country-pricing.js';
+
+const baseRule: CountryPricingRule = {
+  countryCode: 'bo',
+  currency: 'USD',
+  rate: 1.08,
+  deliveryCostByCategory: { [Categories.Truck]: 500 },
+  deliveryLocation: 'La Paz (Bolivia)',
+};
+
+describe('convertFromBranchCurrency', () => {
+  test('multiplies by rate', () => {
+    expect(convertFromBranchCurrency(1000, { rate: 1.08 })).toBe(1080);
+  });
+
+  test('uses Math.ceil to avoid underselling on partial cents', () => {
+    expect(convertFromBranchCurrency(999.5, { rate: 1.0 })).toBe(1000);
+  });
+});
+
+describe('shouldApplyDeliveryCost', () => {
+  test('returns false when origin equals rule country', () => {
+    expect(shouldApplyDeliveryCost({ countryCode: 'bo' }, 'bo')).toBe(false);
+  });
+
+  test('is case-insensitive', () => {
+    expect(shouldApplyDeliveryCost({ countryCode: 'bo' }, 'BO')).toBe(false);
+    expect(shouldApplyDeliveryCost({ countryCode: 'BO' }, 'bo')).toBe(false);
+  });
+
+  test('returns true when origin differs from rule country', () => {
+    expect(shouldApplyDeliveryCost({ countryCode: 'bo' }, 'be')).toBe(true);
+  });
+
+  test('returns true when origin is undefined (safe default)', () => {
+    expect(shouldApplyDeliveryCost({ countryCode: 'bo' }, undefined)).toBe(true);
+  });
+});
+
+describe('getApplicableDeliveryCost', () => {
+  test('returns undefined when same country, even with a configured cost', () => {
+    expect(getApplicableDeliveryCost(baseRule, Categories.Truck, 'bo')).toBeUndefined();
+  });
+
+  test('returns undefined when category is undefined', () => {
+    expect(getApplicableDeliveryCost(baseRule, undefined, 'be')).toBeUndefined();
+  });
+
+  test('returns the matching cost for a different country and known category', () => {
+    expect(getApplicableDeliveryCost(baseRule, Categories.Truck, 'be')).toBe(500);
+  });
+
+  test('returns 0 when the category is explicitly mapped to 0 (opt-in with no fee)', () => {
+    const zeroFeeRule: CountryPricingRule = {
+      countryCode: 'bo',
+      currency: 'USD',
+      rate: 1.08,
+      deliveryCostByCategory: { [Categories.Truck]: 0 },
+      deliveryLocation: 'Bolivia',
+    };
+    expect(getApplicableDeliveryCost(zeroFeeRule, Categories.Truck, 'be')).toBe(0);
+  });
+
+  test('returns undefined when category has no configured cost', () => {
+    expect(getApplicableDeliveryCost(baseRule, Categories.Van, 'be')).toBeUndefined();
+  });
+
+  test('returns undefined when rule has no deliveryCostByCategory at all', () => {
+    const pureRateRule: CountryPricingRule = {
+      countryCode: 'bo',
+      currency: 'USD',
+      rate: 1.08,
+    };
+    expect(getApplicableDeliveryCost(pureRateRule, Categories.Truck, 'be')).toBeUndefined();
+  });
+});

package/src/utils/country-pricing.ts

@@ -0,0 +1,44 @@
+import { Categories } from '../constants.js';
+import { CountryPricingRule } from '../types/country-pricing.js';
+
+/**
+ * Should the delivery cost defined by `rule` be applied for a vehicle whose
+ * origin branch is in `originCountry`? Returns `false` when the vehicle is
+ * already located in the rule's country (case-insensitive ISO-2 compare).
+ */
+export const shouldApplyDeliveryCost = (
+  rule: Pick<CountryPricingRule, 'countryCode'>,
+  originCountry: string | undefined,
+): boolean => {
+  if (originCountry == null) {
+    return true;
+  }
+  return originCountry.toLowerCase() !== rule.countryCode.toLowerCase();
+};
+
+/**
+ * Look up the per-category delivery cost on the rule. Returns `undefined` when delivery is
+ * not applicable (same-country suppression, missing category, or category not in the rule's
+ * map). Returns the configured number — including `0` — when the rule explicitly covers the
+ * category. A `0` is a legitimate value: the operator has opted in for this category but is
+ * charging no fee on top (e.g. for vehicles already at the rule's `deliveryLocation`).
+ */
+export const getApplicableDeliveryCost = (
+  rule: CountryPricingRule,
+  category: string | undefined,
+  originCountry: string | undefined,
+): number | undefined => {
+  if (!shouldApplyDeliveryCost(rule, originCountry)) {
+    return undefined;
+  }
+  if (category == null) {
+    return undefined;
+  }
+  return rule.deliveryCostByCategory?.[category as Categories];
+};
+
+/** Convert an amount in the owning branch's currency to `rule.currency`. */
+export const convertFromBranchCurrency = (
+  branchAmount: number,
+  rule: Pick<CountryPricingRule, 'rate'>,
+): number => Math.ceil(branchAmount * rule.rate);