@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/storage/vector/VectorStoreInit.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Vector Store Initialization Module
+ *
+ * Handles platform-specific SQLite + sqlite-vec extension loading
+ * Supports both Bun and Node.js runtimes
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVectorStoreLibs = getVectorStoreLibs;
+exports.initBunSQLite = initBunSQLite;
+exports.getVecExtensionPath = getVecExtensionPath;
+exports.isVectorSearchAvailable = isVectorSearchAvailable;
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = __importDefault(require("node:fs"));
+// Platform detection
+const platform = `${process.platform}-${process.arch}`;
+// Map platform to library names
+const PLATFORM_LIBS = {
+    'darwin-arm64': { sqlite: 'libsqlite3.dylib', vec: 'vec0.dylib' },
+    'darwin-x64': { sqlite: 'libsqlite3.dylib', vec: 'vec0.dylib' },
+    'linux-x64': { sqlite: 'libsqlite3.so', vec: 'vec0.so' },
+    'linux-arm64': { sqlite: 'libsqlite3.so', vec: 'vec0.so' },
+    'win32-x64': { sqlite: 'sqlite3.dll', vec: 'vec0.dll' },
+};
+/**
+ * Get the paths for SQLite libraries
+ */
+function getVectorStoreLibs() {
+    const libs = PLATFORM_LIBS[platform];
+    if (!libs) {
+        console.warn(`[VectorStore] Unsupported platform: ${platform}`);
+        return null;
+    }
+    // Check for bundled libraries (for packaged app)
+    const bundledDir = node_path_1.default.join(process.cwd(), 'lib', platform);
+    const bundledSqlite = node_path_1.default.join(bundledDir, libs.sqlite);
+    const bundledVec = node_path_1.default.join(bundledDir, libs.vec);
+    if (node_fs_1.default.existsSync(bundledSqlite) && node_fs_1.default.existsSync(bundledVec)) {
+        return {
+            sqlitePath: bundledSqlite,
+            vecExtensionPath: bundledVec,
+            useSystemSQLite: false,
+        };
+    }
+    // Development mode: use system SQLite + npm-installed sqlite-vec
+    const nodeModulesDir = node_path_1.default.join(process.cwd(), 'node_modules');
+    const vecPackageDir = node_path_1.default.join(nodeModulesDir, `sqlite-vec-${platform.replace('-', '-')}`);
+    const vecPath = node_path_1.default.join(vecPackageDir, libs.vec);
+    if (node_fs_1.default.existsSync(vecPath)) {
+        return {
+            sqlitePath: '', // Use system SQLite
+            vecExtensionPath: vecPath,
+            useSystemSQLite: true,
+        };
+    }
+    console.warn(`[VectorStore] Libraries not found for ${platform}`);
+    return null;
+}
+/**
+ * Initialize SQLite for Bun runtime
+ */
+function initBunSQLite() {
+    const isBun = typeof globalThis.Bun !== 'undefined';
+    if (!isBun)
+        return false;
+    const libs = getVectorStoreLibs();
+    if (!libs)
+        return false;
+    try {
+        const { Database } = require('bun:sqlite');
+        // macOS/Windows need custom SQLite with extension support
+        if (process.platform === 'darwin' || process.platform === 'win32') {
+            if (!libs.useSystemSQLite && libs.sqlitePath) {
+                Database.setCustomSQLite(libs.sqlitePath);
+                console.log('[VectorStore] Using bundled SQLite:', libs.sqlitePath);
+            }
+            else if (libs.useSystemSQLite) {
+                console.log('[VectorStore] Using system SQLite with sqlite-vec');
+            }
+        }
+        return true;
+    }
+    catch (e) {
+        console.error('[VectorStore] Failed to initialize Bun SQLite:', e);
+        return false;
+    }
+}
+/**
+ * Get sqlite-vec extension path for better-sqlite3
+ */
+function getVecExtensionPath() {
+    const libs = getVectorStoreLibs();
+    return libs?.vecExtensionPath || null;
+}
+/**
+ * Check if vector search is available
+ */
+function isVectorSearchAvailable() {
+    return getVectorStoreLibs() !== null;
+}
+//# sourceMappingURL=VectorStoreInit.js.map

