onroute-policy-engine 2.13.0 → 2.15.0

package/dist/enum/policy-check.d.ts

@@ -10,6 +10,7 @@ export declare enum PolicyCheckId {
     MaxTireLoad = "max-tire-load",
     MinDriveAxleWeight = "minimum-drive-axle-weight",
     MinSteerAxleWeight = "minimum-steer-axle-weight",
+    MinTandemSteerAxleWeight = "minimum-tandem-steer-axle-weight",
     NumberOfAxles = "number-of-axles",
     NumberOfWheelsPerAxle = "number-of-wheels",
     TruckTractorWheelbase = "truck-tractor-wheelbase"

package/dist/enum/policy-check.js

@@ -15,6 +15,7 @@ var PolicyCheckId;
     PolicyCheckId["MaxTireLoad"] = "max-tire-load";
     PolicyCheckId["MinDriveAxleWeight"] = "minimum-drive-axle-weight";
     PolicyCheckId["MinSteerAxleWeight"] = "minimum-steer-axle-weight";
+    PolicyCheckId["MinTandemSteerAxleWeight"] = "minimum-tandem-steer-axle-weight";
     PolicyCheckId["NumberOfAxles"] = "number-of-axles";
     PolicyCheckId["NumberOfWheelsPerAxle"] = "number-of-wheels";
     PolicyCheckId["TruckTractorWheelbase"] = "truck-tractor-wheelbase";

package/dist/helper/policy-check.helper.d.ts

@@ -58,9 +58,9 @@ export declare function CheckBridgeFormula(policy: Policy, _vehicleConfiguration
  * Validates the number of tires per axle unit against regulatory requirements.
  *
  * This function checks that each axle unit has a valid number of tires based on
- * the number of axles in that unit. The validation allows for 2, 4, or 8 tires
- * per axle (2, 4, or 8 * number of axles). This ensures compliance with tire
- * count regulations for commercial vehicles.
+ * the number of axles in that unit and the axle unit position. Axle unit 1 is
+ * the steer axle unit, axle unit 2 is the drive axle unit, and axle units 3+
+ * use the generic axle unit allowance.
  *
  * @param _policy - The policy instance (unused in this check, but required by PolicyCheck type)
  * @param _vehicleConfiguration - Vehicle configuration (unused in this check, but required by PolicyCheck type)
@@ -70,15 +70,15 @@ export declare function CheckBridgeFormula(policy: Policy, _vehicleConfiguration
  * @example
  * // For a vehicle with 2 axle units
  * const results = CheckNumTiresPerAxle(policy, ['TRKTRAC'], [
- *   { numberOfAxles: 2, numberOfTires: 4 },  // 2 axles × 2 tires = 4 (valid)
- *   { numberOfAxles: 3, numberOfTires: 12 }  // 3 axles × 4 tires = 12 (valid)
+ *   { numberOfAxles: 2, numberOfTires: 4 },  // tandem steer: 4 (valid)
+ *   { numberOfAxles: 3, numberOfTires: 12 }  // tridem drive: 12 (valid)
  * ]);
  * // Returns pass results for both axle units
  *
  * @example
  * // Invalid tire count example
  * const results = CheckNumTiresPerAxle(policy, ['TRKTRAC'], [
- *   { numberOfAxles: 2, numberOfTires: 6 }  // 2 axles × 3 tires = 6 (invalid - not 2, 4, or 8 per axle)
+ *   { numberOfAxles: 1, numberOfTires: 8 }  // single drive: 8 (invalid)
  * ]);
  * // Returns fail result for the axle unit
  *
@@ -156,7 +156,7 @@ export declare function CheckPermittableWeight(policy: Policy, vehicleConfigurat
  * @example
  * // For a single steer, tridem drive configuration
  * const results = CheckMinSteerAxleWeight(policy, ['TRKTRAC'], [
- *   { numberOfAxles: 1, axleUnitWeight: 8000 },  // Steer axle
+ *   { numberOfAxles: 1, axleUnitWeight: 8000 },  // Single steer axle
  *   { numberOfAxles: 3, axleUnitWeight: 30000 }  // Tridem drive axle
  * ]);
  * // Returns pass if steer axle weight >= 27% of drive axle weight (8100 kgs)
@@ -165,6 +165,17 @@ export declare function CheckPermittableWeight(policy: Policy, vehicleConfigurat
  * @see AxleGroupPolicyCheckResult
  */
 export declare function CheckMinSteerAxleWeight(_policy: Policy, _vehicleConfiguration: Array<string>, axleConfiguration: Array<AxleConfiguration>): Array<PolicyCheckResult>;
+/**
+ * Validates minimum tandem steer axle weight requirements for tandem steer
+ * power units with tandem or tridem drive axle units. The tandem steer axle
+ * unit must carry at least 40% of the drive axle unit weight.
+ *
+ * @param _policy - The policy instance (unused in this check, but required by PolicyCheck type)
+ * @param _vehicleConfiguration - Vehicle configuration (unused in this check, but required by PolicyCheck type)
+ * @param axleConfiguration - Array of axle configurations containing weight and axle count information
+ * @returns Array of AxleGroupPolicyCheckResult objects with validation results
+ */
+export declare function CheckMinTandemSteerAxleWeight(_policy: Policy, _vehicleConfiguration: Array<string>, axleConfiguration: Array<AxleConfiguration>): Array<PolicyCheckResult>;
 /**
  * Validates minimum drive axle weight requirements for tandem and tridem drive power units.
  *
@@ -284,6 +295,7 @@ export declare function CheckDriveJeepLoadEqualization(_policy: Policy, vehicleC
  * - MaxTireLoad: Validates tire load capacity for each axle unit
  * - MinDriveAxleWeight: Validates minimum weight requirements for drive axles
  * - MinSteerAxleWeight: Validates minimum weight requirements for steer axles
+ * - MinTandemSteerAxleWeight: Validates tandem steer minimum weight requirements
  * - NumberOfAxles: Validates axle count per axle unit
  * - NumberOfWheelsPerAxle: Validates tire count per axle unit
  * - BoosterAxleLimit: Validates booster axle count against the preceding trailer

package/dist/helper/policy-check.helper.js

@@ -6,6 +6,7 @@ exports.CheckBridgeFormula = CheckBridgeFormula;
 exports.CheckNumTiresPerAxle = CheckNumTiresPerAxle;
 exports.CheckPermittableWeight = CheckPermittableWeight;
 exports.CheckMinSteerAxleWeight = CheckMinSteerAxleWeight;
+exports.CheckMinTandemSteerAxleWeight = CheckMinTandemSteerAxleWeight;
 exports.CheckMinDriveAxleWeight = CheckMinDriveAxleWeight;
 exports.CheckMaxTireLoad = CheckMaxTireLoad;
 exports.CheckBoosterAxleLimit = CheckBoosterAxleLimit;
@@ -13,6 +14,9 @@ exports.CheckTruckTractorWheelbase = CheckTruckTractorWheelbase;
 exports.CheckDriveJeepLoadEqualization = CheckDriveJeepLoadEqualization;
 const dimensions_helper_1 = require("./dimensions.helper");
 const enum_1 = require("../enum");
+function meetsMinimumSteerPercentageOfDriveAxleWeight(steerAxle, driveAxle, minimumPercentage) {
+    return (steerAxle.axleUnitWeight >= driveAxle.axleUnitWeight * minimumPercentage);
+}
 /**
  * Validates the number of axles in each axle unit.
  *
@@ -100,9 +104,9 @@ function CheckBridgeFormula(policy, _vehicleConfiguration, axleConfiguration) {
  * Validates the number of tires per axle unit against regulatory requirements.
  *
  * This function checks that each axle unit has a valid number of tires based on
- * the number of axles in that unit. The validation allows for 2, 4, or 8 tires
- * per axle (2, 4, or 8 * number of axles). This ensures compliance with tire
- * count regulations for commercial vehicles.
+ * the number of axles in that unit and the axle unit position. Axle unit 1 is
+ * the steer axle unit, axle unit 2 is the drive axle unit, and axle units 3+
+ * use the generic axle unit allowance.
  *
  * @param _policy - The policy instance (unused in this check, but required by PolicyCheck type)
  * @param _vehicleConfiguration - Vehicle configuration (unused in this check, but required by PolicyCheck type)
@@ -112,15 +116,15 @@ function CheckBridgeFormula(policy, _vehicleConfiguration, axleConfiguration) {
  * @example
  * // For a vehicle with 2 axle units
  * const results = CheckNumTiresPerAxle(policy, ['TRKTRAC'], [
- *   { numberOfAxles: 2, numberOfTires: 4 },  // 2 axles × 2 tires = 4 (valid)
- *   { numberOfAxles: 3, numberOfTires: 12 }  // 3 axles × 4 tires = 12 (valid)
+ *   { numberOfAxles: 2, numberOfTires: 4 },  // tandem steer: 4 (valid)
+ *   { numberOfAxles: 3, numberOfTires: 12 }  // tridem drive: 12 (valid)
  * ]);
  * // Returns pass results for both axle units
  *
  * @example
  * // Invalid tire count example
  * const results = CheckNumTiresPerAxle(policy, ['TRKTRAC'], [
- *   { numberOfAxles: 2, numberOfTires: 6 }  // 2 axles × 3 tires = 6 (invalid - not 2, 4, or 8 per axle)
+ *   { numberOfAxles: 1, numberOfTires: 8 }  // single drive: 8 (invalid)
  * ]);
  * // Returns fail result for the axle unit
  *
@@ -143,7 +147,10 @@ function CheckNumTiresPerAxle(_policy, _vehicleConfiguration, axleConfiguration)
             message = `Number of axles for axle unit ${axleNum} is not permittable.`;
         }
         else {
-            const checkResult = [numAxles * 2, numAxles * 4, numAxles * 8].includes(numTires);
+            const multipliers = axleNum === 1 ? [2] : axleNum === 2 ? [2, 4] : [2, 4, 8];
+            const checkResult = multipliers
+                .map((multiplier) => numAxles * multiplier)
+                .includes(numTires);
             message = checkResult
                 ? `No. of Wheels for Axle Unit ${axleNum} is permittable.`
                 : `No. of Wheels for Axle Unit ${axleNum} is not permittable.`;
@@ -300,7 +307,7 @@ function CheckPermittableWeight(policy, vehicleConfiguration, axleConfiguration)
  * @example
  * // For a single steer, tridem drive configuration
  * const results = CheckMinSteerAxleWeight(policy, ['TRKTRAC'], [
- *   { numberOfAxles: 1, axleUnitWeight: 8000 },  // Steer axle
+ *   { numberOfAxles: 1, axleUnitWeight: 8000 },  // Single steer axle
  *   { numberOfAxles: 3, axleUnitWeight: 30000 }  // Tridem drive axle
  * ]);
  * // Returns pass if steer axle weight >= 27% of drive axle weight (8100 kgs)
@@ -315,14 +322,13 @@ function CheckMinSteerAxleWeight(_policy, _vehicleConfiguration, axleConfigurati
     if (axleConfiguration[0].numberOfAxles === 1 &&
         axleConfiguration[1].numberOfAxles === 3) {
         // Check minimum load on steer axle
-        if (axleConfiguration[0].axleUnitWeight >=
-            axleConfiguration[1].axleUnitWeight * 0.27) {
-            message = 'Steer axle meets minimum weight requirements';
+        if (meetsMinimumSteerPercentageOfDriveAxleWeight(axleConfiguration[0], axleConfiguration[1], 0.27)) {
+            message = 'Single steer axle meets minimum weight requirements';
             result = enum_1.PolicyCheckResultType.Pass;
         }
         else {
             message =
-                'Steer axle must be a minimum of 27% of tridem drive axle weight';
+                'Single steer axle must be a minimum of 27% of tridem drive axle weight';
             result = enum_1.PolicyCheckResultType.Fail;
         }
     }
@@ -340,6 +346,47 @@ function CheckMinSteerAxleWeight(_policy, _vehicleConfiguration, axleConfigurati
     });
     return policyCheckResults;
 }
+/**
+ * Validates minimum tandem steer axle weight requirements for tandem steer
+ * power units with tandem or tridem drive axle units. The tandem steer axle
+ * unit must carry at least 40% of the drive axle unit weight.
+ *
+ * @param _policy - The policy instance (unused in this check, but required by PolicyCheck type)
+ * @param _vehicleConfiguration - Vehicle configuration (unused in this check, but required by PolicyCheck type)
+ * @param axleConfiguration - Array of axle configurations containing weight and axle count information
+ * @returns Array of AxleGroupPolicyCheckResult objects with validation results
+ */
+function CheckMinTandemSteerAxleWeight(_policy, _vehicleConfiguration, axleConfiguration) {
+    const policyCheckResults = new Array();
+    const policyId = enum_1.PolicyCheckId.MinTandemSteerAxleWeight;
+    const steerAxle = axleConfiguration[0];
+    const driveAxle = axleConfiguration[1];
+    let message, result;
+    if (steerAxle.numberOfAxles === 2 &&
+        (driveAxle.numberOfAxles === 2 || driveAxle.numberOfAxles === 3)) {
+        if (meetsMinimumSteerPercentageOfDriveAxleWeight(steerAxle, driveAxle, 0.4)) {
+            message = 'Tandem steer axle meets minimum weight requirements';
+            result = enum_1.PolicyCheckResultType.Pass;
+        }
+        else {
+            message =
+                'Tandem steer axle must be a minimum of 40% of drive axle weight';
+            result = enum_1.PolicyCheckResultType.Fail;
+        }
+    }
+    else {
+        message = 'Policy check does not apply to this configuration';
+        result = enum_1.PolicyCheckResultType.Pass;
+    }
+    policyCheckResults.push({
+        id: policyId,
+        message: message,
+        result: result,
+        startAxleUnit: 1,
+        endAxleUnit: 2,
+    });
+    return policyCheckResults;
+}
 /**
  * Validates minimum drive axle weight requirements for tandem and tridem drive power units.
  *
@@ -760,6 +807,7 @@ function CheckDriveJeepLoadEqualization(_policy, vehicleConfiguration, axleConfi
  * - MaxTireLoad: Validates tire load capacity for each axle unit
  * - MinDriveAxleWeight: Validates minimum weight requirements for drive axles
  * - MinSteerAxleWeight: Validates minimum weight requirements for steer axles
+ * - MinTandemSteerAxleWeight: Validates tandem steer minimum weight requirements
  * - NumberOfAxles: Validates axle count per axle unit
  * - NumberOfWheelsPerAxle: Validates tire count per axle unit
  * - BoosterAxleLimit: Validates booster axle count against the preceding trailer
@@ -777,6 +825,7 @@ exports.policyCheckMap = new Map([
     [enum_1.PolicyCheckId.MaxTireLoad, CheckMaxTireLoad],
     [enum_1.PolicyCheckId.MinDriveAxleWeight, CheckMinDriveAxleWeight],
     [enum_1.PolicyCheckId.MinSteerAxleWeight, CheckMinSteerAxleWeight],
+    [enum_1.PolicyCheckId.MinTandemSteerAxleWeight, CheckMinTandemSteerAxleWeight],
     [enum_1.PolicyCheckId.NumberOfWheelsPerAxle, CheckNumTiresPerAxle],
     [enum_1.PolicyCheckId.BoosterAxleLimit, CheckBoosterAxleLimit],
     [enum_1.PolicyCheckId.TruckTractorWheelbase, CheckTruckTractorWheelbase],

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "v2.13.0";
+export declare const version = "v2.15.0";

package/dist/version.js

@@ -2,4 +2,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // Generated by genversion.
-exports.version = 'v2.13.0';
+exports.version = 'v2.15.0';

package/package.json

@@ -91,5 +91,5 @@
     ],
     "testEnvironment": "node"
   },
-  "version": "v2.13.0"
+  "version": "v2.15.0"
 }