@gsknnft/bigint-buffer 1.4.1 → 1.4.2

package/src/conversion/docs/functions/toBigIntBE.md

@@ -0,0 +1,27 @@
+[**bigint-conversion**](../README.md)
+
+***
+
+[bigint-conversion](../README.md) / toBigIntBE
+
+# Function: toBigIntBE()
+
+> **toBigIntBE**(`buf`): `bigint`
+
+Defined in: index.ts:63
+
+Convert a big-endian buffer into a BigInt
+
+## Parameters
+
+### buf
+
+`Buffer`
+
+The big-endian buffer to convert.
+
+## Returns
+
+`bigint`
+
+A BigInt with the big-endian representation of buf.

package/src/conversion/docs/functions/toBigIntLE.md

@@ -0,0 +1,27 @@
+[**bigint-conversion**](../README.md)
+
+***
+
+[bigint-conversion](../README.md) / toBigIntLE
+
+# Function: toBigIntLE()
+
+> **toBigIntLE**(`buf`): `bigint`
+
+Defined in: index.ts:36
+
+Convert a little-endian buffer into a BigInt.
+
+## Parameters
+
+### buf
+
+`Buffer`
+
+The little-endian buffer to convert
+
+## Returns
+
+`bigint`
+
+A BigInt with the little-endian representation of buf.

package/src/conversion/docs/functions/toBufferBE.md

@@ -0,0 +1,33 @@
+[**bigint-conversion**](../README.md)
+
+***
+
+[bigint-conversion](../README.md) / toBufferBE
+
+# Function: toBufferBE()
+
+> **toBufferBE**(`num`, `width`): `Buffer`
+
+Defined in: index.ts:98
+
+Convert a BigInt to a big-endian buffer.
+
+## Parameters
+
+### num
+
+`bigint`
+
+The BigInt to convert.
+
+### width
+
+`number`
+
+The number of bytes that the resulting buffer should be.
+
+## Returns
+
+`Buffer`
+
+A big-endian buffer representation of num.

package/src/conversion/docs/functions/toBufferLE.md

@@ -0,0 +1,33 @@
+[**bigint-conversion**](../README.md)
+
+***
+
+[bigint-conversion](../README.md) / toBufferLE
+
+# Function: toBufferLE()
+
+> **toBufferLE**(`num`, `width`): `Buffer`
+
+Defined in: index.ts:80
+
+Convert a BigInt to a little-endian buffer.
+
+## Parameters
+
+### num
+
+`bigint`
+
+The BigInt to convert.
+
+### width
+
+`number`
+
+The number of bytes that the resulting buffer should be.
+
+## Returns
+
+`Buffer`
+
+A little-endian buffer representation of num.

package/src/conversion/docs/functions/validateBigIntBuffer.md

@@ -0,0 +1,15 @@
+[**bigint-conversion**](../README.md)
+
+***
+
+[bigint-conversion](../README.md) / validateBigIntBuffer
+
+# Function: validateBigIntBuffer()
+
+> **validateBigIntBuffer**(): `boolean`
+
+Defined in: index.ts:49
+
+## Returns
+
+`boolean`

package/src/conversion/docs/type-aliases/TypedArray.md

@@ -0,0 +1,11 @@
+[**bigint-conversion**](../README.md)
+
+***
+
+[bigint-conversion](../README.md) / TypedArray
+
+# Type Alias: TypedArray
+
+> **TypedArray** = `Int8Array` \| `Uint8Array` \| `Uint8ClampedArray` \| `Int16Array` \| `Uint16Array` \| `Int32Array` \| `Uint32Array` \| `Float32Array` \| `Float64Array` \| `BigInt64Array` \| `BigUint64Array`
+
+Defined in: index.ts:106

package/src/conversion/docs/variables/isNative.md

