cborg 2.0.5 → 3.0.0-alpha.1

package/.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: 'github-actions'
+    directory: '/'
+    schedule:
+      interval: 'daily'
+    commit-message:
+      prefix: 'chore'
+      include: 'scope'
+  - package-ecosystem: 'npm'
+    directory: '/'
+    schedule:
+      interval: 'daily'
+    commit-message:
+      prefix: 'chore'
+      include: 'scope'

package/.github/workflows/test-and-release.yml

@@ -0,0 +1,63 @@
+name: Test & Maybe Release
+on: [push, pull_request]
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        node: [16.x, 18.x, lts/*, current]
+        os: [macos-latest, ubuntu-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+      - name: Use Node.js ${{ matrix.node }}
+        uses: actions/setup-node@v3.8.1
+        with:
+          node-version: ${{ matrix.node }}
+      - name: Install Dependencies
+        run: |
+          npm install --no-progress
+      - name: Run tests
+        run: |
+          npm config set script-shell bash
+          npm run test:ci
+      - name: Typecheck
+        uses: gozala/typescript-error-reporter-action@v1.0.9
+  release:
+    name: Release
+    needs: test
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Setup Node.js
+        uses: actions/setup-node@v3.8.1
+        with:
+          node-version: lts/*
+      - name: Install dependencies
+        run: |
+          npm install --no-progress --no-package-lock --no-save
+      - name: Build
+        run: |
+          npm run build
+      - name: Install plugins
+        run: |
+          npm install \
+            @semantic-release/commit-analyzer \
+            conventional-changelog-conventionalcommits \
+            @semantic-release/release-notes-generator \
+            @semantic-release/npm \
+            @semantic-release/github \
+            @semantic-release/git \
+            @semantic-release/changelog \
+            --no-progress --no-package-lock --no-save
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release
+

package/CHANGELOG.md

@@ -0,0 +1,332 @@
+## [2.0.5](https://github.com/rvagg/cborg/compare/v2.0.4...v2.0.5) (2023-08-25)
+
+
+### Trivial Changes
+
+* **deps-dev:** bump typescript from 5.1.6 to 5.2.2 ([4518600](https://github.com/rvagg/cborg/commit/451860087ae73f1aeaffcfa5fe64ecca068412e8))
+* **deps:** bump actions/setup-node from 3.8.0 to 3.8.1 ([148013b](https://github.com/rvagg/cborg/commit/148013b2eb28453a6fad2d14ceb07080127574b9))
+
+## [2.0.4](https://github.com/rvagg/cborg/compare/v2.0.3...v2.0.4) (2023-08-14)
+
+
+### Trivial Changes
+
+* **deps:** bump actions/setup-node from 3.7.0 to 3.8.0 ([3c5c865](https://github.com/rvagg/cborg/commit/3c5c86584793f9a256b19b1efd20f29cfd05bcce))
+
+## [2.0.3](https://github.com/rvagg/cborg/compare/v2.0.2...v2.0.3) (2023-07-07)
+
+
+### Trivial Changes
+
+* **deps:** bump actions/setup-node from 3.6.0 to 3.7.0 ([6dccb1c](https://github.com/rvagg/cborg/commit/6dccb1c90d319b004f3be228aa4bc9c9994970b8))
+
+## [2.0.2](https://github.com/rvagg/cborg/compare/v2.0.1...v2.0.2) (2023-06-28)
+
+
+### Trivial Changes
+
+* **deps-dev:** bump typescript from 5.0.4 to 5.1.5 ([e5ed650](https://github.com/rvagg/cborg/commit/e5ed650051efb63cd55a2f7ab3d6c0768aea3b0d))
+* **deps:** bump gozala/typescript-error-reporter-action ([9ac5f4a](https://github.com/rvagg/cborg/commit/9ac5f4a2a542b9f4eec61e5bce1e6a9d2c49a951))
+
+## [2.0.1](https://github.com/rvagg/cborg/compare/v2.0.0...v2.0.1) (2023-06-14)
+
+
+### Trivial Changes
+
+* **deps-dev:** bump c8 from 7.14.0 to 8.0.0 ([26e0a62](https://github.com/rvagg/cborg/commit/26e0a62143af996ff2abcb8741b51e7bde8f7a85))
+
+## [2.0.0](https://github.com/rvagg/cborg/compare/v1.10.2...v2.0.0) (2023-06-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* drop Node.js 14.x support
+
+### Trivial Changes
+
+* drop Node.js 14.x support ([cc28594](https://github.com/rvagg/cborg/commit/cc28594041204a80d5f722c137f41dd9ebc5b987))
+
+## [1.10.2](https://github.com/rvagg/cborg/compare/v1.10.1...v1.10.2) (2023-05-17)
+
+
+### Trivial Changes
+
+* **deps-dev:** bump polendina from 3.1.0 to 3.2.1 ([6098702](https://github.com/rvagg/cborg/commit/6098702f415a1e15a6d5a1fb3d630ebdce31cdfd))
+
+## [1.10.1](https://github.com/rvagg/cborg/compare/v1.10.0...v1.10.1) (2023-03-17)
+
+
+### Bug Fixes
+
+* release with Node.js 18 ([e1de3dc](https://github.com/rvagg/cborg/commit/e1de3dcb2376149c6db18bbb46a4dee6dd3bae3c))
+
+
+### Trivial Changes
+
+* **deps-dev:** bump typescript from 4.9.5 to 5.0.2 ([46974d7](https://github.com/rvagg/cborg/commit/46974d7dd5eed6b7f776990ba81b33360333f56e))
+
+## [1.10.0](https://github.com/rvagg/cborg/compare/v1.9.6...v1.10.0) (2023-01-06)
+
+
+### Features
+
+* add rejectDuplicateMapKeys option (default false) ([450bc8c](https://github.com/rvagg/cborg/commit/450bc8c68006eb109c671084c5ff5dd22dc64e7a))
+
+
+### Trivial Changes
+
+* **no-release:** bump actions/setup-node from 3.5.1 to 3.6.0 ([#73](https://github.com/rvagg/cborg/issues/73)) ([a7d9e99](https://github.com/rvagg/cborg/commit/a7d9e99662eaf0b020b0124fceba56810d8a55d0))
+* **no-release:** update node.js versions in CI ([6fe4131](https://github.com/rvagg/cborg/commit/6fe4131cc00a1c9c824974afb28eba7f6fea9ef1))
+
+## [1.9.6](https://github.com/rvagg/cborg/compare/v1.9.5...v1.9.6) (2022-11-15)
+
+
+### Trivial Changes
+
+* **deps-dev:** bump typescript from 4.8.4 to 4.9.3 ([#66](https://github.com/rvagg/cborg/issues/66)) ([38fc1c8](https://github.com/rvagg/cborg/commit/38fc1c862625bcab76340398897c0a2d928dc482))
+* **no-release:** bump actions/setup-node from 3.4.1 to 3.5.0 ([#64](https://github.com/rvagg/cborg/issues/64)) ([927189a](https://github.com/rvagg/cborg/commit/927189a130d579fba41f62c327042d9166d32714))
+* **no-release:** bump actions/setup-node from 3.5.0 to 3.5.1 ([#65](https://github.com/rvagg/cborg/issues/65)) ([d06f0c9](https://github.com/rvagg/cborg/commit/d06f0c9308627e3bdf2026be5ff4c05ab958b99d))
+
+## [1.9.5](https://github.com/rvagg/cborg/compare/v1.9.4...v1.9.5) (2022-08-26)
+
+
+### Trivial Changes
+
+* **deps-dev:** bump typescript from 4.7.4 to 4.8.2 ([#63](https://github.com/rvagg/cborg/issues/63)) ([b28e7de](https://github.com/rvagg/cborg/commit/b28e7defe986bfa134a8f1a9b9ea71f60682dbd3))
+* **no-release:** bump actions/setup-node from 3.2.0 to 3.3.0 ([#59](https://github.com/rvagg/cborg/issues/59)) ([5f317db](https://github.com/rvagg/cborg/commit/5f317db133d5dd6b6eac369819860351b77a0954))
+* **no-release:** bump actions/setup-node from 3.3.0 to 3.4.0 ([#61](https://github.com/rvagg/cborg/issues/61)) ([a104eb7](https://github.com/rvagg/cborg/commit/a104eb73f3b9e12fd30556e1ed9db017ca4b3b73))
+* **no-release:** bump actions/setup-node from 3.4.0 to 3.4.1 ([#62](https://github.com/rvagg/cborg/issues/62)) ([883b273](https://github.com/rvagg/cborg/commit/883b273a68b08361a7cc8cb5f4f8be6aa8ae7ccc))
+* **no-release:** bump ipld-garbage from 4.0.10 to 5.0.0 ([#60](https://github.com/rvagg/cborg/issues/60)) ([42e6f9a](https://github.com/rvagg/cborg/commit/42e6f9a20a1dcce5061c0a493931e4a060f1442e))
+
+### [1.9.4](https://github.com/rvagg/cborg/compare/v1.9.3...v1.9.4) (2022-05-25)
+
+
+### Trivial Changes
+
+* **deps-dev:** bump typescript from 4.6.4 to 4.7.2 ([b3a63e5](https://github.com/rvagg/cborg/commit/b3a63e594afed42af0fbdd1f9f098ac31bc727b8))
+
+### [1.9.3](https://github.com/rvagg/cborg/compare/v1.9.2...v1.9.3) (2022-05-19)
+
+
+### Bug Fixes
+
+* allow diag output to deal with integers outside of safe range ([5d4ed2c](https://github.com/rvagg/cborg/commit/5d4ed2c7e6f00db40150cb6e56c859bfb965d752))
+
+
+### Trivial Changes
+
+* **no-release:** bump actions/setup-node from 3.1.1 to 3.2.0 ([#57](https://github.com/rvagg/cborg/issues/57)) ([9594b16](https://github.com/rvagg/cborg/commit/9594b160dd9613baac0dadb14ee6e139c2c36853))
+
+### [1.9.2](https://github.com/rvagg/cborg/compare/v1.9.1...v1.9.2) (2022-05-12)
+
+
+### Bug Fixes
+
+* rework lib/bin.js inclusion in ipjx compile chain ([7b3cd32](https://github.com/rvagg/cborg/commit/7b3cd3297b174b42cf1c8fe480c8df430415db6e))
+
+
+### Trivial Changes
+
+* **deps-dev:** bump mocha from 9.2.2 to 10.0.0 ([67db9a3](https://github.com/rvagg/cborg/commit/67db9a39991e0ac163d08870a93ef015510d8d35))
+* **no-release:** bump polendina from 2.0.15 to 3.0.0 ([#54](https://github.com/rvagg/cborg/issues/54)) ([84e8037](https://github.com/rvagg/cborg/commit/84e80374a1a3c0ecaea8be67fd0b054a7d9422e3))
+* **no-release:** bump polendina from 3.0.0 to 3.1.0 ([#55](https://github.com/rvagg/cborg/issues/55)) ([57a47f8](https://github.com/rvagg/cborg/commit/57a47f81ceacef6a00dcabf37befcefb2cd40860))
+
+### [1.9.1](https://github.com/rvagg/cborg/compare/v1.9.0...v1.9.1) (2022-04-20)
+
+
+### Bug Fixes
+
+* standard@17 getting picky about ternaries ([5069065](https://github.com/rvagg/cborg/commit/50690659bfbf3fce871eeff6d311ec30bf6b9813))
+
+
+### Trivial Changes
+
+* **deps-dev:** bump standard from 16.0.4 to 17.0.0 ([291c6ca](https://github.com/rvagg/cborg/commit/291c6ca23f302aec8e74363a039ba4b0696faf9f))
+* **no-release:** bump actions/setup-node from 3.0.0 to 3.1.0 ([#49](https://github.com/rvagg/cborg/issues/49)) ([61e25e0](https://github.com/rvagg/cborg/commit/61e25e03481cebd7b3e25c0c42388b68df1f0474))
+* **no-release:** bump actions/setup-node from 3.1.0 to 3.1.1 ([#51](https://github.com/rvagg/cborg/issues/51)) ([2993a82](https://github.com/rvagg/cborg/commit/2993a82d90197f424ca04041d5721ac16dbf1618))
+
+## [1.9.0](https://github.com/rvagg/cborg/compare/v1.8.1...v1.9.0) (2022-03-30)
+
+
+### Features
+
+* add encodedLength() function ([#48](https://github.com/rvagg/cborg/issues/48)) ([e8be1c0](https://github.com/rvagg/cborg/commit/e8be1c0f2cbe5b889cbf21a16693ec37cee1a1d6))
+
+### [1.8.1](https://github.com/rvagg/cborg/compare/v1.8.0...v1.8.1) (2022-03-02)
+
+
+### Trivial Changes
+
+* **deps-dev:** bump typescript from 4.5.5 to 4.6.2 ([#46](https://github.com/rvagg/cborg/issues/46)) ([cfe6aab](https://github.com/rvagg/cborg/commit/cfe6aab0cb2c67b61b4621d510d1df3d87485ff8))
+* **no-release:** bump actions/checkout from 2.4.0 to 3 ([#45](https://github.com/rvagg/cborg/issues/45)) ([6620054](https://github.com/rvagg/cborg/commit/6620054274fc768ee5e874de1c590f929d331314))
+
+## [1.8.0](https://github.com/rvagg/cborg/compare/v1.7.0...v1.8.0) (2022-02-25)
+
+
+### Features
+
+* **string:** add `retainStringBytes` decode option, better non-unicode & non-printable diag output ([770dd6e](https://github.com/rvagg/cborg/commit/770dd6e2ad8da4b394164d42822b84805429c9ff))
+
+
+### Trivial Changes
+
+* **no-release:** bump actions/setup-node from 2.5.1 to 3.0.0 ([#44](https://github.com/rvagg/cborg/issues/44)) ([149afe0](https://github.com/rvagg/cborg/commit/149afe0f2a61084f0d29e3b49515fe4cef945e41))
+
+## [1.7.0](https://github.com/rvagg/cborg/compare/v1.6.2...v1.7.0) (2022-02-21)
+
+
+### Features
+
+* **cli:** add diag2* commands, minor diag fixes, README update ([bb52262](https://github.com/rvagg/cborg/commit/bb5226268bd7ed4170ff5a6230998cacf0397231))
+
+### [1.6.2](https://github.com/rvagg/cborg/compare/v1.6.1...v1.6.2) (2022-02-21)
+
+
+### Bug Fixes
+
+* **diagnostic:** rework indenting algorithm to better handle recursives ([af47da1](https://github.com/rvagg/cborg/commit/af47da12835bd6d82982784ca4cd8903c4a966f1))
+
+### [1.6.1](https://github.com/rvagg/cborg/compare/v1.6.0...v1.6.1) (2022-01-17)
+
+
+### Bug Fixes
+
+* **diagnostic:** handle zero-length recursives properly in diag output ([38ec7ea](https://github.com/rvagg/cborg/commit/38ec7ea054726bb8d71cc836019949e6b0e28d78))
+
+
+### Trivial Changes
+
+* **no-release:** bump actions/setup-node from 2.5.0 to 2.5.1 ([#38](https://github.com/rvagg/cborg/issues/38)) ([d46fae2](https://github.com/rvagg/cborg/commit/d46fae2c02641ddda0dfab21aa028d06ae6a8c13))
+
+## [1.6.0](https://github.com/rvagg/cborg/compare/v1.5.4...v1.6.0) (2021-12-13)
+
+
+### Features
+
+* add support for coerceUndefinedToNull option ([fd61bbe](https://github.com/rvagg/cborg/commit/fd61bbe95bfbc255fa371ae8e1e241a96f31e211))
+
+
+### Trivial Changes
+
+* test and document coerceUndefinedToNull ([61fd015](https://github.com/rvagg/cborg/commit/61fd0150be586aef5518f2fa9f64456639bd2011))
+* update deps & test setup ([1246122](https://github.com/rvagg/cborg/commit/1246122ace46bbc6ba18b07a66afd4cfb057a3e7))
+
+### [1.5.4](https://github.com/rvagg/cborg/compare/v1.5.3...v1.5.4) (2021-12-08)
+
+
+### Bug Fixes
+
+* remove 'util' dependency ([875d5ea](https://github.com/rvagg/cborg/commit/875d5ea6cf226c6db8fc0a3fce6089592c9aadcd))
+
+
+### Trivial Changes
+
+* **deps-dev:** bump polendina from 1.1.1 to 2.0.0 ([9aeed6b](https://github.com/rvagg/cborg/commit/9aeed6bd2bbec7996b16dc8c2e00daa06721527e))
+* expand browser testing to esm ([cc2a626](https://github.com/rvagg/cborg/commit/cc2a6261a9600abf005e46dc799940dca6626aaf))
+* **no-release:** bump actions/setup-node from 2.4.1 to 2.5.0 ([#32](https://github.com/rvagg/cborg/issues/32)) ([5f7dba1](https://github.com/rvagg/cborg/commit/5f7dba1d1ade3e3da13db18d16635c2e01e71334))
+
+### [1.5.3](https://github.com/rvagg/cborg/compare/v1.5.2...v1.5.3) (2021-11-04)
+
+
+### Trivial Changes
+
+* **deps:** bump actions/checkout from 2.3.5 to 2.4.0 ([8a76824](https://github.com/rvagg/cborg/commit/8a7682419ebc854cf83395627d67823e0403ef46))
+
+### [1.5.2](https://github.com/rvagg/cborg/compare/v1.5.1...v1.5.2) (2021-10-18)
+
+
+### Trivial Changes
+
+* **deps,no-release:** bump actions/checkout from 2.3.4 to 2.3.5 ([#29](https://github.com/rvagg/cborg/issues/29)) ([fd0db75](https://github.com/rvagg/cborg/commit/fd0db75e19690541969d2aac8fb0d7d940be72a1))
+
+### [1.5.1](https://github.com/rvagg/cborg/compare/v1.5.0...v1.5.1) (2021-09-28)
+
+
+### Trivial Changes
+
+* **deps:** bump actions/setup-node from 2.4.0 to 2.4.1 ([a7a1d0c](https://github.com/rvagg/cborg/commit/a7a1d0cd11ce59481d8b1a0b9120cec27fda835d))
+
+## [1.5.0](https://github.com/rvagg/cborg/compare/v1.4.2...v1.5.0) (2021-08-25)
+
+
+### Features
+
+* enhance CLI - more commands & accept stdin ([333b379](https://github.com/rvagg/cborg/commit/333b379190b9a27ce9ab4811a8417a566eaeb7ed))
+
+### [1.4.2](https://github.com/rvagg/cborg/compare/v1.4.1...v1.4.2) (2021-08-23)
+
+
+### Bug Fixes
+
+* add a decimal point for whole number float tokens ([3a18861](https://github.com/rvagg/cborg/commit/3a18861dd8faff2af6ebd06f82b2d1a6dc691fbc))
+
+### [1.4.1](https://github.com/rvagg/cborg/compare/v1.4.0...v1.4.1) (2021-08-05)
+
+
+### Trivial Changes
+
+* **deps:** bump actions/setup-node from 2.3.2 to 2.4.0 ([eda1936](https://github.com/rvagg/cborg/commit/eda19366cb093caac5f3ce6e5bb94bd9b94dc988))
+
+## [1.4.0](https://github.com/rvagg/cborg/compare/v1.3.8...v1.4.0) (2021-08-05)
+
+
+### Features
+
+* handle JSON decoding of large integers as BigInt ([dc87eb4](https://github.com/rvagg/cborg/commit/dc87eb47f7afcd71d51f2d849a92951567f9d565))
+* use `allowBigInt` option so BigInt handling isn't a breaking change ([66d61b5](https://github.com/rvagg/cborg/commit/66d61b51ada9e5f189d4fbc0f52b2423052f5bb1))
+
+### [1.3.8](https://github.com/rvagg/cborg/compare/v1.3.7...v1.3.8) (2021-08-05)
+
+
+### Trivial Changes
+
+* **deps:** bump actions/setup-node from 2.3.1 to 2.3.2 ([3a3cdc1](https://github.com/rvagg/cborg/commit/3a3cdc18ef9aaccff971950279a5470623841b53))
+
+### [1.3.7](https://github.com/rvagg/cborg/compare/v1.3.6...v1.3.7) (2021-08-03)
+
+
+### Trivial Changes
+
+* **deps:** bump actions/setup-node from 2.3.0 to 2.3.1 ([8cd4583](https://github.com/rvagg/cborg/commit/8cd45837e249f23558f08dfa60193a020571a7d7))
+
+### [1.3.6](https://github.com/rvagg/cborg/compare/v1.3.5...v1.3.6) (2021-07-20)
+
+
+### Trivial Changes
+
+* **deps:** bump actions/setup-node from 2.2.0 to 2.3.0 ([7d4a786](https://github.com/rvagg/cborg/commit/7d4a786217281b0041d3003cf96246eca85a8630))
+
+### [1.3.5](https://github.com/rvagg/cborg/compare/v1.3.4...v1.3.5) (2021-07-01)
+
+
+### Trivial Changes
+
+* **deps:** bump actions/setup-node from 2.1.5 to 2.2.0 ([661f195](https://github.com/rvagg/cborg/commit/661f195ebccf6da72e92478b8f3ba98c7b5a7f7c))
+
+### [1.3.4](https://github.com/rvagg/cborg/compare/v1.3.3...v1.3.4) (2021-06-08)
+
+
+### Trivial Changes
+
+* **deps-dev:** bump mocha from 8.4.0 to 9.0.0 ([8ad0905](https://github.com/rvagg/cborg/commit/8ad0905f714a82a431e50d07390d2fc5f80070e8))
+
+### [1.3.3](https://github.com/rvagg/cborg/compare/v1.3.2...v1.3.3) (2021-05-31)
+
+
+### Trivial Changes
+
+* **deps-dev:** bump ipld-garbage from 3.0.6 to 4.0.1 ([1615ec2](https://github.com/rvagg/cborg/commit/1615ec2251afed7bad4eb581c4975bf4913a10f7))
+
+### [1.3.2](https://github.com/rvagg/cborg/compare/v1.3.1...v1.3.2) (2021-05-28)
+
+
+### Bug Fixes
+
+* handle tag indenting properly with diagnostic output ([5312923](https://github.com/rvagg/cborg/commit/5312923c5feb05224dd920efa4e7735208e971fe))
+
+
+### Trivial Changes
+
+* add semantic-release for auto-releases ([155de4c](https://github.com/rvagg/cborg/commit/155de4c06e00bfbbeb397f0b31142dc6a609c742))
+* s/15/16 in node test matrix ([363920f](https://github.com/rvagg/cborg/commit/363920f48af7592453f630d6102db2714ebaa92c))
+* **deps:** bump actions/checkout from 2 to 2.3.4 ([0846f50](https://github.com/rvagg/cborg/commit/0846f502204660ca3c7d76d675edff315a8695c7))

package/bench/bench.js

@@ -0,0 +1,117 @@
+// can be run in a browser with `polendina --runner=bare-sync --timeout 6000 --cleanup bench.js`
+// with additional dependencies for cborg installed here
+
+import assert from 'assert'
+import { garbage } from 'ipld-garbage'
+import { decode, encode } from '../cborg.js'
+import borc from 'borc'
+
+let writebuf = ''
+const write = process.stdout
+  ? process.stdout.write.bind(process.stdout)
+  : (str) => {
+      writebuf += str
+      if (str.endsWith('\n')) {
+        console.log(writebuf.replace(/\n$/, ''))
+        writebuf = ''
+      }
+    }
+
+function runWith (description, count, targetTime, size, options) {
+  let borcDecoder = null
+  const borcDecode = (bytes) => {
+    if (!borcDecoder) {
+      // account for initial allocation & setup time in benchmark
+      borcDecoder = new borc.Decoder({ size: 10 * 1024 * 1024 })
+    }
+    return borcDecoder.decodeAll(bytes)[0]
+  }
+
+  const fixtures = []
+
+  console.log(`${description} @ ${count.toLocaleString()}`)
+  for (let i = 0; i < count; i++) {
+    const obj = garbage(size, options)
+    const cbyts = encode(obj)
+    /*
+    const bbyts = borc.encode(obj)
+    if (Buffer.compare(Buffer.from(cbyts), bbyts) !== 0) {
+      console.log(`mismatch for obj: ${JSON.stringify(obj)}`)
+      console.log('\t', Buffer.from(cbyts).toString('hex'))
+      console.log('\t', Buffer.from(bbyts).toString('hex'))
+    }
+    */
+    if (cbyts.length <= size * 2) {
+      fixtures.push([obj, cbyts])
+    }
+  }
+  const avgSize = Math.round(fixtures.reduce((p, c) => p + c[1].length, 0) / fixtures.length)
+
+  const enc = (encoder) => {
+    for (const [obj, byts] of fixtures) {
+      const ebyts = encoder(obj)
+      if (byts.length !== ebyts.length) {
+        throw new Error('bork')
+      }
+    }
+    return fixtures.length
+  }
+
+  const bench = (bfn) => {
+    const start = Date.now()
+    let opcount = 0
+    do {
+      opcount += bfn()
+    } while (Date.now() - start < targetTime)
+    const ops = Math.round(opcount / ((Date.now() - start) / 1000))
+    return ops
+  }
+
+  const dec = (decoder) => {
+    for (const [obj, byts] of fixtures) {
+      const cobj = decoder(byts)
+      if (obj != null && typeof obj === 'object') {
+        assert.deepStrictEqual(Object.keys(cobj).length, Object.keys(obj).length)
+      } else {
+        assert.deepStrictEqual(obj, cobj)
+      }
+    }
+    return fixtures.length
+  }
+
+  const cmp = (desc, cbfn, bofn) => {
+    write(`\t${desc} (avg ${avgSize.toLocaleString()} b):`)
+    const cborgOps = bench(cbfn)
+    write(` cborg @ ${cborgOps.toLocaleString()} op/s`)
+    const borcOps = bench(bofn)
+    write(` / borc @ ${borcOps.toLocaleString()} op/s`)
+    const percent = Math.round((cborgOps / borcOps) * 1000) / 10
+    write(` = ${(percent).toLocaleString()} %\n`)
+    return percent
+  }
+
+  return [
+    cmp('encode', () => enc(encode), () => enc(borc.encode)),
+    cmp('decode', () => dec(decode), () => dec(borcDecode))
+  ]
+}
+
+const targetTime = 1000
+const accum = []
+accum.push(runWith('rnd-100', 1000, targetTime, 100, { weights: { CID: 0 } }))
+accum.push(runWith('rnd-300', 1000, targetTime, 300, { weights: { CID: 0 } }))
+accum.push(runWith('rnd-nomap-300', 1000, targetTime, 300, { weights: { CID: 0, map: 0 } }))
+accum.push(runWith('rnd-nolist-300', 1000, targetTime, 300, { weights: { CID: 0, list: 0 } }))
+accum.push(runWith('rnd-nofloat-300', 1000, targetTime, 300, { weights: { CID: 0, float: 0 } }))
+accum.push(runWith('rnd-nomaj7-300', 1000, targetTime, 300, { weights: { CID: 0, float: 0, null: 0, boolean: 0 } }))
+accum.push(runWith('rnd-nostr-300', 1000, targetTime, 300, { weights: { CID: 0, string: 0, bytes: 0 } }))
+accum.push(runWith('rnd-nostrbyts-300', 1000, targetTime, 300, { weights: { CID: 0, string: 0 } }))
+accum.push(runWith('rnd-1000', 1000, targetTime, 1000, { weights: { CID: 0 } }))
+accum.push(runWith('rnd-2000', 1000, targetTime, 2000, { weights: { CID: 0 } }))
+accum.push(runWith('rnd-fil-100', 1000, targetTime, 100, { weights: { float: 0, map: 0, CID: 0 } }))
+accum.push(runWith('rnd-fil-300', 1000, targetTime, 300, { weights: { float: 0, map: 0, CID: 0 } }))
+accum.push(runWith('rnd-fil-500', 1000, targetTime, 500, { weights: { float: 0, map: 0, CID: 0 } }))
+accum.push(runWith('rnd-fil-1000', 1000, targetTime, 1000, { weights: { float: 0, map: 0, CID: 0 } }))
+accum.push(runWith('rnd-fil-2000', 1000, targetTime, 2000, { weights: { float: 0, map: 0, CID: 0 } }))
+console.log(`Avg encode: ${Math.round(accum.reduce((p, c) => p + c[0], 0) / accum.length).toLocaleString()} %`)
+console.log(`Avg decode: ${Math.round(accum.reduce((p, c) => p + c[1], 0) / accum.length).toLocaleString()} %`)

