@undefineds.co/xpod 0.3.53 → 0.3.54

package/dist/edge/reachability/ManagedClientFetch.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSignaledManagedClientFetch = createSignaledManagedClientFetch;
+exports.createManagedClientFetch = createManagedClientFetch;
+const CanonicalFetch_1 = require("./CanonicalFetch");
+const P2PDataPlane_1 = require("./P2PDataPlane");
+const P2PSignalingClient_1 = require("./P2PSignalingClient");
+const TcpP2PSignalingSession_1 = require("./TcpP2PSignalingSession");
+async function createSignaledManagedClientFetch(options) {
+    const { apiBaseUrl, nodeId, token, clientId, fetchImpl, probe, probeTimeoutMs, ...p2pOptions } = options;
+    const routeSet = await fetchManagedRouteSet({
+        apiBaseUrl,
+        nodeId,
+        token,
+        fetchImpl,
+    });
+    const signaling = (0, P2PSignalingClient_1.createP2PSignalingClient)({
+        apiBaseUrl,
+        nodeId,
+        token,
+        fetchImpl,
+    });
+    return createManagedClientFetch({
+        routeSet,
+        fetchImpl,
+        probe,
+        probeTimeoutMs,
+        p2p: {
+            ...p2pOptions,
+            signaling,
+            clientId,
+        },
+    });
+}
+async function createManagedClientFetch(options) {
+    const errors = [];
+    for (const route of candidateRoutes(options.routeSet)) {
+        if (!await routeProbeSucceeds(route, options)) {
+            continue;
+        }
+        if (route.kind === 'p2p') {
+            if (!options.p2p) {
+                errors.push(`Route ${route.id} requires p2p options`);
+                continue;
+            }
+            try {
+                const connected = await (0, TcpP2PSignalingSession_1.connectSignaledRawTcpP2PTransport)(options.p2p);
+                const fetchViaP2P = (0, P2PDataPlane_1.createP2PDataPlaneFetch)({
+                    route: connected.rawTcpRoute ?? route,
+                    transport: connected.transport,
+                });
+                return managedResult(route, fetchViaP2P, connected.transport);
+            }
+            catch (error) {
+                errors.push(`Route ${route.id} failed: ${error instanceof Error ? error.message : String(error)}`);
+                continue;
+            }
+        }
+        return managedResult(route, (0, CanonicalFetch_1.createCanonicalFetch)({ route, fetchImpl: options.fetchImpl }));
+    }
+    throw new Error(`No managed client route could be opened${errors.length > 0 ? `: ${errors.join('; ')}` : ''}`);
+}
+function candidateRoutes(routeSet) {
+    return routeSet.routes
+        .filter((route) => route.health !== 'unreachable')
+        .slice()
+        .sort((left, right) => left.priority - right.priority || left.id.localeCompare(right.id));
+}
+async function routeProbeSucceeds(route, options) {
+    const probe = options.probe ?? defaultManagedProbe;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), options.probeTimeoutMs ?? 1_000);
+    try {
+        return await Promise.resolve(probe(route, controller.signal));
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+async function defaultManagedProbe(route, signal) {
+    if (route.kind === 'p2p') {
+        return route.health !== 'unreachable';
+    }
+    if (!route.targetUrl.startsWith('http://') && !route.targetUrl.startsWith('https://')) {
+        return route.health === 'healthy';
+    }
+    const response = await fetch(new URL('/.well-known/solid', route.targetUrl), {
+        method: 'HEAD',
+        signal,
+    });
+    return response.ok || response.status === 401 || response.status === 403;
+}
+function managedResult(route, fetch, transport) {
+    return {
+        route,
+        fetch,
+        close() {
+            transport?.close();
+        },
+    };
+}
+async function fetchManagedRouteSet(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const headers = new Headers({ accept: 'application/json' });
+    if (options.token) {
+        headers.set('authorization', `Bearer ${options.token}`);
+    }
+    const response = await fetchImpl(new URL(`/v1/signal/nodes/${encodeURIComponent(options.nodeId)}/routes`, options.apiBaseUrl).toString(), {
+        method: 'GET',
+        headers,
+    });
+    if (!response.ok) {
+        throw new Error(`Route set request failed with ${response.status}: ${await safeReadText(response)}`);
+    }
+    const body = await response.json();
+    if (!isRouteSet(body)) {
+        throw new Error('Route set response is not a valid route set');
+    }
+    return body;
+}
+async function safeReadText(response) {
+    try {
+        return await response.text();
+    }
+    catch {
+        return '';
+    }
+}
+function isRouteSet(value) {
+    return isRecord(value)
+        && typeof value.nodeId === 'string'
+        && typeof value.canonicalUrl === 'string'
+        && typeof value.generatedAt === 'string'
+        && Array.isArray(value.routes)
+        && value.routes.every(isAccessRoute);
+}
+function isAccessRoute(value) {
+    return isRecord(value)
+        && typeof value.id === 'string'
+        && typeof value.nodeId === 'string'
+        && typeof value.canonicalUrl === 'string'
+        && typeof value.kind === 'string'
+        && typeof value.targetUrl === 'string'
+        && typeof value.priority === 'number'
+        && typeof value.requiresManagedClient === 'boolean'
+        && typeof value.visibility === 'string'
+        && typeof value.health === 'string';
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+//# sourceMappingURL=ManagedClientFetch.js.map

package/dist/edge/reachability/ManagedClientFetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManagedClientFetch.js","sourceRoot":"","sources":["../../../src/edge/reachability/ManagedClientFetch.ts"],"names":[],"mappings":"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","sourcesContent":["import { createCanonicalFetch, type CanonicalFetch } from './CanonicalFetch';\nimport { createP2PDataPlaneFetch } from './P2PDataPlane';\nimport { createP2PSignalingClient } from './P2PSignalingClient';\nimport {\n  connectSignaledRawTcpP2PTransport,\n  type ConnectSignaledRawTcpP2PTransportOptions,\n} from './TcpP2PSignalingSession';\nimport type { TcpP2PDataPlaneTransport } from './TcpP2PDataPlaneTransport';\nimport type { AccessRoute, RouteSet } from './types';\n\ntype ManagedClientP2POptions =\n  Omit<ConnectSignaledRawTcpP2PTransportOptions, 'signaling' | 'clientId'>\n  & Pick<ConnectSignaledRawTcpP2PTransportOptions, 'signaling' | 'clientId'>;\n\ntype SignaledManagedClientP2POptions = Omit<ManagedClientP2POptions, 'signaling' | 'clientId'>;\n\nexport interface ManagedClientFetchOptions {\n  routeSet: RouteSet;\n  fetchImpl?: typeof fetch;\n  probe?: (route: AccessRoute, signal: AbortSignal) => Promise<boolean> | boolean;\n  probeTimeoutMs?: number;\n  p2p?: ManagedClientP2POptions;\n}\n\nexport interface ManagedClientFetch {\n  route: AccessRoute;\n  fetch: CanonicalFetch;\n  close(): void;\n}\n\nexport interface SignaledManagedClientFetchOptions\n  extends Omit<ManagedClientFetchOptions, 'routeSet' | 'p2p'>, SignaledManagedClientP2POptions {\n  apiBaseUrl: string;\n  nodeId: string;\n  token?: string;\n  clientId: string;\n}\n\nexport async function createSignaledManagedClientFetch(options: SignaledManagedClientFetchOptions): Promise<ManagedClientFetch> {\n  const {\n    apiBaseUrl,\n    nodeId,\n    token,\n    clientId,\n    fetchImpl,\n    probe,\n    probeTimeoutMs,\n    ...p2pOptions\n  } = options;\n  const routeSet = await fetchManagedRouteSet({\n    apiBaseUrl,\n    nodeId,\n    token,\n    fetchImpl,\n  });\n  const signaling = createP2PSignalingClient({\n    apiBaseUrl,\n    nodeId,\n    token,\n    fetchImpl,\n  });\n  return createManagedClientFetch({\n    routeSet,\n    fetchImpl,\n    probe,\n    probeTimeoutMs,\n    p2p: {\n      ...p2pOptions,\n      signaling,\n      clientId,\n    },\n  });\n}\n\nexport async function createManagedClientFetch(options: ManagedClientFetchOptions): Promise<ManagedClientFetch> {\n  const errors: string[] = [];\n  for (const route of candidateRoutes(options.routeSet)) {\n    if (!await routeProbeSucceeds(route, options)) {\n      continue;\n    }\n    if (route.kind === 'p2p') {\n      if (!options.p2p) {\n        errors.push(`Route ${route.id} requires p2p options`);\n        continue;\n      }\n      try {\n        const connected = await connectSignaledRawTcpP2PTransport(options.p2p);\n        const fetchViaP2P = createP2PDataPlaneFetch({\n          route: connected.rawTcpRoute ?? route,\n          transport: connected.transport,\n        });\n        return managedResult(route, fetchViaP2P, connected.transport);\n      } catch (error) {\n        errors.push(`Route ${route.id} failed: ${error instanceof Error ? error.message : String(error)}`);\n        continue;\n      }\n    }\n\n    return managedResult(route, createCanonicalFetch({ route, fetchImpl: options.fetchImpl }));\n  }\n\n  throw new Error(`No managed client route could be opened${errors.length > 0 ? `: ${errors.join('; ')}` : ''}`);\n}\n\nfunction candidateRoutes(routeSet: RouteSet): AccessRoute[] {\n  return routeSet.routes\n    .filter((route) => route.health !== 'unreachable')\n    .slice()\n    .sort((left, right) => left.priority - right.priority || left.id.localeCompare(right.id));\n}\n\nasync function routeProbeSucceeds(route: AccessRoute, options: ManagedClientFetchOptions): Promise<boolean> {\n  const probe = options.probe ?? defaultManagedProbe;\n  const controller = new AbortController();\n  const timeout = setTimeout(() => controller.abort(), options.probeTimeoutMs ?? 1_000);\n  try {\n    return await Promise.resolve(probe(route, controller.signal));\n  } catch {\n    return false;\n  } finally {\n    clearTimeout(timeout);\n  }\n}\n\nasync function defaultManagedProbe(route: AccessRoute, signal: AbortSignal): Promise<boolean> {\n  if (route.kind === 'p2p') {\n    return route.health !== 'unreachable';\n  }\n  if (!route.targetUrl.startsWith('http://') && !route.targetUrl.startsWith('https://')) {\n    return route.health === 'healthy';\n  }\n  const response = await fetch(new URL('/.well-known/solid', route.targetUrl), {\n    method: 'HEAD',\n    signal,\n  });\n  return response.ok || response.status === 401 || response.status === 403;\n}\n\nfunction managedResult(\n  route: AccessRoute,\n  fetch: CanonicalFetch,\n  transport?: TcpP2PDataPlaneTransport,\n): ManagedClientFetch {\n  return {\n    route,\n    fetch,\n    close(): void {\n      transport?.close();\n    },\n  };\n}\n\nasync function fetchManagedRouteSet(options: {\n  apiBaseUrl: string;\n  nodeId: string;\n  token?: string;\n  fetchImpl?: typeof fetch;\n}): Promise<RouteSet> {\n  const fetchImpl = options.fetchImpl ?? fetch;\n  const headers = new Headers({ accept: 'application/json' });\n  if (options.token) {\n    headers.set('authorization', `Bearer ${options.token}`);\n  }\n  const response = await fetchImpl(new URL(`/v1/signal/nodes/${encodeURIComponent(options.nodeId)}/routes`, options.apiBaseUrl).toString(), {\n    method: 'GET',\n    headers,\n  });\n  if (!response.ok) {\n    throw new Error(`Route set request failed with ${response.status}: ${await safeReadText(response)}`);\n  }\n  const body = await response.json() as unknown;\n  if (!isRouteSet(body)) {\n    throw new Error('Route set response is not a valid route set');\n  }\n  return body;\n}\n\nasync function safeReadText(response: Response): Promise<string> {\n  try {\n    return await response.text();\n  } catch {\n    return '';\n  }\n}\n\nfunction isRouteSet(value: unknown): value is RouteSet {\n  return isRecord(value)\n    && typeof value.nodeId === 'string'\n    && typeof value.canonicalUrl === 'string'\n    && typeof value.generatedAt === 'string'\n    && Array.isArray(value.routes)\n    && value.routes.every(isAccessRoute);\n}\n\nfunction isAccessRoute(value: unknown): value is AccessRoute {\n  return isRecord(value)\n    && typeof value.id === 'string'\n    && typeof value.nodeId === 'string'\n    && typeof value.canonicalUrl === 'string'\n    && typeof value.kind === 'string'\n    && typeof value.targetUrl === 'string'\n    && typeof value.priority === 'number'\n    && typeof value.requiresManagedClient === 'boolean'\n    && typeof value.visibility === 'string'\n    && typeof value.health === 'string';\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);\n}\n"]}

package/dist/edge/reachability/ManagedClientFetch.jsonld

@@ -0,0 +1,83 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#ManagedClientFetchOptions",
+      "@type": "AbstractClass",
+      "requireElement": "ManagedClientFetchOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#ManagedClientFetchOptions__member_routeSet",
+          "memberFieldName": "routeSet"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#ManagedClientFetchOptions__member_fetchImpl",
+          "memberFieldName": "fetchImpl"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#ManagedClientFetchOptions__member_probe",
+          "memberFieldName": "probe"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#ManagedClientFetchOptions__member_probeTimeoutMs",
+          "memberFieldName": "probeTimeoutMs"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#ManagedClientFetchOptions__member_p2p",
+          "memberFieldName": "p2p"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#ManagedClientFetch",
+      "@type": "AbstractClass",
+      "requireElement": "ManagedClientFetch",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#ManagedClientFetch__member_route",
+          "memberFieldName": "route"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#ManagedClientFetch__member_fetch",
+          "memberFieldName": "fetch"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#ManagedClientFetch__member_close",
+          "memberFieldName": "close"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#SignaledManagedClientFetchOptions",
+      "@type": "AbstractClass",
+      "requireElement": "SignaledManagedClientFetchOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#SignaledManagedClientFetchOptions__member_apiBaseUrl",
+          "memberFieldName": "apiBaseUrl"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#SignaledManagedClientFetchOptions__member_nodeId",
+          "memberFieldName": "nodeId"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#SignaledManagedClientFetchOptions__member_token",
+          "memberFieldName": "token"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#SignaledManagedClientFetchOptions__member_clientId",
+          "memberFieldName": "clientId"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/edge/reachability/ManagedClientP2PSmoke.d.ts

@@ -0,0 +1,16 @@
+import { type SignaledManagedClientFetchOptions } from './ManagedClientFetch';
+import type { AccessRoute } from './types';
+export interface ManagedClientP2PSmokeOptions extends SignaledManagedClientFetchOptions {
+    resourceUrl: string;
+    requestInit?: RequestInit;
+}
+export interface ManagedClientP2PSmokeResult {
+    ok: boolean;
+    route: AccessRoute;
+    resourceUrl: string;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    body: string;
+}
+export declare function runManagedClientP2PSmoke(options: ManagedClientP2PSmokeOptions): Promise<ManagedClientP2PSmokeResult>;

package/dist/edge/reachability/ManagedClientP2PSmoke.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runManagedClientP2PSmoke = runManagedClientP2PSmoke;
+const ManagedClientFetch_1 = require("./ManagedClientFetch");
+async function runManagedClientP2PSmoke(options) {
+    const { resourceUrl, requestInit, ...fetchOptions } = options;
+    const managed = await (0, ManagedClientFetch_1.createSignaledManagedClientFetch)(fetchOptions);
+    try {
+        const response = await managed.fetch(resourceUrl, requestInit);
+        return {
+            ok: response.ok,
+            route: managed.route,
+            resourceUrl,
+            status: response.status,
+            statusText: response.statusText,
+            headers: headersToRecord(response.headers),
+            body: await response.text(),
+        };
+    }
+    finally {
+        managed.close();
+    }
+}
+function headersToRecord(headers) {
+    const result = {};
+    headers.forEach((value, key) => {
+        result[key] = value;
+    });
+    return result;
+}
+//# sourceMappingURL=ManagedClientP2PSmoke.js.map

package/dist/edge/reachability/ManagedClientP2PSmoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManagedClientP2PSmoke.js","sourceRoot":"","sources":["../../../src/edge/reachability/ManagedClientP2PSmoke.ts"],"names":[],"mappings":";;AAqBA,4DAmBC;AAxCD,6DAG8B;AAkBvB,KAAK,UAAU,wBAAwB,CAC5C,OAAqC;IAErC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,IAAA,qDAAgC,EAAC,YAAY,CAAC,CAAC;IACrE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC/D,OAAO;YACL,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW;YACX,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC1C,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE;SAC5B,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,OAAgB;IACvC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import {\n  createSignaledManagedClientFetch,\n  type SignaledManagedClientFetchOptions,\n} from './ManagedClientFetch';\nimport type { AccessRoute } from './types';\n\nexport interface ManagedClientP2PSmokeOptions extends SignaledManagedClientFetchOptions {\n  resourceUrl: string;\n  requestInit?: RequestInit;\n}\n\nexport interface ManagedClientP2PSmokeResult {\n  ok: boolean;\n  route: AccessRoute;\n  resourceUrl: string;\n  status: number;\n  statusText: string;\n  headers: Record<string, string>;\n  body: string;\n}\n\nexport async function runManagedClientP2PSmoke(\n  options: ManagedClientP2PSmokeOptions,\n): Promise<ManagedClientP2PSmokeResult> {\n  const { resourceUrl, requestInit, ...fetchOptions } = options;\n  const managed = await createSignaledManagedClientFetch(fetchOptions);\n  try {\n    const response = await managed.fetch(resourceUrl, requestInit);\n    return {\n      ok: response.ok,\n      route: managed.route,\n      resourceUrl,\n      status: response.status,\n      statusText: response.statusText,\n      headers: headersToRecord(response.headers),\n      body: await response.text(),\n    };\n  } finally {\n    managed.close();\n  }\n}\n\nfunction headersToRecord(headers: Headers): Record<string, string> {\n  const result: Record<string, string> = {};\n  headers.forEach((value, key) => {\n    result[key] = value;\n  });\n  return result;\n}\n"]}

package/dist/edge/reachability/ManagedClientP2PSmoke.jsonld

@@ -0,0 +1,65 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/edge/reachability/ManagedClientP2PSmoke.jsonld#ManagedClientP2PSmokeOptions",
+      "@type": "AbstractClass",
+      "requireElement": "ManagedClientP2PSmokeOptions",
+      "extends": [
+        "undefineds:dist/edge/reachability/ManagedClientFetch.jsonld#SignaledManagedClientFetchOptions"
+      ],
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientP2PSmoke.jsonld#ManagedClientP2PSmokeOptions__member_resourceUrl",
+          "memberFieldName": "resourceUrl"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientP2PSmoke.jsonld#ManagedClientP2PSmokeOptions__member_requestInit",
+          "memberFieldName": "requestInit"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/edge/reachability/ManagedClientP2PSmoke.jsonld#ManagedClientP2PSmokeResult",
+      "@type": "AbstractClass",
+      "requireElement": "ManagedClientP2PSmokeResult",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientP2PSmoke.jsonld#ManagedClientP2PSmokeResult__member_ok",
+          "memberFieldName": "ok"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientP2PSmoke.jsonld#ManagedClientP2PSmokeResult__member_route",
+          "memberFieldName": "route"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientP2PSmoke.jsonld#ManagedClientP2PSmokeResult__member_resourceUrl",
+          "memberFieldName": "resourceUrl"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientP2PSmoke.jsonld#ManagedClientP2PSmokeResult__member_status",
+          "memberFieldName": "status"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientP2PSmoke.jsonld#ManagedClientP2PSmokeResult__member_statusText",
+          "memberFieldName": "statusText"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientP2PSmoke.jsonld#ManagedClientP2PSmokeResult__member_headers",
+          "memberFieldName": "headers"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedClientP2PSmoke.jsonld#ManagedClientP2PSmokeResult__member_body",
+          "memberFieldName": "body"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/edge/reachability/ManagedRouteSelector.d.ts

@@ -0,0 +1,7 @@
+import type { AccessRoute, RouteSet } from './types';
+export interface ChooseAccessRouteOptions {
+    managedClient: boolean;
+    timeoutMs?: number;
+    probe?: (route: AccessRoute, signal: AbortSignal) => Promise<boolean> | boolean;
+}
+export declare function chooseAccessRoute(routeSet: RouteSet, options: ChooseAccessRouteOptions): Promise<AccessRoute | null>;

package/dist/edge/reachability/ManagedRouteSelector.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chooseAccessRoute = chooseAccessRoute;
+async function chooseAccessRoute(routeSet, options) {
+    const candidates = routeSet.routes
+        .filter((route) => route.health !== 'unreachable')
+        .filter((route) => options.managedClient || !route.requiresManagedClient)
+        .slice()
+        .sort((left, right) => left.priority - right.priority || left.id.localeCompare(right.id));
+    if (candidates.length === 0) {
+        return null;
+    }
+    const probe = options.probe ?? defaultProbe;
+    const results = await Promise.all(candidates.map(async (route) => ({
+        route,
+        ok: await probeWithTimeout(route, probe, options.timeoutMs ?? 1_000),
+    })));
+    return results.find((result) => result.ok)?.route ?? null;
+}
+async function probeWithTimeout(route, probe, timeoutMs) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await Promise.resolve(probe(route, controller.signal));
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+async function defaultProbe(route, signal) {
+    if (!route.targetUrl.startsWith('http://') && !route.targetUrl.startsWith('https://')) {
+        return route.health === 'healthy';
+    }
+    const response = await fetch(new URL('/.well-known/solid', route.targetUrl), {
+        method: 'HEAD',
+        signal,
+    });
+    return response.ok || response.status === 401 || response.status === 403;
+}
+//# sourceMappingURL=ManagedRouteSelector.js.map

package/dist/edge/reachability/ManagedRouteSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManagedRouteSelector.js","sourceRoot":"","sources":["../../../src/edge/reachability/ManagedRouteSelector.ts"],"names":[],"mappings":";;AAQA,8CAqBC;AArBM,KAAK,UAAU,iBAAiB,CACrC,QAAkB,EAClB,OAAiC;IAEjC,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM;SAC/B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,aAAa,CAAC;SACjD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC;SACxE,KAAK,EAAE;SACP,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5F,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACjE,KAAK;QACL,EAAE,EAAE,MAAM,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;KACrE,CAAC,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;AAC5D,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,KAAkB,EAClB,KAA8E,EAC9E,SAAiB;IAEjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAChE,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,KAAkB,EAAE,MAAmB;IACjE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACtF,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;IACpC,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE;QAC3E,MAAM,EAAE,MAAM;QACd,MAAM;KACP,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC;AAC3E,CAAC","sourcesContent":["import type { AccessRoute, RouteSet } from './types';\n\nexport interface ChooseAccessRouteOptions {\n  managedClient: boolean;\n  timeoutMs?: number;\n  probe?: (route: AccessRoute, signal: AbortSignal) => Promise<boolean> | boolean;\n}\n\nexport async function chooseAccessRoute(\n  routeSet: RouteSet,\n  options: ChooseAccessRouteOptions,\n): Promise<AccessRoute | null> {\n  const candidates = routeSet.routes\n    .filter((route) => route.health !== 'unreachable')\n    .filter((route) => options.managedClient || !route.requiresManagedClient)\n    .slice()\n    .sort((left, right) => left.priority - right.priority || left.id.localeCompare(right.id));\n\n  if (candidates.length === 0) {\n    return null;\n  }\n\n  const probe = options.probe ?? defaultProbe;\n  const results = await Promise.all(candidates.map(async (route) => ({\n    route,\n    ok: await probeWithTimeout(route, probe, options.timeoutMs ?? 1_000),\n  })));\n\n  return results.find((result) => result.ok)?.route ?? null;\n}\n\nasync function probeWithTimeout(\n  route: AccessRoute,\n  probe: (route: AccessRoute, signal: AbortSignal) => Promise<boolean> | boolean,\n  timeoutMs: number,\n): Promise<boolean> {\n  const controller = new AbortController();\n  const timeout = setTimeout(() => controller.abort(), timeoutMs);\n  try {\n    return await Promise.resolve(probe(route, controller.signal));\n  } catch {\n    return false;\n  } finally {\n    clearTimeout(timeout);\n  }\n}\n\nasync function defaultProbe(route: AccessRoute, signal: AbortSignal): Promise<boolean> {\n  if (!route.targetUrl.startsWith('http://') && !route.targetUrl.startsWith('https://')) {\n    return route.health === 'healthy';\n  }\n  const response = await fetch(new URL('/.well-known/solid', route.targetUrl), {\n    method: 'HEAD',\n    signal,\n  });\n  return response.ok || response.status === 401 || response.status === 403;\n}\n"]}

package/dist/edge/reachability/ManagedRouteSelector.jsonld

@@ -0,0 +1,29 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/edge/reachability/ManagedRouteSelector.jsonld#ChooseAccessRouteOptions",
+      "@type": "AbstractClass",
+      "requireElement": "ChooseAccessRouteOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedRouteSelector.jsonld#ChooseAccessRouteOptions__member_managedClient",
+          "memberFieldName": "managedClient"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedRouteSelector.jsonld#ChooseAccessRouteOptions__member_timeoutMs",
+          "memberFieldName": "timeoutMs"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/ManagedRouteSelector.jsonld#ChooseAccessRouteOptions__member_probe",
+          "memberFieldName": "probe"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/edge/reachability/P2PDataPlane.d.ts

@@ -0,0 +1,37 @@
+import type { AccessRoute } from './types';
+export declare const XPOD_P2P_HTTP_PROTOCOL: "xpod-p2p-http/1";
+export type P2PHttpProtocol = typeof XPOD_P2P_HTTP_PROTOCOL;
+export type P2PHttpHeaderList = [string, string][];
+export interface P2PHttpRequestFrame {
+    protocol: P2PHttpProtocol;
+    requestId?: string;
+    method: string;
+    url: string;
+    headers?: P2PHttpHeaderList;
+    bodyBase64?: string;
+}
+export interface P2PHttpResponseFrame {
+    protocol: P2PHttpProtocol;
+    requestId?: string;
+    status: number;
+    statusText?: string;
+    headers?: P2PHttpHeaderList;
+    bodyBase64?: string;
+}
+export interface P2PDataPlaneTransport {
+    request(frame: P2PHttpRequestFrame): Promise<P2PHttpResponseFrame>;
+}
+export interface P2PDataPlaneFetchOptions {
+    route: AccessRoute;
+    transport: P2PDataPlaneTransport;
+}
+export interface P2PDataPlaneHandlerOptions {
+    targetBaseUrl: string | URL;
+    fetchImpl?: typeof fetch;
+}
+export interface P2PDataPlaneHandler {
+    handleRequest(frame: P2PHttpRequestFrame): Promise<P2PHttpResponseFrame>;
+}
+export type P2PDataPlaneFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export declare function createP2PDataPlaneFetch(options: P2PDataPlaneFetchOptions): P2PDataPlaneFetch;
+export declare function createP2PDataPlaneHandler(options: P2PDataPlaneHandlerOptions): P2PDataPlaneHandler;