spotcharge-types 1.0.437 → 1.0.438

package/dist/utils/index.d.ts

@@ -1,2 +1,3 @@
 export { CONSUMER_STATION_ACCESS_TYPES, FLEET_STATION_ACCESS_TYPES, mapCapabilitiesAccessToAccessType, stationHasConsumerAccess, stationHasFleetAccess, } from './station-access.util';
+export { MAX_PARTNER_SHARE_PERCENT, PARTNER_SHARE_CAP_ERROR, PARTNER_SHARE_TARIFF_REQUIRED_ERROR, PLATFORM_MIN_SHARE_PERCENT, PartnershipShareInput, maxPartnerShareSumMinor, partnerShareSumMinorForRate, partnerShareSumMinorPercentOnly, platformKeepsPercentAtRate, remainingPartnerSharePercent, toShareMinorUnits, validatePartnerShareTotals, } from './station-partnership-share.util';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,iCAAiC,EACjC,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,iCAAiC,EACjC,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,mCAAmC,EACnC,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,+BAA+B,EAC/B,0BAA0B,EAC1B,4BAA4B,EAC5B,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,kCAAkC,CAAC"}

package/dist/utils/index.js

@@ -1,10 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stationHasFleetAccess = exports.stationHasConsumerAccess = exports.mapCapabilitiesAccessToAccessType = exports.FLEET_STATION_ACCESS_TYPES = exports.CONSUMER_STATION_ACCESS_TYPES = void 0;
+exports.validatePartnerShareTotals = exports.toShareMinorUnits = exports.remainingPartnerSharePercent = exports.platformKeepsPercentAtRate = exports.partnerShareSumMinorPercentOnly = exports.partnerShareSumMinorForRate = exports.maxPartnerShareSumMinor = exports.PLATFORM_MIN_SHARE_PERCENT = exports.PARTNER_SHARE_TARIFF_REQUIRED_ERROR = exports.PARTNER_SHARE_CAP_ERROR = exports.MAX_PARTNER_SHARE_PERCENT = exports.stationHasFleetAccess = exports.stationHasConsumerAccess = exports.mapCapabilitiesAccessToAccessType = exports.FLEET_STATION_ACCESS_TYPES = exports.CONSUMER_STATION_ACCESS_TYPES = void 0;
 var station_access_util_1 = require("./station-access.util");
 Object.defineProperty(exports, "CONSUMER_STATION_ACCESS_TYPES", { enumerable: true, get: function () { return station_access_util_1.CONSUMER_STATION_ACCESS_TYPES; } });
 Object.defineProperty(exports, "FLEET_STATION_ACCESS_TYPES", { enumerable: true, get: function () { return station_access_util_1.FLEET_STATION_ACCESS_TYPES; } });
 Object.defineProperty(exports, "mapCapabilitiesAccessToAccessType", { enumerable: true, get: function () { return station_access_util_1.mapCapabilitiesAccessToAccessType; } });
 Object.defineProperty(exports, "stationHasConsumerAccess", { enumerable: true, get: function () { return station_access_util_1.stationHasConsumerAccess; } });
 Object.defineProperty(exports, "stationHasFleetAccess", { enumerable: true, get: function () { return station_access_util_1.stationHasFleetAccess; } });