@@ -0,0 +1,11 @@
+[**bigint-conversion**](../README.md)
+
+***
+
+[bigint-conversion](../README.md) / isNative
+
+# Variable: isNative
+
+> **isNative**: `boolean` = `false`
+
+Defined in: index.ts:10

package/src/conversion/example.cjs

@@ -0,0 +1,9 @@
+const bcu = require('.')
+
+const bi = 87213425n
+console.log(bi)
+
+const b64 = bcu.bigintToBase64(bi)
+console.log(b64)
+
+console.log(bcu.base64ToBigint(b64))

package/src/conversion/example.esm.js

@@ -0,0 +1,11 @@
+import { bigintToBase64, base64ToBigint } from './dist/esm/index.node.js'
+
+const bi = 87213425n
+console.log(bi)
+
+const b64 = bigintToBase64(bi)
+console.log(b64)
+
+console.log(base64ToBigint(b64))
+
+export {}

package/src/conversion/index.ts

@@ -0,0 +1 @@
+export * from './src/ts/index';

package/src/conversion/package.json

@@ -0,0 +1,163 @@
+{
+  "name": "bigint-conversion",
+  "version": "2.4.3",
+  "description": "Convert to/from BigInt from/to Buffer, ArrayBuffer, hex string, utf8-encoded text string.",
+  "keywords": [
+    "BigInt",
+    "bignum",
+    "big integer",
+    "text",
+    "utf8",
+    "hex",
+    "Buffer",
+    "ArrayBuffer",
+    "TypedArray"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Juan Hernández Serrano",
+    "email": "j.hernandez@upc.edu",
+    "url": "https://github.com/juanelas"
+  },
+  "repository": "github:juanelas/bigint-conversion",
+  "main": "./dist/cjs/index.node.js",
+  "browser": "./dist/esm/index.browser.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "node": {
+        "import": {
+          "types": "./dist/index.d.ts",
+          "default": "./dist/esm/index.node.js"
+        },
+        "require": {
+          "types": "./dist/index.d.ts",
+          "default": "./dist/node.js"
+        }
+      },
+      "script": "./dist/bundle.iife.js",
+      "default": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/esm/index.browser.js"
+      }
+    },
+    "./esm-browser-bundle": "./dist/esm/bundle.min.js",
+    "./dist/esm/bundle.min.js": "./dist/esm/bundle.min.js",
+    "./esm-browser-bundle-nomin": "./dist/esm/bundle.js",
+    "./dist/esm/bundle.js": "./dist/esm/bundle.js",
+    "./iife-browser-bundle": "./dist/bundle.iife.js",
+    "./dist/bundle.iife.js": "./dist/bundle.iife.js",
+    "./umd-browser-bundle": "./dist/bundle.umd.js",
+    "./dist/bundle.umd.js": "./dist/bundle.umd.js",
+    "./dist/cjs/index.node": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/cjs/index.node.js"
+    },
+    "./dist/esm/index.node": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/esm/index.node.js"
+    },
+    "./dist/esm/index.browser": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/esm/index.browser.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "imports": {
+    "#pkg": {
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/cjs/index.node.js"
+      },
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/esm/index.node.js"
+      },
+      "default": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/esm/index.browser.js"
+      }
+    }
+  },
+  "directories": {
+    "build": "./build",
+    "dist": "./dist",
+    "docs": "./docs",
+    "src": "./src",
+    "test": "./test"
+  },
+  "scripts": {
+    "_build:cleantypes": "rimraf .types",
+    "_build:cjsAndesmPkgJsons": "node ./build/bin/post-build.ts",
+    "build": "run-s build:js docs copy:types",
+    "build:js": "rollup -c build/rollup.config.ts",
+    "typecheck": "tsc --noEmit",
+    "postbuild:js": "run-s _build:cleantypes _build:cjsAndesmPkgJsons",
+    "test:node": "vitest run",
+    "clean": "rimraf coverage dist .types docs",
+    "coverage": "vitest run --coverage",
+    "docs": "typedoc --plugin typedoc-plugin-markdown --entryModule API.md --readme none --excludePrivate --out docs src/ts/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:browser": "vitest run --browser"
+  },
+  "copy:types": "cpy ./build/index.d.ts ./dist/ --flat",
+  "ts-standard": {
+    "project": "tsconfig.json",
+    "env": [
+      "mocha"
+    ],
+    "globals": [
+      "IS_BROWSER",
+      "browser",
+      "page",
+      "chai"
+    ],
+    "ignore": [
+      "dist/**/*",
+      "examples/**/*",
+      "types/**/*",
+      "benchmark/**/*"
+    ]
+  },
+  "nodeBrowserSkel": {
+    "badges": {
+      "workflow": true,
+      "coveralls": true
+    },
+    "git": {
+      "branch": "main"
+    }
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-inject": "^5.0.5",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-multi-entry": "^7.0.1",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-replace": "^6.0.2",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/node": "^24.10.1",
+    "c8": "^10.1.3",
+    "chai": "^6.2.0",
+    "esbuild-register": "^3.6.0",
+    "glob": "^13.0.0",
+    "json5": "^2.2.3",
+    "minimatch": "^10.0.3",
+    "mocha": "^11.7.4",
+    "npm-run-all": "^4.1.5",
+    "pirates": "^4.0.7",
+    "puppeteer": "^24.26.1",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.53.3",
+    "rollup-plugin-dts": "^6.2.3",
+    "ts-standard": "^12.0.2",
+    "tslib": "^2.8.1",
+    "typedoc": "^0.28.14",
+    "typedoc-plugin-markdown": "^4.9.0",
+    "typescript": "^5.9.3",
+    "vite": "7.2.4",
+    "vitest": "^4.0.3"
+  }
+}

