@owocow/saber-ui 0.0.5 → 0.0.6

package/dist/utils/http.d.ts

@@ -23,6 +23,29 @@ export interface HttpConfig {
     /** 加密响应头的 key，默认 `'encrypt-key'` */
     encryptHeaderKey?: string;
 }
+/** 二进制请求选项，适用于下载、导出以及文件预览。 */
+export interface BlobRequestOptions {
+    /** 请求方法，默认 GET。 */
+    method?: HttpMethod;
+    /** 非 GET 请求体；普通对象会由 ofetch 序列化为 JSON。 */
+    data?: BodyInit | Record<string, unknown>;
+    /** URL 查询参数。 */
+    params?: Record<string, unknown>;
+    /** 是否携带 Bearer Token，默认 true。 */
+    withToken?: boolean;
+    /** 附加或覆盖请求头；显式 Authorization 优先于自动注入的 Token。 */
+    headers?: HeadersInit;
+    /** 用于主动取消下载或预览请求。 */
+    signal?: AbortSignal;
+}
+/** 二进制响应，以及服务端提供的可选文件元数据。 */
+export interface BlobResponse {
+    blob: Blob;
+    /** 从 Content-Disposition 解析并去除路径片段后的文件名。 */
+    fileName?: string;
+    /** 响应 Content-Type；响应头缺失时回退到 Blob.type。 */
+    contentType?: string;
+}
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 interface RequestOptions {
     method?: HttpMethod;
@@ -39,6 +62,12 @@ interface UploadOptions {
 }
 export declare function setupHttp(config: HttpConfig): void;
 export declare function request<T = unknown>(url: string, options?: RequestOptions): Promise<T>;
+/**
+ * 请求二进制内容，但不触发浏览器下载。
+ *
+ * PDF/图片预览可直接消费返回的 blob；需要保存到本地时再调用 saveBlob()。
+ */
+export declare function requestBlob(url: string, options?: BlobRequestOptions): Promise<BlobResponse>;
 export declare const http: {
     get<T = unknown, P extends object = object>(url: string, params?: P, withToken?: boolean): Promise<ApiResponse<T>>;
     list<T = unknown, P extends object = object>(url: string, params?: P, withToken?: boolean): Promise<ListResult<T>>;
@@ -46,5 +75,8 @@ export declare const http: {
     put<T = unknown, D extends object = object>(url: string, data?: D, withToken?: boolean, encrypt?: boolean): Promise<ApiResponse<T>>;
     patch<T = unknown, D extends object = object>(url: string, data?: D, withToken?: boolean, encrypt?: boolean): Promise<ApiResponse<T>>;
     delete<T = unknown, D extends object = object>(url: string, data?: D, withToken?: boolean): Promise<ApiResponse<T>>;
+    blob(url: string, options?: BlobRequestOptions): Promise<BlobResponse>;
     upload<T = unknown>(url: string, file: File | File[], options?: UploadOptions): Promise<T>;
 };
+/** 使用临时 Object URL 将 Blob 保存到本地。 */
+export declare function saveBlob(blob: Blob, fileName: string): void;

package/dist/utils/http.mjs

@@ -1,147 +1,231 @@
 import { ofetch as H } from "ofetch";
-import { decryptBase64 as L, decryptWithAes as O, generateAesKey as R, encryptBase64 as I, encryptWithAes as K } from "./crypto.mjs";
-import { rsaDecrypt as B, rsaEncrypt as U } from "./rsa.mjs";
-import { storage as k } from "./storage.mjs";
-import { getToast as T } from "./toast.mjs";
-let $ = "", S = "", _ = "token", y = null, b = !1, P = "encrypt-key", A = null;
-function v() {
-  if (!A)
+import { decryptBase64 as O, decryptWithAes as P, generateAesKey as N, encryptBase64 as _, encryptWithAes as S } from "./crypto.mjs";
+import { rsaDecrypt as z, rsaEncrypt as G } from "./rsa.mjs";
+import { storage as U } from "./storage.mjs";
+import { getToast as b } from "./toast.mjs";
+let T = "", A = "", v = "token", m = null, R = !1, L = "encrypt-key", B = null, k = null;
+function K() {
+  if (!B)
     throw new Error("[http] 尚未初始化，请先调用 setupHttp({ baseURL, clientId, onAuthError })");
-  return A;
+  return B;
 }
-function C() {
-  return new Headers({ Clientid: S });
+function q() {
+  if (!k)
+    throw new Error("[http] 尚未初始化，请先调用 setupHttp({ baseURL, clientId, onAuthError })");
+  return k;
+}
+function I(r) {
+  const e = new Headers({ Clientid: A });
+  return new Headers(r).forEach((t, o) => e.set(o, t)), e;
 }
-function N(r) {
-  $ = r.baseURL, S = r.clientId, y = r.onAuthError, _ = r.tokenKey ?? "token", b = r.encryptEnabled ?? !1, P = r.encryptHeaderKey ?? "encrypt-key", A = H.create({
-    baseURL: $,
+function V(r) {
+  T = r.baseURL, A = r.clientId, m = r.onAuthError, v = r.tokenKey ?? "token", R = r.encryptEnabled ?? !1, L = r.encryptHeaderKey ?? "encrypt-key", B = H.create({
+    baseURL: T,
     timeout: r.timeout ?? 1e4,
-    async onResponse({ response: t }) {
-      const e = b ? t.headers.get(P) : null;
-      if (e) {
-        const c = L(String(B(e)));
-        t._data = JSON.parse(O(String(t._data), c));
-      } else if (typeof t._data == "string")
+    async onResponse({ response: e }) {
+      const t = R ? e.headers.get(L) : null;
+      if (t) {
+        const c = O(String(z(t)));
+        e._data = JSON.parse(P(String(e._data), c));
+      } else if (typeof e._data == "string")
         try {
-          t._data = JSON.parse(t._data);
+          e._data = JSON.parse(e._data);
         } catch {
         }
-      const o = t._data;
+      const o = e._data;
       if (!o) return;
-      const { code: n, msg: i } = o;
+      const { code: n, msg: a } = o;
       if (n === 200) return;
-      const p = T();
+      const l = b();
       if (n === 401) {
-        p.add({ title: i, color: "error" }), y == null || y();
+        l.add({ title: a, color: "error" }), m == null || m();
         return;
       }
       if (n === 402 || n === 403) {
-        p.add({ title: i ?? "无权限访问该资源", color: "error" });
+        l.add({ title: a ?? "无权限访问该资源", color: "error" });
         return;
       }
       if (n === 404) {
-        p.add({ title: "后端 API 不存在", color: "error" });
+        l.add({ title: "后端 API 不存在", color: "error" });
         return;
       }
-      throw p.add({ title: i ?? `请求失败，错误码：${n}`, color: "error" }), new Error(i ?? `请求失败，错误码：${n}`);
+      throw l.add({ title: a ?? `请求失败，错误码：${n}`, color: "error" }), new Error(a ?? `请求失败，错误码：${n}`);
     },
-    onResponseError({ response: t }) {
+    onResponseError({ response: e }) {
       var n;
-      const e = t.status, o = (n = t._data) == null ? void 0 : n.msg;
-      T().add({
-        title: `请求错误 ${e}${o ? `：${o}` : ""}`,
+      const t = e.status, o = (n = e._data) == null ? void 0 : n.msg;
+      b().add({
+        title: `请求错误 ${t}${o ? `：${o}` : ""}`,
         color: "error"
       });
     }
+  }), k = H.create({
+    baseURL: T,
+    timeout: r.timeout ?? 1e4
   });
 }
-function m(r, t = {}) {
-  const { method: e = "GET", data: o, params: n, withToken: i = !0, encrypt: p = !1 } = t, c = C();
-  if (i) {
-    const a = k.get(_);
-    a && c.set("Authorization", `Bearer ${a}`);
+function E(r, e = {}) {
+  const { method: t = "GET", data: o, params: n, withToken: a = !0, encrypt: l = !1 } = e, c = I();
+  if (a) {
+    const s = U.get(v);
+    s && c.set("Authorization", `Bearer ${s}`);
   }
-  let f = e !== "GET" ? o : void 0, E;
-  if (b && p && (e === "POST" || e === "PUT" || e === "PATCH") && f) {
-    const a = R();
-    c.set(P, String(U(I(a)))), f = K(typeof f == "object" ? JSON.stringify(f) : String(f), a), E = "text";
+  let u = t !== "GET" ? o : void 0, f;
+  if (R && l && (t === "POST" || t === "PUT" || t === "PATCH") && u) {
+    const s = N();
+    c.set(L, String(G(_(s)))), u = S(typeof u == "object" ? JSON.stringify(u) : String(u), s), f = "text";
   }
-  return v()(r, {
-    method: e,
+  return K()(r, {
+    method: t,
     headers: c,
-    body: f,
-    query: e === "GET" ? { ...n, _t: Date.now() } : void 0,
-    responseType: E
+    body: u,
+    query: t === "GET" ? { ...n, _t: Date.now() } : void 0,
+    responseType: f
   });
 }
-const z = {
-  get(r, t, e = !0) {
-    return m(r, { method: "GET", params: t, withToken: e });
+function $(r) {
+  var o;
+  return ((o = r.trim().replace(/^['"]|['"]$/g, "").replace(/[\r\n]/g, "").split(/[\\/]/).pop()) == null ? void 0 : o.trim()) || void 0;
+}
+function C(r) {
+  if (!r) return;
+  const e = r.match(/filename\*\s*=\s*(?:[^']*'[^']*')?([^;]+)/i);
+  if (e != null && e[1]) {
+    const o = e[1].trim().replace(/^['"]|['"]$/g, "");
+    try {
+      return $(decodeURIComponent(o));
+    } catch {
+      return $(o);
+    }
+  }
+  const t = r.match(/filename\s*=\s*(?:"([^"]*)"|([^;]*))/i);
+  return $((t == null ? void 0 : t[1]) ?? (t == null ? void 0 : t[2]) ?? "");
+}
+async function x(r, e) {
+  if (!e || !/(?:^|\/)json(?:;|$)|\+json(?:;|$)/i.test(e)) return null;
+  try {
+    const t = JSON.parse(await r.text());
+    if (!t || typeof t != "object") return null;
+    const o = t, n = typeof o.code == "number" ? o.code : void 0, a = typeof o.msg == "string" ? o.msg : void 0;
+    return n !== void 0 || a !== void 0 ? { code: n, msg: a } : null;
+  } catch {
+    return null;
+  }
+}
+function J(r, e) {
+  const t = (e == null ? void 0 : e.code) !== void 0 && e.code !== 200 ? e.code : r;
+  let o = e == null ? void 0 : e.msg;
+  throw t === 401 ? (o ?? (o = "登录状态已失效"), b().add({ title: o, color: "error" }), m == null || m(), new Error(o)) : (t === 402 || t === 403 ? o ?? (o = "无权限访问该资源") : t === 404 ? o ?? (o = "后端 API 不存在") : o ?? (o = r >= 400 ? `请求错误 ${r}` : `请求失败，错误码：${t}`), b().add({ title: o, color: "error" }), new Error(o));
+}
+async function D(r, e = {}) {
+  const { method: t = "GET", data: o, params: n, withToken: a = !0, headers: l, signal: c } = e, u = I(l);
+  if (a) {
+    const i = U.get(v);
+    i && !u.has("Authorization") && u.set("Authorization", `Bearer ${i}`);
+  }
+  let f;
+  try {
+    f = await q().raw(r, {
+      method: t,
+      headers: u,
+      body: t === "GET" ? void 0 : o,
+      query: t === "GET" ? { ...n, _t: Date.now() } : n,
+      responseType: "blob",
+      ignoreResponseError: !0,
+      signal: c
+    });
+  } catch (i) {
+    throw c != null && c.aborted || b().add({ title: "文件请求失败", color: "error" }), i;
+  }
+  const h = f._data ?? new Blob(), s = f.headers.get("content-type") || h.type || void 0, d = await x(h, s);
+  return (!f.ok || (d == null ? void 0 : d.code) !== void 0 && d.code !== 200) && J(f.status, d), {
+    blob: h,
+    fileName: C(f.headers.get("content-disposition")),
+    contentType: s
+  };
+}
+const Y = {
+  get(r, e, t = !0) {
+    return E(r, { method: "GET", params: e, withToken: t });
+  },
+  list(r, e, t = !0) {
+    return E(r, { method: "GET", params: e, withToken: t });
   },
-  list(r, t, e = !0) {
-    return m(r, { method: "GET", params: t, withToken: e });
+  post(r, e, t = !0, o = !1) {
+    return E(r, { method: "POST", data: e, withToken: t, encrypt: o });
   },
-  post(r, t, e = !0, o = !1) {
-    return m(r, { method: "POST", data: t, withToken: e, encrypt: o });
+  put(r, e, t = !0, o = !1) {
+    return E(r, { method: "PUT", data: e, withToken: t, encrypt: o });
   },
-  put(r, t, e = !0, o = !1) {
-    return m(r, { method: "PUT", data: t, withToken: e, encrypt: o });
+  patch(r, e, t = !0, o = !1) {
+    return E(r, { method: "PATCH", data: e, withToken: t, encrypt: o });
   },
-  patch(r, t, e = !0, o = !1) {
-    return m(r, { method: "PATCH", data: t, withToken: e, encrypt: o });
+  delete(r, e, t = !0) {
+    return E(r, { method: "DELETE", data: e, withToken: t });
   },
-  delete(r, t, e = !0) {
-    return m(r, { method: "DELETE", data: t, withToken: e });
+  blob(r, e = {}) {
+    return D(r, e);
   },
-  upload(r, t, e = {}) {
-    const { data: o, field: n = "file", onProgress: i, withToken: p = !0 } = e, c = new FormData();
-    (Array.isArray(t) ? t : [t]).forEach((a) => c.append(n, a)), o && Object.entries(o).forEach(([a, l]) => c.append(a, l));
-    const E = $, g = { Clientid: S };
-    if (p) {
-      const a = k.get(_);
-      a && (g.Authorization = `Bearer ${a}`);
+  upload(r, e, t = {}) {
+    const { data: o, field: n = "file", onProgress: a, withToken: l = !0 } = t, c = new FormData();
+    (Array.isArray(e) ? e : [e]).forEach((s) => c.append(n, s)), o && Object.entries(o).forEach(([s, d]) => c.append(s, d));
+    const f = T, h = { Clientid: A };
+    if (l) {
+      const s = U.get(v);
+      s && (h.Authorization = `Bearer ${s}`);
     }
-    return new Promise((a, l) => {
-      const s = new XMLHttpRequest();
-      s.open("POST", `${E}${r}`), Object.entries(g).forEach(([u, d]) => s.setRequestHeader(u, d)), i && s.upload.addEventListener("progress", (u) => {
-        u.lengthComputable && i(Math.round(u.loaded / u.total * 100));
-      }), s.addEventListener("load", () => {
-        if (s.status < 200 || s.status >= 300) {
-          T().add({ title: `请求错误 ${s.status}`, color: "error" }), l(new Error(`请求错误 ${s.status}`));
+    return new Promise((s, d) => {
+      const i = new XMLHttpRequest();
+      i.open("POST", `${f}${r}`), Object.entries(h).forEach(([y, p]) => i.setRequestHeader(y, p)), a && i.upload.addEventListener("progress", (y) => {
+        y.lengthComputable && a(Math.round(y.loaded / y.total * 100));
+      }), i.addEventListener("load", () => {
+        if (i.status < 200 || i.status >= 300) {
+          b().add({ title: `请求错误 ${i.status}`, color: "error" }), d(new Error(`请求错误 ${i.status}`));
           return;
         }
-        let u;
+        let y;
         try {
-          u = JSON.parse(s.responseText);
+          y = JSON.parse(i.responseText);
         } catch {
-          l(new Error("响应解析失败"));
+          d(new Error("响应解析失败"));
           return;
         }
-        const { code: d, msg: h } = u;
-        if (d === 200) {
-          a(u.data);
+        const { code: p, msg: w } = y;
+        if (p === 200) {
+          s(y.data);
           return;
         }
-        const w = T();
-        if (d === 401) {
-          w.add({ title: h, color: "error" }), y == null || y(), l(new Error(h ?? `鉴权失败，错误码：${d}`));
+        const g = b();
+        if (p === 401) {
+          g.add({ title: w, color: "error" }), m == null || m(), d(new Error(w ?? `鉴权失败，错误码：${p}`));
           return;
         }
-        if (d === 402 || d === 403) {
-          w.add({ title: h ?? "无权限访问该资源", color: "error" }), l(new Error(h ?? `无权限，错误码：${d}`));
+        if (p === 402 || p === 403) {
+          g.add({ title: w ?? "无权限访问该资源", color: "error" }), d(new Error(w ?? `无权限，错误码：${p}`));
           return;
         }
-        if (d === 404) {
-          w.add({ title: "后端 API 不存在", color: "error" }), l(new Error("后端 API 不存在"));
+        if (p === 404) {
+          g.add({ title: "后端 API 不存在", color: "error" }), d(new Error("后端 API 不存在"));
           return;
         }
-        w.add({ title: h ?? `上传失败，错误码：${d}`, color: "error" }), l(new Error(h ?? `上传失败，错误码：${d}`));
-      }), s.addEventListener("error", () => l(new Error("上传请求失败"))), s.send(c);
+        g.add({ title: w ?? `上传失败，错误码：${p}`, color: "error" }), d(new Error(w ?? `上传失败，错误码：${p}`));
+      }), i.addEventListener("error", () => d(new Error("上传请求失败"))), i.send(c);
     });
   }
 };
+function Z(r, e) {
+  var a, l;
+  if (typeof document > "u" || typeof ((a = globalThis.URL) == null ? void 0 : a.createObjectURL) != "function")
+    throw new Error("[saveBlob] 仅支持浏览器环境");
+  const t = $(e);
+  if (!t) throw new Error("[saveBlob] fileName 不能为空");
+  const o = globalThis.URL.createObjectURL(r), n = document.createElement("a");
+  n.href = o, n.download = t, n.rel = "noopener", n.style.display = "none", (l = document.body) == null || l.append(n), n.click(), n.remove(), setTimeout(() => globalThis.URL.revokeObjectURL(o), 4e4);
+}
 export {
-  z as http,
-  m as request,
-  N as setupHttp
+  Y as http,
+  E as request,
+  D as requestBlob,
+  Z as saveBlob,
+  V as setupHttp
 };

package/dist/utils/index.mjs

@@ -1,41 +1,43 @@
-import { canAccess as t, hasPermission as o, hasRole as s, setupPermission as p } from "./permission.mjs";
+import { canAccess as t, hasPermission as o, hasRole as s, setupPermission as a } from "./permission.mjs";
 import { formatCurrency as m } from "./format.mjs";
 import { createFilterOptions as c } from "./filter.mjs";
 import { createTreeFromList as x } from "./tree.mjs";
-import { decryptBase64 as y, decryptWithAes as d, encryptBase64 as u, encryptWithAes as h, generateAesKey as A } from "./crypto.mjs";
-import { getToast as l, setToast as P, tryGetToast as T } from "./toast.mjs";
-import { setupStorage as C, storage as F } from "./storage.mjs";
-import { rsaDecrypt as W, rsaEncrypt as j, setupRsa as k } from "./rsa.mjs";
-import { http as D, request as E, setupHttp as G } from "./http.mjs";
+import { decryptBase64 as y, decryptWithAes as d, encryptBase64 as u, encryptWithAes as l, generateAesKey as h } from "./crypto.mjs";
+import { getToast as g, setToast as B, tryGetToast as P } from "./toast.mjs";
+import { setupStorage as b, storage as q } from "./storage.mjs";
+import { rsaDecrypt as F, rsaEncrypt as R, setupRsa as W } from "./rsa.mjs";
+import { http as k, request as v, requestBlob as D, saveBlob as E, setupHttp as G } from "./http.mjs";
 import { klona as K } from "klona/json";
 import { nanoid as O } from "nanoid";
-import { addressParse as b, createAddressParser as v } from "./addressParse.mjs";
+import { addressParse as w, createAddressParser as z } from "./addressParse.mjs";
 export {
-  b as addressParse,
+  w as addressParse,
   t as canAccess,
-  v as createAddressParser,
+  z as createAddressParser,
   c as createFilterOptions,
   x as createTreeFromList,
   y as decryptBase64,
   d as decryptWithAes,
   u as encryptBase64,
-  h as encryptWithAes,
+  l as encryptWithAes,
   m as formatCurrency,
-  A as generateAesKey,
-  l as getToast,
+  h as generateAesKey,
+  g as getToast,
   o as hasPermission,
   s as hasRole,
-  D as http,
+  k as http,
   K as jsonClone,
   O as nanoid,
-  E as request,
-  W as rsaDecrypt,
-  j as rsaEncrypt,
-  P as setToast,
+  v as request,
+  D as requestBlob,
+  F as rsaDecrypt,
+  R as rsaEncrypt,
+  E as saveBlob,
+  B as setToast,
   G as setupHttp,
-  p as setupPermission,
-  k as setupRsa,
-  C as setupStorage,
-  F as storage,
-  T as tryGetToast
+  a as setupPermission,
+  W as setupRsa,
+  b as setupStorage,
+  q as storage,
+  P as tryGetToast
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owocow/saber-ui",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "Saber application foundation for Vue 3 projects built on Nuxt UI",
   "type": "module",
   "sideEffects": false,