@skillfm/local 2.6.4 → 2.7.0

package/dist/asset-connectors/namecheap.js

@@ -0,0 +1,178 @@
+// sdk/skillfm-local/src/asset-connectors/namecheap.ts
+//
+// Namecheap connector — 域名时效真实现 (Day 4 B2)
+// Doc: https://www.namecheap.com/support/api/methods/domains/get-list/
+// Endpoint: GET https://api.namecheap.com/xml.response
+// Auth: 4 个 query param + IP 白名单 (sandbox 不需 IP 白名单)
+//   ApiUser, ApiKey, UserName, ClientIp + Command=namecheap.domains.getList
+//
+// byok_key 格式: "ApiUser:ApiKey:UserName" (3 段 colon 分隔, 缺一不可)
+// ClientIp 实时从 sidecar 公网 IP 拿 (env BEACON_PUBLIC_IP 或 ifconfig.me 拉)
+import { AssetBaseConnector } from './base.js';
+import { daysUntil, classifyStatus } from './types.js';
+import { sanitizeError } from '../connectors/types.js';
+const PROD_URL = 'https://api.namecheap.com/xml.response';
+const SANDBOX_URL = 'https://api.sandbox.namecheap.com/xml.response';
+function parseKey(byok_key) {
+    const parts = byok_key.split(':');
+    if (parts.length !== 3 || parts.some((p) => !p)) {
+        throw new Error('Namecheap byok_key 格式应为 "ApiUser:ApiKey:UserName" (3 段 colon 分隔)');
+    }
+    return { api_user: parts[0], api_key: parts[1], user_name: parts[2] };
+}
+async function getPublicIp() {
+    if (process.env.BEACON_PUBLIC_IP)
+        return process.env.BEACON_PUBLIC_IP;
+    // 兜底: 拉 ifconfig.me. Day 5+ 启动时 cache 在 ~/.skillfm/local.json
+    try {
+        const r = await fetch('https://ifconfig.me/ip', { signal: AbortSignal.timeout(5000) });
+        const txt = (await r.text()).trim();
+        if (/^\d{1,3}(\.\d{1,3}){3}$/.test(txt))
+            return txt;
+    }
+    catch {
+        /* fallthrough */
+    }
+    throw new Error('Namecheap 需要 sidecar 公网 IP. 请设 BEACON_PUBLIC_IP env, ' +
+        '或确保 sidecar 能访问 ifconfig.me, 然后把该 IP 加 Namecheap dashboard 白名单');
+}
+/**
+ * 简单 XML parser (够用 Namecheap GetList response schema)
+ * <DomainGetListResult>
+ *   <Domain ID="123" Name="example.com" Expires="01/05/2027" IsExpired="false" AutoRenew="true" .../>
+ * </DomainGetListResult>
+ */
+function parseDomains(xml) {
+    const results = [];
+    // 检 error
+    const errMatch = xml.match(/<Error\s+Number="(\d+)">([^<]+)<\/Error>/);
+    if (errMatch) {
+        throw new Error(`Namecheap API error ${errMatch[1]}: ${errMatch[2]}`);
+    }
+    // 抽每个 <Domain ... /> 自闭合
+    // 用 [^>]*? 而非 [^/>]*? 因为 attribute 值可能含 "/" (如日期 "01/15/2027")
+    const domainRegex = /<Domain\s+([^>]*?)\/>/g;
+    let m;
+    while ((m = domainRegex.exec(xml)) !== null) {
+        const attrs = m[1];
+        const get = (k) => {
+            const r = new RegExp(`${k}="([^"]*)"`);
+            const a = attrs.match(r);
+            return a ? a[1] : null;
+        };
+        const name = get('Name');
+        if (!name)
+            continue;
+        const expires = get('Expires'); // "MM/DD/YYYY"
+        let expires_iso = null;
+        if (expires) {
+            const dm = expires.match(/^(\d{1,2})\/(\d{1,2})\/(\d{4})$/);
+            if (dm) {
+                const month = dm[1].padStart(2, '0');
+                const day = dm[2].padStart(2, '0');
+                expires_iso = `${dm[3]}-${month}-${day}T00:00:00Z`;
+            }
+        }
+        results.push({
+            id: get('ID') ?? '',
+            name,
+            expires_iso,
+            is_expired: get('IsExpired') === 'true',
+            auto_renew: get('AutoRenew') === 'true',
+        });
+    }
+    return results;
+}
+export class NamecheapConnector extends AssetBaseConnector {
+    id = 'namecheap';
+    name = 'Namecheap';
+    is_real = true;
+    /** sandbox 模式 (env BEACON_NAMECHEAP_SANDBOX=1) — sandbox 不需要 IP 白名单, 用于 CI 测试 */
+    getEndpoint() {
+        return process.env.BEACON_NAMECHEAP_SANDBOX === '1' ? SANDBOX_URL : PROD_URL;
+    }
+    async fetchAssets(byok_key, opts) {
+        let auth;
+        try {
+            auth = parseKey(byok_key);
+        }
+        catch (e) {
+            throw new Error(sanitizeError(e, byok_key));
+        }
+        const client_ip = await getPublicIp();
+        const params = new URLSearchParams({
+            ApiUser: auth.api_user,
+            ApiKey: auth.api_key,
+            UserName: auth.user_name,
+            ClientIp: client_ip,
+            Command: 'namecheap.domains.getList',
+            PageSize: String(Math.min(opts?.limit ?? 50, 100)), // Namecheap 最大 100/page
+            Page: '1',
+        });
+        const r = await this.safeFetch(`${this.getEndpoint()}?${params.toString()}`, { method: 'GET' }, byok_key);
+        if (!r.ok) {
+            const text = await r.text().catch(() => '');
+            throw new Error(sanitizeError(`Namecheap ${r.status}: ${text}`, byok_key));
+        }
+        const xml = await r.text();
+        const domains = parseDomains(xml);
+        const assets = [];
+        for (const d of domains) {
+            const days = daysUntil(d.expires_iso);
+            if (opts?.expiring_within_days !== undefined && days !== null && days > opts.expiring_within_days)
+                continue;
+            assets.push({
+                asset_type: 'domain',
+                identifier: d.id || d.name,
+                display_name: d.name,
+                expires_at: d.expires_iso,
+                days_left: days,
+                provider: this.id,
+                status: d.is_expired ? 'expired' : classifyStatus(days),
+                raw: { auto_renew: d.auto_renew },
+            });
+        }
+        return assets;
+    }
+    async ping(byok_key) {
+        const fp = this.fingerprint(byok_key);
+        try {
+            const auth = parseKey(byok_key);
+            const client_ip = await getPublicIp();
+            const params = new URLSearchParams({
+                ApiUser: auth.api_user,
+                ApiKey: auth.api_key,
+                UserName: auth.user_name,
+                ClientIp: client_ip,
+                Command: 'namecheap.domains.getList',
+                PageSize: '1',
+                Page: '1',
+            });
+            const r = await this.safeFetch(`${this.getEndpoint()}?${params.toString()}`, { method: 'GET' }, byok_key);
+            if (r.ok) {
+                const xml = await r.text();
+                // 校验返回是否含 IsSuccess="true"
+                if (/IsSuccess="true"/.test(xml))
+                    return { ok: true, key_fingerprint: fp };
+                const errMatch = xml.match(/<Error[^>]*>([^<]+)<\/Error>/);
+                return {
+                    ok: false,
+                    error: errMatch ? `Namecheap: ${errMatch[1]}` : 'Namecheap response not success',
+                    key_fingerprint: fp,
+                };
+            }
+            const text = await r.text().catch(() => '');
+            return {
+                ok: false,
+                error: `HTTP ${r.status}: ${sanitizeError(text, byok_key)}`,
+                key_fingerprint: fp,
+            };
+        }
+        catch (e) {
+            return { ok: false, error: sanitizeError(e, byok_key), key_fingerprint: fp };
+        }
+    }
+}
+// 暴露 parseDomains 供 test 使用
+export { parseDomains as _parseDomainsForTest };
+//# sourceMappingURL=namecheap.js.map

