wowok 2.1.39 → 2.1.41

package/dist/esm/w/local/storage.d.ts

@@ -1,15 +1,3 @@
-/**
- * SQLite 存储实现
- *
- * 架构：
- * - cache.db: 通用缓存数据
- * - account.db: 账户数据（更高安全级别）
- *
- * 特点：
- * 1. 进程安全 - 支持多进程并发访问
- * 2. 业务隔离 - cache 和 account 完全分离
- * 3. WAL 模式 - 高性能读写
- */
 import Database from "better-sqlite3";
 export interface IStorage {
     put(key: string, value: string): Promise<void>;
@@ -47,15 +35,7 @@ export declare class SQLiteAccountStorage implements IAccountStorage {
     put(data: string): Promise<void>;
     clear(): Promise<void>;
 }
-/**
- * 关闭并重置所有数据库连接
- * 用于测试时清理数据
- */
 export declare function resetAllDbConnections(): void;
-/**
- * 重置所有存储实例和数据库连接
- * 用于测试时完全清理数据
- */
 export declare function resetAllStorage(): void;
 export declare const defaultStorage: SQLiteStorage;
 export declare const defaultAccountStorage: SQLiteAccountStorage;

package/dist/esm/w/local/storage.js

@@ -1,222 +1 @@
-// Copyright (c) Wowok.
-// SPDX-License-Identifier: Apache-2.0
-/**
- * SQLite 存储实现
- *
- * 架构：
- * - cache.db: 通用缓存数据
- * - account.db: 账户数据（更高安全级别）
- *
- * 特点：
- * 1. 进程安全 - 支持多进程并发访问
- * 2. 业务隔离 - cache 和 account 完全分离
- * 3. WAL 模式 - 高性能读写
- */
-import Database from "better-sqlite3";
-import * as path from "path";
-import * as fs from "fs";
-import { getWowDir } from "./util.js";
-const WOW_DIR = getWowDir();
-const CACHE_DB_PATH = path.join(WOW_DIR, "cache.db");
-const ACCOUNT_DB_PATH = path.join(WOW_DIR, "account.db");
-function ensureWowDirExists() {
-    if (!fs.existsSync(WOW_DIR)) {
-        fs.mkdirSync(WOW_DIR, { recursive: true });
-    }
-}
-ensureWowDirExists();
-// ========== Cache 数据库 ==========
-function getCacheDatabase() {
-    ensureWowDirExists();
-    const db = new Database(CACHE_DB_PATH);
-    db.pragma("journal_mode = WAL");
-    db.pragma("synchronous = NORMAL");
-    db.exec(`
-		CREATE TABLE IF NOT EXISTS cache (
-			key TEXT PRIMARY KEY,
-			value TEXT NOT NULL,
-			updated_at INTEGER DEFAULT (strftime('%s', 'now'))
-		);
-	`);
-    return db;
-}
-let cacheDbInstance = null;
-function getCacheDb() {
-    if (!cacheDbInstance) {
-        cacheDbInstance = getCacheDatabase();
-    }
-    return cacheDbInstance;
-}
-// ========== Account 数据库 ==========
-function getAccountDatabase() {
-    ensureWowDirExists();
-    const db = new Database(ACCOUNT_DB_PATH);
-    db.pragma("journal_mode = WAL");
-    db.pragma("synchronous = NORMAL");
-    // 设置更严格的文件权限（仅 Unix 系统有效）
-    try {
-        fs.chmodSync(ACCOUNT_DB_PATH, 0o600);
-    }
-    catch {
-        // Windows 或其他系统忽略权限设置错误
-    }
-    db.exec(`
-		CREATE TABLE IF NOT EXISTS accounts (
-			id INTEGER PRIMARY KEY CHECK (id = 1),
-			data TEXT NOT NULL,
-			updated_at INTEGER DEFAULT (strftime('%s', 'now'))
-		);
-	`);
-    return db;
-}
-let accountDbInstance = null;
-function getAccountDb() {
-    if (!accountDbInstance) {
-        accountDbInstance = getAccountDatabase();
-    }
-    return accountDbInstance;
-}
-// ========== Cache 存储实现 ==========
-export class SQLiteStorage {
-    _db;
-    _dbSource;
-    constructor(db) {
-        this._dbSource = db;
-    }
-    get db() {
-        if (this._dbSource) {
-            return this._dbSource;
-        }
-        if (!this._db) {
-            this._db = getCacheDb();
-        }
-        return this._db;
-    }
-    async get(key) {
-        const row = this.db
-            .prepare("SELECT value FROM cache WHERE key = ?")
-            .get(key);
-        return row?.value;
-    }
-    async getMany(keys) {
-        const placeholders = keys.map(() => "?").join(",");
-        const rows = this.db
-            .prepare(`SELECT key, value FROM cache WHERE key IN (${placeholders})`)
-            .all(...keys);
-        const map = new Map(rows.map((r) => [r.key, r.value]));
-        return keys.map((k) => map.get(k));
-    }
-    async put(key, value) {
-        this.db
-            .prepare(`
-			INSERT INTO cache (key, value, updated_at) 
-			VALUES (?, ?, strftime('%s', 'now'))
-			ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at
-		`)
-            .run(key, value);
-    }
-    async putMany(items) {
-        const stmt = this.db.prepare(`
-			INSERT INTO cache (key, value, updated_at) 
-			VALUES (?, ?, strftime('%s', 'now'))
-			ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at
-		`);
-        const insertMany = this.db.transaction((items) => {
-            for (const item of items)
-                stmt.run(item.key, item.value);
-        });
-        insertMany(items);
-    }
-    async del(key) {
-        this.db.prepare("DELETE FROM cache WHERE key = ?").run(key);
-    }
-    async clear() {
-        this.db.exec("DELETE FROM cache");
-    }
-}
-// ========== Account 存储实现 ==========
-export class SQLiteAccountStorage {
-    _db;
-    _dbSource;
-    constructor(db) {
-        this._dbSource = db;
-    }
-    get db() {
-        if (this._dbSource) {
-            return this._dbSource;
-        }
-        if (!this._db) {
-            this._db = getAccountDb();
-        }
-        return this._db;
-    }
-    async get() {
-        const row = this.db
-            .prepare("SELECT data FROM accounts WHERE id = 1")
-            .get();
-        return row?.data;
-    }
-    async put(data) {
-        this.db
-            .prepare(`
-			INSERT INTO accounts (id, data, updated_at) 
-			VALUES (1, ?, strftime('%s', 'now'))
-			ON CONFLICT(id) DO UPDATE SET data = excluded.data, updated_at = excluded.updated_at
-		`)
-            .run(data);
-    }
-    async clear() {
-        this.db.exec("DELETE FROM accounts");
-    }
-}
-// ========== 数据库连接管理 ==========
-/**
- * 关闭并重置所有数据库连接
- * 用于测试时清理数据
- */
-export function resetAllDbConnections() {
-    if (cacheDbInstance) {
-        try {
-            cacheDbInstance.close();
-        }
-        catch (e) {
-            // 忽略关闭错误
-        }
-        cacheDbInstance = null;
-    }
-    if (accountDbInstance) {
-        try {
-            accountDbInstance.close();
-        }
-        catch (e) {
-            // 忽略关闭错误
-        }
-        accountDbInstance = null;
-    }
-}
-// 注册进程退出时的清理函数
-process.on("exit", () => {
-    resetAllDbConnections();
-});
-// 处理 SIGINT (Ctrl+C)
-process.on("SIGINT", () => {
-    resetAllDbConnections();
-    process.exit(0);
-});
-// 处理 SIGTERM
-process.on("SIGTERM", () => {
-    resetAllDbConnections();
-    process.exit(0);
-});
-/**
- * 重置所有存储实例和数据库连接
- * 用于测试时完全清理数据
- */
-export function resetAllStorage() {
-    // 先重置数据库连接
-    resetAllDbConnections();
-}
-// ========== 默认实例 ==========
-export const defaultStorage = new SQLiteStorage();
-export const defaultAccountStorage = new SQLiteAccountStorage();
-//# sourceMappingURL=storage.js.map
+import a175a from'better-sqlite3';import*as a175b from'path';import*as a175c from'fs';import{getWowDir}from'./util.js';const WOW_DIR=getWowDir(),CACHE_DB_PATH=a175b['join'](WOW_DIR,'cache.db'),ACCOUNT_DB_PATH=a175b['join'](WOW_DIR,'account.db');function ensureWowDirExists(){!a175c['existsSync'](WOW_DIR)&&a175c['mkdirSync'](WOW_DIR,{'recursive':!![]});}ensureWowDirExists();function getCacheDatabase(){ensureWowDirExists();const a=new a175a(CACHE_DB_PATH);return a['pragma']('journal_mode\x20=\x20WAL'),a['pragma']('synchronous\x20=\x20NORMAL'),a['exec']('\x0a\x09\x09CREATE\x20TABLE\x20IF\x20NOT\x20EXISTS\x20cache\x20(\x0a\x09\x09\x09key\x20TEXT\x20PRIMARY\x20KEY,\x0a\x09\x09\x09value\x20TEXT\x20NOT\x20NULL,\x0a\x09\x09\x09updated_at\x20INTEGER\x20DEFAULT\x20(strftime(\x27%s\x27,\x20\x27now\x27))\x0a\x09\x09);\x0a\x09'),a;}let cacheDbInstance=null;function getCacheDb(){return!cacheDbInstance&&(cacheDbInstance=getCacheDatabase()),cacheDbInstance;}function getAccountDatabase(){ensureWowDirExists();const a=new a175a(ACCOUNT_DB_PATH);a['pragma']('journal_mode\x20=\x20WAL'),a['pragma']('synchronous\x20=\x20NORMAL');try{a175c['chmodSync'](ACCOUNT_DB_PATH,0x180);}catch{}return a['exec']('\x0a\x09\x09CREATE\x20TABLE\x20IF\x20NOT\x20EXISTS\x20accounts\x20(\x0a\x09\x09\x09id\x20INTEGER\x20PRIMARY\x20KEY\x20CHECK\x20(id\x20=\x201),\x0a\x09\x09\x09data\x20TEXT\x20NOT\x20NULL,\x0a\x09\x09\x09updated_at\x20INTEGER\x20DEFAULT\x20(strftime(\x27%s\x27,\x20\x27now\x27))\x0a\x09\x09);\x0a\x09'),a;}let accountDbInstance=null;function getAccountDb(){return!accountDbInstance&&(accountDbInstance=getAccountDatabase()),accountDbInstance;}export class SQLiteStorage{['_db'];['_dbSource'];constructor(a){this['_dbSource']=a;}get['db'](){if(this['_dbSource'])return this['_dbSource'];return!this['_db']&&(this['_db']=getCacheDb()),this['_db'];}async['get'](a){const b=this['db']['prepare']('SELECT\x20value\x20FROM\x20cache\x20WHERE\x20key\x20=\x20?')['get'](a);return b?.['value'];}async['getMany'](a){const b=a['map'](()=>'?')['join'](','),c=this['db']['prepare']('SELECT\x20key,\x20value\x20FROM\x20cache\x20WHERE\x20key\x20IN\x20('+b+')')['all'](...a),d=new Map(c['map'](e=>[e['key'],e['value']]));return a['map'](e=>d['get'](e));}async['put'](a,b){this['db']['prepare']('\x0a\x09\x09\x09INSERT\x20INTO\x20cache\x20(key,\x20value,\x20updated_at)\x20\x0a\x09\x09\x09VALUES\x20(?,\x20?,\x20strftime(\x27%s\x27,\x20\x27now\x27))\x0a\x09\x09\x09ON\x20CONFLICT(key)\x20DO\x20UPDATE\x20SET\x20value\x20=\x20excluded.value,\x20updated_at\x20=\x20excluded.updated_at\x0a\x09\x09')['run'](a,b);}async['putMany'](a){const b=this['db']['prepare']('\x0a\x09\x09\x09INSERT\x20INTO\x20cache\x20(key,\x20value,\x20updated_at)\x20\x0a\x09\x09\x09VALUES\x20(?,\x20?,\x20strftime(\x27%s\x27,\x20\x27now\x27))\x0a\x09\x09\x09ON\x20CONFLICT(key)\x20DO\x20UPDATE\x20SET\x20value\x20=\x20excluded.value,\x20updated_at\x20=\x20excluded.updated_at\x0a\x09\x09'),c=this['db']['transaction'](d=>{for(const e of d)b['run'](e['key'],e['value']);});c(a);}async['del'](a){this['db']['prepare']('DELETE\x20FROM\x20cache\x20WHERE\x20key\x20=\x20?')['run'](a);}async['clear'](){this['db']['exec']('DELETE\x20FROM\x20cache');}}export class SQLiteAccountStorage{['_db'];['_dbSource'];constructor(a){this['_dbSource']=a;}get['db'](){if(this['_dbSource'])return this['_dbSource'];return!this['_db']&&(this['_db']=getAccountDb()),this['_db'];}async['get'](){const a=this['db']['prepare']('SELECT\x20data\x20FROM\x20accounts\x20WHERE\x20id\x20=\x201')['get']();return a?.['data'];}async['put'](a){this['db']['prepare']('\x0a\x09\x09\x09INSERT\x20INTO\x20accounts\x20(id,\x20data,\x20updated_at)\x20\x0a\x09\x09\x09VALUES\x20(1,\x20?,\x20strftime(\x27%s\x27,\x20\x27now\x27))\x0a\x09\x09\x09ON\x20CONFLICT(id)\x20DO\x20UPDATE\x20SET\x20data\x20=\x20excluded.data,\x20updated_at\x20=\x20excluded.updated_at\x0a\x09\x09')['run'](a);}async['clear'](){this['db']['exec']('DELETE\x20FROM\x20accounts');}}export function resetAllDbConnections(){if(cacheDbInstance){try{cacheDbInstance['close']();}catch(a){}cacheDbInstance=null;}if(accountDbInstance){try{accountDbInstance['close']();}catch(b){}accountDbInstance=null;}}process['on']('exit',()=>{resetAllDbConnections();}),process['on']('SIGINT',()=>{resetAllDbConnections(),process['exit'](0x0);}),process['on']('SIGTERM',()=>{resetAllDbConnections(),process['exit'](0x0);});export function resetAllStorage(){resetAllDbConnections();}export const defaultStorage=new SQLiteStorage();export const defaultAccountStorage=new SQLiteAccountStorage();

package/dist/esm/w/local/token.d.ts

@@ -1,11 +1,8 @@
-/**
- * coin type cache
- */
 import type { ENTRYPOINT } from "../../client/network.js";
 import type { CoinMetadata } from "../../client/index.js";
 export interface TokenTypeInfo extends CoinMetadata {
     alias?: string;
-    type: string; /** type name for the token (e.g., 0x168da5bf1f48dafc111b0a488fa454aca95e0b5e::usdc::USDC) */
+    type: string;
 }
 export interface TokenDataFilter {
     alias_or_name?: string;

package/dist/esm/w/local/token.js

@@ -1,161 +1 @@
-// Copyright (c) Wowok.
-// SPDX-License-Identifier: Apache-2.0
-/**
- * coin type cache
- */
-import { SuiClient } from "../../client/index.js";
-import { getFullnodeUrl } from "../../client/network.js";
-import { GasTokenType } from "../common.js";
-import { Config } from "./config.js";
-import { Cache, CachePrefix } from "./cache.js";
-import { W_ERROR, WErrors } from "../exception.js";
-export class TokenInfo {
-    static _instance;
-    static Instance() {
-        if (!TokenInfo._instance) {
-            TokenInfo._instance = new TokenInfo();
-        }
-        return TokenInfo._instance;
-    }
-    cacheKey = [CachePrefix.token];
-    async fetch_imp(network, tokenType, alias) {
-        const client = new SuiClient({ url: getFullnodeUrl(network) });
-        const r = await client.getCoinMetadata({ coinType: tokenType });
-        if (r) {
-            return { alias: alias, type: tokenType, ...r };
-        }
-        return undefined;
-    }
-    // alice - name - symbol - tokenType
-    async fetch(tokenType, alias, network) {
-        tokenType = tokenType ?? GasTokenType;
-        const net = await Config.Instance().network_get(network);
-        const cachedData = await Cache.read([...this.cacheKey, net], async (_) => {
-            return {
-                expire: "INFINITE",
-                data: [],
-            };
-        });
-        // 检查缓存中是否已有匹配的token
-        let foundToken = cachedData?.data?.find((token) => token.type === tokenType);
-        if (!foundToken) {
-            // 如果没找到，从网络获取
-            foundToken = await this.fetch_imp(net, tokenType, alias);
-            if (!foundToken) {
-                W_ERROR(WErrors.TokenNotFoundLocally, `token type: ${tokenType}`);
-                return undefined;
-            }
-            // 将新token添加到缓存数组中
-            const updatedTokens = [...(cachedData?.data || []), foundToken];
-            // 更新缓存
-            await Cache.read([...this.cacheKey, net], async (_) => ({
-                expire: "INFINITE",
-                data: updatedTokens,
-            }), true);
-        }
-        else if (alias && foundToken.alias !== alias) {
-            // 如果找到了token但alias需要更新
-            foundToken.alias = alias;
-            // 更新缓存数组
-            const updatedTokens = cachedData?.data?.map((token) => token.type === tokenType ? foundToken : token) || [];
-            // 更新缓存
-            await Cache.read([...this.cacheKey, net], async (_) => ({
-                expire: "INFINITE",
-                data: updatedTokens,
-            }), true);
-        }
-        return foundToken;
-    }
-    async list(filter, network) {
-        const net = await Config.Instance().network_get(network);
-        let cachedData = await Cache.read([...this.cacheKey, net], async (_) => {
-            return {
-                expire: "INFINITE",
-                data: [],
-            };
-        });
-        let tokens = cachedData?.data || [];
-        // 确定要查询的 token type：优先使用 filter.type，否则默认 GasTokenType
-        const targetType = filter?.type ?? GasTokenType;
-        // 如果本地没有找到该 type，从网络获取
-        // 只在指定了 type 时，才用 alias_or_name 作为 alias
-        const alias = filter?.type ? filter?.alias_or_name : undefined;
-        const foundByType = tokens.find((t) => t.type === targetType);
-        if (!foundByType) {
-            const fetched = await this.fetch_imp(net, targetType, alias);
-            if (fetched) {
-                // 更新缓存
-                const updatedTokens = [...tokens, fetched];
-                await Cache.read([...this.cacheKey, net], async (_) => ({
-                    expire: "INFINITE",
-                    data: updatedTokens,
-                }), true);
-                // 重新读取缓存
-                cachedData = await Cache.read([...this.cacheKey, net], async (_) => ({
-                    expire: "INFINITE",
-                    data: updatedTokens,
-                }));
-                tokens = cachedData?.data || [];
-            }
-        }
-        if (filter) {
-            tokens = tokens.filter((token) => {
-                let match = true;
-                // 检查symbol条件
-                if (filter.symbol && match) {
-                    match = token.symbol === filter.symbol;
-                }
-                // 检查tokenType条件（使用 targetType，支持默认 GasTokenType）
-                if (filter.type && match) {
-                    match = token.type === targetType;
-                }
-                return match;
-            });
-            // 对alias_or_name进行模糊搜索并排序
-            if (filter.alias_or_name) {
-                const searchTerm = filter.alias_or_name.toLowerCase();
-                // 添加匹配分数
-                tokens = tokens.map((token) => {
-                    let score = 0;
-                    const alias = token.alias?.toLowerCase() || "";
-                    const name = token.name?.toLowerCase() || "";
-                    // 完全匹配得分最高
-                    if (alias === searchTerm || name === searchTerm) {
-                        score = 3;
-                    }
-                    // 以搜索词开头得分次之
-                    else if (alias.startsWith(searchTerm) ||
-                        name.startsWith(searchTerm)) {
-                        score = 2;
-                    }
-                    // 包含搜索词得分最低
-                    else if (alias.includes(searchTerm) ||
-                        name.includes(searchTerm)) {
-                        score = 1;
-                    }
-                    return { ...token, _score: score };
-                });
-                // 过滤掉没有匹配的结果并按分数排序
-                tokens = tokens
-                    .filter((token) => token._score > 0)
-                    .sort((a, b) => {
-                    // 按匹配分数降序排序
-                    const scoreDiff = b._score - a._score;
-                    if (scoreDiff !== 0)
-                        return scoreDiff;
-                    // 分数相同时，按名称长度升序排序
-                    const aNameLength = (a.alias?.length || 0) + (a.name?.length || 0);
-                    const bNameLength = (b.alias?.length || 0) + (b.name?.length || 0);
-                    return aNameLength - bNameLength;
-                });
-                // 移除临时的_score属性
-                tokens = tokens.map((token) => {
-                    const { _score, ...rest } = token;
-                    return rest;
-                });
-            }
-        }
-        return tokens;
-    }
-}
-//# sourceMappingURL=token.js.map
+import{SuiClient}from'../../client/index.js';import{getFullnodeUrl}from'../../client/network.js';import{GasTokenType}from'../common.js';import{Config}from'./config.js';import{Cache,CachePrefix}from'./cache.js';import{W_ERROR,WErrors}from'../exception.js';export class TokenInfo{static ['_instance'];static['Instance'](){return!TokenInfo['_instance']&&(TokenInfo['_instance']=new TokenInfo()),TokenInfo['_instance'];}['cacheKey']=[CachePrefix['token']];async['fetch_imp'](a,b,c){const d=new SuiClient({'url':getFullnodeUrl(a)}),e=await d['getCoinMetadata']({'coinType':b});if(e)return{'alias':c,'type':b,...e};return undefined;}async['fetch'](a,b,c){a=a??GasTokenType;const d=await Config['Instance']()['network_get'](c),e=await Cache['read']([...this['cacheKey'],d],async g=>{return{'expire':'INFINITE','data':[]};});let f=e?.['data']?.['find'](g=>g['type']===a);if(!f){f=await this['fetch_imp'](d,a,b);if(!f)return W_ERROR(WErrors['TokenNotFoundLocally'],'token\x20type:\x20'+a),undefined;const g=[...e?.['data']||[],f];await Cache['read']([...this['cacheKey'],d],async h=>({'expire':'INFINITE','data':g}),!![]);}else{if(b&&f['alias']!==b){f['alias']=b;const h=e?.['data']?.['map'](i=>i['type']===a?f:i)||[];await Cache['read']([...this['cacheKey'],d],async i=>({'expire':'INFINITE','data':h}),!![]);}}return f;}async['list'](a,b){const c=await Config['Instance']()['network_get'](b);let d=await Cache['read']([...this['cacheKey'],c],async i=>{return{'expire':'INFINITE','data':[]};}),e=d?.['data']||[];const f=a?.['type']??GasTokenType,g=a?.['type']?a?.['alias_or_name']:undefined,h=e['find'](i=>i['type']===f);if(!h){const i=await this['fetch_imp'](c,f,g);if(i){const j=[...e,i];await Cache['read']([...this['cacheKey'],c],async k=>({'expire':'INFINITE','data':j}),!![]),d=await Cache['read']([...this['cacheKey'],c],async k=>({'expire':'INFINITE','data':j})),e=d?.['data']||[];}}if(a){e=e['filter'](k=>{let l=!![];return a['symbol']&&l&&(l=k['symbol']===a['symbol']),a['type']&&l&&(l=k['type']===f),l;});if(a['alias_or_name']){const k=a['alias_or_name']['toLowerCase']();e=e['map'](l=>{let m=0x0;const n=l['alias']?.['toLowerCase']()||'',o=l['name']?.['toLowerCase']()||'';if(n===k||o===k)m=0x3;else{if(n['startsWith'](k)||o['startsWith'](k))m=0x2;else(n['includes'](k)||o['includes'](k))&&(m=0x1);}return{...l,'_score':m};}),e=e['filter'](l=>l['_score']>0x0)['sort']((l,m)=>{const n=m['_score']-l['_score'];if(n!==0x0)return n;const o=(l['alias']?.['length']||0x0)+(l['name']?.['length']||0x0),p=(m['alias']?.['length']||0x0)+(m['name']?.['length']||0x0);return o-p;}),e=e['map'](l=>{const {_score:m,...n}=l;return n;});}}return e;}}

package/dist/esm/w/local/util.d.ts

@@ -1,5 +1 @@
-/**
- * 获取跨平台的 .wow 目录路径
- * 支持通过 WOWOK_DATA_DIR 环境变量覆盖默认路径（主要用于测试隔离）
- */
 export declare function getWowDir(): string;

package/dist/esm/w/local/util.js

@@ -1,50 +1 @@
-// Copyright (c) Wowok.
-// SPDX-License-Identifier: Apache-2.0
-/**
- * 获取跨平台的 .wow 目录路径
- * - Windows: %USERPROFILE%\.wow
- * - macOS: ~/Library/Application Support/.wow
- * - Linux: ~/.config/.wow 或 ~/.local/share/.wow (遵循 XDG 规范)
- *
- * 用于存储 wowok SDK 的数据库文件和配置文件
- */
-// ================================================
-// 跨平台 .wow 目录路径获取
-// ================================================
-import * as path from "path";
-import * as os from "os";
-/**
- * 获取跨平台的 .wow 目录路径
- * 支持通过 WOWOK_DATA_DIR 环境变量覆盖默认路径（主要用于测试隔离）
- */
-export function getWowDir() {
-    // 优先使用环境变量指定的路径（用于测试隔离）
-    if (process.env.WOWOK_DATA_DIR) {
-        return process.env.WOWOK_DATA_DIR;
-    }
-    const home = os.homedir();
-    const platform = os.platform();
-    if (platform === "win32") {
-        // Windows: 使用用户主目录下的 .wow
-        return path.join(home, ".wow");
-    }
-    else if (platform === "darwin") {
-        // macOS: 使用 ~/Library/Application Support/.wow
-        return path.join(home, "Library", "Application Support", ".wow");
-    }
-    else {
-        // Linux 和其他系统: 使用 XDG 规范，优先使用 ~/.config/.wow
-        const xdgConfig = process.env.XDG_CONFIG_HOME;
-        if (xdgConfig) {
-            return path.join(xdgConfig, ".wow");
-        }
-        // 回退到 ~/.local/share/.wow
-        const xdgData = process.env.XDG_DATA_HOME;
-        if (xdgData) {
-            return path.join(xdgData, ".wow");
-        }
-        // 最后回退到 ~/.wow
-        return path.join(home, ".wow");
-    }
-}
-//# sourceMappingURL=util.js.map
+import*as a177a from'path';import*as a177b from'os';export function getWowDir(){if(process['env']['WOWOK_DATA_DIR'])return process['env']['WOWOK_DATA_DIR'];const a=a177b['homedir'](),b=a177b['platform']();if(b==='win32')return a177a['join'](a,'.wow');else{if(b==='darwin')return a177a['join'](a,'Library','Application\x20Support','.wow');else{const c=process['env']['XDG_CONFIG_HOME'];if(c)return a177a['join'](c,'.wow');const d=process['env']['XDG_DATA_HOME'];if(d)return a177a['join'](d,'.wow');return a177a['join'](a,'.wow');}}}

package/dist/esm/w/local/wip.d.ts

@@ -56,15 +56,6 @@ export interface WipLimits {
     maxImageCount: number;
     maxTextLength: number;
 }
-/**
- * 默认限制配置
- *
- * 设计考虑:
- * - maxImageSize: 2MB - 单张图片限制，确保 Base64 编码后不会过大
- * - maxTotalSize: 10MB - 整个 WIP 文件大小限制，适合网络传输
- * - maxImageCount: 10 - 最多10张图片，满足大多数承诺场景
- * - maxTextLength: 10000 - 文字内容长度限制，约5000个汉字
- */
 export declare const DEFAULT_LIMITS: WipLimits;
 export declare class WipError extends Error {
     constructor(message: string);
@@ -79,21 +70,9 @@ export declare class WIP {
     private limits;
     private resourceLoader;
     constructor(limits?: Partial<WipLimits>);
-    /**
-     * 创建 WIP 文件
-     */
     create(options: WipCreateOptions): Promise<WipFile>;
-    /**
-     * 处理图片源
-     */
     private processImage;
-    /**
-     * 签名（真实实现）
-     */
     private sign;
-    /**
-     * 验证 WIP 文件（私有方法，内部使用）
-     */
     verify(wipFile: WipFile): Promise<{
         valid: boolean;
         error?: string;
@@ -102,50 +81,18 @@ export declare class WIP {
             valid: boolean;
         }[];
     }>;
-    /**
-     * 验证签名
-     */
     private verifySignature;
-    /**
-     * 转换为 HTML
-     */
     toHtml(wipFile: WipFile, options?: {
         title?: string;
         theme?: "light" | "dark";
     }): Promise<string>;
-    /**
-     * 序列化为 JSON
-     */
     stringify(wipFile: WipFile, pretty?: boolean): string;
-    /**
-     * 从 JSON 解析
-     */
     parse(jsonString: string): WipFile;
-    /**
-     * 从 URL 或本地路径加载 WIP 文件
-     */
     load(source: string): Promise<WipFile>;
-    /**
-     * 获取 WIP 文件的哈希值（用于 Service 销售）
-     * @param wipFile WIP 文件
-     * @returns 纯哈希值（不含 sha256: 前缀）
-     */
     getHash(wipFile: WipFile): string;
-    /**
-     * 提取图片
-     */
     extractImages(wipFile: WipFile, outputDir: string): string[];
-    /**
-     * 保存到文件
-     */
     save(wipFile: WipFile, filePath: string, pretty?: boolean): void;
-    /**
-     * 获取限制配置
-     */
     getLimits(): WipLimits;
-    /**
-     * 更新限制配置
-     */
     setLimits(limits: Partial<WipLimits>): void;
 }
 export declare function createWip(options: WipCreateOptions, limits?: Partial<WipLimits>): Promise<WipFile>;
@@ -181,47 +128,8 @@ export interface WipToHtmlOptions {
     theme?: "light" | "dark";
     outputPath?: string;
 }
-/**
- * 生成 WIP 文件并保存到指定路径
- *
- * @param options 生成选项
- * @param outputPath 输出文件路径
- * @param limits 可选的限制配置
- * @returns 生成的 WIP 文件路径
- */
 export declare function generate_wip(options: WipGenerationOptions, outputPath: string): Promise<string>;
-/**
- * 验证 WIP 文件
- * 验证内容包括：
- * 1. 基本结构验证
- * 2. 哈希值验证（内容完整性）
- * 3. 数字签名验证（如果存在）
- * 4. 可选：要求必须有签名
- *
- * @param wipFilePath WIP 文件路径（支持本地文件和网络 URL）
- * @param hash_equal 可选的预期哈希值，用于验证文件哈希是否匹配
- * @param requireSignature 可选的标志，如果为 true，则文件必须有签名
- * @returns 验证结果，包含哈希验证和签名验证状态
- */
 export declare function verify_wip(wipFilePath: string, hash_equal?: string, requireSignature?: boolean): Promise<WipVerificationResult>;
-/**
- * 对 WIP 文件进行签名
- *
- * 该函数会加载 WIP 文件、验证格式、使用 Account 添加数字签名并保存。
- * 支持多签名，如果文件已有签名，新签名会追加到签名列表中。
- *
- * @param wipFilePath WIP 文件路径
- * @param account 签名账号（账户名或地址）
- * @param outputPath 输出文件路径（可选，默认覆盖原文件）
- * @returns 签名后的 WIP 文件路径
- */
 export declare function sign_wip(wipFilePath: string, account: string | undefined | null, outputPath?: string): Promise<string>;
-/**
- * 将 WIP 文件或文件夹转换为 HTML
- *
- * @param wipPath WIP 文件路径或文件夹路径
- * @param options 转换选项（支持 outputPath 直接保存到文件）
- * @returns HTML 字符串、保存的文件路径，或转换的文件路径数组
- */
 export declare function wip2html(wipPath: string, options?: WipToHtmlOptions): Promise<string | string[]>;
 export default WIP;