@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/service/EdgeNodeCertificateService.jsonld

@@ -0,0 +1,216 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService",
+      "@type": "Class",
+      "requireElement": "EdgeNodeCertificateService",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_identityDbUrl",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_repository",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "undefineds:dist/identity/drizzle/EdgeNodeRepository.jsonld#EdgeNodeRepository",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_provisioner",
+          "range": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_accountKeyPath",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_certificateStorePath",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_directoryUrl",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_email",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_propagationDelayMs",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:number",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_logger",
+          "memberFieldName": "logger"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_repository",
+          "memberFieldName": "repository"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_provisioner",
+          "memberFieldName": "provisioner"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_accountKeyPath",
+          "memberFieldName": "accountKeyPath"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_certificateStorePath",
+          "memberFieldName": "certificateStorePath"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_directoryUrl",
+          "memberFieldName": "directoryUrl"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_email",
+          "memberFieldName": "email"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_propagationDelayMs",
+          "memberFieldName": "propagationDelayMs"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_pending",
+          "memberFieldName": "pending"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_issueCertificate",
+          "memberFieldName": "issueCertificate"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_issueCertificateInternal",
+          "memberFieldName": "issueCertificateInternal"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_extractDomains",
+          "memberFieldName": "extractDomains"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_validateDomains",
+          "memberFieldName": "validateDomains"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_createClient",
+          "memberFieldName": "createClient"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_ensureAccount",
+          "memberFieldName": "ensureAccount"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_loadOrCreateAccountKey",
+          "memberFieldName": "loadOrCreateAccountKey"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_persistCertificate",
+          "memberFieldName": "persistCertificate"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_readExpiration",
+          "memberFieldName": "readExpiration"
+        },
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService__member_delay",
+          "memberFieldName": "delay"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "identityDbUrl",
+              "value": {
+                "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_identityDbUrl"
+              }
+            },
+            {
+              "keyRaw": "repository",
+              "value": {
+                "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_repository"
+              }
+            },
+            {
+              "keyRaw": "provisioner",
+              "value": {
+                "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_provisioner"
+              }
+            },
+            {
+              "keyRaw": "accountKeyPath",
+              "value": {
+                "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_accountKeyPath"
+              }
+            },
+            {
+              "keyRaw": "certificateStorePath",
+              "value": {
+                "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_certificateStorePath"
+              }
+            },
+            {
+              "keyRaw": "directoryUrl",
+              "value": {
+                "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_directoryUrl"
+              }
+            },
+            {
+              "keyRaw": "email",
+              "value": {
+                "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_email"
+              }
+            },
+            {
+              "keyRaw": "propagationDelayMs",
+              "value": {
+                "@id": "undefineds:dist/service/EdgeNodeCertificateService.jsonld#EdgeNodeCertificateService_options_propagationDelayMs"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/service/EdgeNodeHeartbeatService.d.ts

@@ -0,0 +1,68 @@
+export interface EdgeNodeHeartbeatServiceOptions {
+    edgeNodesEnabled?: string | boolean;
+    signalEndpoint?: string;
+    nodeId?: string;
+    nodeToken?: string;
+    baseUrl?: string;
+    publicAddress?: string;
+    ipv4?: string;
+    ipv6?: string;
+    pods?: string | string[];
+    capabilities?: string | string[];
+    reachability?: string;
+    directCandidates?: string | string[];
+    tunnel?: string;
+    certificate?: string;
+    metrics?: string;
+    metadata?: string;
+    intervalMs?: number | string;
+    onHeartbeatResponse?: (data: unknown) => void;
+    metadataSupplier?: () => Record<string, unknown> | undefined;
+    metricsSupplier?: () => Record<string, unknown> | undefined;
+    tunnelSupplier?: () => Record<string, unknown> | undefined;
+    networkSupplier?: () => Promise<{
+        ipv4?: string;
+        ipv6?: string;
+    }> | {
+        ipv4?: string;
+        ipv6?: string;
+    };
+}
+export declare class EdgeNodeHeartbeatService {
+    private readonly logger;
+    private readonly interval?;
+    private readonly endpoint?;
+    private readonly baseNodeId?;
+    private readonly baseToken?;
+    private readonly baseUrl?;
+    private readonly publicAddress?;
+    private readonly baseIpv4?;
+    private readonly baseIpv6?;
+    private readonly basePods?;
+    private readonly baseCapabilities?;
+    private readonly baseReachability?;
+    private readonly baseDirectCandidates?;
+    private readonly baseTunnel?;
+    private readonly baseCertificate?;
+    private readonly baseMetrics?;
+    private readonly baseMetadata?;
+    private readonly tunnelSupplier?;
+    private readonly metricsSupplier?;
+    private readonly metadataSupplier?;
+    private readonly networkSupplier?;
+    private readonly intervalMs;
+    private readonly onHeartbeatResponse?;
+    constructor(options: EdgeNodeHeartbeatServiceOptions);
+    dispose(): void;
+    private sendHeartbeat;
+    private buildPayload;
+    private handleHeartbeatResponse;
+    private mergeRecords;
+    private normalizeBoolean;
+    private normalizeString;
+    private normalizeInterval;
+    private normalizePods;
+    private normalizeStringArray;
+    private normalizeJsonRecord;
+    private normalizeCandidates;
+}

package/dist/service/EdgeNodeHeartbeatService.js

@@ -0,0 +1,262 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EdgeNodeHeartbeatService = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+class EdgeNodeHeartbeatService {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.intervalMs = 30_000;
+        const enabled = this.normalizeBoolean(options.edgeNodesEnabled);
+        const endpoint = this.normalizeString(options.signalEndpoint);
+        const nodeId = this.normalizeString(options.nodeId);
+        const nodeToken = this.normalizeString(options.nodeToken);
+        if (!enabled) {
+            this.logger.debug('Edge node heartbeat service disabled.');
+            return;
+        }
+        if (!endpoint || !nodeId || !nodeToken) {
+            this.logger.warn('Edge node heartbeat service missing configuration (signal endpoint, nodeId, nodeToken).');
+            return;
+        }
+        this.intervalMs = this.normalizeInterval(options.intervalMs) ?? this.intervalMs;
+        this.endpoint = endpoint;
+        this.onHeartbeatResponse = options.onHeartbeatResponse;
+        this.metadataSupplier = options.metadataSupplier;
+        this.metricsSupplier = options.metricsSupplier;
+        this.tunnelSupplier = options.tunnelSupplier;
+        this.networkSupplier = options.networkSupplier;
+        this.baseNodeId = nodeId;
+        this.baseToken = nodeToken;
+        this.baseUrl = this.normalizeString(options.baseUrl);
+        this.publicAddress = this.normalizeString(options.publicAddress);
+        this.baseIpv4 = this.normalizeString(options.ipv4);
+        this.baseIpv6 = this.normalizeString(options.ipv6);
+        this.basePods = this.normalizePods(options.pods);
+        this.baseCapabilities = this.normalizeStringArray(options.capabilities);
+        this.baseReachability = this.normalizeJsonRecord(options.reachability, 'reachability');
+        this.baseDirectCandidates = this.normalizeCandidates(options.directCandidates);
+        this.baseTunnel = this.normalizeJsonRecord(options.tunnel, 'tunnel');
+        this.baseCertificate = this.normalizeJsonRecord(options.certificate, 'certificate');
+        this.baseMetrics = this.normalizeJsonRecord(options.metrics, 'metrics');
+        this.baseMetadata = this.normalizeJsonRecord(options.metadata, 'metadata');
+        void this.sendHeartbeat();
+        if (this.intervalMs > 0) {
+            this.interval = setInterval(() => {
+                void this.sendHeartbeat();
+            }, this.intervalMs);
+        }
+    }
+    dispose() {
+        if (this.interval) {
+            clearInterval(this.interval);
+        }
+    }
+    async sendHeartbeat() {
+        if (!this.endpoint || !this.baseNodeId || !this.baseToken) {
+            return;
+        }
+        const payload = await this.buildPayload();
+        try {
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(payload),
+            });
+            if (!response.ok) {
+                this.logger.warn(`Edge node heartbeat failed: ${response.status} ${response.statusText}`);
+            }
+            else {
+                this.logger.debug('Edge node heartbeat sent successfully.');
+                await this.handleHeartbeatResponse(response);
+            }
+        }
+        catch (error) {
+            this.logger.error(`Edge node heartbeat error: ${error.message}`);
+        }
+    }
+    async buildPayload() {
+        const payload = {
+            nodeId: this.baseNodeId,
+            token: this.baseToken,
+        };
+        if (this.baseUrl) {
+            payload.baseUrl = this.baseUrl;
+        }
+        if (this.publicAddress) {
+            payload.publicAddress = this.publicAddress;
+        }
+        // 获取网络地址（支持动态检测）
+        let ipv4 = this.baseIpv4;
+        let ipv6 = this.baseIpv6;
+        if (this.networkSupplier) {
+            try {
+                const networkInfo = await Promise.resolve(this.networkSupplier());
+                ipv4 = networkInfo.ipv4 ?? ipv4;
+                ipv6 = networkInfo.ipv6 ?? ipv6;
+            }
+            catch (error) {
+                this.logger.debug(`Network detection failed: ${error.message}`);
+            }
+        }
+        if (ipv4) {
+            payload.ipv4 = ipv4;
+        }
+        if (ipv6) {
+            payload.ipv6 = ipv6;
+        }
+        if (this.basePods && this.basePods.length > 0) {
+            payload.pods = [...this.basePods];
+        }
+        if (this.baseCapabilities && this.baseCapabilities.length > 0) {
+            payload.capabilities = [...this.baseCapabilities];
+        }
+        const reachability = this.mergeRecords(this.baseReachability, undefined);
+        if (reachability && Object.keys(reachability).length > 0) {
+            payload.reachability = reachability;
+        }
+        const directCandidates = this.baseDirectCandidates;
+        if (directCandidates && directCandidates.length > 0) {
+            payload.directCandidates = [...directCandidates];
+        }
+        const tunnel = this.mergeRecords(this.baseTunnel, this.tunnelSupplier?.());
+        if (tunnel && Object.keys(tunnel).length > 0) {
+            payload.tunnel = tunnel;
+        }
+        const certificate = this.mergeRecords(this.baseCertificate, undefined);
+        if (certificate && Object.keys(certificate).length > 0) {
+            payload.certificate = certificate;
+        }
+        const metrics = this.mergeRecords(this.baseMetrics, this.metricsSupplier?.());
+        if (metrics && Object.keys(metrics).length > 0) {
+            payload.metrics = metrics;
+        }
+        const metadata = this.mergeRecords(this.baseMetadata, this.metadataSupplier?.());
+        if (metadata && Object.keys(metadata).length > 0) {
+            payload.metadata = metadata;
+        }
+        return payload;
+    }
+    async handleHeartbeatResponse(response) {
+        if (!this.onHeartbeatResponse) {
+            return;
+        }
+        const contentType = response.headers.get('content-type') ?? '';
+        if (!contentType.includes('application/json')) {
+            return;
+        }
+        try {
+            const data = await response.json();
+            this.onHeartbeatResponse(data);
+        }
+        catch (error) {
+            this.logger.warn(`解析心跳响应 JSON 失败: ${error.message}`);
+        }
+    }
+    mergeRecords(base, extra) {
+        if (!base && !extra) {
+            return undefined;
+        }
+        return { ...(base ?? {}), ...(extra ?? {}) };
+    }
+    normalizeBoolean(value) {
+        if (typeof value === 'boolean') {
+            return value;
+        }
+        if (typeof value === 'string') {
+            const normalized = value.trim().toLowerCase();
+            return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';
+        }
+        return false;
+    }
+    normalizeString(value) {
+        if (typeof value !== 'string') {
+            return undefined;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    normalizeInterval(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;
+    }
+    normalizePods(value) {
+        if (value === undefined) {
+            return undefined;
+        }
+        const source = Array.isArray(value) ? value : value.split(/[\n,]+/u);
+        const pods = source
+            .map((entry) => entry.trim())
+            .filter((entry) => entry.length > 0)
+            .map((entry) => {
+            try {
+                return new URL(entry).toString();
+            }
+            catch {
+                this.logger.warn(`忽略无效的 Pod 基址: ${entry}`);
+                return undefined;
+            }
+        })
+            .filter((entry) => typeof entry === 'string');
+        return pods.length > 0 ? pods : undefined;
+    }
+    normalizeStringArray(value) {
+        if (value === undefined) {
+            return undefined;
+        }
+        const source = Array.isArray(value) ? value : value.split(/[\n,]+/u);
+        const items = source
+            .map((entry) => entry.trim())
+            .filter((entry) => entry.length > 0);
+        return items.length > 0 ? Array.from(new Set(items)) : undefined;
+    }
+    normalizeJsonRecord(value, field) {
+        if (!value) {
+            return undefined;
+        }
+        try {
+            const parsed = JSON.parse(value);
+            if (parsed == null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+                this.logger.warn(`忽略 ${field}：需要 JSON 对象。`);
+                return undefined;
+            }
+            return parsed;
+        }
+        catch (error) {
+            this.logger.warn(`无法解析 ${field} JSON：${error.message}`);
+            return undefined;
+        }
+    }
+    normalizeCandidates(value) {
+        if (value === undefined) {
+            return undefined;
+        }
+        const source = Array.isArray(value) ? value : value.split(/[\n,]+/u);
+        const result = [];
+        for (const entry of source) {
+            const trimmed = entry.trim();
+            if (trimmed.length === 0) {
+                continue;
+            }
+            try {
+                const normalized = new URL(trimmed).toString();
+                if (!result.includes(normalized)) {
+                    result.push(normalized);
+                }
+            }
+            catch {
+                this.logger.warn(`忽略无效的候选地址: ${trimmed}`);
+            }
+        }
+        return result.length > 0 ? result : undefined;
+    }
+}
+exports.EdgeNodeHeartbeatService = EdgeNodeHeartbeatService;
+//# sourceMappingURL=EdgeNodeHeartbeatService.js.map

package/dist/service/EdgeNodeHeartbeatService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeNodeHeartbeatService.js","sourceRoot":"","sources":["../../src/service/EdgeNodeHeartbeatService.ts"],"names":[],"mappings":"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","sourcesContent":["import { getLoggerFor } from 'global-logger-factory';\n\nexport interface EdgeNodeHeartbeatServiceOptions {\n  edgeNodesEnabled?: string | boolean;\n  signalEndpoint?: string;\n  nodeId?: string;\n  nodeToken?: string;\n  baseUrl?: string;\n  publicAddress?: string;\n  ipv4?: string;\n  ipv6?: string;\n  pods?: string | string[];\n  capabilities?: string | string[];\n  reachability?: string;\n  directCandidates?: string | string[];\n  tunnel?: string;\n  certificate?: string;\n  metrics?: string;\n  metadata?: string;\n  intervalMs?: number | string;\n  onHeartbeatResponse?: (data: unknown) => void;\n  metadataSupplier?: () => Record<string, unknown> | undefined;\n  metricsSupplier?: () => Record<string, unknown> | undefined;\n  tunnelSupplier?: () => Record<string, unknown> | undefined;\n  networkSupplier?: () => Promise<{ ipv4?: string; ipv6?: string }> | { ipv4?: string; ipv6?: string };\n}\n\ntype HeartbeatPayload = {\n  nodeId: string;\n  token: string;\n  baseUrl?: string;\n  publicAddress?: string;\n  ipv4?: string;\n  ipv6?: string;\n  pods?: string[];\n  capabilities?: string[];\n  reachability?: Record<string, unknown>;\n  directCandidates?: string[];\n  tunnel?: Record<string, unknown>;\n  certificate?: Record<string, unknown>;\n  metrics?: Record<string, unknown>;\n  metadata?: Record<string, unknown>;\n};\n\nexport class EdgeNodeHeartbeatService {\n  private readonly logger = getLoggerFor(this);\n  private readonly interval?: NodeJS.Timeout;\n  private readonly endpoint?: string;\n  private readonly baseNodeId?: string;\n  private readonly baseToken?: string;\n  private readonly baseUrl?: string;\n  private readonly publicAddress?: string;\n  private readonly baseIpv4?: string;\n  private readonly baseIpv6?: string;\n  private readonly basePods?: string[];\n  private readonly baseCapabilities?: string[];\n  private readonly baseReachability?: Record<string, unknown>;\n  private readonly baseDirectCandidates?: string[];\n  private readonly baseTunnel?: Record<string, unknown>;\n  private readonly baseCertificate?: Record<string, unknown>;\n  private readonly baseMetrics?: Record<string, unknown>;\n  private readonly baseMetadata?: Record<string, unknown>;\n  private readonly tunnelSupplier?: () => Record<string, unknown> | undefined;\n  private readonly metricsSupplier?: () => Record<string, unknown> | undefined;\n  private readonly metadataSupplier?: () => Record<string, unknown> | undefined;\n  private readonly networkSupplier?: () => Promise<{ ipv4?: string; ipv6?: string }> | { ipv4?: string; ipv6?: string };\n  private readonly intervalMs: number = 30_000;\n  private readonly onHeartbeatResponse?: (data: unknown) => void;\n\n  public constructor(options: EdgeNodeHeartbeatServiceOptions) {\n    const enabled = this.normalizeBoolean(options.edgeNodesEnabled);\n    const endpoint = this.normalizeString(options.signalEndpoint);\n    const nodeId = this.normalizeString(options.nodeId);\n    const nodeToken = this.normalizeString(options.nodeToken);\n\n    if (!enabled) {\n      this.logger.debug('Edge node heartbeat service disabled.');\n      return;\n    }\n\n    if (!endpoint || !nodeId || !nodeToken) {\n      this.logger.warn('Edge node heartbeat service missing configuration (signal endpoint, nodeId, nodeToken).');\n      return;\n    }\n\n    this.intervalMs = this.normalizeInterval(options.intervalMs) ?? this.intervalMs;\n    this.endpoint = endpoint;\n    this.onHeartbeatResponse = options.onHeartbeatResponse;\n    this.metadataSupplier = options.metadataSupplier;\n    this.metricsSupplier = options.metricsSupplier;\n    this.tunnelSupplier = options.tunnelSupplier;\n    this.networkSupplier = options.networkSupplier;\n\n    this.baseNodeId = nodeId;\n    this.baseToken = nodeToken;\n    this.baseUrl = this.normalizeString(options.baseUrl);\n    this.publicAddress = this.normalizeString(options.publicAddress);\n    this.baseIpv4 = this.normalizeString(options.ipv4);\n    this.baseIpv6 = this.normalizeString(options.ipv6);\n    this.basePods = this.normalizePods(options.pods);\n    this.baseCapabilities = this.normalizeStringArray(options.capabilities);\n    this.baseReachability = this.normalizeJsonRecord(options.reachability, 'reachability');\n    this.baseDirectCandidates = this.normalizeCandidates(options.directCandidates);\n    this.baseTunnel = this.normalizeJsonRecord(options.tunnel, 'tunnel');\n    this.baseCertificate = this.normalizeJsonRecord(options.certificate, 'certificate');\n    this.baseMetrics = this.normalizeJsonRecord(options.metrics, 'metrics');\n    this.baseMetadata = this.normalizeJsonRecord(options.metadata, 'metadata');\n\n    void this.sendHeartbeat();\n    if (this.intervalMs > 0) {\n      this.interval = setInterval(() => {\n        void this.sendHeartbeat();\n      }, this.intervalMs);\n    }\n  }\n\n  public dispose(): void {\n    if (this.interval) {\n      clearInterval(this.interval);\n    }\n  }\n\n  private async sendHeartbeat(): Promise<void> {\n    if (!this.endpoint || !this.baseNodeId || !this.baseToken) {\n      return;\n    }\n\n    const payload: Record<string, unknown> = await this.buildPayload();\n\n    try {\n      const response = await fetch(this.endpoint, {\n        method: 'POST',\n        headers: { 'content-type': 'application/json' },\n        body: JSON.stringify(payload),\n      });\n      if (!response.ok) {\n        this.logger.warn(`Edge node heartbeat failed: ${response.status} ${response.statusText}`);\n      } else {\n        this.logger.debug('Edge node heartbeat sent successfully.');\n        await this.handleHeartbeatResponse(response);\n      }\n    } catch (error: unknown) {\n      this.logger.error(`Edge node heartbeat error: ${(error as Error).message}`);\n    }\n  }\n\n  private async buildPayload(): Promise<HeartbeatPayload> {\n    const payload: HeartbeatPayload = {\n      nodeId: this.baseNodeId!,\n      token: this.baseToken!,\n    };\n\n    if (this.baseUrl) {\n      payload.baseUrl = this.baseUrl;\n    }\n    if (this.publicAddress) {\n      payload.publicAddress = this.publicAddress;\n    }\n    \n    // 获取网络地址（支持动态检测）\n    let ipv4 = this.baseIpv4;\n    let ipv6 = this.baseIpv6;\n    if (this.networkSupplier) {\n      try {\n        const networkInfo = await Promise.resolve(this.networkSupplier());\n        ipv4 = networkInfo.ipv4 ?? ipv4;\n        ipv6 = networkInfo.ipv6 ?? ipv6;\n      } catch (error: unknown) {\n        this.logger.debug(`Network detection failed: ${(error as Error).message}`);\n      }\n    }\n    if (ipv4) {\n      payload.ipv4 = ipv4;\n    }\n    if (ipv6) {\n      payload.ipv6 = ipv6;\n    }\n    \n    if (this.basePods && this.basePods.length > 0) {\n      payload.pods = [ ...this.basePods ];\n    }\n    if (this.baseCapabilities && this.baseCapabilities.length > 0) {\n      payload.capabilities = [ ...this.baseCapabilities ];\n    }\n    const reachability = this.mergeRecords(this.baseReachability, undefined);\n    if (reachability && Object.keys(reachability).length > 0) {\n      payload.reachability = reachability;\n    }\n    const directCandidates = this.baseDirectCandidates;\n    if (directCandidates && directCandidates.length > 0) {\n      payload.directCandidates = [ ...directCandidates ];\n    }\n    const tunnel = this.mergeRecords(this.baseTunnel, this.tunnelSupplier?.());\n    if (tunnel && Object.keys(tunnel).length > 0) {\n      payload.tunnel = tunnel;\n    }\n    const certificate = this.mergeRecords(this.baseCertificate, undefined);\n    if (certificate && Object.keys(certificate).length > 0) {\n      payload.certificate = certificate;\n    }\n    const metrics = this.mergeRecords(this.baseMetrics, this.metricsSupplier?.());\n    if (metrics && Object.keys(metrics).length > 0) {\n      payload.metrics = metrics;\n    }\n    const metadata = this.mergeRecords(this.baseMetadata, this.metadataSupplier?.());\n    if (metadata && Object.keys(metadata).length > 0) {\n      payload.metadata = metadata;\n    }\n    return payload;\n  }\n\n  private async handleHeartbeatResponse(response: Response): Promise<void> {\n    if (!this.onHeartbeatResponse) {\n      return;\n    }\n    const contentType = response.headers.get('content-type') ?? '';\n    if (!contentType.includes('application/json')) {\n      return;\n    }\n    try {\n      const data = await response.json();\n      this.onHeartbeatResponse(data);\n    } catch (error: unknown) {\n      this.logger.warn(`解析心跳响应 JSON 失败: ${(error as Error).message}`);\n    }\n  }\n\n  private mergeRecords(base?: Record<string, unknown>, extra?: Record<string, unknown>): Record<string, unknown> | undefined {\n    if (!base && !extra) {\n      return undefined;\n    }\n    return { ...(base ?? {}), ...(extra ?? {}) };\n  }\n\n  private normalizeBoolean(value?: string | boolean): 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 normalizeString(value?: string): string | undefined {\n    if (typeof value !== 'string') {\n      return undefined;\n    }\n    const trimmed = value.trim();\n    return trimmed.length > 0 ? trimmed : undefined;\n  }\n\n  private normalizeInterval(value?: number | string): 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 normalizePods(value?: string | string[]): string[] | undefined {\n    if (value === undefined) {\n      return undefined;\n    }\n    const source = Array.isArray(value) ? value : value.split(/[\\n,]+/u);\n    const pods = source\n      .map((entry) => entry.trim())\n      .filter((entry) => entry.length > 0)\n      .map((entry) => {\n        try {\n          return new URL(entry).toString();\n        } catch {\n          this.logger.warn(`忽略无效的 Pod 基址: ${entry}`);\n          return undefined;\n        }\n      })\n      .filter((entry): entry is string => typeof entry === 'string');\n    return pods.length > 0 ? pods : undefined;\n  }\n\n  private normalizeStringArray(value?: string | string[]): string[] | undefined {\n    if (value === undefined) {\n      return undefined;\n    }\n    const source = Array.isArray(value) ? value : value.split(/[\\n,]+/u);\n    const items = source\n      .map((entry) => entry.trim())\n      .filter((entry) => entry.length > 0);\n    return items.length > 0 ? Array.from(new Set(items)) : undefined;\n  }\n\n  private normalizeJsonRecord(value: string | undefined, field: string): Record<string, unknown> | undefined {\n    if (!value) {\n      return undefined;\n    }\n    try {\n      const parsed = JSON.parse(value);\n      if (parsed == null || typeof parsed !== 'object' || Array.isArray(parsed)) {\n        this.logger.warn(`忽略 ${field}：需要 JSON 对象。`);\n        return undefined;\n      }\n      return parsed as Record<string, unknown>;\n    } catch (error: unknown) {\n      this.logger.warn(`无法解析 ${field} JSON：${(error as Error).message}`);\n      return undefined;\n    }\n  }\n\n  private normalizeCandidates(value?: string | string[]): string[] | undefined {\n    if (value === undefined) {\n      return undefined;\n    }\n    const source = Array.isArray(value) ? value : value.split(/[\\n,]+/u);\n    const result: string[] = [];\n    for (const entry of source) {\n      const trimmed = entry.trim();\n      if (trimmed.length === 0) {\n        continue;\n      }\n      try {\n        const normalized = new URL(trimmed).toString();\n        if (!result.includes(normalized)) {\n          result.push(normalized);\n        }\n      } catch {\n        this.logger.warn(`忽略无效的候选地址: ${trimmed}`);\n      }\n    }\n    return result.length > 0 ? result : undefined;\n  }\n}\n"]}

package/dist/service/PodMigrationService.d.ts

@@ -0,0 +1,43 @@
+export interface PodMigrationServiceConfig {
+    identityDbUrl: string;
+    currentNodeId: string;
+}
+export interface MigrationResult {
+    podId: string;
+    sourceNodeId: string;
+    targetNodeId: string;
+    migratedAt: Date;
+}
+/**
+ * Service for managing Pod migrations between Center nodes.
+ *
+ * Simplified migration process:
+ * 1. Validate pod and target node exist
+ * 2. Update nodeId to target node (atomic update)
+ *
+ * Data does NOT need to be copied upfront:
+ * - Metadata is in shared PostgreSQL (Quadstore), already accessible from all nodes
+ * - Binary files use cross-region fallback read (TieredMinioDataAccessor)
+ * - Files are lazily copied on first access if configured
+ *
+ * This provides instant, user-transparent migration.
+ */
+export declare class PodMigrationService {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly podLookupRepository;
+    private readonly edgeNodeRepository;
+    private readonly currentNodeId;
+    constructor(config: PodMigrationServiceConfig);
+    /**
+     * Migrate a pod to a different node.
+     *
+     * This is instant - only updates the nodeId in database.
+     * Subsequent requests will be routed to the new node.
+     * Binary files are read via cross-region fallback if not present locally.
+     */
+    migratePod(podId: string, targetNodeId: string): Promise<MigrationResult>;
+    /**
+     * Get which node a pod is currently on.
+     */
+    getPodNode(podId: string): Promise<string | null>;
+}