lunibee 0.2.3 → 0.3.0

package/dist/ws/protocol.d.ts

@@ -91,7 +91,7 @@ export interface IdentifyProperties {
     os?: string;
     browser?: string;
     device?: string;
-    [key: string]: unknown;
+    [key: string]: string | undefined;
 }
 /** Everything IDENTIFY needs. */
 export interface IdentifyOptions {
@@ -102,8 +102,16 @@ export interface IdentifyOptions {
     properties?: IdentifyProperties;
     presence?: GatewayPresence;
 }
+/** The `d` field of an IDENTIFY payload. */
+export interface IdentifyData {
+    token: string;
+    intents: number;
+    properties: IdentifyProperties;
+    presence: Required<GatewayPresence>;
+    shard: [shardId: number, shardCount: number];
+}
 /** Builds an IDENTIFY payload. */
-export declare function identifyPayload(options: IdentifyOptions): GatewayPayload;
+export declare function identifyPayload(options: IdentifyOptions): GatewayPayload<IdentifyData>;
 /** Builds a RESUME payload from the session's resume material. */
 export declare function resumePayload(token: string, resume: ResumeInfo): GatewayPayload;
 /** Builds a heartbeat payload carrying the last sequence seen. */

package/dist/ws/reconnect.d.ts

@@ -44,6 +44,10 @@ export type ScheduleResult = {
     scheduled: true;
     delayMs: number;
     attempt: number;
+    /** Set when reconnects are coming too fast: the delay was raised. */
+    unstable?: {
+        reconnects: number;
+    };
 } | {
     scheduled: false;
     reason: ScheduleRefusal;
@@ -60,6 +64,12 @@ export interface ReconnectOptions {
     maxDelay: number;
     /** Randomness source for jitter; injected in tests. */
     random?: () => number;
+    /** Reconnects inside `stormWindow` before the link counts as unstable (default 5). */
+    stormLimit?: number;
+    /** The span over which reconnects are counted, in ms (default 60,000). */
+    stormWindow?: number;
+    /** Clock in ms; injected in tests. */
+    now?: () => number;
 }
 /** Reconnect scheduling, backoff and attempt coordination. */
 export declare class GatewayReconnect {

package/dist/ws/send-budget.d.ts

@@ -1,11 +1,13 @@
 /**
- * Sliding-window budget for outgoing Gateway payloads.
+ * Sliding-window budget for outgoing Gateway payloads. Heartbeats, IDENTIFY and
+ * RESUME are privileged: they always go out (and are still counted), so
+ * application traffic can never starve them.
  *
  * Discord allows 120 sends per 60 seconds. Application traffic is capped at
  * 115 so the remaining headroom is reserved for privileged sends (heartbeats),
  * which are still recorded so the true total stays under Discord's limit.
  */
-export declare class SendBudget {
+export declare class GatewaySendLimiter {
     #private;
     constructor(limit?: number, windowMs?: number);
     /** Sends recorded within the current window. */
@@ -15,3 +17,5 @@ export declare class SendBudget {
     /** Records a send that went out. */
     record(now?: number): void;
 }
+/** The limiter's name before 0.3.0. */
+export declare const SendBudget: typeof GatewaySendLimiter;

package/dist/ws/session.d.ts

@@ -9,9 +9,12 @@
  */
 /** Everything needed to send a RESUME, or nothing when one is impossible. */
 export interface ResumeInfo {
-    /** Discord's session identifier from READY. */ sessionId: string;
-    /** Last sequence number observed on this session. */ sequence: number;
-    /** Host READY nominated for resuming this session. */ resumeURL: string;
+    /** Discord's session identifier from READY. */
+    sessionId: string;
+    /** Last sequence number observed on this session. */
+    sequence: number;
+    /** Host READY nominated for resuming this session. */
+    resumeURL: string;
 }
 /**
  * What the next connection must do.
@@ -95,6 +98,13 @@ export declare class GatewaySession {
     resumeInfo(): ResumeInfo | undefined;
     /** What the next connection must send: RESUME with material, or IDENTIFY. */
     handshake(): HandshakeIntent;
-    /** Host the next connection should dial: the resume host, else `fallback`. */
+    /**
+     * Host the next connection should dial: the resume host, else `fallback`.
+     * The resume host comes from READY, so it is used only when it is a `wss:`
+     * URL on discord.gg (or a subdomain), or on the fallback's own host; any
+     * other host would receive the bot token in the RESUME frame.
+     */
     connectURL(fallback: string): string;
 }
+/** Whether `url` is a `wss:` URL on discord.gg (or a subdomain) or on `fallback`'s host. */
+export declare function isTrustedGatewayURL(url: string, fallback: string): boolean;

package/dist/ws/state.d.ts

@@ -1,14 +1,23 @@
 /** Gateway connection lifecycle states. */
 export declare enum GatewayState {
-    /** Initial connection state. */ Connect = "CONNECT",
-    /** Gateway HELLO received state. */ Hello = "HELLO",
-    /** IDENTIFY operation in progress. */ Identify = "IDENTIFY",
-    /** RESUME operation in progress. */ Resume = "RESUME",
-    /** Gateway READY state. */ Ready = "READY",
-    /** Gateway dispatch processing state. */ Dispatch = "DISPATCH",
-    /** Heartbeat processing state. */ Heartbeat = "HEARTBEAT",
-    /** Reconnect in progress. */ Reconnect = "RECONNECT",
-    /** Gateway is permanently closed. */ Closed = "CLOSED"
+    /** Initial connection state. */
+    Connect = "CONNECT",
+    /** Gateway HELLO received state. */
+    Hello = "HELLO",
+    /** IDENTIFY operation in progress. */
+    Identify = "IDENTIFY",
+    /** RESUME operation in progress. */
+    Resume = "RESUME",
+    /** Gateway READY state. */
+    Ready = "READY",
+    /** Gateway dispatch processing state. */
+    Dispatch = "DISPATCH",
+    /** Heartbeat processing state. */
+    Heartbeat = "HEARTBEAT",
+    /** Reconnect in progress. */
+    Reconnect = "RECONNECT",
+    /** Gateway is permanently closed. */
+    Closed = "CLOSED"
 }
 /**
  * Discord.js-familiar alias for {@link GatewayState}.
@@ -22,6 +31,8 @@ export declare enum GatewayState {
 export { GatewayState as Status };
 /** Gateway protocol error. */
 export declare class GatewayError extends Error {
-    /** Gateway close/error code. */ readonly code?: number;
-    /** Creates a Gateway error. @param message Error message. @param code Optional Gateway code. @param options Optional error metadata. */ constructor(message: string, code?: number, options?: ErrorOptions);
+    /** Gateway close/error code. */
+    readonly code?: number;
+    /** Creates a Gateway error. @param message Error message. @param code Optional Gateway code. @param options Optional error metadata. */
+    constructor(message: string, code?: number, options?: ErrorOptions);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lunibee",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "A lightweight, Bun-first Discord API library.",
   "type": "module",
   "main": "./dist/index.js",
@@ -92,38 +92,42 @@
     "format:check": "prettier --check \"packages/*/src/**/*.ts\" \"tests/**/*.ts\"",
     "check:deps": "bun scripts/check-dependency-graph.ts",
     "audit:api": "bun scripts/api-audit.ts",
+    "audit:coverage": "bun scripts/api-coverage.ts --check",
     "typecheck": "bunx tsc --noEmit --project tsconfig.json && bunx tsc --noEmit --project tsconfig.strict.json",
     "ci:install": "bun install --frozen-lockfile",
     "ci:deps": "bun run check:deps",
     "ci:typecheck": "bun run typecheck",
     "ci:test": "bun test --coverage && bun test ./packages/testing/src",
-    "ci": "bun run ci:deps && bun run audit:api && bun run format:check && bun run ci:typecheck && bun run ci:test",
+    "ci": "bun run ci:deps && bun run audit:api && bun run audit:coverage && bun run format:check && bun run ci:typecheck && bun run ci:test",
     "bench": "bun benchmarks/parity.ts",
+    "bench:rest": "bun benchmarks/rest-buckets.ts",
+    "bench:compare": "bun scripts/bench-compare.mjs",
     "build:all": "bun run build && bun run build:dts",
     "publish:all": "bun run scripts/publish.ts"
   },
   "dependencies": {
-    "@lunibee/builders": "^0.2.3",
-    "@lunibee/collection": "^0.2.3",
-    "@lunibee/core": "^0.2.3",
-    "@lunibee/formatters": "^0.2.3",
-    "@lunibee/handlers": "^0.2.3",
-    "@lunibee/managers": "^0.2.3",
-    "@lunibee/rest": "^0.2.3",
-    "@lunibee/sharding": "^0.2.3",
-    "@lunibee/structures": "^0.2.3",
-    "@lunibee/types": "^0.2.3",
-    "@lunibee/utils": "^0.2.3",
-    "@lunibee/voice": "^0.2.3",
-    "@lunibee/ws": "^0.2.3"
+    "@lunibee/builders": "^0.3.0",
+    "@lunibee/collection": "^0.3.0",
+    "@lunibee/core": "^0.3.0",
+    "@lunibee/formatters": "^0.3.0",
+    "@lunibee/handlers": "^0.3.0",
+    "@lunibee/managers": "^0.3.0",
+    "@lunibee/rest": "^0.3.0",
+    "@lunibee/sharding": "^0.3.0",
+    "@lunibee/structures": "^0.3.0",
+    "@lunibee/types": "^0.3.0",
+    "@lunibee/utils": "^0.3.0",
+    "@lunibee/voice": "^0.3.0",
+    "@lunibee/ws": "^0.3.0"
   },
   "devDependencies": {
+    "@discordjs/collection": "^2.1.1",
     "@types/bun": "^1.4.1",
     "prettier": "^3.9.9",
     "typescript": "^7.0.2"
   },
   "engines": {
-    "bun": ">=1.2.0"
+    "bun": ">=1.4.0"
   },
   "license": "MIT"
 }