@nsnanocat/util 1.7.0

package/lib/notification.mjs

@@ -0,0 +1,148 @@
+import { $app } from "./app.mjs";
+import { Console } from "../polyfill/Console.mjs";
+
+/**
+ * 系统通知
+ *
+ * > 通知参数: 同时支持 QuanX 和 Loon 两种格式, EnvJs根据运行环境自动转换, Surge 环境不支持多媒体通知
+ *
+ * 示例:
+ * $.msg(title, subtitle, body, "twitter://")
+ * $.msg(title, subtitle, body, { "open-url": "twitter://", "media-url": "https://github.githubassets.com/images/modules/open_graph/github-mark.png" })
+ * $.msg(title, subtitle, body, { "open-url": "https://bing.com", "media-url": "https://github.githubassets.com/images/modules/open_graph/github-mark.png" })
+ *
+ * @param {string} title 标题
+ * @param {string} subtitle 副标题
+ * @param {string} body 内容
+ * @param {*} mutableContent 通知扩展字段
+ *
+ */
+export function notification(title = `ℹ️ ${$app} 通知`, subtitle = "", body = "", content = {}) {
+	switch ($app) {
+		case "Surge":
+		case "Loon":
+		case "Stash":
+		case "Egern":
+		case "Shadowrocket":
+		default:
+			$notification.post(title, subtitle, body, MutableContent(content));
+			break;
+		case "Quantumult X":
+			$notify(title, subtitle, body, MutableContent(content));
+			break;
+		case "Node.js":
+			break;
+	}
+	Console.info(...["==============📣系统通知📣==============", title, subtitle, body, JSON.stringify(MutableContent(content), null, 2)]);
+}
+
+const MutableContent = content => {
+	const mutableContent = {};
+	switch (typeof content) {
+		case undefined:
+			break;
+		case "string":
+		case "number":
+		case "boolean":
+			switch ($app) {
+				case "Surge":
+				case "Stash":
+				case "Egern":
+				default:
+					mutableContent.url = content;
+					break;
+				case "Loon":
+				case "Shadowrocket":
+					mutableContent.openUrl = content;
+					break;
+				case "Quantumult X":
+					mutableContent["open-url"] = content;
+					break;
+				case "Node.js":
+					break;
+			}
+			break;
+		case "object": {
+			const openUrl = content.open || content["open-url"] || content.url || content.openUrl;
+			const copyUrl = content.copy || content["update-pasteboard"] || content.updatePasteboard;
+			const mediaUrl = content.media || content["media-url"] || content.mediaUrl;
+			switch ($app) {
+				case "Surge":
+				case "Stash":
+				case "Egern":
+				case "Shadowrocket":
+				default: {
+					if (openUrl) {
+						mutableContent.action = "open-url";
+						mutableContent.url = openUrl;
+					}
+					if (copyUrl) {
+						mutableContent.action = "clipboard";
+						mutableContent.text = copyUrl;
+					}
+					if (mediaUrl) {
+						switch (true) {
+							case mediaUrl.startsWith("http"): // http 开头的网络地址
+								mutableContent["media-url"] = mediaUrl;
+								break;
+							case mediaUrl.startsWith("data:"): {
+								// data 开头的 Base64 编码
+								// data:image/png;base64,iVBORw0KGgo...
+								const base64RegExp = /^data:(?<MIME>\w+\/\w+);base64,(?<Base64>.+)/;
+								const { MIME, Base64 } = mediaUrl.match(base64RegExp).groups;
+								mutableContent["media-base64"] = Base64;
+								mutableContent["media-base64-mime"] = content.mime || MIME;
+								break;
+							}
+							default: {
+								mutableContent["media-base64"] = mediaUrl;
+								// https://stackoverflow.com/questions/57976898/how-to-get-mime-type-from-base-64-string
+								switch (true) {
+									case mediaUrl.startsWith("CiVQREYt"):
+									case mediaUrl.startsWith("JVBERi0"):
+										mutableContent["media-base64-mime"] = "application/pdf";
+										break;
+									case mediaUrl.startsWith("R0lGODdh"):
+									case mediaUrl.startsWith("R0lGODlh"):
+										mutableContent["media-base64-mime"] = "image/gif";
+										break;
+									case mediaUrl.startsWith("iVBORw0KGgo"):
+										mutableContent["media-base64-mime"] = "image/png";
+										break;
+									case mediaUrl.startsWith("/9j/"):
+										mutableContent["media-base64-mime"] = "image/jpg";
+										break;
+									case mediaUrl.startsWith("Qk02U"):
+										mutableContent["media-base64-mime"] = "image/bmp";
+										break;
+								}
+								break;
+							}
+						}
+					}
+					if (content["auto-dismiss"]) mutableContent["auto-dismiss"] = content["auto-dismiss"];
+					if (content.sound) mutableContent.sound = content.sound;
+					break;
+				}
+				case "Loon": {
+					if (openUrl) mutableContent.openUrl = openUrl;
+					if (mediaUrl?.startsWith("http")) mutableContent.mediaUrl = mediaUrl;
+					break;
+				}
+				case "Quantumult X": {
+					if (openUrl) mutableContent["open-url"] = openUrl;
+					if (mediaUrl?.startsWith("http")) mutableContent["media-url"] = mediaUrl;
+					if (copyUrl) mutableContent["update-pasteboard"] = copyUrl;
+					break;
+				}
+				case "Node.js":
+					break;
+			}
+			break;
+		}
+		default:
+			Console.error(`不支持的通知参数类型: ${typeof content}`, "");
+			break;
+	}
+	return mutableContent;
+};