package/src/conversion/src/docs/index.md

@@ -0,0 +1,47 @@
+[![Licence: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md)
+[![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
+{{GITHUB_ACTIONS_BADGES}}
+
+# {{PKG_NAME}}
+
+Convert to/from non-negative integers represented with [ES-2020 native JS implementation of BigInt](https://tc39.es/ecma262/#sec-bigint-objects) from/to:
+
+- `Buffer` (node.js) or `ArrayBuffer|TypedArray` (native js),
+- hex `string`,
+- utf8-encoded text `string`,
+- standard and url-safe base64 with and without padding.
+
+It provides a common interface for the conversions that works for both **node.js** and **native javascript**.
+
+> Note that there is not a directly visible `TypedArray()` constructor, but a set of typed array ones: `Int8Array()`, `Uint8Array()`, `Uint8ClampedArray()`, `Int16Array()`, `Uint16Array()`, `Int32Array()`, `Uint32Array()`, `Float32Array()`, `Float64Array()`, `BigInt64Array()`, `BigUint64Array()`.
+
+## Usage
+
+`{{PKG_NAME}}` can be imported to your project with `npm`:
+
+```console
+npm install {{PKG_NAME}}
+```
+
+Then either require (Node.js CJS):
+
+```javascript
+const {{PKG_CAMELCASE}} = require('{{PKG_NAME}}')
+```
+
+or import (JavaScript ES module):
+
+```javascript
+import * as {{PKG_CAMELCASE}} from '{{PKG_NAME}}'
+```
+
+The appropriate version for browser or node is automatically exported.
+
+> BigInt is [ES-2020](https://tc39.es/ecma262/#sec-bigint-objects). In order to use it with TypeScript you should set `target` (and probably also `lib`) to at least `es2020` in `tsconfig.json`.
+
+You can also download the {{IIFE_BUNDLE}}, the {{ESM_BUNDLE}} or the {{UMD_BUNDLE}} and manually add it to your project, or, if you have already installed `{{PKG_NAME}}` in your project, just get the bundles from `node_modules/{{PKG_NAME}}/dist/bundles/`.
+
+## API reference documentation
+
+[Check the API](./docs/API.md)