@burdenoff/microfe-movethewheels 2026.1031.6 → 2026.1101.1

package/dist/hooks/useCarrierIntegrations.js

@@ -0,0 +1,141 @@
+import { useMoveTheWheels as e } from "../providers/MoveTheWheelsProvider.js";
+import { executeGraphQL as t } from "../utils/graphqlClient.js";
+import { CREATE_INTEGRATION_MUTATION as n, DELETE_INTEGRATION_MUTATION as r, INTEGRATION_COUNTS_QUERY as i, INTEGRATION_EVENTS_QUERY as a, LIST_INTEGRATIONS_QUERY as o, UPDATE_INTEGRATION_MUTATION as s } from "../utils/carrierIntegrations.js";
+import { useCallback as c, useEffect as l, useMemo as u, useRef as d, useState as f } from "react";
+//#region src/movethewheels/hooks/useCarrierIntegrations.ts
+function p() {
+	let { apiGatewayUrl: t, authToken: n, workspaceToken: r, workspaceId: i, tenantId: a, currentUser: o } = e();
+	return u(() => ({
+		apiGatewayUrl: t,
+		authToken: n,
+		workspaceToken: r,
+		workspaceId: i,
+		tenantId: a,
+		actorId: o?.id
+	}), [
+		t,
+		n,
+		r,
+		i,
+		a,
+		o?.id
+	]);
+}
+function m(e, t) {
+	return e instanceof Error ? e : Error(t);
+}
+function h(e) {
+	let n = p(), { status: r, limit: i, offset: a } = e, [s, u] = f([]), [h, g] = f(0), [_, v] = f(!1), [y, b] = f(null), x = d(0), S = c(async () => {
+		let e = ++x.current;
+		v(!0), b(null);
+		try {
+			let s = await t(n, o, {
+				filter: r ? { status: r } : void 0,
+				pagination: {
+					limit: i,
+					offset: a
+				}
+			});
+			if (e !== x.current) return;
+			u(s.integrations), g(s.integrationsCount);
+		} catch (t) {
+			if (e !== x.current) return;
+			b(m(t, "Failed to load integrations"));
+		} finally {
+			e === x.current && v(!1);
+		}
+	}, [
+		n,
+		r,
+		i,
+		a
+	]);
+	l(() => (S(), () => {
+		x.current += 1;
+	}), [S]);
+	let C = d(S);
+	return l(() => {
+		C.current = S;
+	}, [S]), {
+		integrations: s,
+		total: h,
+		isLoading: _,
+		error: y,
+		refetch: c(() => C.current(), [])
+	};
+}
+function g() {
+	let e = p(), [n, r] = f({
+		all: 0,
+		active: 0
+	}), a = d(0), o = c(async () => {
+		let n = ++a.current;
+		try {
+			let o = await t(e, i, {});
+			n === a.current && r({
+				all: o.all,
+				active: o.active
+			});
+		} catch {}
+	}, [e]);
+	return l(() => (o(), () => {
+		a.current += 1;
+	}), [o]), {
+		...n,
+		refetch: o
+	};
+}
+function _(e, n, r = 20) {
+	let i = p(), [o, s] = f([]), [c, u] = f(!1), [d, h] = f(null);
+	return l(() => {
+		if (!e) {
+			s([]);
+			return;
+		}
+		let n = !1;
+		return u(!0), h(null), t(i, a, {
+			integrationId: e,
+			pagination: {
+				limit: r,
+				offset: 0
+			}
+		}).then((e) => {
+			n || s(e.integrationEvents);
+		}).catch((e) => {
+			n || h(m(e, "Failed to load deliveries"));
+		}).finally(() => {
+			n || u(!1);
+		}), () => {
+			n = !0;
+		};
+	}, [
+		i,
+		e,
+		n,
+		r
+	]), {
+		events: o,
+		isLoading: c,
+		error: d
+	};
+}
+function v() {
+	let e = p();
+	return u(() => ({
+		create: async (r) => (await t(e, n, { input: {
+			...r,
+			name: r.name.trim(),
+			status: "ACTIVE"
+		} }, "SINGLE_ATTEMPT")).createIntegration,
+		update: async (n, r) => (await t(e, s, {
+			id: n,
+			input: r.name === void 0 ? r : {
+				...r,
+				name: r.name.trim()
+			}
+		})).updateIntegration,
+		remove: async (n) => (await t(e, r, { id: n })).deleteIntegration
+	}), [e]);
+}
+//#endregion
+export { v as useCarrierIntegrationActions, g as useCarrierIntegrationCounts, _ as useCarrierIntegrationEvents, h as useCarrierIntegrations };

package/dist/movethewheels/hooks/useCarrierIntegrations.d.ts