package/dist/asset-connectors/namecheap.js.map

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

package/dist/asset-connectors/ssl-labs.d.ts

@@ -0,0 +1,22 @@
+import { AssetBaseConnector } from './base.js';
+import type { AssetExpiry, AssetProviderId, FetchAssetsOptions } from './types.js';
+export declare class SSLLabsConnector extends AssetBaseConnector {
+    id: AssetProviderId;
+    name: string;
+    is_real: boolean;
+    /**
+     * byok_key 实际是逗号分隔的域名列表 (e.g. "skillfm.ai,api.skillfm.ai")
+     * SSL Labs 不需要 auth key
+     */
+    fetchAssets(byok_key: string, opts?: FetchAssetsOptions): Promise<AssetExpiry[]>;
+    ping(_byok_key: string): Promise<{
+        ok: boolean;
+        key_fingerprint: string;
+        error?: undefined;
+    } | {
+        ok: boolean;
+        error: string;
+        key_fingerprint?: undefined;
+    }>;
+}
+//# sourceMappingURL=ssl-labs.d.ts.map

package/dist/asset-connectors/ssl-labs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssl-labs.d.ts","sourceRoot":"","sources":["../../src/asset-connectors/ssl-labs.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAsBnF,qBAAa,gBAAiB,SAAQ,kBAAkB;IACtD,EAAE,EAAE,eAAe,CAAc;IACjC,IAAI,SAAc;IAClB,OAAO,UAAQ;IAEf;;;OAGG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgDhF,IAAI,CAAC,SAAS,EAAE,MAAM;;;;;;;;;CAS7B"}

