feat: add official bun binding

[twoeths]

Motivation

• consume https://github.com/ChainSafe/bun-ffi-z
• have the same DevEx like napi-rs

Description

• add home "bun" folder
• compile zig in bun "package.json" by: "bun run build"
• TBD

TODOs

• blocked by fix: fix openLibrary api bun-ffi-z#2
• bun run build
• bun test:unit
• bun benchmark
• test CI
• bun prePublish. ==> tested in feat: prepublish step in workflow #11
• bun publish
• release CI

[github-actions]

Performance Report

✔️ no performance regression detected

Full benchmark results

Benchmark suite	Current: 993e407	Previous: null	Ratio
JS - unshuffleList - 16384 indices	922.25 us/op
Zig - unshuffleList - 16384 indices	608.12 us/op
JS - unshuffleList - 250000 indices	13.312 ms/op
Zig - unshuffleList - 250000 indices	8.9923 ms/op
JS - unshuffleList - 1000000 indices	52.861 ms/op
Zig - unshuffleList - 1000000 indices	35.853 ms/op
get values - 1000	335.00 ns/op
get values - naive - 1000	499.00 ns/op
set values - 1000	299.00 ns/op
set values - naive - 1000	613.00 ns/op
get values - 1000000	926.00 ns/op
get values - naive - 1000000	1.6170 us/op
set values - 1000000	930.00 ns/op
set values - naive - 1000000	2.1100 us/op
JS - computeSyncCommitteeIndices - 16384 indices	296.19 ms/op
Zig - computeSyncCommitteeIndices - 16384 indices	4.0516 ms/op
JS - computeSyncCommitteeIndices - 250000 indices	286.99 ms/op
Zig - computeSyncCommitteeIndices - 250000 indices	16.819 ms/op
JS - computeSyncCommitteeIndices - 1000000 indices	303.88 ms/op
Zig - computeSyncCommitteeIndices - 1000000 indices	31.108 ms/op

by benchmarkbot/action

[wemeetagain]

the path.resolve("../bun") is strange here. I don't think it will work when the cwd is another consumer of this package.

maybe better is path.join(import.meta.dirname, '..')

(I'm assuming the dylib would be located at something like bun/libstate-transition-utils.dylib)

[twoeths]

I simplified it to const lib = await openLibrary(path.resolve("."), fns); please have a look at the latest change

[wemeetagain]

@twoeths check this comment. Try something with import.meta.dirname here instead of path.resolve/cwd

[twoeths]

thanks, just switched to "import.meta.dirname"

[twoeths]

the publish step was tested successfully with -dry-run flag, this is the generated targetPackages
targetPackages.zip

[wemeetagain]

🚀