@xylabs/hex 2.13.15 → 2.13.17

package/package.json

@@ -38,7 +38,7 @@
     "esm"
   ],
   "dependencies": {
-    "@xylabs/arraybuffer": "~2.13.15"
+    "@xylabs/arraybuffer": "~2.13.17"
   },
   "devDependencies": {
     "@xylabs/ts-scripts-yarn3": "^3.2.10",
@@ -53,7 +53,7 @@
     "url": "https://github.com/xylabs/sdk-js.git"
   },
   "sideEffects": false,
-  "version": "2.13.15",
+  "version": "2.13.17",
   "packageManager": "yarn@3.3.1",
   "type": "module"
 }

package/src/address.ts

@@ -1,10 +1,15 @@
 import { AssertConfig, assertError } from './assert'
-import { asHex, bitsToNibbles, isHex } from './hex'
+import { bitsToNibbles, HexConfig, hexFrom, hexFromHexString, isHex } from './hex'
 
 export const addressRegex = /0x[0-9a-f]+/i
 
 export type Address = string
 
+export const toAddress = (value: unknown, config: HexConfig = {}) => {
+  const { bitLength = 160, prefix = true } = config
+  return hexFrom(value, { bitLength, prefix, ...config })
+}
+
 export const isAddress = (value: unknown, bitLength = 160): value is Address => {
   //Is it a string?
   if (typeof value !== 'string') return false
@@ -22,12 +27,15 @@ export const isAddress = (value: unknown, bitLength = 160): value is Address =>
 
 export function asAddress(value: unknown): Address | undefined
 export function asAddress(value: unknown, assert: AssertConfig): Address
-export function asAddress(value: unknown, bitLength: number): Address | undefined
-export function asAddress(value: unknown, bitLength: number, assert: AssertConfig): Address
-export function asAddress(value: unknown, assertOrBitLength?: AssertConfig | number, assertOnly?: AssertConfig): Address | undefined {
-  const bitLength = typeof assertOrBitLength === 'number' ? assertOrBitLength : 160
-  const assert = typeof assertOrBitLength !== 'number' ? assertOrBitLength : assertOnly
-
-  const result = `0x${asHex(value, bitLength, assert)}`
-  return isAddress(result, bitLength) ? result : assertError(value, assert, 'Resulting value is not an Address')
+export function asAddress(value: unknown, assert?: AssertConfig): Address | undefined {
+  let stringValue: string | undefined = undefined
+
+  switch (typeof value) {
+    case 'string':
+      stringValue = hexFromHexString(value, { prefix: true })
+      break
+    default:
+      return assert ? assertError(value, assert, `Unsupported type [${typeof value}]`) : undefined
+  }
+  return isAddress(stringValue) ? stringValue : assertError(value, assert, `Value is not an Address [${value}]`)
 }

package/src/hash.ts

@@ -1,5 +1,5 @@
 import { AssertConfig, assertError } from './assert'
-import { asHex, Hex, isHex, nibblesToBits } from './hex'
+import { Hex, hexFromHexString, isHex } from './hex'
 
 export type HashBitLength = 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096
 export const HashBitLength: HashBitLength[] = [32, 64, 128, 256, 512, 1024, 2048, 4096]
@@ -10,24 +10,20 @@ export const isHashBitLength = (value: unknown): value is HashBitLength => {
 
 export type Hash = Hex
 export const isHash = (value: unknown, bitLength: HashBitLength = 256): value is Hash => {
-  if (!isHex(value, bitLength)) return false
-
-  const hex = asHex(value, bitLength)
-  if (!hex) return false
-
-  if (!isHashBitLength(nibblesToBits(hex.length))) return false
-
-  return true
+  return isHex(value, bitLength)
 }
 
 export function asHash(value: unknown): Hash | undefined
 export function asHash(value: unknown, assert: AssertConfig): Hash
-export function asHash(value: unknown, bitLength?: HashBitLength): Hash | undefined
-export function asHash(value: unknown, bitLength: HashBitLength | undefined, assert: AssertConfig): Hash
-export function asHash(value: unknown, assertOrBitLength?: AssertConfig | HashBitLength, assertOnly?: AssertConfig): Hash | undefined {
-  const bitLength: HashBitLength = typeof assertOrBitLength === 'number' ? assertOrBitLength : 256
-  const assert = typeof assertOrBitLength !== 'number' ? assertOrBitLength : assertOnly
-
-  const result = asHex(value, bitLength, assert)
-  return isHash(result, bitLength) ? result : assertError(value, assert, 'Resulting value is not a Hash')
+export function asHash(value: unknown, assert?: AssertConfig): Hash | undefined {
+  let stringValue: string | undefined = undefined
+
+  switch (typeof value) {
+    case 'string':
+      stringValue = hexFromHexString(value)
+      break
+    default:
+      return assert ? assertError(value, assert, `Unsupported type [${typeof value}]`) : undefined
+  }
+  return isHash(stringValue) ? stringValue : assertError(value, assert, `Value is not a Hash [${value}]`)
 }

package/src/hex/as.ts

@@ -0,0 +1,20 @@
+import { AssertConfig, assertError } from '../assert'
+import { hexFromHexString } from './from'
+import { isHex } from './is'
+import { Hex } from './model'
+
+export function asHex(value: unknown): Hex | undefined
+export function asHex(value: unknown, assert: AssertConfig): Hex
+export function asHex(value: unknown, assert?: AssertConfig): Hex | undefined {
+  let stringValue: string | undefined = undefined
+
+  switch (typeof value) {
+    case 'string':
+      stringValue = hexFromHexString(value)
+      break
+    default:
+      return assertError(value, assert, `Unsupported type [${typeof value}]`)
+  }
+
+  return isHex(stringValue) ? stringValue : assertError(value, assert, `Value is not Hex [${value}]`)
+}

package/src/hex/from.ts

@@ -0,0 +1,52 @@
+import { isArrayBuffer } from '@xylabs/arraybuffer'
+
+import { isHex } from './is'
+import { HexConfig } from './model'
+import { bitsToNibbles } from './nibble'
+
+export const hexFromArrayBuffer = (buffer: ArrayBuffer, config?: HexConfig): string => {
+  const unPadded = [...new Uint8Array(buffer)].map((x) => x.toString(16).padStart(2, '0')).join('')
+  return hexFromHexString(unPadded, config)
+}
+
+export const hexFromBigInt = (value: bigint, config: HexConfig = {}): string => {
+  const { bitLength } = config
+  const unPadded = value.toString(16)
+  const padded = bitLength === undefined ? unPadded : unPadded.padStart(bitsToNibbles(bitLength), '0')
+  return hexFromHexString(padded, config)
+}
+
+export const hexFromNumber = (value: number, config?: HexConfig): string => {
+  return hexFromBigInt(BigInt(value), config)
+}
+
+export const hexFromHexString = (value: string, config: HexConfig = {}): string => {
+  const { prefix = false, byteSize = 8 } = config
+  const nibbleBoundary = bitsToNibbles(byteSize)
+  const unPadded = (value.startsWith('0x') ? value.substring(2) : value).toLowerCase()
+  if (isHex(unPadded)) {
+    const padded = unPadded.padStart(unPadded.length + (unPadded.length % nibbleBoundary), '0')
+    return prefix ? `0x${padded}` : padded
+  } else {
+    throw Error('Received string is not a value hex')
+  }
+}
+
+export const hexFrom = (value: unknown, config?: HexConfig): string => {
+  switch (typeof value) {
+    case 'string':
+      return hexFromHexString(value, config)
+    case 'bigint':
+      return hexFromBigInt(value, config)
+    case 'number':
+      return hexFromNumber(value, config)
+    case 'object':
+      if (isArrayBuffer(value)) {
+        return hexFromArrayBuffer(value, config)
+      } else {
+        throw Error('Invalid type: object !== ArrayBuffer')
+      }
+    default:
+      throw Error(`Invalid type: ${typeof value}`)
+  }
+}

package/src/hex/index.ts

@@ -0,0 +1,7 @@
+export * from './as'
+export * from './from'
+export * from './is'
+export * from './legacy'
+export * from './model'
+export * from './nibble'
+export * from './regex'

package/src/hex/is.ts

@@ -0,0 +1,19 @@
+import { hexFromHexString } from './from'
+import { Hex } from './model'
+import { bitsToNibbles } from './nibble'
+import { hexRegex } from './regex'
+
+export const isHexZero = (value: string) => {
+  return BigInt(hexFromHexString(value, { prefix: true })) === 0n
+}
+
+export const isHex = (value: unknown, bitLength?: number): value is Hex => {
+  //Is it a string?
+  if (typeof value !== 'string') return false
+
+  //If a bitLength specified, does it conform?
+  if (bitLength !== undefined && value.length !== bitsToNibbles(bitLength)) return false
+
+  //Does it only has hex values?
+  return hexRegex.test(value)
+}

package/src/hex/legacy.ts

@@ -0,0 +1,8 @@
+export const toHexLegacy = (buffer: ArrayBuffer) => {
+  return [...new Uint8Array(buffer)].map((x) => x.toString(16).padStart(2, '0')).join('')
+}
+
+/** @deprecated use toHexLegacy instead */
+export const toHex = (buffer: ArrayBuffer) => {
+  return toHexLegacy(buffer)
+}

package/src/hex/model.ts

@@ -0,0 +1,7 @@
+export type Hex = string
+
+export interface HexConfig {
+  bitLength?: number
+  byteSize?: number
+  prefix?: boolean
+}

package/src/hex/nibble.ts

@@ -0,0 +1,11 @@
+//determine the number of nibbles for a given number of bits
+export const bitsToNibbles = (value: number): number => {
+  const nibbles = value >> 2
+  if (value !== nibbles << 2) throw Error('Bits for nibbles must multiple of 4')
+  return nibbles
+}
+
+//determine the number of nibbles for a given number of bits
+export const nibblesToBits = (value: number): number => {
+  return value << 2
+}

package/src/hex/regex.ts

@@ -0,0 +1,2 @@
+export const hexRegex = /^[0-9a-f]+$/i
+export const hexRegexWithPrefix = /0x[0-9a-f]+$/i

package/dist/browser/hex.d.cts

@@ -1,15 +0,0 @@
-import { AssertConfig } from './assert';
-export declare const hexRegex: RegExp;
-export declare const hexRegexWithPrefix: RegExp;
-export type Hex = string;
-export declare const hexFrom: (buffer: ArrayBuffer) => string;
-export declare const bitsToNibbles: (value: number) => number;
-export declare const nibblesToBits: (value: number) => number;
-export declare const isRoundNibble: (value: number) => boolean;
-export declare const isHex: (value: unknown, bitLength?: number) => value is string;
-export declare const toHex: (buffer: ArrayBuffer) => string;
-export declare function asHex(value: unknown): Hex | undefined;
-export declare function asHex(value: unknown, bitLength?: number): Hex | undefined;
-export declare function asHex(value: unknown, assert: AssertConfig): Hex;
-export declare function asHex(value: unknown, bitLength: number | undefined, assert?: AssertConfig): Hex;
-//# sourceMappingURL=hex.d.ts.map

package/dist/browser/hex.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/hex.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAe,MAAM,UAAU,CAAA;AAEpD,eAAO,MAAM,QAAQ,QAAiB,CAAA;AACtC,eAAO,MAAM,kBAAkB,QAAkB,CAAA;AAEjD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAA;AAExB,eAAO,MAAM,OAAO,WAAY,WAAW,WAE1C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,MAI7C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,MAE7C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,YAE1C,CAAA;AAED,eAAO,MAAM,KAAK,UAAW,OAAO,cAAc,MAAM,oBASvD,CAAA;AAED,eAAO,MAAM,KAAK,WAAY,WAAW,WAExC,CAAA;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,GAAG,SAAS,CAAA;AACtD,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAA;AAC1E,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,GAAG,CAAA;AAChE,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,GAAG,CAAA"}

package/dist/browser/hex.d.mts

@@ -1,15 +0,0 @@
-import { AssertConfig } from './assert';
-export declare const hexRegex: RegExp;
-export declare const hexRegexWithPrefix: RegExp;
-export type Hex = string;
-export declare const hexFrom: (buffer: ArrayBuffer) => string;
-export declare const bitsToNibbles: (value: number) => number;
-export declare const nibblesToBits: (value: number) => number;
-export declare const isRoundNibble: (value: number) => boolean;
-export declare const isHex: (value: unknown, bitLength?: number) => value is string;
-export declare const toHex: (buffer: ArrayBuffer) => string;
-export declare function asHex(value: unknown): Hex | undefined;
-export declare function asHex(value: unknown, bitLength?: number): Hex | undefined;
-export declare function asHex(value: unknown, assert: AssertConfig): Hex;
-export declare function asHex(value: unknown, bitLength: number | undefined, assert?: AssertConfig): Hex;
-//# sourceMappingURL=hex.d.ts.map

package/dist/browser/hex.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/hex.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAe,MAAM,UAAU,CAAA;AAEpD,eAAO,MAAM,QAAQ,QAAiB,CAAA;AACtC,eAAO,MAAM,kBAAkB,QAAkB,CAAA;AAEjD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAA;AAExB,eAAO,MAAM,OAAO,WAAY,WAAW,WAE1C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,MAI7C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,MAE7C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,YAE1C,CAAA;AAED,eAAO,MAAM,KAAK,UAAW,OAAO,cAAc,MAAM,oBASvD,CAAA;AAED,eAAO,MAAM,KAAK,WAAY,WAAW,WAExC,CAAA;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,GAAG,SAAS,CAAA;AACtD,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAA;AAC1E,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,GAAG,CAAA;AAChE,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,GAAG,CAAA"}

package/dist/browser/hex.d.ts

@@ -1,15 +0,0 @@
-import { AssertConfig } from './assert';
-export declare const hexRegex: RegExp;
-export declare const hexRegexWithPrefix: RegExp;
-export type Hex = string;
-export declare const hexFrom: (buffer: ArrayBuffer) => string;
-export declare const bitsToNibbles: (value: number) => number;
-export declare const nibblesToBits: (value: number) => number;
-export declare const isRoundNibble: (value: number) => boolean;
-export declare const isHex: (value: unknown, bitLength?: number) => value is string;
-export declare const toHex: (buffer: ArrayBuffer) => string;
-export declare function asHex(value: unknown): Hex | undefined;
-export declare function asHex(value: unknown, bitLength?: number): Hex | undefined;
-export declare function asHex(value: unknown, assert: AssertConfig): Hex;
-export declare function asHex(value: unknown, bitLength: number | undefined, assert?: AssertConfig): Hex;
-//# sourceMappingURL=hex.d.ts.map

package/dist/browser/hex.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/hex.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAe,MAAM,UAAU,CAAA;AAEpD,eAAO,MAAM,QAAQ,QAAiB,CAAA;AACtC,eAAO,MAAM,kBAAkB,QAAkB,CAAA;AAEjD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAA;AAExB,eAAO,MAAM,OAAO,WAAY,WAAW,WAE1C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,MAI7C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,MAE7C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,YAE1C,CAAA;AAED,eAAO,MAAM,KAAK,UAAW,OAAO,cAAc,MAAM,oBASvD,CAAA;AAED,eAAO,MAAM,KAAK,WAAY,WAAW,WAExC,CAAA;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,GAAG,SAAS,CAAA;AACtD,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAA;AAC1E,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,GAAG,CAAA;AAChE,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,GAAG,CAAA"}

package/dist/node/hex.d.cts

@@ -1,15 +0,0 @@
-import { AssertConfig } from './assert';
-export declare const hexRegex: RegExp;
-export declare const hexRegexWithPrefix: RegExp;
-export type Hex = string;
-export declare const hexFrom: (buffer: ArrayBuffer) => string;
-export declare const bitsToNibbles: (value: number) => number;
-export declare const nibblesToBits: (value: number) => number;
-export declare const isRoundNibble: (value: number) => boolean;
-export declare const isHex: (value: unknown, bitLength?: number) => value is string;
-export declare const toHex: (buffer: ArrayBuffer) => string;
-export declare function asHex(value: unknown): Hex | undefined;
-export declare function asHex(value: unknown, bitLength?: number): Hex | undefined;
-export declare function asHex(value: unknown, assert: AssertConfig): Hex;
-export declare function asHex(value: unknown, bitLength: number | undefined, assert?: AssertConfig): Hex;
-//# sourceMappingURL=hex.d.ts.map

package/dist/node/hex.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/hex.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAe,MAAM,UAAU,CAAA;AAEpD,eAAO,MAAM,QAAQ,QAAiB,CAAA;AACtC,eAAO,MAAM,kBAAkB,QAAkB,CAAA;AAEjD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAA;AAExB,eAAO,MAAM,OAAO,WAAY,WAAW,WAE1C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,MAI7C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,MAE7C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,YAE1C,CAAA;AAED,eAAO,MAAM,KAAK,UAAW,OAAO,cAAc,MAAM,oBASvD,CAAA;AAED,eAAO,MAAM,KAAK,WAAY,WAAW,WAExC,CAAA;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,GAAG,SAAS,CAAA;AACtD,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAA;AAC1E,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,GAAG,CAAA;AAChE,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,GAAG,CAAA"}

package/dist/node/hex.d.mts

@@ -1,15 +0,0 @@
-import { AssertConfig } from './assert';
-export declare const hexRegex: RegExp;
-export declare const hexRegexWithPrefix: RegExp;
-export type Hex = string;
-export declare const hexFrom: (buffer: ArrayBuffer) => string;
-export declare const bitsToNibbles: (value: number) => number;
-export declare const nibblesToBits: (value: number) => number;
-export declare const isRoundNibble: (value: number) => boolean;
-export declare const isHex: (value: unknown, bitLength?: number) => value is string;
-export declare const toHex: (buffer: ArrayBuffer) => string;
-export declare function asHex(value: unknown): Hex | undefined;
-export declare function asHex(value: unknown, bitLength?: number): Hex | undefined;
-export declare function asHex(value: unknown, assert: AssertConfig): Hex;
-export declare function asHex(value: unknown, bitLength: number | undefined, assert?: AssertConfig): Hex;
-//# sourceMappingURL=hex.d.ts.map

package/dist/node/hex.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/hex.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAe,MAAM,UAAU,CAAA;AAEpD,eAAO,MAAM,QAAQ,QAAiB,CAAA;AACtC,eAAO,MAAM,kBAAkB,QAAkB,CAAA;AAEjD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAA;AAExB,eAAO,MAAM,OAAO,WAAY,WAAW,WAE1C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,MAI7C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,MAE7C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,YAE1C,CAAA;AAED,eAAO,MAAM,KAAK,UAAW,OAAO,cAAc,MAAM,oBASvD,CAAA;AAED,eAAO,MAAM,KAAK,WAAY,WAAW,WAExC,CAAA;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,GAAG,SAAS,CAAA;AACtD,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAA;AAC1E,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,GAAG,CAAA;AAChE,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,GAAG,CAAA"}

package/dist/node/hex.d.ts

@@ -1,15 +0,0 @@
-import { AssertConfig } from './assert';
-export declare const hexRegex: RegExp;
-export declare const hexRegexWithPrefix: RegExp;
-export type Hex = string;
-export declare const hexFrom: (buffer: ArrayBuffer) => string;
-export declare const bitsToNibbles: (value: number) => number;
-export declare const nibblesToBits: (value: number) => number;
-export declare const isRoundNibble: (value: number) => boolean;
-export declare const isHex: (value: unknown, bitLength?: number) => value is string;
-export declare const toHex: (buffer: ArrayBuffer) => string;
-export declare function asHex(value: unknown): Hex | undefined;
-export declare function asHex(value: unknown, bitLength?: number): Hex | undefined;
-export declare function asHex(value: unknown, assert: AssertConfig): Hex;
-export declare function asHex(value: unknown, bitLength: number | undefined, assert?: AssertConfig): Hex;
-//# sourceMappingURL=hex.d.ts.map

package/dist/node/hex.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/hex.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAe,MAAM,UAAU,CAAA;AAEpD,eAAO,MAAM,QAAQ,QAAiB,CAAA;AACtC,eAAO,MAAM,kBAAkB,QAAkB,CAAA;AAEjD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAA;AAExB,eAAO,MAAM,OAAO,WAAY,WAAW,WAE1C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,MAI7C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,KAAG,MAE7C,CAAA;AAGD,eAAO,MAAM,aAAa,UAAW,MAAM,YAE1C,CAAA;AAED,eAAO,MAAM,KAAK,UAAW,OAAO,cAAc,MAAM,oBASvD,CAAA;AAED,eAAO,MAAM,KAAK,WAAY,WAAW,WAExC,CAAA;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,GAAG,SAAS,CAAA;AACtD,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAA;AAC1E,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,GAAG,CAAA;AAChE,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,GAAG,CAAA"}

package/src/hex.ts

@@ -1,88 +0,0 @@
-import { isArrayBuffer } from '@xylabs/arraybuffer'
-
-import { AssertConfig, assertError } from './assert'
-
-export const hexRegex = /^[0-9a-f]+$/i
-export const hexRegexWithPrefix = /0x[0-9a-f]+$/i
-
-export type Hex = string
-
-export const hexFrom = (buffer: ArrayBuffer) => {
-  return [...new Uint8Array(buffer)].map((x) => x.toString(16).padStart(2, '0')).join('')
-}
-
-//determine the number of nibbles for a given number of bits
-export const bitsToNibbles = (value: number): number => {
-  const nibbles = value >> 2
-  if (value !== nibbles << 2) throw Error('Bits for nibbles must multiple of 4')
-  return nibbles
-}
-
-//determine the number of nibbles for a given number of bits
-export const nibblesToBits = (value: number): number => {
-  return value << 2
-}
-
-//are the number of bit a round nibble (factor of 4)?
-export const isRoundNibble = (value: number) => {
-  return (value >> 2) << 2 === value
-}
-
-export const isHex = (value: unknown, bitLength?: number): value is Hex => {
-  //Is it a string?
-  if (typeof value !== 'string') return false
-
-  //If a bitLength specified, does it conform?
-  if (bitLength !== undefined && value.length !== bitsToNibbles(bitLength)) return false
-
-  //Does it only has hex values?
-  return hexRegex.test(value)
-}
-
-export const toHex = (buffer: ArrayBuffer) => {
-  return [...new Uint8Array(buffer)].map((x) => x.toString(16).padStart(2, '0')).join('')
-}
-
-export function asHex(value: unknown): Hex | undefined
-export function asHex(value: unknown, bitLength?: number): Hex | undefined
-export function asHex(value: unknown, assert: AssertConfig): Hex
-export function asHex(value: unknown, bitLength: number | undefined, assert?: AssertConfig): Hex
-export function asHex(value: unknown, assertOrBitLength?: AssertConfig | number, assertOnly?: AssertConfig): Hex | undefined {
-  const bitLength = typeof assertOrBitLength === 'number' ? assertOrBitLength : undefined
-  const assert = typeof assertOrBitLength !== 'number' ? assertOrBitLength : assertOnly
-
-  let stringValue: string | undefined = undefined
-
-  switch (typeof value) {
-    case 'string':
-      //remove the leading 0x if it is there
-      stringValue = hexRegexWithPrefix.test(value) ? value.substring(2) : value
-      break
-    case 'number':
-      if (value === Math.floor(value)) {
-        stringValue = value.toString(16)
-      } else {
-        return assertError(value, assert, 'Numbers must be whole')
-      }
-      break
-    case 'bigint':
-      stringValue = value.toString(16)
-      break
-    case 'object':
-      if (isArrayBuffer(value)) {
-        stringValue = hexFrom(value)
-      } else {
-        return assertError(value, assert, 'Unsupported object')
-      }
-      break
-    default:
-      return assertError(value, assert, `Unsupported type [${typeof value}]`)
-  }
-
-  //make it conform to the bit length if shorter
-  if (stringValue && bitLength) {
-    stringValue = stringValue.padStart(bitsToNibbles(bitLength), '0')
-  }
-
-  return isHex(stringValue, bitLength) ? stringValue.toLowerCase() : assertError(value, assert, 'Unable to convert to Hash')
-}