package/lib/runScript.mjs

@@ -0,0 +1,27 @@
+import { Console } from "../polyfill/Console.mjs";
+import { fetch } from "../polyfill/fetch.mjs";
+import { Lodash as _ } from "../polyfill/Lodash.mjs";
+import { Storage } from "../polyfill/Storage.mjs";
+
+export async function runScript(script, runOpts) {
+	let httpapi = Storage.getItem("@chavy_boxjs_userCfgs.httpapi");
+	httpapi = httpapi?.replace?.(/\n/g, "")?.trim();
+	let httpapi_timeout = Storage.getItem("@chavy_boxjs_userCfgs.httpapi_timeout");
+	httpapi_timeout = httpapi_timeout * 1 ?? 20;
+	httpapi_timeout = runOpts?.timeout ?? httpapi_timeout;
+	const [password, address] = httpapi.split("@");
+	const request = {
+		url: `http://${address}/v1/scripting/evaluate`,
+		body: {
+			script_text: script,
+			mock_type: "cron",
+			timeout: httpapi_timeout,
+		},
+		headers: { "X-Key": password, Accept: "*/*" },
+		timeout: httpapi_timeout,
+	};
+	await fetch(request).then(
+		response => response.body,
+		error => Console.error(error),
+	);
+}

package/lib/time.mjs

@@ -0,0 +1,30 @@
+/**
+ * time
+ * 时间格式化
+ * [version of ISO8601]{@link https://262.ecma-international.org/5.1/#sec-15.9.1.15}
+ * 示例:time("yyyy-MM-dd qq HH:mm:ss.S") YYYY-MM-DDTHH:mm:ss.sssZ
+ *    :time("yyyyMMddHHmmssS")
+ *    YY:年 MM:月 dd:日 S:季 HH:时 m:分 ss:秒 sss:毫秒 Z:时区
+ *    其中y可选0-4位占位符、S可选0-1位占位符，其余可选0-2位占位符
+ * @param {string} format 格式化参数
+ * @param {number} ts 可选: 根据指定时间戳返回格式化日期
+ *
+ */
+export function time(format, ts) {
+	const date = ts ? new Date(ts) : new Date();
+	const Time = {
+		YY: date.getFullYear().toString().substring(3),
+		yyyy: date.getFullYear().toString(),
+		MM: (date.getMonth() + 1).toString().padStart(2, "0"),
+		dd: date.getDate().toString().padStart(2, "0"),
+		HH: date.getHours().toString().padStart(2, "0"),
+		mm: date.getMinutes().toString().padStart(2, "0"),
+		sss: date.getMilliseconds().toString().padStart(3, "0"),
+		ss: date.getSeconds().toString().padStart(2, "0"),
+		S: `${Math.floor(date.getMonth() / 3) + 1}`,
+	};
+	for (const [key, value] of Object.entries(Time)) {
+		format = format.replace(key, value);
+	}
+	return format;
+}

package/lib/wait.mjs

@@ -0,0 +1,10 @@
+/**
+ * wait
+ *
+ * @export
+ * @param {number} [delay=1000]
+ * @returns {Promise<resolve>}
+ */
+export function wait(delay = 1000) {
+	return new Promise(resolve => setTimeout(resolve, delay));
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+	"name": "@nsnanocat/util",
+	"version": "1.7.0",
+	"description": "Pure JS's util module for well-known iOS network tools",
+	"author": "VirgilClyne <Virgil@nanocat.me>",
+	"homepage": "https://NSNanoCat.github.io/util",
+	"keywords": [
+		"loon",
+		"quantumult",
+		"surge",
+		"shadowrocket",
+		"stash",
+		"egern"
+	],
+	"license": "Apache-2.0",
+	"bugs": "https://github.com/NSNanoCat/util/issues",
+	"main": "index.js",
+	"type": "module",
+	"scripts": {
+		"tsc:build": "npx tsc",
+		"test": "exit 0"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/NSNanoCat/util.git"
+	},
+	"dependencies": {
+		"pako": "^2.1.0"
+	},
+	"files": [
+		"index.js",
+		"lib",
+		"polyfill",
+		"gRPC.mjs",
+		"getStorage.mjs"
+	],
+	"devDependencies": {
+		"typescript": "^5.6.3"
+	}
+}

