@yeying-community/web3-bs 1.0.7 → 1.0.10

package/README.md

@@ -21,9 +21,13 @@ npm install @yeying-community/web3-bs
 ### 1) Provider 与账户
 
 - `getProvider` / `requireProvider`
+- `watchProvider`
 - `requestAccounts` / `getAccounts` / `getPreferredAccount` / `watchAccounts`
 - `getChainId` / `getBalance`
 - `onAccountsChanged` / `onChainChanged`
+- `classifyWalletError` / `isUserRejectedWalletAction` / `isWalletReconnectError`
+
+`requestAccounts` 默认会复用同一 provider 上尚未完成的连接请求，避免用户重复点击时触发多个钱包授权弹窗。
 
 ### 2) SIWE + JWT
 
@@ -59,6 +63,7 @@ npm install @yeying-community/web3-bs
 
 - `createWebDavClient`
 - `initWebDavStorage`（自动生成/复用 WebDAV Invocation UCAN，可自动创建应用目录）
+- `createShareLink` / `listShareLinks` / `revokeShareLink`（公开分享链接管理）
 - `initDappSession`（SIWE 登录 + WebDAV UCAN 初始化）
 - `deriveAppIdFromLocation` / `deriveAppIdFromHost`
 
@@ -97,6 +102,30 @@ const webdav = await initWebDavStorage({
 await webdav.client.upload(`${webdav.appDir}/hello.txt`, 'Hello WebDAV');
 ```
 
+### WebDAV 分享链接（warehouse）
+
+```ts
+import { createWebDavClient } from '@yeying-community/web3-bs';
+
+const client = createWebDavClient({
+  baseUrl: 'http://localhost:6065',
+  token: '<JWT_OR_UCAN>',
+});
+
+// expiresValue = 0 表示长期（不过期）分享链接
+const share = await client.createShareLink({
+  path: '/apps/demo/hello.txt',
+  expiresValue: 0,
+  expiresUnit: 'day',
+});
+
+console.log(share.url);
+```
+
+分享链接权限边界（warehouse 当前实现）：
+- 使用 UCAN 且 capability 带 `app` scope（如 `app:all:<appId>`）时，`createShareLink` / `listShareLinks` 仅允许授权目录内的文件路径。
+- 使用 JWT（或未携带 UCAN `app` scope）时，不会自动套用上述目录过滤，最终范围由后端鉴权策略决定。
+
 ## Demo
 
 - 前端 Demo（双 Tab：单后端 SIWE / 多后端 UCAN+WebDAV）：

package/dist/auth/provider.d.ts

@@ -1,6 +1,12 @@
-import { Eip1193Provider, ProviderDiscoveryOptions, ProviderInfo, RequestAccountsOptions, AccountSelection, PreferredAccountOptions, WatchAccountsOptions, AccountsChangedHandler } from './types';
+import { Eip1193Provider, ProviderDiscoveryOptions, ProviderInfo, RequestAccountsOptions, AccountSelection, PreferredAccountOptions, WatchAccountsOptions, AccountsChangedHandler, WatchProviderOptions, ProviderChangedHandler, WalletErrorInfo } from './types';
 export declare function isYeYingProvider(provider?: Eip1193Provider | null, info?: ProviderInfo): boolean;
 export declare function getProvider(options?: ProviderDiscoveryOptions): Promise<Eip1193Provider | null>;
+export declare function watchProvider(handler: ProviderChangedHandler, options?: WatchProviderOptions): () => void;
+export declare function getWalletErrorMessage(error: unknown): string;
+export declare function getWalletErrorCode(error: unknown): number | null;
+export declare function classifyWalletError(error: unknown): WalletErrorInfo;
+export declare function isUserRejectedWalletAction(error: unknown): boolean;
+export declare function isWalletReconnectError(error: unknown): boolean;
 export declare function requireProvider(options?: ProviderDiscoveryOptions): Promise<Eip1193Provider>;
 export declare function requestAccounts(options?: RequestAccountsOptions): Promise<string[]>;
 export declare function getAccounts(provider?: Eip1193Provider): Promise<string[]>;

package/dist/auth/types.d.ts

@@ -16,6 +16,8 @@ export interface Eip1193Provider {
     };
     isMetaMask?: boolean;
     isYeYing?: boolean;
+    providers?: Eip1193Provider[];
+    [key: string]: unknown;
 }
 export interface ProviderInfo {
     uuid?: string;
@@ -31,8 +33,23 @@ export interface ProviderDiscoveryOptions {
     timeoutMs?: number;
     preferYeYing?: boolean;
 }
+export interface WatchProviderOptions extends ProviderDiscoveryOptions {
+    pollIntervalMs?: number;
+    maxPolls?: number;
+}
+export type ProviderChangedHandler = (payload: {
+    provider: Eip1193Provider | null;
+    present: boolean;
+}) => void;
+export type WalletErrorType = 'userRejected' | 'disconnected' | 'timeout' | 'notFound' | 'unknown';
+export type WalletErrorInfo = {
+    type: WalletErrorType;
+    code: number | null;
+    message: string;
+};
 export interface RequestAccountsOptions {
     provider?: Eip1193Provider;
+    dedupe?: boolean;
 }
 export type AccountSelection = {
     account: string | null;

package/dist/storage/webdav.d.ts

@@ -23,6 +23,40 @@ export type WebDavRequestOptions = {
     contentType?: string;
     signal?: AbortSignal;
 };
+export type WebDavShareExpiresUnit = 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year';
+export type WebDavShareItem = {
+    token: string;
+    name: string;
+    path: string;
+    url: string;
+    viewCount: number;
+    downloadCount: number;
+    expiresAt?: string;
+    createdAt?: string;
+};
+export type CreateWebDavShareLinkOptions = {
+    path: string;
+    expiresIn?: number;
+    expiresValue?: number;
+    expiresUnit?: WebDavShareExpiresUnit;
+    auth?: WebDavAuth;
+    token?: string;
+    signal?: AbortSignal;
+};
+export type WebDavShareListOptions = {
+    auth?: WebDavAuth;
+    token?: string;
+    signal?: AbortSignal;
+};
+export type WebDavShareRevokeOptions = {
+    auth?: WebDavAuth;
+    token?: string;
+    signal?: AbortSignal;
+};
+export type WebDavShareRevokeResult = {
+    message?: string;
+    revoked?: boolean;
+};
 export declare class WebDavClient {
     private baseUrl;
     private prefix;
@@ -51,5 +85,10 @@ export declare class WebDavClient {
     recoverRecycle(hash: string): Promise<unknown>;
     deleteRecycle(hash: string): Promise<unknown>;
     clearRecycle(): Promise<unknown>;
+    private requestApiJson;
+    getShareAccessUrl(token: string, fileName?: string): string;
+    createShareLink(options: CreateWebDavShareLinkOptions): Promise<WebDavShareItem>;
+    listShareLinks(options?: WebDavShareListOptions): Promise<WebDavShareItem[]>;
+    revokeShareLink(token: string, options?: WebDavShareRevokeOptions): Promise<WebDavShareRevokeResult>;
 }
 export declare function createWebDavClient(options: WebDavClientOptions): WebDavClient;

package/dist/web3-bs.esm.js

@@ -1,10 +1,46 @@
 const YEYING_RDNS = 'io.github.yeying';
 const DEFAULT_TIMEOUT = 1000;
 const DEFAULT_ACCOUNT_STORAGE_KEY = 'yeying:last_account';
+const DEFAULT_PROVIDER_POLL_INTERVAL = 100;
+const DEFAULT_PROVIDER_MAX_POLLS = 20;
+const requestAccountsInFlight = new WeakMap();
+function isProvider(value) {
+    return !!value && typeof value.request === 'function';
+}
 function getWindowEthereum() {
     if (typeof window === 'undefined')
         return null;
-    return window.ethereum || null;
+    const ethereum = window.ethereum;
+    return isProvider(ethereum) ? ethereum : null;
+}
+function getWindowProviderCandidates() {
+    if (typeof window === 'undefined')
+        return [];
+    const source = window;
+    const candidates = [];
+    const addProvider = (provider) => {
+        if (isProvider(provider) && !candidates.includes(provider)) {
+            candidates.push(provider);
+        }
+    };
+    for (const name of [
+        'ethereum',
+        'yeeying',
+        'yeying',
+        'coinbaseWallet',
+        'bitkeep',
+        'tokenpocket',
+        '__YEYING_PROVIDER__',
+    ]) {
+        addProvider(source[name]);
+    }
+    const ethereum = getWindowEthereum();
+    if (Array.isArray(ethereum?.providers)) {
+        for (const provider of ethereum.providers) {
+            addProvider(provider);
+        }
+    }
+    return candidates;
 }
 function readStoredAccount(storageKey) {
     if (typeof localStorage === 'undefined')
@@ -48,7 +84,7 @@ function isYeYingProvider(provider, info) {
 }
 function selectBestProvider(candidates, preferYeYing) {
     if (candidates.length === 0)
-        return null;
+        return selectBestWindowProvider(preferYeYing);
     if (preferYeYing) {
         const yeying = candidates.find(c => isYeYingProvider(c.provider, c.info));
         if (yeying)
@@ -56,10 +92,21 @@ function selectBestProvider(candidates, preferYeYing) {
     }
     return candidates[0].provider;
 }
+function selectBestWindowProvider(preferYeYing) {
+    const candidates = getWindowProviderCandidates();
+    if (candidates.length === 0)
+        return null;
+    if (preferYeYing) {
+        const yeying = candidates.find(provider => isYeYingProvider(provider));
+        if (yeying)
+            return yeying;
+    }
+    return candidates[0];
+}
 async function getProvider(options = {}) {
     const preferYeYing = options.preferYeYing !== false;
     const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT;
-    const windowProvider = getWindowEthereum();
+    const windowProvider = selectBestWindowProvider(preferYeYing);
     if (preferYeYing && isYeYingProvider(windowProvider)) {
         return windowProvider;
     }
@@ -92,7 +139,7 @@ async function getProvider(options = {}) {
             }
         };
         const onEthereumInitialized = () => {
-            const injected = getWindowEthereum();
+            const injected = selectBestWindowProvider(preferYeYing);
             if (preferYeYing && isYeYingProvider(injected)) {
                 safeResolve(injected);
             }
@@ -104,7 +151,7 @@ async function getProvider(options = {}) {
                 return;
             const best = selectBestProvider(discovered, preferYeYing) ||
                 windowProvider ||
-                getWindowEthereum();
+                selectBestWindowProvider(preferYeYing);
             safeResolve(best || null);
         }, timeoutMs);
         try {
@@ -118,6 +165,107 @@ async function getProvider(options = {}) {
         }
     });
 }
+function watchProvider(handler, options = {}) {
+    if (typeof window === 'undefined') {
+        handler({ provider: null, present: false });
+        return () => { };
+    }
+    const preferYeYing = options.preferYeYing !== false;
+    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_PROVIDER_POLL_INTERVAL;
+    const maxPolls = options.maxPolls ?? DEFAULT_PROVIDER_MAX_POLLS;
+    let stopped = false;
+    let lastProvider;
+    let pollCount = 0;
+    let pollTimer = null;
+    const emit = () => {
+        if (stopped)
+            return;
+        const provider = selectBestWindowProvider(preferYeYing);
+        if (provider === lastProvider)
+            return;
+        lastProvider = provider;
+        handler({ provider, present: !!provider });
+    };
+    const poll = () => {
+        if (stopped)
+            return;
+        emit();
+        pollCount += 1;
+        if (lastProvider || pollCount >= maxPolls)
+            return;
+        pollTimer = setTimeout(poll, pollIntervalMs);
+    };
+    const handleProviderReady = () => {
+        emit();
+    };
+    window.addEventListener('ethereum#initialized', handleProviderReady);
+    window.addEventListener('eip6963:announceProvider', handleProviderReady);
+    try {
+        window.dispatchEvent(new Event('eip6963:requestProvider'));
+    }
+    catch {
+        // Ignore unsupported event dispatch environments.
+    }
+    poll();
+    return () => {
+        stopped = true;
+        if (pollTimer) {
+            clearTimeout(pollTimer);
+        }
+        window.removeEventListener('ethereum#initialized', handleProviderReady);
+        window.removeEventListener('eip6963:announceProvider', handleProviderReady);
+    };
+}
+function getWalletErrorMessage(error) {
+    if (!error)
+        return '';
+    if (typeof error === 'string')
+        return error;
+    if (error instanceof Error)
+        return error.message || String(error);
+    const message = error.message;
+    if (typeof message === 'string')
+        return message;
+    return String(error);
+}
+function getWalletErrorCode(error) {
+    const code = Number(error?.code);
+    if (!Number.isNaN(code))
+        return code;
+    const causeCode = Number(error?.cause?.code);
+    if (!Number.isNaN(causeCode))
+        return causeCode;
+    return null;
+}
+function classifyWalletError(error) {
+    const code = getWalletErrorCode(error);
+    const message = getWalletErrorMessage(error);
+    const lowerMessage = message.toLowerCase();
+    if (code === 4001 || lowerMessage.includes('user rejected')) {
+        return { type: 'userRejected', code, message };
+    }
+    if (code === 4900 ||
+        lowerMessage.includes('disconnected') ||
+        lowerMessage.includes('reconnect') ||
+        lowerMessage.includes('not connected')) {
+        return { type: 'disconnected', code, message };
+    }
+    if (lowerMessage.includes('timeout')) {
+        return { type: 'timeout', code, message };
+    }
+    if (lowerMessage.includes('no injected wallet provider') ||
+        lowerMessage.includes('未检测到钱包')) {
+        return { type: 'notFound', code, message };
+    }
+    return { type: 'unknown', code, message };
+}
+function isUserRejectedWalletAction(error) {
+    return classifyWalletError(error).type === 'userRejected';
+}
+function isWalletReconnectError(error) {
+    const type = classifyWalletError(error).type;
+    return type === 'disconnected' || type === 'timeout';
+}
 async function requireProvider(options = {}) {
     const provider = await getProvider(options);
     if (!provider) {
@@ -127,10 +275,24 @@ async function requireProvider(options = {}) {
 }
 async function requestAccounts(options = {}) {
     const provider = options.provider || (await requireProvider());
-    const accounts = (await provider.request({
+    const dedupe = options.dedupe !== false;
+    if (dedupe) {
+        const pending = requestAccountsInFlight.get(provider);
+        if (pending)
+            return pending;
+    }
+    const request = provider.request({
         method: 'eth_requestAccounts',
-    }));
-    return Array.isArray(accounts) ? accounts : [];
+    }).then(accounts => (Array.isArray(accounts) ? accounts : []));
+    if (!dedupe)
+        return request;
+    requestAccountsInFlight.set(provider, request);
+    try {
+        return await request;
+    }
+    finally {
+        requestAccountsInFlight.delete(provider);
+    }
 }
 async function getAccounts(provider) {
     const p = provider || (await requireProvider());
@@ -1435,6 +1597,9 @@ function joinUrl(baseUrl, path) {
     const suffix = path.startsWith('/') ? path : `/${path}`;
     return `${base}${suffix}`;
 }
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
 function resolveAuthHeader(auth, token) {
     if (auth?.type === 'bearer') {
         return `Bearer ${auth.token}`;
@@ -1623,6 +1788,72 @@ class WebDavClient {
         }
         return await res.json();
     }
+    async requestApiJson(method, apiPath, body, options) {
+        const headers = this.buildHeaders({
+            auth: options?.auth,
+            token: options?.token,
+            contentType: body === undefined ? undefined : 'application/json',
+        });
+        const response = await this.fetcher(joinUrl(this.baseUrl, apiPath), {
+            method,
+            headers,
+            body: body === undefined ? undefined : JSON.stringify(body),
+            credentials: this.credentials,
+            signal: options?.signal,
+        });
+        if (!response.ok) {
+            throw new Error(`WebDAV ${method} ${apiPath} failed: ${response.status} ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    getShareAccessUrl(token, fileName) {
+        const normalizedToken = encodeURIComponent(String(token || '').trim());
+        if (!normalizedToken) {
+            throw new Error('Share token is required');
+        }
+        const encodedFileName = String(fileName || '').trim()
+            ? `/${encodeURIComponent(String(fileName || '').trim())}`
+            : '';
+        return joinUrl(this.baseUrl, `/api/v1/public/share/${normalizedToken}${encodedFileName}`);
+    }
+    async createShareLink(options) {
+        const normalizedPath = String(options.path || '').trim();
+        if (!normalizedPath) {
+            throw new Error('Share path is required');
+        }
+        const payload = await this.requestApiJson('POST', '/api/v1/public/share/create', {
+            path: normalizedPath,
+            expiresIn: options.expiresIn,
+            expiresValue: options.expiresValue,
+            expiresUnit: options.expiresUnit,
+        }, options);
+        if (!isRecord(payload)) {
+            throw new Error('WebDAV share create response is invalid');
+        }
+        return payload;
+    }
+    async listShareLinks(options = {}) {
+        const payload = await this.requestApiJson('GET', '/api/v1/public/share/list', undefined, options);
+        if (!isRecord(payload)) {
+            return [];
+        }
+        const items = payload.items;
+        if (!Array.isArray(items)) {
+            return [];
+        }
+        return items.filter(isRecord);
+    }
+    async revokeShareLink(token, options = {}) {
+        const normalizedToken = String(token || '').trim();
+        if (!normalizedToken) {
+            throw new Error('Share token is required');
+        }
+        const payload = await this.requestApiJson('POST', '/api/v1/public/share/revoke', { token: normalizedToken }, options);
+        if (!isRecord(payload)) {
+            return {};
+        }
+        return payload;
+    }
 }
 function createWebDavClient(options) {
     return new WebDavClient(options);
@@ -1935,5 +2166,5 @@ async function initDappSession(options) {
     return result;
 }
 
-export { WebDavClient, authCentralUcanFetch, authFetch, authUcanFetch, clearAccessToken, clearCentralSessionToken, clearUcanSession, createAndIssueCentralUcan, createCentralSession, createDelegationUcan, createInvocationUcan, createRootUcan, createUcanSession, createWebDavClient, deriveAppIdFromHost, deriveAppIdFromLocation, getAccessToken, getAccounts, getBalance, getCapabilityAction, getCapabilityResource, getCentralIssuerInfo, getCentralSessionToken, getChainId, getOrCreateUcanRoot, getPreferredAccount, getProvider, getStoredUcanRoot, getUcanSession, initDappSession, initWebDavStorage, isYeYingProvider, issueCentralUcan, loginWithChallenge, logout, normalizeAppHostnameForAppId, normalizeUcanCapabilities, normalizeUcanCapability, onAccountsChanged, onChainChanged, refreshAccessToken, requestAccounts, requireProvider, setAccessToken, setCentralSessionToken, signMessage, storeUcanRoot, watchAccounts };
+export { WebDavClient, authCentralUcanFetch, authFetch, authUcanFetch, classifyWalletError, clearAccessToken, clearCentralSessionToken, clearUcanSession, createAndIssueCentralUcan, createCentralSession, createDelegationUcan, createInvocationUcan, createRootUcan, createUcanSession, createWebDavClient, deriveAppIdFromHost, deriveAppIdFromLocation, getAccessToken, getAccounts, getBalance, getCapabilityAction, getCapabilityResource, getCentralIssuerInfo, getCentralSessionToken, getChainId, getOrCreateUcanRoot, getPreferredAccount, getProvider, getStoredUcanRoot, getUcanSession, getWalletErrorCode, getWalletErrorMessage, initDappSession, initWebDavStorage, isUserRejectedWalletAction, isWalletReconnectError, isYeYingProvider, issueCentralUcan, loginWithChallenge, logout, normalizeAppHostnameForAppId, normalizeUcanCapabilities, normalizeUcanCapability, onAccountsChanged, onChainChanged, refreshAccessToken, requestAccounts, requireProvider, setAccessToken, setCentralSessionToken, signMessage, storeUcanRoot, watchAccounts, watchProvider };
 //# sourceMappingURL=web3-bs.esm.js.map