onroute-policy-engine 1.0.0 → 1.2.0

package/dist/enum/validation-result-code.d.ts

@@ -3,5 +3,6 @@ export declare enum ValidationResultCode {
     FieldValidationError = "field-validation-error",
     ConfigurationInvalid = "configuration-invalid",
     GeneralResult = "general-result",
-    CostValue = "cost-value"
+    CostValue = "cost-value",
+    IsLcvCarrier = "lcv-carrier"
 }

package/dist/enum/validation-result-code.js

@@ -8,4 +8,5 @@ var ValidationResultCode;
     ValidationResultCode["ConfigurationInvalid"] = "configuration-invalid";
     ValidationResultCode["GeneralResult"] = "general-result";
     ValidationResultCode["CostValue"] = "cost-value";
+    ValidationResultCode["IsLcvCarrier"] = "lcv-carrier";
 })(ValidationResultCode || (exports.ValidationResultCode = ValidationResultCode = {}));

package/dist/helper/facts.helper.js

@@ -61,6 +61,28 @@ function addRuntimeFacts(engine, policy) {
         }
         return isValid;
     });
+    /**
+     * Add runtime fact to get the list of allowed vehicles taking into
+     * consideration a client special authorization lcv flag.
+     */
+    engine.addFact(enum_1.PolicyFacts.AllowedVehicles.toString(), async function (params, almanac) {
+        let allowedVehicles = [];
+        const permitTypeId = (await almanac.factValue(enum_1.PermitAppInfo.PermitType));
+        const permitType = policy.getPermitTypeDefinition(permitTypeId);
+        if (permitType) {
+            if (permitType.allowedVehicles &&
+                permitType.allowedVehicles.length > 0) {
+                allowedVehicles = permitType.allowedVehicles;
+                // Filter out long combination vehcles if necessary
+                if (!policy.specialAuthorizations ||
+                    !policy.specialAuthorizations.isLcvAllowed) {
+                    allowedVehicles =
+                        policy.filterOutLongCombinationVehicles(allowedVehicles);
+                }
+            }
+        }
+        return allowedVehicles;
+    });
     /**
      * Add runtime fact for a fixed permit cost, the cost supplied
      * as a parameter.

package/dist/helper/rules-engine.helper.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRulesEngines = getRulesEngines;
 const json_rules_engine_1 = require("json-rules-engine");
 const custom_operators_1 = require("../rule-operator/custom-operators");
-const enum_1 = require("onroute-policy-engine/enum");
 /**
  * Gets a json-rules-engine with all onRouteBC custom operators added,
  * and all policy rules that apply to all permit types added.
@@ -60,16 +59,6 @@ function getRulesEngines(policy) {
             };
             engine.addRule(costRule);
         });
-        let allowedVehicles;
-        if (permitType.allowedVehicles && permitType.allowedVehicles.length > 0) {
-            allowedVehicles = permitType.allowedVehicles;
-        }
-        else {
-            // If no allowed vehicles are specified, none are permitted
-            allowedVehicles = [];
-        }
-        // Each permit type should have a list of allowed vehicles configured.
-        engine.addFact(enum_1.PolicyFacts.AllowedVehicles.toString(), allowedVehicles);
         engineMap.set(permitType.id, engine);
     });
     return engineMap;

package/dist/helper/vehicles.helper.d.ts

@@ -0,0 +1,8 @@
+import { VehicleTypes } from '../types';
+/**
+ * Filters out all LCV vehicles from a supplied list of vehicle IDs.
+ * @param vehicleList List of vehicle IDs to filter
+ * @param vehicleTypes Configured vehicle types from policy configuration
+ * @returns
+ */
+export declare function filterOutLcv(vehicleList: Array<string>, vehicleTypes: VehicleTypes): Array<string>;

