@wzyjs/utils 0.3.32 → 0.3.36

package/dist/common/base/string.d.ts

@@ -4,6 +4,7 @@ export declare const replaceByRules: (str: string, rules: [string, string][]) =>
 export declare const replaceByVariables: (prompt: string, variables?: {
     [key: string]: string;
 }) => string;
+export declare const getSafeCallbackPath: (value: string | null, fallback: string) => string;
 export declare const getType: (value: any) => any;
 export declare const safeJsonParse: <T = any>(value: unknown, fallback: T) => T;
 export declare const isJsonObject: (str: string) => boolean;

package/dist/node/cors.d.ts

@@ -0,0 +1,14 @@
+export type CorsOptions = {
+    allowHeaders?: string[];
+    allowMethods?: string[];
+    maxAge?: string;
+};
+export declare const createCorsHeaders: (request: Request, options?: CorsOptions) => {
+    'Access-Control-Allow-Headers': string;
+    'Access-Control-Allow-Methods': string;
+    'Access-Control-Allow-Origin': string;
+    'Access-Control-Max-Age': string;
+    Vary: string;
+};
+export declare const applyCorsHeaders: (request: Request, response: Response, options?: CorsOptions) => Response;
+export declare const createCorsPreflightResponse: (request: Request, options?: CorsOptions) => Response;

package/dist/node/file/index.d.ts

@@ -1,8 +1,21 @@
+export declare const getExtFromFileName: (fileName?: string) => string;
+export declare const getExtFromMimeType: (mimeType?: string) => string;
 export declare const getMimeType: (fileName: string) => string;
