@undefineds.co/xpod 0.3.52 → 0.3.54

package/dist/edge/EdgeNodeAgentInitializer.js

@@ -25,8 +25,7 @@ class EdgeNodeAgentInitializer extends community_server_1.Initializer {
         // 运行时严格校验参数
         this.validateOptions(this.options);
         try {
-            // 此时已确认 options 符合 EdgeNodeAgentOptions (去除 Partial)
-            await this.agent.start(this.options);
+            await this.agent.start(this.buildAgentOptions(this.options));
             this.logger.info(`EdgeNodeAgent started (Node: ${this.options.nodeId})`);
         }
         catch (error) {
@@ -45,10 +44,38 @@ class EdgeNodeAgentInitializer extends community_server_1.Initializer {
             missing.push('nodeId');
         if (!options.nodeToken)
             missing.push('nodeToken');
+        if (this.normalizeBoolean(options.p2pEnabled) && !options.p2pTargetBaseUrl) {
+            missing.push('p2pTargetBaseUrl');
+        }
         if (missing.length > 0) {
             throw new Error(`EdgeNodeAgent enabled but missing required configuration: ${missing.join(', ')}`);
         }
     }
+    buildAgentOptions(options) {
+        const p2pEnabled = this.normalizeBoolean(options.p2pEnabled);
+        return {
+            signalEndpoint: options.signalEndpoint,
+            nodeId: options.nodeId,
+            nodeToken: options.nodeToken,
+            baseUrl: options.baseUrl,
+            directCandidates: options.directCandidates,
+            pods: options.pods,
+            includeSystemMetrics: options.includeSystemMetrics,
+            enableNetworkDetection: options.enableNetworkDetection,
+            metadata: options.metadata,
+            intervalMs: this.normalizePositiveInteger(options.intervalMs),
+            ...(p2pEnabled ? {
+                p2p: {
+                    enabled: true,
+                    targetBaseUrl: options.p2pTargetBaseUrl,
+                    label: options.p2pLabel,
+                    acceptIntervalMs: this.normalizePositiveInteger(options.p2pAcceptIntervalMs),
+                    connectTimeoutMs: this.normalizePositiveInteger(options.p2pConnectTimeoutMs),
+                    winnerSelectionWindowMs: this.normalizeNonNegativeInteger(options.p2pWinnerSelectionWindowMs),
+                },
+            } : {}),
+        };
+    }
     normalizeBoolean(value) {
         if (typeof value === 'boolean') {
             return value;
@@ -59,6 +86,30 @@ class EdgeNodeAgentInitializer extends community_server_1.Initializer {
         }
         return false;
     }
+    normalizePositiveInteger(value) {
+        if (typeof value === 'number' && Number.isFinite(value) && value > 0) {
+            return value;
+        }
+        if (typeof value === 'string') {
+            const parsed = Number(value);
+            if (Number.isFinite(parsed) && parsed > 0) {
+                return parsed;
+            }
+        }
+        return undefined;
+    }
+    normalizeNonNegativeInteger(value) {
+        if (typeof value === 'number' && Number.isFinite(value) && value >= 0) {
+            return Math.floor(value);
+        }
+        if (typeof value === 'string') {
+            const parsed = Number(value);
+            if (Number.isFinite(parsed) && parsed >= 0) {
+                return Math.floor(parsed);
+            }
+        }
+        return undefined;
+    }
 }
 exports.EdgeNodeAgentInitializer = EdgeNodeAgentInitializer;
 //# sourceMappingURL=EdgeNodeAgentInitializer.js.map

package/dist/edge/EdgeNodeAgentInitializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"EdgeNodeAgentInitializer.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeAgentInitializer.ts"],"names":[],"mappings":";;;AAAA,8DAAsD;AACtD,iEAAqD;AACrD,mDAA2E;AAS3E;;;GAGG;AACH,MAAa,wBAAyB,SAAQ,8BAAW;IAMvD,YAAmB,OAAwC;QACzD,KAAK,EAAE,CAAC;QANS,WAAM,GAAG,IAAA,oCAAY,EAAC,IAAI,CAAC,CAAC;QAO7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,IAAI,6BAAa,EAAE,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;IAEe,KAAK,CAAC,MAAM;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAClE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAE9C,YAAY;QACZ,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEnC,IAAI,CAAC;YACH,qDAAqD;YACrD,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAA+B,CAAC,CAAC;YAC7D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAmC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YAChF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,OAAwC;QAC9D,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,IAAI,CAAC,OAAO,CAAC,cAAc;YAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAElD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,6DAA6D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,KAAmC;QAC1D,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC9C,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,IAAI,CAAC;QACpG,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AA3DD,4DA2DC","sourcesContent":["import { Initializer } from '@solid/community-server';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { EdgeNodeAgent, type EdgeNodeAgentOptions } from './EdgeNodeAgent';\n\n/**\n * 所有配置项设为可选，以便在 disabled 状态下即使缺少 CLI 变量也能成功实例化。\n */\nexport interface EdgeNodeAgentInitializerOptions extends Partial<EdgeNodeAgentOptions> {\n  enabled?: boolean | string;\n}\n\n/**\n * Initializer that starts the EdgeNodeAgent.\n * Designed to be safe to configure even when disabled or missing dependent variables.\n */\nexport class EdgeNodeAgentInitializer extends Initializer {\n  protected readonly logger = getLoggerFor(this);\n  private readonly agent: EdgeNodeAgent;\n  private readonly options: EdgeNodeAgentInitializerOptions;\n  private readonly enabled: boolean;\n\n  public constructor(options: EdgeNodeAgentInitializerOptions) {\n    super();\n    this.options = options;\n    this.agent = new EdgeNodeAgent();\n    this.enabled = this.normalizeBoolean(options.enabled);\n  }\n\n  public override async handle(): Promise<void> {\n    if (!this.enabled) {\n      this.logger.debug('EdgeNodeAgent is disabled, skipping startup.');\n      return;\n    }\n\n    this.logger.info('Enabling EdgeNodeAgent...');\n    \n    // 运行时严格校验参数\n    this.validateOptions(this.options);\n\n    try {\n      // 此时已确认 options 符合 EdgeNodeAgentOptions (去除 Partial)\n      await this.agent.start(this.options as EdgeNodeAgentOptions);\n      this.logger.info(`EdgeNodeAgent started (Node: ${this.options.nodeId})`);\n    } catch (error: unknown) {\n      this.logger.error(`Failed to start EdgeNodeAgent: ${(error as Error).message}`);\n      throw error;\n    }\n  }\n\n  /**\n   * 确保启用时必需参数存在\n   */\n  private validateOptions(options: EdgeNodeAgentInitializerOptions): asserts options is EdgeNodeAgentOptions {\n    const missing: string[] = [];\n    \n    if (!options.signalEndpoint) missing.push('signalEndpoint');\n    if (!options.nodeId) missing.push('nodeId');\n    if (!options.nodeToken) missing.push('nodeToken');\n\n    if (missing.length > 0) {\n      throw new Error(`EdgeNodeAgent enabled but missing required configuration: ${missing.join(', ')}`);\n    }\n  }\n\n  private normalizeBoolean(value: string | boolean | undefined): boolean {\n    if (typeof value === 'boolean') {\n      return value;\n    }\n    if (typeof value === 'string') {\n      const normalized = value.trim().toLowerCase();\n      return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';\n    }\n    return false;\n  }\n}\n"]}
+{"version":3,"file":"EdgeNodeAgentInitializer.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeAgentInitializer.ts"],"names":[],"mappings":"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","sourcesContent":["import { Initializer } from '@solid/community-server';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { EdgeNodeAgent, type EdgeNodeAgentOptions } from './EdgeNodeAgent';\n\n/**\n * 所有配置项设为可选，以便在 disabled 状态下即使缺少 CLI 变量也能成功实例化。\n */\nexport interface EdgeNodeAgentInitializerOptions {\n  enabled?: boolean | string;\n  signalEndpoint?: string;\n  nodeId?: string;\n  nodeToken?: string;\n  baseUrl?: string;\n  directCandidates?: string | string[];\n  pods?: string[];\n  includeSystemMetrics?: boolean;\n  enableNetworkDetection?: boolean;\n  metadata?: Record<string, unknown>;\n  intervalMs?: number | string;\n  p2pEnabled?: boolean | string;\n  p2pTargetBaseUrl?: string;\n  p2pLabel?: string;\n  p2pAcceptIntervalMs?: number | string;\n  p2pConnectTimeoutMs?: number | string;\n  p2pWinnerSelectionWindowMs?: number | string;\n}\n\n/**\n * Initializer that starts the EdgeNodeAgent.\n * Designed to be safe to configure even when disabled or missing dependent variables.\n */\nexport class EdgeNodeAgentInitializer extends Initializer {\n  protected readonly logger = getLoggerFor(this);\n  private readonly agent: EdgeNodeAgent;\n  private readonly options: EdgeNodeAgentInitializerOptions;\n  private readonly enabled: boolean;\n\n  public constructor(options: EdgeNodeAgentInitializerOptions) {\n    super();\n    this.options = options;\n    this.agent = new EdgeNodeAgent();\n    this.enabled = this.normalizeBoolean(options.enabled);\n  }\n\n  public override async handle(): Promise<void> {\n    if (!this.enabled) {\n      this.logger.debug('EdgeNodeAgent is disabled, skipping startup.');\n      return;\n    }\n\n    this.logger.info('Enabling EdgeNodeAgent...');\n    \n    // 运行时严格校验参数\n    this.validateOptions(this.options);\n\n    try {\n      await this.agent.start(this.buildAgentOptions(this.options));\n      this.logger.info(`EdgeNodeAgent started (Node: ${this.options.nodeId})`);\n    } catch (error: unknown) {\n      this.logger.error(`Failed to start EdgeNodeAgent: ${(error as Error).message}`);\n      throw error;\n    }\n  }\n\n  /**\n   * 确保启用时必需参数存在\n   */\n  private validateOptions(options: EdgeNodeAgentInitializerOptions): void {\n    const missing: string[] = [];\n    \n    if (!options.signalEndpoint) missing.push('signalEndpoint');\n    if (!options.nodeId) missing.push('nodeId');\n    if (!options.nodeToken) missing.push('nodeToken');\n    if (this.normalizeBoolean(options.p2pEnabled) && !options.p2pTargetBaseUrl) {\n      missing.push('p2pTargetBaseUrl');\n    }\n\n    if (missing.length > 0) {\n      throw new Error(`EdgeNodeAgent enabled but missing required configuration: ${missing.join(', ')}`);\n    }\n  }\n\n  private buildAgentOptions(options: EdgeNodeAgentInitializerOptions): EdgeNodeAgentOptions {\n    const p2pEnabled = this.normalizeBoolean(options.p2pEnabled);\n    return {\n      signalEndpoint: options.signalEndpoint!,\n      nodeId: options.nodeId!,\n      nodeToken: options.nodeToken!,\n      baseUrl: options.baseUrl,\n      directCandidates: options.directCandidates,\n      pods: options.pods,\n      includeSystemMetrics: options.includeSystemMetrics,\n      enableNetworkDetection: options.enableNetworkDetection,\n      metadata: options.metadata,\n      intervalMs: this.normalizePositiveInteger(options.intervalMs),\n      ...(p2pEnabled ? {\n        p2p: {\n          enabled: true,\n          targetBaseUrl: options.p2pTargetBaseUrl!,\n          label: options.p2pLabel,\n          acceptIntervalMs: this.normalizePositiveInteger(options.p2pAcceptIntervalMs),\n          connectTimeoutMs: this.normalizePositiveInteger(options.p2pConnectTimeoutMs),\n          winnerSelectionWindowMs: this.normalizeNonNegativeInteger(options.p2pWinnerSelectionWindowMs),\n        },\n      } : {}),\n    };\n  }\n\n  private normalizeBoolean(value: string | boolean | undefined): boolean {\n    if (typeof value === 'boolean') {\n      return value;\n    }\n    if (typeof value === 'string') {\n      const normalized = value.trim().toLowerCase();\n      return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';\n    }\n    return false;\n  }\n\n  private normalizePositiveInteger(value: number | string | undefined): number | undefined {\n    if (typeof value === 'number' && Number.isFinite(value) && value > 0) {\n      return value;\n    }\n    if (typeof value === 'string') {\n      const parsed = Number(value);\n      if (Number.isFinite(parsed) && parsed > 0) {\n        return parsed;\n      }\n    }\n    return undefined;\n  }\n\n  private normalizeNonNegativeInteger(value: number | string | undefined): number | undefined {\n    if (typeof value === 'number' && Number.isFinite(value) && value >= 0) {\n      return Math.floor(value);\n    }\n    if (typeof value === 'string') {\n      const parsed = Number(value);\n      if (Number.isFinite(parsed) && parsed >= 0) {\n        return Math.floor(parsed);\n      }\n    }\n    return undefined;\n  }\n}\n"]}