package/dist/storage/vector/VectorStoreInit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorStoreInit.js","sourceRoot":"","sources":["../../../src/storage/vector/VectorStoreInit.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Vector Store Initialization Module\n *\n * Handles platform-specific SQLite + sqlite-vec extension loading\n * Supports both Bun and Node.js runtimes\n */\n\nimport path from 'node:path';\nimport fs from 'node:fs';\n\n// Platform detection\nconst platform = `${process.platform}-${process.arch}`;\n\n// Map platform to library names\nconst PLATFORM_LIBS: Record<string, { sqlite: string; vec: string }> = {\n  'darwin-arm64': { sqlite: 'libsqlite3.dylib', vec: 'vec0.dylib' },\n  'darwin-x64': { sqlite: 'libsqlite3.dylib', vec: 'vec0.dylib' },\n  'linux-x64': { sqlite: 'libsqlite3.so', vec: 'vec0.so' },\n  'linux-arm64': { sqlite: 'libsqlite3.so', vec: 'vec0.so' },\n  'win32-x64': { sqlite: 'sqlite3.dll', vec: 'vec0.dll' },\n};\n\ninterface VectorStoreConfig {\n  sqlitePath: string;\n  vecExtensionPath: string;\n  useSystemSQLite: boolean;\n}\n\n/**\n * Get the paths for SQLite libraries\n */\nexport function getVectorStoreLibs(): VectorStoreConfig | null {\n  const libs = PLATFORM_LIBS[platform];\n  if (!libs) {\n    console.warn(`[VectorStore] Unsupported platform: ${platform}`);\n    return null;\n  }\n\n  // Check for bundled libraries (for packaged app)\n  const bundledDir = path.join(process.cwd(), 'lib', platform);\n  const bundledSqlite = path.join(bundledDir, libs.sqlite);\n  const bundledVec = path.join(bundledDir, libs.vec);\n\n  if (fs.existsSync(bundledSqlite) && fs.existsSync(bundledVec)) {\n    return {\n      sqlitePath: bundledSqlite,\n      vecExtensionPath: bundledVec,\n      useSystemSQLite: false,\n    };\n  }\n\n  // Development mode: use system SQLite + npm-installed sqlite-vec\n  const nodeModulesDir = path.join(process.cwd(), 'node_modules');\n  const vecPackageDir = path.join(\n    nodeModulesDir,\n    `sqlite-vec-${platform.replace('-', '-')}`\n  );\n  const vecPath = path.join(vecPackageDir, libs.vec);\n\n  if (fs.existsSync(vecPath)) {\n    return {\n      sqlitePath: '', // Use system SQLite\n      vecExtensionPath: vecPath,\n      useSystemSQLite: true,\n    };\n  }\n\n  console.warn(`[VectorStore] Libraries not found for ${platform}`);\n  return null;\n}\n\n/**\n * Initialize SQLite for Bun runtime\n */\nexport function initBunSQLite(): boolean {\n  const isBun = typeof (globalThis as any).Bun !== 'undefined';\n  if (!isBun) return false;\n\n  const libs = getVectorStoreLibs();\n  if (!libs) return false;\n\n  try {\n    const { Database } = require('bun:sqlite');\n\n    // macOS/Windows need custom SQLite with extension support\n    if (process.platform === 'darwin' || process.platform === 'win32') {\n      if (!libs.useSystemSQLite && libs.sqlitePath) {\n        Database.setCustomSQLite(libs.sqlitePath);\n        console.log('[VectorStore] Using bundled SQLite:', libs.sqlitePath);\n      } else if (libs.useSystemSQLite) {\n        console.log('[VectorStore] Using system SQLite with sqlite-vec');\n      }\n    }\n\n    return true;\n  } catch (e) {\n    console.error('[VectorStore] Failed to initialize Bun SQLite:', e);\n    return false;\n  }\n}\n\n/**\n * Get sqlite-vec extension path for better-sqlite3\n */\nexport function getVecExtensionPath(): string | null {\n  const libs = getVectorStoreLibs();\n  return libs?.vecExtensionPath || null;\n}\n\n/**\n * Check if vector search is available\n */\nexport function isVectorSearchAvailable(): boolean {\n  return getVectorStoreLibs() !== null;\n}\n"]}

package/dist/storage/vector/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types';
+export * from './VectorStore';
+export * from './SqliteVectorStore';
+export * from './PostgresVectorStore';
+export * from './VectorIndexingListener';

package/dist/storage/vector/index.js

