@jetta/axle-load-calculator 0.1.3 → 0.3.1

package/README.md

@@ -17,16 +17,57 @@ npm run build
 ## Usage
 
 ```typescript
-import { calculate_weight_on_axles_physics } from '@jetta/axle-load-calculator'
-
-const response_json = calculate_weight_on_axles_physics(input_json_string)
+import {
+    calculate_weight_on_axles_physics,
+    UnsupportedVehicleTypeError,
+    type WeightByAxisRequestInput,
+    type WeightByAxisSuccessOutput
+} from '@jetta/axle-load-calculator'
+import { ZodError } from 'zod'
+
+const request: WeightByAxisRequestInput = { envs: [...] }
+
+try {
+    const response: WeightByAxisSuccessOutput = calculate_weight_on_axles_physics(request)
+    // response.envs with axle weights
+} catch (error) {
+    if (error instanceof ZodError) {
+        // invalid request shape (null, array, missing containers, etc.)
+    } else if (error instanceof UnsupportedVehicleTypeError) {
+        // unsupported tipoVeiculo
+    }
+}
 ```
 
-**Contract:** same as `WeightByAxisTask.run()` in ms-faixas-porcentuais:
+**Contract:**
+
+- Input: object `{ envs, config? }` with required `containers` on each env (cloned before processing)
+- Success: `{ envs }` with `containers[].pesoEixos` filled; `items` and `faixas` cleared on containers
+- Failure: throws (see **Errors** below)
+
+## Errors
+
+### Thrown by `calculate_weight_on_axles_physics`
+
+| Class | When |
+|-------|------|
+| `ZodError` (from `zod`, not re-exported) | Invalid request shape (`null`, array, missing `containers`, etc.) |
+| `UnsupportedVehicleTypeError` | Unknown `tipoVeiculo` |
+| `UnrecognizedSuspensionTypeError` | Invalid vanderleia suspension type |
+| `GrouperNotFoundError` | Merged-container grouper not found |
+
+Import `ZodError` directly from [`zod`](https://github.com/colinhacks/zod).
+
+### Exported for lower-level use
+
+Also exported from `@jetta/axle-load-calculator` for `instanceof` checks when using internal physics modules (not thrown by `calculate_weight_on_axles_physics`):
 
-- Input: JSON string `{ envs, config? }`
-- Success: `envs[].conteiners[].pesoEixos` filled; `items` and `faixas` cleared on containers
-- Error: `{ msg, apiError }`
+| Class | When |
+|-------|------|
+| `ContainerSequenceNotFoundError` | Container sequence missing on transport |
+| `MissingContainerError` | Container lookup failed |
+| `UnknownItemIdError` | Unknown item template id |
+| `DeflectionModelNotImplementedError` | No deflection model for the vehicle |
 
 ## Dependencies
 

package/build/core/contracts/{chassi_reference.d.ts → ChassiReference.d.ts}

@@ -4,4 +4,4 @@ export declare const CHASSI_REFERENCE: Readonly<{
     TRACTOR: "TRACTOR";
 }>;
 export type ChassiReference = typeof CHASSI_REFERENCE[keyof typeof CHASSI_REFERENCE];
-//# sourceMappingURL=chassi_reference.d.ts.map
+//# sourceMappingURL=ChassiReference.d.ts.map

package/build/core/contracts/ChassiReference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChassiReference.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/ChassiReference.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;EAI3B,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAA"}

package/build/core/contracts/{ms_faixas_contract.d.ts → MsFaixasContract.d.ts}

@@ -1,4 +1,4 @@
-import { AllocatedItemManager } from '../physics/items/allocated_item_manager.js';
+import { AllocatedItemManager } from '../physics/items/AllocatedItemManager.js';
 /**
  * Parses ms-faixas `{ envs: [...] }` payloads for axleweight services.
  */
@@ -10,4 +10,4 @@ export declare class MsFaixasContract {
      */
     constructor(ms_faixas_input: Record<string, unknown>);
 }
-//# sourceMappingURL=ms_faixas_contract.d.ts.map
+//# sourceMappingURL=MsFaixasContract.d.ts.map

package/build/core/contracts/MsFaixasContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MsFaixasContract.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/MsFaixasContract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAA;AAO/E;;GAEG;AACH,qBAAa,gBAAgB;IAEzB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IAEpE;;OAEG;gBACS,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOvD"}

package/build/core/contracts/{ms_faixas_contract.js → MsFaixasContract.js}

@@ -1,6 +1,6 @@
-import { AllocatedItem } from '../physics/items/allocated_item.js';
-import { AllocatedItemManager } from '../physics/items/allocated_item_manager.js';
-import { ItemTemplates } from '../physics/items/item_templates.js';
+import { AllocatedItem } from '../physics/items/AllocatedItem.js';
+import { AllocatedItemManager } from '../physics/items/AllocatedItemManager.js';
+import { ItemTemplates } from '../physics/items/ItemTemplates.js';
 const TRANSPORT_LIST_FLAG = 'envs';
 const CONTAINERS_FLAG = 'containers';
 const ITEM_LIST_FLAG = 'items';

package/build/core/contracts/{rotation_enum.d.ts → RotationEnum.d.ts}

@@ -8,4 +8,4 @@ export declare const ROTATION: Readonly<{
     POS6: 6;
 }>;
 export type RotationCode = typeof ROTATION[keyof typeof ROTATION];
-//# sourceMappingURL=rotation_enum.d.ts.map
+//# sourceMappingURL=RotationEnum.d.ts.map

package/build/core/contracts/RotationEnum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RotationEnum.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/RotationEnum.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,eAAO,MAAM,QAAQ;;;;;;;EAOnB,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAA"}

package/build/core/contracts/{suspension_type.d.ts → SuspensionType.d.ts}

@@ -2,4 +2,4 @@ export declare const SUSPENSION_TYPE: Readonly<{
     PNEUMATICA: "Pneumatica";
     MECANICA: "Mecanica";
 }>;
-//# sourceMappingURL=suspension_type.d.ts.map
+//# sourceMappingURL=SuspensionType.d.ts.map

package/build/core/contracts/SuspensionType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SuspensionType.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/SuspensionType.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe;;;EAG1B,CAAA"}

package/build/core/contracts/{transport_record.d.ts → TransportRecord.d.ts}

@@ -2,4 +2,4 @@
  * Raw transport dict as received by axle-weight services (jettainterface wire format).
  */
 export type TransportRecord = Record<string, unknown>;
-//# sourceMappingURL=transport_record.d.ts.map
+//# sourceMappingURL=TransportRecord.d.ts.map

package/build/core/contracts/TransportRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransportRecord.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/TransportRecord.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA"}

package/build/core/contracts/{vehicle_type.d.ts → VehicleType.d.ts}

@@ -9,4 +9,4 @@ export declare const VEHICLE_TYPE: Readonly<{
     VUC: 8;
 }>;
 export type VehicleTypeCode = typeof VEHICLE_TYPE[keyof typeof VEHICLE_TYPE];
-//# sourceMappingURL=vehicle_type.d.ts.map
+//# sourceMappingURL=VehicleType.d.ts.map

package/build/core/contracts/VehicleType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VehicleType.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/VehicleType.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;;;;;;;EASvB,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAA"}

package/build/core/contracts/{vehicle_version.d.ts → VehicleVersion.d.ts}

@@ -5,4 +5,4 @@ export declare const VEHICLE_VERSION: Readonly<{
     SEMIREBOQUE_BITRUCK: 6;
     SEMIREBOQUE_QUAD_ALT: 7;
 }>;
-//# sourceMappingURL=vehicle_version.d.ts.map
+//# sourceMappingURL=VehicleVersion.d.ts.map

package/build/core/contracts/VehicleVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VehicleVersion.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/VehicleVersion.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe;;;;;;EAM1B,CAAA"}

package/build/core/contracts/{wire_flags.d.ts → WireFlags.d.ts}

@@ -24,4 +24,4 @@ export declare const WIRE_FLAGS: Readonly<{
     CM_SERVICE_Z: "z_position";
     CM_SERVICE_MASS: "mass";
 }>;
-//# sourceMappingURL=wire_flags.d.ts.map
+//# sourceMappingURL=WireFlags.d.ts.map

package/build/core/contracts/WireFlags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WireFlags.d.ts","sourceRoot":"","sources":["../../../src/core/contracts/WireFlags.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;EAyBrB,CAAA"}

package/build/core/math/{float_tools.d.ts → FloatTools.d.ts}

@@ -4,4 +4,4 @@
  * @returns Plain number matrix or vector.
  */
 export declare function float_list_to_matrix(float_list: number[] | number[][]): number[] | number[][];
-//# sourceMappingURL=float_tools.d.ts.map
+//# sourceMappingURL=FloatTools.d.ts.map

package/build/core/math/FloatTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FloatTools.d.ts","sourceRoot":"","sources":["../../../src/core/math/FloatTools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,CAW7F"}

package/build/core/math/{gaussian_elimination.d.ts → GaussianElimination.d.ts}

@@ -5,4 +5,4 @@
  * @returns Solution vector length n.
  */
 export declare function solve_linear_system(matrix: number[][], independent: number[]): number[];
-//# sourceMappingURL=gaussian_elimination.d.ts.map
+//# sourceMappingURL=GaussianElimination.d.ts.map

package/build/core/math/GaussianElimination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GaussianElimination.d.ts","sourceRoot":"","sources":["../../../src/core/math/GaussianElimination.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CASvF"}

package/build/core/orchestration/{axle_weight_physics.d.ts → AxleWeightPhysics.d.ts}

@@ -4,4 +4,4 @@
  * @returns Loaded cargo weight per axle index.
  */
 export declare function calculate_loaded_weights_for_env(env_vehicle: Record<string, unknown>): number[];
-//# sourceMappingURL=axle_weight_physics.d.ts.map
+//# sourceMappingURL=AxleWeightPhysics.d.ts.map

package/build/core/orchestration/AxleWeightPhysics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AxleWeightPhysics.d.ts","sourceRoot":"","sources":["../../../src/core/orchestration/AxleWeightPhysics.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,MAAM,EAAE,CAMV"}

package/build/core/orchestration/{axle_weight_physics.js → AxleWeightPhysics.js}

@@ -1,6 +1,6 @@
-import { CmAxleWeightService } from '../physics/services/cm_axle_weight_service.js';
-import { build_connector_payload } from './connector_payload_builder.js';
-import { mass_center_by_grouper_from_env } from './java_mass_center.js';
+import { CmAxleWeightService } from '../physics/services/CmAxleWeightService.js';
+import { build_connector_payload } from './ConnectorPayloadBuilder.js';
+import { mass_center_by_grouper_from_env } from './JavaMassCenter.js';
 /**
  * Calculates loaded weights per vehicle axle (in-process, no HTTP).
  * @param env_vehicle - Single env from weight_by_axis payload.

package/build/core/orchestration/{connector_payload_builder.d.ts → ConnectorPayloadBuilder.d.ts}

@@ -8,4 +8,4 @@ export declare function build_connector_payload(env_vehicle: Record<string, unkn
     mass: number;
     z: number;
 }>): Record<string, unknown>;
-//# sourceMappingURL=connector_payload_builder.d.ts.map
+//# sourceMappingURL=ConnectorPayloadBuilder.d.ts.map

package/build/core/orchestration/ConnectorPayloadBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorPayloadBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/orchestration/ConnectorPayloadBuilder.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACvE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB"}

package/build/core/orchestration/{connector_payload_builder.js → ConnectorPayloadBuilder.js}

@@ -1,4 +1,4 @@
-import { WIRE_FLAGS } from '../contracts/wire_flags.js';
+import { WIRE_FLAGS } from '../contracts/WireFlags.js';
 /**
  * Builds axle-weight service payload from a prepared env vehicle (Java AxleWeightConnector).
  * @param env_vehicle - Vehicle object inside envs[].
@@ -36,12 +36,11 @@ function map_center_of_mass_wire(center_of_mass_by_grouper) {
     return center_of_mass;
 }
 /**
- * @param env_vehicle - Env vehicle JSON.
- * @returns Container wire list without items.
+ * @param container - Env container record.
+ * @returns Wire container without items.
  */
-function build_containers(env_vehicle) {
-    const list = env_vehicle.containers;
-    return list.map((container) => ({
+function map_container_to_wire(container) {
+    return {
         [WIRE_FLAGS.LENGTH]: container.comprimento,
         [WIRE_FLAGS.WIDTH]: container.largura,
         [WIRE_FLAGS.HEIGHT]: container.altura,
@@ -49,19 +48,34 @@ function build_containers(env_vehicle) {
         [WIRE_FLAGS.MAIN_PIN_DISTANCE]: container.distPinoRei,
         [WIRE_FLAGS.CONTAINER_DISTANCE_AHEAD]: container.containerDistanceAhead,
         [WIRE_FLAGS.GROUPER]: container.grouper
-    }));
+    };
 }
 /**
- * @param env_vehicle - Env vehicle JSON.
- * @returns Axle wire list.
+ * @param axle - Env axle record.
+ * @returns Wire axle payload.
  */
-function build_axles(env_vehicle) {
-    const list = env_vehicle.eixos;
-    return list.map((axle) => ({
+function map_axle_to_wire(axle) {
+    return {
         [WIRE_FLAGS.DISTANCE_FROM_ORIGIN]: axle.distanciaOrigem,
         [WIRE_FLAGS.MAX_SUPPORTED_WEIGHT]: axle.pesoMaxSuportado,
         [WIRE_FLAGS.SEQUENCE_CONTAINER]: axle.sequenciaContainer,
         [WIRE_FLAGS.DNIT_WEIGHT]: axle.pesoDnit ?? axle.pesoMaxSuportado,
         [WIRE_FLAGS.TARE]: axle.tara
-    }));
+    };
+}
+/**
+ * @param env_vehicle - Env vehicle JSON.
+ * @returns Container wire list without items.
+ */
+function build_containers(env_vehicle) {
+    const list = env_vehicle.containers;
+    return list.map(map_container_to_wire);
+}
+/**
+ * @param env_vehicle - Env vehicle JSON.
+ * @returns Axle wire list.
+ */
+function build_axles(env_vehicle) {
+    const list = env_vehicle.eixos;
+    return list.map(map_axle_to_wire);
 }

package/build/core/orchestration/{java_mass_center.d.ts → JavaMassCenter.d.ts}

@@ -1,4 +1,4 @@
-import { CenterOfMass } from '../physics/items/center_of_mass.js';
+import { CenterOfMass } from '../physics/items/CenterOfMass.js';
 /**
  * Computes mass center per grouper using ms-faixas Java Item / MassCenter rules.
  * Longitudinal position uses JSON `y` (maps to Ponto3D.z in Java CubeRepresentation).
@@ -6,4 +6,4 @@ import { CenterOfMass } from '../physics/items/center_of_mass.js';
  * @returns Map of grouper id to center of mass.
  */
 export declare function mass_center_by_grouper_from_env(env_vehicle: Record<string, unknown>): Record<number, CenterOfMass>;
-//# sourceMappingURL=java_mass_center.d.ts.map
+//# sourceMappingURL=JavaMassCenter.d.ts.map

package/build/core/orchestration/JavaMassCenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JavaMassCenter.d.ts","sourceRoot":"","sources":["../../../src/core/orchestration/JavaMassCenter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAE/D;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC3C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAe9B"}

package/build/core/orchestration/{java_mass_center.js → JavaMassCenter.js}

@@ -1,4 +1,4 @@
-import { CenterOfMass } from '../physics/items/center_of_mass.js';
+import { CenterOfMass } from '../physics/items/CenterOfMass.js';
 /**
  * Computes mass center per grouper using ms-faixas Java Item / MassCenter rules.
  * Longitudinal position uses JSON `y` (maps to Ponto3D.z in Java CubeRepresentation).

package/build/core/orchestration/OutputBuilder.d.ts

@@ -0,0 +1,7 @@
+import type { WeightByAxisSuccessOutput } from './WeightByAxisResponse.js';
+/**
+ * @param envs - Output env list.
+ * @returns Success response object.
+ */
+export declare function build_success_output(envs: Record<string, unknown>[]): WeightByAxisSuccessOutput;
+//# sourceMappingURL=OutputBuilder.d.ts.map

package/build/core/orchestration/OutputBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutputBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/orchestration/OutputBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAA;AAE1E;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,yBAAyB,CAG/F"}

package/build/core/orchestration/OutputBuilder.js

@@ -0,0 +1,7 @@
+/**
+ * @param envs - Output env list.
+ * @returns Success response object.
+ */
+export function build_success_output(envs) {
+    return { envs };
+}

package/build/core/orchestration/{request_schema.d.ts → RequestSchema.d.ts}

@@ -3,63 +3,55 @@ declare const request_schema: z.ZodObject<{
     envs: z.ZodArray<z.ZodObject<{
         _id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         eixos: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
-        conteiners: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
-        containers: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        containers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         _id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         eixos: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
-        conteiners: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
-        containers: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        containers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         _id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         eixos: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
-        conteiners: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
-        containers: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        containers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
     }, z.ZodTypeAny, "passthrough">>, "many">;
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     envs: z.ZodArray<z.ZodObject<{
         _id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         eixos: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
-        conteiners: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
-        containers: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        containers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         _id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         eixos: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
-        conteiners: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
-        containers: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        containers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         _id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         eixos: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
-        conteiners: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
-        containers: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        containers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
     }, z.ZodTypeAny, "passthrough">>, "many">;
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     envs: z.ZodArray<z.ZodObject<{
         _id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         eixos: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
-        conteiners: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
-        containers: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        containers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         _id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         eixos: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
-        conteiners: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
-        containers: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        containers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         _id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         eixos: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
-        conteiners: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
-        containers: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+        containers: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
     }, z.ZodTypeAny, "passthrough">>, "many">;
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.ZodTypeAny, "passthrough">>;
 export type WeightByAxisRequest = z.infer<typeof request_schema>;
+export type WeightByAxisRequestInput = z.input<typeof request_schema>;
 /**
- * Parses and validates weight-by-axis JSON at the library boundary.
- * @param json_data - Raw request string.
+ * Parses and validates weight-by-axis request data at the library boundary.
+ * @param data - JSON string or plain `{ envs, config? }` object.
  * @returns Parsed request object.
  */
-export declare function parse_weight_by_axis_request(json_data: string): WeightByAxisRequest;
+export declare function parse_weight_by_axis_request_data(data: WeightByAxisRequestInput): WeightByAxisRequest;
 export {};
-//# sourceMappingURL=request_schema.d.ts.map
+//# sourceMappingURL=RequestSchema.d.ts.map

package/build/core/orchestration/RequestSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestSchema.d.ts","sourceRoot":"","sources":["../../../src/core/orchestration/RequestSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAQvB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAGJ,CAAA;AAEhB,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAChE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErE;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC7C,IAAI,EAAE,wBAAwB,GAC/B,mBAAmB,CAGrB"}

package/build/core/orchestration/RequestSchema.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+const env_schema = z.object({
+    _id: z.union([z.string(), z.number()]).optional(),
+    eixos: z.array(z.record(z.unknown())).min(1),
+    containers: z.array(z.record(z.unknown())).min(1)
+}).passthrough();
+const request_schema = z.object({
+    envs: z.array(env_schema).min(1),
+    config: z.record(z.unknown()).optional()
+}).passthrough();
+/**
+ * Parses and validates weight-by-axis request data at the library boundary.
+ * @param data - JSON string or plain `{ envs, config? }` object.
+ * @returns Parsed request object.
+ */
+export function parse_weight_by_axis_request_data(data) {
+    return request_schema.parse(data);
+}

package/build/core/orchestration/WeightByAxisResponse.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Successful weight-by-axis response payload.
+ */
+export type WeightByAxisSuccessOutput = {
+    envs: Record<string, unknown>[];
+};
+/**
+ * Weight-by-axis task success response.
+ */
+export type WeightByAxisResponse = WeightByAxisSuccessOutput;
+//# sourceMappingURL=WeightByAxisResponse.d.ts.map

package/build/core/orchestration/WeightByAxisResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WeightByAxisResponse.d.ts","sourceRoot":"","sources":["../../../src/core/orchestration/WeightByAxisResponse.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;CAClC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,yBAAyB,CAAA"}

package/build/core/orchestration/WeightByAxisResponse.js

@@ -0,0 +1 @@
+export {};

package/build/core/orchestration/WeightByAxisTask.d.ts

@@ -0,0 +1,17 @@
+import { type WeightByAxisRequestInput } from './RequestSchema.js';
+import type { WeightByAxisSuccessOutput } from './WeightByAxisResponse.js';
+/**
+ * Runs weight-by-axis for ms-faixas input (WeightByAxisTask.run contract).
+ * @param request_data - `{ envs, config? }` object.
+ * @returns Response object with envs and axle weights.
+ * @throws {import('zod').ZodError} When request validation fails.
+ * @throws {import('../physics/models/UnsupportedVehicleTypeError.js').UnsupportedVehicleTypeError} When physics rejects the vehicle type.
+ * @throws {import('../physics/models/UnrecognizedSuspensionTypeError.js').UnrecognizedSuspensionTypeError} When vanderleia suspension type is invalid.
+ * @throws {import('../physics/transports/GrouperNotFoundError.js').GrouperNotFoundError} When a merged-container grouper is missing.
+ * @throws {import('../physics/transports/ContainerSequenceNotFoundError.js').ContainerSequenceNotFoundError} When a container sequence is missing.
+ * @throws {import('../physics/transports/MissingContainerError.js').MissingContainerError} When a container lookup fails.
+ * @throws {import('../physics/items/UnknownItemIdError.js').UnknownItemIdError} When an item template id is unknown.
+ * @throws {import('../physics/models/deflection/DeflectionModelNotImplementedError.js').DeflectionModelNotImplementedError} When no deflection model exists.
+ */
+export declare function run_weight_by_axis_task(request_data: WeightByAxisRequestInput): WeightByAxisSuccessOutput;
+//# sourceMappingURL=WeightByAxisTask.d.ts.map

package/build/core/orchestration/WeightByAxisTask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WeightByAxisTask.d.ts","sourceRoot":"","sources":["../../../src/core/orchestration/WeightByAxisTask.ts"],"names":[],"mappings":"AAEA,OAAO,EAEH,KAAK,wBAAwB,EAChC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAA;AAE1E;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACnC,YAAY,EAAE,wBAAwB,GACvC,yBAAyB,CAY3B"}

package/build/core/orchestration/{weight_by_axis_task.js → WeightByAxisTask.js}

@@ -1,30 +1,32 @@
-import { calculate_loaded_weights_for_env } from './axle_weight_physics.js';
-import { build_success_output, build_error_output } from './output_builder.js';
-import { check_cargo_collision } from './collision_checker.js';
-import { parse_weight_by_axis_request } from './request_schema.js';
+import { calculate_loaded_weights_for_env } from './AxleWeightPhysics.js';
+import { build_success_output } from './OutputBuilder.js';
+import { parse_weight_by_axis_request_data } from './RequestSchema.js';
 /**
- * Runs weight-by-axis for ms-faixas JSON input (WeightByAxisTask.run contract).
- * @param json_data - Raw request JSON string.
- * @returns Response JSON string.
+ * Runs weight-by-axis for ms-faixas input (WeightByAxisTask.run contract).
+ * @param request_data - `{ envs, config? }` object.
+ * @returns Response object with envs and axle weights.
+ * @throws {import('zod').ZodError} When request validation fails.
+ * @throws {import('../physics/models/UnsupportedVehicleTypeError.js').UnsupportedVehicleTypeError} When physics rejects the vehicle type.
+ * @throws {import('../physics/models/UnrecognizedSuspensionTypeError.js').UnrecognizedSuspensionTypeError} When vanderleia suspension type is invalid.
+ * @throws {import('../physics/transports/GrouperNotFoundError.js').GrouperNotFoundError} When a merged-container grouper is missing.
+ * @throws {import('../physics/transports/ContainerSequenceNotFoundError.js').ContainerSequenceNotFoundError} When a container sequence is missing.
+ * @throws {import('../physics/transports/MissingContainerError.js').MissingContainerError} When a container lookup fails.
+ * @throws {import('../physics/items/UnknownItemIdError.js').UnknownItemIdError} When an item template id is unknown.
+ * @throws {import('../physics/models/deflection/DeflectionModelNotImplementedError.js').DeflectionModelNotImplementedError} When no deflection model exists.
  */
-export function run_weight_by_axis_task(json_data) {
-    try {
-        const request = parse_weight_by_axis_request(json_data);
-        const envs = request.envs;
-        const output_envs = [];
-        for (const env of envs) {
-            const loaded_weights = calculate_loaded_weights_for_env(env);
-            apply_loaded_weights_to_env(env, loaded_weights);
-            check_cargo_collision(env);
-            output_envs.push(strip_items_and_bands(env));
-        }
-        return build_success_output(output_envs);
-    }
-    catch (error) {
-        return build_error_output(error);
+export function run_weight_by_axis_task(request_data) {
+    const request = parse_weight_by_axis_request_data(request_data);
+    const envs = request.envs;
+    const output_envs = [];
+    for (const env of envs) {
+        const loaded_weights = calculate_loaded_weights_for_env(env);
+        apply_loaded_weights_to_env(env, loaded_weights);
+        output_envs.push(strip_items_and_bands(env));
     }
+    return build_success_output(output_envs);
 }
 /**
+ * Writes loaded axle and container pesoEixos fields on the env vehicle.
  * @param env - Env vehicle object.
  * @param loaded_weights - Forces per axle.
  */
@@ -37,10 +39,7 @@ function apply_loaded_weights_to_env(env, loaded_weights) {
         axle.pesoCarregado = cargo;
         axle.pesoCarregadoFinal = tare + cargo;
     }
-    const containers = env.conteiners ?? env.containers;
-    if (!Array.isArray(containers)) {
-        return;
-    }
+    const containers = env.containers;
     apply_to_containers(containers, loaded_weights, axles);
 }
 /**
@@ -89,13 +88,13 @@ function build_peso_eixo_entry(axle, cargo) {
     };
 }
 /**
+ * Copies env vehicle for response, clearing items/faixas and setting idCaminhao.
  * @param env - Env with updated axle data.
  * @returns Env copy without items/faixas on containers.
  */
 function strip_items_and_bands(env) {
     const clone = JSON.parse(JSON.stringify(env));
-    const key = clone.conteiners ? 'conteiners' : 'containers';
-    const containers = clone[key];
+    const containers = clone.containers;
     for (const container of containers) {
         container.items = [];
         container.faixas = [];

package/build/core/physics/items/{allocated_item.d.ts → AllocatedItem.d.ts}

@@ -1,5 +1,5 @@
-import type { RotationCode } from '../../contracts/rotation_enum.js';
-import type { ItemTemplates } from './item_templates.js';
+import type { RotationCode } from '../../contracts/RotationEnum.js';
+import type { ItemTemplates } from './ItemTemplates.js';
 /**
  * Allocated cargo item with position in container coordinates.
  */
@@ -19,4 +19,4 @@ export declare class AllocatedItem {
     get length(): number;
     get center_of_gravity_z(): number;
 }
-//# sourceMappingURL=allocated_item.d.ts.map
+//# sourceMappingURL=AllocatedItem.d.ts.map

package/build/core/physics/items/AllocatedItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AllocatedItem.d.ts","sourceRoot":"","sources":["../../../../src/core/physics/items/AllocatedItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD;;GAEG;AACH,qBAAa,aAAa;IAEtB,EAAE,SAAI;IACN,EAAE,SAAI;IACN,EAAE,SAAI;IACN,QAAQ,EAAE,YAAY,CAAgB;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IAEjC;;;OAGG;gBACS,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM;IAM5D,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,IAAI,mBAAmB,IAAI,MAAM,CAGhC;CACJ"}

package/build/core/physics/items/{allocated_item.js → AllocatedItem.js}

@@ -1,4 +1,4 @@
-import { ROTATION } from '../../contracts/rotation_enum.js';
+import { ROTATION } from '../../contracts/RotationEnum.js';
 /**
  * Allocated cargo item with position in container coordinates.
  */

package/build/core/physics/items/{allocated_item_manager.d.ts → AllocatedItemManager.d.ts}

@@ -1,5 +1,5 @@
-import { AllocatedItem } from './allocated_item.js';
-import type { ItemTemplates } from './item_templates.js';
+import { AllocatedItem } from './AllocatedItem.js';
+import type { ItemTemplates } from './ItemTemplates.js';
 /**
  * Items allocated inside one container sequence.
  */
@@ -28,4 +28,4 @@ export declare class AllocatedItemManager {
      */
     get_item(item_index: number): AllocatedItem;
 }
-//# sourceMappingURL=allocated_item_manager.d.ts.map
+//# sourceMappingURL=AllocatedItemManager.d.ts.map

package/build/core/physics/items/AllocatedItemManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AllocatedItemManager.d.ts","sourceRoot":"","sources":["../../../../src/core/physics/items/AllocatedItemManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD;;GAEG;AACH,qBAAa,oBAAoB;IAOjB,QAAQ,CAAC,SAAS,EAAE,aAAa;IAL7C,OAAO,CAAC,KAAK,CAAsB;IAEnC;;OAEG;gBACkB,SAAS,EAAE,aAAa;IAI7C;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI;IAKjD;;OAEG;IACH,WAAW,IAAI,MAAM;IAKrB;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAK7B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;CAI9C"}