package/dist/asset-connectors/ssl-labs.js

@@ -0,0 +1,79 @@
+// sdk/skillfm-local/src/asset-connectors/ssl-labs.ts
+//
+// SSL Labs connector — SSL 证书强度 + 到期分析 (Day 2 真实现)
+// Doc: https://github.com/ssllabs/ssllabs-scan/blob/master/ssllabs-api-docs-v3.md
+// Endpoint: GET /api/v3/analyze?host=<domain>
+// Auth: 无 (SSL Labs 公开 API, 但有 rate limit ~25 scans/sec/IP)
+//
+// 用户在 ~/.skillfm/local.json (或 dashboard) 配置要监控的域名列表,
+// 此 connector 不需要 BYOK key — fetchAssets 的第一参 byok_key 实际是逗号分隔的域名列表。
+import { AssetBaseConnector } from './base.js';
+import { daysUntil, classifyStatus } from './types.js';
+const BASE_URL = 'https://api.ssllabs.com/api/v3';
+export class SSLLabsConnector extends AssetBaseConnector {
+    id = 'ssl_labs';
+    name = 'SSL Labs';
+    is_real = true;
+    /**
+     * byok_key 实际是逗号分隔的域名列表 (e.g. "skillfm.ai,api.skillfm.ai")
+     * SSL Labs 不需要 auth key
+     */
+    async fetchAssets(byok_key, opts) {
+        const domains = (byok_key || '').split(',').map((s) => s.trim()).filter(Boolean);
+        const assets = [];
+        for (const host of domains.slice(0, opts?.limit ?? 10)) {
+            try {
+                // fromCache=on + maxAge=24 节省真扫描
+                const r = await this.safeFetch(`${BASE_URL}/analyze?host=${encodeURIComponent(host)}&fromCache=on&maxAge=24`, { method: 'GET', headers: { accept: 'application/json' } }, byok_key);
+                if (!r.ok)
+                    continue;
+                const data = (await r.json());
+                if (data.status !== 'READY') {
+                    assets.push({
+                        asset_type: 'ssl',
+                        identifier: host,
+                        display_name: host,
+                        expires_at: null,
+                        days_left: null,
+                        provider: this.id,
+                        status: data.status === 'IN_PROGRESS' ? 'scanning' : 'error',
+                    });
+                    continue;
+                }
+                const cert = data.endpoints?.[0]?.details?.cert ?? data.certs?.[0];
+                if (!cert)
+                    continue;
+                const expires_at = new Date(cert.notAfter).toISOString();
+                const days = daysUntil(expires_at);
+                if (opts?.expiring_within_days !== undefined && days !== null && days > opts.expiring_within_days)
+                    continue;
+                assets.push({
+                    asset_type: 'ssl',
+                    identifier: host,
+                    display_name: host,
+                    expires_at,
+                    days_left: days,
+                    provider: this.id,
+                    status: classifyStatus(days),
+                    raw: { sig_alg: cert.sigAlg, grade: data.endpoints?.[0]?.grade },
+                });
+            }
+            catch {
+                // 单域名扫描失败不影响其他
+            }
+        }
+        return assets;
+    }
+    async ping(_byok_key) {
+        try {
+            const r = await this.safeFetch(`${BASE_URL}/info`, { method: 'GET' }, '');
+            if (r.ok)
+                return { ok: true, key_fingerprint: 'no-auth' };
+            return { ok: false, error: `HTTP ${r.status}` };
+        }
+        catch (e) {
+            return { ok: false, error: e instanceof Error ? e.message : String(e) };
+        }
+    }
+}
+//# sourceMappingURL=ssl-labs.js.map

