ph-utils 0.14.1 → 0.15.2

package/lib/crypto.d.ts

@@ -13,6 +13,24 @@ export declare function bufferToHex(bf: ArrayBuffer | Uint8Array, upper?: boolea
  * @returns
  */
 export declare function sha(message: string, upper?: boolean, algorithm?: string): Promise<string>;
+/**
+ * 哈希算法
+ * @param message     待进行 hash 的数据
+ * @param upper       是否转换为大写, 默认为: false
+ * @param algorithm   hash算法, 支持: SHA-1、SHA-256、SHA-384、SHA-512; 默认为: SHA-256
+ * @returns
+ */
+export declare function hash(message: string, upper?: boolean, algorithm?: string): Promise<string>;
+type HMACAlgorithm = "SHA-256" | "SHA-512";
+/**
+ * 使用 HMAC 算法计算消息的哈希值
+ * @param message - 需要计算哈希的消息字符串
+ * @param secret - 用于生成 HMAC 的密钥
+ * @param algorithm - HMAC 使用的哈希算法,默认为 "SHA-256"
+ * @param upper - 是否将结果转换为大写,默认为 false
+ * @returns 返回十六进制格式的 HMAC 哈希值
+ */
+export declare function hmacHash(message: string, secret: string, algorithm?: HMACAlgorithm, upper?: boolean): Promise<string>;
 /** 返回结果类似 */
 type AlgorithmResType = "hex" | "hexUpper" | "base64" | "raw";
 /**

package/lib/crypto.js

@@ -63,6 +63,30 @@ export async function sha(message, upper = false, algorithm = "SHA-256") {
     const hashBuffer = await globalThis.crypto.subtle.digest(algorithm || "SHA-256", msgUint8);
     return bufferToHex(hashBuffer, upper);
 }
+/**
+ * 哈希算法
+ * @param message     待进行 hash 的数据
+ * @param upper       是否转换为大写, 默认为: false
+ * @param algorithm   hash算法, 支持: SHA-1、SHA-256、SHA-384、SHA-512; 默认为: SHA-256
+ * @returns
+ */
+export async function hash(message, upper = false, algorithm = "SHA-256") {
+    return sha(message, upper, algorithm);
+}
+/**
+ * 使用 HMAC 算法计算消息的哈希值
+ * @param message - 需要计算哈希的消息字符串
+ * @param secret - 用于生成 HMAC 的密钥
+ * @param algorithm - HMAC 使用的哈希算法,默认为 "SHA-256"
+ * @param upper - 是否将结果转换为大写,默认为 false
+ * @returns 返回十六进制格式的 HMAC 哈希值
+ */
+export async function hmacHash(message, secret, algorithm = "SHA-256", upper = false) {
+    const encoder = new TextEncoder();
+    const key = await crypto.subtle.importKey("raw", encoder.encode(secret), { name: "HMAC", hash: { name: algorithm } }, false, ["sign"]);
+    const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(message));
+    return bufferToHex(signature, upper);
+}
 function parseRsaKey(pem) {
     const pemHeader = "-----BEGIN PUBLIC KEY-----";
     const pemFooter = "-----END PUBLIC KEY-----";

package/lib/crypto_node.d.ts

@@ -1,4 +1,5 @@
-type HashAlgorithmName = "md5" | "sha1" | "sha256";
+type HashAlgorithmName = "md5" | SHAHashAlgorithmName;
+type SHAHashAlgorithmName = "sha1" | "sha256" | "sha512";
 /**
  * 进行 md5|sha1|sha256 数据摘要签名
  * @param d 待加密的数据
@@ -6,6 +7,22 @@ type HashAlgorithmName = "md5" | "sha1" | "sha256";
  * @param upper 返回的结果是否需要大写. Defaults to False.
  */
 export declare function hashDigest(d: string, algorithm?: HashAlgorithmName, upper?: boolean): string;
+/**
+ * 进行 md5|sha1|sha256 数据摘要签名
+ * @param d 待加密的数据
+ * @param algorithm 签名算法, md5、sha1、sha256. Defaults to "sha256".
+ * @param upper 返回的结果是否需要大写. Defaults to False.
+ */
+export declare function hash(d: string, algorithm?: HashAlgorithmName, upper?: boolean): string;
+/**
+ * 使用 HMAC 算法对消息进行哈希处理
+ * @param message 待处理的消息
+ * @param key 用于 HMAC 算法的密钥
+ * @param algorithm 哈希算法，可选值为 "sha1"、"sha256" 或 "sha512"，默认为 "sha256"
+ * @param upper 返回的结果是否需要大写，默认为 false
+ * @returns 经过 HMAC 哈希处理后的字符串
+ */
+export declare function hmacHash(message: string, key: string, algorithm?: SHAHashAlgorithmName, upper?: boolean): string;
 /**
  * 生成 RSA 签名密钥对
  * @returns: [公钥, 私钥]

package/lib/crypto_node.js

@@ -1,4 +1,4 @@
-import { createHash, createCipheriv, randomBytes, generateKeyPair, createDecipheriv, privateDecrypt, publicEncrypt, } from "node:crypto";
+import { createHash, createCipheriv, randomBytes, generateKeyPair, createDecipheriv, privateDecrypt, publicEncrypt, createHmac, } from "node:crypto";
 /**
  * 进行 md5|sha1|sha256 数据摘要签名
  * @param d 待加密的数据
@@ -9,6 +9,27 @@ export function hashDigest(d, algorithm = "sha256", upper = false) {
     const hashed = createHash(algorithm).update(d).digest("hex");
     return upper ? hashed.toUpperCase() : hashed;
 }
+/**
+ * 进行 md5|sha1|sha256 数据摘要签名
+ * @param d 待加密的数据
+ * @param algorithm 签名算法, md5、sha1、sha256. Defaults to "sha256".
+ * @param upper 返回的结果是否需要大写. Defaults to False.
+ */
+export function hash(d, algorithm = "sha256", upper = false) {
+    return hashDigest(d, algorithm, upper);
+}
+/**
+ * 使用 HMAC 算法对消息进行哈希处理
+ * @param message 待处理的消息
+ * @param key 用于 HMAC 算法的密钥
+ * @param algorithm 哈希算法，可选值为 "sha1"、"sha256" 或 "sha512"，默认为 "sha256"
+ * @param upper 返回的结果是否需要大写，默认为 false
+ * @returns 经过 HMAC 哈希处理后的字符串
+ */
+export function hmacHash(message, key, algorithm = "sha256", upper = false) {
+    const hashed = createHmac(algorithm, key).update(message).digest("hex");
+    return upper ? hashed.toUpperCase() : hashed;
+}
 /**
  * 生成 RSA 签名密钥对
  * @returns: [公钥, 私钥]

package/lib/dom.d.ts

@@ -82,7 +82,7 @@ export declare function toggleClass(el: HTMLElement, clazz: string): void;
  * @param {function}    event     事件处理函数
  * @param {boolean}     onceOrConfig  是否是只运行一次的处理函数或者配置，其中 eventFlag 为 string，如果配置该项，则表明为委托事件
  */
-export declare function on(element: HTMLElement | ShadowRoot | Document, listener: string, fn: EventListener, option?: boolean | (AddEventListenerOptions & {
+export declare function on(element: HTMLElement | ShadowRoot | Document | HTMLCollection | NodeListOf<HTMLElement> | HTMLElement[], listener: string, fn: EventListener, option?: boolean | (AddEventListenerOptions & {
     eventFlag?: string;
 })): void;
 /**
@@ -91,7 +91,7 @@ export declare function on(element: HTMLElement | ShadowRoot | Document, listene
  * @param listener - 事件名称。
  * @param fn - 要移除的事件监听器函数。
  */
-export declare function off(el: HTMLElement | ShadowRoot | Document, listener: string, fn: EventListener, option?: boolean | EventListenerOptions): void;
+export declare function off(el: HTMLElement | ShadowRoot | Document | HTMLCollection | NodeListOf<HTMLElement> | HTMLElement[], listener: string, fn: EventListener, option?: boolean | EventListenerOptions): void;
 /**
  * 判断事件是否应该继续传递。
  * 从事件目标开始向上遍历DOM树，检查每个节点上是否存在指定的属性。
@@ -124,7 +124,7 @@ export declare function text(element: HTMLElement, textstr?: string): string | n
  * @param elems
  * @param fn 遍历到节点时的回调，回调第一个参数为遍历到的节点，第2个参数为 index；如果回调函数返回 true，则会终止遍历(break)
  */
-export declare function iterate(elems: NodeList | HTMLElement[], fn: (el: HTMLElement, index: number) => any): void;
+export declare function iterate<T>(elems: NodeList | HTMLCollection | T[], fn: (el: HTMLElement | T, index: number) => any): void;
 /**
  * 设置或获取节点 data-* 属性
  * @param elem

package/lib/dom.js

@@ -133,7 +133,14 @@ export function on(element, listener, fn, option) {
             element.setAttribute(option.eventFlag, "__stop__");
         }
     }
-    element.addEventListener(listener, fn, option);
+    if (element.length) {
+        iterate(element, (elem) => {
+            elem.addEventListener(listener, fn, option);
+        });
+    }
+    else if (element) {
+        element.addEventListener(listener, fn, option);
+    }
 }
 /**
  * 移除指定元素的事件监听器。
@@ -142,7 +149,14 @@ export function on(element, listener, fn, option) {
  * @param fn - 要移除的事件监听器函数。
  */
 export function off(el, listener, fn, option) {
-    el.removeEventListener(listener, fn, option);
+    if (el.length) {
+        iterate(el, (elem) => {
+            elem.removeEventListener(listener, fn, option);
+        });
+    }
+    else if (el) {
+        el.removeEventListener(listener, fn, option);
+    }
 }
 /**
  * 判断事件是否应该继续传递。
@@ -439,6 +453,8 @@ function toggleCssProperty(el, properties, method = "set") {
 export function transition(el, nameOrProperties, dir = "enter", finish) {
     const p = dir === "enter" ? "from" : "to";
     let nameClass = "", activeClass = "";
+    /** 动画状态, -1 - 准备, 0 - 进行中, 1 - 完成 */
+    let status = -1;
     const trans = [];
     if (typeof nameOrProperties === "string") {
         nameClass = `${nameOrProperties}-${dir}-${p}`;
@@ -452,6 +468,7 @@ export function transition(el, nameOrProperties, dir = "enter", finish) {
             }
         }
     }
+    status = 0;
     if (dir === "enter") {
         if (nameClass) {
             el.classList.add(nameClass);
@@ -490,25 +507,26 @@ export function transition(el, nameOrProperties, dir = "enter", finish) {
             });
         }
     }
-    el.addEventListener("transitionend", () => {
-        if (nameClass) {
-            el.classList.remove(activeClass);
-            requestAnimationFrame(() => {
-                el.classList.remove(nameClass);
-            });
-        }
-        else {
-            if (trans) {
-                el.style.removeProperty("transition");
+    el.addEventListener("transitionend", (e) => {
+        if (status === 0) {
+            status = 1;
+            if (nameClass) {
+                el.classList.remove(activeClass);
+                requestAnimationFrame(() => {
+                    el.classList.remove(nameClass);
+                });
             }
-            requestAnimationFrame(() => {
+            else {
+                if (trans) {
+                    el.style.removeProperty("transition");
+                }
                 requestAnimationFrame(() => {
                     toggleCssProperty(el, nameOrProperties, "remove");
                 });
-            });
-        }
-        if (finish) {
-            finish();
+            }
+            if (finish) {
+                finish();
+            }
         }
     }, { once: true });
 }

package/package.json

@@ -68,7 +68,7 @@
     },
     "./*": "./lib/*"
   },
-  "version": "0.14.1",
+  "version": "0.15.2",
   "type": "module",
   "repository": {
     "type": "git",