module-develop-kit 1.2.0 → 1.2.2

package/dist/main.d.ts

@@ -2,6 +2,12 @@ import { Ref } from 'vue';
 import { supportedExtensions } from 'file-type';
 import { supportedMimeTypes } from 'file-type';
 
+/**
+ * 支持的文件 MIME 类型配置
+ * 从 file-type 库导出,可用于UI展示或额外验证
+ */
+export declare const ALLOWED_FILE_MIMES: string[];
+
 /**
  * 支持的文件类型配置
  * 基于 file-type 库的 supportedMimeTypes 动态生成
@@ -47,7 +53,7 @@ export declare const CallLogger: {
  * @param options 检测选项
  * @returns 检测结果
  */
-export declare function detectFileByExtension(file: File, _allowedExtensions: TMaybeArray<string>, options?: FileDetectionOptions): Promise<FileDetectionResult>;
+export declare function detectFileByExtension(file: File, _allowedExtensions: TMaybeArray<string>, options?: IFileDetectionOptions): Promise<IFileDetectionResult>;
 
 /**
  * 检测文件真实类型并验证 MIME 类型
@@ -57,7 +63,7 @@ export declare function detectFileByExtension(file: File, _allowedExtensions: TM
  * @param options 检测选项
  * @returns 检测结果
  */
-export declare function detectFileByMime(file: File, _allowedMimes: TMaybeArray<string>, options?: FileDetectionOptions): Promise<FileDetectionResult>;
+export declare function detectFileByMime(file: File, _allowedMimes: TMaybeArray<string>, options?: IFileDetectionOptions): Promise<IFileDetectionResult>;
 
 /**
  * 批量检测文件扩展名
@@ -67,7 +73,7 @@ export declare function detectFileByMime(file: File, _allowedMimes: TMaybeArray<
  * @param options 检测选项
  * @returns 检测结果列表
  */
-export declare function detectionFilesByExtension(files: File[], allowedExtensions: TMaybeArray<string>, options?: FileDetectionOptions): Promise<FileDetectionResult[]>;
+export declare function detectionFilesByExtension(files: File[], allowedExtensions: TMaybeArray<string>, options?: IFileDetectionOptions): Promise<IFileDetectionResult[]>;
 
 /**
  * 批量检测文件 MIME 类型
@@ -77,7 +83,7 @@ export declare function detectionFilesByExtension(files: File[], allowedExtensio
  * @param options 检测选项
  * @returns 检测结果列表
  */