package/dist/asset-connectors/ssl-labs.js.map

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

package/dist/asset-connectors/tencent-cvm.d.ts

@@ -0,0 +1,18 @@
+import { AssetBaseConnector } from './base.js';
+import type { AssetExpiry, AssetProviderId, FetchAssetsOptions } from './types.js';
+export declare class TencentCVMConnector extends AssetBaseConnector {
+    id: AssetProviderId;
+    name: string;
+    is_real: boolean;
+    fetchAssets(byok_key: string, opts?: FetchAssetsOptions): Promise<AssetExpiry[]>;
+    ping(byok_key: string): Promise<{
+        ok: boolean;
+        key_fingerprint: string;
+        error?: undefined;
+    } | {
+        ok: boolean;
+        error: string;
+        key_fingerprint: string;
+    }>;
+}
+//# sourceMappingURL=tencent-cvm.d.ts.map

package/dist/asset-connectors/tencent-cvm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tencent-cvm.d.ts","sourceRoot":"","sources":["../../src/asset-connectors/tencent-cvm.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAwCnF,qBAAa,mBAAoB,SAAQ,kBAAkB;IACzD,EAAE,EAAE,eAAe,CAAiB;IACpC,IAAI,SAAa;IACjB,OAAO,UAAQ;IAET,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA+FhF,IAAI,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;CAmC5B"}

package/dist/asset-connectors/tencent-cvm.js

