chore: add worker-relay readme
continuous-integration/drone/push Build is running Details

This commit is contained in:
Kieran 2024-01-30 20:32:43 +00:00
parent a14a5fa96b
commit a7c0cf7397
Signed by: Kieran
GPG Key ID: DE71CEB3925BE941
3 changed files with 41 additions and 27 deletions

View File

@ -0,0 +1,39 @@
## Worker Relay
Worker relay is a Nostr relay built on `sqlite-wasm`
`WorkerRelayInterface` is the class which accepts the URL of the worker script
`sqlite-wasm` uses OFPS in order to persist the database.
OPFS requires special headers to be present when serving your application. Read more about it [here](https://sqlite.org/wasm/doc/trunk/persistence.md#opfs)
```
Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Embedder-Policy: require-corp
```
### Usage (Vite)
```typescript
import WorkerRelayPath from "@snort/worker-relay/dist/worker?worker&url";
```
### Example
```typescript
const relay = new WorkerRelayInterface(WorkerRelayPath);
// load sqlite database and run migrations
await relay.init();
// Query worker relay with regular nostr REQ command
const results = await relay.query(["REQ", "1", { kinds: [1], limit: 10 }]);
// publish a new event to the relay
const myEvent = {
kind: 1,
content: "test",
};
if (await relay.event(myEvent)) {
console.log("Success");
}
```

View File

@ -1,6 +1,6 @@
{
"name": "@snort/worker-relay",
"version": "1.0.0",
"version": "1.0.1",
"description": "A nostr relay in a service worker",
"main": "dist/index.js",
"types": "dist/index.d.ts",

View File

@ -3,15 +3,7 @@
import { InMemoryRelay } from "./memory-relay";
import { WorkQueueItem, barrierQueue, processWorkQueue } from "./queue";
import { SqliteRelay } from "./sqlite-relay";
import { NostrEvent, RelayHandler, ReqCommand, ReqFilter, WorkerMessage, eventMatchesFilter, unixNowMs } from "./types";
interface PortedFilter {
filters: Array<ReqFilter>;
port: MessagePort;
}
// Active open subscriptions awaiting new events
const ActiveSubscriptions = new Map<string, PortedFilter>();
import { NostrEvent, RelayHandler, ReqCommand, ReqFilter, WorkerMessage, unixNowMs } from "./types";
let relay: RelayHandler | undefined;
@ -77,23 +69,6 @@ globalThis.onmessage = async ev => {
} else {
relay = new InMemoryRelay();
}
relay.on("event", evs => {
for (const pf of ActiveSubscriptions.values()) {
const pfSend = [];
for (const ev of evs) {
for (const fx of pf.filters) {
if (eventMatchesFilter(ev, fx)) {
pfSend.push(ev);
continue;
}
}
}
if (pfSend.length > 0) {
pf.port.postMessage(pfSend);
}
}
});
await relay.init(msg.args as string);
reply(msg.id, true);
});