+var station_partnership_share_util_1 = require("./station-partnership-share.util");
+Object.defineProperty(exports, "MAX_PARTNER_SHARE_PERCENT", { enumerable: true, get: function () { return station_partnership_share_util_1.MAX_PARTNER_SHARE_PERCENT; } });
+Object.defineProperty(exports, "PARTNER_SHARE_CAP_ERROR", { enumerable: true, get: function () { return station_partnership_share_util_1.PARTNER_SHARE_CAP_ERROR; } });
+Object.defineProperty(exports, "PARTNER_SHARE_TARIFF_REQUIRED_ERROR", { enumerable: true, get: function () { return station_partnership_share_util_1.PARTNER_SHARE_TARIFF_REQUIRED_ERROR; } });
+Object.defineProperty(exports, "PLATFORM_MIN_SHARE_PERCENT", { enumerable: true, get: function () { return station_partnership_share_util_1.PLATFORM_MIN_SHARE_PERCENT; } });
+Object.defineProperty(exports, "maxPartnerShareSumMinor", { enumerable: true, get: function () { return station_partnership_share_util_1.maxPartnerShareSumMinor; } });
+Object.defineProperty(exports, "partnerShareSumMinorForRate", { enumerable: true, get: function () { return station_partnership_share_util_1.partnerShareSumMinorForRate; } });
+Object.defineProperty(exports, "partnerShareSumMinorPercentOnly", { enumerable: true, get: function () { return station_partnership_share_util_1.partnerShareSumMinorPercentOnly; } });
+Object.defineProperty(exports, "platformKeepsPercentAtRate", { enumerable: true, get: function () { return station_partnership_share_util_1.platformKeepsPercentAtRate; } });
+Object.defineProperty(exports, "remainingPartnerSharePercent", { enumerable: true, get: function () { return station_partnership_share_util_1.remainingPartnerSharePercent; } });
+Object.defineProperty(exports, "toShareMinorUnits", { enumerable: true, get: function () { return station_partnership_share_util_1.toShareMinorUnits; } });
+Object.defineProperty(exports, "validatePartnerShareTotals", { enumerable: true, get: function () { return station_partnership_share_util_1.validatePartnerShareTotals; } });
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,6DAM+B;AAL7B,oIAAA,6BAA6B,OAAA;AAC7B,iIAAA,0BAA0B,OAAA;AAC1B,wIAAA,iCAAiC,OAAA;AACjC,+HAAA,wBAAwB,OAAA;AACxB,4HAAA,qBAAqB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,6DAM+B;AAL7B,oIAAA,6BAA6B,OAAA;AAC7B,iIAAA,0BAA0B,OAAA;AAC1B,wIAAA,iCAAiC,OAAA;AACjC,+HAAA,wBAAwB,OAAA;AACxB,4HAAA,qBAAqB,OAAA;AAEvB,mFAa0C;AAZxC,2IAAA,yBAAyB,OAAA;AACzB,yIAAA,uBAAuB,OAAA;AACvB,qJAAA,mCAAmC,OAAA;AACnC,4IAAA,0BAA0B,OAAA;AAE1B,yIAAA,uBAAuB,OAAA;AACvB,6IAAA,2BAA2B,OAAA;AAC3B,iJAAA,+BAA+B,OAAA;AAC/B,4IAAA,0BAA0B,OAAA;AAC1B,8IAAA,4BAA4B,OAAA;AAC5B,mIAAA,iBAAiB,OAAA;AACjB,4IAAA,0BAA0B,OAAA"}

package/dist/utils/station-partnership-share.util.d.ts

@@ -0,0 +1,22 @@
+import { StationPartnershipShareType } from '../consts/station-partnership-share-type.const';
+export declare const PLATFORM_MIN_SHARE_PERCENT = 10;
+export declare const MAX_PARTNER_SHARE_PERCENT = 90;
+export interface PartnershipShareInput {
+    shareType: StationPartnershipShareType;
+    percent: string | null;
+    amountPerKwh: string | null;
+}
+export declare const PARTNER_SHARE_CAP_ERROR = "Partner shares cannot exceed 90% of the kWh price. SpotCharge keeps at least 10%.";
+export declare const PARTNER_SHARE_TARIFF_REQUIRED_ERROR = "Set a tariff on this charger size before using rupee partnership shares.";
+export declare function toShareMinorUnits(value: string): number | null;
+/** Partner share total in minor units (10000 = 100%) for one energy rate. */
+export declare function partnerShareSumMinorForRate(partners: PartnershipShareInput[], energyRate: number): number | null;
+/** Partner share total when every row is a typed percent (no tariff needed). */
+export declare function partnerShareSumMinorPercentOnly(partners: PartnershipShareInput[]): number | null;
+export declare function validatePartnerShareTotals(partners: PartnershipShareInput[], energyRates: number[]): string | null;
+/** SpotCharge remainder as a percent of the kWh price (0–100), for display. */
+export declare function platformKeepsPercentAtRate(partners: PartnershipShareInput[], energyRate: number | null): number | null;
+/** Highest partner total across applicable tariff rates (minor units). */
+export declare function maxPartnerShareSumMinor(partners: PartnershipShareInput[], energyRates: number[]): number | null;
+export declare function remainingPartnerSharePercent(partners: PartnershipShareInput[], energyRates: number[]): number | null;
+//# sourceMappingURL=station-partnership-share.util.d.ts.map

