@diap/sdk 0.1.1 → 0.1.2

package/dist/ipfs-node-manager.d.ts

@@ -0,0 +1,136 @@
+/**
+ * DIAP TypeScript SDK - IPFS 节点管理器
+ * 自动启动和管理本地 IPFS 节点
+ */
+import { EventEmitter } from 'events';
+/**
+ * IPFS 节点状态
+ */
+export declare enum IpfsNodeStatus {
+    /** 未知 */
+    Unknown = "unknown",
+    /** 启动中 */
+    Starting = "starting",
+    /** 运行中 */
+    Running = "running",
+    /** 已停止 */
+    Stopped = "stopped",
+    /** 错误 */
+    Error = "error"
+}
+/**
+ * IPFS 节点配置
+ */
+export interface IpfsNodeConfig {
+    /** 数据目录 */
+    dataDir?: string;
+    /** API 端口 */
+    apiPort?: number;
+    /** 网关端口 */
+    gatewayPort?: number;
+    /** Swarm 端口 */
+    swarmPort?: number;
+    /** 自动启动 */
+    autoStart?: boolean;
+    /** 启动超时（秒） */
+    startTimeout?: number;
+}
+/**
+ * IPFS 节点信息
+ */
+export interface IpfsNodeInfo {
+    /** 节点 ID */
+    id: string;
+    /** API 地址 */
+    apiUrl: string;
+    /** 网关地址 */
+    gatewayUrl: string;
+    /** 协议版本 */
+    protocolVersion: string;
+    /** 代理版本 */
+    agentVersion: string;
+}
+/**
+ * IPFS 节点管理器
+ */
+export declare class IpfsNodeManager extends EventEmitter {
+    /** 配置 */
+    private config;
+    /** 节点状态 */
+    private status;
+    /** 进程对象 */
+    private process?;
+    /** 节点信息 */
+    private nodeInfo?;
+    /** 健康检查定时器 */
+    private healthCheckTimer?;
+    /**
+     * 创建 IPFS 节点管理器
+     */
+    static create(config?: IpfsNodeConfig): Promise<IpfsNodeManager>;
+    /**
+     * 构造函数
+     */
+    private constructor();
+    /**
+     * 初始化管理器
+     */
+    private initialize;
+    /**
+     * 启动 IPFS 节点
+     */
+    start(): Promise<void>;
+    /**
+     * 模拟节点启动
+     */
+    private simulateNodeStart;
+    /**
+     * 停止 IPFS 节点
+     */
+    stop(): Promise<void>;
+    /**
+     * 重启 IPFS 节点
+     */
+    restart(): Promise<void>;
+    /**
+     * 获取节点状态
+     */
+    getStatus(): IpfsNodeStatus;
+    /**
+     * 检查节点是否健康
+     */
+    isHealthy(): Promise<boolean>;
+    /**
+     * 获取 API 地址
+     */
+    getApiUrl(): string;
+    /**
+     * 获取网关地址
+     */
+    getGatewayUrl(): string;
+    /**
+     * 获取节点信息
+     */
+    getNodeInfo(): IpfsNodeInfo | null;
+    /**
+     * 启动健康检查
+     */
+    private startHealthCheck;
+    /**
+     * 停止健康检查
+     */
+    private stopHealthCheck;
+    /**
+     * 获取配置
+     */
+    getConfig(): IpfsNodeConfig;
+    /**
+     * 销毁管理器
+     */
+    destroy(): Promise<void>;
+}
+/**
+ * 创建 IPFS 节点管理器（便捷函数）
+ */
+export declare function createIpfsNodeManager(config?: IpfsNodeConfig): Promise<IpfsNodeManager>;
+//# sourceMappingURL=ipfs-node-manager.d.ts.map

