@burdenoff/microfe-movethewheels 2026.1017.15 → 2026.1017.17

package/src/movethewheels/utils/consumedFuelResponse.ts

@@ -0,0 +1,140 @@
+import type {
+  MtwConsumedFuelPreviewInput,
+  MtwConsumedFuelPreviewQuery,
+  MtwConsumedFuelReason,
+} from '../../generated/consumed-fuel-preview-operations';
+import { strictFuelInstant } from './consumedFuelInput';
+export type ConsumedFuelPreview = MtwConsumedFuelPreviewQuery['mtwConsumedFuelPreview'];
+function invalid(): never {
+  throw new Error('The consumption preview response could not be verified.');
+}
+function isObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function object(value: unknown): Record<string, unknown> {
+  if (!isObject(value)) return invalid();
+  return value;
+}
+function keys(value: Record<string, unknown>, names: readonly string[]): void {
+  const allowed = new Set(names);
+  if (
+    names.some((k) => !Object.hasOwn(value, k)) ||
+    Object.keys(value).some((k) => k !== '__typename' && !allowed.has(k))
+  )
+    invalid();
+}
+function reason(value: unknown): MtwConsumedFuelReason {
+  switch (value) {
+    case 'DISTANCE_UNKNOWN':
+    case 'FUEL_UNKNOWN':
+    case 'SOURCE_UNKNOWN':
+    case 'NON_MEASURED_DISTANCE':
+    case 'UNSUPPORTED_FUEL_BASIS':
+    case 'INTERVAL_MISMATCH':
+    case 'PARTIAL_COVERAGE':
+    case 'ZERO_DISTANCE':
+      return value;
+    default:
+      return invalid();
+  }
+}
+export function validateConsumedFuelEnvelope(value: unknown): void {
+  const envelope = object(value);
+  keys(envelope, ['data', ...(Object.hasOwn(envelope, 'errors') ? ['errors'] : [])]);
+  if (
+    Object.hasOwn(envelope, 'errors') &&
+    (!Array.isArray(envelope.errors) || envelope.errors.length !== 0)
+  )
+    invalid();
+  const data = object(envelope.data);
+  keys(data, ['mtwConsumedFuelPreview']);
+}
+export function parseConsumedFuelPreview(
+  data: unknown,
+  input: MtwConsumedFuelPreviewInput
+): ConsumedFuelPreview {
+  const root = object(data);
+  keys(root, ['mtwConsumedFuelPreview']);
+  const row = object(root.mtwConsumedFuelPreview);
+  keys(row, ['status', 'litresPer100Km', 'reasons', 'qualification', 'distance', 'fuel']);
+  const normalized = (
+    value: NonNullable<
+      MtwConsumedFuelPreviewInput['distance'] | MtwConsumedFuelPreviewInput['fuel']
+    >
+  ) => ({
+    intervalFrom: strictFuelInstant(value.intervalFrom, 'response'),
+    intervalUntil: strictFuelInstant(value.intervalUntil, 'response'),
+    sourceReference: value.sourceReference?.trim() ?? null,
+    sourceRevision: value.sourceRevision?.trim() ?? null,
+  });
+  const distance = input.distance
+    ? { ...input.distance, ...normalized(input.distance), metres: input.distance.metres ?? null }
+    : null;
+  const fuel = input.fuel
+    ? { ...input.fuel, ...normalized(input.fuel), millilitres: input.fuel.millilitres ?? null }
+    : null;
+  const checkEcho = (value: unknown, expected: object | null): void => {
+    if (expected === null) {
+      if (value !== null) invalid();
+      return;
+    }
+    const record = object(value);
+    keys(record, Object.keys(expected));
+    for (const [field, wanted] of Object.entries(expected)) if (record[field] !== wanted) invalid();
+  };
+  checkEcho(row.distance, distance);
+  checkEcho(row.fuel, fuel);
+  if (
+    row.qualification !== 'OPERATOR_REPORTED_UNVERIFIED' ||
+    (row.status !== 'KNOWN' && row.status !== 'UNKNOWN') ||
+    !Array.isArray(row.reasons)
+  )
+    return invalid();
+  const reasons = row.reasons.map(reason);
+  if (new Set(reasons).size !== reasons.length) invalid();
+  const expectedReasons: MtwConsumedFuelReason[] = [];
+  if (distance?.metres == null) expectedReasons.push('DISTANCE_UNKNOWN');
+  if (fuel?.millilitres == null) expectedReasons.push('FUEL_UNKNOWN');
+  if (
+    !distance?.sourceReference ||
+    !distance.sourceRevision ||
+    !fuel?.sourceReference ||
+    !fuel.sourceRevision
+  )
+    expectedReasons.push('SOURCE_UNKNOWN');
+  if (distance && distance.basis !== 'MEASURED') expectedReasons.push('NON_MEASURED_DISTANCE');
+  if (fuel && fuel.basis !== 'MEASURED_CONSUMPTION') expectedReasons.push('UNSUPPORTED_FUEL_BASIS');
+  if (
+    distance &&
+    fuel &&
+    (distance.intervalFrom !== fuel.intervalFrom || distance.intervalUntil !== fuel.intervalUntil)
+  )
+    expectedReasons.push('INTERVAL_MISMATCH');
+  if (distance?.coverage === 'PARTIAL' || fuel?.coverage === 'PARTIAL')
+    expectedReasons.push('PARTIAL_COVERAGE');
+  if (distance?.metres === 0) expectedReasons.push('ZERO_DISTANCE');
+  // Owning preview reasons have a deterministic order; a changed list/order is a contract mismatch.
+  if (JSON.stringify(reasons) !== JSON.stringify(expectedReasons)) invalid();
+  // The owner uses the same JS IEEE 754 double (100 * mL) / m and JSON Float roundtrip; compare exactly.
+  const ratio = row.litresPer100Km;
+  if (reasons.length) {
+    if (row.status !== 'UNKNOWN' || ratio !== null) invalid();
+  } else if (
+    row.status !== 'KNOWN' ||
+    typeof ratio !== 'number' ||
+    !Number.isFinite(ratio) ||
+    ratio < 0 ||
+    !distance?.metres ||
+    fuel?.millilitres == null ||
+    ratio !== (100 * fuel.millilitres) / distance.metres
+  )
+    invalid();
+  return {
+    status: row.status,
+    litresPer100Km: ratio,
+    reasons,
+    qualification: 'OPERATOR_REPORTED_UNVERIFIED',
+    distance: distance ? { ...distance, metres: distance.metres ?? null } : null,
+    fuel: fuel ? { ...fuel, millilitres: fuel.millilitres ?? null } : null,
+  };
+}

package/src/operations/consumed-fuel-preview/preview.graphql

@@ -0,0 +1 @@
+query MtwConsumedFuelPreview($input: MtwConsumedFuelPreviewInput!) { mtwConsumedFuelPreview(input: $input) { status litresPer100Km reasons qualification distance { metres intervalFrom intervalUntil basis coverage sourceReference sourceRevision } fuel { millilitres intervalFrom intervalUntil basis coverage sourceReference sourceRevision } } }