package/dist/utils/station-partnership-share.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"station-partnership-share.util.d.ts","sourceRoot":"","sources":["../../src/utils/station-partnership-share.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAE7F,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAK5C,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,2BAA2B,CAAC;IACvC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,eAAO,MAAM,uBAAuB,sFACiD,CAAC;AAEtF,eAAO,MAAM,mCAAmC,6EAC4B,CAAC;AAE7E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO9D;AAED,6EAA6E;AAC7E,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,qBAAqB,EAAE,EACjC,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAmBf;AAED,gFAAgF;AAChF,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,qBAAqB,EAAE,GAAG,MAAM,GAAG,IAAI,CAahG;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,qBAAqB,EAAE,EACjC,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,GAAG,IAAI,CA6Bf;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,qBAAqB,EAAE,EACjC,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,GAAG,IAAI,CASf;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,qBAAqB,EAAE,EACjC,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,GAAG,IAAI,CAoBf;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,qBAAqB,EAAE,EACjC,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,GAAG,IAAI,CAMf"}

package/dist/utils/station-partnership-share.util.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remainingPartnerSharePercent = exports.maxPartnerShareSumMinor = exports.platformKeepsPercentAtRate = exports.validatePartnerShareTotals = exports.partnerShareSumMinorPercentOnly = exports.partnerShareSumMinorForRate = exports.toShareMinorUnits = exports.PARTNER_SHARE_TARIFF_REQUIRED_ERROR = exports.PARTNER_SHARE_CAP_ERROR = exports.MAX_PARTNER_SHARE_PERCENT = exports.PLATFORM_MIN_SHARE_PERCENT = void 0;
+var station_partnership_share_type_const_1 = require("../consts/station-partnership-share-type.const");
+exports.PLATFORM_MIN_SHARE_PERCENT = 10;
+exports.MAX_PARTNER_SHARE_PERCENT = 90;
+var FULL_SHARE_MINOR = 10000;
+var MAX_PARTNER_SHARE_MINOR = exports.MAX_PARTNER_SHARE_PERCENT * 100;
+exports.PARTNER_SHARE_CAP_ERROR = 'Partner shares cannot exceed 90% of the kWh price. SpotCharge keeps at least 10%.';
+exports.PARTNER_SHARE_TARIFF_REQUIRED_ERROR = 'Set a tariff on this charger size before using rupee partnership shares.';
+function toShareMinorUnits(value) {
+    var _a;
+    var match = /^(\d{1,8})(?:\.(\d{1,2}))?$/.exec(String(value !== null && value !== void 0 ? value : '').trim());
+    if (!match) {
+        return null;
+    }
+    var fraction = (_a = match[2]) !== null && _a !== void 0 ? _a : '';
+    return Number(match[1]) * 100 + Number((fraction + '00').slice(0, 2));
+}
+exports.toShareMinorUnits = toShareMinorUnits;
+/** Partner share total in minor units (10000 = 100%) for one energy rate. */
+function partnerShareSumMinorForRate(partners, energyRate) {
+    var _a, _b;
+    var sum = 0;
+    for (var _i = 0, partners_1 = partners; _i < partners_1.length; _i++) {
+        var row = partners_1[_i];
+        if (row.shareType === station_partnership_share_type_const_1.StationPartnershipShareType.PerKwh) {
+            var amountMinor = toShareMinorUnits((_a = row.amountPerKwh) !== null && _a !== void 0 ? _a : '');
+            if (amountMinor === null || amountMinor <= 0 || energyRate <= 0) {
+                return null;
+            }
+            var amount = amountMinor / 100;
+            sum += Math.round((amount / energyRate) * FULL_SHARE_MINOR);
+            continue;
+        }
+        var minor = toShareMinorUnits((_b = row.percent) !== null && _b !== void 0 ? _b : '');
+        if (minor === null || minor <= 0) {
+            return null;
+        }
+        sum += minor;
+    }
+    return sum;
+}
+exports.partnerShareSumMinorForRate = partnerShareSumMinorForRate;
+/** Partner share total when every row is a typed percent (no tariff needed). */
+function partnerShareSumMinorPercentOnly(partners) {
+    var _a;
+    var sum = 0;
+    for (var _i = 0, partners_2 = partners; _i < partners_2.length; _i++) {
+        var row = partners_2[_i];
+        if (row.shareType === station_partnership_share_type_const_1.StationPartnershipShareType.PerKwh) {
+            return null;
+        }
+        var minor = toShareMinorUnits((_a = row.percent) !== null && _a !== void 0 ? _a : '');
+        if (minor === null || minor <= 0) {
+            return null;
+        }
+        sum += minor;
+    }
+    return sum;
+}
+exports.partnerShareSumMinorPercentOnly = partnerShareSumMinorPercentOnly;
+function validatePartnerShareTotals(partners, energyRates) {
+    var usableRates = Array.from(new Set(energyRates.filter(function (rate) { return rate > 0; })));
+    var hasRupee = partners.some(function (row) { return row.shareType === station_partnership_share_type_const_1.StationPartnershipShareType.PerKwh; });
+    if (hasRupee && usableRates.length === 0) {
+        return exports.PARTNER_SHARE_TARIFF_REQUIRED_ERROR;
+    }
+    if (hasRupee) {
+        for (var _i = 0, usableRates_1 = usableRates; _i < usableRates_1.length; _i++) {
+            var rate = usableRates_1[_i];
+            var sum_1 = partnerShareSumMinorForRate(partners, rate);
+            if (sum_1 === null) {
+                return exports.PARTNER_SHARE_TARIFF_REQUIRED_ERROR;
+            }
+            if (sum_1 > MAX_PARTNER_SHARE_MINOR) {
+                return exports.PARTNER_SHARE_CAP_ERROR;
+            }
+        }
+        return null;
+    }
+    var sum = partnerShareSumMinorPercentOnly(partners);
+    if (sum === null) {
+        return null;
+    }
+    if (sum > MAX_PARTNER_SHARE_MINOR) {
+        return exports.PARTNER_SHARE_CAP_ERROR;
+    }
+    return null;
+}
+exports.validatePartnerShareTotals = validatePartnerShareTotals;
+/** SpotCharge remainder as a percent of the kWh price (0–100), for display. */
+function platformKeepsPercentAtRate(partners, energyRate) {
+    var sum = energyRate != null && energyRate > 0
+        ? partnerShareSumMinorForRate(partners, energyRate)
+        : partnerShareSumMinorPercentOnly(partners);
+    if (sum === null) {
+        return null;
+    }
+    return Math.max(0, (FULL_SHARE_MINOR - sum) / 100);
+}
+exports.platformKeepsPercentAtRate = platformKeepsPercentAtRate;
+/** Highest partner total across applicable tariff rates (minor units). */
+function maxPartnerShareSumMinor(partners, energyRates) {
+    var usableRates = energyRates.filter(function (rate) { return rate > 0; });
+    var hasRupee = partners.some(function (row) { return row.shareType === station_partnership_share_type_const_1.StationPartnershipShareType.PerKwh; });
+    if (hasRupee) {
+        if (usableRates.length === 0) {
+            return null;
+        }
+        var max = 0;
+        for (var _i = 0, usableRates_2 = usableRates; _i < usableRates_2.length; _i++) {
+            var rate = usableRates_2[_i];
+            var sum = partnerShareSumMinorForRate(partners, rate);
+            if (sum === null) {
+                return null;
+            }
+            max = Math.max(max, sum);
+        }
+        return max;
+    }
+    return partnerShareSumMinorPercentOnly(partners);
+}
+exports.maxPartnerShareSumMinor = maxPartnerShareSumMinor;
+function remainingPartnerSharePercent(partners, energyRates) {
+    var sumMinor = maxPartnerShareSumMinor(partners, energyRates);
+    if (sumMinor === null) {
+        return null;
+    }
+    return Math.max(0, (MAX_PARTNER_SHARE_MINOR - sumMinor) / 100);
+}
+exports.remainingPartnerSharePercent = remainingPartnerSharePercent;
+//# sourceMappingURL=station-partnership-share.util.js.map