+export declare const normalizeDataUrlBase64: (value: string) => {
+    base64: string;
+    mimeType?: string;
+};
+export declare const parseBase64File: (input: {
+    fileBase64: string;
+    mimeType?: string;
+}) => {
+    buffer: Buffer;
+    mimeType?: string;
+};
 export declare const replaceContentInFile: (filePath: string, targetContent: string, replacement: string) => Promise<void>;
 export declare const downloadFile: (httpUrl: string, outputPath?: string) => Promise<string>;
 /**
- * 上传文件参数
+ * 描述 processFile 支持的文件来源和对应输入内容。
  */
 export interface UploadFileParams {
     /**
@@ -23,7 +36,7 @@ export interface UploadFileParams {
     file: string | Buffer | File;
 }
 /**
- * 文件处理结果
+ * 描述 processFile 归一化后的文件元信息和内容。
  */
 export interface UploadFileResult {
     /** 文件内容 Buffer */
@@ -42,7 +55,7 @@ export interface UploadFileResult {
     ext: string;
 }
 /**
- * 处理各种类型的文件输入，将其统一转换为标准的文件信息对象
+ * 处理各种类型的文件输入，将其统一转换为标准的文件信息对象。
  *
  * @description
  * 该函数用于处理不同来源的文件（URL、本地路径、Buffer、File对象），

package/dist/node.cjs.js

@@ -5539,6 +5539,7 @@ __export(exports_node, {
   getType: () => getType,
   getStrLength: () => getStrLength,
   getSliceStr: () => getSliceStr,
+  getSafeCallbackPath: () => getSafeCallbackPath,
   getRandomString: () => getRandomString,
   getRandomColor: () => getRandomColor,
   getPublicUrl: () => getPublicUrl,
@@ -5564,6 +5565,7 @@ __export(exports_node, {
   custom: () => custom,
   cron: () => exports_cron,
   crawl: () => exports_crawl,
+  cors: () => exports_cors,
   consola: () => import_consola.default,
   coerce: () => coerce,
   cheerio: () => cheerio,
@@ -10413,6 +10415,12 @@ var replaceByVariables = (prompt, variables) => {
     return variables[p1] ?? match;
   });
 };
+var getSafeCallbackPath = (value, fallback) => {
+  if (!value || !value.startsWith("/") || value.startsWith("//")) {
+    return fallback;
+  }
+  return value;
+};
 var getType = (value) => {
   return Object.prototype.toString.call(value).slice(8, -1);
 };
@@ -10726,6 +10734,36 @@ var Timezone;
   Timezone2["EuropeBerlin"] = "Europe/Berlin";
 })(Timezone ||= {});
 var dayjs_default = import_dayjs.default;
+// src/node/cors.ts
+var exports_cors = {};
+__export(exports_cors, {
+  createCorsPreflightResponse: () => createCorsPreflightResponse,
+  createCorsHeaders: () => createCorsHeaders,
+  applyCorsHeaders: () => applyCorsHeaders
+});
+var DEFAULT_ALLOW_HEADERS = ["Authorization", "Content-Type", "X-TRPC-Source"];
+var DEFAULT_ALLOW_METHODS = ["GET", "POST", "OPTIONS"];
+var DEFAULT_MAX_AGE = "86400";
+var createCorsHeaders = (request, options = {}) => {
+  const origin = request.headers.get("origin") ?? "*";
+  return {
+    "Access-Control-Allow-Headers": (options.allowHeaders ?? DEFAULT_ALLOW_HEADERS).join(", "),
+    "Access-Control-Allow-Methods": (options.allowMethods ?? DEFAULT_ALLOW_METHODS).join(", "),
+    "Access-Control-Allow-Origin": origin,
+    "Access-Control-Max-Age": options.maxAge ?? DEFAULT_MAX_AGE,
+    Vary: "Origin"
+  };
+};
+var applyCorsHeaders = (request, response, options) => {
+  Object.entries(createCorsHeaders(request, options)).forEach(([key2, value]) => {
+    response.headers.set(key2, value);
+  });
+  return response;
+};
+var createCorsPreflightResponse = (request, options) => new Response(null, {
+  headers: createCorsHeaders(request, options),
+  status: 204
+});
 // src/node/oss/index.ts
 var exports_oss = {};
 __export(exports_oss, {
@@ -10894,7 +10932,11 @@ var exports_file = {};
 __export(exports_file, {
   replaceContentInFile: () => replaceContentInFile,
   processFile: () => processFile,
+  parseBase64File: () => parseBase64File,
+  normalizeDataUrlBase64: () => normalizeDataUrlBase64,
   getMimeType: () => getMimeType,
+  getExtFromMimeType: () => getExtFromMimeType,
+  getExtFromFileName: () => getExtFromFileName,
   downloadFile: () => downloadFile
 });
 var import_fs_extra = __toESM(require("fs-extra"));
@@ -10902,53 +10944,62 @@ var import_axios9 = __toESM(require("axios"));
 var import_url = __toESM(require("url"));
 var path2 = __toESM(require("path"));
 var import_crypto = __toESM(require("crypto"));
+var mimeExtMap = {
+  "image/png": ["png"],
+  "image/jpeg": ["jpg", "jpeg"],
+  "image/gif": ["gif"],
+  "image/webp": ["webp"],
+  "image/svg+xml": ["svg"],
+  "video/mp4": ["mp4"],
+  "audio/mpeg": ["mp3"],
+  "application/pdf": ["pdf"],
+  "application/msword": ["doc"],
+  "application/vnd.openxmlformats-officedocument.wordprocessingml.document": ["docx"],
+  "application/vnd.ms-excel": ["xls"],
+  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": ["xlsx"],
+  "application/vnd.ms-powerpoint": ["ppt"],
+  "application/vnd.openxmlformats-officedocument.presentationml.presentation": ["pptx"],
+  "text/plain": ["txt"],
+  "text/html": ["html"],
+  "text/css": ["css"],
+  "application/javascript": ["js"],
+  "application/json": ["json"],
+  "application/xml": ["xml"]
+};
+var getExtFromFileName = (fileName) => {
+  return fileName ? path2.extname(fileName).toLowerCase() : "";
+};
+var getExtFromMimeType = (mimeType) => {
+  const ext = mimeType ? mimeExtMap[mimeType]?.[0] : "";
+  return ext ? `.${ext}` : "";
+};
 var getMimeType = (fileName) => {
-  const ext = fileName.split(".").pop()?.toLowerCase();
-  switch (ext) {
-    case "png":
-      return "image/png";
-    case "jpg":
-    case "jpeg":
-      return "image/jpeg";
-    case "gif":
-      return "image/gif";
-    case "webp":
-      return "image/webp";
-    case "svg":
-      return "image/svg+xml";
-    case "mp4":
-      return "video/mp4";
-    case "mp3":
-      return "audio/mpeg";
-    case "pdf":
-      return "application/pdf";
-    case "doc":
-      return "application/msword";
-    case "docx":
-      return "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
-    case "xls":
-      return "application/vnd.ms-excel";
-    case "xlsx":
-      return "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
-    case "ppt":
-      return "application/vnd.ms-powerpoint";
-    case "pptx":
-      return "application/vnd.openxmlformats-officedocument.presentationml.presentation";
-    case "txt":
-      return "text/plain";
-    case "html":
-      return "text/html";
-    case "css":
-      return "text/css";
-    case "js":
-      return "application/javascript";
-    case "json":
-      return "application/json";
-    case "xml":
-      return "application/xml";
-    default:
-      return "application/octet-stream";
-  }
+  const ext = getExtFromFileName(fileName).replace(/^\./, "");
+  const matched = Object.entries(mimeExtMap).find(([, extensions]) => extensions.includes(ext));
+  return matched?.[0] || "application/octet-stream";
+};
+var generateUniqueFileName = (originalName = "") => {
+  const ext = path2.extname(originalName);
+  const nameWithoutExt = path2.basename(originalName, ext);
+  const finalFileName = `${nameWithoutExt ? `${nameWithoutExt}_` : ""}${Date.now()}_${Math.random().toString(36).slice(2)}${ext}`;
+  return {
+    finalFileName,
+    ext: ext.toLowerCase()
+  };
+};
+var normalizeDataUrlBase64 = (value) => {
+  const matched = value.match(/^data:([^;]+);base64,(.*)$/);
+  return {
+    base64: matched?.[2] || value,
+    mimeType: matched?.[1]
+  };
+};
+var parseBase64File = (input) => {
+  const parsed = normalizeDataUrlBase64(input.fileBase64);
+  return {
+    buffer: Buffer.from(parsed.base64, "base64"),
+    mimeType: input.mimeType || parsed.mimeType
+  };
 };
 var replaceContentInFile = async (filePath, targetContent, replacement) => {
   const data = await import_fs_extra.default.readFile(filePath, "utf8");
@@ -10962,8 +11013,8 @@ var replaceContentInFile = async (filePath, targetContent, replacement) => {
 };
 var downloadFile = async (httpUrl, outputPath) => {
   try {
-    let parsedUrl = import_url.default.parse(httpUrl);
-    let fileName = path2.basename(parsedUrl.pathname);
+    const parsedUrl = import_url.default.parse(httpUrl);
+    const fileName = path2.basename(parsedUrl.pathname);
     if (!outputPath) {
       if (!import_fs_extra.default.existsSync(".tmp")) {
         import_fs_extra.default.mkdirSync(".tmp", { recursive: true });
@@ -10987,15 +11038,6 @@ var downloadFile = async (httpUrl, outputPath) => {
     throw error;
   }
 };
-var generateUniqueFileName = (originalName = "") => {
-  const ext = path2.extname(originalName);
-  const nameWithoutExt = path2.basename(originalName, ext);
-  const finalFileName = `${nameWithoutExt ? `${nameWithoutExt}_` : ""}${Date.now()}_${Math.random().toString(36).slice(2)}${ext}`;
-  return {
-    finalFileName,
-    ext: ext.toLowerCase()
-  };
-};
 var processFile = async (params) => {
   const { file, type } = params;
   let buffer;

package/dist/node.d.ts

@@ -7,6 +7,7 @@ export { default as fs } from 'fs-extra';
 import lodash from 'lodash';
 export declare const _: lodash.LoDashStatic;
 export * from './common';
+export * as cors from './node/cors';
 export * as oss from './node/oss';
 export * as cron from './node/cron';
 export * as mail from './node/mail';

package/dist/node.esm.js

@@ -10240,6 +10240,12 @@ var replaceByVariables = (prompt, variables) => {
     return variables[p1] ?? match;
   });
 };
+var getSafeCallbackPath = (value, fallback) => {
+  if (!value || !value.startsWith("/") || value.startsWith("//")) {
+    return fallback;
+  }
+  return value;
+};
 var getType = (value) => {
   return Object.prototype.toString.call(value).slice(8, -1);
 };
@@ -10553,6 +10559,36 @@ var Timezone;
   Timezone2["EuropeBerlin"] = "Europe/Berlin";
 })(Timezone ||= {});
 var dayjs_default = dayjs;
+// src/node/cors.ts
+var exports_cors = {};
+__export(exports_cors, {
+  createCorsPreflightResponse: () => createCorsPreflightResponse,
+  createCorsHeaders: () => createCorsHeaders,
+  applyCorsHeaders: () => applyCorsHeaders
+});
+var DEFAULT_ALLOW_HEADERS = ["Authorization", "Content-Type", "X-TRPC-Source"];
+var DEFAULT_ALLOW_METHODS = ["GET", "POST", "OPTIONS"];
+var DEFAULT_MAX_AGE = "86400";
+var createCorsHeaders = (request, options = {}) => {
+  const origin = request.headers.get("origin") ?? "*";
+  return {
+    "Access-Control-Allow-Headers": (options.allowHeaders ?? DEFAULT_ALLOW_HEADERS).join(", "),
+    "Access-Control-Allow-Methods": (options.allowMethods ?? DEFAULT_ALLOW_METHODS).join(", "),
+    "Access-Control-Allow-Origin": origin,
+    "Access-Control-Max-Age": options.maxAge ?? DEFAULT_MAX_AGE,
+    Vary: "Origin"
+  };
+};
+var applyCorsHeaders = (request, response, options) => {
+  Object.entries(createCorsHeaders(request, options)).forEach(([key2, value]) => {
+    response.headers.set(key2, value);
+  });
+  return response;
+};
+var createCorsPreflightResponse = (request, options) => new Response(null, {
+  headers: createCorsHeaders(request, options),
+  status: 204
+});
 // src/node/oss/index.ts
 var exports_oss = {};
 __export(exports_oss, {
@@ -10721,7 +10757,11 @@ var exports_file = {};
 __export(exports_file, {
   replaceContentInFile: () => replaceContentInFile,
   processFile: () => processFile,
+  parseBase64File: () => parseBase64File,
+  normalizeDataUrlBase64: () => normalizeDataUrlBase64,
   getMimeType: () => getMimeType,
+  getExtFromMimeType: () => getExtFromMimeType,
+  getExtFromFileName: () => getExtFromFileName,
   downloadFile: () => downloadFile
 });
 import fs from "fs-extra";
@@ -10729,53 +10769,62 @@ import axios6 from "axios";
 import url2 from "url";
 import * as path2 from "path";
 import crypto2 from "crypto";
+var mimeExtMap = {
+  "image/png": ["png"],
+  "image/jpeg": ["jpg", "jpeg"],
+  "image/gif": ["gif"],
+  "image/webp": ["webp"],
+  "image/svg+xml": ["svg"],
+  "video/mp4": ["mp4"],
+  "audio/mpeg": ["mp3"],
+  "application/pdf": ["pdf"],
+  "application/msword": ["doc"],
+  "application/vnd.openxmlformats-officedocument.wordprocessingml.document": ["docx"],
+  "application/vnd.ms-excel": ["xls"],
+  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": ["xlsx"],
+  "application/vnd.ms-powerpoint": ["ppt"],
+  "application/vnd.openxmlformats-officedocument.presentationml.presentation": ["pptx"],
+  "text/plain": ["txt"],
+  "text/html": ["html"],
+  "text/css": ["css"],
+  "application/javascript": ["js"],
+  "application/json": ["json"],
+  "application/xml": ["xml"]
+};
+var getExtFromFileName = (fileName) => {
+  return fileName ? path2.extname(fileName).toLowerCase() : "";
+};
+var getExtFromMimeType = (mimeType) => {
+  const ext = mimeType ? mimeExtMap[mimeType]?.[0] : "";
+  return ext ? `.${ext}` : "";
+};
 var getMimeType = (fileName) => {
-  const ext = fileName.split(".").pop()?.toLowerCase();
-  switch (ext) {
-    case "png":
-      return "image/png";
-    case "jpg":
-    case "jpeg":
-      return "image/jpeg";
-    case "gif":
-      return "image/gif";
-    case "webp":
-      return "image/webp";
-    case "svg":
-      return "image/svg+xml";
-    case "mp4":
-      return "video/mp4";
-    case "mp3":
-      return "audio/mpeg";
-    case "pdf":
-      return "application/pdf";
-    case "doc":
-      return "application/msword";
-    case "docx":
-      return "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
-    case "xls":
-      return "application/vnd.ms-excel";
-    case "xlsx":
-      return "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
-    case "ppt":
-      return "application/vnd.ms-powerpoint";
-    case "pptx":
-      return "application/vnd.openxmlformats-officedocument.presentationml.presentation";
-    case "txt":
-      return "text/plain";
-    case "html":
-      return "text/html";
-    case "css":
-      return "text/css";
-    case "js":
-      return "application/javascript";
-    case "json":
-      return "application/json";
-    case "xml":
-      return "application/xml";
-    default:
-      return "application/octet-stream";
-  }
+  const ext = getExtFromFileName(fileName).replace(/^\./, "");
+  const matched = Object.entries(mimeExtMap).find(([, extensions]) => extensions.includes(ext));
+  return matched?.[0] || "application/octet-stream";
+};
+var generateUniqueFileName = (originalName = "") => {
+  const ext = path2.extname(originalName);
+  const nameWithoutExt = path2.basename(originalName, ext);
+  const finalFileName = `${nameWithoutExt ? `${nameWithoutExt}_` : ""}${Date.now()}_${Math.random().toString(36).slice(2)}${ext}`;
+  return {
+    finalFileName,
+    ext: ext.toLowerCase()
+  };
+};
+var normalizeDataUrlBase64 = (value) => {
+  const matched = value.match(/^data:([^;]+);base64,(.*)$/);
+  return {
+    base64: matched?.[2] || value,
+    mimeType: matched?.[1]
+  };
+};
+var parseBase64File = (input) => {
+  const parsed = normalizeDataUrlBase64(input.fileBase64);
+  return {
+    buffer: Buffer.from(parsed.base64, "base64"),
+    mimeType: input.mimeType || parsed.mimeType
+  };
 };
 var replaceContentInFile = async (filePath, targetContent, replacement) => {
   const data = await fs.readFile(filePath, "utf8");
@@ -10789,8 +10838,8 @@ var replaceContentInFile = async (filePath, targetContent, replacement) => {
 };
 var downloadFile = async (httpUrl, outputPath) => {
   try {
-    let parsedUrl = url2.parse(httpUrl);
-    let fileName = path2.basename(parsedUrl.pathname);
+    const parsedUrl = url2.parse(httpUrl);
+    const fileName = path2.basename(parsedUrl.pathname);
     if (!outputPath) {
       if (!fs.existsSync(".tmp")) {
         fs.mkdirSync(".tmp", { recursive: true });
@@ -10814,15 +10863,6 @@ var downloadFile = async (httpUrl, outputPath) => {
     throw error;
   }
 };
-var generateUniqueFileName = (originalName = "") => {
-  const ext = path2.extname(originalName);
-  const nameWithoutExt = path2.basename(originalName, ext);
-  const finalFileName = `${nameWithoutExt ? `${nameWithoutExt}_` : ""}${Date.now()}_${Math.random().toString(36).slice(2)}${ext}`;
-  return {
-    finalFileName,
-    ext: ext.toLowerCase()
-  };
-};
 var processFile = async (params) => {
   const { file, type } = params;
   let buffer;
@@ -11974,6 +12014,7 @@ export {
   getType,
   getStrLength,
   getSliceStr,
+  getSafeCallbackPath,
   getRandomString,
   getRandomColor,
   getPublicUrl,
@@ -11999,6 +12040,7 @@ export {
   custom,
   exports_cron as cron,
   exports_crawl as crawl,
+  exports_cors as cors,
   default4 as consola,
   coerce,
   cheerio,

package/dist/web.cjs.js

@@ -10861,6 +10861,7 @@ __export(exports_web, {
   getType: () => getType,
   getStrLength: () => getStrLength,
   getSliceStr: () => getSliceStr,
+  getSafeCallbackPath: () => getSafeCallbackPath,
   getRandomString: () => getRandomString,
   getRandomColor: () => getRandomColor,
   getPublicUrl: () => getPublicUrl,
@@ -20350,6 +20351,12 @@ var replaceByVariables = (prompt, variables) => {
     return variables[p1] ?? match;
   });
 };
+var getSafeCallbackPath = (value, fallback) => {
+  if (!value || !value.startsWith("/") || value.startsWith("//")) {
+    return fallback;
+  }
+  return value;
+};
 var getType = (value) => {
   return Object.prototype.toString.call(value).slice(8, -1);
 };

package/dist/web.esm.js

@@ -20181,6 +20181,12 @@ var replaceByVariables = (prompt, variables) => {
     return variables[p1] ?? match;
   });
 };
+var getSafeCallbackPath = (value, fallback) => {
+  if (!value || !value.startsWith("/") || value.startsWith("//")) {
+    return fallback;
+  }
+  return value;
+};
 var getType = (value) => {
   return Object.prototype.toString.call(value).slice(8, -1);
 };
@@ -20620,6 +20626,7 @@ export {
   getType,
   getStrLength,
   getSliceStr,
+  getSafeCallbackPath,
   getRandomString,
   getRandomColor,
   getPublicUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wzyjs/utils",
-  "version": "0.3.32",
+  "version": "0.3.36",
   "description": "description",
   "author": "wzy",
   "sideEffects": false,
@@ -9,7 +9,8 @@
     "build-web-cjs": "bun build ./src/web.ts --outfile dist/web.cjs.js --format cjs",
     "build-node-esm": "bun build ./src/node.ts --outfile dist/node.esm.js --format esm --target node --external nodemailer --external fs-extra --external axios --external node:* --external ali-oss --external nedb --external cheerio --external json5 --external consola --external dayjs --external node-cron --external @aws-sdk/client-s3",
     "build-node-cjs": "bun build ./src/node.ts --outfile dist/node.cjs.js --format cjs --target node --external nodemailer --external fs-extra --external axios --external node:* --external ali-oss --external nedb --external cheerio --external json5 --external consola --external dayjs --external node-cron --external @aws-sdk/client-s3",
-    "build": "rm -rf dist && bun run build-web-esm && bun run build-web-cjs && bun run build-node-esm && bun run build-node-cjs && tsc"
+    "build": "rm -rf dist && bun run build-web-esm && bun run build-web-cjs && bun run build-node-esm && bun run build-node-cjs && tsc",
+    "typecheck": "tsc --noEmit"
   },
   "files": [
     "dist"
@@ -71,7 +72,7 @@
     "@types/nodemailer": "^6.4.7",
     "@types/papaparse": "^5.3.15"
   },
-  "gitHead": "260d8290106ef447ec42375d4656af2e89675b15",
+  "gitHead": "7db0faf741993d729a9e1c0742f480f364816222",
   "publishConfig": {
     "access": "public"
   }