@@ -0,0 +1,22 @@
+"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 __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("./types"), exports);
+__exportStar(require("./VectorStore"), exports);
+__exportStar(require("./SqliteVectorStore"), exports);
+__exportStar(require("./PostgresVectorStore"), exports);
+__exportStar(require("./VectorIndexingListener"), exports);
+//# sourceMappingURL=index.js.map

package/dist/storage/vector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/vector/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,gDAA8B;AAC9B,sDAAoC;AACpC,wDAAsC;AACtC,2DAAyC","sourcesContent":["export * from './types';\nexport * from './VectorStore';\nexport * from './SqliteVectorStore';\nexport * from './PostgresVectorStore';\nexport * from './VectorIndexingListener';\n"]}

package/dist/storage/vector/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * VectorStore - 向量存储类型定义
+ *
+ * 支持多模型版本管理和向量搜索
+ */
+/**
+ * VectorStore 配置选项
+ */
+export interface VectorStoreOptions {
+    /** 数据库连接字符串，如 sqlite:./data/xpod.db 或 postgresql://... */
+    connectionString: string;
+}
+/**
+ * 向量记录
+ */
+export interface VectorRecord {
+    id: number;
+    embedding: number[];
+    createdAt: number;
+}
+/**
+ * 向量搜索选项
+ */
+export interface VectorSearchOptions {
+    /** 搜索结果数量限制 */
+    limit?: number;
+    /** 相似度阈值 (0-1) */
+    threshold?: number;
+    /** 排除的 ID 列表（用于双读去重） */
+    excludeIds?: Set<number>;
+}
+/**
+ * 向量搜索结果
+ */
+export interface VectorSearchResult {
+    id: number;
+    distance: number;
+    score: number;
+}