package/dist/helper/vehicles.helper.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterOutLcv = filterOutLcv;
+/**
+ * Filters out all LCV vehicles from a supplied list of vehicle IDs.
+ * @param vehicleList List of vehicle IDs to filter
+ * @param vehicleTypes Configured vehicle types from policy configuration
+ * @returns
+ */
+function filterOutLcv(vehicleList, vehicleTypes) {
+    const allVehicleTypes = vehicleTypes.powerUnitTypes.concat(vehicleTypes.trailerTypes);
+    const filteredList = vehicleList.filter((v) => {
+        const vType = allVehicleTypes.find((vt) => vt.id === v);
+        if (vType) {
+            if (vType.isLcv) {
+                return false;
+            }
+            else {
+                return true;
+            }
+        }
+        else {
+            console.log(`No configured vehicle type matching '${v}'`);
+            return false;
+        }
+    });
+    return filteredList;
+}

package/dist/policy-engine.d.ts

@@ -1,10 +1,16 @@
 import { PolicyDefinition, PermitType, Commodity, SizeDimension, AxleConfiguration, BridgeCalculationResult } from 'onroute-policy-engine/types';
 import { Engine } from 'json-rules-engine';
 import { ValidationResults } from './validation-results';
+import { SpecialAuthorizations } from './types/special-authorizations';
 /** Class representing commercial vehicle policy. */
 export declare class Policy {
     /** Object representation of policy definition and rules. */
     policyDefinition: PolicyDefinition;
+    /**
+     * Special authorizations granted to a client, used
+     * to adjust validations and allowed vehicles for permit types.
+     */
+    specialAuthorizations?: SpecialAuthorizations | null;
     /**
      * Map of json-rules-engine instances, one for each
      * permit type defined in the permit definition. Keyed
@@ -15,7 +21,13 @@ export declare class Policy {
      * Creates a new Policy object.
      * @param definition Policy definition to validate permits against
      */
-    constructor(definition: PolicyDefinition);
+    constructor(definition: PolicyDefinition, authorizations?: SpecialAuthorizations);
+    /**
+     * Sets a client's special authorizations to modify the policy validations
+     * and permittable vehicles for permit types.
+     * @param authorizations Special authorizations for a client
+     */
+    setSpecialAuthorizations(authorizations: SpecialAuthorizations | null): void;
     /**
      * Validates a permit application against the policy definition.
      * @param permit The permit application to validate against policy
@@ -32,6 +44,13 @@ export declare class Policy {
      * @returns Map of geographic region IDs to region names.
      */
     getGeographicRegions(): Map<string, string>;
+    /**
+     * Filters out all long combination vehicles from the list of supplied
+     * vehicle IDs, based on policy configuration.
+     * @param vehicleList List of vehicles to filter
+     * @returns Filtered list of vehicles without LCVs
+     */
+    filterOutLongCombinationVehicles(vehicleList: Array<string>): Array<string>;
     /**
      * Gets a list of all configured commodities in the policy definition.
      * @param permitTypeId Return only commodities valid for this permit type.

package/dist/policy-engine.js

@@ -15,13 +15,14 @@ const version_1 = require("./version");
 const valid_1 = __importDefault(require("semver/functions/valid"));
 const lt_1 = __importDefault(require("semver/functions/lt"));
 const major_1 = __importDefault(require("semver/functions/major"));
+const vehicles_helper_1 = require("./helper/vehicles.helper");
 /** Class representing commercial vehicle policy. */
 class Policy {
     /**
      * Creates a new Policy object.
      * @param definition Policy definition to validate permits against
      */
-    constructor(definition) {
+    constructor(definition, authorizations) {
         // Check compatibility of the policy engine with the policy config
         if (!(0, valid_1.default)(version_1.version)) {
             throw new Error(`Cannot determine the version of the policy engine for compatibility: invalid semver: ${version_1.version}`);
@@ -36,14 +37,24 @@ class Policy {
             throw new Error(`Current policy config minimum version is at least one major version behind policy engine: major(${definition.minPEVersion}) < major(${version_1.version}))`);
         }
         this.policyDefinition = definition;
+        this.specialAuthorizations = authorizations;
         this.rulesEngines = (0, rules_engine_helper_1.getRulesEngines)(this);
     }
+    /**
+     * Sets a client's special authorizations to modify the policy validations
+     * and permittable vehicles for permit types.
+     * @param authorizations Special authorizations for a client
+     */
+    setSpecialAuthorizations(authorizations) {
+        this.specialAuthorizations = authorizations;
+    }
     /**
      * Validates a permit application against the policy definition.
      * @param permit The permit application to validate against policy
      * @returns Results of the validation of the permit application
      */
     async validate(permit) {
+        var _a;
         const engine = this.rulesEngines.get(permit.permitType);
         if (!engine) {
             // If the permit type being validated has no configuration in the
@@ -60,7 +71,12 @@ class Policy {
             // Run the json-rules-engine against the permit facts
             const engineResult = await engine.run(permit);
             // Wrap the json-rules-engine result in a ValidationResult object
-            return new validation_results_1.ValidationResults(engineResult);
+            const validationResults = new validation_results_1.ValidationResults(engineResult);
+            // Include an informational message if the client is an LCV carrier
+            if ((_a = this.specialAuthorizations) === null || _a === void 0 ? void 0 : _a.isLcvAllowed) {
+                validationResults.information.push(new validation_result_1.ValidationResult(enum_1.ValidationResultType.Information, enum_1.ValidationResultCode.IsLcvCarrier, `Policy validation allowing long combination vahicle permitting for client '${this.specialAuthorizations.companyId}'`));
+            }
+            return validationResults;
         }
     }
     /**
@@ -79,6 +95,15 @@ class Policy {
         const geographicRegions = (0, lists_helper_1.extractIdentifiedObjects)(this.policyDefinition.geographicRegions);
         return geographicRegions;
     }
+    /**
+     * Filters out all long combination vehicles from the list of supplied
+     * vehicle IDs, based on policy configuration.
+     * @param vehicleList List of vehicles to filter
+     * @returns Filtered list of vehicles without LCVs
+     */
+    filterOutLongCombinationVehicles(vehicleList) {
+        return (0, vehicles_helper_1.filterOutLcv)(vehicleList, this.policyDefinition.vehicleTypes);
+    }
     /**
      * Gets a list of all configured commodities in the policy definition.
      * @param permitTypeId Return only commodities valid for this permit type.
@@ -143,7 +168,7 @@ class Policy {
      * vehicle, and a string common name for the vehicle.
      */
     getPermittableVehicleTypes(permitTypeId, commodityId) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         if (!permitTypeId || !commodityId) {
             throw new Error('Missing permitTypeId and/or commodityId');
         }
@@ -170,16 +195,31 @@ class Policy {
             if (!commodity) {
                 throw new Error(`Commodity id '${commodityId}' is not correctly configured in the policy definition`);
             }
-            const puTypeIdsOS = (_b = (_a = commodity.size) === null || _a === void 0 ? void 0 : _a.powerUnits) === null || _b === void 0 ? void 0 : _b.map((p) => p.type);
-            const trTypeIdsOS = [];
+            let puTypeIdsOS = (_b = (_a = commodity.size) === null || _a === void 0 ? void 0 : _a.powerUnits) === null || _b === void 0 ? void 0 : _b.map((p) => p.type);
+            let trTypeIdsOS = [];
             (_d = (_c = commodity.size) === null || _c === void 0 ? void 0 : _c.powerUnits) === null || _d === void 0 ? void 0 : _d.forEach((pu) => {
                 const trForPu = pu.trailers.map((t) => t.type);
                 if (trForPu)
-                    trTypeIdsOS.concat(trForPu);
+                    trTypeIdsOS === null || trTypeIdsOS === void 0 ? void 0 : trTypeIdsOS.concat(trForPu);
             });
             // TODO: implement along with overweight permits. Stub for now.
-            const puTypeIdsOW = [];
-            const trTypeIdsOW = [];
+            let puTypeIdsOW = [];
+            let trTypeIdsOW = [];
+            // Remove long combination vehicles if needed
+            if (!((_e = this.specialAuthorizations) === null || _e === void 0 ? void 0 : _e.isLcvAllowed)) {
+                if (puTypeIdsOS) {
+                    puTypeIdsOS = this.filterOutLongCombinationVehicles(puTypeIdsOS);
+                }
+                if (trTypeIdsOS) {
+                    trTypeIdsOS = this.filterOutLongCombinationVehicles(trTypeIdsOS);
+                }
+                if (puTypeIdsOW) {
+                    puTypeIdsOW = this.filterOutLongCombinationVehicles(puTypeIdsOW);
+                }
+                if (trTypeIdsOW) {
+                    trTypeIdsOW = this.filterOutLongCombinationVehicles(trTypeIdsOW);
+                }
+            }
             const puTypesOS = (0, lists_helper_1.extractIdentifiedObjects)(this.policyDefinition.vehicleTypes.powerUnitTypes, puTypeIdsOS);
             const trTypesOS = (0, lists_helper_1.extractIdentifiedObjects)(this.policyDefinition.vehicleTypes.trailerTypes, trTypeIdsOS);
             const puTypesOW = (0, lists_helper_1.extractIdentifiedObjects)(this.policyDefinition.vehicleTypes.powerUnitTypes, puTypeIdsOW);
@@ -237,7 +277,7 @@ class Policy {
      * trailers in a single return value (if applicable).
      */
     getNextPermittableVehicles(permitTypeId, commodityId, currentConfiguration) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         if (!permitTypeId || !commodityId || !currentConfiguration) {
             throw new Error('Missing permitTypeId and/or commodityId and/or currentConfiguration');
         }
@@ -305,6 +345,12 @@ class Policy {
                 }
             }
         }
+        // Remove long combination vehicles if required
+        if (!((_e = this.specialAuthorizations) === null || _e === void 0 ? void 0 : _e.isLcvAllowed)) {
+            if (vehicleTypeIds) {
+                vehicleTypeIds = this.filterOutLongCombinationVehicles(vehicleTypeIds);
+            }
+        }
         vehicleTypes = (0, lists_helper_1.extractIdentifiedObjects)(allVehicles, vehicleTypeIds);
         return vehicleTypes;
     }
@@ -347,6 +393,16 @@ class Policy {
             // invalid as a complete configuration.
             return validatePartial;
         }
+        if (!this.specialAuthorizations ||
+            !this.specialAuthorizations.isLcvAllowed) {
+            // No provision for allowing long combination vehicles
+            const filteredConfiguration = this.filterOutLongCombinationVehicles(currentConfiguration);
+            if (filteredConfiguration.length !== currentConfiguration.length) {
+                // There is an LCV in the configuration, but we are not allowing
+                // LCV permitting. Return false.
+                return false;
+            }
+        }
         const powerUnit = (_b = (_a = commodity.size) === null || _a === void 0 ? void 0 : _a.powerUnits) === null || _b === void 0 ? void 0 : _b.find((p) => p.type == currentConfiguration[0]);
         if (!powerUnit) {
             // The power unit is not allowed for the commodity

package/dist/types/index.d.ts

@@ -13,6 +13,7 @@ export { Matrix, RangeMatrix } from './range-matrix';
 export { RegionSizeOverride } from './region-size-override';
 export { SelfIssuable } from './self-issuable';
 export { SizeDimension } from './size-dimension';
+export { SpecialAuthorizations } from './special-authorizations';
 export { VehicleCategory, PowerUnitCategory, TrailerCategory, VehicleCategories, } from './vehicle-category';
 export { VehicleType, PowerUnitType, TrailerType, VehicleTypes, } from './vehicle-type';
 export { Vehicle, VehicleSizeConfiguration, TrailerSize, PowerUnitWeight, TrailerWeight, } from './vehicle';

package/dist/types/special-authorizations.d.ts

@@ -0,0 +1,5 @@
+export type SpecialAuthorizations = {
+    companyId: number;
+    isLcvAllowed?: boolean;
+    noFeeType?: string;
+};

package/dist/types/special-authorizations.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/vehicle-type.d.ts

@@ -3,6 +3,7 @@ export type VehicleType = IdentifiedObject & {
     category: string;
     defaultSizeDimensions?: SizeDimension;
     ignoreForSizeDimensions?: boolean;
+    isLcv?: boolean;
 };
 export type PowerUnitType = VehicleType & {
     defaultWeightDimensions?: Array<PowerUnitWeightDimension>;

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "v1.0.0";
+export declare const version = "v1.2.0";

package/dist/version.js

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

package/package.json

@@ -89,5 +89,5 @@
     ],
     "testEnvironment": "node"
   },
-  "version": "v1.0.0"
+  "version": "v1.2.0"
 }