package/bench/json.js

@@ -0,0 +1,124 @@
+// can be run in a browser with `polendina --runner=bare-sync --timeout 6000 --cleanup bench.js`
+// with additional dependencies for cborg installed here
+
+import assert from 'assert'
+import { garbage } from 'ipld-garbage'
+import { decode, encode } from '../lib/json/json.js'
+
+let writebuf = ''
+const write = process.stdout
+  ? process.stdout.write.bind(process.stdout)
+  : (str) => {
+      writebuf += str
+      if (str.endsWith('\n')) {
+        console.log(writebuf.replace(/\n$/, ''))
+        writebuf = ''
+      }
+    }
+
+const textEncoder = new TextEncoder()
+const textDecoder = new TextDecoder()
+
+function jencode (obj) {
+  return textEncoder.encode(JSON.stringify(obj))
+}
+
+function jdecode (buf) {
+  return JSON.parse(textDecoder.decode(buf))
+}
+
+function runWith (description, count, targetTime, size, options) {
+  const fixtures = []
+
+  console.log(`${description} @ ${count.toLocaleString()}`)
+  for (let i = 0; i < count; i++) {
+    const obj = garbage(size, options)
+    const cbyts = encode(obj)
+    /*
+    const jbyts = jencode(obj)
+    if (Buffer.compare(Buffer.from(cbyts), jbyts) !== 0) {
+      console.log(`mismatch for obj: ${JSON.stringify(obj)}`)
+      console.log('\tc> ', Buffer.from(cbyts).toString('utf8'))
+      console.log('\tj> ', Buffer.from(jbyts).toString('utf8'))
+    }
+    */
+    if (cbyts.length <= size * 2) {
+      fixtures.push([obj, cbyts])
+    }
+  }
+  const avgSize = Math.round(fixtures.reduce((p, c) => p + c[1].length, 0) / fixtures.length)
+
+  const enc = (encoder) => {
+    for (const [obj, byts] of fixtures) {
+      const ebyts = encoder(obj)
+      if (byts.length !== ebyts.length) {
+        throw new Error('bork')
+      }
+    }
+    return fixtures.length
+  }
+
+  const bench = (bfn) => {
+    const start = Date.now()
+    let opcount = 0
+    do {
+      opcount += bfn()
+    } while (Date.now() - start < targetTime)
+    const ops = Math.round(opcount / ((Date.now() - start) / 1000))
+    return ops
+  }
+
+  const dec = (decoder) => {
+    for (const [obj, byts] of fixtures) {
+      let cobj
+      try {
+        cobj = decoder(byts)
+      } catch (e) {
+        console.log('Failed to decode:', Buffer.from(byts).toString('utf8'))
+        throw e
+      }
+      if (obj != null && typeof obj === 'object') {
+        assert.deepStrictEqual(Object.keys(cobj).length, Object.keys(obj).length)
+      } else {
+        assert.deepStrictEqual(obj, cobj)
+      }
+    }
+    return fixtures.length
+  }
+
+  const cmp = (desc, cbfn, bofn) => {
+    write(`\t${desc} (avg ${avgSize.toLocaleString()} b):`)
+    const cborgOps = bench(cbfn)
+    write(` cborg @ ${cborgOps.toLocaleString()} op/s`)
+    const jOps = bench(bofn)
+    write(` / JSON @ ${jOps.toLocaleString()} op/s`)
+    const percent = Math.round((cborgOps / jOps) * 1000) / 10
+    write(` = ${(percent).toLocaleString()} %\n`)
+    return percent
+  }
+
+  return [
+    cmp('encode', () => enc(encode), () => enc(jencode)),
+    cmp('decode', () => dec(decode), () => dec(jdecode))
+  ]
+}
+
+const targetTime = 1000
+const accum = []
+accum.push(runWith('rnd-100', 1000, targetTime, 100, { weights: { CID: 0, bytes: 0 } }))
+accum.push(runWith('rnd-300', 1000, targetTime, 300, { weights: { CID: 0, bytes: 0 } }))
+accum.push(runWith('rnd-nomap-300', 1000, targetTime, 300, { weights: { CID: 0, bytes: 0, map: 0 } }))
+accum.push(runWith('rnd-nolist-300', 1000, targetTime, 300, { weights: { CID: 0, bytes: 0, list: 0 } }))
+accum.push(runWith('rnd-nofloat-300', 1000, targetTime, 300, { weights: { CID: 0, bytes: 0, float: 0 } }))
+accum.push(runWith('rnd-nomaj7-300', 1000, targetTime, 300, { weights: { CID: 0, bytes: 0, float: 0, null: 0, boolean: 0 } }))
+accum.push(runWith('rnd-nostr-300', 1000, targetTime, 300, { weights: { CID: 0, bytes: 0, string: 0 } }))
+accum.push(runWith('rnd-nostrbyts-300', 1000, targetTime, 300, { weights: { CID: 0, bytes: 0, string: 0 } }))
+accum.push(runWith('rnd-1000', 1000, targetTime, 1000, { weights: { CID: 0, bytes: 0 } }))
+accum.push(runWith('rnd-2000', 1000, targetTime, 2000, { weights: { CID: 0, bytes: 0 } }))
+accum.push(runWith('rnd-fil-100', 1000, targetTime, 100, { weights: { float: 0, map: 0, CID: 0, bytes: 0 } }))
+accum.push(runWith('rnd-fil-300', 1000, targetTime, 300, { weights: { float: 0, map: 0, CID: 0, bytes: 0 } }))
+accum.push(runWith('rnd-fil-500', 1000, targetTime, 500, { weights: { float: 0, map: 0, CID: 0, bytes: 0 } }))
+accum.push(runWith('rnd-fil-1000', 1000, targetTime, 1000, { weights: { float: 0, map: 0, CID: 0, bytes: 0 } }))
+accum.push(runWith('rnd-fil-2000', 1000, targetTime, 2000, { weights: { float: 0, map: 0, CID: 0, bytes: 0 } }))
+console.log(`Avg encode: ${Math.round(accum.reduce((p, c) => p + c[0], 0) / accum.length).toLocaleString()} %`)
+console.log(`Avg decode: ${Math.round(accum.reduce((p, c) => p + c[1], 0) / accum.length).toLocaleString()} %`)

package/bench/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "cborg-bench",
+  "type": "module",
+  "dependencies": {
+    "borc": "^2.1.2",
+    "ipld-garbage": "^3.0.3"
+  }
+}

package/lib/bin.js

@@ -1,4 +1,4 @@
-// excluding #! from here because of ipjs compile, this is called from cli.js
+#!/usr/bin/env node
 
 import process from 'process'
 import { decode, encode } from '../cborg.js'