package/dist/edge/EdgeNodeAgentInitializer.jsonld

@@ -0,0 +1,409 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/community-server/^8.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer",
+      "@type": "Class",
+      "requireElement": "EdgeNodeAgentInitializer",
+      "extends": [
+        "css:dist/init/Initializer.jsonld#Initializer"
+      ],
+      "comment": "Initializer that starts the EdgeNodeAgent. Designed to be safe to configure even when disabled or missing dependent variables.",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_enabled",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_signalEndpoint",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_nodeId",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_nodeToken",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_baseUrl",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_directCandidates",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeArray",
+                "parameterRangeValue": "xsd:string"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_pods",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              {
+                "@type": "ParameterRangeArray",
+                "parameterRangeValue": "xsd:string"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_includeSystemMetrics",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_enableNetworkDetection",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_metadata",
+          "range": {
+            "@type": "ParameterRangeCollectEntries",
+            "parameterRangeCollectEntriesParameters": [
+              {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_metadata_key"
+              },
+              {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_metadata_value",
+                "range": {
+                  "@type": "ParameterRangeWildcard"
+                }
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_intervalMs",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:number",
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_p2pEnabled",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_p2pTargetBaseUrl",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_p2pLabel",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_p2pAcceptIntervalMs",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:number",
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_p2pConnectTimeoutMs",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:number",
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_p2pWinnerSelectionWindowMs",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:number",
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer__member_logger",
+          "memberFieldName": "logger",
+          "range": {
+            "@type": "ParameterRangeWildcard"
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer__member_agent",
+          "memberFieldName": "agent"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer__member_options",
+          "memberFieldName": "options"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer__member_enabled",
+          "memberFieldName": "enabled"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer__member_handle",
+          "memberFieldName": "handle"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer__member_validateOptions",
+          "memberFieldName": "validateOptions"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer__member_buildAgentOptions",
+          "memberFieldName": "buildAgentOptions"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer__member_normalizeBoolean",
+          "memberFieldName": "normalizeBoolean"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer__member_normalizePositiveInteger",
+          "memberFieldName": "normalizePositiveInteger"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer__member_normalizeNonNegativeInteger",
+          "memberFieldName": "normalizeNonNegativeInteger"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "enabled",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_enabled"
+              }
+            },
+            {
+              "keyRaw": "signalEndpoint",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_signalEndpoint"
+              }
+            },
+            {
+              "keyRaw": "nodeId",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_nodeId"
+              }
+            },
+            {
+              "keyRaw": "nodeToken",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_nodeToken"
+              }
+            },
+            {
+              "keyRaw": "baseUrl",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_baseUrl"
+              }
+            },
+            {
+              "keyRaw": "directCandidates",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_directCandidates"
+              }
+            },
+            {
+              "keyRaw": "pods",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_pods"
+              }
+            },
+            {
+              "keyRaw": "includeSystemMetrics",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_includeSystemMetrics"
+              }
+            },
+            {
+              "keyRaw": "enableNetworkDetection",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_enableNetworkDetection"
+              }
+            },
+            {
+              "keyRaw": "metadata",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_metadata__constructorArgument",
+                "fields": [
+                  {
+                    "collectEntries": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_metadata",
+                    "key": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_metadata_key",
+                    "value": {
+                      "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_metadata_value"
+                    }
+                  }
+                ]
+              }
+            },
+            {
+              "keyRaw": "intervalMs",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_intervalMs"
+              }
+            },
+            {
+              "keyRaw": "p2pEnabled",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_p2pEnabled"
+              }
+            },
+            {
+              "keyRaw": "p2pTargetBaseUrl",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_p2pTargetBaseUrl"
+              }
+            },
+            {
+              "keyRaw": "p2pLabel",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_p2pLabel"
+              }
+            },
+            {
+              "keyRaw": "p2pAcceptIntervalMs",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_p2pAcceptIntervalMs"
+              }
+            },
+            {
+              "keyRaw": "p2pConnectTimeoutMs",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_p2pConnectTimeoutMs"
+              }
+            },
+            {
+              "keyRaw": "p2pWinnerSelectionWindowMs",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeAgentInitializer.jsonld#EdgeNodeAgentInitializer_options_p2pWinnerSelectionWindowMs"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,7 @@
+import type { AccessRoute } from './types';
+export interface CanonicalFetchOptions {
+    route: AccessRoute;
+    fetchImpl?: typeof fetch;
+}
+export type CanonicalFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export declare function createCanonicalFetch(options: CanonicalFetchOptions): CanonicalFetch;

package/dist/edge/reachability/CanonicalFetch.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCanonicalFetch = createCanonicalFetch;
+function createCanonicalFetch(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const route = options.route;
+    const canonicalOrigin = new URL(route.canonicalUrl).origin;
+    const targetBase = new URL(route.targetUrl);
+    return async (input, init) => {
+        const request = input instanceof Request ? input : undefined;
+        const canonicalUrl = new URL(request?.url ?? input.toString());
+        if (canonicalUrl.origin !== canonicalOrigin) {
+            throw new Error(`Request ${canonicalUrl.toString()} is outside canonical origin ${canonicalOrigin}`);
+        }
+        const targetUrl = rewriteTargetUrl(targetBase, canonicalUrl);
+        const headers = new Headers(request?.headers ?? undefined);
+        const initHeaders = new Headers(init?.headers ?? undefined);
+        initHeaders.forEach((value, key) => headers.set(key, value));
+        headers.set('x-xpod-canonical-url', canonicalUrl.toString());
+        headers.set('x-xpod-canonical-origin', canonicalOrigin);
+        headers.set('x-xpod-canonical-host', canonicalUrl.host);
+        const nextInit = {
+            ...init,
+            method: init?.method ?? request?.method ?? 'GET',
+            headers,
+            body: init?.body ?? requestBody(request),
+            signal: init?.signal ?? request?.signal,
+        };
+        return fetchImpl(targetUrl, nextInit);
+    };
+}
+function rewriteTargetUrl(targetBase, canonicalUrl) {
+    const basePath = targetBase.pathname.endsWith('/')
+        ? targetBase.pathname.slice(0, -1)
+        : targetBase.pathname;
+    const targetPath = `${basePath}${canonicalUrl.pathname}`.replace(/\/+/gu, '/');
+    const target = new URL(targetBase.toString());
+    target.pathname = targetPath;
+    target.search = canonicalUrl.search;
+    target.hash = '';
+    return target.toString();
+}
+function requestBody(request) {
+    if (!request || request.method === 'GET' || request.method === 'HEAD') {
+        return undefined;
+    }
+    return request.body;
+}
+//# sourceMappingURL=CanonicalFetch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CanonicalFetch.js","sourceRoot":"","sources":["../../../src/edge/reachability/CanonicalFetch.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AccessRoute } from './types';\n\nexport interface CanonicalFetchOptions {\n  route: AccessRoute;\n  fetchImpl?: typeof fetch;\n}\n\nexport type CanonicalFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;\n\nexport function createCanonicalFetch(options: CanonicalFetchOptions): CanonicalFetch {\n  const fetchImpl = options.fetchImpl ?? fetch;\n  const route = options.route;\n  const canonicalOrigin = new URL(route.canonicalUrl).origin;\n  const targetBase = new URL(route.targetUrl);\n\n  return async (input: RequestInfo | URL, init?: RequestInit): Promise<Response> => {\n    const request = input instanceof Request ? input : undefined;\n    const canonicalUrl = new URL(request?.url ?? input.toString());\n    if (canonicalUrl.origin !== canonicalOrigin) {\n      throw new Error(`Request ${canonicalUrl.toString()} is outside canonical origin ${canonicalOrigin}`);\n    }\n\n    const targetUrl = rewriteTargetUrl(targetBase, canonicalUrl);\n    const headers = new Headers(request?.headers ?? undefined);\n    const initHeaders = new Headers(init?.headers ?? undefined);\n    initHeaders.forEach((value, key) => headers.set(key, value));\n    headers.set('x-xpod-canonical-url', canonicalUrl.toString());\n    headers.set('x-xpod-canonical-origin', canonicalOrigin);\n    headers.set('x-xpod-canonical-host', canonicalUrl.host);\n\n    const nextInit: RequestInit = {\n      ...init,\n      method: init?.method ?? request?.method ?? 'GET',\n      headers,\n      body: init?.body ?? requestBody(request),\n      signal: init?.signal ?? request?.signal,\n    };\n    return fetchImpl(targetUrl, nextInit);\n  };\n}\n\nfunction rewriteTargetUrl(targetBase: URL, canonicalUrl: URL): string {\n  const basePath = targetBase.pathname.endsWith('/')\n    ? targetBase.pathname.slice(0, -1)\n    : targetBase.pathname;\n  const targetPath = `${basePath}${canonicalUrl.pathname}`.replace(/\\/+/gu, '/');\n  const target = new URL(targetBase.toString());\n  target.pathname = targetPath;\n  target.search = canonicalUrl.search;\n  target.hash = '';\n  return target.toString();\n}\n\nfunction requestBody(request?: Request): BodyInit | null | undefined {\n  if (!request || request.method === 'GET' || request.method === 'HEAD') {\n    return undefined;\n  }\n  return request.body as unknown as BodyInit | null | undefined;\n}\n"]}

package/dist/edge/reachability/CanonicalFetch.jsonld

@@ -0,0 +1,25 @@
+{
+  "@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/CanonicalFetch.jsonld#CanonicalFetchOptions",
+      "@type": "AbstractClass",
+      "requireElement": "CanonicalFetchOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/reachability/CanonicalFetch.jsonld#CanonicalFetchOptions__member_route",
+          "memberFieldName": "route"
+        },
+        {
+          "@id": "undefineds:dist/edge/reachability/CanonicalFetch.jsonld#CanonicalFetchOptions__member_fetchImpl",
+          "memberFieldName": "fetchImpl"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

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

@@ -0,0 +1,26 @@
+import { type CanonicalFetch } from './CanonicalFetch';
+import { type ConnectSignaledRawTcpP2PTransportOptions } from './TcpP2PSignalingSession';
+import type { AccessRoute, RouteSet } from './types';
+type ManagedClientP2POptions = Omit<ConnectSignaledRawTcpP2PTransportOptions, 'signaling' | 'clientId'> & Pick<ConnectSignaledRawTcpP2PTransportOptions, 'signaling' | 'clientId'>;
+type SignaledManagedClientP2POptions = Omit<ManagedClientP2POptions, 'signaling' | 'clientId'>;
+export interface ManagedClientFetchOptions {
+    routeSet: RouteSet;
+    fetchImpl?: typeof fetch;
+    probe?: (route: AccessRoute, signal: AbortSignal) => Promise<boolean> | boolean;
+    probeTimeoutMs?: number;
+    p2p?: ManagedClientP2POptions;
+}
+export interface ManagedClientFetch {
+    route: AccessRoute;
+    fetch: CanonicalFetch;
+    close(): void;
+}
+export interface SignaledManagedClientFetchOptions extends Omit<ManagedClientFetchOptions, 'routeSet' | 'p2p'>, SignaledManagedClientP2POptions {
+    apiBaseUrl: string;
+    nodeId: string;
+    token?: string;
+    clientId: string;
+}
+export declare function createSignaledManagedClientFetch(options: SignaledManagedClientFetchOptions): Promise<ManagedClientFetch>;
+export declare function createManagedClientFetch(options: ManagedClientFetchOptions): Promise<ManagedClientFetch>;
+export {};