@atcute/firehose 0.1.0 → 1.0.0

package/README.md

@@ -1,23 +1,211 @@
 # @atcute/firehose
 
-lightweight and cute XRPC subscription client for AT Protocol.
+lightweight XRPC subscription client for AT Protocol.
+
+```sh
+npm install @atcute/firehose
+```
+
+this package provides a generic client for XRPC subscriptions - the WebSocket-based streaming
+protocol used by AT Protocol. it handles CBOR frame decoding, automatic reconnection, and optional
+schema validation.
+
+for consuming the Bluesky network firehose specifically, consider using `@atcute/jetstream` instead,
+which provides a simpler JSON-based interface.
+
+## usage
+
+### subscribing to the relay firehose
 
 ```ts
 import { FirehoseSubscription } from '@atcute/firehose';
 import { ComAtprotoSyncSubscribeRepos } from '@atcute/atproto';
 
+const subscription = new FirehoseSubscription({
+	service: 'wss://bsky.network',
+	nsid: ComAtprotoSyncSubscribeRepos.mainSchema,
+});
+
+for await (const message of subscription) {
+	console.log(message.$type, message.seq);
+}
+```
+
+the connection opens when you start iterating and closes when you break out of the loop. the
+underlying WebSocket automatically reconnects on disconnection.
+
+### handling message types
+
+messages include a `$type` field indicating their type:
+
+```ts
+for await (const message of subscription) {
+	switch (message.$type) {
+		case 'com.atproto.sync.subscribeRepos#commit': {
+			// repository commit (record creates, updates, deletes)
+			console.log('commit:', message.repo, message.rev);
+			break;
+		}
+
+		case 'com.atproto.sync.subscribeRepos#handle': {
+			// handle change
+			console.log('handle:', message.did, message.handle);
+			break;
+		}
+
+		case 'com.atproto.sync.subscribeRepos#migrate': {
+			// account migration
+			console.log('migrate:', message.did, message.migrateTo);
+			break;
+		}
+
+		case 'com.atproto.sync.subscribeRepos#tombstone': {
+			// account deletion
+			console.log('tombstone:', message.did);
+			break;
+		}
+
+		case 'com.atproto.sync.subscribeRepos#identity': {
+			// identity update
+			console.log('identity:', message.did);
+			break;
+		}
+
+		case 'com.atproto.sync.subscribeRepos#account': {
+			// account status change
+			console.log('account:', message.did, message.active);
+			break;
+		}
+	}
+}
+```
+
+### tracking cursor for resumption
+
+use a function for `params` to provide the current cursor on each connection attempt:
+
+```ts
 let cursor: number | undefined;
 
+// load saved cursor if resuming
+const saved = localStorage.getItem('firehose-cursor');
+if (saved) {
+	cursor = Number(saved);
+}
+
 const subscription = new FirehoseSubscription({
-	service: ['wss://bsky.network'],
+	service: 'wss://bsky.network',
 	nsid: ComAtprotoSyncSubscribeRepos.mainSchema,
+	// function is called on each connection/reconnection
 	params: () => ({ cursor }),
 });
 
 for await (const message of subscription) {
-	if (message.$type === 'com.atproto.sync.subscribeRepos#commit') {
+	if ('seq' in message) {
 		cursor = message.seq;
-		console.log('commit:', message.seq, message.repo);
+
+		// periodically save cursor for recovery
+		if (cursor % 1000 === 0) {
+			localStorage.setItem('firehose-cursor', String(cursor));
+		}
 	}
 }
 ```