package/polyfill/Console.mjs

@@ -0,0 +1,109 @@
+import { $app } from "../lib/app.mjs";
+
+export class Console {
+	static #counts = new Map([]);
+	static #groups = [];
+	static #times = new Map([]);
+
+	static clear = () => {};
+
+	static count = (label = "default") => {
+		switch (Console.#counts.has(label)) {
+			case true:
+				Console.#counts.set(label, Console.#counts.get(label) + 1);
+				break;
+			case false:
+				Console.#counts.set(label, 0);
+				break;
+		}
+		Console.log(`${label}: ${Console.#counts.get(label)}`);
+	};
+
+	static countReset = (label = "default") => {
+		switch (Console.#counts.has(label)) {
+			case true:
+				Console.#counts.set(label, 0);
+				Console.log(`${label}: ${Console.#counts.get(label)}`);
+				break;
+			case false:
+				Console.warn(`Counter "${label}" doesn’t exist`);
+				break;
+		}
+	};
+
+	static debug = (...msg) => {
+		msg = msg.map(m => `🅱️ ${m}`);
+		Console.log(...msg);
+	};
+
+	static error(...msg) {
+		switch ($app) {
+			case "Surge":
+			case "Loon":
+			case "Stash":
+			case "Egern":
+			case "Shadowrocket":
+			case "Quantumult X":
+			default:
+				msg = msg.map(m => `❌ ${m}`);
+				break;
+			case "Node.js":
+				msg = msg.map(m => `❌ ${m.stack}`);
+				break;
+		}
+		Console.log(...msg);
+	}
+
+	static exception = (...msg) => Console.error(...msg);
+
+	static group = label => Console.#groups.unshift(label);
+
+	static groupEnd = () => Console.#groups.shift();
+
+	static info(...msg) {
+		msg = msg.map(m => `ℹ️ ${m}`);
+		Console.log(...msg);
+	}
+
+	static log = (...msg) => {
+		msg = msg.map(log => {
+			switch (typeof log) {
+				case "object":
+					log = JSON.stringify(log);
+					break;
+				case "bigint":
+				case "number":
+				case "boolean":
+				case "string":
+					log = log.toString();
+					break;
+				case "undefined":
+				default:
+					log = "";
+					break;
+			}
+			return log;
+		});
+		Console.#groups.forEach(group => {
+			msg = msg.map(log => `  ${log}`);
+			msg.unshift(`▼ ${group}:`);
+		});
+		msg = ["", ...msg, ""];
+		console.log(msg.join("\n"));
+	};
+
+	static time = (label = "default") => Console.#times.set(label, Date.now());
+
+	static timeEnd = (label = "default") => Console.#times.delete(label);
+
+	static timeLog = (label = "default") => {
+		const time = Console.#times.get(label);
+		if (time) Console.log(`${label}: ${Date.now() - time}ms`);
+		else Console.warn(`Timer "${label}" doesn’t exist`);
+	};
+
+	static warn(...msg) {
+		msg = msg.map(m => `⚠️ ${m}`);
+		Console.log(...msg);
+	}
+}

package/polyfill/Lodash.mjs

