@yeying-community/web3-bs 1.0.7 → 1.0.8

package/README.md

@@ -59,6 +59,7 @@ npm install @yeying-community/web3-bs
 
 - `createWebDavClient`
 - `initWebDavStorage`（自动生成/复用 WebDAV Invocation UCAN，可自动创建应用目录）
+- `createShareLink` / `listShareLinks` / `revokeShareLink`（公开分享链接管理）
 - `initDappSession`（SIWE 登录 + WebDAV UCAN 初始化）
 - `deriveAppIdFromLocation` / `deriveAppIdFromHost`
 
@@ -97,6 +98,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/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

@@ -1435,6 +1435,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 +1626,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);