@@ -0,0 +1,145 @@
+// sdk/skillfm-local/src/asset-connectors/tencent-cvm.ts
+//
+// 腾讯云 CVM connector — Day 4 真实现 (TC3-HMAC-SHA256)
+// Doc: https://cloud.tencent.com/document/api/213/15728 (CVM)
+//      https://cloud.tencent.com/document/api/555/30334 (DescribeAccountBalance)
+// Auth: SecretId + SecretKey + 腾讯云 TC3-HMAC-SHA256
+//
+// byok_key 格式: "<SecretId>:<SecretKey>" (colon 分隔)
+import { AssetBaseConnector } from './base.js';
+import { sanitizeError } from '../connectors/types.js';
+import { signTencentTC3 } from '../_signers/index.js';
+const CVM_HOST = 'cvm.tencentcloudapi.com';
+const BILLING_HOST = 'billing.tencentcloudapi.com';
+function splitKey(byok_key) {
+    const idx = byok_key.indexOf(':');
+    if (idx <= 0 || idx === byok_key.length - 1) {
+        throw new Error('腾讯云 byok_key 格式应为 "<SecretId>:<SecretKey>"');
+    }
+    return { ak_id: byok_key.slice(0, idx), ak_secret: byok_key.slice(idx + 1) };
+}
+export class TencentCVMConnector extends AssetBaseConnector {
+    id = 'tencent_cvm';
+    name = '腾讯云 CVM';
+    is_real = true;
+    async fetchAssets(byok_key, opts) {
+        let ak;
+        try {
+            ak = splitKey(byok_key);
+        }
+        catch (e) {
+            throw new Error(sanitizeError(e, byok_key));
+        }
+        const assets = [];
+        // 1. 账户余额 (DescribeAccountBalance, billing service)
+        try {
+            const payload = JSON.stringify({});
+            const signed = signTencentTC3({
+                method: 'POST',
+                host: BILLING_HOST,
+                path: '/',
+                query: {},
+                headers: {},
+                payload,
+                ak_id: ak.ak_id,
+                ak_secret: ak.ak_secret,
+                service: 'billing',
+                action: 'DescribeAccountBalance',
+                version: '2018-07-09',
+            });
+            const r = await this.safeFetch(`https://${BILLING_HOST}/`, { method: 'POST', headers: signed.signed_headers_with_signature, body: payload }, byok_key);
+            if (r.ok) {
+                const d = (await r.json());
+                if (d.Response?.Balance !== undefined && !d.Response.Error) {
+                    // Balance 单位 cent (分), CNY → USD ≈ /730
+                    const balance_usd = (d.Response.Balance ?? 0) / 100 / 7.3;
+                    assets.push({
+                        asset_type: 'api_credit',
+                        identifier: 'tencent-account-balance',
+                        display_name: `腾讯云账户余额 (Uin ${d.Response.Uin ?? 'unknown'})`,
+                        expires_at: null,
+                        days_left: null,
+                        provider: this.id,
+                        balance_usd,
+                        status: 'active',
+                    });
+                }
+            }
+        }
+        catch {
+            /* tolerate */
+        }
+        // 2. CVM 实例列表
+        const cvmPayload = JSON.stringify({ Limit: opts?.limit ?? 50, Offset: 0 });
+        const signed = signTencentTC3({
+            method: 'POST',
+            host: CVM_HOST,
+            path: '/',
+            query: {},
+            headers: {},
+            payload: cvmPayload,
+            ak_id: ak.ak_id,
+            ak_secret: ak.ak_secret,
+            service: 'cvm',
+            region: 'ap-shanghai',
+            action: 'DescribeInstances',
+            version: '2017-03-12',
+        });
+        const r = await this.safeFetch(`https://${CVM_HOST}/`, { method: 'POST', headers: signed.signed_headers_with_signature, body: cvmPayload }, byok_key);
+        if (!r.ok) {
+            const text = await r.text().catch(() => '');
+            throw new Error(sanitizeError(`腾讯云 CVM ${r.status}: ${text}`, byok_key));
+        }
+        const data = (await r.json());
+        if (data.Response?.Error) {
+            throw new Error(sanitizeError(`腾讯云 CVM ${data.Response.Error.Code}: ${data.Response.Error.Message}`, byok_key));
+        }
+        for (const i of data.Response?.InstanceSet ?? []) {
+            assets.push({
+                asset_type: 'vps',
+                identifier: i.InstanceId,
+                display_name: i.InstanceName || i.InstanceId,
+                expires_at: null,
+                days_left: null,
+                provider: this.id,
+                status: i.InstanceState,
+                raw: { instance_type: i.InstanceType, zone: i.Placement?.Zone, created: i.CreatedTime },
+            });
+        }
+        return assets;
+    }
+    async ping(byok_key) {
+        const fp = this.fingerprint(byok_key);
+        try {
+            const ak = splitKey(byok_key);
+            // DescribeAccountBalance 是最轻量验签
+            const payload = JSON.stringify({});
+            const signed = signTencentTC3({
+                method: 'POST',
+                host: BILLING_HOST,
+                path: '/',
+                query: {},
+                headers: {},
+                payload,
+                ak_id: ak.ak_id,
+                ak_secret: ak.ak_secret,
+                service: 'billing',
+                action: 'DescribeAccountBalance',
+                version: '2018-07-09',
+            });
+            const r = await this.safeFetch(`https://${BILLING_HOST}/`, { method: 'POST', headers: signed.signed_headers_with_signature, body: payload }, byok_key);
+            if (r.ok)
+                return { ok: true, key_fingerprint: fp };
+            const text = await r.text().catch(() => '');
+            return {
+                ok: false,
+                error: `HTTP ${r.status}: ${sanitizeError(text, byok_key)}`,
+                key_fingerprint: fp,
+            };
+        }
+        catch (e) {
+            return { ok: false, error: sanitizeError(e, byok_key), key_fingerprint: fp };
+        }
+    }
+}
+//# sourceMappingURL=tencent-cvm.js.map

package/dist/asset-connectors/tencent-cvm.js.map

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

package/dist/asset-connectors/types.d.ts