package/dist/storage/vector/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * VectorStore - 向量存储类型定义
+ *
+ * 支持多模型版本管理和向量搜索
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/storage/vector/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/storage/vector/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG","sourcesContent":["/**\n * VectorStore - 向量存储类型定义\n *\n * 支持多模型版本管理和向量搜索\n */\n\n/**\n * VectorStore 配置选项\n */\nexport interface VectorStoreOptions {\n  /** 数据库连接字符串，如 sqlite:./data/xpod.db 或 postgresql://... */\n  connectionString: string;\n}\n\n/**\n * 向量记录\n */\nexport interface VectorRecord {\n  id: number; // 关联 quints.rowid\n  embedding: number[]; // 向量数据\n  createdAt: number;\n}\n\n/**\n * 向量搜索选项\n */\nexport interface VectorSearchOptions {\n  /** 搜索结果数量限制 */\n  limit?: number;\n  /** 相似度阈值 (0-1) */\n  threshold?: number;\n  /** 排除的 ID 列表（用于双读去重） */\n  excludeIds?: Set<number>;\n}\n\n/**\n * 向量搜索结果\n */\nexport interface VectorSearchResult {\n  id: number; // quints.rowid\n  distance: number; // 距离（越小越相似）\n  score: number; // 相似度分数 (0-1)\n}\n"]}

package/dist/subdomain/SubdomainClient.d.ts

@@ -0,0 +1,156 @@
+/**
+ * SubdomainClient - Local 模式子域名客户端
+ *
+ * Local 模式不持有 DNS/Tunnel 密钥，通过调用 Cloud API 来管理子域名。
+ * 使用 Node Token 认证（与 Edge Node 心跳相同的认证方式）。
+ */
+export interface SubdomainClientOptions {
+    /** Cloud API 端点 (如 https://center.example.com/v1/subdomain) */
+    cloudApiEndpoint: string;
+    /** 节点 ID */
+    nodeId: string;
+    /** 节点 Token */
+    nodeToken: string;
+    /** 请求超时 (ms) */
+    timeoutMs?: number;
+}
+export interface SubdomainCheckResult {
+    subdomain: string;
+    available: boolean;
+    reason?: string;
+}
+export interface SubdomainRegistrationResult {
+    success: boolean;
+    subdomain: string;
+    fullDomain: string;
+    mode: 'direct' | 'tunnel';
+    publicIp?: string;
+    tunnelProvider?: string;
+    tunnelEndpoint?: string;
+    registeredAt: string;
+    message?: string;
+}
+export interface SubdomainInfo {
+    subdomain: string;
+    fullDomain: string;
+    mode: 'direct' | 'tunnel';
+    publicIp?: string;
+    tunnelProvider?: string;
+    tunnelEndpoint?: string;
+    registeredAt: string;
+    ownerId?: string;
+}
+export interface DdnsAllocationResult {
+    success: boolean;
+    subdomain: string;
+    domain: string;
+    fqdn: string;
+    ipAddress?: string;
+    ipv6Address?: string;
+    createdAt: string;
+}
+export interface DdnsUpdateResult {
+    success: boolean;
+    subdomain: string;
+    domain: string;
+    fqdn: string;
+    ipAddress?: string;
+    ipv6Address?: string;
+    updatedAt: string;
+}
+export interface DdnsRecordInfo {
+    subdomain: string;
+    domain: string;
+    fqdn: string;
+    ipAddress?: string;
+    ipv6Address?: string;
+    recordType: string;
+    status: string;
+    ttl: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * 子域名客户端 (Local 模式)
+ *
+ * 通过 HTTP 调用 Cloud 的子域名 API
+ */
+export declare class SubdomainClient {
+    private readonly logger;
+    private readonly cloudApiEndpoint;
+    private readonly nodeId;
+    private readonly nodeToken;
+    private readonly timeoutMs;
+    constructor(options: SubdomainClientOptions);
+    /**
+     * 检查子域名可用性
+     */
+    checkAvailability(name: string): Promise<SubdomainCheckResult>;
+    /**
+     * 注册子域名
+     */
+    register(options: {
+        subdomain: string;
+        localPort: number;
+        publicIp?: string;
+    }): Promise<SubdomainRegistrationResult>;
+    /**
+     * 获取子域名信息
+     */
+    getInfo(name: string): Promise<SubdomainInfo | null>;
+    /**
+     * 列出所有子域名
+     */
+    list(): Promise<{
+        registrations: SubdomainInfo[];
+        total: number;
+    }>;
+    /**
+     * 释放子域名
+     */
+    release(name: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * 启动隧道
+     */
+    startTunnel(name: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * 停止隧道
+     */
+    stopTunnel(name: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * 分配 DDNS 子域名
+     */
+    allocateDdns(options: {
+        subdomain: string;
+        ipAddress?: string;
+        ipv6Address?: string;
+    }): Promise<DdnsAllocationResult>;
+    /**
+     * 更新 DDNS 记录
+     */
+    updateDdns(subdomain: string, options: {
+        ipAddress?: string;
+        ipv6Address?: string;
+    }): Promise<DdnsUpdateResult>;
+    /**
+     * 获取 DDNS 记录
+     */
+    getDdns(subdomain: string): Promise<DdnsRecordInfo | null>;
+    private fetch;
+}
+/**
+ * SubdomainClient 错误
+ */
+export declare class SubdomainClientError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}

package/dist/subdomain/SubdomainClient.js

@@ -0,0 +1,220 @@
+"use strict";
+/**
+ * SubdomainClient - Local 模式子域名客户端
+ *
+ * Local 模式不持有 DNS/Tunnel 密钥，通过调用 Cloud API 来管理子域名。
+ * 使用 Node Token 认证（与 Edge Node 心跳相同的认证方式）。
+ */
+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.SubdomainClientError = exports.SubdomainClient = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+/**
+ * 子域名客户端 (Local 模式)
+ *
+ * 通过 HTTP 调用 Cloud 的子域名 API
+ */
+class SubdomainClient {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.cloudApiEndpoint = options.cloudApiEndpoint.replace(/\/$/, '');
+        this.nodeId = options.nodeId;
+        this.nodeToken = options.nodeToken;
+        this.timeoutMs = options.timeoutMs ?? 30000;
+    }
+    /**
+     * 检查子域名可用性
+     */
+    async checkAvailability(name) {
+        const url = `${this.cloudApiEndpoint}/check?name=${encodeURIComponent(name)}`;
+        const response = await this.fetch(url, { method: 'GET' });
+        return response;
+    }
+    /**
+     * 注册子域名
+     */
+    async register(options) {
+        const url = `${this.cloudApiEndpoint}/register`;
+        const response = await this.fetch(url, {
+            method: 'POST',
+            body: JSON.stringify({
+                subdomain: options.subdomain,
+                localPort: options.localPort,
+                publicIp: options.publicIp,
+                nodeId: this.nodeId,
+            }),
+        });
+        return response;
+    }
+    /**
+     * 获取子域名信息
+     */
+    async getInfo(name) {
+        const url = `${this.cloudApiEndpoint}/${encodeURIComponent(name)}`;
+        try {
+            const response = await this.fetch(url, { method: 'GET' });
+            return response;
+        }
+        catch (error) {
+            if (error instanceof SubdomainClientError && error.status === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * 列出所有子域名
+     */
+    async list() {
+        const url = this.cloudApiEndpoint;
+        const response = await this.fetch(url, { method: 'GET' });
+        return response;
+    }
+    /**
+     * 释放子域名
+     */
+    async release(name) {
+        const url = `${this.cloudApiEndpoint}/${encodeURIComponent(name)}`;
+        const response = await this.fetch(url, { method: 'DELETE' });
+        return response;
+    }
+    /**
+     * 启动隧道
+     */
+    async startTunnel(name) {
+        const url = `${this.cloudApiEndpoint}/${encodeURIComponent(name)}/start`;
+        const response = await this.fetch(url, { method: 'POST' });
+        return response;
+    }
+    /**
+     * 停止隧道
+     */
+    async stopTunnel(name) {
+        const url = `${this.cloudApiEndpoint}/${encodeURIComponent(name)}/stop`;
+        const response = await this.fetch(url, { method: 'POST' });
+        return response;
+    }
+    // ============ DDNS API ============
+    /**
+     * 分配 DDNS 子域名
+     */
+    async allocateDdns(options) {
+        const url = `${this.cloudApiEndpoint}/api/v1/ddns/allocate`;
+        const response = await this.fetch(url, {
+            method: 'POST',
+            body: JSON.stringify({
+                subdomain: options.subdomain,
+                nodeId: this.nodeId,
+                ipAddress: options.ipAddress,
+                ipv6Address: options.ipv6Address,
+            }),
+        });
+        return response;
+    }
+    /**
+     * 更新 DDNS 记录
+     */
+    async updateDdns(subdomain, options) {
+        const url = `${this.cloudApiEndpoint}/api/v1/ddns/${encodeURIComponent(subdomain)}`;
+        const response = await this.fetch(url, {
+            method: 'POST',
+            body: JSON.stringify({
+                ip: options.ipAddress,
+                ipv6Address: options.ipv6Address,
+            }),
+        });
+        return response;
+    }
+    /**
+     * 获取 DDNS 记录
+     */
+    async getDdns(subdomain) {
+        const url = `${this.cloudApiEndpoint}/api/v1/ddns/${encodeURIComponent(subdomain)}`;
+        try {
+            const response = await this.fetch(url, { method: 'GET' });
+            return response;
+        }
+        catch (error) {
+            if (error instanceof SubdomainClientError && error.status === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    // ============ Private Methods ============
+    async fetch(url, options) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            // 使用 undici 的 fetch，禁用代理
+            const { fetch: undiciFetch, Agent } = await Promise.resolve().then(() => __importStar(require('undici')));
+            const agent = new Agent({
+                connect: { timeout: this.timeoutMs },
+            });
+            const response = await undiciFetch(url, {
+                method: options.method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.nodeToken}`,
+                    'X-Node-Id': this.nodeId,
+                },
+                body: options.body,
+                signal: controller.signal,
+                dispatcher: agent,
+            });
+            const data = await response.json();
+            if (!response.ok) {
+                const error = data?.error ?? 'Unknown error';
+                throw new SubdomainClientError(error, response.status);
+            }
+            return data;
+        }
+        catch (error) {
+            if (error instanceof SubdomainClientError) {
+                throw error;
+            }
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new SubdomainClientError('Request timeout', 408);
+            }
+            throw new SubdomainClientError(error instanceof Error ? error.message : 'Unknown error', 500);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+exports.SubdomainClient = SubdomainClient;
+/**
+ * SubdomainClient 错误
+ */
+class SubdomainClientError extends Error {
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = 'SubdomainClientError';
+    }
+}
+exports.SubdomainClientError = SubdomainClientError;
+//# sourceMappingURL=SubdomainClient.js.map

package/dist/subdomain/SubdomainClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubdomainClient.js","sourceRoot":"","sources":["../../src/subdomain/SubdomainClient.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SubdomainClient - Local 模式子域名客户端\n * \n * Local 模式不持有 DNS/Tunnel 密钥，通过调用 Cloud API 来管理子域名。\n * 使用 Node Token 认证（与 Edge Node 心跳相同的认证方式）。\n */\n\nimport { getLoggerFor } from 'global-logger-factory';\n\nexport interface SubdomainClientOptions {\n  /** Cloud API 端点 (如 https://center.example.com/v1/subdomain) */\n  cloudApiEndpoint: string;\n  \n  /** 节点 ID */\n  nodeId: string;\n  \n  /** 节点 Token */\n  nodeToken: string;\n  \n  /** 请求超时 (ms) */\n  timeoutMs?: number;\n}\n\nexport interface SubdomainCheckResult {\n  subdomain: string;\n  available: boolean;\n  reason?: string;\n}\n\nexport interface SubdomainRegistrationResult {\n  success: boolean;\n  subdomain: string;\n  fullDomain: string;\n  mode: 'direct' | 'tunnel';\n  publicIp?: string;\n  tunnelProvider?: string;\n  tunnelEndpoint?: string;\n  registeredAt: string;\n  message?: string;\n}\n\nexport interface SubdomainInfo {\n  subdomain: string;\n  fullDomain: string;\n  mode: 'direct' | 'tunnel';\n  publicIp?: string;\n  tunnelProvider?: string;\n  tunnelEndpoint?: string;\n  registeredAt: string;\n  ownerId?: string;\n}\n\nexport interface DdnsAllocationResult {\n  success: boolean;\n  subdomain: string;\n  domain: string;\n  fqdn: string;\n  ipAddress?: string;\n  ipv6Address?: string;\n  createdAt: string;\n}\n\nexport interface DdnsUpdateResult {\n  success: boolean;\n  subdomain: string;\n  domain: string;\n  fqdn: string;\n  ipAddress?: string;\n  ipv6Address?: string;\n  updatedAt: string;\n}\n\nexport interface DdnsRecordInfo {\n  subdomain: string;\n  domain: string;\n  fqdn: string;\n  ipAddress?: string;\n  ipv6Address?: string;\n  recordType: string;\n  status: string;\n  ttl: number;\n  createdAt: string;\n  updatedAt: string;\n}\n\n/**\n * 子域名客户端 (Local 模式)\n * \n * 通过 HTTP 调用 Cloud 的子域名 API\n */\nexport class SubdomainClient {\n  private readonly logger = getLoggerFor(this);\n  private readonly cloudApiEndpoint: string;\n  private readonly nodeId: string;\n  private readonly nodeToken: string;\n  private readonly timeoutMs: number;\n\n  constructor(options: SubdomainClientOptions) {\n    this.cloudApiEndpoint = options.cloudApiEndpoint.replace(/\\/$/, '');\n    this.nodeId = options.nodeId;\n    this.nodeToken = options.nodeToken;\n    this.timeoutMs = options.timeoutMs ?? 30000;\n  }\n\n  /**\n   * 检查子域名可用性\n   */\n  async checkAvailability(name: string): Promise<SubdomainCheckResult> {\n    const url = `${this.cloudApiEndpoint}/check?name=${encodeURIComponent(name)}`;\n    const response = await this.fetch(url, { method: 'GET' });\n    return response as SubdomainCheckResult;\n  }\n\n  /**\n   * 注册子域名\n   */\n  async register(options: {\n    subdomain: string;\n    localPort: number;\n    publicIp?: string;\n  }): Promise<SubdomainRegistrationResult> {\n    const url = `${this.cloudApiEndpoint}/register`;\n    const response = await this.fetch(url, {\n      method: 'POST',\n      body: JSON.stringify({\n        subdomain: options.subdomain,\n        localPort: options.localPort,\n        publicIp: options.publicIp,\n        nodeId: this.nodeId,\n      }),\n    });\n    return response as SubdomainRegistrationResult;\n  }\n\n  /**\n   * 获取子域名信息\n   */\n  async getInfo(name: string): Promise<SubdomainInfo | null> {\n    const url = `${this.cloudApiEndpoint}/${encodeURIComponent(name)}`;\n    try {\n      const response = await this.fetch(url, { method: 'GET' });\n      return response as SubdomainInfo;\n    } catch (error) {\n      if (error instanceof SubdomainClientError && error.status === 404) {\n        return null;\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * 列出所有子域名\n   */\n  async list(): Promise<{ registrations: SubdomainInfo[]; total: number }> {\n    const url = this.cloudApiEndpoint;\n    const response = await this.fetch(url, { method: 'GET' });\n    return response as { registrations: SubdomainInfo[]; total: number };\n  }\n\n  /**\n   * 释放子域名\n   */\n  async release(name: string): Promise<{ success: boolean; message: string }> {\n    const url = `${this.cloudApiEndpoint}/${encodeURIComponent(name)}`;\n    const response = await this.fetch(url, { method: 'DELETE' });\n    return response as { success: boolean; message: string };\n  }\n\n  /**\n   * 启动隧道\n   */\n  async startTunnel(name: string): Promise<{ success: boolean; message: string }> {\n    const url = `${this.cloudApiEndpoint}/${encodeURIComponent(name)}/start`;\n    const response = await this.fetch(url, { method: 'POST' });\n    return response as { success: boolean; message: string };\n  }\n\n  /**\n   * 停止隧道\n   */\n  async stopTunnel(name: string): Promise<{ success: boolean; message: string }> {\n    const url = `${this.cloudApiEndpoint}/${encodeURIComponent(name)}/stop`;\n    const response = await this.fetch(url, { method: 'POST' });\n    return response as { success: boolean; message: string };\n  }\n\n  // ============ DDNS API ============\n\n  /**\n   * 分配 DDNS 子域名\n   */\n  async allocateDdns(options: {\n    subdomain: string;\n    ipAddress?: string;\n    ipv6Address?: string;\n  }): Promise<DdnsAllocationResult> {\n    const url = `${this.cloudApiEndpoint}/api/v1/ddns/allocate`;\n    const response = await this.fetch(url, {\n      method: 'POST',\n      body: JSON.stringify({\n        subdomain: options.subdomain,\n        nodeId: this.nodeId,\n        ipAddress: options.ipAddress,\n        ipv6Address: options.ipv6Address,\n      }),\n    });\n    return response as DdnsAllocationResult;\n  }\n\n  /**\n   * 更新 DDNS 记录\n   */\n  async updateDdns(subdomain: string, options: {\n    ipAddress?: string;\n    ipv6Address?: string;\n  }): Promise<DdnsUpdateResult> {\n    const url = `${this.cloudApiEndpoint}/api/v1/ddns/${encodeURIComponent(subdomain)}`;\n    const response = await this.fetch(url, {\n      method: 'POST',\n      body: JSON.stringify({\n        ip: options.ipAddress,\n        ipv6Address: options.ipv6Address,\n      }),\n    });\n    return response as DdnsUpdateResult;\n  }\n\n  /**\n   * 获取 DDNS 记录\n   */\n  async getDdns(subdomain: string): Promise<DdnsRecordInfo | null> {\n    const url = `${this.cloudApiEndpoint}/api/v1/ddns/${encodeURIComponent(subdomain)}`;\n    try {\n      const response = await this.fetch(url, { method: 'GET' });\n      return response as DdnsRecordInfo;\n    } catch (error) {\n      if (error instanceof SubdomainClientError && error.status === 404) {\n        return null;\n      }\n      throw error;\n    }\n  }\n\n  // ============ Private Methods ============\n\n  private async fetch(url: string, options: {\n    method: string;\n    body?: string;\n  }): Promise<unknown> {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    try {\n      // 使用 undici 的 fetch，禁用代理\n      const { fetch: undiciFetch, Agent } = await import('undici');\n      const agent = new Agent({\n        connect: { timeout: this.timeoutMs },\n      });\n\n      const response = await undiciFetch(url, {\n        method: options.method,\n        headers: {\n          'Content-Type': 'application/json',\n          'Authorization': `Bearer ${this.nodeToken}`,\n          'X-Node-Id': this.nodeId,\n        },\n        body: options.body,\n        signal: controller.signal,\n        dispatcher: agent,\n      });\n\n      const data = await response.json();\n\n      if (!response.ok) {\n        const error = (data as any)?.error ?? 'Unknown error';\n        throw new SubdomainClientError(error, response.status);\n      }\n\n      return data;\n    } catch (error) {\n      if (error instanceof SubdomainClientError) {\n        throw error;\n      }\n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new SubdomainClientError('Request timeout', 408);\n      }\n      throw new SubdomainClientError(\n        error instanceof Error ? error.message : 'Unknown error',\n        500,\n      );\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n}\n\n/**\n * SubdomainClient 错误\n */\nexport class SubdomainClientError extends Error {\n  constructor(\n    message: string,\n    public readonly status: number,\n  ) {\n    super(message);\n    this.name = 'SubdomainClientError';\n  }\n}\n"]}