package/dist/ipfs-node-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipfs-node-manager.d.ts","sourceRoot":"","sources":["../src/ipfs-node-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC;;GAEG;AACH,oBAAY,cAAc;IACxB,SAAS;IACT,OAAO,YAAY;IACnB,UAAU;IACV,QAAQ,aAAa;IACrB,UAAU;IACV,OAAO,YAAY;IACnB,UAAU;IACV,OAAO,YAAY;IACnB,SAAS;IACT,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW;IACX,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,SAAS;IACT,OAAO,CAAC,MAAM,CAA2B;IACzC,WAAW;IACX,OAAO,CAAC,MAAM,CAAiB;IAC/B,WAAW;IACX,OAAO,CAAC,OAAO,CAAC,CAAM;IACtB,WAAW;IACX,OAAO,CAAC,QAAQ,CAAC,CAAe;IAChC,cAAc;IACd,OAAO,CAAC,gBAAgB,CAAC,CAAiB;IAE1C;;OAEG;WACiB,MAAM,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAS7E;;OAEG;IACH,OAAO;IAeP;;OAEG;YACW,UAAU;IAaxB;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BnC;;OAEG;YACW,iBAAiB;IAe/B;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBlC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrC;;OAEG;IACI,SAAS,IAAI,cAAc;IAIlC;;OAEG;IACU,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAa1C;;OAEG;IACI,SAAS,IAAI,MAAM;IAI1B;;OAEG;IACI,aAAa,IAAI,MAAM;IAI9B;;OAEG;IACI,WAAW,IAAI,YAAY,GAAG,IAAI;IAIzC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACI,SAAS,IAAI,cAAc;IAIlC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAKtC;AAMD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAE7F"}

package/dist/ipfs-node-manager.js

