@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/ice/IceServerProvider.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * TURN 凭证提供器
+ *
+ * 生成带时间限制的 TURN 服务器凭证
+ * 支持 coturn 的 static-auth-secret 模式
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ICE_SERVERS = exports.IceServerProvider = void 0;
+const node_crypto_1 = require("node:crypto");
+/**
+ * ICE 服务器配置提供器
+ *
+ * 功能：
+ * - 管理 STUN/TURN 服务器配置
+ * - 为 TURN 服务器生成时间限制的凭证
+ */
+class IceServerProvider {
+    constructor(options = {}) {
+        this.stunServers = options.stunServers ?? [];
+        this.turnServers = options.turnServers ?? [];
+        this.credentialTTL = options.credentialTTL ?? 86400; // 默认 24 小时
+    }
+    /**
+     * 获取 ICE 服务器配置
+     *
+     * @param userId 可选的用户标识，用于生成唯一用户名
+     */
+    getIceServers(userId) {
+        const servers = [];
+        // 添加 STUN 服务器
+        for (const stun of this.stunServers) {
+            servers.push({ urls: stun.urls });
+        }
+        // 添加 TURN 服务器
+        for (const turn of this.turnServers) {
+            servers.push(this.createTurnCredential(turn, userId));
+        }
+        return servers;
+    }
+    /**
+     * 创建 TURN 服务器凭证
+     */
+    createTurnCredential(config, userId) {
+        // 如果有共享密钥，生成临时凭证
+        if (config.sharedSecret) {
+            return this.generateTempCredential(config.urls, config.sharedSecret, userId);
+        }
+        // 使用静态凭证
+        return {
+            urls: config.urls,
+            username: config.username,
+            credential: config.credential,
+        };
+    }
+    /**
+     * 生成临时凭证（coturn static-auth-secret 模式）
+     *
+     * 凭证格式：
+     * - username: timestamp:userId
+     * - credential: HMAC-SHA1(sharedSecret, username)
+     */
+    generateTempCredential(urls, sharedSecret, userId) {
+        const timestamp = Math.floor(Date.now() / 1000) + this.credentialTTL;
+        const username = `${timestamp}:${userId ?? 'anonymous'}`;
+        // 使用 HMAC-SHA1 生成凭证
+        const hmac = (0, node_crypto_1.createHmac)('sha1', sharedSecret);
+        hmac.update(username);
+        const credential = hmac.digest('base64');
+        return {
+            urls,
+            username,
+            credential,
+        };
+    }
+    /**
+     * 从环境变量创建 IceServerProvider
+     *
+     * 环境变量：
+     * - STUN_SERVERS: 逗号分隔的 STUN 服务器 URL
+     * - TURN_SERVERS: 逗号分隔的 TURN 服务器 URL
+     * - TURN_SECRET: TURN 共享密钥
+     * - TURN_USERNAME: TURN 静态用户名
+     * - TURN_CREDENTIAL: TURN 静态密码
+     * - TURN_CREDENTIAL_TTL: 凭证有效期（秒）
+     */
+    static fromEnv() {
+        const stunUrls = process.env.STUN_SERVERS?.split(',').filter(Boolean) ?? [];
+        const turnUrls = process.env.TURN_SERVERS?.split(',').filter(Boolean) ?? [];
+        const turnSecret = process.env.TURN_SECRET;
+        const turnUsername = process.env.TURN_USERNAME;
+        const turnCredential = process.env.TURN_CREDENTIAL;
+        const credentialTTL = process.env.TURN_CREDENTIAL_TTL
+            ? parseInt(process.env.TURN_CREDENTIAL_TTL, 10)
+            : undefined;
+        const stunServers = stunUrls.map((url) => ({ urls: url }));
+        const turnServers = turnUrls.map((url) => ({
+            urls: url,
+            sharedSecret: turnSecret,
+            username: turnUsername,
+            credential: turnCredential,
+        }));
+        // 如果没有配置，使用默认的公共 STUN 服务器
+        if (stunServers.length === 0 && turnServers.length === 0) {
+            stunServers.push({ urls: 'stun:stun.l.google.com:19302' }, { urls: 'stun:stun1.l.google.com:19302' });
+        }
+        return new IceServerProvider({
+            stunServers,
+            turnServers,
+            credentialTTL,
+        });
+    }
+}
+exports.IceServerProvider = IceServerProvider;
+/**
+ * 默认的 ICE 服务器配置（公共 STUN 服务器）
+ */
+exports.DEFAULT_ICE_SERVERS = [
+    { urls: 'stun:stun.l.google.com:19302' },
+    { urls: 'stun:stun1.l.google.com:19302' },
+];
+//# sourceMappingURL=IceServerProvider.js.map

