400a437b08
Instead of forcing people to connect over http://, fall back gracefully to http if no protocol is given. This fixes an issue where external clients can't use this method, since SameSite cookies need to be secure as per https://web.dev/samesite-cookies-explained/#samesite=none-must-be-secure |
||
---|---|---|
.. | ||
example | ||
src | ||
test | ||
.babelrc | ||
.gitignore | ||
jest.config.cjs | ||
package-lock.json | ||
package.json | ||
README.md | ||
rollup.config.ts | ||
setupEnv.js | ||
tsconfig.json |
Urbit Connector
This project allows you to connect to an Urbit ship via a JavaScript application.
Example
Check out the example
directory for examples of how to use this code.
- Open
example/index.html
in your browser and follow the instructions there, or - With a ship running in the same fashion as indicated in the file above, run
node example/index.js
The code for either of these can be found in src/example/browser.js
or src/example/node.js
, depending on your context.
Design
This library is designed to be useful for node applications that communicate with an urbit running either on the local computer or on a remote one.
The majority of its methods are asynchronous and return Promises. This is due to the non-blocking nature of JavaScript. If used in a React app, response handlers should be bound with this
to setState
after a message is received.
NOTE
You must enable CORS requests on your urbit for this library to work in browser context. Use +cors-registry
to see domains which have made requests to your urbit, and then approve the needed one, e.g. |cors-approve http://zod.arvo.network
.