@@ -0,0 +1,232 @@
+/**
+ * DIAP TypeScript SDK - IPFS 节点管理器
+ * 自动启动和管理本地 IPFS 节点
+ */
+import { EventEmitter } from 'events';
+import { logger } from './utils/logger.js';
+/**
+ * IPFS 节点状态
+ */
+export var IpfsNodeStatus;
+(function (IpfsNodeStatus) {
+    /** 未知 */
+    IpfsNodeStatus["Unknown"] = "unknown";
+    /** 启动中 */
+    IpfsNodeStatus["Starting"] = "starting";
+    /** 运行中 */
+    IpfsNodeStatus["Running"] = "running";
+    /** 已停止 */
+    IpfsNodeStatus["Stopped"] = "stopped";
+    /** 错误 */
+    IpfsNodeStatus["Error"] = "error";
+})(IpfsNodeStatus || (IpfsNodeStatus = {}));
+/**
+ * IPFS 节点管理器
+ */
+export class IpfsNodeManager extends EventEmitter {
+    /** 配置 */
+    config;
+    /** 节点状态 */
+    status;
+    /** 进程对象 */
+    process;
+    /** 节点信息 */
+    nodeInfo;
+    /** 健康检查定时器 */
+    healthCheckTimer;
+    /**
+     * 创建 IPFS 节点管理器
+     */
+    static async create(config) {
+        logger.info('🚀 创建 IPFS 节点管理器');
+        const manager = new IpfsNodeManager(config);
+        await manager.initialize();
+        return manager;
+    }
+    /**
+     * 构造函数
+     */
+    constructor(config) {
+        super();
+        this.config = {
+            dataDir: config?.dataDir || './ipfs-data',
+            apiPort: config?.apiPort || 5001,
+            gatewayPort: config?.gatewayPort || 8080,
+            swarmPort: config?.swarmPort || 4001,
+            autoStart: config?.autoStart ?? true,
+            startTimeout: config?.startTimeout || 60,
+        };
+        this.status = IpfsNodeStatus.Unknown;
+    }
+    /**
+     * 初始化管理器
+     */
+    async initialize() {
+        logger.info('💾 IPFS 节点管理器已初始化');
+        logger.info(`  数据目录: ${this.config.dataDir}`);
+        logger.info(`  API 端口: ${this.config.apiPort}`);
+        logger.info(`  网关端口: ${this.config.gatewayPort}`);
+        logger.info(`  Swarm 端口: ${this.config.swarmPort}`);
+        // 如果配置了自动启动，则启动节点
+        if (this.config.autoStart) {
+            await this.start();
+        }
+    }
+    /**
+     * 启动 IPFS 节点
+     */
+    async start() {
+        if (this.status === IpfsNodeStatus.Running) {
+            logger.info('IPFS 节点已在运行中');
+            return;
+        }
+        logger.info('🔄 启动 IPFS 节点...');
+        this.status = IpfsNodeStatus.Starting;
+        this.emit('statusChange', { status: this.status });
+        try {
+            // 模拟节点启动（实际实现需要调用 kubo 或使用 Helia）
+            await this.simulateNodeStart();
+            this.status = IpfsNodeStatus.Running;
+            this.emit('statusChange', { status: this.status });
+            this.emit('started', {});
+            logger.info('✅ IPFS 节点启动成功');
+            // 启动健康检查
+            this.startHealthCheck();
+        }
+        catch (error) {
+            this.status = IpfsNodeStatus.Error;
+            this.emit('statusChange', { status: this.status, error });
+            throw error;
+        }
+    }
+    /**
+     * 模拟节点启动
+     */
+    async simulateNodeStart() {
+        return new Promise((resolve) => {
+            setTimeout(() => {
+                this.nodeInfo = {
+                    id: 'QmSimulatedNodeId123456789',
+                    apiUrl: `http://localhost:${this.config.apiPort}`,
+                    gatewayUrl: `http://localhost:${this.config.gatewayPort}`,
+                    protocolVersion: 'ipfs/0.4.0',
+                    agentVersion: 'kubo/0.26.0',
+                };
+                resolve();
+            }, 1000);
+        });
+    }
+    /**
+     * 停止 IPFS 节点
+     */
+    async stop() {
+        if (this.status === IpfsNodeStatus.Stopped) {
+            logger.info('IPFS 节点已停止');
+            return;
+        }
+        logger.info('🔄 停止 IPFS 节点...');
+        this.status = IpfsNodeStatus.Stopped;
+        this.emit('statusChange', { status: this.status });
+        // 停止健康检查
+        this.stopHealthCheck();
+        this.emit('stopped', {});
+        logger.info('✅ IPFS 节点已停止');
+    }
+    /**
+     * 重启 IPFS 节点
+     */
+    async restart() {
+        logger.info('🔄 重启 IPFS 节点...');
+        await this.stop();
+        await this.start();
+        logger.info('✅ IPFS 节点重启成功');
+    }
+    /**
+     * 获取节点状态
+     */
+    getStatus() {
+        return this.status;
+    }
+    /**
+     * 检查节点是否健康
+     */
+    async isHealthy() {
+        if (this.status !== IpfsNodeStatus.Running) {
+            return false;
+        }
+        try {
+            // 模拟健康检查
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 获取 API 地址
+     */
+    getApiUrl() {
+        return `http://localhost:${this.config.apiPort}`;
+    }
+    /**
+     * 获取网关地址
+     */
+    getGatewayUrl() {
+        return `http://localhost:${this.config.gatewayPort}`;
+    }
+    /**
+     * 获取节点信息
+     */
+    getNodeInfo() {
+        return this.nodeInfo || null;
+    }
+    /**
+     * 启动健康检查
+     */
+    startHealthCheck() {
+        const intervalMs = 30000; // 每 30 秒检查一次
+        this.healthCheckTimer = setInterval(async () => {
+            const healthy = await this.isHealthy();
+            if (!healthy && this.status === IpfsNodeStatus.Running) {
+                logger.warn('⚠️ IPFS 节点健康检查失败');
+                this.emit('unhealthy', {});
+            }
+        }, intervalMs);
+    }
+    /**
+     * 停止健康检查
+     */
+    stopHealthCheck() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = undefined;
+        }
+    }
+    /**
+     * 获取配置
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * 销毁管理器
+     */
+    async destroy() {
+        await this.stop();
+        this.removeAllListeners();
+        logger.info('🧹 IPFS 节点管理器已销毁');
+    }
+}
+// ============================================================================
+// 便捷函数
+// ============================================================================
+/**
+ * 创建 IPFS 节点管理器（便捷函数）
+ */
+export async function createIpfsNodeManager(config) {
+    return IpfsNodeManager.create(config);
+}
+// ============================================================================
+// 导出
+// ============================================================================
+//# sourceMappingURL=ipfs-node-manager.js.map

package/dist/ipfs-node-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipfs-node-manager.js","sourceRoot":"","sources":["../src/ipfs-node-manager.ts"],"names":[],"mappings":"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"}

package/dist/ipns-manager.d.ts