package/dist/ice/IceServerProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IceServerProvider.js","sourceRoot":"","sources":["../../src/ice/IceServerProvider.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * TURN 凭证提供器\n *\n * 生成带时间限制的 TURN 服务器凭证\n * 支持 coturn 的 static-auth-secret 模式\n */\n\nimport { createHmac } from 'node:crypto';\nimport type { RTCIceServer } from '../signaling/types';\n\n/**\n * TURN 服务器配置\n */\nexport interface TurnServerConfig {\n  /** TURN 服务器 URL，如 turn:turn.example.com:3478 */\n  urls: string | string[];\n  /** 共享密钥（用于生成临时凭证） */\n  sharedSecret?: string;\n  /** 静态用户名（不使用共享密钥时） */\n  username?: string;\n  /** 静态密码（不使用共享密钥时） */\n  credential?: string;\n}\n\n/**\n * STUN 服务器配置\n */\nexport interface StunServerConfig {\n  /** STUN 服务器 URL，如 stun:stun.example.com:3478 */\n  urls: string | string[];\n}\n\n/**\n * ICE 服务器配置选项\n */\nexport interface IceServerOptions {\n  /** STUN 服务器列表 */\n  stunServers?: StunServerConfig[];\n  /** TURN 服务器列表 */\n  turnServers?: TurnServerConfig[];\n  /** 凭证有效期（秒） */\n  credentialTTL?: number;\n}\n\n/**\n * ICE 服务器配置提供器\n *\n * 功能：\n * - 管理 STUN/TURN 服务器配置\n * - 为 TURN 服务器生成时间限制的凭证\n */\nexport class IceServerProvider {\n  private readonly stunServers: StunServerConfig[];\n  private readonly turnServers: TurnServerConfig[];\n  private readonly credentialTTL: number;\n\n  public constructor(options: IceServerOptions = {}) {\n    this.stunServers = options.stunServers ?? [];\n    this.turnServers = options.turnServers ?? [];\n    this.credentialTTL = options.credentialTTL ?? 86400; // 默认 24 小时\n  }\n\n  /**\n   * 获取 ICE 服务器配置\n   *\n   * @param userId 可选的用户标识，用于生成唯一用户名\n   */\n  public getIceServers(userId?: string): RTCIceServer[] {\n    const servers: RTCIceServer[] = [];\n\n    // 添加 STUN 服务器\n    for (const stun of this.stunServers) {\n      servers.push({ urls: stun.urls });\n    }\n\n    // 添加 TURN 服务器\n    for (const turn of this.turnServers) {\n      servers.push(this.createTurnCredential(turn, userId));\n    }\n\n    return servers;\n  }\n\n  /**\n   * 创建 TURN 服务器凭证\n   */\n  private createTurnCredential(config: TurnServerConfig, userId?: string): RTCIceServer {\n    // 如果有共享密钥，生成临时凭证\n    if (config.sharedSecret) {\n      return this.generateTempCredential(config.urls, config.sharedSecret, userId);\n    }\n\n    // 使用静态凭证\n    return {\n      urls: config.urls,\n      username: config.username,\n      credential: config.credential,\n    };\n  }\n\n  /**\n   * 生成临时凭证（coturn static-auth-secret 模式）\n   *\n   * 凭证格式：\n   * - username: timestamp:userId\n   * - credential: HMAC-SHA1(sharedSecret, username)\n   */\n  private generateTempCredential(\n    urls: string | string[],\n    sharedSecret: string,\n    userId?: string,\n  ): RTCIceServer {\n    const timestamp = Math.floor(Date.now() / 1000) + this.credentialTTL;\n    const username = `${timestamp}:${userId ?? 'anonymous'}`;\n\n    // 使用 HMAC-SHA1 生成凭证\n    const hmac = createHmac('sha1', sharedSecret);\n    hmac.update(username);\n    const credential = hmac.digest('base64');\n\n    return {\n      urls,\n      username,\n      credential,\n    };\n  }\n\n  /**\n   * 从环境变量创建 IceServerProvider\n   *\n   * 环境变量：\n   * - STUN_SERVERS: 逗号分隔的 STUN 服务器 URL\n   * - TURN_SERVERS: 逗号分隔的 TURN 服务器 URL\n   * - TURN_SECRET: TURN 共享密钥\n   * - TURN_USERNAME: TURN 静态用户名\n   * - TURN_CREDENTIAL: TURN 静态密码\n   * - TURN_CREDENTIAL_TTL: 凭证有效期（秒）\n   */\n  public static fromEnv(): IceServerProvider {\n    const stunUrls = process.env.STUN_SERVERS?.split(',').filter(Boolean) ?? [];\n    const turnUrls = process.env.TURN_SERVERS?.split(',').filter(Boolean) ?? [];\n    const turnSecret = process.env.TURN_SECRET;\n    const turnUsername = process.env.TURN_USERNAME;\n    const turnCredential = process.env.TURN_CREDENTIAL;\n    const credentialTTL = process.env.TURN_CREDENTIAL_TTL\n      ? parseInt(process.env.TURN_CREDENTIAL_TTL, 10)\n      : undefined;\n\n    const stunServers: StunServerConfig[] = stunUrls.map((url) => ({ urls: url }));\n\n    const turnServers: TurnServerConfig[] = turnUrls.map((url) => ({\n      urls: url,\n      sharedSecret: turnSecret,\n      username: turnUsername,\n      credential: turnCredential,\n    }));\n\n    // 如果没有配置，使用默认的公共 STUN 服务器\n    if (stunServers.length === 0 && turnServers.length === 0) {\n      stunServers.push(\n        { urls: 'stun:stun.l.google.com:19302' },\n        { urls: 'stun:stun1.l.google.com:19302' },\n      );\n    }\n\n    return new IceServerProvider({\n      stunServers,\n      turnServers,\n      credentialTTL,\n    });\n  }\n}\n\n/**\n * 默认的 ICE 服务器配置（公共 STUN 服务器）\n */\nexport const DEFAULT_ICE_SERVERS: RTCIceServer[] = [\n  { urls: 'stun:stun.l.google.com:19302' },\n  { urls: 'stun:stun1.l.google.com:19302' },\n];\n"]}

package/dist/ice/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ICE 服务器配置模块
+ *
+ * 提供：
+ * - IceServerProvider: STUN/TURN 服务器配置提供器
+ * - 临时凭证生成（coturn 兼容）
+ */
+export * from './IceServerProvider';

package/dist/ice/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * ICE 服务器配置模块
+ *
+ * 提供：
+ * - IceServerProvider: STUN/TURN 服务器配置提供器
+ * - 临时凭证生成（coturn 兼容）
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./IceServerProvider"), exports);
+//# sourceMappingURL=index.js.map

package/dist/ice/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ice/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;AAEH,sDAAoC","sourcesContent":["/**\n * ICE 服务器配置模块\n *\n * 提供：\n * - IceServerProvider: STUN/TURN 服务器配置提供器\n * - 临时凭证生成（coturn 兼容）\n */\n\nexport * from './IceServerProvider';\n"]}

package/dist/identity/CenterNodeRegistrationService.d.ts

@@ -0,0 +1,102 @@
+import { Initializer } from '@solid/community-server';
+/**
+ * Configuration for the Center node registration service.
+ */
+export interface CenterNodeRegistrationConfig {
+    /** Database connection URL */
+    identityDbUrl: string;
+    /** Server port (from CSS --port parameter) */
+    port?: number | string;
+    /** Root file path (from CSS --rootFilePath parameter, for node ID persistence) */
+    rootFilePath?: string;
+    /** Unique identifier for this node. Auto-generated if not provided. */
+    nodeId?: string;
+    /** Display name for this node */
+    displayName?: string;
+    /** Heartbeat interval in milliseconds (default: 30000) */
+    heartbeatInterval?: number;
+    /** Whether the service is enabled (default: true) */
+    enabled?: boolean | string;
+}
+/**
+ * Service that registers this Center node with the cluster on startup.
+ *
+ * This allows multiple Center nodes to discover each other and route
+ * requests to the correct node based on Pod location.
+ *
+ * The service:
+ * 1. Auto-detects internal IP and port
+ * 2. Generates or loads a persistent node ID
+ * 3. Registers with the shared database on startup
+ * 4. Sends periodic heartbeats to indicate liveness
+ */
+export declare class CenterNodeRegistrationService extends Initializer {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly edgeNodeRepository;
+    private readonly nodeId;
+    private readonly displayName?;
+    private readonly internalIp;
+    private readonly internalPort;
+    private readonly heartbeatInterval;
+    private readonly nodeIdPath;
+    private readonly enabled;
+    private heartbeatTimer?;
+    private token?;
+    constructor(config: CenterNodeRegistrationConfig);
+    /**
+     * Get the current node's ID.
+     */
+    getNodeId(): string;
+    /**
+     * Get the current node's internal endpoint.
+     */
+    getInternalEndpoint(): {
+        ip: string;
+        port: number;
+    };
+    /**
+     * Initialize the service: register with the cluster and start heartbeat.
+     */
+    handle(): Promise<void>;
+    /**
+     * Auto-detect internal IP address.
+     * Priority:
+     * 1. K8s POD_IP environment variable
+     * 2. First non-localhost IPv4 address from network interfaces
+     */
+    private detectInternalIp;
+    /**
+     * Normalize port from string/number.
+     */
+    private normalizePort;
+    /**
+     * Load node ID from persistent storage, or generate a new one.
+     */
+    private loadOrGenerateNodeId;
+    /**
+     * Start periodic heartbeat to indicate liveness.
+     */
+    private startHeartbeat;
+    /**
+     * Stop the heartbeat timer (for graceful shutdown).
+     */
+    stopHeartbeat(): void;
+    /**
+     * List all center nodes in the cluster (for discovery).
+     */
+    listClusterNodes(): Promise<Array<{
+        nodeId: string;
+        internalIp: string;
+        internalPort: number;
+        isLocal: boolean;
+        reachable: boolean;
+    }>>;
+    /**
+     * Get the internal URL for a specific node.
+     */
+    getNodeInternalUrl(nodeId: string): Promise<string | undefined>;
+    /**
+     * Normalize boolean values from string/boolean.
+     */
+    private normalizeBoolean;
+}

package/dist/identity/CenterNodeRegistrationService.js

@@ -0,0 +1,266 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CenterNodeRegistrationService = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+const community_server_1 = require("@solid/community-server");
+const EdgeNodeRepository_1 = require("./drizzle/EdgeNodeRepository");
+const db_1 = require("./drizzle/db");
+const node_crypto_1 = require("node:crypto");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+/**
+ * Service that registers this Center node with the cluster on startup.
+ *
+ * This allows multiple Center nodes to discover each other and route
+ * requests to the correct node based on Pod location.
+ *
+ * The service:
+ * 1. Auto-detects internal IP and port
+ * 2. Generates or loads a persistent node ID
+ * 3. Registers with the shared database on startup
+ * 4. Sends periodic heartbeats to indicate liveness
+ */
+class CenterNodeRegistrationService extends community_server_1.Initializer {
+    constructor(config) {
+        super();
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        // Check if enabled
+        this.enabled = this.normalizeBoolean(config.enabled, true);
+        // Auto-detect internal IP and port
+        this.internalIp = this.detectInternalIp();
+        this.internalPort = this.normalizePort(config.port);
+        this.displayName = config.displayName;
+        this.heartbeatInterval = config.heartbeatInterval ?? 30_000;
+        // Auto-generate nodeIdPath from rootFilePath
+        this.nodeIdPath = config.rootFilePath ? path.join(config.rootFilePath, '.node-id') : undefined;
+        // Create repository from database URL
+        const db = (0, db_1.getIdentityDatabase)(config.identityDbUrl);
+        this.edgeNodeRepository = new EdgeNodeRepository_1.EdgeNodeRepository(db);
+        // Load or generate node ID
+        this.nodeId = this.loadOrGenerateNodeId(config.nodeId);
+    }
+    /**
+     * Get the current node's ID.
+     */
+    getNodeId() {
+        return this.nodeId;
+    }
+    /**
+     * Get the current node's internal endpoint.
+     */
+    getInternalEndpoint() {
+        return { ip: this.internalIp, port: this.internalPort };
+    }
+    /**
+     * Initialize the service: register with the cluster and start heartbeat.
+     */
+    async handle() {
+        if (!this.enabled) {
+            this.logger.info('Center node registration disabled');
+            return;
+        }
+        if (!this.internalIp) {
+            this.logger.warn('Center node registration skipped: could not detect internal IP');
+            return;
+        }
+        if (!this.internalPort) {
+            this.logger.warn('Center node registration skipped: port not configured');
+            return;
+        }
+        this.logger.info(`Registering center node: ${this.nodeId}`);
+        this.logger.info(`Internal endpoint: ${this.internalIp}:${this.internalPort}`);
+        try {
+            // Register this node with the cluster
+            const result = await this.edgeNodeRepository.registerCenterNode({
+                nodeId: this.nodeId,
+                displayName: this.displayName,
+                internalIp: this.internalIp,
+                internalPort: this.internalPort,
+            });
+            this.token = result.token;
+            this.logger.info(`Center node registered successfully: ${this.nodeId}`);
+            // Start periodic heartbeat
+            this.startHeartbeat();
+        }
+        catch (error) {
+            this.logger.error(`Failed to register center node: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Auto-detect internal IP address.
+     * Priority:
+     * 1. K8s POD_IP environment variable
+     * 2. First non-localhost IPv4 address from network interfaces
+     */
+    detectInternalIp() {
+        // K8s environment
+        const podIp = process.env.POD_IP;
+        if (podIp) {
+            this.logger.debug(`Using POD_IP: ${podIp}`);
+            return podIp;
+        }
+        // Detect from network interfaces
+        const interfaces = os.networkInterfaces();
+        for (const name of Object.keys(interfaces)) {
+            const netInterface = interfaces[name];
+            if (!netInterface)
+                continue;
+            for (const addr of netInterface) {
+                // Skip internal (localhost) and non-IPv4
+                if (addr.internal || addr.family !== 'IPv4') {
+                    continue;
+                }
+                this.logger.debug(`Detected internal IP from ${name}: ${addr.address}`);
+                return addr.address;
+            }
+        }
+        this.logger.warn('Could not detect internal IP address');
+        return '';
+    }
+    /**
+     * Normalize port from string/number.
+     */
+    normalizePort(port) {
+        if (typeof port === 'number') {
+            return port;
+        }
+        if (typeof port === 'string') {
+            const parsed = parseInt(port, 10);
+            return isNaN(parsed) ? 0 : parsed;
+        }
+        return 0;
+    }
+    /**
+     * Load node ID from persistent storage, or generate a new one.
+     */
+    loadOrGenerateNodeId(configNodeId) {
+        // Use config value if provided
+        if (configNodeId) {
+            return configNodeId;
+        }
+        // Try to load from file
+        if (this.nodeIdPath) {
+            try {
+                if (fs.existsSync(this.nodeIdPath)) {
+                    const content = fs.readFileSync(this.nodeIdPath, 'utf-8').trim();
+                    if (content) {
+                        this.logger.debug(`Loaded node ID from ${this.nodeIdPath}: ${content}`);
+                        return content;
+                    }
+                }
+            }
+            catch (error) {
+                this.logger.warn(`Failed to load node ID from ${this.nodeIdPath}: ${error.message}`);
+            }
+        }
+        // Generate new node ID
+        const newNodeId = `center-${(0, node_crypto_1.randomUUID)()}`;
+        // Persist to file if path is configured
+        if (this.nodeIdPath) {
+            try {
+                const dir = path.dirname(this.nodeIdPath);
+                if (!fs.existsSync(dir)) {
+                    fs.mkdirSync(dir, { recursive: true });
+                }
+                fs.writeFileSync(this.nodeIdPath, newNodeId, 'utf-8');
+                this.logger.info(`Generated and saved new node ID: ${newNodeId}`);
+            }
+            catch (error) {
+                this.logger.warn(`Failed to persist node ID to ${this.nodeIdPath}: ${error.message}`);
+            }
+        }
+        return newNodeId;
+    }
+    /**
+     * Start periodic heartbeat to indicate liveness.
+     */
+    startHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+        }
+        this.heartbeatTimer = setInterval(async () => {
+            try {
+                await this.edgeNodeRepository.updateCenterNodeHeartbeat(this.nodeId, this.internalIp, this.internalPort, new Date());
+                this.logger.debug(`Heartbeat sent for node: ${this.nodeId}`);
+            }
+            catch (error) {
+                this.logger.warn(`Failed to send heartbeat: ${error.message}`);
+            }
+        }, this.heartbeatInterval);
+        // Don't block process exit
+        this.heartbeatTimer.unref();
+    }
+    /**
+     * Stop the heartbeat timer (for graceful shutdown).
+     */
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+            this.logger.info(`Heartbeat stopped for node: ${this.nodeId}`);
+        }
+    }
+    /**
+     * List all center nodes in the cluster (for discovery).
+     */
+    async listClusterNodes() {
+        const nodes = await this.edgeNodeRepository.listCenterNodes();
+        return nodes.map(node => ({
+            nodeId: node.nodeId,
+            internalIp: node.internalIp,
+            internalPort: node.internalPort,
+            isLocal: node.nodeId === this.nodeId,
+            reachable: node.connectivityStatus === 'reachable',
+        }));
+    }
+    /**
+     * Get the internal URL for a specific node.
+     */
+    async getNodeInternalUrl(nodeId) {
+        const node = await this.edgeNodeRepository.getCenterNode(nodeId);
+        if (!node || !node.internalIp || !node.internalPort) {
+            return undefined;
+        }
+        return `http://${node.internalIp}:${node.internalPort}`;
+    }
+    /**
+     * Normalize boolean values from string/boolean.
+     */
+    normalizeBoolean(value, defaultValue) {
+        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 defaultValue;
+    }
+}
+exports.CenterNodeRegistrationService = CenterNodeRegistrationService;
+//# sourceMappingURL=CenterNodeRegistrationService.js.map

package/dist/identity/CenterNodeRegistrationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CenterNodeRegistrationService.js","sourceRoot":"","sources":["../../src/identity/CenterNodeRegistrationService.ts"],"names":[],"mappings":"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","sourcesContent":["import { getLoggerFor } from 'global-logger-factory';\nimport { Initializer } from '@solid/community-server';\nimport { EdgeNodeRepository } from './drizzle/EdgeNodeRepository';\nimport { getIdentityDatabase } from './drizzle/db';\nimport { randomUUID } from 'node:crypto';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport * as os from 'node:os';\n\n/**\n * Configuration for the Center node registration service.\n */\nexport interface CenterNodeRegistrationConfig {\n  /** Database connection URL */\n  identityDbUrl: string;\n  /** Server port (from CSS --port parameter) */\n  port?: number | string;\n  /** Root file path (from CSS --rootFilePath parameter, for node ID persistence) */\n  rootFilePath?: string;\n  /** Unique identifier for this node. Auto-generated if not provided. */\n  nodeId?: string;\n  /** Display name for this node */\n  displayName?: string;\n  /** Heartbeat interval in milliseconds (default: 30000) */\n  heartbeatInterval?: number;\n  /** Whether the service is enabled (default: true) */\n  enabled?: boolean | string;\n}\n\n/**\n * Service that registers this Center node with the cluster on startup.\n * \n * This allows multiple Center nodes to discover each other and route\n * requests to the correct node based on Pod location.\n * \n * The service:\n * 1. Auto-detects internal IP and port\n * 2. Generates or loads a persistent node ID\n * 3. Registers with the shared database on startup\n * 4. Sends periodic heartbeats to indicate liveness\n */\nexport class CenterNodeRegistrationService extends Initializer {\n  protected readonly logger = getLoggerFor(this);\n\n  private readonly edgeNodeRepository: EdgeNodeRepository;\n  private readonly nodeId: string;\n  private readonly displayName?: string;\n  private readonly internalIp: string;\n  private readonly internalPort: number;\n  private readonly heartbeatInterval: number;\n  private readonly nodeIdPath: string | undefined;\n  private readonly enabled: boolean;\n\n  private heartbeatTimer?: NodeJS.Timeout;\n  private token?: string;\n\n  public constructor(config: CenterNodeRegistrationConfig) {\n    super();\n\n    // Check if enabled\n    this.enabled = this.normalizeBoolean(config.enabled, true);\n    \n    // Auto-detect internal IP and port\n    this.internalIp = this.detectInternalIp();\n    this.internalPort = this.normalizePort(config.port);\n    this.displayName = config.displayName;\n    this.heartbeatInterval = config.heartbeatInterval ?? 30_000;\n    \n    // Auto-generate nodeIdPath from rootFilePath\n    this.nodeIdPath = config.rootFilePath ? path.join(config.rootFilePath, '.node-id') : undefined;\n\n    // Create repository from database URL\n    const db = getIdentityDatabase(config.identityDbUrl);\n    this.edgeNodeRepository = new EdgeNodeRepository(db);\n\n    // Load or generate node ID\n    this.nodeId = this.loadOrGenerateNodeId(config.nodeId);\n  }\n\n  /**\n   * Get the current node's ID.\n   */\n  public getNodeId(): string {\n    return this.nodeId;\n  }\n\n  /**\n   * Get the current node's internal endpoint.\n   */\n  public getInternalEndpoint(): { ip: string; port: number } {\n    return { ip: this.internalIp, port: this.internalPort };\n  }\n\n  /**\n   * Initialize the service: register with the cluster and start heartbeat.\n   */\n  public async handle(): Promise<void> {\n    if (!this.enabled) {\n      this.logger.info('Center node registration disabled');\n      return;\n    }\n\n    if (!this.internalIp) {\n      this.logger.warn('Center node registration skipped: could not detect internal IP');\n      return;\n    }\n\n    if (!this.internalPort) {\n      this.logger.warn('Center node registration skipped: port not configured');\n      return;\n    }\n\n    this.logger.info(`Registering center node: ${this.nodeId}`);\n    this.logger.info(`Internal endpoint: ${this.internalIp}:${this.internalPort}`);\n\n    try {\n      // Register this node with the cluster\n      const result = await this.edgeNodeRepository.registerCenterNode({\n        nodeId: this.nodeId,\n        displayName: this.displayName,\n        internalIp: this.internalIp,\n        internalPort: this.internalPort,\n      });\n\n      this.token = result.token;\n      this.logger.info(`Center node registered successfully: ${this.nodeId}`);\n\n      // Start periodic heartbeat\n      this.startHeartbeat();\n    } catch (error: unknown) {\n      this.logger.error(`Failed to register center node: ${(error as Error).message}`);\n      throw error;\n    }\n  }\n\n  /**\n   * Auto-detect internal IP address.\n   * Priority:\n   * 1. K8s POD_IP environment variable\n   * 2. First non-localhost IPv4 address from network interfaces\n   */\n  private detectInternalIp(): string {\n    // K8s environment\n    const podIp = process.env.POD_IP;\n    if (podIp) {\n      this.logger.debug(`Using POD_IP: ${podIp}`);\n      return podIp;\n    }\n\n    // Detect from network interfaces\n    const interfaces = os.networkInterfaces();\n    for (const name of Object.keys(interfaces)) {\n      const netInterface = interfaces[name];\n      if (!netInterface) continue;\n\n      for (const addr of netInterface) {\n        // Skip internal (localhost) and non-IPv4\n        if (addr.internal || addr.family !== 'IPv4') {\n          continue;\n        }\n        this.logger.debug(`Detected internal IP from ${name}: ${addr.address}`);\n        return addr.address;\n      }\n    }\n\n    this.logger.warn('Could not detect internal IP address');\n    return '';\n  }\n\n  /**\n   * Normalize port from string/number.\n   */\n  private normalizePort(port?: number | string): number {\n    if (typeof port === 'number') {\n      return port;\n    }\n    if (typeof port === 'string') {\n      const parsed = parseInt(port, 10);\n      return isNaN(parsed) ? 0 : parsed;\n    }\n    return 0;\n  }\n\n  /**\n   * Load node ID from persistent storage, or generate a new one.\n   */\n  private loadOrGenerateNodeId(configNodeId?: string): string {\n    // Use config value if provided\n    if (configNodeId) {\n      return configNodeId;\n    }\n\n    // Try to load from file\n    if (this.nodeIdPath) {\n      try {\n        if (fs.existsSync(this.nodeIdPath)) {\n          const content = fs.readFileSync(this.nodeIdPath, 'utf-8').trim();\n          if (content) {\n            this.logger.debug(`Loaded node ID from ${this.nodeIdPath}: ${content}`);\n            return content;\n          }\n        }\n      } catch (error: unknown) {\n        this.logger.warn(`Failed to load node ID from ${this.nodeIdPath}: ${(error as Error).message}`);\n      }\n    }\n\n    // Generate new node ID\n    const newNodeId = `center-${randomUUID()}`;\n\n    // Persist to file if path is configured\n    if (this.nodeIdPath) {\n      try {\n        const dir = path.dirname(this.nodeIdPath);\n        if (!fs.existsSync(dir)) {\n          fs.mkdirSync(dir, { recursive: true });\n        }\n        fs.writeFileSync(this.nodeIdPath, newNodeId, 'utf-8');\n        this.logger.info(`Generated and saved new node ID: ${newNodeId}`);\n      } catch (error: unknown) {\n        this.logger.warn(`Failed to persist node ID to ${this.nodeIdPath}: ${(error as Error).message}`);\n      }\n    }\n\n    return newNodeId;\n  }\n\n  /**\n   * Start periodic heartbeat to indicate liveness.\n   */\n  private startHeartbeat(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer);\n    }\n\n    this.heartbeatTimer = setInterval(async () => {\n      try {\n        await this.edgeNodeRepository.updateCenterNodeHeartbeat(\n          this.nodeId,\n          this.internalIp,\n          this.internalPort,\n          new Date(),\n        );\n        this.logger.debug(`Heartbeat sent for node: ${this.nodeId}`);\n      } catch (error: unknown) {\n        this.logger.warn(`Failed to send heartbeat: ${(error as Error).message}`);\n      }\n    }, this.heartbeatInterval);\n\n    // Don't block process exit\n    this.heartbeatTimer.unref();\n  }\n\n  /**\n   * Stop the heartbeat timer (for graceful shutdown).\n   */\n  public stopHeartbeat(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = undefined;\n      this.logger.info(`Heartbeat stopped for node: ${this.nodeId}`);\n    }\n  }\n\n  /**\n   * List all center nodes in the cluster (for discovery).\n   */\n  public async listClusterNodes(): Promise<Array<{\n    nodeId: string;\n    internalIp: string;\n    internalPort: number;\n    isLocal: boolean;\n    reachable: boolean;\n  }>> {\n    const nodes = await this.edgeNodeRepository.listCenterNodes();\n    return nodes.map(node => ({\n      nodeId: node.nodeId,\n      internalIp: node.internalIp,\n      internalPort: node.internalPort,\n      isLocal: node.nodeId === this.nodeId,\n      reachable: node.connectivityStatus === 'reachable',\n    }));\n  }\n\n  /**\n   * Get the internal URL for a specific node.\n   */\n  public async getNodeInternalUrl(nodeId: string): Promise<string | undefined> {\n    const node = await this.edgeNodeRepository.getCenterNode(nodeId);\n    if (!node || !node.internalIp || !node.internalPort) {\n      return undefined;\n    }\n    return `http://${node.internalIp}:${node.internalPort}`;\n  }\n\n  /**\n   * Normalize boolean values from string/boolean.\n   */\n  private normalizeBoolean(value: string | boolean | undefined, defaultValue: 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 defaultValue;\n  }\n}\n"]}