@atcute/jetstream 1.0.0

package/LICENSE

@@ -0,0 +1,17 @@
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# @atcute/jetstream
+
+a simple Jetstream client
+
+```ts
+import { JetstreamSubscription } from '@atcute/jetstream';
+import { is } from '@atcute/lexicons';
+
+import { AppBskyFeedPost } from '@atcute/bluesky';
+
+const subscription = new JetstreamSubscription({
+	url: 'wss://jetstream2.us-east.bsky.network',
+	wantedCollections: ['app.bsky.feed.post'],
+});
+
+for await (const event of subscription) {
+	if (event.kind === 'commit') {
+		const commit = event.commit;
+
+		if (commit.collection !== 'app.bsky.feed.post') {
+			continue;
+		}
+
+		if (commit.operation === 'create') {
+			const record = commit.record;
+			if (!is(AppBskyFeedPost.mainSchema, record)) {
+				continue;
+			}
+
+			console.log(`${record.text}`);
+		}
+	}
+}
+```

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './subscription.js';
+export * from './types.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './subscription.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/subscription.d.ts

@@ -0,0 +1,82 @@
+import type { Did } from '@atcute/lexicons';
+import { EventIterator } from '@mary-ext/event-iterator';
+import type { CloseEvent, ErrorEvent, Options } from 'partysocket/ws';
+import type { ReadonlyDeep } from 'type-fest';
+export interface JetstreamSubscriptionOptions {
+    url: string;
+    cursor?: number;
+    /**
+     * Array of collection NSIDs that you're interested in receiving commit events
+     * for, pass in an empty array for no commit events.
+     */
+    wantedCollections?: string[];
+    /**
+     * Array of account DIDs that you're interested in receiving commit events
+     * for, pass in an empty array for no commit events.
+     */
+    wantedDids?: Did[];
+    /**
+     * Whether to validate Jetstream's events, you'd still need to validate the records.
+     * @default true
+     */
+    validateEvents?: boolean;
+    onConnectionOpen?: (event: Event) => void;
+    onConnectionClose?: (event: CloseEvent) => void;
+    onConnectionError?: (event: ErrorEvent) => void;
+    /**
+     * WebSocket connection options
+     */
+    ws?: Options;
+}
+export declare class JetstreamSubscription {
+    #private;
+    constructor(options: JetstreamSubscriptionOptions);
+    [Symbol.asyncIterator](): EventIterator<{
+        did: `did:${string}:${string}`;
+        time_us: number;
+        kind: "commit";
+        commit: {
+            rev: string;
+            collection: `${string}.${string}.${string}`;
+            rkey: string;
+            operation: "create";
+            cid: string;
+            record: Record<string, unknown>;
+        } | {
+            rev: string;
+            collection: `${string}.${string}.${string}`;
+            rkey: string;
+            operation: "update";
+            cid: string;
+            record: Record<string, unknown>;
+        } | {
+            rev: string;
+            collection: `${string}.${string}.${string}`;
+            rkey: string;
+            operation: "delete";
+        };
+    } | {
+        did: `did:${string}:${string}`;
+        time_us: number;
+        kind: "identity";
+        identity: {
+            did: `did:${string}:${string}`;
+            handle: `${string}.${string}`;
+            seq: number;
+            time: string;
+        };
+    } | {
+        did: `did:${string}:${string}`;
+        time_us: number;
+        kind: "account";
+        account: {
+            did: `did:${string}:${string}`;
+            active: boolean;
+            seq: number;
+            time: string;
+        };
+    }>;
+    get cursor(): number;
+    getOptions(): ReadonlyDeep<JetstreamSubscriptionOptions>;
+    updateOptions(options: Partial<JetstreamSubscriptionOptions>): void;
+}

package/dist/subscription.js