-export declare function detectionFilesByMime(files: File[], allowedMimes: TMaybeArray<string>, options?: FileDetectionOptions): Promise<FileDetectionResult[]>;
+export declare function detectionFilesByMime(files: File[], allowedMimes: TMaybeArray<string>, options?: IFileDetectionOptions): Promise<IFileDetectionResult[]>;
 
 export declare enum ECallStatus {
     /**
@@ -162,40 +168,6 @@ export declare interface EventBusProps {
 
 declare type EventFnc = (...args: any) => void;
 
-export declare interface FileDetectionOptions {
-    /**
-     * 最大文件大小(字节)
-     */
-    maxSize?: number;
-}
-
-export declare interface FileDetectionResult {
-    /**
-     * 是否通过检测
-     */
-    valid: boolean;
-    /**
-     * 检测到的真实MIME类型
-     */
-    detectedMime?: string;
-    /**
-     * 检测到的文件扩展名
-     */
-    detectedExt?: string;
-    /**
-     * 错误信息
-     */
-    error?: string;
-    /**
-     * 文件声称的MIME类型(来自File对象)
-     */
-    claimedMime?: string;
-    /**
-     * MIME类型是否匹配(真实vs声称)
-     */
-    mimeMatches?: boolean;
-}
-
 /**
  * 安全的解析html内容 防止xss攻击
  * @param input 输入的html内容
@@ -305,6 +277,40 @@ export declare interface ICallOptions {
     call: string;
 }
 
+export declare interface IFileDetectionOptions {
+    /**
+     * 最大文件大小(字节)
+     */
+    maxSize?: number;
+}
+
+export declare interface IFileDetectionResult {
+    /**
+     * 是否通过检测
+     */
+    valid: boolean;
+    /**
+     * 检测到的真实MIME类型
+     */
+    detectedMime?: string;
+    /**
+     * 检测到的文件扩展名
+     */
+    detectedExt?: string;
+    /**
+     * 错误信息
+     */
+    error?: string;
+    /**
+     * 文件声称的MIME类型(来自File对象)
+     */
+    claimedMime?: string;
+    /**
+     * MIME类型是否匹配(真实vs声称)
+     */
+    mimeMatches?: boolean;
+}
+
 export declare interface IResponseDataEncryptionStep {
     data: string;
     headers: Record<EHeaderKey, string>;
@@ -327,22 +333,53 @@ export declare interface ISm4Params {
  * @param options - 配置选项
  * @returns 是否安全
  */
-export declare function isUrlSafe(url: unknown, options?: UrlSanitizeOptions): boolean;
+export declare function isUrlSafe(url: unknown, options?: IUrlSanitizeOptions): boolean;
 
 /**
  * 便捷方法: 检测是否为文档文件(基于 MIME 类型)
  */
-export declare function isValidDocument(file: File, maxSize?: number): Promise<FileDetectionResult>;
+export declare function isValidDocument(file: File, maxSize?: number): Promise<IFileDetectionResult>;
+
+/**
+ * 便捷方法: 检测是否为常规支持的文件类型(基于 MIME 类型)
+ */
+export declare function isValidFile(file: File, maxSize?: number): Promise<IFileDetectionResult>;
 
 /**
  * 便捷方法: 检测是否为图片文件(基于 MIME 类型)
  */
-export declare function isValidImage(file: File, maxSize?: number): Promise<FileDetectionResult>;
+export declare function isValidImage(file: File, maxSize?: number): Promise<IFileDetectionResult>;
 
 /**
  * 便捷方法: 检测是否为视频文件(基于 MIME 类型)
  */
-export declare function isValidVideo(file: File, maxSize?: number): Promise<FileDetectionResult>;
+export declare function isValidVideo(file: File, maxSize?: number): Promise<IFileDetectionResult>;
+
+/**
+ * URL XSS 防护工具
+ * 用于检测和拦截包含 XSS 攻击的 URL
+ */
+/**
+ * URL 消毒选项
+ */
+export declare interface IUrlSanitizeOptions {
+    /**
+     * 是否允许相对路径 URL，默认 true
+     */
+    allowRelative?: boolean;
+    /**
+     * 额外的安全协议
+     */
+    extraSafeProtocols?: string[];
+    /**
+     * 当检测到 XSS 时的替代 URL，默认 '#'
+     */
+    fallbackUrl?: string;
+    /**
+     * 是否严格模式，严格模式下只允许 http/https，默认 false
+     */
+    strictMode?: boolean;
+}
 
 /**
  * 请求数据加密
@@ -373,7 +410,7 @@ export declare function responseDataEncryption<T>(stepCb: (_headers: {
  * @param options - 配置选项
  * @returns 安全的 URL
  */
-export declare function sanitizeUrl(url: unknown, options?: UrlSanitizeOptions): string;
+export declare function sanitizeUrl(url: unknown, options?: IUrlSanitizeOptions): string;
 
 /**
  * 批量消毒 URL 列表
@@ -381,7 +418,7 @@ export declare function sanitizeUrl(url: unknown, options?: UrlSanitizeOptions):
  * @param options - 配置选项
  * @returns 消毒后的 URL 列表
  */
-export declare function sanitizeUrls(urls: string[], options?: UrlSanitizeOptions): string[];
+export declare function sanitizeUrls(urls: string[], options?: IUrlSanitizeOptions): string[];
 
 /**
  * sip code对应的的状态，优先处理 code 对应的提示文案，如果不存在则按照 causes 状态去处理
@@ -459,32 +496,6 @@ export declare type TObj<K extends keyof any = string, T = any> = Record<K, T>;
 
 export declare type TUndefinable<T> = T | undefined;
 
-/**
- * URL XSS 防护工具
- * 用于检测和拦截包含 XSS 攻击的 URL
- */
-/**
- * URL 消毒选项
- */
-export declare interface UrlSanitizeOptions {
-    /**
-     * 是否允许相对路径 URL，默认 true
-     */
-    allowRelative?: boolean;
-    /**
-     * 额外的安全协议
-     */
-    extraSafeProtocols?: string[];
-    /**
-     * 当检测到 XSS 时的替代 URL，默认 '#'
-     */
-    fallbackUrl?: string;
-    /**
-     * 是否严格模式，严格模式下只允许 http/https，默认 false
-     */
-    strictMode?: boolean;
-}
-
 /**
  * 打电话
  * FIXME： callBack 为什么存在？zyy 中通过 useCall 拿到的变量无法实现响应式，所以通过 callback 的方式更新外部依赖。

package/dist/main.js

@@ -1,37 +1,39 @@
 import { useCall as o } from "./src/outside-call/index.js";
-import { antiReplyAttackStrategy as i, requestDataEncryption as s, responseDataEncryption as a } from "./src/shield/crypto/index.js";
-import { ALLOWED_FILE_TYPES as p, detectFileByExtension as E, detectFileByMime as l, detectionFilesByExtension as m, detectionFilesByMime as x, isValidDocument as f, isValidImage as S, isValidVideo as d } from "./src/shield/file-detection.js";
-import { htmlSanitize as c } from "./src/shield/html-sanitize.js";
-import { startNoDebugger as _ } from "./src/shield/no-debugger.js";
-import { isUrlSafe as D, sanitizeUrl as M, sanitizeUrls as A } from "./src/shield/url-sanitize.js";
-import { EventBus as C } from "./src/utils/eventBus.js";
-import { CallLogger as I } from "./src/outside-call/utils.js";
-import { ECallStatus as L, EMIT_EVENT_NAME as R, SIP_CODE_MESSAGE as T, SIP_ERROR_CAUSES as U } from "./src/outside-call/constants.js";
-import { supportedExtensions as N, supportedMimeTypes as O } from "./vendor/file-type/source/index.js";
+import { antiReplyAttackStrategy as i, requestDataEncryption as s, responseDataEncryption as E } from "./src/shield/crypto/index.js";
+import { ALLOWED_FILE_MIMES as l, ALLOWED_FILE_TYPES as n, detectFileByExtension as p, detectFileByMime as m, detectionFilesByExtension as x, detectionFilesByMime as S, isValidDocument as d, isValidFile as f, isValidImage as _, isValidVideo as y } from "./src/shield/file-detection.js";
+import { htmlSanitize as u } from "./src/shield/html-sanitize.js";
+import { startNoDebugger as D } from "./src/shield/no-debugger.js";
+import { isUrlSafe as I, sanitizeUrl as L, sanitizeUrls as g } from "./src/shield/url-sanitize.js";
+import { EventBus as V } from "./src/utils/eventBus.js";
+import { CallLogger as C } from "./src/outside-call/utils.js";
+import { ECallStatus as R, EMIT_EVENT_NAME as T, SIP_CODE_MESSAGE as U, SIP_ERROR_CAUSES as z } from "./src/outside-call/constants.js";
+import { supportedExtensions as P, supportedMimeTypes as W } from "./vendor/file-type/source/index.js";
 export {
-  p as ALLOWED_FILE_TYPES,
-  I as CallLogger,
-  L as ECallStatus,
-  R as EMIT_EVENT_NAME,
-  C as EventBus,
-  T as SIP_CODE_MESSAGE,
-  U as SIP_ERROR_CAUSES,
+  l as ALLOWED_FILE_MIMES,
+  n as ALLOWED_FILE_TYPES,
+  C as CallLogger,
+  R as ECallStatus,
+  T as EMIT_EVENT_NAME,
+  V as EventBus,
+  U as SIP_CODE_MESSAGE,
+  z as SIP_ERROR_CAUSES,
   i as antiReplyAttackStrategy,
-  E as detectFileByExtension,
-  l as detectFileByMime,
-  m as detectionFilesByExtension,
-  x as detectionFilesByMime,
-  c as htmlSanitize,
-  D as isUrlSafe,
-  f as isValidDocument,
-  S as isValidImage,
-  d as isValidVideo,
+  p as detectFileByExtension,
+  m as detectFileByMime,
+  x as detectionFilesByExtension,
+  S as detectionFilesByMime,
+  u as htmlSanitize,
+  I as isUrlSafe,
+  d as isValidDocument,
+  f as isValidFile,
+  _ as isValidImage,
+  y as isValidVideo,
   s as requestDataEncryption,
-  a as responseDataEncryption,
-  M as sanitizeUrl,
-  A as sanitizeUrls,
-  _ as startNoDebugger,
-  N as supportedExtensions,
-  O as supportedMimeTypes,
+  E as responseDataEncryption,
+  L as sanitizeUrl,
+  g as sanitizeUrls,
+  D as startNoDebugger,
+  P as supportedExtensions,
+  W as supportedMimeTypes,
   o as useCall
 };

package/dist/src/shield/file-detection.js

@@ -1,19 +1,20 @@
-import { supportedMimeTypes as l, fileTypeFromStream as y } from "../../vendor/file-type/source/index.js";
-import { supportedExtensions as z } from "../../vendor/file-type/source/index.js";
+import { supportedMimeTypes as f, fileTypeFromStream as y } from "../../vendor/file-type/source/index.js";
+import { supportedExtensions as L } from "../../vendor/file-type/source/index.js";
 function d(e) {
   const t = /* @__PURE__ */ new Set();
-  for (const r of l)
-    r.startsWith(`${e}/`) && t.add(r);
+  for (const i of f)
+    i.startsWith(`${e}/`) && t.add(i);
   return t;
 }
-const f = {
+const l = {
   // 图片类型 - 从 supportedMimeTypes 中过滤 image/*
   image: d("image"),
   // 文档类型 - 包含常见办公文档
   document: /* @__PURE__ */ new Set([
-    ...Array.from(l).filter(
-      (e) => e.includes("pdf") || e.includes("msword") || e.includes("officedocument") || e.includes("ms-excel") || e.includes("ms-powerpoint") || e.includes("opendocument") || e === "text/plain"
-    )
+    ...Array.from(f).filter((e) => {
+      const t = e.includes("pdf") || e.includes("msword") || e.includes("officedocument") || e.includes("ms-excel") || e.includes("ms-powerpoint") || e.includes("opendocument") || e === "text/plain", i = e.includes("macroenabled");
+      return t && !i;
+    })
   ]),
   // 视频类型 - 从 supportedMimeTypes 中过滤 video/*
   video: d("video"),
@@ -21,7 +22,7 @@ const f = {
   audio: d("audio"),
   // 压缩文件
   archive: /* @__PURE__ */ new Set([
-    ...Array.from(l).filter(
+    ...Array.from(f).filter(
       (e) => e.includes("zip") || e.includes("rar") || e.includes("7z") || e.includes("tar") || e.includes("gzip") || e.includes("compress")
     )
   ]),
@@ -29,37 +30,37 @@ const f = {
   font: d("font"),
   // 模型文件
   model: d("model")
-};
-function M(e, t) {
-  return t.some((r) => {
-    const i = r.trim();
-    if (!i)
+}, M = Object.values(l).reduce((e, t) => (e.push(...Array.from(t)), e), []);
+function v(e, t) {
+  return t.some((i) => {
+    const r = i.trim();
+    if (!r)
       return !1;
-    if (i === e)
+    if (r === e)
       return !0;
-    if (i.endsWith("/*")) {
-      const n = i.slice(0, i.indexOf("/"));
+    if (r.endsWith("/*")) {
+      const n = r.slice(0, r.indexOf("/"));
       return e.startsWith(`${n}/`);
     }
     return !1;
   });
 }
 async function p(e, t) {
-  const { maxSize: r } = t;
-  if (r && e.size > r)
+  const { maxSize: i } = t;
+  if (i && e.size > i)
     return {
       valid: !1,
-      error: `上传文件大小不能超过 ${(r / 1024 / 1024).toFixed(2)}MB`,
+      error: `上传文件大小不能超过 ${(i / 1024 / 1024).toFixed(2)}MB`,
       claimedMime: e.type
     };
-  const i = await y(e.stream());
-  if (!i)
+  const r = await y(e.stream());
+  if (!r)
     return {
       valid: !1,
       error: "无法检测文件类型,可能是不支持的格式或文件已损坏",
       claimedMime: e.type
     };
-  const n = i.mime, o = i.ext, c = e.type, s = n === c;
+  const n = r.mime, o = r.ext, c = e.type, s = n === c;
   return !s && c && console.warn("文件MIME类型不匹配", {
     claimed: c,
     detected: n,
@@ -71,12 +72,12 @@ async function p(e, t) {
     mimeMatches: s
   };
 }
-async function u(e, t, r = {}) {
-  const i = await p(e, r);
-  if ("valid" in i && !i.valid)
-    return i;
-  const { detectedMime: n, detectedExt: o, claimedMime: c, mimeMatches: s } = i, m = Array.isArray(t) ? t : t.split(",");
-  return !n || !M(n, m) ? {
+async function a(e, t, i = {}) {
+  const r = await p(e, i);
+  if ("valid" in r && !r.valid)
+    return r;
+  const { detectedMime: n, detectedExt: o, claimedMime: c, mimeMatches: s } = r, m = Array.isArray(t) ? t : t.split(",");
+  return !n || !v(n, m) ? {
     valid: !1,
     error: `不支持的文件类型: ${n || "未知"}`,
     detectedMime: n,
@@ -91,12 +92,12 @@ async function u(e, t, r = {}) {
     mimeMatches: s
   };
 }
-async function v(e, t, r = {}) {
-  const i = await p(e, r);
-  if ("valid" in i && !i.valid)
-    return i;
-  const { detectedMime: n, detectedExt: o, claimedMime: c, mimeMatches: s } = i, m = Array.isArray(t) ? t : t.split(",").map((a) => a.trim());
-  return !o || !m.some((a) => o === a || `.${o}` === a) ? {
+async function A(e, t, i = {}) {
+  const r = await p(e, i);
+  if ("valid" in r && !r.valid)
+    return r;
+  const { detectedMime: n, detectedExt: o, claimedMime: c, mimeMatches: s } = r, m = Array.isArray(t) ? t : t.split(",").map((u) => u.trim());
+  return !o || !m.some((u) => o === u || `.${o}` === u) ? {
     valid: !1,
     error: `不支持的文件扩展名: .${o || "未知"}`,
     detectedMime: n,
@@ -111,33 +112,38 @@ async function v(e, t, r = {}) {
     mimeMatches: s
   };
 }
-function A(e, t, r = {}) {
-  return Promise.all(e.map((i) => u(i, t, r)));
+function x(e, t, i = {}) {
+  return Promise.all(e.map((r) => a(r, t, i)));
 }
-function g(e, t, r = {}) {
-  return Promise.all(e.map((i) => v(i, t, r)));
+function F(e, t, i = {}) {
+  return Promise.all(e.map((r) => A(r, t, i)));
 }
-function E(e, t) {
-  const r = Array.from(f.image);
-  return u(e, r, { maxSize: t });
+function g(e, t) {
+  const i = Array.from(l.image);
+  return a(e, i, { maxSize: t });
 }
 function w(e, t) {
-  const r = Array.from(f.document);
-  return u(e, r, { maxSize: t });
+  const i = Array.from(l.document);
+  return a(e, i, { maxSize: t });
+}
+function h(e, t) {
+  const i = Array.from(l.video);
+  return a(e, i, { maxSize: t });
 }
-function F(e, t) {
-  const r = Array.from(f.video);
-  return u(e, r, { maxSize: t });
+function S(e, t) {
+  return a(e, M, { maxSize: t });
 }
 export {
-  f as ALLOWED_FILE_TYPES,
-  v as detectFileByExtension,
-  u as detectFileByMime,
-  g as detectionFilesByExtension,
-  A as detectionFilesByMime,
+  M as ALLOWED_FILE_MIMES,
+  l as ALLOWED_FILE_TYPES,
+  A as detectFileByExtension,
+  a as detectFileByMime,
+  F as detectionFilesByExtension,
+  x as detectionFilesByMime,
   w as isValidDocument,
-  E as isValidImage,
-  F as isValidVideo,
-  z as supportedExtensions,
-  l as supportedMimeTypes
+  S as isValidFile,
+  g as isValidImage,
+  h as isValidVideo,
+  L as supportedExtensions,
+  f as supportedMimeTypes
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "module-develop-kit",
   "author": "Front-End team",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "type": "module",
   "description": "前端项目通用工具包",
   "module": "dist/main.js",