@xylabs/arraybuffer 4.5.0 → 4.5.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.
@@ -1 +1 @@
1
- {"version":3,"file":"equalArrayBuffers.d.ts","sourceRoot":"","sources":["../../src/equalArrayBuffers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,OAAQ,eAAe,MAAM,eAAe,YAQzE,CAAA"}
1
+ {"version":3,"file":"equalArrayBuffers.d.ts","sourceRoot":"","sources":["../../src/equalArrayBuffers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,GAAI,IAAI,eAAe,EAAE,IAAI,eAAe,YAQzE,CAAA"}
@@ -18,27 +18,36 @@ var isArrayBufferLike = (value) => {
18
18
  };
19
19
 
20
20
  // src/toArrayBuffer.ts
21
- import { base16, base58 } from "@scure/base";
22
21
  import { assertEx } from "@xylabs/assert";
23
- var stringToUInt8Array = (value, base = 16) => {
22
+ import { toHex } from "@xylabs/hex";
23
+ function hexToArrayBuffer(value) {
24
+ if (value.length % 2 !== 0) {
25
+ throw new Error("Invalid hex value");
26
+ }
27
+ const length = value.length / 2;
28
+ const result = new Uint8Array(new ArrayBuffer(length));
29
+ for (let i = 0; i < length; i++) {
30
+ const byte = value.slice(i * 2, i * 2 + 2);
31
+ result[i] = Number.parseInt(byte, 16);
32
+ }
33
+ return result;
34
+ }
35
+ function stringToArrayBuffer(value, base = 16) {
24
36
  switch (base) {
25
37
  case 16: {
26
- return base16.decode((value.startsWith("0x") ? value.slice(2) : value).toUpperCase());
27
- }
28
- case 58: {
29
- return base58.decode(value);
38
+ return hexToArrayBuffer(toHex((value.startsWith("0x") ? value.slice(2) : value).toUpperCase()));
30
39
  }
31
40
  default: {
32
41
  throw new Error(`Unsupported base [${base}]`);
33
42
  }
34
43
  }
35
- };
44
+ }
36
45
  function toArrayBuffer(value, padLength, base) {
37
46
  if (value === void 0) return void 0;
38
47
  if (typeof value === "bigint" && value < 0) {
39
48
  throw new Error(`negative bigint values are not supported: ${typeof value}`);
40
49
  }
41
- let result = typeof value === "string" ? stringToUInt8Array(value, base) : typeof value === "bigint" ? stringToUInt8Array(value.toString(16)) : new Uint8Array(value);
50
+ let result = typeof value === "string" ? stringToArrayBuffer(value, base) : typeof value === "bigint" ? stringToArrayBuffer(value.toString(16)) : new Uint8Array(value);
42
51
  if (result === void 0) {
43
52
  throw new Error(`toArrayBuffer - Unknown type: ${typeof value}`);
44
53
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/equalArrayBuffers.ts","../../src/isArrayBuffer.ts","../../src/toArrayBuffer.ts","../../src/toUint8Array.ts"],"sourcesContent":["export const equalArrayBuffers = (a1: ArrayBufferLike, a2: ArrayBufferLike) => {\n const u1 = new Uint8Array(a1)\n const u2 = new Uint8Array(a2)\n if (u1.byteLength !== u2.byteLength) return false\n for (let i = 0; i < u1.byteLength; i++) {\n if (u1[i] !== u2[i]) return false\n }\n return true\n}\n","export const isArrayBuffer = (value: unknown): value is ArrayBuffer => {\n return value instanceof ArrayBuffer\n}\n\nexport const isArrayBufferLike = (value: unknown): value is ArrayBufferLike => {\n return (\n value !== null\n && typeof value === 'object'\n && 'byteLength' in value\n && typeof (value as ArrayBufferLike).byteLength === 'number'\n && 'slice' in value\n && typeof (value as ArrayBufferLike).slice === 'function'\n )\n}\n","import { base16, base58 } from '@scure/base'\nimport { assertEx } from '@xylabs/assert'\n\nconst stringToUInt8Array = (value: string, base = 16): Uint8Array => {\n switch (base) {\n case 16: {\n return base16.decode((value.startsWith('0x') ? value.slice(2) : value).toUpperCase())\n }\n case 58: {\n return base58.decode(value)\n }\n default: {\n throw new Error(`Unsupported base [${base}]`)\n }\n }\n}\n\nexport function toArrayBuffer(value: undefined, padLength?: number, base?: number): undefined\nexport function toArrayBuffer(value: ArrayBufferLike | bigint | string, padLength?: number, base?: number): ArrayBufferLike\nexport function toArrayBuffer(value: ArrayBufferLike | bigint | string | undefined, padLength?: number, base?: number): ArrayBufferLike | undefined\nexport function toArrayBuffer(value?: ArrayBufferLike | bigint | string, padLength?: number, base?: number): ArrayBufferLike | undefined {\n if (value === undefined) return undefined\n\n if (typeof value === 'bigint' && value < 0) {\n throw new Error(`negative bigint values are not supported: ${typeof value}`)\n }\n\n let result: Uint8Array | undefined\n = typeof value === 'string'\n ? stringToUInt8Array(value, base)\n : typeof value === 'bigint' ? stringToUInt8Array(value.toString(16)) : (new Uint8Array(value))\n\n if (result === undefined) {\n throw new Error(`toArrayBuffer - Unknown type: ${typeof value}`)\n }\n\n if (padLength && result.length < padLength) {\n result = new Uint8Array([...new Uint8Array(padLength - result.length), ...result])\n assertEx(result?.length <= padLength, () => 'Resulting length is greater than padLength')\n }\n\n return result.buffer\n}\n","import { toArrayBuffer } from './toArrayBuffer.ts'\n\nexport function toUint8Array(value: undefined, padLength?: number, base?: number): undefined\nexport function toUint8Array(value: ArrayBufferLike | bigint | string, padLength?: number, base?: number): Uint8Array\nexport function toUint8Array(value: ArrayBufferLike | bigint | string | undefined, padLength?: number, base?: number): Uint8Array | undefined\nexport function toUint8Array(value?: ArrayBufferLike | bigint | string, padLength?: number, base?: number): Uint8Array | undefined {\n const arrayBuffer = toArrayBuffer(value, padLength, base)\n return arrayBuffer ? new Uint8Array(arrayBuffer) : undefined\n}\n"],"mappings":";AAAO,IAAM,oBAAoB,CAAC,IAAqB,OAAwB;AAC7E,QAAM,KAAK,IAAI,WAAW,EAAE;AAC5B,QAAM,KAAK,IAAI,WAAW,EAAE;AAC5B,MAAI,GAAG,eAAe,GAAG,WAAY,QAAO;AAC5C,WAAS,IAAI,GAAG,IAAI,GAAG,YAAY,KAAK;AACtC,QAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAG,QAAO;AAAA,EAC9B;AACA,SAAO;AACT;;;ACRO,IAAM,gBAAgB,CAAC,UAAyC;AACrE,SAAO,iBAAiB;AAC1B;AAEO,IAAM,oBAAoB,CAAC,UAA6C;AAC7E,SACE,UAAU,QACP,OAAO,UAAU,YACjB,gBAAgB,SAChB,OAAQ,MAA0B,eAAe,YACjD,WAAW,SACX,OAAQ,MAA0B,UAAU;AAEnD;;;ACbA,SAAS,QAAQ,cAAc;AAC/B,SAAS,gBAAgB;AAEzB,IAAM,qBAAqB,CAAC,OAAe,OAAO,OAAmB;AACnE,UAAQ,MAAM;AAAA,IACZ,KAAK,IAAI;AACP,aAAO,OAAO,QAAQ,MAAM,WAAW,IAAI,IAAI,MAAM,MAAM,CAAC,IAAI,OAAO,YAAY,CAAC;AAAA,IACtF;AAAA,IACA,KAAK,IAAI;AACP,aAAO,OAAO,OAAO,KAAK;AAAA,IAC5B;AAAA,IACA,SAAS;AACP,YAAM,IAAI,MAAM,qBAAqB,IAAI,GAAG;AAAA,IAC9C;AAAA,EACF;AACF;AAKO,SAAS,cAAc,OAA2C,WAAoB,MAA4C;AACvI,MAAI,UAAU,OAAW,QAAO;AAEhC,MAAI,OAAO,UAAU,YAAY,QAAQ,GAAG;AAC1C,UAAM,IAAI,MAAM,6CAA6C,OAAO,KAAK,EAAE;AAAA,EAC7E;AAEA,MAAI,SACA,OAAO,UAAU,WACf,mBAAmB,OAAO,IAAI,IAC9B,OAAO,UAAU,WAAW,mBAAmB,MAAM,SAAS,EAAE,CAAC,IAAK,IAAI,WAAW,KAAK;AAEhG,MAAI,WAAW,QAAW;AACxB,UAAM,IAAI,MAAM,iCAAiC,OAAO,KAAK,EAAE;AAAA,EACjE;AAEA,MAAI,aAAa,OAAO,SAAS,WAAW;AAC1C,aAAS,IAAI,WAAW,CAAC,GAAG,IAAI,WAAW,YAAY,OAAO,MAAM,GAAG,GAAG,MAAM,CAAC;AACjF,aAAS,QAAQ,UAAU,WAAW,MAAM,4CAA4C;AAAA,EAC1F;AAEA,SAAO,OAAO;AAChB;;;ACrCO,SAAS,aAAa,OAA2C,WAAoB,MAAuC;AACjI,QAAM,cAAc,cAAc,OAAO,WAAW,IAAI;AACxD,SAAO,cAAc,IAAI,WAAW,WAAW,IAAI;AACrD;","names":[]}
1
+ {"version":3,"sources":["../../src/equalArrayBuffers.ts","../../src/isArrayBuffer.ts","../../src/toArrayBuffer.ts","../../src/toUint8Array.ts"],"sourcesContent":["export const equalArrayBuffers = (a1: ArrayBufferLike, a2: ArrayBufferLike) => {\n const u1 = new Uint8Array(a1)\n const u2 = new Uint8Array(a2)\n if (u1.byteLength !== u2.byteLength) return false\n for (let i = 0; i < u1.byteLength; i++) {\n if (u1[i] !== u2[i]) return false\n }\n return true\n}\n","export const isArrayBuffer = (value: unknown): value is ArrayBuffer => {\n return value instanceof ArrayBuffer\n}\n\nexport const isArrayBufferLike = (value: unknown): value is ArrayBufferLike => {\n return (\n value !== null\n && typeof value === 'object'\n && 'byteLength' in value\n && typeof (value as ArrayBufferLike).byteLength === 'number'\n && 'slice' in value\n && typeof (value as ArrayBufferLike).slice === 'function'\n )\n}\n","import { assertEx } from '@xylabs/assert'\nimport type { Hex } from '@xylabs/hex'\nimport { toHex } from '@xylabs/hex'\n\nfunction hexToArrayBuffer(value: Hex): Uint8Array {\n if (value.length % 2 !== 0) {\n throw new Error('Invalid hex value')\n }\n\n const length = value.length / 2\n const result = new Uint8Array(new ArrayBuffer(length))\n\n for (let i = 0; i < length; i++) {\n const byte = value.slice(i * 2, i * 2 + 2)\n result[i] = Number.parseInt(byte, 16)\n }\n\n return result\n}\n\nfunction stringToArrayBuffer(value: string, base = 16): Uint8Array {\n switch (base) {\n case 16: {\n return hexToArrayBuffer(toHex((value.startsWith('0x') ? value.slice(2) : value).toUpperCase()))\n }\n default: {\n throw new Error(`Unsupported base [${base}]`)\n }\n }\n}\n\nexport function toArrayBuffer(value: undefined, padLength?: number, base?: number): undefined\nexport function toArrayBuffer(value: ArrayBufferLike | bigint | string, padLength?: number, base?: number): ArrayBufferLike\nexport function toArrayBuffer(value: ArrayBufferLike | bigint | string | undefined, padLength?: number, base?: number): ArrayBufferLike | undefined\nexport function toArrayBuffer(value?: ArrayBufferLike | bigint | string, padLength?: number, base?: number): ArrayBufferLike | undefined {\n if (value === undefined) return undefined\n\n if (typeof value === 'bigint' && value < 0) {\n throw new Error(`negative bigint values are not supported: ${typeof value}`)\n }\n\n let result: Uint8Array | undefined\n = typeof value === 'string'\n ? stringToArrayBuffer(value, base)\n : typeof value === 'bigint' ? stringToArrayBuffer(value.toString(16)) : (new Uint8Array(value))\n\n if (result === undefined) {\n throw new Error(`toArrayBuffer - Unknown type: ${typeof value}`)\n }\n\n if (padLength && result.length < padLength) {\n result = new Uint8Array([...new Uint8Array(padLength - result.length), ...result])\n assertEx(result?.length <= padLength, () => 'Resulting length is greater than padLength')\n }\n\n return result.buffer\n}\n","import { toArrayBuffer } from './toArrayBuffer.ts'\n\nexport function toUint8Array(value: undefined, padLength?: number, base?: number): undefined\nexport function toUint8Array(value: ArrayBufferLike | bigint | string, padLength?: number, base?: number): Uint8Array\nexport function toUint8Array(value: ArrayBufferLike | bigint | string | undefined, padLength?: number, base?: number): Uint8Array | undefined\nexport function toUint8Array(value?: ArrayBufferLike | bigint | string, padLength?: number, base?: number): Uint8Array | undefined {\n const arrayBuffer = toArrayBuffer(value, padLength, base)\n return arrayBuffer ? new Uint8Array(arrayBuffer) : undefined\n}\n"],"mappings":";AAAO,IAAM,oBAAoB,CAAC,IAAqB,OAAwB;AAC7E,QAAM,KAAK,IAAI,WAAW,EAAE;AAC5B,QAAM,KAAK,IAAI,WAAW,EAAE;AAC5B,MAAI,GAAG,eAAe,GAAG,WAAY,QAAO;AAC5C,WAAS,IAAI,GAAG,IAAI,GAAG,YAAY,KAAK;AACtC,QAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAG,QAAO;AAAA,EAC9B;AACA,SAAO;AACT;;;ACRO,IAAM,gBAAgB,CAAC,UAAyC;AACrE,SAAO,iBAAiB;AAC1B;AAEO,IAAM,oBAAoB,CAAC,UAA6C;AAC7E,SACE,UAAU,QACP,OAAO,UAAU,YACjB,gBAAgB,SAChB,OAAQ,MAA0B,eAAe,YACjD,WAAW,SACX,OAAQ,MAA0B,UAAU;AAEnD;;;ACbA,SAAS,gBAAgB;AAEzB,SAAS,aAAa;AAEtB,SAAS,iBAAiB,OAAwB;AAChD,MAAI,MAAM,SAAS,MAAM,GAAG;AAC1B,UAAM,IAAI,MAAM,mBAAmB;AAAA,EACrC;AAEA,QAAM,SAAS,MAAM,SAAS;AAC9B,QAAM,SAAS,IAAI,WAAW,IAAI,YAAY,MAAM,CAAC;AAErD,WAAS,IAAI,GAAG,IAAI,QAAQ,KAAK;AAC/B,UAAM,OAAO,MAAM,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC;AACzC,WAAO,CAAC,IAAI,OAAO,SAAS,MAAM,EAAE;AAAA,EACtC;AAEA,SAAO;AACT;AAEA,SAAS,oBAAoB,OAAe,OAAO,IAAgB;AACjE,UAAQ,MAAM;AAAA,IACZ,KAAK,IAAI;AACP,aAAO,iBAAiB,OAAO,MAAM,WAAW,IAAI,IAAI,MAAM,MAAM,CAAC,IAAI,OAAO,YAAY,CAAC,CAAC;AAAA,IAChG;AAAA,IACA,SAAS;AACP,YAAM,IAAI,MAAM,qBAAqB,IAAI,GAAG;AAAA,IAC9C;AAAA,EACF;AACF;AAKO,SAAS,cAAc,OAA2C,WAAoB,MAA4C;AACvI,MAAI,UAAU,OAAW,QAAO;AAEhC,MAAI,OAAO,UAAU,YAAY,QAAQ,GAAG;AAC1C,UAAM,IAAI,MAAM,6CAA6C,OAAO,KAAK,EAAE;AAAA,EAC7E;AAEA,MAAI,SACA,OAAO,UAAU,WACf,oBAAoB,OAAO,IAAI,IAC/B,OAAO,UAAU,WAAW,oBAAoB,MAAM,SAAS,EAAE,CAAC,IAAK,IAAI,WAAW,KAAK;AAEjG,MAAI,WAAW,QAAW;AACxB,UAAM,IAAI,MAAM,iCAAiC,OAAO,KAAK,EAAE;AAAA,EACjE;AAEA,MAAI,aAAa,OAAO,SAAS,WAAW;AAC1C,aAAS,IAAI,WAAW,CAAC,GAAG,IAAI,WAAW,YAAY,OAAO,MAAM,GAAG,GAAG,MAAM,CAAC;AACjF,aAAS,QAAQ,UAAU,WAAW,MAAM,4CAA4C;AAAA,EAC1F;AAEA,SAAO,OAAO;AAChB;;;ACnDO,SAAS,aAAa,OAA2C,WAAoB,MAAuC;AACjI,QAAM,cAAc,cAAc,OAAO,WAAW,IAAI;AACxD,SAAO,cAAc,IAAI,WAAW,WAAW,IAAI;AACrD;","names":[]}
@@ -1 +1 @@
1
- {"version":3,"file":"isArrayBuffer.d.ts","sourceRoot":"","sources":["../../src/isArrayBuffer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,KAAK,IAAI,WAEvD,CAAA;AAED,eAAO,MAAM,iBAAiB,UAAW,OAAO,KAAG,KAAK,IAAI,eAS3D,CAAA"}
1
+ {"version":3,"file":"isArrayBuffer.d.ts","sourceRoot":"","sources":["../../src/isArrayBuffer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WAEvD,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAS3D,CAAA"}
@@ -1 +1 @@
1
- {"version":3,"file":"toArrayBuffer.d.ts","sourceRoot":"","sources":["../../src/toArrayBuffer.ts"],"names":[],"mappings":"AAiBA,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;AAC7F,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAA;AAC3H,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAA"}
1
+ {"version":3,"file":"toArrayBuffer.d.ts","sourceRoot":"","sources":["../../src/toArrayBuffer.ts"],"names":[],"mappings":"AA+BA,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;AAC7F,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAA;AAC3H,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAA"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xylabs/arraybuffer",
3
- "version": "4.5.0",
3
+ "version": "4.5.2",
4
4
  "description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
5
5
  "keywords": [
6
6
  "xylabs",
@@ -35,14 +35,14 @@
35
35
  "module": "dist/neutral/index.mjs",
36
36
  "types": "dist/neutral/index.d.ts",
37
37
  "dependencies": {
38
- "@scure/base": "^1.2.4",
39
- "@xylabs/assert": "^4.5.0"
38
+ "@xylabs/assert": "^4.5.2",
39
+ "@xylabs/hex": "^4.5.2"
40
40
  },
41
41
  "devDependencies": {
42
- "@xylabs/ts-scripts-yarn3": "^4.2.6",
43
- "@xylabs/tsconfig": "^4.2.6",
44
- "typescript": "^5.7.3",
45
- "vitest": "^3.0.3"
42
+ "@xylabs/ts-scripts-yarn3": "^5.0.39",
43
+ "@xylabs/tsconfig": "^5.0.39",
44
+ "typescript": "^5.8.2",
45
+ "vitest": "^3.0.7"
46
46
  },
47
47
  "engines": {
48
48
  "node": ">=18"
@@ -1,13 +1,27 @@
1
- import { base16, base58 } from '@scure/base'
2
1
  import { assertEx } from '@xylabs/assert'
2
+ import type { Hex } from '@xylabs/hex'
3
+ import { toHex } from '@xylabs/hex'
3
4
 
4
- const stringToUInt8Array = (value: string, base = 16): Uint8Array => {
5
+ function hexToArrayBuffer(value: Hex): Uint8Array {
6
+ if (value.length % 2 !== 0) {
7
+ throw new Error('Invalid hex value')
8
+ }
9
+
10
+ const length = value.length / 2
11
+ const result = new Uint8Array(new ArrayBuffer(length))
12
+
13
+ for (let i = 0; i < length; i++) {
14
+ const byte = value.slice(i * 2, i * 2 + 2)
15
+ result[i] = Number.parseInt(byte, 16)
16
+ }
17
+
18
+ return result
19
+ }
20
+
21
+ function stringToArrayBuffer(value: string, base = 16): Uint8Array {
5
22
  switch (base) {
6
23
  case 16: {
7
- return base16.decode((value.startsWith('0x') ? value.slice(2) : value).toUpperCase())
8
- }
9
- case 58: {
10
- return base58.decode(value)
24
+ return hexToArrayBuffer(toHex((value.startsWith('0x') ? value.slice(2) : value).toUpperCase()))
11
25
  }
12
26
  default: {
13
27
  throw new Error(`Unsupported base [${base}]`)
@@ -27,8 +41,8 @@ export function toArrayBuffer(value?: ArrayBufferLike | bigint | string, padLeng
27
41
 
28
42
  let result: Uint8Array | undefined
29
43
  = typeof value === 'string'
30
- ? stringToUInt8Array(value, base)
31
- : typeof value === 'bigint' ? stringToUInt8Array(value.toString(16)) : (new Uint8Array(value))
44
+ ? stringToArrayBuffer(value, base)
45
+ : typeof value === 'bigint' ? stringToArrayBuffer(value.toString(16)) : (new Uint8Array(value))
32
46
 
33
47
  if (result === undefined) {
34
48
  throw new Error(`toArrayBuffer - Unknown type: ${typeof value}`)