@@ -0,0 +1,117 @@
+import { EventIterator } from '@mary-ext/event-iterator';
+import { SimpleEventEmitter } from '@mary-ext/simple-event-emitter';
+import { WebSocket as ReconnectingWebSocket } from 'partysocket';
+import { jetstreamEventSchema } from './types.js';
+const PARSE_OPTIONS = { mode: 'passthrough' };
+export class JetstreamSubscription {
+    #listening = 0;
+    #ws;
+    #emitter = new SimpleEventEmitter();
+    #options;
+    #cursor;
+    constructor(options) {
+        this.#options = options;
+        this.#cursor = options.cursor ?? Date.now() * 1_000;
+    }
+    #sendOptionsUpdate() {
+        const ws = this.#ws;
+        if (ws === undefined) {
+            return;
+        }
+        const payload = {
+            type: 'options_update',
+            payload: {
+                wantedCollections: this.#options.wantedCollections,
+                wantedDids: this.#options.wantedDids,
+            },
+        };
+        ws.send(JSON.stringify(payload));
+    }
+    #create() {
+        if (this.#ws !== undefined) {
+            return;
+        }
+        const { url: wsUrl, ws: wsOptions, validateEvents = true, onConnectionClose, onConnectionError, onConnectionOpen, } = this.#options;
+        const emitter = this.#emitter;
+        const getUrl = () => {
+            const url = new URL('/subscribe', wsUrl);
+            url.searchParams.set('requireHello', 'true');
+            url.searchParams.set('cursor', '' + this.#cursor);
+            return url.toString();
+        };
+        const ws = new ReconnectingWebSocket(getUrl, null, wsOptions);
+        this.#ws = ws;
+        ws.binaryType = 'arraybuffer';
+        ws.onerror = onConnectionError ?? null;
+        ws.onclose = onConnectionClose ?? null;
+        ws.onopen = (ev) => {
+            this.#sendOptionsUpdate();
+            onConnectionOpen?.(ev);
+        };
+        ws.onmessage = (ev) => {
+            const raw = JSON.parse(ev.data);
+            let event;
+            if (validateEvents) {
+                const result = jetstreamEventSchema.try(raw, PARSE_OPTIONS);
+                if (!result.ok) {
+                    return;
+                }
+                event = result.value;
+            }
+            else {
+                event = raw;
+            }
+            this.#cursor = event.time_us;
+            emitter.emit(event);
+        };
+    }
+    #destroy() {
+        const ws = this.#ws;
+        if (ws === undefined) {
+            return;
+        }
+        ws.close();
+        this.#ws = undefined;
+    }
+    [Symbol.asyncIterator]() {
+        return new EventIterator((emit) => {
+            if (this.#listening === 0) {
+                this.#create();
+            }
+            this.#listening++;
+            this.#emitter.subscribe(emit);
+            return () => {
+                if (this.#listening === 1) {
+                    this.#destroy();
+                }
+                this.#listening--;
+                this.#emitter.unsubscribe(emit);
+            };
+        });
+    }
+    get cursor() {
+        return this.#cursor;
+    }
+    getOptions() {
+        return this.#options;
+    }
+    updateOptions(options) {
+        this.#options = { ...this.#options, ...options };
+        if (options.cursor !== undefined) {
+            this.#cursor = options.cursor;
+        }
+        if (this.#ws !== undefined) {
+            const isOptionsUpdate = Object.keys(options).every((key) => {
+                return key === 'wantedCollections' || key === 'wantedDids';
+            });
+            if (isOptionsUpdate) {
+                this.#sendOptionsUpdate();
+            }
+            else {
+                this.#destroy();
+                this.#create();
+            }
+        }
+    }
+}
+//# sourceMappingURL=subscription.js.map

