Bug: JavaScript Browser Documentation

[jlarmstrongiv]

Describe the bug

No documentation can be found for using usearch in the browser.

Wasmer does not have relevant documentation either.

See Discord discussion

Steps to reproduce

Try to import usearch in the browser

Expected behavior

More details or an example is provided on how to import and setup usearch in the browser

USearch version

v1.1.0

Operating System

Browser

Hardware architecture

x86

Which interface are you using?

Other bindings

Contact Details

No response

Is there an existing issue for this?

• I have searched the existing issues

Code of Conduct

• I agree to follow this project's Code of Conduct

[ashvardanian]

Thank you for acknowledging this issue, @jlarmstrongiv! We are already working with @syrusakbary and broader @wasmerio team to provide a solution 🤗

[jlarmstrongiv]

• Example of a different wasmer package https://medium.com/wasmer/wasmer-js-9a53e837b80
• More information on wasmer packages https://www.infoq.com/news/2019/10/wasmer-js-wasi-wasm-browser/

[ashvardanian]

@jlarmstrongiv, thank you fir sharing those! I will try to address those, and come back with WASM updates with a week 🤗

[jlarmstrongiv]

@ashvardanian thank you! I’m looking forward to it 😄

[aehlke]

how has it gone? thanks.

[jlarmstrongiv]

The Wasmer JS SDK has been released this week https://wasmer.io/posts/introducing-the-wasmer-js-sdk

[ashvardanian]

@jlarmstrongiv, nice! Can it help us to run USearch in the browser?

[jlarmstrongiv]

@ashvardanian Yes, I think it would. Especially since usearch already builds a Wasmer package

[andrewluetgers]

not sure if this helps but looking into wasmer filesystem it has an in memory fs abstraction in the browser, but it looks like they will be able to support opfs wasmerio/wasmer-js#393

[MentalGear]

Very excited about usearch in the browser, will open up many more applications! Using OPFS for FS should work in all modern browsers!

[MentalGear]

OPFS has iOS/mac Safari support

[aehlke]

I tried to find confirmation that it also works in WKWebView but couldn't find that explicitly

[MentalGear]

I don't know about WKWebView, but since it's basically safari it should. You can always test it yourself when in doubt.
RXDB has quite a great info on OPFS:

From the beginning of 2023, the Origin Private File System API is supported by all modern browsers like Safari, Chrome, Edge and Firefox.
It is important to know that the OPFS API is only available inside of a WebWorker. It cannot be used in the main thread, an iFrame or even a SharedWorker.

https://rxdb.info/rx-storage-opfs.html#opfs-limitations