@@ -0,0 +1,45 @@
+export type AssetType = 'domain' | 'ssl' | 'vps' | 'api_credit' | 'cdn_credit';
+export type AssetProviderId = 'cloudflare' | 'godaddy' | 'namecheap' | 'ssl_labs' | 'hetzner' | 'digitalocean' | 'vultr' | 'aliyun_ecs' | 'tencent_cvm';
+export interface AssetExpiry {
+    asset_type: AssetType;
+    /** 资源标识 (domain name / cert fingerprint / vps id) */
+    identifier: string;
+    /** 显示名 (e.g. example.com / vps "web-prod-01") */
+    display_name: string;
+    /** ISO 8601 到期时间 (null = 不到期 / 未知) */
+    expires_at: string | null;
+    /** 距离到期天数 (负数 = 已过期, null = 未知) */
+    days_left: number | null;
+    /** 提供商 */
+    provider: AssetProviderId;
+    /** 余额 (VPS / API credit), 单位 USD */
+    balance_usd?: number;
+    /** 状态描述 (e.g. "active" / "expiring_soon" / "expired" / "renewed") */
+    status?: string;
+    /** 原始响应 (调试用, 生产可省) */
+    raw?: unknown;
+}
+export interface FetchAssetsOptions {
+    /** 最多返回条数 */
+    limit?: number;
+    /** 仅查询 X 天内到期的 (省 API call) */
+    expiring_within_days?: number;
+}
+export interface AssetConnector {
+    id: AssetProviderId;
+    name: string;
+    is_real: boolean;
+    /** 拉资产时效列表 — 调用瞬间 BYOK key 注入,函数 scope 结束 GC */
+    fetchAssets(byok_key: string, opts?: FetchAssetsOptions): Promise<AssetExpiry[]>;
+    /** 验 key 有效性 */
+    ping(byok_key: string): Promise<{
+        ok: boolean;
+        error?: string;
+        key_fingerprint?: string;
+    }>;
+}
+/** 计算距离到期天数 */
+export declare function daysUntil(iso: string | null): number | null;
+/** 状态归类 */
+export declare function classifyStatus(days_left: number | null): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/asset-connectors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/asset-connectors/types.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,YAAY,GAAG,YAAY,CAAC;AAE/E,MAAM,MAAM,eAAe,GAEvB,YAAY,GACZ,SAAS,GACT,WAAW,GACX,UAAU,GAEV,SAAS,GACT,cAAc,GACd,OAAO,GACP,YAAY,GACZ,aAAa,CAAC;AAElB,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,SAAS,CAAC;IACtB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,mCAAmC;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU;IACV,QAAQ,EAAE,eAAe,CAAC;IAC1B,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,eAAe,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACjF,gBAAgB;IAChB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5F;AAED,eAAe;AACf,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAK3D;AAED,WAAW;AACX,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAM/D"}

package/dist/asset-connectors/types.js

@@ -0,0 +1,26 @@
+// sdk/skillfm-local/src/asset-connectors/types.ts
+//
+// 数字资产时效 connector 共享类型 (Day 2 D2-2)
+// 跟 LLM connectors 区分 — 这里关注 "expiry / balance" 不是 "token usage"
+/** 计算距离到期天数 */
+export function daysUntil(iso) {
+    if (!iso)
+        return null;
+    const t = new Date(iso).getTime();
+    if (isNaN(t))
+        return null;
+    return Math.floor((t - Date.now()) / 86400000);
+}
+/** 状态归类 */
+export function classifyStatus(days_left) {
+    if (days_left === null)
+        return 'unknown';
+    if (days_left < 0)
+        return 'expired';
+    if (days_left <= 7)
+        return 'expiring_soon';
+    if (days_left <= 30)
+        return 'expiring_in_month';
+    return 'active';
+}
+//# sourceMappingURL=types.js.map

package/dist/asset-connectors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/asset-connectors/types.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,qCAAqC;AACrC,iEAAiE;AAsDjE,eAAe;AACf,MAAM,UAAU,SAAS,CAAC,GAAkB;IAC1C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IAClC,IAAI,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED,WAAW;AACX,MAAM,UAAU,cAAc,CAAC,SAAwB;IACrD,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACpC,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,eAAe,CAAC;IAC3C,IAAI,SAAS,IAAI,EAAE;QAAE,OAAO,mBAAmB,CAAC;IAChD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/asset-connectors/vultr.d.ts

@@ -0,0 +1,18 @@
+import { AssetBaseConnector } from './base.js';
+import type { AssetExpiry, AssetProviderId, FetchAssetsOptions } from './types.js';
+export declare class VultrConnector extends AssetBaseConnector {
+    id: AssetProviderId;
+    name: string;
+    is_real: boolean;
+    fetchAssets(byok_key: string, opts?: FetchAssetsOptions): Promise<AssetExpiry[]>;
+    ping(byok_key: string): Promise<{
+        ok: boolean;
+        key_fingerprint: string;
+        error?: undefined;
+    } | {
+        ok: boolean;
+        error: string;
+        key_fingerprint: string;
+    }>;
+}
+//# sourceMappingURL=vultr.d.ts.map

package/dist/asset-connectors/vultr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vultr.d.ts","sourceRoot":"","sources":["../../src/asset-connectors/vultr.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA+BnF,qBAAa,cAAe,SAAQ,kBAAkB;IACpD,EAAE,EAAE,eAAe,CAAW;IAC9B,IAAI,SAAW;IACf,OAAO,UAAQ;IAET,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAiDhF,IAAI,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;CAe5B"}