tinyhmacmd5 0.3.2-es2026 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,7 +2,7 @@ English | [中文](README-zh.md)
2
2
 
3
3
  # Tiny HMAC MD5
4
4
 
5
- A tiny and reliable HMAC-MD5 implementation for JavaScript: [`browser.min.js`](browser.min.js) is only **952 bytes**.
5
+ A tiny and reliable HMAC-MD5 implementation for JavaScript: [`browser.min.js`](browser.min.js) is only **984 bytes**.
6
6
 
7
7
  - **Input type**: `string` (UTF‑8), `Uint8Array` or `Uint8ClampedArray`
8
8
  - **Output type**: hex `string` or bytes `Uint8Array`
@@ -10,10 +10,14 @@ A tiny and reliable HMAC-MD5 implementation for JavaScript: [`browser.min.js`](b
10
10
  - **TypeScript‑ready**: [`main.d.ts`](main.d.ts)
11
11
  - **0 dependencies**
12
12
 
13
+ **Live demo**: https://bddjr.github.io/tinyhmacmd5/
14
+
13
15
  `tinyhmacmd5` does not simply aim for the smallest possible size.
14
16
  Its goal is to balance code size and runtime performance, so some performance-oriented implementations are intentionally retained.
15
17
  As a result, the final size is not the smallest theoretically achievable.
16
18
 
19
+ If you need a smaller implementation that targets ECMAScript 2026, see the [`es2026`](https://github.com/bddjr/tinyhmacmd5/tree/es2026) branch.
20
+
17
21
  > [!WARNING]
18
22
  > MD5 is cryptographically broken and unsafe for security-sensitive applications.
19
23
  > Do not rely on it for password hashing, digital signatures, or certificate verification.
@@ -23,7 +27,7 @@ As a result, the final size is not the smallest theoretically achievable.
23
27
  ### npm
24
28
 
25
29
  ```
26
- npm i tinyhmacmd5@es2026
30
+ npm i tinyhmacmd5
27
31
  ```
28
32
 
29
33
  ```js
@@ -39,7 +43,7 @@ You can also use other package managers (e.g. `pnpm` or `yarn`) in place of `npm
39
43
  See https://www.jsdelivr.com/package/npm/tinyhmacmd5
40
44
 
41
45
  ```html
42
- <script src="https://cdn.jsdelivr.net/npm/tinyhmacmd5@es2026"></script>
46
+ <script src="https://cdn.jsdelivr.net/npm/tinyhmacmd5"></script>
43
47
  ```
44
48
 
45
49
  It will define the `md5` function using `var`.
@@ -47,7 +51,7 @@ It will define the `md5` function using `var`.
47
51
  ### UNPKG
48
52
 
49
53
  ```html
50
- <script src="https://unpkg.com/tinyhmacmd5@es2026"></script>
54
+ <script src="https://unpkg.com/tinyhmacmd5"></script>
51
55
  ```
52
56
 
53
57
  It will define the `md5` function using `var`.
@@ -138,22 +142,22 @@ md5(data)
138
142
 
139
143
  ## Runtime Environment
140
144
 
141
- Environments that support [`Uint8Array.prototype.toHex()`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array/toHex) :
145
+ Environments that support [Exponentiation (`**`)](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/Exponentiation) and [`TextEncoder`](https://developer.mozilla.org/docs/Web/API/TextEncoder) :
142
146
 
143
147
  - Desktop
144
- - Chrome ≥ 140 (2025-09-02)
145
- - Edge ≥ 140 (2025-09-05)
146
- - Firefox ≥ 133 (2024-11-26)
147
- - Opera ≥ 124 (2025-11-13)
148
- - Safari ≥ 18.2 (2024-12-11)
148
+ - Chrome ≥ 52 (2016-07-20)
149
+ - Edge ≥ 79 (2020-01-15)
150
+ - Firefox ≥ 52 (2017-03-07)
151
+ - Opera ≥ 39 (2016-08-02)
152
+ - Safari ≥ 10.1 (2017-03-27)
149
153
  - Mobile
150
- - Chrome Android ≥ 140 (2025-09-02)
151
- - Firefox for Android ≥ 133 (2024-11-26)
152
- - Opera Android ≥ 92 (2025-10-08)
153
- - Safari on iOS ≥ 18.2 (2024-12-11)
154
- - Samsung Browser ×
155
- - WebView Android ≥ 140 (2025-09-02)
156
- - WebView on iOS ≥ 18.2 (2024-12-11)
154
+ - Chrome Android ≥ 52 (2016-07-27)
155
+ - Firefox for Android ≥ 52 (2017-03-07)
156
+ - Opera Android ≥ 41 (2016-10-25)
157
+ - Safari on iOS ≥ 10.3 (2017-03-27)
158
+ - Samsung Browser ≥ 6 (2017-08-23)
159
+ - WebView Android ≥ 51 (2016-06-08)
160
+ - WebView on iOS ≥ 10.3 (2017-03-27)
157
161
 
158
162
  Not recommended for use in environments that support `node:crypto`, as `node:crypto` already provides HMAC-MD5.
159
163
 
@@ -201,7 +205,7 @@ During the adaptation, I discovered that `blueimp-md5` did not correctly handle
201
205
 
202
206
  I also found that using `Array` to process inputs over 512 MiB could throw a `RangeError`, so I replaced it with `Int32Array`.
203
207
 
204
- I demonstrated in practice that HMAC-MD5 can be implemented in an extremely small footprint (952 bytes) while also improving reliability.
208
+ I demonstrated in practice that HMAC-MD5 can be implemented in an extremely small footprint (984 bytes) while also improving reliability.
205
209
 
206
210
  Maybe not many people care about saving just a few KB, but `tinyhmacmd5` exists precisely to "explore the unknown".
207
211
 
package/browser.min.js CHANGED
@@ -1 +1 @@
1
- /*! npmjs.com/tinyhmacmd5 */{let r=Math,e=r.floor,n=Int32Array,t=new n(64).map((e,n)=>2**32*r.abs(r.sin(n+1))),o=(r,o,f=0,a,l=1732584193,w=271733878,d,h,i=r.length,s=n.of(l,~w,~l,w),u=new n(s))=>{for(r[i-1]=o/2**29,r[e(o/4)]|=128<<(r[i-2]=o<<3);f<i;f+=16){for(o=0;o<16;o+=4)for(a=0;a<16;)s[h&=3]=((w=s[h]+t[4*o|a]+(l=s[3&++h],w=s[3&++h],d=s[3&++h],o?o>4?o>8?w^(l|~d):l^w^d:l&d|w&~d:l&w|~l&d)+r[f+(a*(29521>>o)+(1296>>o)&15)])<<(d="',16%).4$+07&*/5".charCodeAt(3&a++|o))|w>>>64-d)+l;for(;h;)u[--h]=s[h]+=u[h]}return s},f=(r,t,o=("string"==typeof r?r=(new TextEncoder).encode(r):r).length,f=new n(16*e((4*t+o+72)/64)),a=0)=>{for(;a<o;)f[t++]=r[a++]|r[a++]<<8|r[a++]<<16|r[a++]<<24;return[f,o]};var md5=(r,e,t)=>{var a=16,l=null!=e,[w,d]=f(r,l*a),h=new Uint8Array(a);if(l){let[r,t]=f(e,0),l=new n(32);for(t>64&&(r=o(r,t)),t=a;t;)l[--t]=1785358954^(w[t]=909522486^r[t]);l.set(o(w,64+d),a),w=l,d=80}for(w=o(w,d);a;)h[--a]=w[a>>2]>>8*a;return t?h:h.toHex()}}
1
+ /*! npmjs.com/tinyhmacmd5 */{let r=Math,e=r.floor,n=Int32Array,t=new n(64).map((e,n)=>2**32*r.abs(r.sin(n+1))),o=(r,o,f=0,a,l=1732584193,w=271733878,i,d,g=r.length,h=n.of(l,~w,~l,w),s=new n(h))=>{for(r[g-1]=o/2**29,r[e(o/4)]|=128<<(r[g-2]=o<<3);f<g;f+=16){for(o=0;o<16;o+=4)for(a=0;a<16;)h[d&=3]=((w=h[d]+t[4*o|a]+(l=h[3&++d],w=h[3&++d],i=h[3&++d],o?o>4?o>8?w^(l|~i):l^w^i:l&i|w&~i:l&w|~l&i)+r[f+(a*(29521>>o)+(1296>>o)&15)])<<(i="',16%).4$+07&*/5".charCodeAt(3&a++|o))|w>>>64-i)+l;for(;d;)s[--d]=h[d]+=s[d]}return h},f=(r,t,o=("string"==typeof r?r=(new TextEncoder).encode(r):r).length,f=new n(16*e((4*t+o+72)/64)),a=0)=>{for(;a<o;)f[t++]=r[a++]|r[a++]<<8|r[a++]<<16|r[a++]<<24;return[f,o]};var md5=(r,e,t)=>{var a=16,l=null!=e,[w,i]=f(r,l*a),d=t?new Uint8Array(a):"";if(l){let[r,t]=f(e,0),l=new n(32);for(t>64&&(r=o(r,t)),t=a;t;)l[--t]=1785358954^(w[t]=909522486^r[t]);l.set(o(w,64+i),a),w=l,i=80}for(w=o(w,i);a;t?d[a]=i:d=(i>>4&&"")+i.toString(16)+d)i=w[--a>>2]>>8*a&255;return d}}
package/main.js CHANGED
@@ -125,7 +125,9 @@ var md5 = (data, key, raw) => {
125
125
  var i = 16
126
126
  , hasKey = key != null
127
127
  , [bdata, temp] = inputToWords(data, /**@type {*}*/(hasKey) * i)
128
- , out = new Uint8Array(i)
128
+
129
+ /** @type {*} */
130
+ var out = raw ? new Uint8Array(i) : ''
129
131
 
130
132
  if (hasKey) {
131
133
  // HMAC
@@ -146,11 +148,15 @@ var md5 = (data, key, raw) => {
146
148
  bdata = wordsMD5(bdata, temp)
147
149
 
148
150
  // words to bytes or hex
149
- for (; i;) {
150
- out[--i] = bdata[i >> 2] >> i * 8
151
+ for (; i;
152
+ raw
153
+ ? out[i] = temp
154
+ : out = (temp >> 4 && '') + temp.toString(16) + out
155
+ ) {
156
+ temp = bdata[--i >> 2] >> i * 8 & 0xff
151
157
  }
152
158
 
153
- return raw ? out : out.toHex()
159
+ return out
154
160
  }
155
161
 
156
162
  export default md5
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "tinyhmacmd5",
3
- "version": "0.3.2-es2026",
4
- "description": "A tiny and reliable HMAC-MD5 implementation for JavaScript: browser.min.js is only 952 bytes.",
3
+ "version": "0.3.2",
4
+ "description": "A tiny and reliable HMAC-MD5 implementation for JavaScript: browser.min.js is only 984 bytes.",
5
5
  "author": "bddjr",
6
6
  "license": "MIT",
7
7
  "type": "module",
@@ -63,7 +63,7 @@
63
63
  "typescript": "^7.0.2"
64
64
  },
65
65
  "scripts": {
66
- "build": "tsc && node scripts/build.mjs && es-check es2026 --module --checkFeatures main.js browser.min.js",
66
+ "build": "tsc && node scripts/build.mjs && es-check es2016 --module --checkFeatures main.js browser.min.js",
67
67
  "build:unchanged": "node scripts/build-unchanged.mjs",
68
68
  "test": "pnpm build && pnpm test:only",
69
69
  "test:only": "node scripts/test.mjs && node scripts/test-513MiB.mjs",