@@ -0,0 +1,39 @@
+import { CarrierIntegration, CarrierIntegrationEvent, IntegrationStatus, SupportedProvider } from '../utils/carrierIntegrations';
+export interface CreateCarrierIntegrationInput {
+    provider: SupportedProvider;
+    name: string;
+    apiSecret: string;
+}
+export interface UpdateCarrierIntegrationInput {
+    name?: string;
+    status?: IntegrationStatus;
+    apiSecret?: string;
+}
+export declare function useCarrierIntegrations(options: {
+    status?: IntegrationStatus;
+    limit: number;
+    offset: number;
+}): {
+    integrations: CarrierIntegration[];
+    total: number;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/** Workspace-wide feed counts (all and active) in one request, independent of the list filter. */
+export declare function useCarrierIntegrationCounts(): {
+    refetch: () => Promise<void>;
+    all: number;
+    active: number;
+};
+/** The most recent deliveries for one integration, newest first. */
+export declare function useCarrierIntegrationEvents(integrationId: string | null, refreshKey: number, limit?: number): {
+    events: CarrierIntegrationEvent[];
+    isLoading: boolean;
+    error: Error | null;
+};
+export declare function useCarrierIntegrationActions(): {
+    create: (input: CreateCarrierIntegrationInput) => Promise<CarrierIntegration>;
+    update: (id: string, input: UpdateCarrierIntegrationInput) => Promise<CarrierIntegration>;
+    remove: (id: string) => Promise<boolean>;
+};

package/dist/movethewheels/pages/IntegrationsPage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Remounts the page whenever the host switches tenant or workspace, so no
+ * server state, filter, page, pending reveal or in-flight mutation from the
+ * previous workspace survives into the next one.
+ */
+export default function IntegrationsPage(): import('react').JSX.Element;

package/dist/movethewheels/utils/carrierIntegrations.d.ts

@@ -0,0 +1,88 @@
+/** Providers the service can ingest today. Vendor adapters are refused by the API. */
+export declare const SUPPORTED_PROVIDERS: readonly ["GENERIC_WEBHOOK"];
+export type SupportedProvider = (typeof SUPPORTED_PROVIDERS)[number];
+/** Named networks that need a signed vendor agreement before an adapter can ship. */
+export declare const ROADMAP_PROVIDERS: readonly [{
+    readonly id: "PROJECT44";
+    readonly label: "project44";
+}, {
+    readonly id: "FOURKITES";
+    readonly label: "FourKites";
+}, {
+    readonly id: "DESCARTES";
+    readonly label: "Descartes";
+}];
+export declare const INTEGRATION_STATUSES: readonly ["ACTIVE", "PAUSED", "DISABLED"];
+export type IntegrationStatus = (typeof INTEGRATION_STATUSES)[number];
+export type IntegrationProvider = 'GENERIC_WEBHOOK' | 'PROJECT44' | 'FOURKITES' | 'DESCARTES';
+export type IntegrationEventStatus = 'RECEIVED' | 'ACCEPTED' | 'PARTIAL' | 'REJECTED' | 'DUPLICATE' | 'CONFLICT';
+/** Tracking event types a delivery may carry (the service's TrackingEventType). */
+export declare const TRACKING_EVENT_TYPES: readonly ["CREATED", "PICKED_UP", "IN_TRANSIT", "ARRIVED", "DEPARTED", "OUT_FOR_DELIVERY", "DELIVERED", "FAILED", "RETURNED"];
+/** The service refuses shorter secrets; the generator always produces 64 hex characters. */
+export declare const MIN_SECRET_LENGTH = 32;
+/** Header the workspace gateway forwards; custom headers do not survive the gateway. */
+export declare const SIGNATURE_HEADER = "x-webhook-signature";
+/** Updates accepted in one delivery (a JSON array of at most this many objects). */
+export declare const MAX_UPDATES_PER_DELIVERY = 5;
+export interface CarrierIntegration {
+    id: string;
+    workspaceId: string;
+    provider: IntegrationProvider;
+    name: string;
+    status: IntegrationStatus;
+    lastSyncAt: string | null;
+    lastErrorAt: string | null;
+    lastErrorMessage: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CarrierIntegrationEvent {
+    id: string;
+    integrationId: string;
+    externalEventId: string | null;
+    shipmentId: string | null;
+    eventType: string | null;
+    status: IntegrationEventStatus;
+    errorMessage: string | null;
+    receivedAt: string;
+    processedAt: string | null;
+}
+export declare const LIST_INTEGRATIONS_QUERY = "\n  query MtwCarrierIntegrations($filter: IntegrationFilterInput, $pagination: PaginationInput) {\n    integrations(filter: $filter, pagination: $pagination) {\n      \n  id\n  workspaceId\n  provider\n  name\n  status\n  lastSyncAt\n  lastErrorAt\n  lastErrorMessage\n  createdAt\n  updatedAt\n\n    }\n    integrationsCount(filter: $filter)\n  }\n";
+export declare const INTEGRATION_COUNTS_QUERY = "\n  query MtwCarrierIntegrationCounts {\n    all: integrationsCount\n    active: integrationsCount(filter: { status: ACTIVE })\n  }\n";
+export declare const INTEGRATION_EVENTS_QUERY = "\n  query MtwCarrierIntegrationEvents($integrationId: ID, $pagination: PaginationInput) {\n    integrationEvents(integrationId: $integrationId, pagination: $pagination) {\n      id\n      integrationId\n      externalEventId\n      shipmentId\n      eventType\n      status\n      errorMessage\n      receivedAt\n      processedAt\n    }\n  }\n";
+export declare const CREATE_INTEGRATION_MUTATION = "\n  mutation CreateMtwCarrierIntegration($input: CreateIntegrationInput!) {\n    createIntegration(input: $input) {\n      \n  id\n  workspaceId\n  provider\n  name\n  status\n  lastSyncAt\n  lastErrorAt\n  lastErrorMessage\n  createdAt\n  updatedAt\n\n    }\n  }\n";
+export declare const UPDATE_INTEGRATION_MUTATION = "\n  mutation UpdateMtwCarrierIntegration($id: ID!, $input: UpdateIntegrationInput!) {\n    updateIntegration(id: $id, input: $input) {\n      \n  id\n  workspaceId\n  provider\n  name\n  status\n  lastSyncAt\n  lastErrorAt\n  lastErrorMessage\n  createdAt\n  updatedAt\n\n    }\n  }\n";
+export declare const DELETE_INTEGRATION_MUTATION = "\n  mutation DeleteMtwCarrierIntegration($id: ID!) {\n    deleteIntegration(id: $id)\n  }\n";
+/** Minimal source of randomness, so tests can supply a deterministic one. */
+export interface RandomSource {
+    getRandomValues<T extends ArrayBufferView>(array: T): T;
+}
+/** A fresh 256-bit signing secret as 64 lowercase hex characters. */
+export declare function generateSigningSecret(random?: RandomSource): string;
+/** Returns an error message for an unusable secret, or null when it is fine. */
+export declare function signingSecretError(secret: string): string | null;
+/** Returns an error message for an unusable name, or null when it is fine. */
+export declare function integrationNameError(name: string): string | null;
+/**
+ * The public URL a carrier posts deliveries to. It lives on the same workspace
+ * gateway host the app already talks to: `/api/integrations/webhook/<workspace>/<integration>`.
+ * A relative gateway URL (local development behind the dev proxy) resolves
+ * against `fallbackOrigin`.
+ */
+export declare function webhookUrl(apiGatewayUrl: string | undefined, workspaceId: string, integrationId: string, fallbackOrigin: string): string;
+/** An example delivery body for the setup instructions. */
+export declare function examplePayload(now?: Date): string;
+/** Quotes a value for a POSIX shell: single quotes, with embedded ones escaped. */
+export declare function shellQuote(value: string): string;
+/**
+ * A copy-paste shell example that signs and sends one delivery. The secret is
+ * referenced as an environment variable so it never appears in the snippet.
+ */
+export declare function curlExample(url: string): string;
+/** "OUT_FOR_DELIVERY" → "Out for delivery". */
+export declare function humanize(value: string): string;
+export type BadgeTone = 'default' | 'secondary' | 'outline' | 'destructive';
+export declare function integrationStatusTone(status: IntegrationStatus): BadgeTone;
+export declare function eventStatusTone(status: IntegrationEventStatus): BadgeTone;
+/** What a webhook sender sees for each status, shown next to the status control. */
+export declare function statusExplanation(status: IntegrationStatus): string;

package/dist/node_modules/lucide-react/dist/esm/icons/copy.js

@@ -0,0 +1,16 @@
+import { createLucideIcon as e } from "../createLucideIcon.js";
+//#region node_modules/lucide-react/dist/esm/icons/copy.js
+var t = e("Copy", [["rect", {
+	width: "14",
+	height: "14",
+	x: "8",
+	y: "8",
+	rx: "2",
+	ry: "2",
+	key: "17jyea"
+}], ["path", {
+	d: "M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2",
+	key: "zix9uf"
+}]]);
+//#endregion
+export { t as Copy };

package/dist/node_modules/lucide-react/dist/esm/icons/pause.js

@@ -0,0 +1,19 @@
+import { createLucideIcon as e } from "../createLucideIcon.js";
+//#region node_modules/lucide-react/dist/esm/icons/pause.js
+var t = e("Pause", [["rect", {
+	x: "14",
+	y: "4",
+	width: "4",
+	height: "16",
+	rx: "1",
+	key: "zuxfzm"
+}], ["rect", {
+	x: "6",
+	y: "4",
+	width: "4",
+	height: "16",
+	rx: "1",
+	key: "1okwgv"
+}]]);
+//#endregion
+export { t as Pause };

package/dist/node_modules/lucide-react/dist/esm/icons/play.js

@@ -0,0 +1,8 @@
+import { createLucideIcon as e } from "../createLucideIcon.js";
+//#region node_modules/lucide-react/dist/esm/icons/play.js
+var t = e("Play", [["polygon", {
+	points: "6 3 20 12 6 21 6 3",
+	key: "1oa8hb"
+}]]);
+//#endregion
+export { t as Play };