onroute-policy-engine 0.1.0 → 0.2.0

package/README.md

@@ -10,7 +10,7 @@ A JSON-based rules engine to validate onRouteBC permit applications against comm
 import Policy from 'orbc-policy-engine';
 
 // Instantiate a new Policy object
-// policyConfiguration is a JSON object of type PolicyDefinition
+// policyDefinition is a JSON object of type PolicyDefinition
 const policy: Policy = new Policy(policyDefinition);
 
 // Get list of all available permit types (ID and name)
@@ -31,19 +31,20 @@ const commodities: Map<string, string> = policy.getCommodities(permitTypeId);
 // Get list of all vehicle types valid to be added to a configuration,
 // by permit type and commodity. Requires supplying the vehicles already
 // added to the configuration, or empty array if starting from scratch
-const allowableVehicles: Map<string, string> = policy.getAllowableVehicles(
+const allowableVehicles: Map<string, string> = policy.getNextPermittableVehicles(
   permitTypeId, 
   commodityId, 
   currentConfiguration);
 
 // Validate a permit application against policy
 // permitApplication is a JSON object of type PermitApplication
-// A PermitApplication is just the standard permitData object wrapped
+// A PermitApplication is the standard permitData object wrapped
 // in an object with a permitType key. For example:
 // {
 //   permitType: 'TROS',
 //   permitData: { ... }
 // }
-const results: ValidationResults = policy.validate(permitApplication);
+// Note this is an async call due to the reliance on json-rules-engine
+const results: ValidationResults = await policy.validate(permitApplication);
 ```
 

package/dist/enum/accessory-vehicle-type.d.ts

@@ -0,0 +1,4 @@
+export declare enum AccessoryVehicleType {
+    Booster = "BOOSTER",
+    Jeep = "JEEPSRG"
+}

package/dist/enum/accessory-vehicle-type.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccessoryVehicleType = void 0;
+var AccessoryVehicleType;
+(function (AccessoryVehicleType) {
+    AccessoryVehicleType["Booster"] = "BOOSTER";
+    AccessoryVehicleType["Jeep"] = "JEEPSRG";
+})(AccessoryVehicleType || (exports.AccessoryVehicleType = AccessoryVehicleType = {}));

package/dist/enum/facts.d.ts

@@ -1,5 +1,9 @@
 export declare enum PolicyFacts {
     AllowedVehicles = "allowedVehicles",
     DaysInPermitYear = "daysInPermitYear",
-    ValidationDate = "validationDate"
+    ValidationDate = "validationDate",
+    FixedCost = "fixedCost",
+    CostPerMonth = "costPerMonth",
+    RangeMatrixCostLookup = "rangeMatrixCostLookup",
+    ConfigurationIsValid = "configurationIsValid"
 }

package/dist/enum/facts.js

@@ -6,4 +6,8 @@ var PolicyFacts;
     PolicyFacts["AllowedVehicles"] = "allowedVehicles";
     PolicyFacts["DaysInPermitYear"] = "daysInPermitYear";
     PolicyFacts["ValidationDate"] = "validationDate";
+    PolicyFacts["FixedCost"] = "fixedCost";
+    PolicyFacts["CostPerMonth"] = "costPerMonth";
+    PolicyFacts["RangeMatrixCostLookup"] = "rangeMatrixCostLookup";
+    PolicyFacts["ConfigurationIsValid"] = "configurationIsValid";
 })(PolicyFacts || (exports.PolicyFacts = PolicyFacts = {}));

package/dist/enum/index.d.ts

@@ -1,5 +1,7 @@
+export { AccessoryVehicleType } from './accessory-vehicle-type';
 export { PolicyFacts } from './facts';
 export { PermitAppInfo } from './permit-app-info';
 export { RelativePosition } from './relative-position';
 export { ValidationResultCode } from './validation-result-code';
 export { ValidationResultType } from './validation-result-type';
+export { VehicleTypes } from './vehicle-types';

package/dist/enum/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValidationResultType = exports.ValidationResultCode = exports.RelativePosition = exports.PermitAppInfo = exports.PolicyFacts = void 0;
+exports.VehicleTypes = exports.ValidationResultType = exports.ValidationResultCode = exports.RelativePosition = exports.PermitAppInfo = exports.PolicyFacts = exports.AccessoryVehicleType = void 0;
+var accessory_vehicle_type_1 = require("./accessory-vehicle-type");
+Object.defineProperty(exports, "AccessoryVehicleType", { enumerable: true, get: function () { return accessory_vehicle_type_1.AccessoryVehicleType; } });
 var facts_1 = require("./facts");
 Object.defineProperty(exports, "PolicyFacts", { enumerable: true, get: function () { return facts_1.PolicyFacts; } });
 var permit_app_info_1 = require("./permit-app-info");
@@ -11,3 +13,5 @@ var validation_result_code_1 = require("./validation-result-code");
 Object.defineProperty(exports, "ValidationResultCode", { enumerable: true, get: function () { return validation_result_code_1.ValidationResultCode; } });
 var validation_result_type_1 = require("./validation-result-type");
 Object.defineProperty(exports, "ValidationResultType", { enumerable: true, get: function () { return validation_result_type_1.ValidationResultType; } });
+var vehicle_types_1 = require("./vehicle-types");
+Object.defineProperty(exports, "VehicleTypes", { enumerable: true, get: function () { return vehicle_types_1.VehicleTypes; } });

package/dist/enum/permit-app-info.d.ts

@@ -4,7 +4,13 @@
  * referenced from within source code.
  */
 export declare enum PermitAppInfo {
-    PermitStartDate = "permitData.startDate",
+    PermitType = "permitType",
+    PermitData = "permitData",
+    PermitStartDate = "$.startDate",
     PermitDateFormat = "YYYY-MM-DD",
-    CompanyName = "permitData.companyName"
+    CompanyName = "$.companyName",
+    PermitDuration = "$.permitDuration",
+    PowerUnitType = "$.vehicleDetails.vehicleSubType",
+    TrailerList = "$.vehicleConfiguration.trailers",
+    Commodity = "$.permittedCommodity"
 }

package/dist/enum/permit-app-info.js

@@ -8,7 +8,13 @@ exports.PermitAppInfo = void 0;
  */
 var PermitAppInfo;
 (function (PermitAppInfo) {
-    PermitAppInfo["PermitStartDate"] = "permitData.startDate";
+    PermitAppInfo["PermitType"] = "permitType";
+    PermitAppInfo["PermitData"] = "permitData";
+    PermitAppInfo["PermitStartDate"] = "$.startDate";
     PermitAppInfo["PermitDateFormat"] = "YYYY-MM-DD";
-    PermitAppInfo["CompanyName"] = "permitData.companyName";
+    PermitAppInfo["CompanyName"] = "$.companyName";
+    PermitAppInfo["PermitDuration"] = "$.permitDuration";
+    PermitAppInfo["PowerUnitType"] = "$.vehicleDetails.vehicleSubType";
+    PermitAppInfo["TrailerList"] = "$.vehicleConfiguration.trailers";
+    PermitAppInfo["Commodity"] = "$.permittedCommodity";
 })(PermitAppInfo || (exports.PermitAppInfo = PermitAppInfo = {}));

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

@@ -2,5 +2,6 @@ export declare enum ValidationResultCode {
     PermitTypeUnknown = "permit-type-unknown",
     FieldValidationError = "field-validation-error",
     ConfigurationInvalid = "configuration-invalid",
-    GeneralResult = "general-result"
+    GeneralResult = "general-result",
+    CostValue = "cost-value"
 }

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

@@ -7,4 +7,5 @@ var ValidationResultCode;
     ValidationResultCode["FieldValidationError"] = "field-validation-error";
     ValidationResultCode["ConfigurationInvalid"] = "configuration-invalid";
     ValidationResultCode["GeneralResult"] = "general-result";
+    ValidationResultCode["CostValue"] = "cost-value";
 })(ValidationResultCode || (exports.ValidationResultCode = ValidationResultCode = {}));

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

@@ -2,5 +2,6 @@ export declare enum ValidationResultType {
     Violation = "violation",
     Requirement = "requirement",
     Warning = "warning",
-    Information = "information"
+    Information = "information",
+    Cost = "cost"
 }

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

@@ -7,4 +7,5 @@ var ValidationResultType;
     ValidationResultType["Requirement"] = "requirement";
     ValidationResultType["Warning"] = "warning";
     ValidationResultType["Information"] = "information";
+    ValidationResultType["Cost"] = "cost";
 })(ValidationResultType || (exports.ValidationResultType = ValidationResultType = {}));

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

@@ -0,0 +1,4 @@
+export declare enum VehicleTypes {
+    PowerUnits = "powerUnits",
+    Trailers = "trailers"
+}

package/dist/enum/vehicle-types.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VehicleTypes = void 0;
+var VehicleTypes;
+(function (VehicleTypes) {
+    VehicleTypes["PowerUnits"] = "powerUnits";
+    VehicleTypes["Trailers"] = "trailers";
+})(VehicleTypes || (exports.VehicleTypes = VehicleTypes = {}));

package/dist/helper/facts.helper.d.ts

@@ -1,15 +1,8 @@
 import { Engine } from 'json-rules-engine';
-import { PermitFacts } from 'onroute-policy-engine/types';
+import { Policy } from '../policy-engine';
 /**
  * Adds runtime facts for the validation. For example, adds the
  * validation date for comparison against startDate of the permit.
  * @param engine json-rules-engine Engine instance to add facts to.
  */
-export declare function addRuntimeFacts(engine: Engine): void;
-/**
- * Flattens the permit application, using keys taken from the PermitFacts enum so
- * the facts can be used more easily within validation rules.
- * @param permitApplication Permit application object to flatten.
- * @returns Flattened permit application object for validation.
- */
-export declare function transformPermitFacts(permitApplication: any): PermitFacts;
+export declare function addRuntimeFacts(engine: Engine, policy: Policy): void;

package/dist/helper/facts.helper.js

@@ -3,39 +3,76 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.transformPermitFacts = exports.addRuntimeFacts = void 0;
+exports.addRuntimeFacts = void 0;
 const dayjs_1 = __importDefault(require("dayjs"));
-const flattie_1 = require("flattie");
 const enum_1 = require("onroute-policy-engine/enum");
 /**
  * Adds runtime facts for the validation. For example, adds the
  * validation date for comparison against startDate of the permit.
  * @param engine json-rules-engine Engine instance to add facts to.
  */
-function addRuntimeFacts(engine) {
-    const today = (0, dayjs_1.default)().format(enum_1.PermitAppInfo.PermitDateFormat.toString());
-    engine.addFact(enum_1.PolicyFacts.ValidationDate.toString(), today);
-    // Will be either 365 or 366, for use when comparing against
-    // duration for 1 year permits.
-    engine.addFact(enum_1.PolicyFacts.DaysInPermitYear.toString(), async function (params, almanac) {
-        const startDate = await almanac.factValue(enum_1.PermitAppInfo.PermitStartDate.toString());
-        const dateFrom = (0, dayjs_1.default)(startDate, enum_1.PermitAppInfo.PermitDateFormat.toString());
-        return dateFrom.diff(dateFrom.add(1, 'year'), 'day');
+function addRuntimeFacts(engine, policy) {
+    const today = (0, dayjs_1.default)().format(enum_1.PermitAppInfo.PermitDateFormat);
+    engine.addFact(enum_1.PolicyFacts.ValidationDate, today);
+    /**
+     * Add runtime fact for number of days in the permit year.
+     * Will be either 365 or 366, for use when comparing against
+     * duration for 1 year permits.
+     */
+    engine.addFact(enum_1.PolicyFacts.DaysInPermitYear, async function (params, almanac) {
+        const startDate = await almanac.factValue(enum_1.PermitAppInfo.PermitData, {}, enum_1.PermitAppInfo.PermitStartDate);
+        const dateFrom = (0, dayjs_1.default)(startDate, enum_1.PermitAppInfo.PermitDateFormat);
+        const daysInPermitYear = dateFrom.add(1, 'year').diff(dateFrom, 'day');
+        return daysInPermitYear;
+    });
+    /**
+     * Adds a runtime fact specifying whether the vehicle configuration
+     * in the permit application is valid for the permit type and
+     * commodity. Will return true or false.
+     */
+    engine.addFact(enum_1.PolicyFacts.ConfigurationIsValid.toString(), async function (params, almanac) {
+        const powerUnit = await almanac.factValue(enum_1.PermitAppInfo.PermitData, {}, enum_1.PermitAppInfo.PowerUnitType);
+        const trailerList = await almanac.factValue(enum_1.PermitAppInfo.PermitData, {}, enum_1.PermitAppInfo.TrailerList);
+        let fullVehicleConfiguration = [];
+        fullVehicleConfiguration.push(powerUnit);
+        fullVehicleConfiguration = fullVehicleConfiguration.concat(trailerList.map((t) => t.vehicleSubType));
+        const permitType = await almanac.factValue(enum_1.PermitAppInfo.PermitType);
+        const commodity = await almanac.factValue(enum_1.PermitAppInfo.PermitData, {}, enum_1.PermitAppInfo.Commodity);
+        let isValid;
+        try {
+            isValid = policy.isConfigurationValid(permitType, commodity, fullVehicleConfiguration);
+        }
+        catch (e) {
+            console.log(`Error validating vehicle configuration: '{e.message}'`);
+            isValid = false;
+        }
+        return isValid;
+    });
+    /**
+     * Add runtime fact for a fixed permit cost, the cost supplied
+     * as a parameter.
+     */
+    engine.addFact(enum_1.PolicyFacts.FixedCost.toString(), async function (params) {
+        return params.cost;
+    });
+    /**
+     * Add runtime fact for cost per month, where month is defined by
+     * policy as a 30 day period or portion thereof, except in the
+     * case of a full year in which case it is 12 months.
+     */
+    engine.addFact(enum_1.PolicyFacts.CostPerMonth.toString(), async function (params, almanac) {
+        const duration = await almanac.factValue(enum_1.PermitAppInfo.PermitData, {}, enum_1.PermitAppInfo.PermitDuration);
+        const daysInPermitYear = await almanac.factValue(enum_1.PolicyFacts.DaysInPermitYear.toString());
+        let months = Math.floor(duration / 30);
+        const extraDays = duration % 30;
+        if (extraDays > 0 && duration !== daysInPermitYear) {
+            // Add an extra month for a partial month unless it is
+            // a full year. Note this does not handle the case where 2
+            // or more years duration is specified, since that is not
+            // a valid permit and does not warrant considetation.
+            months++;
+        }
+        return months * params.cost;
     });
 }
 exports.addRuntimeFacts = addRuntimeFacts;
-/**
- * Flattens the permit application, using keys taken from the PermitFacts enum so
- * the facts can be used more easily within validation rules.
- * @param permitApplication Permit application object to flatten.
- * @returns Flattened permit application object for validation.
- */
-function transformPermitFacts(permitApplication) {
-    // Flatten the permit application so all properties can be accessed
-    // by key
-    const permitFacts = (0, flattie_1.flattie)(permitApplication);
-    // Add the app itself as a fact to be used by more complex rules
-    permitFacts.app = permitApplication;
-    return permitFacts;
-}
-exports.transformPermitFacts = transformPermitFacts;

package/dist/helper/lists.helper.d.ts

@@ -9,3 +9,16 @@ import { IdentifiedObject } from 'onroute-policy-engine/types';
  * @returns Map of object ID to object name.
  */
 export declare function extractIdentifiedObjects(objects: Array<IdentifiedObject>, filter?: Array<string>): Map<string, string>;
+/**
+ * Intersects two maps containing string id and string description to
+ * return a new map containing those entries common to both.
+ * This only checks that the keys are common, not the values. If the
+ * values are different, this returns the value from the first map.
+ * If any values in the first map are null or undefined, these will
+ * be replaced with empty string.
+ * @param first The first map
+ * @param second The second map
+ * @returns New map containing entries common to both input maps
+ */
+export declare function intersectIdMaps(first: Map<string, string>, second: Map<string, string>): Map<string, string>;
+export declare function getIdFromName(list: Array<IdentifiedObject>, name: string): string | null;

package/dist/helper/lists.helper.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractIdentifiedObjects = void 0;
+exports.getIdFromName = exports.intersectIdMaps = exports.extractIdentifiedObjects = void 0;
 /**
  * Extracts a map containing just the ID and name of each of the supplied
  * identified objects.
@@ -20,3 +20,34 @@ function extractIdentifiedObjects(objects, filter) {
     return objectMap;
 }
 exports.extractIdentifiedObjects = extractIdentifiedObjects;
+/**
+ * Intersects two maps containing string id and string description to
+ * return a new map containing those entries common to both.
+ * This only checks that the keys are common, not the values. If the
+ * values are different, this returns the value from the first map.
+ * If any values in the first map are null or undefined, these will
+ * be replaced with empty string.
+ * @param first The first map
+ * @param second The second map
+ * @returns New map containing entries common to both input maps
+ */
+function intersectIdMaps(first, second) {
+    var _a;
+    const combinedMap = new Map();
+    for (const key in first.keys()) {
+        if (second.has(key)) {
+            combinedMap.set(key, (_a = first.get(key)) !== null && _a !== void 0 ? _a : '');
+        }
+    }
+    return combinedMap;
+}
+exports.intersectIdMaps = intersectIdMaps;
+function getIdFromName(list, name) {
+    let id = null;
+    const identifiedObject = list.find((i) => i.name == name);
+    if (identifiedObject) {
+        id = identifiedObject.id;
+    }
+    return id;
+}
+exports.getIdFromName = getIdFromName;

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

@@ -11,7 +11,10 @@ const enum_1 = require("onroute-policy-engine/enum");
  * @returns json-rules-engine Engine instance.
  */
 function getEngine(policyDefinition) {
-    const engine = new json_rules_engine_1.Engine();
+    const engine = new json_rules_engine_1.Engine([], {
+        replaceFactsInEventParams: true,
+        allowUndefinedFacts: true,
+    });
     custom_operators_1.CustomOperators.forEach((o) => engine.addOperator(o));
     policyDefinition.commonRules.forEach((r) => engine.addRule(r));
     return engine;
@@ -27,9 +30,36 @@ function getRulesEngines(policy) {
     var _a, _b;
     const engineMap = new Map();
     (_b = (_a = policy.policyDefinition) === null || _a === void 0 ? void 0 : _a.permitTypes) === null || _b === void 0 ? void 0 : _b.forEach((permitType) => {
-        var _a;
+        var _a, _b;
         const engine = getEngine(policy.policyDefinition);
         (_a = permitType.rules) === null || _a === void 0 ? void 0 : _a.forEach((r) => engine.addRule(r));
+        // Convert the cost definitions into proper rules so the
+        // results can be added to the validation run. This takes advantage
+        // of the replaceFactsInEventParams option for the json-rules-engine
+        // Engine object.
+        (_b = permitType.costRules) === null || _b === void 0 ? void 0 : _b.forEach((c) => {
+            const costRule = {
+                conditions: {
+                    all: [
+                        {
+                            fact: c.fact,
+                            params: c.params,
+                            operator: 'greaterThanInclusive',
+                            value: 0,
+                        },
+                    ],
+                },
+                event: {
+                    type: 'cost',
+                    params: {
+                        message: 'Calculated permit cost',
+                        code: 'cost-value',
+                        cost: c,
+                    },
+                },
+            };
+            engine.addRule(costRule);
+        });
         let allowedVehicles;
         if (permitType.allowedVehicles && permitType.allowedVehicles.length > 0) {
             allowedVehicles = permitType.allowedVehicles;

package/dist/policy-engine.d.ts

@@ -1,4 +1,4 @@
-import { PolicyDefinition, PermitType } from 'onroute-policy-engine/types';
+import { PolicyDefinition, PermitType, Commodity, SizeDimension } from 'onroute-policy-engine/types';
 import { Engine } from 'json-rules-engine';
 import { ValidationResults } from './validation-results';
 /** Class representing commercial vehicle policy. */
@@ -36,10 +36,84 @@ export declare class Policy {
      * Gets a list of all configured commodities in the policy definition.
      * @param permitTypeId Return only commodities valid for this permit type.
      *   If not supplied, return all commodities configured in policy. If permit
-     *   type does not require commodity (e.g. 'TROS'), return all commodities.
+     *   type does not require commodity (e.g. 'TROS'), return empty map.
      * @returns Map of commodity IDs to commodity names.
      */
     getCommodities(permitTypeId?: string): Map<string, string>;
+    /**
+     * Gets a list of all allowable vehicle types for the given permit type
+     * and commodity. Includes all power units and trailers.
+     * @param permitTypeId ID of the permit type to get vehicles for
+     * @param commodityId ID of the commodity to get vehicles for
+     * @returns Map of two separate maps, one keyed on 'powerUnits' and the
+     * other keyed on 'trailers'. Each map consists of a string id for the
+     * vehicle, and a string common name for the vehicle.
+     */
+    getPermittableVehicleTypes(permitTypeId: string, commodityId: string): Map<string, Map<string, string>>;
+    /**
+     * Gets a list of all allowable power unit types for the given permit type
+     * and commodity.
+     * @param permitTypeId ID of the permit type to get power units for
+     * @param commodityId ID of the commodity to get power units for
+     * @returns Map of power unit IDs to power unit names.
+     */
+    getPermittablePowerUnitTypes(permitTypeId: string, commodityId: string): Map<string, string>;
+    /**
+     * Gets the next permittable vehicles based on the supplied permit type,
+     * commodity, and current configuration.
+     * If the permit type does not require commodity or if the commodity
+     * is not valid for the permit type, this will return an empty map
+     * (meaning no vehicles are permittable).
+     * @param permitTypeId ID of the permit type to get vehicles for
+     * @param commodityId ID of the commodity to get vehicles for
+     * @param currentConfiguration Current vehicle configuration to which will be
+     * added the next permittable vehicle
+     * @returns Map of vehicle ID to vehicle name. Includes both power units and
+     * trailers in a single return value (if applicable).
+     */
+    getNextPermittableVehicles(permitTypeId: string, commodityId: string, currentConfiguration: Array<string>): Map<string, string>;
+    /**
+     * Returns whether the supplied configuration is valid for the given permit type
+     * and commodity. If the permit type does not require a commodity, this method
+     * will return false. This will not validate incomplete configurations - if the
+     * current configuration has only a power unit this will return false even if the
+     * power unit is acceptable because there is no trailer which is mandatory.
+     * If this is called for a permit type that does not require commodity, or with
+     * a commodity not permitted for the permit type, it will return false.
+     * @param permitTypeId ID of the permit type to validate the configuration against
+     * @param commodityId ID of the commodity used for the configuration
+     * @param currentConfiguration Current vehicle configuration to validate
+     * @param validatePartial Whether to validate a partial configuration (e.g. one
+     * that does not include a trailer). This will just return whether or not there
+     * are any invalid vehicles in the configuration. If true, an empty current
+     * configuration will return true from this method.
+     */
+    isConfigurationValid(permitTypeId: string, commodityId: string, currentConfiguration: Array<string>, validatePartial?: boolean): boolean;
+    /**
+     * Gets the maximum size dimensions for a given permit type, commodity,
+     * and vehicle configuration. A vehicle configuration's size dimension is
+     * dictated by the configuration on the trailer. For configurations that
+     * are just a power unit, a pseudo trailer type 'NONE' is used and the
+     * size dimension is configured on that. Accessory category trailers
+     * (e.g. jeeps and boosters) are not used for configuration since they
+     * do not impact the size dimension in policy.
+     * @param permitTypeId ID of the permit type to get size dimension for
+     * @param commodityId ID of the commodity to get size dimension for
+     * @param currentConfiguration Current vehicle configuration to get size dimension for
+     * @param regions List of regions the vehicle will be traveling in. If not
+     * supplied this defaults to the most restrictive size dimension (if multiple
+     * are configured).
+     * @returns SizeDimension for the given permit type, commodity, and configuration
+     */
+    getSizeDimension(permitTypeId: string, commodityId: string, configuration: Array<string>, regions?: Array<string>): SizeDimension | null;
+    /**
+     * Selects the correct size dimension from a list of potential candidates, based
+     * on the modifier of each dimension. If none of the modifiers match, returns
+     * null.
+     * @param sizeDimensions Size dimension options to choose from
+     * @param currentConfiguration The full vehicle configuration
+     */
+    selectCorrectSizeDimension(sizeDimensions: Array<SizeDimension>, configuration: Array<string>, sizeTrailer: string): SizeDimension | null;
     /**
      * Gets a list of all configured power unit types in the policy definition.
      * @returns Map of power unit type IDs to power unit type names.
@@ -56,4 +130,10 @@ export declare class Policy {
      * @returns PermitType definition for the supplied ID.
      */
     getPermitTypeDefinition(type?: string): PermitType | null;
+    /**
+     * Gets a full Commodity definition by ID
+     * @param type Type ID of the commodity to return.
+     * @returns Commodity definition for the supplied ID.
+     */
+    getCommodityDefinition(type?: string): Commodity | null;
 }