@nickyzj2023/utils 1.0.42 → 1.0.44

package/package.json

@@ -1,26 +1,27 @@
 {
-	"name": "@nickyzj2023/utils",
-	"version": "1.0.42",
-	"type": "module",
-	"module": "dist/index.js",
-	"types": "dist/index.d.ts",
-	"scripts": {
-		"docs": "typedoc src/index.ts --plugin typedoc-material-theme",
-		"build": "bun build --target=bun --outdir ./dist --minify ./src/index.ts && tsc && bun run docs"
-	},
-	"devDependencies": {
-		"@biomejs/biome": "^2.3.14",
-		"@types/bun": "^1.3.8",
-		"typedoc": "^0.28.16"
-	},
-	"peerDependencies": {
-		"typescript": "^5.9.3"
-	},
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/Nickyzj628/utils.git"
-	},
-	"dependencies": {
-		"typedoc-material-theme": "^1.4.1"
-	}
+  "name": "@nickyzj2023/utils",
+  "version": "1.0.44",
+  "type": "module",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "docs": "typedoc src/index.ts --plugin typedoc-material-theme",
+    "build": "bun build --target=bun --outdir ./dist --minify ./src/index.ts --packages external && tsc && bun run docs"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.14",
+    "@types/bun": "^1.3.8",
+    "typedoc": "^0.28.16"
+  },
+  "peerDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Nickyzj628/utils.git"
+  },
+  "dependencies": {
+    "sharp": "^0.34.5",
+    "typedoc-material-theme": "^1.4.1"
+  }
 }

package/src/network.ts

@@ -125,3 +125,20 @@ export const to = async <T, E = Error>(
 		return [e as E, undefined];
 	}
 };
+
+/** 从 url 响应头获取真实链接 */
+export const getRealURL = async (originURL: string) => {
+	const [error, response] = await to(
+		fetch(originURL, {
+			method: "HEAD", // 用 HEAD 减少数据传输
+			redirect: "manual", // 手动处理重定向
+		}),
+	);
+
+	if (error) {
+		return originURL;
+	}
+
+	const location = response.headers.get("location");
+	return location || originURL;
+};

package/src/string.ts

@@ -1,3 +1,4 @@
+import sharp from "sharp";
 import { fetcher } from "./network";
 
 export type SnakeToCamel<S extends string> =
@@ -75,25 +76,46 @@ export const decapitalize = <S extends string>(s: S): Decapitalize<S> => {
 /**
  * 图片地址转 base64 数据
  *
+ * @param imageUrl 图片地址
+ * @param options 可选配置
+ * @param options.quality 压缩比率，默认 0.92
+ *
+ * @example
+ * imageUrlToBase64("https://example.com/image.gif"); // "data:image/gif;base64,..."
+ *
  * @example
- * imageUrlToBase64("https://example.com/image.jpg"); // "data:image/jpeg;base64,..."
+ * imageUrlToBase64("https://example.com/image.jpg", { quality: 0.8 }); // 压缩至 80% 质量
  */
-export const imageUrlToBase64 = async (imageUrl: string) => {
+export const imageUrlToBase64 = async (
+	imageUrl: string,
+	{ quality = 0.92 }: { quality?: number } = {},
+) => {
 	if (!imageUrl.startsWith("http")) {
 		throw new Error("图片地址必须以http或https开头");
 	}
 
 	let mime = "";
 	const response = await fetcher().get<ArrayBuffer>(imageUrl, {
-		parser: (response) => {
+		parser: async (response) => {
 			mime = response.headers.get("Content-Type") || "image/jpeg";
 			return response.arrayBuffer();
 		},
 	});
+
 	const buffer = Buffer.from(response);
+	let compressedBuffer: Buffer;
+
+	if (mime === "image/png") {
+		compressedBuffer = await sharp(buffer)
+			.png({ compressionLevel: Math.round(quality * 9) })
+			.toBuffer();
+	} else if (mime === "image/gif") {
+		compressedBuffer = await sharp(buffer).gif().toBuffer();
+	} else {
+		compressedBuffer = await sharp(buffer).jpeg({ quality }).toBuffer();
+	}
 
-	const base64 = buffer.toString("base64");
-	return `data:${mime};base64,${base64}`;
+	return `data:${mime};base64,${compressedBuffer.toString("base64")}`;
 };
 
 /**