package/dist/utils/station-partnership-share.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"station-partnership-share.util.js","sourceRoot":"","sources":["../../src/utils/station-partnership-share.util.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spotcharge-types",
-  "version": "1.0.437",
+  "version": "1.0.438",
   "description": "Spotcharge types",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/utils/index.ts

@@ -5,3 +5,17 @@ export {
   stationHasConsumerAccess,
   stationHasFleetAccess,
 } from './station-access.util';
+export {
+  MAX_PARTNER_SHARE_PERCENT,
+  PARTNER_SHARE_CAP_ERROR,
+  PARTNER_SHARE_TARIFF_REQUIRED_ERROR,
+  PLATFORM_MIN_SHARE_PERCENT,
+  PartnershipShareInput,
+  maxPartnerShareSumMinor,
+  partnerShareSumMinorForRate,
+  partnerShareSumMinorPercentOnly,
+  platformKeepsPercentAtRate,
+  remainingPartnerSharePercent,
+  toShareMinorUnits,
+  validatePartnerShareTotals,
+} from './station-partnership-share.util';

package/src/utils/station-partnership-share.util.ts

@@ -0,0 +1,155 @@
+import { StationPartnershipShareType } from '../consts/station-partnership-share-type.const';
+
+export const PLATFORM_MIN_SHARE_PERCENT = 10;
+export const MAX_PARTNER_SHARE_PERCENT = 90;
+
+const FULL_SHARE_MINOR = 10000;
+const MAX_PARTNER_SHARE_MINOR = MAX_PARTNER_SHARE_PERCENT * 100;
+
+export interface PartnershipShareInput {
+  shareType: StationPartnershipShareType;
+  percent: string | null;
+  amountPerKwh: string | null;
+}
+
+export const PARTNER_SHARE_CAP_ERROR =
+  'Partner shares cannot exceed 90% of the kWh price. SpotCharge keeps at least 10%.';
+
+export const PARTNER_SHARE_TARIFF_REQUIRED_ERROR =
+  'Set a tariff on this charger size before using rupee partnership shares.';
+
+export function toShareMinorUnits(value: string): number | null {
+  const match = /^(\d{1,8})(?:\.(\d{1,2}))?$/.exec(String(value ?? '').trim());
+  if (!match) {
+    return null;
+  }
+  const fraction = match[2] ?? '';
+  return Number(match[1]) * 100 + Number((fraction + '00').slice(0, 2));
+}
+
+/** Partner share total in minor units (10000 = 100%) for one energy rate. */
+export function partnerShareSumMinorForRate(
+  partners: PartnershipShareInput[],
+  energyRate: number,
+): number | null {
+  let sum = 0;
+  for (const row of partners) {
+    if (row.shareType === StationPartnershipShareType.PerKwh) {
+      const amountMinor = toShareMinorUnits(row.amountPerKwh ?? '');
+      if (amountMinor === null || amountMinor <= 0 || energyRate <= 0) {
+        return null;
+      }
+      const amount = amountMinor / 100;
+      sum += Math.round((amount / energyRate) * FULL_SHARE_MINOR);
+      continue;
+    }
+    const minor = toShareMinorUnits(row.percent ?? '');
+    if (minor === null || minor <= 0) {
+      return null;
+    }
+    sum += minor;
+  }
+  return sum;
+}
+
+/** Partner share total when every row is a typed percent (no tariff needed). */
+export function partnerShareSumMinorPercentOnly(partners: PartnershipShareInput[]): number | null {
+  let sum = 0;
+  for (const row of partners) {
+    if (row.shareType === StationPartnershipShareType.PerKwh) {
+      return null;
+    }
+    const minor = toShareMinorUnits(row.percent ?? '');
+    if (minor === null || minor <= 0) {
+      return null;
+    }
+    sum += minor;
+  }
+  return sum;
+}
+
+export function validatePartnerShareTotals(
+  partners: PartnershipShareInput[],
+  energyRates: number[],
+): string | null {
+  const usableRates = Array.from(new Set(energyRates.filter((rate) => rate > 0)));
+  const hasRupee = partners.some((row) => row.shareType === StationPartnershipShareType.PerKwh);
+
+  if (hasRupee && usableRates.length === 0) {
+    return PARTNER_SHARE_TARIFF_REQUIRED_ERROR;
+  }
+
+  if (hasRupee) {
+    for (const rate of usableRates) {
+      const sum = partnerShareSumMinorForRate(partners, rate);
+      if (sum === null) {
+        return PARTNER_SHARE_TARIFF_REQUIRED_ERROR;
+      }
+      if (sum > MAX_PARTNER_SHARE_MINOR) {
+        return PARTNER_SHARE_CAP_ERROR;
+      }
+    }
+    return null;
+  }
+
+  const sum = partnerShareSumMinorPercentOnly(partners);
+  if (sum === null) {
+    return null;
+  }
+  if (sum > MAX_PARTNER_SHARE_MINOR) {
+    return PARTNER_SHARE_CAP_ERROR;
+  }
+  return null;
+}
+
+/** SpotCharge remainder as a percent of the kWh price (0–100), for display. */
+export function platformKeepsPercentAtRate(
+  partners: PartnershipShareInput[],
+  energyRate: number | null,
+): number | null {
+  const sum =
+    energyRate != null && energyRate > 0
+      ? partnerShareSumMinorForRate(partners, energyRate)
+      : partnerShareSumMinorPercentOnly(partners);
+  if (sum === null) {
+    return null;
+  }
+  return Math.max(0, (FULL_SHARE_MINOR - sum) / 100);
+}
+
+/** Highest partner total across applicable tariff rates (minor units). */
+export function maxPartnerShareSumMinor(
+  partners: PartnershipShareInput[],
+  energyRates: number[],
+): number | null {
+  const usableRates = energyRates.filter((rate) => rate > 0);
+  const hasRupee = partners.some((row) => row.shareType === StationPartnershipShareType.PerKwh);
+
+  if (hasRupee) {
+    if (usableRates.length === 0) {
+      return null;
+    }
+    let max = 0;
+    for (const rate of usableRates) {
+      const sum = partnerShareSumMinorForRate(partners, rate);
+      if (sum === null) {
+        return null;
+      }
+      max = Math.max(max, sum);
+    }
+    return max;
+  }
+
+  return partnerShareSumMinorPercentOnly(partners);
+}
+
+export function remainingPartnerSharePercent(
+  partners: PartnershipShareInput[],
+  energyRates: number[],
+): number | null {
+  const sumMinor = maxPartnerShareSumMinor(partners, energyRates);
+  if (sumMinor === null) {
+    return null;
+  }
+  return Math.max(0, (MAX_PARTNER_SHARE_MINOR - sumMinor) / 100);
+}