@burdenoff/microfe-movethewheels 2026.1011.1 → 2026.1011.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/dist/MoveTheWheelsRoot.js +5 -0
  2. package/dist/MoveTheWheelsRoutes.js +54 -50
  3. package/dist/generated/shipment-status-authority-operations.d.ts +4473 -0
  4. package/dist/hooks/useEpod.js +85 -77
  5. package/dist/hooks/useShipmentStatusAuthority.js +127 -0
  6. package/dist/hooks/useTracking.js +15 -14
  7. package/dist/hooks/useTrackingEventQuality.js +43 -17
  8. package/dist/movethewheels/hooks/useEpod.d.ts +23 -0
  9. package/dist/movethewheels/hooks/useShipmentStatusAuthority.d.ts +23 -0
  10. package/dist/movethewheels/hooks/useTrackingEventQuality.d.ts +5 -0
  11. package/dist/movethewheels/pages/ShipmentStatusAuthorityPage.d.ts +1 -0
  12. package/dist/movethewheels/utils/shipmentStatusDraft.d.ts +45 -0
  13. package/dist/pages/DeliveryCapturePage.js +181 -116
  14. package/dist/pages/ShipmentStatusAuthorityPage.js +563 -0
  15. package/dist/pages/TrackingEventQualityPage.js +6 -1
  16. package/dist/src/generated/shipment-status-authority-operations.js +86 -0
  17. package/dist/utils/graphqlClient.js +66 -56
  18. package/dist/utils/shipmentStatusDraft.js +41 -0
  19. package/package.json +7 -5
  20. package/src/generated/shipment-status-authority-operations.ts +5503 -0
  21. package/src/movethewheels/MoveTheWheelsRoot.tsx +6 -0
  22. package/src/movethewheels/MoveTheWheelsRoutes.tsx +2 -0
  23. package/src/movethewheels/hooks/useEpod.ts +47 -12
  24. package/src/movethewheels/hooks/useShipmentStatusAuthority.ts +179 -0
  25. package/src/movethewheels/hooks/useTracking.ts +27 -12
  26. package/src/movethewheels/hooks/useTrackingEventQuality.ts +42 -0
  27. package/src/movethewheels/pages/DeliveryCapturePage.tsx +113 -6
  28. package/src/movethewheels/pages/ShipmentStatusAuthorityPage.tsx +639 -0
  29. package/src/movethewheels/pages/TrackingEventQualityPage.tsx +13 -2
  30. package/src/movethewheels/utils/graphqlClient.ts +34 -17
  31. package/src/movethewheels/utils/shipmentStatusDraft.ts +118 -0
  32. package/src/operations/shipment-status-authority/status.graphql +80 -0
@@ -1,3 +1,5 @@
1
+ import { prepareWorkspaceRequest } from '@burdenoff/fe-libs/shared/graphql';
2
+
1
3
  export type GraphQLAttemptPolicy = 'RETRY_TRANSIENT' | 'SINGLE_ATTEMPT';
2
4
 