@@ -0,0 +1,60 @@
+/* https://www.lodashjs.com */
+export class Lodash {
+	static get(object = {}, path = "", defaultValue = undefined) {
+		// translate array case to dot case, then split with .
+		// a[0].b -> a.0.b -> ['a', '0', 'b']
+		if (!Array.isArray(path)) path = Lodash.toPath(path);
+
+		const result = path.reduce((previousValue, currentValue) => {
+			return Object(previousValue)[currentValue]; // null undefined get attribute will throwError, Object() can return a object
+		}, object);
+		return result === undefined ? defaultValue : result;
+	}
+
+	static set(object, path, value) {
+		if (!Array.isArray(path)) path = Lodash.toPath(path);
+		path.slice(0, -1).reduce((previousValue, currentValue, currentIndex) => (Object(previousValue[currentValue]) === previousValue[currentValue] ? previousValue[currentValue] : (previousValue[currentValue] = /^\d+$/.test(path[currentIndex + 1]) ? [] : {})), object)[path[path.length - 1]] = value;
+		return object;
+	}
+
+	static unset(object = {}, path = "") {
+		if (!Array.isArray(path)) path = Lodash.toPath(path);
+		const result = path.reduce((previousValue, currentValue, currentIndex) => {
+			if (currentIndex === path.length - 1) {
+				delete previousValue[currentValue];
+				return true;
+			}
+			return Object(previousValue)[currentValue];
+		}, object);
+		return result;
+	}
+
+	static toPath(value) {
+		return value
+			.replace(/\[(\d+)\]/g, ".$1")
+			.split(".")
+			.filter(Boolean);
+	}
+
+	static escape(string) {
+		const map = {
+			"&": "&",
+			"<": "&lt;",
+			">": "&gt;",
+			'"': "&quot;",
+			"'": "&#39;",
+		};
+		return string.replace(/[&<>"']/g, m => map[m]);
+	}
+
+	static unescape(string) {
+		const map = {
+			"&amp;": "&",
+			"&lt;": "<",
+			"&gt;": ">",
+			"&quot;": '"',
+			"&#39;": "'",
+		};
+		return string.replace(/&amp;|&lt;|&gt;|&quot;|&#39;/g, m => map[m]);
+	}
+}

package/polyfill/StatusCodes.mjs

@@ -0,0 +1,62 @@
+export const StatusCodes = {
+	100: "HTTP/1.1 100 Continue",
+	101: "HTTP/1.1 101 Switching Protocols",
+	102: "HTTP/1.1 102 Processing",
+	103: "HTTP/1.1 103 Early Hints",
+	200: "HTTP/1.1 200 OK",
+	201: "HTTP/1.1 201 Created",
+	202: "HTTP/1.1 202 Accepted",
+	203: "HTTP/1.1 203 Non-Authoritative Information",
+	204: "HTTP/1.1 204 No Content",
+	205: "HTTP/1.1 205 Reset Content",
+	206: "HTTP/1.1 206 Partial Content",
+	207: "HTTP/1.1 207 Multi-Status",
+	208: "HTTP/1.1 208 Already Reported",
+	226: "HTTP/1.1 226 IM Used",
+	300: "HTTP/1.1 300 Multiple Choices",
+	301: "HTTP/1.1 301 Moved Permanently",
+	302: "HTTP/1.1 302 Found",
+	304: "HTTP/1.1 304 Not Modified",
+	307: "HTTP/1.1 307 Temporary Redirect",
+	308: "HTTP/1.1 308 Permanent Redirect",
+	400: "HTTP/1.1 400 Bad Request",
+	401: "HTTP/1.1 401 Unauthorized",
+	402: "HTTP/1.1 402 Payment Required",
+	403: "HTTP/1.1 403 Forbidden",
+	404: "HTTP/1.1 404 Not Found",
+	405: "HTTP/1.1 405 Method Not Allowed",
+	406: "HTTP/1.1 406 Not Acceptable",
+	407: "HTTP/1.1 407 Proxy Authentication Required",
+	408: "HTTP/1.1 408 Request Timeout",
+	409: "HTTP/1.1 409 Conflict",
+	410: "HTTP/1.1 410 Gone",
+	411: "HTTP/1.1 411 Length Required",
+	412: "HTTP/1.1 412 Precondition Failed",
+	413: "HTTP/1.1 413 Content Too Large",
+	414: "HTTP/1.1 414 URI Too Long",
+	415: "HTTP/1.1 415 Unsupported Media Type",
+	416: "HTTP/1.1 416 Range Not Satisfiable",
+	417: "HTTP/1.1 417 Expectation Failed",
+	418: "HTTP/1.1 418 I'm a teapot",
+	421: "HTTP/1.1 421 Misdirected Request",
+	422: "HTTP/1.1 422 Unprocessable Entity",
+	423: "HTTP/1.1 423 Locked",
+	424: "HTTP/1.1 424 Failed Dependency",
+	425: "HTTP/1.1 425 Too Early",
+	426: "HTTP/1.1 426 Upgrade Required",
+	428: "HTTP/1.1 428 Precondition Required",
+	429: "HTTP/1.1 429 Too Many Requests",
+	431: "HTTP/1.1 431 Request Header Fields Too Large",
+	451: "HTTP/1.1 451 Unavailable For Legal Reasons",
+	500: "HTTP/1.1 500 Internal Server Error",
+	501: "HTTP/1.1 501 Not Implemented",
+	502: "HTTP/1.1 502 Bad Gateway",
+	503: "HTTP/1.1 503 Service Unavailable",
+	504: "HTTP/1.1 504 Gateway Timeout",
+	505: "HTTP/1.1 505 HTTP Version Not Supported",
+	506: "HTTP/1.1 506 Variant Also Negotiates",
+	507: "HTTP/1.1 507 Insufficient Storage",
+	508: "HTTP/1.1 508 Loop Detected",
+	510: "HTTP/1.1 510 Not Extended",
+	511: "HTTP/1.1 511 Network Authentication Required",
+};