@@ -0,0 +1,182 @@
+/**
+ * DIAP TypeScript SDK - IPNS 管理器
+ * 负责 IPNS 记录的发布、解析和 Key 管理
+ */
+/**
+ * IPNS 记录状态
+ */
+export declare enum IpnsRecordStatus {
+    /** 待发布 */
+    Pending = "pending",
+    /** 已发布 */
+    Published = "published",
+    /** 已过期 */
+    Expired = "expired",
+    /** 失败 */
+    Failed = "failed"
+}
+/**
+ * IPNS 配置
+ */
+export interface IpnsConfig {
+    /** 是否使用 w3name */
+    useW3name?: boolean;
+    /** 是否使用 IPFS 节点 */
+    useIpfsNode?: boolean;
+    /** 记录有效期（天） */
+    validityDays?: number;
+    /** 默认 TTL */
+    defaultTtl?: number;
+}
+/**
+ * IPNS 发布结果
+ */
+export interface IpnsPublishResult {
+    /** IPNS 名称 */
+    name: string;
+    /** 指向的 CID */
+    value: string;
+    /** 序列号 */
+    sequence: number;
+    /** 有效期 */
+    validity: number;
+    /** 签名 */
+    signature: string;
+    /** 发布时间 */
+    publishedAt: string;
+}
+/**
+ * IPNS 解析结果
+ */
+export interface IpnsResolveResult {
+    /** IPNS 名称 */
+    name: string;
+    /** 解析后的 CID */
+    value: string;
+    /** 序列号 */
+    sequence: number;
+    /** TTL */
+    ttl?: number;
+    /** 缓存时间 */
+    cachedAt?: string;
+}
+/**
+ * IPNS Key 信息
+ */
+export interface KeyInfo {
+    /** Key 名称 */
+    name: string;
+    /** Key ID */
+    id: string;
+}
+/**
+ * IPNS 记录
+ */
+export interface IpnsRecord {
+    /** IPNS 名称 */
+    name: string;
+    /** 指向的值 */
+    value: string;
+    /** 序列号 */
+    sequence: number;
+    /** 有效期 */
+    validity: number;
+    /** 签名 */
+    signature: Uint8Array;
+    /** TTL */
+    ttl?: number;
+}
+/**
+ * IPNS 管理器
+ */
+export declare class IpnsManager {
+    /** 配置 */
+    private config;
+    /** Key 列表 */
+    private keys;
+    /** 记录缓存 */
+    private recordCache;
+    /** 使用 w3name */
+    private useW3name;
+    /**
+     * 创建 IPNS 管理器
+     */
+    static create(config?: IpnsConfig): Promise<IpnsManager>;
+    /**
+     * 构造函数
+     */
+    private constructor();
+    /**
+     * 初始化管理器
+     */
+    private initialize;
+    /**
+     * 发布 IPNS 记录
+     */
+    publish(cid: string, keyName?: string, lifetime?: number, ttl?: number): Promise<IpnsPublishResult>;
+    /**
+     * 发布到 w3name
+     */
+    private publishToW3name;
+    /**
+     * 发布到 IPFS 节点
+     */
+    private publishToIpfs;
+    /**
+     * 解析 IPNS 名称
+     */
+    resolve(ipnsName: string): Promise<IpnsResolveResult>;
+    /**
+     * 从 w3name 解析
+     */
+    private resolveFromW3name;
+    /**
+     * 从 IPFS 节点解析
+     */
+    private resolveFromIpfs;
+    /**
+     * 确保 Key 存在
+     */
+    ensureKeyExists(keyName: string): Promise<KeyInfo>;
+    /**
+     * 创建新的 IPNS Key
+     */
+    createKey(keyName: string): Promise<KeyInfo>;
+    /**
+     * 列出所有 Key
+     */
+    listKeys(): KeyInfo[];
+    /**
+     * 删除 Key
+     */
+    removeKey(keyName: string): Promise<void>;
+    /**
+     * 获取下一个序列号
+     */
+    private getNextSequence;
+    /**
+     * 生成 Key ID
+     */
+    private generateKeyId;
+    /**
+     * 获取配置
+     */
+    getConfig(): IpnsConfig;
+    /**
+     * 清空缓存
+     */
+    clearCache(): void;
+    /**
+     * 获取缓存的记录数
+     */
+    getCacheSize(): number;
+    /**
+     * 获取 Key 数量
+     */
+    getKeyCount(): number;
+}
+/**
+ * 创建 IPNS 管理器（便捷函数）
+ */
+export declare function createIpnsManager(config?: IpnsConfig): Promise<IpnsManager>;
+//# sourceMappingURL=ipns-manager.d.ts.map

package/dist/ipns-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipns-manager.d.ts","sourceRoot":"","sources":["../src/ipns-manager.ts"],"names":[],"mappings":"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"}