+
+the params function is called on each connection attempt, so when the WebSocket reconnects after a
+disconnection, it automatically uses the latest cursor value.
+
+### using multiple servers
+
+pass an array of URLs for automatic failover. the client randomly selects one on each connection:
+
+```ts
+const subscription = new FirehoseSubscription({
+	service: ['wss://bsky.network', 'wss://bsky-relay.example.com'],
+	nsid: ComAtprotoSyncSubscribeRepos.mainSchema,
+});
+```
+
+### handling errors
+
+XRPC subscriptions can send error frames. handle them with the `onError` callback:
+
+```ts
+const subscription = new FirehoseSubscription({
+	service: 'wss://bsky.network',
+	nsid: ComAtprotoSyncSubscribeRepos.mainSchema,
+	onError(error, message) {
+		console.error('firehose error:', error, message);
+		// common errors:
+		// - "FutureCursor": cursor is ahead of the server
+		// - "ConsumerTooSlow": client is not consuming messages fast enough
+	},
+});
+```
+
+### connection lifecycle callbacks
+
+handle connection events for logging or UI updates:
+
+```ts
+const subscription = new FirehoseSubscription({
+	service: 'wss://bsky.network',
+	nsid: ComAtprotoSyncSubscribeRepos.mainSchema,
+	onConnectionOpen(event) {
+		console.log('connected to firehose');
+	},
+	onConnectionClose(event) {
+		console.log('disconnected:', event.code, event.reason);
+	},
+	onConnectionError(event) {
+		console.error('connection error:', event.error);
+	},
+});
+```
+
+### updating options at runtime
+
+change options using `updateOptions()`. this triggers a reconnection:
+
+```ts
+const subscription = new FirehoseSubscription({
+	service: 'wss://bsky.network',
+	nsid: ComAtprotoSyncSubscribeRepos.mainSchema,
+});
+
+// later, switch to a different service
+subscription.updateOptions({
+	service: 'wss://different-relay.example.com',
+});
+```
+
+### disabling message validation
+
+by default, messages are validated against the schema. disable this for better performance if you
+trust the server:
+
+```ts
+const subscription = new FirehoseSubscription({
+	service: 'wss://bsky.network',
+	nsid: ComAtprotoSyncSubscribeRepos.mainSchema,
+	validateMessages: false,
+});
+```
+
+### WebSocket options
+
+pass options to the underlying
+[partysocket](https://github.com/partykit/partykit/tree/main/packages/partysocket) WebSocket for
+custom reconnection behavior:
+
+```ts
+const subscription = new FirehoseSubscription({
+	service: 'wss://bsky.network',
+	nsid: ComAtprotoSyncSubscribeRepos.mainSchema,
+	ws: {
+		maxRetries: 10,
+		minReconnectionDelay: 1000,
+		maxReconnectionDelay: 30000,
+	},
+});
+```

package/dist/frame-decoder.d.ts

@@ -1,4 +1,4 @@
-import type { DecodedFrame } from './types.js';
+import type { DecodedFrame } from './types.ts';
 /**
  * decodes a CBOR frame from a buffer
  */

package/dist/frame-decoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frame-decoder.d.ts","sourceRoot":"","sources":["../lib/frame-decoder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAA+B,MAAM,YAAY,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,UAAU,KAAG,YAuBhD,CAAC;AAeF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,eAAe,MAAM,GAAG,SAAS,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SAU1F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,OAAO,EAAE,eAAe,MAAM,GAAG,SAAS,EAAE,MAAM,MAAM,KAAG,OAQ9F,CAAC"}
+{"version":3,"file":"frame-decoder.d.ts","sourceRoot":"","sources":["../lib/frame-decoder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAA+B,MAAM,YAAY,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,WAAW,WAAY,UAAU,KAAG,YAuBhD,CAAC;AAeF;;GAEG;AACH,eAAO,MAAM,eAAe,kBAAmB,MAAM,GAAG,SAAS,QAAQ,MAAM,KAAG,MAAM,GAAG,SAU1F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,SAAU,OAAO,iBAAiB,MAAM,GAAG,SAAS,QAAQ,MAAM,KAAG,OAQ9F,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { FirehoseSubscription } from './subscription.js';
-export type { FirehoseSubscriptionOptions, MessageOf, ParamsOf } from './types.js';
+export { FirehoseError, FirehoseSubscription } from './subscription.ts';
+export type { FirehoseSubscriptionOptions, MessageOf, ParamsOf } from './types.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,2BAA2B,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EAAE,2BAA2B,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { FirehoseSubscription } from './subscription.js';
+export { FirehoseError, FirehoseSubscription } from './subscription.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/subscription.d.ts

@@ -1,7 +1,17 @@
 import { type XRPCSubscriptionMetadata } from '@atcute/lexicons/validations';
 import { EventIterator } from '@mary-ext/event-iterator';
 import type { ReadonlyDeep } from 'type-fest';
-import type { FirehoseSubscriptionOptions, MessageOf } from './types.js';
+import type { FirehoseSubscriptionOptions, MessageOf } from './types.ts';
+/**
+ * non-fatal error frame received from the upstream firehose, carrying the
+ * atproto-spec `error` code alongside the human-readable `message`.
+ */
+export declare class FirehoseError extends Error {
+    readonly name = "FirehoseError";
+    /** atproto error code from the error frame */
+    readonly error: string;
+    constructor(error: string, message?: string);
+}
 /**
  * generic XRPC subscription client for AT Protocol
  */

package/dist/subscription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../lib/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAExF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAKzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,KAAK,EAAE,2BAA2B,EAAE,SAAS,EAAY,MAAM,YAAY,CAAC;AAEnF;;GAEG;AACH,qBAAa,oBAAoB,CAAC,OAAO,SAAS,wBAAwB;;IAQzE;;OAEG;gBACS,OAAO,EAAE,2BAA2B,CAAC,OAAO,CAAC;IA4FzD,CAAC,MAAM,CAAC,aAAa,CAAC;IAoBtB;;OAEG;IACH,UAAU,IAAI,YAAY,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAIhE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI;CAQ3E"}
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../lib/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAExF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,KAAK,EAAE,2BAA2B,EAAE,SAAS,EAAY,MAAM,YAAY,CAAC;AAEnF;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACvC,SAAkB,IAAI,mBAAmB;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,YAAY,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAG1C;CACD;AAED;;GAEG;AACH,qBAAa,oBAAoB,CAAC,OAAO,SAAS,wBAAwB;;IAQzE;;OAEG;IACH,YAAY,OAAO,EAAE,2BAA2B,CAAC,OAAO,CAAC,EAExD;IAiGD,CAAC,MAAM,CAAC,aAAa,CAAC,sCAkBrB;IAED;;OAEG;IACH,UAAU,IAAI,YAAY,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,CAE/D;IAED;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAO1E;CACD"}

package/dist/subscription.js

@@ -3,6 +3,17 @@ import { EventIterator } from '@mary-ext/event-iterator';
 import { SimpleEventEmitter } from '@mary-ext/simple-event-emitter';
 import { WebSocket as ReconnectingWebSocket } from 'partysocket';
 import { addTypeToBody, decodeFrame } from './frame-decoder.js';
+/**
+ * non-fatal error frame received from the upstream firehose, carrying the
+ * atproto-spec `error` code alongside the human-readable `message`.
+ */
+export class FirehoseError extends Error {
+    constructor(error, message) {
+        super(message ?? error);
+        this.name = 'FirehoseError';
+        this.error = error;
+    }
+}
 /**
  * generic XRPC subscription client for AT Protocol
  */
@@ -21,7 +32,7 @@ export class FirehoseSubscription {
         if (this.#ws !== undefined) {
             return;
         }
-        const { service: wsUrls, nsid, params, ws: wsOptions, validateMessages = true, onConnectionClose, onConnectionError, onConnectionOpen, onError, } = this.#options;
+        const { service: wsUrls, nsid, params, ws: wsOptions, validateEvents = true, onConnectionClose, onConnectionError, onConnectionOpen, onError, } = this.#options;
         const emitter = this.#emitter;
         const getUrl = () => {
             let selectedUrl;
@@ -54,13 +65,21 @@ export class FirehoseSubscription {
             const buffer = new Uint8Array(ev.data);
             const frame = decodeFrame(buffer);
             if (frame.type === 'error') {
-                onError?.(frame.error, frame.message);
+                onError?.(new FirehoseError(frame.error, frame.message));
                 return;
             }
             let body = addTypeToBody(frame.body, frame.discriminator, nsid.nsid);
-            if (validateMessages && nsid.message !== null) {
+            if (validateEvents && nsid.message !== null) {
                 const result = safeParse(nsid.message, body);
                 if (!result.ok) {
+                    if (onError) {
+                        try {
+                            result.throw();
+                        }
+                        catch (err) {
+                            onError(err);
+                        }
+                    }
                     return;
                 }
                 body = result.value;

package/dist/subscription.js.map

@@ -1 +1 @@
-{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../lib/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiC,MAAM,8BAA8B,CAAC;AAExF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAE,SAAS,IAAI,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIjE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGhE;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAChC,UAAU,GAAG,CAAC,CAAC;IACf,GAAG,CAAyB;IAE5B,QAAQ,GAAG,IAAI,kBAAkB,EAAiC,CAAC;IAEnE,QAAQ,CAAuC;IAE/C;;OAEG;IACH,YAAY,OAA6C;QACxD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,OAAO;QACN,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO;QACR,CAAC;QAED,MAAM,EACL,OAAO,EAAE,MAAM,EACf,IAAI,EACJ,MAAM,EACN,EAAE,EAAE,SAAS,EACb,gBAAgB,GAAG,IAAI,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,OAAO,GACP,GAAG,IAAI,CAAC,QAAQ,CAAC;QAElB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE9B,MAAM,MAAM,GAAG,GAAG,EAAE;YACnB,IAAI,WAAmB,CAAC;YAExB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAChC,WAAW,GAAG,MAAM,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACP,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YACjE,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAEvD,MAAM,aAAa,GAAsB,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;YAE1F,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;gBAC3D,MAAM,QAAQ,GAAG,aAAwC,CAAC;gBAC1D,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;oBAC5B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;oBAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;wBAC3C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC1C,CAAC;gBACF,CAAC;YACF,CAAC;YAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;QACvB,CAAC,CAAC;QAEF,MAAM,EAAE,GAAG,IAAI,qBAAqB,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAC9D,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QAEd,EAAE,CAAC,UAAU,GAAG,aAAa,CAAC;QAE9B,EAAE,CAAC,OAAO,GAAG,iBAAiB,IAAI,IAAI,CAAC;QACvC,EAAE,CAAC,OAAO,GAAG,iBAAiB,IAAI,IAAI,CAAC;QACvC,EAAE,CAAC,MAAM,GAAG,gBAAgB,IAAI,IAAI,CAAC;QAErC,EAAE,CAAC,SAAS,GAAG,CAAC,EAAE,EAAE,EAAE;YACrB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YAElC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC5B,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBACtC,OAAO;YACR,CAAC;YAED,IAAI,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAErE,IAAI,gBAAgB,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC/C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC7C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;oBAChB,OAAO;gBACR,CAAC;gBACD,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;YACrB,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,IAA0B,CAAC,CAAC;QAC1C,CAAC,CAAC;IACH,CAAC;IAED,QAAQ;QACP,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO;QACR,CAAC;QAED,EAAE,CAAC,KAAK,EAAE,CAAC;QAEX,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;IACtB,CAAC;IAED,CAAC,MAAM,CAAC,aAAa,CAAC;QACrB,OAAO,IAAI,aAAa,CAAqB,CAAC,IAAI,EAAE,EAAE;YACrD,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;YAChB,CAAC;YAED,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAE9B,OAAO,GAAG,EAAE;gBACX,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;oBAC3B,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACjB,CAAC;gBAED,IAAI,CAAC,UAAU,EAAE,CAAC;gBAClB,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACjC,CAAC,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU;QACT,OAAO,IAAI,CAAC,QAA8D,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAsD;QACnE,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;QAEjD,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,IAAI,CAAC,OAAO,EAAE,CAAC;QAChB,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../lib/subscription.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 import type { InferOutput, XRPCSubscriptionMetadata } from '@atcute/lexicons/validations';
-import type { CloseEvent, ErrorEvent, Options } from 'partysocket/ws';
 import type { BaseSchema } from '@atcute/lexicons/validations';
+import type { CloseEvent, ErrorEvent, Options } from 'partysocket/ws';
 /**
  * extracts the params type from an XRPC subscription schema
  */
@@ -28,14 +28,18 @@ export interface FirehoseSubscriptionOptions<TSchema extends XRPCSubscriptionMet
      */
     params?: ParamsOf<TSchema> | (() => ParamsOf<TSchema>);
     /**
-     * whether to validate incoming messages against the schema
+     * whether to validate incoming events against the schema
      * @default true
      */
-    validateMessages?: boolean;
+    validateEvents?: boolean;
     onConnectionOpen?: (event: Event) => void;
     onConnectionClose?: (event: CloseEvent) => void;
     onConnectionError?: (event: ErrorEvent) => void;
-    onError?: (error: string, message?: string) => void;
+    /**
+     * called for non-fatal frame-level errors: atproto error frames (passed as `FirehoseError`)
+     * and message validation failures (passed as `ValidationError`).
+     */
+    onError?: (err: unknown) => void;
     /**
      * WebSocket connection options
      */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAE1F,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,wBAAwB,CAAC,MAAM,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAClF,OAAO,SAAS,IAAI,GACnB,SAAS,GACT,OAAO,SAAS,UAAU,GACzB,WAAW,CAAC,OAAO,CAAC,GACpB,KAAK,GACP,KAAK,CAAC;AAET;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,wBAAwB,CAAC,GAAG,EAAE,MAAM,QAAQ,EAAE,GAAG,CAAC,GACpF,QAAQ,SAAS,IAAI,GACpB,OAAO,GACP,QAAQ,SAAS,UAAU,GAC1B,WAAW,CAAC,QAAQ,CAAC,GACrB,KAAK,GACP,KAAK,CAAC;AAET;;GAEG;AACH,MAAM,WAAW,2BAA2B,CAAC,OAAO,SAAS,wBAAwB;IACpF;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;;;OAIG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAEvD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC1C,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpD;;OAEG;IACH,EAAE,CAAC,EAAE,OAAO,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B;;OAEG;IACH,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEX;;OAEG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB;IACA,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACtB,GACD;IACA,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IACrB,CAAC,SAAS,wBAAwB,CAAC,MAAM,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GACxD,OAAO,SAAS,IAAI,GACnB,SAAS,GACT,OAAO,SAAS,UAAU,GACzB,WAAW,CAAC,OAAO,CAAC,GACpB,KAAK,GACP,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IACtB,CAAC,SAAS,wBAAwB,CAAC,GAAG,EAAE,MAAM,QAAQ,EAAE,GAAG,CAAC,GACzD,QAAQ,SAAS,IAAI,GACpB,OAAO,GACP,QAAQ,SAAS,UAAU,GAC1B,WAAW,CAAC,QAAQ,CAAC,GACrB,KAAK,GACP,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,2BAA2B,CAAC,OAAO,SAAS,wBAAwB;IACpF;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;;;OAIG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAEvD;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC1C,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAEjC;;OAEG;IACH,EAAE,CAAC,EAAE,OAAO,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B;;OAEG;IACH,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEX;;OAEG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB;IACA,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACtB,GACD;IACA,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/lib/frame-decoder.ts

@@ -1,6 +1,6 @@
 import { decode, decodeFirst } from '@atcute/cbor';
 
-import type { DecodedFrame, ErrorFrameBody, FrameHeader } from './types.js';
+import type { DecodedFrame, ErrorFrameBody, FrameHeader } from './types.ts';
 
 /**
  * decodes a CBOR frame from a buffer

package/lib/index.ts

@@ -1,2 +1,2 @@
-export { FirehoseSubscription } from './subscription.js';
-export type { FirehoseSubscriptionOptions, MessageOf, ParamsOf } from './types.js';
+export { FirehoseError, FirehoseSubscription } from './subscription.ts';
+export type { FirehoseSubscriptionOptions, MessageOf, ParamsOf } from './types.ts';

package/lib/subscription.ts

@@ -2,13 +2,25 @@ import { safeParse, type XRPCSubscriptionMetadata } from '@atcute/lexicons/valid
 
 import { EventIterator } from '@mary-ext/event-iterator';
 import { SimpleEventEmitter } from '@mary-ext/simple-event-emitter';
-
 import { WebSocket as ReconnectingWebSocket } from 'partysocket';
-
 import type { ReadonlyDeep } from 'type-fest';
 
-import { addTypeToBody, decodeFrame } from './frame-decoder.js';
-import type { FirehoseSubscriptionOptions, MessageOf, ParamsOf } from './types.js';
+import { addTypeToBody, decodeFrame } from './frame-decoder.ts';
+import type { FirehoseSubscriptionOptions, MessageOf, ParamsOf } from './types.ts';
+
+/**
+ * non-fatal error frame received from the upstream firehose, carrying the
+ * atproto-spec `error` code alongside the human-readable `message`.
+ */
+export class FirehoseError extends Error {
+	override readonly name = 'FirehoseError';
+	/** atproto error code from the error frame */
+	readonly error: string;
+	constructor(error: string, message?: string) {
+		super(message ?? error);
+		this.error = error;
+	}
+}
 
 /**
  * generic XRPC subscription client for AT Protocol
@@ -38,7 +50,7 @@ export class FirehoseSubscription<TSchema extends XRPCSubscriptionMetadata> {
 			nsid,
 			params,
 			ws: wsOptions,
-			validateMessages = true,
+			validateEvents = true,
 			onConnectionClose,
 			onConnectionError,
 			onConnectionOpen,
@@ -87,15 +99,22 @@ export class FirehoseSubscription<TSchema extends XRPCSubscriptionMetadata> {
 			const frame = decodeFrame(buffer);
 
 			if (frame.type === 'error') {
-				onError?.(frame.error, frame.message);
+				onError?.(new FirehoseError(frame.error, frame.message));
 				return;
 			}
 
 			let body = addTypeToBody(frame.body, frame.discriminator, nsid.nsid);
 
-			if (validateMessages && nsid.message !== null) {
+			if (validateEvents && nsid.message !== null) {
 				const result = safeParse(nsid.message, body);
 				if (!result.ok) {
+					if (onError) {
+						try {
+							result.throw();
+						} catch (err) {
+							onError(err);
+						}
+					}
 					return;
 				}
 				body = result.value;

package/lib/types.ts

@@ -1,30 +1,31 @@
 import type { InferOutput, XRPCSubscriptionMetadata } from '@atcute/lexicons/validations';
+import type { BaseSchema } from '@atcute/lexicons/validations';
 
 import type { CloseEvent, ErrorEvent, Options } from 'partysocket/ws';
 
-import type { BaseSchema } from '@atcute/lexicons/validations';
-
 /**
  * extracts the params type from an XRPC subscription schema
  */
-export type ParamsOf<T> = T extends XRPCSubscriptionMetadata<infer TParams, any, any>
-	? TParams extends null
-		? undefined
-		: TParams extends BaseSchema
-			? InferOutput<TParams>
-			: never
-	: never;
+export type ParamsOf<T> =
+	T extends XRPCSubscriptionMetadata<infer TParams, any, any>
+		? TParams extends null
+			? undefined
+			: TParams extends BaseSchema
+				? InferOutput<TParams>
+				: never
+		: never;
 
 /**
  * extracts the message type from an XRPC subscription schema
  */
-export type MessageOf<T> = T extends XRPCSubscriptionMetadata<any, infer TMessage, any>
-	? TMessage extends null
-		? unknown
-		: TMessage extends BaseSchema
-			? InferOutput<TMessage>
-			: never
-	: never;
+export type MessageOf<T> =
+	T extends XRPCSubscriptionMetadata<any, infer TMessage, any>
+		? TMessage extends null
+			? unknown
+			: TMessage extends BaseSchema
+				? InferOutput<TMessage>
+				: never
+		: never;
 
 /**
  * configuration options for FirehoseSubscription
@@ -48,15 +49,19 @@ export interface FirehoseSubscriptionOptions<TSchema extends XRPCSubscriptionMet
 	params?: ParamsOf<TSchema> | (() => ParamsOf<TSchema>);
 
 	/**
-	 * whether to validate incoming messages against the schema
+	 * whether to validate incoming events against the schema
 	 * @default true
 	 */
-	validateMessages?: boolean;
+	validateEvents?: boolean;
 
 	onConnectionOpen?: (event: Event) => void;
 	onConnectionClose?: (event: CloseEvent) => void;
 	onConnectionError?: (event: ErrorEvent) => void;
-	onError?: (error: string, message?: string) => void;
+	/**
+	 * called for non-fatal frame-level errors: atproto error frames (passed as `FirehoseError`)
+	 * and message validation failures (passed as `ValidationError`).
+	 */
+	onError?: (err: unknown) => void;
 
 	/**
 	 * WebSocket connection options

package/package.json

@@ -1,7 +1,6 @@
 {
-  "type": "module",
   "name": "@atcute/firehose",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "lightweight and cute XRPC subscription client for AT Protocol",
   "license": "0BSD",
   "repository": {
@@ -12,25 +11,33 @@
     "dist/",
     "lib/",
     "!lib/**/*.bench.ts",
-    "!lib/**/*.test.ts"
+    "!lib/**/*.test.ts",
+    "!dist/**/*.{test,bench}.*"
   ],
+  "type": "module",
   "exports": {
     ".": "./dist/index.js"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "@mary-ext/event-iterator": "^1.0.0",
-    "@mary-ext/simple-event-emitter": "^1.0.0",
-    "partysocket": "^1.1.6",
+    "@mary-ext/simple-event-emitter": "^1.0.1",
+    "partysocket": "^1.1.18",
     "type-fest": "^4.41.0",
-    "@atcute/lexicons": "^1.2.2",
-    "@atcute/cbor": "^2.2.7",
-    "@atcute/uint8array": "^1.0.5"
+    "@atcute/cbor": "^2.3.3",
+    "@atcute/lexicons": "^2.0.0",
+    "@atcute/uint8array": "^1.1.1"
   },
   "devDependencies": {
-    "@atcute/atproto": "^3.1.8"
+    "@atcute/atproto": "^4.0.0"
+  },
+  "peerDependencies": {
+    "@atcute/lexicons": "^2.0.0"
   },
   "scripts": {
-    "build": "tsc --project tsconfig.build.json",
+    "build": "tsgo",
     "prepublish": "rm -rf dist; pnpm run build"
   }
 }