feat: add hex-string {en,de}code

Author: septs

package.json

@@ -8,14 +8,18 @@
     "module": "./esm/index.js",
     "types": "./esm/index.d.ts",
     "type": "module",
-    "files": ["esm", "src"],
+    "files": [
+        "esm",
+        "src"
+    ],
     "scripts": {
         "build": "tsc -p ./tsconfig.json"
     },
     "devDependencies": {
         "@types/lodash-es": "^4.17.6",
         "prettier": "^2.5.1",
-        "typescript": "^4.7.0-dev.20220223"
+        "typescript": "^4.7.0-dev.20220223",
+        "user-agent-data-types": "^0.2.0"
     },
     "dependencies": {
         "lodash-es": "^4.17.21"

pnpm-lock.yaml

@@ -1,3 +1,5 @@
+import 'user-agent-data-types'
+
 export function formatFileSize(input = 0, si = isMacPlatform(), fractionDigits = 1) {
     if (input === 0 || Number.isNaN(input)) {
         return '0 B'
@@ -13,7 +15,7 @@ export function formatFileSize(input = 0, si = isMacPlatform(), fractionDigits =
 /** @internal */
 function isMacPlatform() {
     try {
-        return /^Mac/.test(navigator.platform)
+        return /^Mac/.test(navigator.userAgentData?.platform ?? navigator.platform)
     } catch {
         return false
     }

src/media/file.ts

@@ -1,22 +1,17 @@
-export const blobToDataURL = factory('readAsDataURL')
-export const blobToText = factory('readAsText')
+export const blobToDataURL = factory<string>('DataURL')
+export const blobToText = factory<string>('Text')
 
-interface Methods {
-    readAsDataURL: string
-    readAsText: string
-}
-
-function factory<T extends keyof Methods>(method: T) {
+function factory<T extends string | ArrayBuffer>(method: 'ArrayBuffer' | 'BinaryString' | 'DataURL' | 'Text') {
     return (blob: Blob) => {
-        return new Promise<Methods[T]>((resolve, reject) => {
+        return new Promise<T>((resolve, reject) => {
             const reader = new FileReader()
             reader.addEventListener('error', () => {
                 reject(reader.error)
             })
             reader.addEventListener('load', () => {
-                resolve(reader.result as Methods[T])
+                resolve(reader.result as T)
             })
-            reader[method](blob)
+            reader[`readAs${method}`](blob)
         })
     }
 }

src/web/blob.ts

@@ -1,5 +1,4 @@
-export function getCookieValue(name: string): string | undefined {
-    const { cookie } = document
+export function getCookieValue(name: string, cookie = document.cookie): string | undefined {
     const start = cookie.indexOf(`${name}=`)
     if (start === -1) return
     let end: number | undefined = cookie.indexOf('; ', start)

src/web/cookie.ts

@@ -2,8 +2,8 @@ export function encodeText(input: string) {
     return new TextEncoder().encode(input)
 }
 
-export function decodeText(input: ArrayBuffer) {
-    return new TextDecoder().decode(input)
+export function decodeText(input: Iterable<number>) {
+    return new TextDecoder().decode(Uint8Array.from(input))
 }
 
 export function decodeArrayBuffer(input: string) {
@@ -15,9 +15,9 @@ export function decodeArrayBuffer(input: string) {
     return buffer.buffer
 }
 
-export function encodeArrayBuffer(input: ArrayBuffer) {
+export function encodeArrayBuffer(input: Iterable<number>) {
     let encoded = ''
-    for (const code of new Uint8Array(input)) {
+    for (const code of Uint8Array.from(input)) {
         encoded += String.fromCharCode(code)
     }
     return btoa(encoded)

src/web/encode-text-arraybuffer.ts

@@ -0,0 +1,13 @@
+export function encodeHexString(input: Uint8Array) {
+    return [...input].map((value) => (value < 10 ? '0' : '') + value.toString(16)).join('')
+}
+
+export function decodeHexString(input: string) {
+    const values: number[] = []
+    for (let index = 0; index < input.length; index += 2) {
+        const value = Number.parseInt(input.slice(index, index + 2), 16)
+        if (Number.isNaN(value)) throw new Error('The string not is hex string')
+        values.push(value)
+    }
+    return Uint8Array.from(values)
+}

src/web/hex-string.ts

@@ -5,4 +5,5 @@ export * from './cookie.js'
 export * from './delay.js'
 export * from './document.readyState.js'
 export * from './encode-text-arraybuffer.js'
+export * from './hex-string.js'
 export * from './timeout.js'