3
5
  interface GraphQLRequestOptions {
@@ -111,29 +113,42 @@ export async function executeGraphQL<TData>(
111
113
  variables?: Record<string, unknown>,
112
114
  attemptPolicy: GraphQLAttemptPolicy = 'RETRY_TRANSIENT'
113
115
  ): Promise<TData> {
114
- const url = resolveGraphqlUrl(options.apiGatewayUrl);
115
- const headers: Record<string, string> = {
116
- 'content-type': 'application/json',
117
- ...(options.authToken ? { Authorization: `Bearer ${options.authToken}` } : {}),
118
- ...(options.workspaceToken
119
- ? { 'X-Workspace-Authorization': `Bearer ${options.workspaceToken}` }
120
- : {}),
121
- ...(options.workspaceId ? { 'x-workspace-id': options.workspaceId } : {}),
122
- ...(options.tenantId ? { 'x-tenant-id': options.tenantId } : {}),
123
- ...(options.actorId ? { 'x-actor-id': options.actorId } : {}),
124
- ...(options.actorId ? { 'x-actor-type': 'user' } : {}),
125
- };
116
+ // Capture the original intent before queueing or asynchronously renewing authority.
117
+ const request = { ...options };
126
118
  const body = JSON.stringify({ query, variables });
127
-
128
- // Serialize past the global concurrency cap before doing any network work,
129
- // and always release the slot when this call settles (success or failure).
119
+ const url = resolveGraphqlUrl(request.apiGatewayUrl);
130
120
  await acquireSlot();
131
121
  try {
122
+ // Server-side callers retain explicit-token behavior; active browser requests
123
+ // use the shared owning profile/context lifecycle before product dispatch.
124
+ const authority =
125
+ typeof window !== 'undefined'
126
+ ? await prepareWorkspaceRequest({
127
+ url: url.startsWith('/') ? new URL(url, window.location.origin).toString() : url,
128
+ authToken: request.authToken ?? '',
129
+ actorId: request.actorId ?? '',
130
+ workspaceId: request.workspaceId ?? '',
131
+ tenantId: request.tenantId,
132
+ workspaceToken: request.workspaceToken,
133
+ currentQuery: query,
134
+ })
135
+ : null;
136
+ const workspaceToken = authority?.workspaceToken ?? request.workspaceToken;
137
+ const headers: Record<string, string> = {
138
+ 'content-type': 'application/json',
139
+ ...(request.authToken ? { Authorization: `Bearer ${request.authToken}` } : {}),
140
+ ...(workspaceToken ? { 'X-Workspace-Authorization': `Bearer ${workspaceToken}` } : {}),
141
+ ...(request.workspaceId ? { 'x-workspace-id': request.workspaceId } : {}),
142
+ ...(request.tenantId ? { 'x-tenant-id': request.tenantId } : {}),
143
+ ...(request.actorId ? { 'x-actor-id': request.actorId } : {}),
144
+ ...(request.actorId ? { 'x-actor-type': 'user' } : {}),
145
+ };
132
146
  return await runWithRetries<TData>(
133
147
  url,
134
148
  headers,
135
149
  body,
136
- attemptPolicy === 'SINGLE_ATTEMPT' ? 0 : MAX_RETRIES
150
+ attemptPolicy === 'SINGLE_ATTEMPT' ? 0 : MAX_RETRIES,
151
+ authority?.assertCurrent ?? (() => {})
137
152
  );
138
153
  } finally {
139
154
  releaseSlot();
@@ -157,7 +172,8 @@ async function runWithRetries<TData>(
157
172
  url: string,
158
173
  headers: Record<string, string>,
159
174
  body: string,
160
- retries: number
175
+ retries: number,
176
+ assertCurrent: () => void
161
177
  ): Promise<TData> {
162
178
  let lastError: Error = new Error('GraphQL request failed');
163
179
 
@@ -167,6 +183,7 @@ async function runWithRetries<TData>(
167
183
  if (attempt > 0)
168
184
  await sleep(Math.min(250 * 2 ** (attempt - 1), 2000) + Math.floor(Math.random() * 150));
169
185
 
186
+ assertCurrent();
170
187
  const controller = new AbortController();
171
188
  const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
172
189
  try {
@@ -0,0 +1,118 @@
1
+ export interface ShipmentSourceDraft {
2
+ integrationId: string;
3
+ basisTrackingEventId: string;
4
+ maxSourceAgeSeconds: string;
5
+ maxFutureSkewSeconds: string;
6
+ reason: string;
7
+ }
8
+
9
+ export function statusDecisionReason(value: string): string {
10
+ const reason = value.trim();
11
+ if (!reason || reason.length > 1000) throw new Error('Enter a reason of 1–1000 characters.');
12
+ return reason;
13
+ }
14
+
15
+ function explicitSeconds(value: string, minimum: number, maximum: number, label: string): number {
16
+ if (!/^\d+$/.test(value.trim()))
17
+ throw new Error(`${label} must be an explicit whole number of seconds.`);
18
+ const result = Number(value.trim());
19
+ if (!Number.isSafeInteger(result) || result < minimum || result > maximum)
20
+ throw new Error(`${label} must be between ${minimum} and ${maximum} seconds.`);
21
+ return result;
22
+ }
23
+
24
+ export function shipmentSourceInput(draft: ShipmentSourceDraft, expectedStatusRevision: number) {
25
+ if (!draft.integrationId || !draft.basisTrackingEventId)
26
+ throw new Error('Choose one integration and one recorded basis event.');
27
+ return {
28
+ expectedStatusRevision,
29
+ integrationId: draft.integrationId,
30
+ basisTrackingEventId: draft.basisTrackingEventId,
31
+ maxSourceAgeSeconds: explicitSeconds(
32
+ draft.maxSourceAgeSeconds,
33
+ 1,
34
+ 2592000,
35
+ 'Maximum source age'
36
+ ),
37
+ maxFutureSkewSeconds: explicitSeconds(
38
+ draft.maxFutureSkewSeconds,
39
+ 0,
40
+ 86400,
41
+ 'Allowed future skew'
42
+ ),
43
+ reason: statusDecisionReason(draft.reason),
44
+ };
45
+ }
46
+
47
+ interface StatusAcknowledgement {
48
+ id: string;
49
+ status: string;
50
+ statusRevision: number;
51
+ statusAuthority: string;
52
+ statusAuthorityEpoch: number;
53
+ designatedIntegrationId?: string | null;
54
+ statusBasisEventId?: string | null;
55
+ statusBasisSourceTime?: string | null;
56
+ maxSourceAgeSeconds?: number | null;
57
+ maxFutureSkewSeconds?: number | null;
58
+ }
59
+
60
+ export function sourceStatusAcknowledged(
61
+ actual: StatusAcknowledgement | null | undefined,
62
+ expected: {
63
+ id: string;
64
+ epoch: number;
65
+ input: ReturnType<typeof shipmentSourceInput>;
66
+ basis: { id: string; eventType: string; providerEventTime?: string | null } | undefined;
67
+ }
68
+ ): boolean {
69
+ const statuses: Record<string, string> = {
70
+ PICKED_UP: 'PICKED_UP',
71
+ IN_TRANSIT: 'IN_TRANSIT',
72
+ ARRIVED: 'IN_TRANSIT',
73
+ DEPARTED: 'IN_TRANSIT',
74
+ OUT_FOR_DELIVERY: 'IN_TRANSIT',
75
+ DELIVERED: 'DELIVERED',
76
+ FAILED: 'FAILED',
77
+ RETURNED: 'RETURNED',
78
+ };
79
+ const basis = expected.basis;
80
+ const time = basis?.providerEventTime ? Date.parse(basis.providerEventTime) : NaN;
81
+ return (
82
+ !!actual &&
83
+ !!basis &&
84
+ Number.isFinite(time) &&
85
+ actual.id === expected.id &&
86
+ actual.statusRevision === expected.input.expectedStatusRevision + 1 &&
87
+ actual.statusAuthority === 'INTEGRATION_EVENT_TIME' &&
88
+ actual.statusAuthorityEpoch === expected.epoch + 1 &&
89
+ actual.designatedIntegrationId === expected.input.integrationId &&
90
+ actual.statusBasisEventId === basis.id &&
91
+ basis.id === expected.input.basisTrackingEventId &&
92
+ typeof actual.statusBasisSourceTime === 'string' &&
93
+ Date.parse(actual.statusBasisSourceTime) === time &&
94
+ actual.maxSourceAgeSeconds === expected.input.maxSourceAgeSeconds &&
95
+ actual.maxFutureSkewSeconds === expected.input.maxFutureSkewSeconds &&
96
+ typeof statuses[basis.eventType] === 'string' &&
97
+ actual.status === statuses[basis.eventType]
98
+ );
99
+ }
100
+
101
+ export function manualStatusAcknowledged(
102
+ actual: StatusAcknowledgement | null | undefined,
103
+ expected: { id: string; revision: number; epoch: number; status: string }
104
+ ): boolean {
105
+ return (
106
+ !!actual &&
107
+ actual.id === expected.id &&
108
+ actual.statusRevision === expected.revision + 1 &&
109
+ actual.status === expected.status &&
110
+ actual.statusAuthority === 'MANUAL_HOLD' &&
111
+ actual.statusAuthorityEpoch === expected.epoch + 1 &&
112
+ actual.designatedIntegrationId === null &&
113
+ actual.statusBasisEventId === null &&
114
+ actual.statusBasisSourceTime === null &&
115
+ actual.maxSourceAgeSeconds === null &&
116
+ actual.maxFutureSkewSeconds === null
117
+ );
118
+ }
@@ -0,0 +1,80 @@
1
+ fragment ShipmentStatusAuthorityFields on MtwShipment {
2
+ id
3
+ shipmentNumber
4
+ status
5
+ statusRevision
6
+ statusAuthority
7
+ statusAuthorityEpoch
8
+ designatedIntegrationId
9
+ statusBasisEventId
10
+ statusBasisSourceTime
11
+ maxSourceAgeSeconds
12
+ maxFutureSkewSeconds
13
+ }
14
+
15
+ query StatusAuthorityShipments($filter: ShipmentFilterInput, $pagination: PaginationInput!) {
16
+ shipments(filter: $filter, pagination: $pagination) {
17
+ ...ShipmentStatusAuthorityFields
18
+ }
19
+ }
20
+
21
+ query StatusAuthorityDetail($id: ID!, $pagination: PaginationInput!, $evidencePagination: PaginationInput!) {
22
+ shipment(id: $id) {
23
+ ...ShipmentStatusAuthorityFields
24
+ trackingEvents(pagination: $evidencePagination) {
25
+ id
26
+ eventType
27
+ sourceIntegrationId
28
+ sourceTimestampProvenance
29
+ providerEventTime
30
+ serverReceivedAt
31
+ timestamp
32
+ }
33
+ }
34
+ shipmentStatusDecisions(shipmentId: $id, pagination: $pagination) {
35
+ id
36
+ origin
37
+ outcome
38
+ heldReason
39
+ observedRevision
40
+ resultRevision
41
+ priorStatus
42
+ resultStatus
43
+ trackingEventId
44
+ proofId
45
+ reason
46
+ recordedAt
47
+ configuredIntegrationId
48
+ configuredMaxSourceAgeSeconds
49
+ configuredMaxFutureSkewSeconds
50
+ }
51
+ }
52
+
53
+ query StatusAuthoritySources($pagination: PaginationInput!) {
54
+ integrations(pagination: $pagination) {
55
+ id
56
+ name
57
+ provider
58
+ status
59
+ }
60
+ }
61
+
62
+ mutation StatusAuthorityConfigure($id: ID!, $input: ConfigureShipmentStatusSourceInput!) {
63
+ configureShipmentStatusSource(id: $id, input: $input) {
64
+ ...ShipmentStatusAuthorityFields
65
+ }
66
+ }
67
+
68
+ mutation StatusAuthorityManual($id: ID!, $input: UpdateShipmentInput!) {
69
+ updateShipment(id: $id, input: $input) {
70
+ ...ShipmentStatusAuthorityFields
71
+ }
72
+ }
73
+
74
+ query StatusAuthorityOwnedDelivery($deliveryJobId: ID!) {
75
+ myEpodShipmentStatus(deliveryJobId: $deliveryJobId) {
76
+ id
77
+ status
78
+ statusRevision
79
+ }
80
+ }