e621stream 0.0.0 → 0.0.3

package/README.md

@@ -1,9 +1,9 @@
 # e621stream
 
-A TypeScript client for [E621Stream](https://e621.stream), a live WebSocket stream of e621 activity. It works in Node 22+, Bun, Deno and browsers, has no dependencies, and every event type is typed down to the record it carries.
+A client for [E621Stream](https://e621.stream). Works in node 22+, bun, deno & browsers, has no dependencies, and every event is typed down to the record it has.
 
-```bash
-npm install e621stream
+```sh
+npm i e621stream
 ```
 
 ```ts
@@ -18,7 +18,7 @@ stream.on("post.create", (event) => {
     console.log(event.data.post.id, event.data.post.tags.general);
 });
 stream.on("post.update", (event) => {
-    // only the fields that changed, tags per category
+    // only what changed, tags are per category
     console.log(event.data.changes?.["tags.general"]?.added);
 });
 stream.on("comment.update", (event) => {
@@ -28,12 +28,20 @@ stream.on("error", err => console.error(err));
 stream.connect();
 ```
 
-- **Events:** `on("<event type>", ...)` for one type, typed to its data, or `on("dispatch", ...)` for everything, narrowed by checking `event.type`. See [Events](https://e621.stream/events/) for what each one is.
-- **Reconnecting:** the connection is reopened with backoff when it drops, and resumes from the last event it got, so nothing is missed. It isn't reopened after a close retrying won't fix, like bad credentials. `reconnect: false` turns it off.
-- **Resuming:** pass `cursor` (an event id, or a millisecond timestamp) to replay from there. `stream.cursor` is the last event received.
-- **Changing subscriptions:** `stream.subscribe([...])`.
-- **Private events:** like `dmail.create`, these are polled with your own credentials and have to be subscribed to by name.
-- **Other events:** `ready`, `replayComplete`, `subscribed`, `reconnecting`, `close` and `error`.
-- **Older Node:** pass a WebSocket implementation, like the `ws` package, as the `WebSocket` option.
+Listen for an event type with `on("post.create", ...)`, or everything with `on("dispatch", ...)` (check `event.type` to narrow it). The others are `ready`, `replayComplete`, `subscribed`, `reconnecting`, `close` and `error`. See [Events](https://e621.stream/events/) for what each event is.
 
-Event data comes from the [e621 module](https://www.npmjs.com/package/e621)'s types, so records like `LegacyPost`, `Comment` and `ForumTopic` are exported here too. Mod action events are typed per action: checking `event.data.action` narrows `event.data.values`.
+#### Options
+| Option | Type | Default | Description |
+|:---:|:---:|:---:|:---:|
+| `subscriptions` | Array | | what to subscribe to, `stream.subscribe([...])` changes it later |
+| `auth` | Object | None | `{ username, apiKey }`, or `{ token }` from [/authorize](https://e621.stream/authorize) |
+| `cursor` | String \| Number | None | an event id or ms timestamp to replay from, `stream.cursor` is the last event you got |
+| `reconnect` | Boolean | `true` | reconnect when the connection drops (not after things like bad credentials) |
+| `client` | String | None | shown in the server's logs |
+| `url` | String | `https://e621.stream` | the websocket url comes from its `/info`, a `ws://` or `wss://` url is connected to directly |
+| `fetch` | Function | global `fetch` | used for `/info` |
+| `WebSocket` | WebSocket | global | for older node, the `ws` package works |
+
+Private events like `dmail.create` have to be subscribed to by name.
+
+Records like `LegacyPost`, `Comment` and `ForumTopic` come from the [e621 module](https://www.npmjs.com/package/e621)'s types, and are exported here too. Mod action events are typed per action, so checking `event.data.action` narrows `event.data.values`.

package/dist/E621Stream.d.ts

@@ -1,24 +1,29 @@
 import Emitter from "./Emitter.ts";
 import { type EventType, type PrivateEventType, type StreamEvent, type Subscription } from "./events.ts";
 export interface Options {
-    /** your e621 username and an api key, from Account > Manage API Access */
+    /** Your e621 username & api key, or a token from https://e621.stream/authorize. */
     auth?: {
         apiKey: string;
         username: string;
+    } | {
+        token: string;
     };
-    /** a name for your client, shown in the server's logs */
+    /** Shown in the server's logs. */
     client?: string;
-    /** an event id (or a millisecond timestamp) to replay from. after that, reconnecting resumes from the last event */
+    /** An event id or millisecond timestamp to replay from. */
     cursor?: number | string;
-    /** reconnects with backoff when the connection drops, unless the server closed it for something retrying won't fix */
+    /** Used to get the websocket url from `/info`. */
+    fetch?: typeof fetch;
+    /** Reconnect when the connection drops. */
     reconnect?: boolean;
     subscriptions: Array<Subscription>;
+    /** The site, the websocket url comes from its `/info`. A `ws://` or `wss://` url is connected to directly. */
     url?: string;
-    /** for runtimes without a global WebSocket, like node before 22 (the `ws` package works) */
+    /** For runtimes without a global WebSocket (node < 22), the `ws` package works. */
     WebSocket?: typeof WebSocket;
 }
 export interface Ready {
-    /** when replaying, set if the cursor was older than anything still kept */
+    /** If the cursor was older than anything still kept. */
     cursor_expired?: boolean;
     replaying: boolean;
     session_id: string;
@@ -36,7 +41,7 @@ export interface ClientEvents {
         reason: string;
         reconnecting: boolean;
     }];
-    /** every event, public or private */
+    /** Every event, public or private. */
     dispatch: [StreamEvent];
     error: [Error];
     ready: [Ready];
@@ -44,7 +49,6 @@ export interface ClientEvents {
         attempt: number;
         delayMS: number;
     }];
-    /** replay is done, live events follow */
     replayComplete: [{
         cursor: string | null;
         events: number;
@@ -59,8 +63,8 @@ export declare class StreamError extends Error {
     constructor(code: number, message: string);
 }
 /**
- * a connection to E621Stream, see https://e621.stream
- *
+ * A connection to E621Stream, see https://e621.stream
+ * @example
  * ```ts
  * const stream = new E621Stream({ auth: { username, apiKey }, subscriptions: ["post.create"] });
  * stream.on("post.create", event => console.log(event.data.post.id));
@@ -70,12 +74,12 @@ export declare class StreamError extends Error {
 export declare class E621Stream extends Emitter<Listeners> {
     private attempt;
     private closing;
+    private connecting;
     private heartbeat;
     private lastError;
-    private lastMessage;
+    private lastHeartbeatAck;
     private reconnectTimer;
     private socket;
-    /** the newest event received, which reconnecting resumes from */
     cursor: string | null;
     readonly options: Options & {
         url: string;
@@ -83,13 +87,15 @@ export declare class E621Stream extends Emitter<Listeners> {
     constructor(options: Options);
     private handle;
     private onClose;
+    private open;
     private send;
     private startHeartbeat;
     private stopHeartbeat;
-    /** closes the connection for good */
+    private websocketURL;
+    /** Close the connection. */
     close(): void;
     connect(): this;
-    /** replaces the current subscriptions, and keeps them for reconnecting */
+    /** Replace the current subscriptions. */
     subscribe(subscriptions: Array<Subscription>): void;
 }
 export {};

package/dist/E621Stream.js

@@ -8,7 +8,6 @@ export class StreamError extends Error {
         this.name = "StreamError";
     }
 }
-// closing for any of these again would just get the same result
 const FATAL = new Set([
     CloseCodes.UNKNOWN_OP,
     CloseCodes.DECODE_ERROR,
@@ -17,14 +16,14 @@ const FATAL = new Set([
     CloseCodes.INVALID_SUBSCRIPTION,
     CloseCodes.INVALID_CURSOR,
     CloseCodes.AUTHENTICATION_EXPIRED,
+    CloseCodes.DISCONNECTED,
+    CloseCodes.BANNED,
 ]);
 const MAX_DELAY_MS = 60_000;
 const HEARTBEAT_MS = 30_000;
-// the server answers heartbeats and pings, nothing for this long means the connection is gone without having closed
-const SILENT_MS = 75_000;
 /**
- * a connection to E621Stream, see https://e621.stream
- *
+ * A connection to E621Stream, see https://e621.stream
+ * @example
  * ```ts
  * const stream = new E621Stream({ auth: { username, apiKey }, subscriptions: ["post.create"] });
  * stream.on("post.create", event => console.log(event.data.post.id));
@@ -34,25 +33,24 @@ const SILENT_MS = 75_000;
 export class E621Stream extends Emitter {
     attempt = 0;
     closing = false;
+    connecting = false;
     heartbeat = null;
     lastError = null;
-    lastMessage = 0;
+    lastHeartbeatAck = true;
     reconnectTimer = null;
     socket = null;
-    /** the newest event received, which reconnecting resumes from */
     cursor;
     options;
     constructor(options) {
         super();
-        this.options = { reconnect: true, url: "wss://e621.stream/ws", ...options };
+        this.options = { reconnect: true, url: "https://e621.stream", ...options };
         this.cursor = options.cursor === undefined ? null : String(options.cursor);
     }
     handle(raw) {
         if (typeof raw !== "string") {
-            this.emit("error", new Error("got a binary message, compression isn't supported by this client"));
+            this.emit("error", new Error("compression isn't supported"));
             return;
         }
-        this.lastMessage = Date.now();
         const message = JSON.parse(raw);
         switch (message.op) {
             case "hello": {
@@ -60,7 +58,7 @@ export class E621Stream extends Emitter {
                 this.send({
                     op: "identify",
                     d: {
-                        ...(auth ? { auth: { username: auth.username, api_key: auth.apiKey } } : {}),
+                        ...(auth ? { auth: "token" in auth ? { token: auth.token } : { username: auth.username, api_key: auth.apiKey } } : {}),
                         ...(client ? { client } : {}),
                         ...(this.cursor === null ? {} : { cursor: this.cursor }),
                         subscriptions,
@@ -75,11 +73,10 @@ export class E621Stream extends Emitter {
             }
             case "dispatch": {
                 const event = { id: message.id, type: message.type, time: message.time, data: message.data, ...(message.private ? { private: true } : {}) };
-                // private events aren't in the stream, so they can't be resumed from
                 if (!event.private)
                     this.cursor = event.id;
                 this.emit("dispatch", event);
-                // typescript can't tie each type in the union to its own listener, it's the same event either way
+                // typescript can't narrow this
                 this.emitUnchecked(event.type, event);
                 break;
             }
@@ -91,6 +88,10 @@ export class E621Stream extends Emitter {
                 this.emit("subscribed", message.d.subscriptions);
                 break;
             }
+            case "heartbeat_ack": {
+                this.lastHeartbeatAck = true;
+                break;
+            }
             case "error": {
                 const { code, message: text } = message.d;
                 this.lastError = new StreamError(code, text);
@@ -110,7 +111,6 @@ export class E621Stream extends Emitter {
         if (!reconnecting)
             return;
         this.attempt++;
-        // a server that's rate limiting this connection wants a longer break
         const base = code === CloseCodes.RATE_LIMITED ? 30_000 : 1000;
         const delayMS = Math.min(MAX_DELAY_MS, base * 2 ** (this.attempt - 1)) * (0.75 + Math.random() * 0.5);
         this.emit("reconnecting", { attempt: this.attempt, delayMS: Math.round(delayMS) });
@@ -119,18 +119,32 @@ export class E621Stream extends Emitter {
             this.connect();
         }, delayMS);
     }
+    open(Socket, url) {
+        const socket = this.socket = new Socket(url);
+        socket.addEventListener("open", () => { this.startHeartbeat(); });
+        socket.addEventListener("message", (event) => {
+            try {
+                this.handle(event.data);
+            }
+            catch (err) {
+                this.emit("error", err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+        socket.addEventListener("close", (event) => { this.onClose(event.code, event.reason); });
+        socket.addEventListener("error", () => null);
+    }
     send(payload) {
         if (this.socket?.readyState === 1)
             this.socket.send(JSON.stringify(payload));
     }
     startHeartbeat() {
-        this.lastMessage = Date.now();
+        this.lastHeartbeatAck = true;
         this.heartbeat = setInterval(() => {
-            if (Date.now() - this.lastMessage > SILENT_MS) {
-                // a client-side close code, nothing the server would send
-                this.socket?.close(4999, "no response from the server");
+            if (!this.lastHeartbeatAck) {
+                this.socket?.close(4999, "heartbeat not acknowledged");
                 return;
             }
+            this.lastHeartbeatAck = false;
             this.send({ op: "heartbeat" });
         }, HEARTBEAT_MS);
     }
@@ -139,7 +153,20 @@ export class E621Stream extends Emitter {
             clearInterval(this.heartbeat);
         this.heartbeat = null;
     }
-    /** closes the connection for good */
+    // fetched every time, so it can move
+    async websocketURL() {
+        const { url } = this.options;
+        if (/^wss?:\/\//i.test(url))
+            return url;
+        const res = await (this.options.fetch ?? fetch)(new URL("/info", url));
+        if (!res.ok)
+            throw new Error(`${url}/info returned ${res.status}`);
+        const { websocket } = await res.json();
+        if (typeof websocket !== "string")
+            throw new Error(`${url}/info didn't have a websocket url`);
+        return new URL(websocket, url).href;
+    }
+    /** Close the connection. */
     close() {
         this.closing = true;
         if (this.reconnectTimer)
@@ -148,30 +175,28 @@ export class E621Stream extends Emitter {
         this.socket?.close(1000, "closed by client");
     }
     connect() {
-        if (this.socket)
+        if (this.socket || this.connecting)
             return this;
         this.closing = false;
-        // the dom types say it's always there, node before 22 doesn't have it
+        // not present before node 22
         const global = globalThis.WebSocket;
         const Socket = this.options.WebSocket ?? global;
         if (!Socket)
-            throw new Error("there's no global WebSocket here, pass one as the WebSocket option");
-        const socket = this.socket = new Socket(this.options.url);
-        socket.addEventListener("open", () => { this.startHeartbeat(); });
-        socket.addEventListener("message", (event) => {
-            try {
-                this.handle(event.data);
-            }
-            catch (err) {
-                this.emit("error", err instanceof Error ? err : new Error(String(err)));
-            }
+            throw new Error("no WebSocket available, pass one with the WebSocket option");
+        this.connecting = true;
+        this.websocketURL().then((url) => {
+            this.connecting = false;
+            if (!this.closing)
+                this.open(Socket, url);
+        }, (err) => {
+            this.connecting = false;
+            this.emit("error", err instanceof Error ? err : new Error(String(err)));
+            // retried the same as a dropped connection
+            this.onClose(1006, "couldn't get the websocket url");
         });
-        socket.addEventListener("close", (event) => { this.onClose(event.code, event.reason); });
-        // the close event that follows has the details
-        socket.addEventListener("error", () => null);
         return this;
     }
-    /** replaces the current subscriptions, and keeps them for reconnecting */
+    /** Replace the current subscriptions. */
     subscribe(subscriptions) {
         this.options.subscriptions = subscriptions;
         this.send({ op: "subscribe", d: { subscriptions } });

package/dist/E621Stream.js.map

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

package/dist/Emitter.d.ts

@@ -4,7 +4,6 @@ export default class Emitter<Events extends {
 }> {
     private listeners;
     protected emit<K extends keyof Events>(event: K, ...args: Events[K]): void;
-    /** for an event name only known at runtime, whose listeners' arguments can't be checked */
     protected emitUnchecked(event: keyof Events, ...args: Array<unknown>): void;
     off<K extends keyof Events>(event: K, listener: NoInfer<Listener<Events[K]>>): this;
     on<K extends keyof Events>(event: K, listener: NoInfer<Listener<Events[K]>>): this;

package/dist/Emitter.js

@@ -1,12 +1,9 @@
-// a minimal typed event emitter, so the client has no dependencies and works anywhere
 export default class Emitter {
-    // listeners of every event share one map, so they're stored without their argument types
     listeners = new Map();
     emit(event, ...args) {
         for (const listener of this.listeners.get(event) ?? [])
             listener(...args);
     }
-    /** for an event name only known at runtime, whose listeners' arguments can't be checked */
     emitUnchecked(event, ...args) {
         for (const listener of this.listeners.get(event) ?? [])
             listener(...args);

package/dist/Emitter.js.map

@@ -1 +1 @@
-{"version":3,"file":"Emitter.js","sourceRoot":"","sources":["../lib/Emitter.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAItF,MAAM,CAAC,OAAO,OAAO,OAAO;IACxB,yFAAyF;IACjF,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEhD,IAAI,CAAyB,KAAQ,EAAE,GAAG,IAAe;QAC/D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;YAAG,QAAgC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvG,CAAC;IAED,2FAA2F;IACjF,aAAa,CAAC,KAAmB,EAAE,GAAG,IAAoB;QAChE,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;YAAG,QAAqC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5G,CAAC;IAED,GAAG,CAAyB,KAAQ,EAAE,QAAsC;QACxE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,EAAE,CAAyB,KAAQ,EAAE,QAAsC;QACvE,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;QACrD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,CAAyB,KAAQ,EAAE,QAAsC;QACzE,MAAM,OAAO,GAAwB,CAAC,GAAG,IAAI,EAAE,EAAE;YAC7C,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACzB,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QACtB,CAAC,CAAC;QACF,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;CACJ"}
+{"version":3,"file":"Emitter.js","sourceRoot":"","sources":["../lib/Emitter.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,OAAO,OAAO;IAChB,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEhD,IAAI,CAAyB,KAAQ,EAAE,GAAG,IAAe;QAC/D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;YAAG,QAAgC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvG,CAAC;IAES,aAAa,CAAC,KAAmB,EAAE,GAAG,IAAoB;QAChE,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;YAAG,QAAqC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5G,CAAC;IAED,GAAG,CAAyB,KAAQ,EAAE,QAAsC;QACxE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,EAAE,CAAyB,KAAQ,EAAE,QAAsC;QACvE,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;QACrD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,CAAyB,KAAQ,EAAE,QAAsC;QACzE,MAAM,OAAO,GAAwB,CAAC,GAAG,IAAI,EAAE,EAAE;YAC7C,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACzB,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QACtB,CAAC,CAAC;QACF,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;CACJ"}

package/dist/changes.d.ts

@@ -1,21 +1,19 @@
 import type { LegacyPost } from "./generated.ts";
-/** a field's value before and after */
+/** A field's old and new value. */
 export interface ValueChange<T> {
     new: T;
     old: T;
 }
-/** what was added to and removed from a list */
 export interface SetChange<T> {
     added: Array<T>;
     removed: Array<T>;
 }
-/** what changed on a record, only the fields that did */
 export type Changes<R, Field extends keyof R> = Partial<{
     [K in Field]: ValueChange<R[K]>;
 }>;
 export type TagCategoryName = "artist" | "character" | "contributor" | "copyright" | "general" | "invalid" | "lore" | "meta" | "species";
 export type PostFlagName = Extract<keyof LegacyPost["flags"], string>;
-/** what changed on a post, only the fields that did. tags are per category, so a category change shows up as a move */
+/** Tags are split by category, so moving a tag between categories shows up as a remove & add. */
 export type PostChanges = Partial<Record<`tags.${TagCategoryName}`, SetChange<string>> & Record<`flags.${PostFlagName}`, ValueChange<boolean>> & {
     approver_id: ValueChange<number | null>;
     children: SetChange<number>;
@@ -28,3 +26,37 @@ export type PostChanges = Partial<Record<`tags.${TagCategoryName}`, SetChange<st
     rating: ValueChange<LegacyPost["rating"]>;
     sources: SetChange<string>;
 }>;
+/** What was last known of a post, only `id` is guaranteed. */
+export type PostSnapshot = Partial<{
+    approver_id: number | null;
+    change_seq: number;
+    children: Array<number>;
+    description: string;
+    flags: LegacyPost["flags"];
+    has_notes: boolean;
+    locked_tags: Array<string>;
+    md5: string;
+    parent_id: number | null;
+    pools: Array<number>;
+    rating: LegacyPost["rating"];
+    sources: Array<string>;
+    tags: Partial<Record<TagCategoryName, Array<string>>>;
+} & Omit<PostStats, "changes" | "post_id">> & {
+    id: number;
+};
+export interface PostScore {
+    down: number;
+    total: number;
+    up: number;
+}
+export interface PostStats {
+    changes: Partial<{
+        comment_count: ValueChange<number>;
+        fav_count: ValueChange<number>;
+        score: ValueChange<PostScore>;
+    }>;
+    comment_count: number;
+    fav_count: number;
+    post_id: number;
+    score: PostScore;
+}

package/dist/events.d.ts

@@ -1,25 +1,21 @@
 import type { EventDataMap } from "./generated.ts";
-export declare const EVENT_TYPES: readonly ["artist.create", "artist.delete", "artist.update", "artist_url.create", "artist_version.create", "avoid_posting.create", "avoid_posting.delete", "avoid_posting.destroy", "avoid_posting.undelete", "avoid_posting.update", "avoid_posting_version.create", "ban.create", "ban.delete", "ban.update", "blip.create", "bulk_update_request.create", "bulk_update_request.update", "comment.create", "comment.delete", "comment.hide", "comment.unhide", "comment.update", "forum_post.create", "forum_post.delete", "forum_post.hide", "forum_post.unhide", "forum_post.update", "forum_topic.create", "forum_topic.delete", "forum_topic.hide", "forum_topic.unhide", "forum_topic.update", "help_page.create", "help_page.update", "mod_action.create", "news_update.create", "news_update.update", "note.create", "note.update", "note_version.create", "pool.add_posts", "pool.create", "pool.delete", "pool.remove_posts", "pool.update", "pool_version.create", "post.create", "post.update", "post_approval.create", "post_event.create", "post_flag.create", "post_flag.update", "post_replacement.create", "post_set.add_posts", "post_set.create", "post_set.delete", "post_set.remove_posts", "post_set.update", "post_version.create", "post_version.hide", "post_version.unhide", "tag.create", "tag.delete", "tag.update", "tag_alias.create", "tag_alias.update", "tag_implication.create", "tag_implication.update", "tag_type_version.create", "takedown.create", "takedown.delete", "takedown.update", "upload_karma_event.create", "user.create", "user.delete", "user.update", "user_feedback.create", "user_feedback.delete", "user_feedback.destroy", "user_feedback.undelete", "user_feedback.update", "wiki_page.create", "wiki_page.delete", "wiki_page.update", "wiki_page_version.create"];
+export declare const EVENT_TYPES: readonly ["artist.create", "artist.delete", "artist.update", "artist_url.create", "artist_version.create", "avoid_posting.create", "avoid_posting.delete", "avoid_posting.destroy", "avoid_posting.undelete", "avoid_posting.update", "avoid_posting_version.create", "ban.create", "ban.delete", "ban.update", "blip.create", "bulk_update_request.create", "bulk_update_request.update", "comment.create", "comment.delete", "comment.hide", "comment.unhide", "comment.update", "forum_post.create", "forum_post.delete", "forum_post.hide", "forum_post.unhide", "forum_post.update", "forum_topic.create", "forum_topic.delete", "forum_topic.hide", "forum_topic.unhide", "forum_topic.update", "help_page.create", "help_page.update", "mod_action.create", "news_update.create", "news_update.update", "note.create", "note.update", "note_version.create", "pool.add_posts", "pool.create", "pool.delete", "pool.remove_posts", "pool.update", "pool_version.create", "post.create", "post.destroy", "post.stats", "post.update", "post_approval.create", "post_event.create", "post_flag.create", "post_flag.update", "post_replacement.create", "post_replacement.destroy", "post_replacement.update", "post_set.add_posts", "post_set.create", "post_set.delete", "post_set.remove_posts", "post_set.update", "post_version.create", "post_version.hide", "post_version.unhide", "tag.create", "tag.delete", "tag.update", "tag_alias.create", "tag_alias.update", "tag_implication.create", "tag_implication.update", "tag_type_version.create", "takedown.create", "takedown.delete", "takedown.update", "upload_karma_event.create", "user.create", "user.delete", "user.update", "user_feedback.create", "user_feedback.delete", "user_feedback.destroy", "user_feedback.undelete", "user_feedback.update", "wiki_page.create", "wiki_page.delete", "wiki_page.update", "wiki_page_version.create"];
 export type EventType = typeof EVENT_TYPES[number];
-/** polled with your own credentials and only sent to you, they have to be subscribed to by name */
-export declare const PRIVATE_EVENT_TYPES: readonly ["dmail.create"];
+/** Polled with your own credentials, these need to be subscribed to by name. */
+export declare const PRIVATE_EVENT_TYPES: readonly ["dmail.create", "private_post_set.add_posts", "private_post_set.remove_posts"];
 export type PrivateEventType = typeof PRIVATE_EVENT_TYPES[number];
-/** events whose data is the mod action they come from */
 export declare const MOD_ACTION_EVENT_TYPES: readonly ["artist.delete", "avoid_posting.delete", "avoid_posting.destroy", "avoid_posting.undelete", "ban.delete", "ban.update", "comment.delete", "comment.hide", "comment.unhide", "forum_post.delete", "forum_post.hide", "forum_post.unhide", "forum_topic.delete", "forum_topic.hide", "forum_topic.unhide", "pool.delete", "post_set.delete", "post_version.hide", "post_version.unhide", "tag.delete", "takedown.delete", "user.delete", "user.update", "user_feedback.delete", "user_feedback.destroy", "user_feedback.undelete", "user_feedback.update", "wiki_page.delete"];
-/** updates whose data is the version record they come from */
 export declare const VERSION_EVENT_TYPES: readonly ["artist.update", "avoid_posting.update", "note.update", "pool.update", "tag.update", "wiki_page.update"];
 export type ModActionEventType = typeof MOD_ACTION_EVENT_TYPES[number];
 export type VersionEventType = typeof VERSION_EVENT_TYPES[number];
-/** what an event type's `data` is, see https://e621.stream/events/ */
+/** The data for each event type, see https://e621.stream/events/ */
 export type EventData<T extends EventType | PrivateEventType> = EventDataMap[T];
-/** one event from the stream, narrowed to its type's data by checking `type` */
 export type StreamEvent<T extends EventType | PrivateEventType = EventType | PrivateEventType> = T extends EventType | PrivateEventType ? {
     data: EventData<T>;
-    /** the event's cursor, pass it as `cursor` to resume after it. private events have no cursor */
+    /** Pass this as `cursor` to resume after this event. Private events don't have one. */
     id: string;
-    /** only for private events, which are polled with your own credentials and never stored */
     private?: true;
-    /** when it happened on e621 */
+    /** When it happened on e621. */
     time: string;
     type: T;
 } : never;
@@ -28,12 +24,11 @@ export interface Filter {
     pool_ids?: Array<number>;
     post_ids?: Array<number>;
     set_ids?: Array<number>;
-    /** e621 style tag query, supports `tag`, `-tag`, `~tag` and `rating:<s|q|e>` */
+    /** An e621 style tag query, supporting `tag`, `-tag`, `~tag` and `rating:`. */
     tags?: string;
     topic_ids?: Array<number>;
     user_ids?: Array<number>;
 }
-/** an event type, `<resource>.*`, `*`, or one of those with a filter */
 export type Subscription = string | {
     filter?: Filter;
     type: string;
@@ -51,4 +46,6 @@ export declare const CloseCodes: {
     readonly SLOW_CONSUMER: 4009;
     readonly TOO_MANY_CONNECTIONS: 4010;
     readonly AUTHENTICATION_EXPIRED: 4011;
+    readonly DISCONNECTED: 4012;
+    readonly BANNED: 4013;
 };

package/dist/events.js

@@ -1,4 +1,4 @@
-// kept identical to the server's src/events.ts, the repository's tests check it
+// keep in sync with src/events.ts
 export const EVENT_TYPES = [
     "artist.create",
     "artist.delete",
@@ -47,12 +47,16 @@ export const EVENT_TYPES = [
     "pool.update",
     "pool_version.create",
     "post.create",
+    "post.destroy",
+    "post.stats",
     "post.update",
     "post_approval.create",
     "post_event.create",
     "post_flag.create",
     "post_flag.update",
     "post_replacement.create",
+    "post_replacement.destroy",
+    "post_replacement.update",
     "post_set.add_posts",
     "post_set.create",
     "post_set.delete",
@@ -86,9 +90,12 @@ export const EVENT_TYPES = [
     "wiki_page.update",
     "wiki_page_version.create",
 ];
-/** polled with your own credentials and only sent to you, they have to be subscribed to by name */
-export const PRIVATE_EVENT_TYPES = ["dmail.create"];
-/** events whose data is the mod action they come from */
+/** Polled with your own credentials, these need to be subscribed to by name. */
+export const PRIVATE_EVENT_TYPES = [
+    "dmail.create",
+    "private_post_set.add_posts",
+    "private_post_set.remove_posts",
+];
 export const MOD_ACTION_EVENT_TYPES = [
     "artist.delete",
     "avoid_posting.delete",
@@ -119,8 +126,14 @@ export const MOD_ACTION_EVENT_TYPES = [
     "user_feedback.update",
     "wiki_page.delete",
 ];
-/** updates whose data is the version record they come from */
-export const VERSION_EVENT_TYPES = ["artist.update", "avoid_posting.update", "note.update", "pool.update", "tag.update", "wiki_page.update"];
+export const VERSION_EVENT_TYPES = [
+    "artist.update",
+    "avoid_posting.update",
+    "note.update",
+    "pool.update",
+    "tag.update",
+    "wiki_page.update",
+];
 export const CloseCodes = {
     UNKNOWN_ERROR: 4000,
     UNKNOWN_OP: 4001,
@@ -134,5 +147,7 @@ export const CloseCodes = {
     SLOW_CONSUMER: 4009,
     TOO_MANY_CONNECTIONS: 4010,
     AUTHENTICATION_EXPIRED: 4011,
+    DISCONNECTED: 4012,
+    BANNED: 4013,
 };
 //# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../lib/events.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAEhF,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,eAAe;IACf,eAAe;IACf,eAAe;IACf,mBAAmB;IACnB,uBAAuB;IACvB,sBAAsB;IACtB,sBAAsB;IACtB,uBAAuB;IACvB,wBAAwB;IACxB,sBAAsB;IACtB,8BAA8B;IAC9B,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,4BAA4B;IAC5B,4BAA4B;IAC5B,gBAAgB;IAChB,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,mBAAmB;IACnB,mBAAmB;IACnB,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB,kBAAkB;IAClB,oBAAoB;IACpB,oBAAoB;IACpB,kBAAkB;IAClB,kBAAkB;IAClB,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB,aAAa;IACb,aAAa;IACb,qBAAqB;IACrB,gBAAgB;IAChB,aAAa;IACb,aAAa;IACb,mBAAmB;IACnB,aAAa;IACb,qBAAqB;IACrB,aAAa;IACb,aAAa;IACb,sBAAsB;IACtB,mBAAmB;IACnB,kBAAkB;IAClB,kBAAkB;IAClB,yBAAyB;IACzB,oBAAoB;IACpB,iBAAiB;IACjB,iBAAiB;IACjB,uBAAuB;IACvB,iBAAiB;IACjB,qBAAqB;IACrB,mBAAmB;IACnB,qBAAqB;IACrB,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,kBAAkB;IAClB,kBAAkB;IAClB,wBAAwB;IACxB,wBAAwB;IACxB,yBAAyB;IACzB,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,2BAA2B;IAC3B,aAAa;IACb,aAAa;IACb,aAAa;IACb,sBAAsB;IACtB,sBAAsB;IACtB,uBAAuB;IACvB,wBAAwB;IACxB,sBAAsB;IACtB,kBAAkB;IAClB,kBAAkB;IAClB,kBAAkB;IAClB,0BAA0B;CACpB,CAAC;AAIX,mGAAmG;AAEnG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,cAAc,CAAU,CAAC;AAI7D,yDAAyD;AAEzD,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,eAAe;IACf,sBAAsB;IACtB,uBAAuB;IACvB,wBAAwB;IACxB,YAAY;IACZ,YAAY;IACZ,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,mBAAmB;IACnB,iBAAiB;IACjB,mBAAmB;IACnB,oBAAoB;IACpB,kBAAkB;IAClB,oBAAoB;IACpB,aAAa;IACb,iBAAiB;IACjB,mBAAmB;IACnB,qBAAqB;IACrB,YAAY;IACZ,iBAAiB;IACjB,aAAa;IACb,aAAa;IACb,sBAAsB;IACtB,uBAAuB;IACvB,wBAAwB;IACxB,sBAAsB;IACtB,kBAAkB;CACZ,CAAC;AAEX,8DAA8D;AAE9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,eAAe,EAAE,sBAAsB,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,kBAAkB,CAAU,CAAC;AAkCtJ,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,IAAI;IACpB,qBAAqB,EAAE,IAAI;IAC3B,kBAAkB,EAAE,IAAI;IACxB,oBAAoB,EAAE,IAAI;IAC1B,cAAc,EAAE,IAAI;IACpB,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,IAAI;IACnB,oBAAoB,EAAE,IAAI;IAC1B,sBAAsB,EAAE,IAAI;CACtB,CAAC"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../lib/events.ts"],"names":[],"mappings":"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"}

package/dist/generated.d.ts

@@ -1,4 +1,4 @@
-import type { Changes, PostChanges } from "./changes.ts";
+import type { Changes, PostChanges, PostSnapshot, PostStats } from "./changes.ts";
 export type PoolCategory = 'collection' | 'series';
 export type PostEventAction = 'deleted' | 'undeleted' | 'approved' | 'unapproved' | 'flag_created' | 'flag_removed' | 'favorites_moved' | 'favorites_received' | 'rating_locked' | 'rating_unlocked' | 'status_locked' | 'status_unlocked' | 'note_locked' | 'note_unlocked' | 'comment_locked' | 'comment_unlocked' | 'replacement_accepted' | 'replacement_rejected' | 'replacement_promoted' | 'replacement_deleted' | 'expunged' | 'changed_bg_color' | 'replacement_penalty_changed' | 'owner_changed' | 'replacement_moved';
 export type PostReplacementStatus = 'promoted' | 'approved' | 'rejected' | 'pending' | 'original';
@@ -1084,21 +1084,21 @@ export interface ModActionValues {
     };
 }
 export type ModActionName = keyof ModActionValues;
-/** one variant per action, so checking `action` narrows `values` */
+/** Checking `action` narrows `values`. */
 export type ModAction<A extends ModActionName = ModActionName> = A extends ModActionName ? {
     action: A;
     created_at: string;
     creator_id: number;
     id: number;
     updated_at: string;
-    /** what the action applies to */
+    /** What the action applies to. */
     values: ModActionValues[A];
 } : never;
-/** a record wrapped under its resource name with what changed, `changes` is null when its previous state isn't known */
+/** `changes` is null when the previous state isn't known. */
 export type Update<Resource extends string, R, Field extends keyof R & string> = Record<Resource, R> & {
     changes: Changes<R, Field> | null;
 };
-/** what each event type's `data` is */
+/** The `data` each event type is sent with. */
 export interface EventDataMap {
     "artist.create": Artist;
     "artist.delete": ModAction<"artist_delete">;
@@ -1155,6 +1155,11 @@ export interface EventDataMap {
     "post.create": {
         post: LegacyPost;
     };
+    "post.destroy": {
+        post: PostSnapshot;
+        post_event: PostEvent;
+    };
+    "post.stats": PostStats;
     "post.update": {
         changes: PostChanges | null;
         post: LegacyPost;
@@ -1164,6 +1169,11 @@ export interface EventDataMap {
     "post_flag.create": PostFlag;
     "post_flag.update": Update<"post_flag", PostFlag, "is_resolved">;
     "post_replacement.create": PostReplacement;
+    "post_replacement.destroy": {
+        post_event: PostEvent;
+        post_replacement: Pick<PostReplacement, "id" | "status" | "approver_id" | "reason" | "post_id">;
+    };
+    "post_replacement.update": Update<"post_replacement", PostReplacement, "status" | "approver_id" | "reason" | "post_id">;
     "post_set.add_posts": Record<"post_set", PostSet> & {
         post_ids: Array<number>;
     };
@@ -1201,4 +1211,12 @@ export interface EventDataMap {
     "wiki_page.update": WikiPageVersion;
     "wiki_page_version.create": WikiPageVersion;
     "dmail.create": DMail;
+    "private_post_set.add_posts": {
+        post_ids: Array<number>;
+        post_set: PostSet;
+    };
+    "private_post_set.remove_posts": {
+        post_ids: Array<number>;
+        post_set: PostSet;
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "e621stream",
-  "version": "0.0.0",
+  "version": "0.0.3",
   "description": "A client for E621Stream, a live WebSocket stream of e621 activity",
   "license": "MIT",
   "author": "Donovan_DMC <hewwo@yiff.rocks>",