package/dist/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../lib/subscription.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,250 @@
+import * as v from '@badrap/valita';
+declare const _cidStringSchema: v.Type<string>;
+declare const cidStringSchema: cidStringSchema.$schema;
+declare namespace cidStringSchema {
+    export {};
+    type $schematype = typeof _cidStringSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _datetimeStringSchema: v.Type<string>;
+declare const datetimeStringSchema: datetimeStringSchema.$schema;
+declare namespace datetimeStringSchema {
+    export {};
+    type $schematype = typeof _datetimeStringSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _didStringSchema: v.Type<`did:${string}:${string}`>;
+declare const didStringSchema: didStringSchema.$schema;
+declare namespace didStringSchema {
+    export {};
+    type $schematype = typeof _didStringSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _handleStringSchema: v.Type<`${string}.${string}`>;
+declare const handleStringSchema: handleStringSchema.$schema;
+declare namespace handleStringSchema {
+    export {};
+    type $schematype = typeof _handleStringSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _nsidStringSchema: v.Type<`${string}.${string}.${string}`>;
+declare const nsidStringSchema: nsidStringSchema.$schema;
+declare namespace nsidStringSchema {
+    export {};
+    type $schematype = typeof _nsidStringSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _rkeyStringSchema: v.Type<string>;
+declare const rkeyStringSchema: rkeyStringSchema.$schema;
+declare namespace rkeyStringSchema {
+    export {};
+    type $schematype = typeof _rkeyStringSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _tidStringSchema: v.Type<string>;
+declare const tidStringSchema: tidStringSchema.$schema;
+declare namespace tidStringSchema {
+    export {};
+    type $schematype = typeof _tidStringSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _integerSchema: v.Type<number>;
+declare const integerSchema: integerSchema.$schema;
+declare namespace integerSchema {
+    export {};
+    type $schematype = typeof _integerSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _createCommitSchema: v.ObjectType<Omit<{
+    rev: tidStringSchema.$schema;
+    collection: nsidStringSchema.$schema;
+    rkey: rkeyStringSchema.$schema;
+}, "operation" | "cid" | "record"> & {
+    operation: v.Type<"create">;
+    cid: cidStringSchema.$schema;
+    record: v.Type<Record<string, unknown>>;
+}, undefined>;
+export declare const createCommitSchema: createCommitSchema.$schema;
+export interface CreateCommit extends v.Infer<typeof createCommitSchema> {
+}
+export declare namespace createCommitSchema {
+    export {};
+    type $schematype = typeof _createCommitSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _updateCommitSchema: v.ObjectType<Omit<{
+    rev: tidStringSchema.$schema;
+    collection: nsidStringSchema.$schema;
+    rkey: rkeyStringSchema.$schema;
+}, "operation" | "cid" | "record"> & {
+    operation: v.Type<"update">;
+    cid: cidStringSchema.$schema;
+    record: v.Type<Record<string, unknown>>;
+}, undefined>;
+export declare const updateCommitSchema: updateCommitSchema.$schema;
+export interface UpdateCommit extends v.Infer<typeof updateCommitSchema> {
+}
+export declare namespace updateCommitSchema {
+    export {};
+    type $schematype = typeof _updateCommitSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _deleteCommitSchema: v.ObjectType<Omit<{
+    rev: tidStringSchema.$schema;
+    collection: nsidStringSchema.$schema;
+    rkey: rkeyStringSchema.$schema;
+}, "operation"> & {
+    operation: v.Type<"delete">;
+}, undefined>;
+export declare const deleteCommitSchema: deleteCommitSchema.$schema;
+export interface DeleteCommit extends v.Infer<typeof deleteCommitSchema> {
+}
+export declare namespace deleteCommitSchema {
+    export {};
+    type $schematype = typeof _deleteCommitSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _commitOperationSchema: v.UnionType<[createCommitSchema.$schema, updateCommitSchema.$schema, deleteCommitSchema.$schema]>;
+export declare const commitOperationSchema: commitSchema.$schema;
+export type CommitOperation = v.Infer<typeof commitOperationSchema>;
+export declare namespace commitSchema {
+    export {};
+    type $schematype = typeof _commitOperationSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _commitEventSchema: v.ObjectType<Omit<{
+    did: didStringSchema.$schema;
+    time_us: integerSchema.$schema;
+}, "kind" | "commit"> & {
+    kind: v.Type<"commit">;
+    commit: commitSchema.$schema;
+}, undefined>;
+export declare const commitEventSchema: commitEventSchema.$schema;
+export interface CommitEvent extends v.Infer<typeof commitEventSchema> {
+}
+export declare namespace commitEventSchema {
+    export {};
+    type $schematype = typeof _commitEventSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _identityDataSchema: v.ObjectType<{
+    did: didStringSchema.$schema;
+    handle: handleStringSchema.$schema;
+    seq: integerSchema.$schema;
+    time: datetimeStringSchema.$schema;
+}, undefined>;
+export declare const identityDataSchema: identityData.$schema;
+export interface IdentityData extends v.Infer<typeof identityDataSchema> {
+}
+export declare namespace identityData {
+    export {};
+    type $schematype = typeof _identityDataSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _identityEventSchema: v.ObjectType<Omit<{
+    did: didStringSchema.$schema;
+    time_us: integerSchema.$schema;
+}, "kind" | "identity"> & {
+    kind: v.Type<"identity">;
+    identity: identityData.$schema;
+}, undefined>;
+export declare const identityEventSchema: identityEventSchema.$schema;
+export interface IdentityEvent extends v.Infer<typeof identityEventSchema> {
+}
+export declare namespace identityEventSchema {
+    export {};
+    type $schematype = typeof _identityEventSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _accountDataSchema: v.ObjectType<{
+    did: didStringSchema.$schema;
+    active: v.Type<boolean>;
+    seq: integerSchema.$schema;
+    time: datetimeStringSchema.$schema;
+}, undefined>;
+export declare const accountDataSchema: accountDataSchema.$schema;
+export interface AccountData extends v.Infer<typeof accountDataSchema> {
+}
+export declare namespace accountDataSchema {
+    export {};
+    type $schematype = typeof _accountDataSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _accountEventSchema: v.ObjectType<Omit<{
+    did: didStringSchema.$schema;
+    time_us: integerSchema.$schema;
+}, "kind" | "account"> & {
+    kind: v.Type<"account">;
+    account: accountDataSchema.$schema;
+}, undefined>;
+export declare const accountEventSchema: accountEventSchema.$schema;
+export interface AccountEvent extends v.Infer<typeof accountEventSchema> {
+}
+export declare namespace accountEventSchema {
+    export {};
+    type $schematype = typeof _accountEventSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _jetstreamEventSchema: v.UnionType<[commitEventSchema.$schema, identityEventSchema.$schema, accountEventSchema.$schema]>;
+export declare const jetstreamEventSchema: jetstreamEventSchema.$schema;
+export type JetstreamEvent = v.Infer<typeof jetstreamEventSchema>;
+export declare namespace jetstreamEventSchema {
+    export {};
+    type $schematype = typeof _jetstreamEventSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _optionsUpdatePayloadSchema: v.ObjectType<{
+    wantedCollections: v.Optional<string[]>;
+    wantedDids: v.Optional<`did:${string}:${string}`[]>;
+    maxMessageSizeBytes: v.Optional<number>;
+}, undefined>;
+export declare const optionsUpdatePayloadSchema: optionsUpdatePayloadSchema.$schema;
+export interface OptionsUpdatePayload extends v.Infer<typeof optionsUpdatePayloadSchema> {
+}
+export declare namespace optionsUpdatePayloadSchema {
+    export {};
+    type $schematype = typeof _optionsUpdatePayloadSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _optionsUpdateProcedureSchema: v.ObjectType<{
+    type: v.Type<"options_update">;
+    payload: optionsUpdatePayloadSchema.$schema;
+}, undefined>;
+export declare const optionsUpdateProcedureSchema: optionsUpdateProcedureSchema.$schema;
+export interface OptionsUpdateProcedure extends v.Infer<typeof optionsUpdateProcedureSchema> {
+}
+export declare namespace optionsUpdateProcedureSchema {
+    export {};
+    type $schematype = typeof _optionsUpdateProcedureSchema;
+    export interface $schema extends $schematype {
+    }
+}
+declare const _jetstreamProcedureSchema: v.UnionType<[optionsUpdateProcedureSchema.$schema]>;
+export declare const jetstreamProcedureSchema: jetstreamProcedureSchema.$schema;
+export type JetstreamProcedure = v.Infer<typeof jetstreamProcedureSchema>;
+export declare namespace jetstreamProcedureSchema {
+    export {};
+    type $schematype = typeof _jetstreamProcedureSchema;
+    export interface $schema extends $schematype {
+    }
+}
+export {};

package/dist/types.js

@@ -0,0 +1,94 @@
+import * as syntax from '@atcute/lexicons/syntax';
+import * as v from '@badrap/valita';
+const _cidStringSchema = v.string();
+const cidStringSchema = _cidStringSchema;
+const _datetimeStringSchema = v.string().assert(syntax.isDatetime, `must be a datetime`);
+const datetimeStringSchema = _datetimeStringSchema;
+const _didStringSchema = v.string().assert(syntax.isDid, `must be a did`);
+const didStringSchema = _didStringSchema;
+const _handleStringSchema = v.string().assert(syntax.isHandle, `must be a handle`);
+const handleStringSchema = _handleStringSchema;
+const _nsidStringSchema = v.string().assert(syntax.isNsid, `must be an nsid`);
+const nsidStringSchema = _nsidStringSchema;
+const _rkeyStringSchema = v.string().assert(syntax.isRecordKey, `must be a rkey`);
+const rkeyStringSchema = _rkeyStringSchema;
+const _tidStringSchema = v.string().assert(syntax.isTid, `must be a tid`);
+const tidStringSchema = _tidStringSchema;
+const _integerSchema = v
+    .number()
+    .assert((input) => input >= 0 && Number.isSafeInteger(input), `must be a nonnegative integer`);
+const integerSchema = _integerSchema;
+const _baseCommitSchema = v.object({
+    rev: tidStringSchema,
+    collection: nsidStringSchema,
+    rkey: rkeyStringSchema,
+});
+const baseCommitSchema = _baseCommitSchema;
+const _createCommitSchema = baseCommitSchema.extend({
+    operation: v.literal('create'),
+    cid: cidStringSchema,
+    record: v.record(v.unknown()),
+});
+export const createCommitSchema = _createCommitSchema;
+const _updateCommitSchema = baseCommitSchema.extend({
+    operation: v.literal('update'),
+    cid: cidStringSchema,
+    record: v.record(v.unknown()),
+});
+export const updateCommitSchema = _updateCommitSchema;
+const _deleteCommitSchema = baseCommitSchema.extend({
+    operation: v.literal('delete'),
+});
+export const deleteCommitSchema = _deleteCommitSchema;
+const _commitOperationSchema = v.union(createCommitSchema, updateCommitSchema, deleteCommitSchema);
+export const commitOperationSchema = _commitOperationSchema;
+const _baseEventSchema = v.object({
+    did: didStringSchema,
+    time_us: integerSchema,
+});
+const baseEventSchema = _baseEventSchema;
+const _commitEventSchema = baseEventSchema.extend({
+    kind: v.literal('commit'),
+    commit: commitOperationSchema,
+});
+export const commitEventSchema = _commitEventSchema;
+const _identityDataSchema = v.object({
+    did: didStringSchema,
+    handle: handleStringSchema,
+    seq: integerSchema,
+    time: datetimeStringSchema,
+});
+export const identityDataSchema = _identityDataSchema;
+const _identityEventSchema = baseEventSchema.extend({
+    kind: v.literal('identity'),
+    identity: identityDataSchema,
+});
+export const identityEventSchema = _identityEventSchema;
+const _accountDataSchema = v.object({
+    did: didStringSchema,
+    active: v.boolean(),
+    seq: integerSchema,
+    time: datetimeStringSchema,
+});
+export const accountDataSchema = _accountDataSchema;
+const _accountEventSchema = baseEventSchema.extend({
+    kind: v.literal('account'),
+    account: accountDataSchema,
+});
+export const accountEventSchema = _accountEventSchema;
+const _jetstreamEventSchema = v.union(commitEventSchema, identityEventSchema, accountEventSchema);
+export const jetstreamEventSchema = _jetstreamEventSchema;
+const _optionsUpdatePayloadSchema = v.object({
+    wantedCollections: v.array(v.string()).optional(),
+    wantedDids: v.array(didStringSchema).optional(),
+    maxMessageSizeBytes: integerSchema.optional(),
+});
+export const optionsUpdatePayloadSchema = _optionsUpdatePayloadSchema;
+const _optionsUpdateProcedureSchema = v.object({
+    type: v.literal('options_update'),
+    payload: optionsUpdatePayloadSchema,
+});
+export const optionsUpdateProcedureSchema = _optionsUpdateProcedureSchema;
+const _jetstreamProcedureSchema = v.union(optionsUpdateProcedureSchema);
+export const jetstreamProcedureSchema = _jetstreamProcedureSchema;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"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"}

package/lib/index.ts

@@ -0,0 +1,2 @@
+export * from './subscription.js';
+export * from './types.js';

package/lib/subscription.ts

@@ -0,0 +1,192 @@
+import type { Did } from '@atcute/lexicons';
+
+import { EventIterator } from '@mary-ext/event-iterator';
+import { SimpleEventEmitter } from '@mary-ext/simple-event-emitter';
+
+import { WebSocket as ReconnectingWebSocket } from 'partysocket';
+import type { CloseEvent, ErrorEvent, Options } from 'partysocket/ws';
+
+import type { ReadonlyDeep } from 'type-fest';
+
+import { jetstreamEventSchema, type JetstreamEvent, type JetstreamProcedure } from './types.js';
+
+export interface JetstreamSubscriptionOptions {
+	url: string;
+
+	cursor?: number;
+
+	/**
+	 * Array of collection NSIDs that you're interested in receiving commit events
+	 * for, pass in an empty array for no commit events.
+	 */
+	wantedCollections?: string[];
+	/**
+	 * Array of account DIDs that you're interested in receiving commit events
+	 * for, pass in an empty array for no commit events.
+	 */
+	wantedDids?: Did[];
+
+	/**
+	 * Whether to validate Jetstream's events, you'd still need to validate the records.
+	 * @default true
+	 */
+	validateEvents?: boolean;
+
+	onConnectionOpen?: (event: Event) => void;
+	onConnectionClose?: (event: CloseEvent) => void;
+	onConnectionError?: (event: ErrorEvent) => void;
+
+	/**
+	 * WebSocket connection options
+	 */
+	ws?: Options;
+}
+
+const PARSE_OPTIONS = { mode: 'passthrough' } as const;
+
+export class JetstreamSubscription {
+	#listening = 0;
+	#ws?: ReconnectingWebSocket;
+
+	#emitter = new SimpleEventEmitter<[event: JetstreamEvent]>();
+
+	#options: JetstreamSubscriptionOptions;
+	#cursor: number;
+
+	constructor(options: JetstreamSubscriptionOptions) {
+		this.#options = options;
+		this.#cursor = options.cursor ?? Date.now() * 1_000;
+	}
+
+	#sendOptionsUpdate() {
+		const ws = this.#ws;
+		if (ws === undefined) {
+			return;
+		}
+
+		const payload: JetstreamProcedure = {
+			type: 'options_update',
+			payload: {
+				wantedCollections: this.#options.wantedCollections,
+				wantedDids: this.#options.wantedDids,
+			},
+		};
+
+		ws.send(JSON.stringify(payload));
+	}
+
+	#create() {
+		if (this.#ws !== undefined) {
+			return;
+		}
+
+		const {
+			url: wsUrl,
+			ws: wsOptions,
+			validateEvents = true,
+			onConnectionClose,
+			onConnectionError,
+			onConnectionOpen,
+		} = this.#options;
+		const emitter = this.#emitter;
+
+		const getUrl = () => {
+			const url = new URL('/subscribe', wsUrl);
+			url.searchParams.set('requireHello', 'true');
+			url.searchParams.set('cursor', '' + this.#cursor);
+
+			return url.toString();
+		};
+
+		const ws = new ReconnectingWebSocket(getUrl, null, wsOptions);
+		this.#ws = ws;
+
+		ws.binaryType = 'arraybuffer';
+
+		ws.onerror = onConnectionError ?? null;
+		ws.onclose = onConnectionClose ?? null;
+
+		ws.onopen = (ev) => {
+			this.#sendOptionsUpdate();
+			onConnectionOpen?.(ev);
+		};
+
+		ws.onmessage = (ev) => {
+			const raw = JSON.parse(ev.data);
+
+			let event: JetstreamEvent;
+			if (validateEvents) {
+				const result = jetstreamEventSchema.try(raw, PARSE_OPTIONS);
+				if (!result.ok) {
+					return;
+				}
+
+				event = result.value;
+			} else {
+				event = raw;
+			}
+
+			this.#cursor = event.time_us;
+			emitter.emit(event);
+		};
+	}
+
+	#destroy() {
+		const ws = this.#ws;
+		if (ws === undefined) {
+			return;
+		}
+
+		ws.close();
+
+		this.#ws = undefined;
+	}
+
+	[Symbol.asyncIterator]() {
+		return new EventIterator<JetstreamEvent>((emit) => {
+			if (this.#listening === 0) {
+				this.#create();
+			}
+
+			this.#listening++;
+			this.#emitter.subscribe(emit);
+
+			return () => {
+				if (this.#listening === 1) {
+					this.#destroy();
+				}
+
+				this.#listening--;
+				this.#emitter.unsubscribe(emit);
+			};
+		});
+	}
+
+	get cursor() {
+		return this.#cursor;
+	}
+
+	getOptions(): ReadonlyDeep<JetstreamSubscriptionOptions> {
+		return this.#options;
+	}
+
+	updateOptions(options: Partial<JetstreamSubscriptionOptions>): void {
+		this.#options = { ...this.#options, ...options };
+		if (options.cursor !== undefined) {
+			this.#cursor = options.cursor;
+		}
+
+		if (this.#ws !== undefined) {
+			const isOptionsUpdate = Object.keys(options).every((key) => {
+				return key === 'wantedCollections' || key === 'wantedDids';
+			});
+
+			if (isOptionsUpdate) {
+				this.#sendOptionsUpdate();
+			} else {
+				this.#destroy();
+				this.#create();
+			}
+		}
+	}
+}

package/lib/types.ts

@@ -0,0 +1,286 @@
+import * as syntax from '@atcute/lexicons/syntax';
+
+import * as v from '@badrap/valita';
+
+const _cidStringSchema = v.string();
+
+const cidStringSchema = _cidStringSchema as cidStringSchema.$schema;
+declare namespace cidStringSchema {
+	export {};
+
+	type $schematype = typeof _cidStringSchema;
+	export interface $schema extends $schematype {}
+}
+const _datetimeStringSchema = v.string().assert(syntax.isDatetime, `must be a datetime`);
+
+const datetimeStringSchema = _datetimeStringSchema as datetimeStringSchema.$schema;
+declare namespace datetimeStringSchema {
+	export {};
+
+	type $schematype = typeof _datetimeStringSchema;
+	export interface $schema extends $schematype {}
+}
+const _didStringSchema = v.string().assert(syntax.isDid, `must be a did`);
+
+const didStringSchema = _didStringSchema as didStringSchema.$schema;
+declare namespace didStringSchema {
+	export {};
+
+	type $schematype = typeof _didStringSchema;
+	export interface $schema extends $schematype {}
+}
+const _handleStringSchema = v.string().assert(syntax.isHandle, `must be a handle`);
+
+const handleStringSchema = _handleStringSchema as handleStringSchema.$schema;
+declare namespace handleStringSchema {
+	export {};
+
+	type $schematype = typeof _handleStringSchema;
+	export interface $schema extends $schematype {}
+}
+const _nsidStringSchema = v.string().assert(syntax.isNsid, `must be an nsid`);
+
+const nsidStringSchema = _nsidStringSchema as nsidStringSchema.$schema;
+declare namespace nsidStringSchema {
+	export {};
+
+	type $schematype = typeof _nsidStringSchema;
+	export interface $schema extends $schematype {}
+}
+const _rkeyStringSchema = v.string().assert(syntax.isRecordKey, `must be a rkey`);
+
+const rkeyStringSchema = _rkeyStringSchema as rkeyStringSchema.$schema;
+declare namespace rkeyStringSchema {
+	export {};
+
+	type $schematype = typeof _rkeyStringSchema;
+	export interface $schema extends $schematype {}
+}
+const _tidStringSchema = v.string().assert(syntax.isTid, `must be a tid`);
+
+const tidStringSchema = _tidStringSchema as tidStringSchema.$schema;
+declare namespace tidStringSchema {
+	export {};
+
+	type $schematype = typeof _tidStringSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _integerSchema = v
+	.number()
+	.assert((input) => input >= 0 && Number.isSafeInteger(input), `must be a nonnegative integer`);
+
+const integerSchema = _integerSchema as integerSchema.$schema;
+declare namespace integerSchema {
+	export {};
+
+	type $schematype = typeof _integerSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _baseCommitSchema = v.object({
+	rev: tidStringSchema,
+	collection: nsidStringSchema,
+	rkey: rkeyStringSchema,
+});
+
+const baseCommitSchema = _baseCommitSchema as baseCommitSchema.$schema;
+declare namespace baseCommitSchema {
+	export {};
+
+	type $schematype = typeof _baseCommitSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _createCommitSchema = baseCommitSchema.extend({
+	operation: v.literal('create'),
+	cid: cidStringSchema,
+	record: v.record(v.unknown()),
+});
+
+export const createCommitSchema = _createCommitSchema as createCommitSchema.$schema;
+export interface CreateCommit extends v.Infer<typeof createCommitSchema> {}
+export declare namespace createCommitSchema {
+	export {};
+
+	type $schematype = typeof _createCommitSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _updateCommitSchema = baseCommitSchema.extend({
+	operation: v.literal('update'),
+	cid: cidStringSchema,
+	record: v.record(v.unknown()),
+});
+
+export const updateCommitSchema = _updateCommitSchema as updateCommitSchema.$schema;
+export interface UpdateCommit extends v.Infer<typeof updateCommitSchema> {}
+export declare namespace updateCommitSchema {
+	export {};
+
+	type $schematype = typeof _updateCommitSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _deleteCommitSchema = baseCommitSchema.extend({
+	operation: v.literal('delete'),
+});
+
+export const deleteCommitSchema = _deleteCommitSchema as deleteCommitSchema.$schema;
+export interface DeleteCommit extends v.Infer<typeof deleteCommitSchema> {}
+export declare namespace deleteCommitSchema {
+	export {};
+
+	type $schematype = typeof _deleteCommitSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _commitOperationSchema = v.union(createCommitSchema, updateCommitSchema, deleteCommitSchema);
+
+export const commitOperationSchema = _commitOperationSchema as commitSchema.$schema;
+export type CommitOperation = v.Infer<typeof commitOperationSchema>;
+export declare namespace commitSchema {
+	export {};
+
+	type $schematype = typeof _commitOperationSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _baseEventSchema = v.object({
+	did: didStringSchema,
+	time_us: integerSchema,
+});
+
+const baseEventSchema = _baseEventSchema as baseEventSchema.$schema;
+declare namespace baseEventSchema {
+	export {};
+
+	type $schematype = typeof _baseEventSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _commitEventSchema = baseEventSchema.extend({
+	kind: v.literal('commit'),
+	commit: commitOperationSchema,
+});
+
+export const commitEventSchema = _commitEventSchema as commitEventSchema.$schema;
+export interface CommitEvent extends v.Infer<typeof commitEventSchema> {}
+export declare namespace commitEventSchema {
+	export {};
+
+	type $schematype = typeof _commitEventSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _identityDataSchema = v.object({
+	did: didStringSchema,
+	handle: handleStringSchema,
+	seq: integerSchema,
+	time: datetimeStringSchema,
+});
+
+export const identityDataSchema = _identityDataSchema as identityData.$schema;
+export interface IdentityData extends v.Infer<typeof identityDataSchema> {}
+export declare namespace identityData {
+	export {};
+
+	type $schematype = typeof _identityDataSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _identityEventSchema = baseEventSchema.extend({
+	kind: v.literal('identity'),
+	identity: identityDataSchema,
+});
+
+export const identityEventSchema = _identityEventSchema as identityEventSchema.$schema;
+export interface IdentityEvent extends v.Infer<typeof identityEventSchema> {}
+export declare namespace identityEventSchema {
+	export {};
+
+	type $schematype = typeof _identityEventSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _accountDataSchema = v.object({
+	did: didStringSchema,
+	active: v.boolean(),
+	seq: integerSchema,
+	time: datetimeStringSchema,
+});
+
+export const accountDataSchema = _accountDataSchema as accountDataSchema.$schema;
+export interface AccountData extends v.Infer<typeof accountDataSchema> {}
+export declare namespace accountDataSchema {
+	export {};
+
+	type $schematype = typeof _accountDataSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _accountEventSchema = baseEventSchema.extend({
+	kind: v.literal('account'),
+	account: accountDataSchema,
+});
+
+export const accountEventSchema = _accountEventSchema as accountEventSchema.$schema;
+export interface AccountEvent extends v.Infer<typeof accountEventSchema> {}
+export declare namespace accountEventSchema {
+	export {};
+
+	type $schematype = typeof _accountEventSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _jetstreamEventSchema = v.union(commitEventSchema, identityEventSchema, accountEventSchema);
+
+export const jetstreamEventSchema = _jetstreamEventSchema as jetstreamEventSchema.$schema;
+export type JetstreamEvent = v.Infer<typeof jetstreamEventSchema>;
+export declare namespace jetstreamEventSchema {
+	export {};
+
+	type $schematype = typeof _jetstreamEventSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _optionsUpdatePayloadSchema = v.object({
+	wantedCollections: v.array(v.string()).optional(),
+	wantedDids: v.array(didStringSchema).optional(),
+	maxMessageSizeBytes: integerSchema.optional(),
+});
+
+export const optionsUpdatePayloadSchema = _optionsUpdatePayloadSchema as optionsUpdatePayloadSchema.$schema;
+export interface OptionsUpdatePayload extends v.Infer<typeof optionsUpdatePayloadSchema> {}
+export declare namespace optionsUpdatePayloadSchema {
+	export {};
+
+	type $schematype = typeof _optionsUpdatePayloadSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _optionsUpdateProcedureSchema = v.object({
+	type: v.literal('options_update'),
+	payload: optionsUpdatePayloadSchema,
+});
+
+export const optionsUpdateProcedureSchema =
+	_optionsUpdateProcedureSchema as optionsUpdateProcedureSchema.$schema;
+export interface OptionsUpdateProcedure extends v.Infer<typeof optionsUpdateProcedureSchema> {}
+export declare namespace optionsUpdateProcedureSchema {
+	export {};
+
+	type $schematype = typeof _optionsUpdateProcedureSchema;
+	export interface $schema extends $schematype {}
+}
+
+const _jetstreamProcedureSchema = v.union(optionsUpdateProcedureSchema);
+
+export const jetstreamProcedureSchema = _jetstreamProcedureSchema as jetstreamProcedureSchema.$schema;
+export type JetstreamProcedure = v.Infer<typeof jetstreamProcedureSchema>;
+export declare namespace jetstreamProcedureSchema {
+	export {};
+
+	type $schematype = typeof _jetstreamProcedureSchema;
+	export interface $schema extends $schematype {}
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "type": "module",
+  "name": "@atcute/jetstream",
+  "version": "1.0.0",
+  "description": "lightweight and cute Jetstream subscriber for AT Protocol",
+  "license": "MIT",
+  "repository": {
+    "url": "https://github.com/mary-ext/atcute",
+    "directory": "packages/core/jetstream"
+  },
+  "files": [
+    "dist/",
+    "lib/",
+    "!lib/**/*.bench.ts",
+    "!lib/**/*.test.ts"
+  ],
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "@badrap/valita": "^0.4.2",
+    "@mary-ext/event-iterator": "^1.0.0",
+    "@mary-ext/simple-event-emitter": "^1.0.0",
+    "partysocket": "^1.1.4",
+    "type-fest": "^4.41.0",
+    "yocto-queue": "^1.2.1",
+    "@atcute/lexicons": "^1.0.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^3.0.4",
+    "vitest": "^3.0.4"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "test": "vitest run --coverage",
+    "prepublish": "rm -rf dist; pnpm run build"
+  }
+}