@atcute/xrpc-server 0.1.11 → 1.0.0

package/lib/main/utils/websocket-mock.ts

@@ -1,20 +1,24 @@
 import { AsyncLocalStorage } from 'node:async_hooks';
 
+import { SimpleEventEmitter } from '@mary-ext/simple-event-emitter';
+
 import type { Promisable } from '../../types/misc.ts';
 import type { XRPCRouter } from '../router.ts';
 import type { WebSocketAdapter, WebSocketConnection } from '../types/websocket.ts';
 
-import { EventEmitter } from './event-emitter.ts';
-
 interface WebSocketHandlerContext {
 	handler: ((ws: WebSocketConnection) => Promisable<void>) | null;
 }
 
+export interface CloseEvent {
+	code: number;
+	reason: string;
+	wasClean: boolean;
+}
+
 export interface SubscriptionClient extends Disposable {
-	events: EventEmitter<{
-		message: [data: Uint8Array];
-		close: [event: { code: number; reason: string; wasClean: boolean }];
-	}>;
+	onMessage: SimpleEventEmitter<[data: Uint8Array]>;
+	onClose: SimpleEventEmitter<[event: CloseEvent]>;
 	dispose(): void;
 }
 
@@ -64,10 +68,8 @@ export class MockWebSocketAdapter implements WebSocketAdapter {
 					throw new Error(`WebSocket upgrade succeeded but no handler was set`);
 				}
 
-				const events = new EventEmitter<{
-					message: [data: Uint8Array];
-					close: [event: { code: number; reason: string; wasClean: boolean }];
-				}>();
+				const onMessage = new SimpleEventEmitter<[data: Uint8Array]>();
+				const onClose = new SimpleEventEmitter<[event: CloseEvent]>();
 
 				const controller = new AbortController();
 				const signal = controller.signal;
@@ -75,11 +77,14 @@ export class MockWebSocketAdapter implements WebSocketAdapter {
 				const connection: WebSocketConnection = {
 					signal: signal,
 					send(data) {
-						events.emit('message', data);
+						onMessage.emit(data);
+					},
+					drain() {
+						// tests have no outgoing buffer to observe
 					},
 					close(code = 1000, reason = '') {
 						if (!signal.aborted) {
-							events.emit('close', { code, reason, wasClean: true });
+							onClose.emit({ code, reason, wasClean: true });
 							controller.abort();
 						}
 					},
@@ -93,10 +98,11 @@ export class MockWebSocketAdapter implements WebSocketAdapter {
 				}
 
 				const client: SubscriptionClient = {
-					events,
+					onMessage,
+					onClose,
 					dispose() {
 						if (!signal.aborted) {
-							events.emit('close', { code: 1000, reason: '', wasClean: true });
+							onClose.emit({ code: 1000, reason: '', wasClean: true });
 							controller.abort();
 						}
 					},

package/lib/main/xrpc-error.ts

@@ -1,7 +1,71 @@
+/**
+ * a single WWW-Authenticate challenge. exactly one of `params` or `token68` may
+ * be provided. a bare scheme (no params, no token) is valid and renders as just
+ * the scheme name.
+ *
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc7235#section-4.1 | RFC 7235 §4.1}
+ */
+export interface WWWAuthenticateChallenge {
+	/** authentication scheme, e.g. `Bearer`, `DPoP`, `Basic`. */
+	scheme: string;
+	/** auth-param pairs. entries whose value is `undefined` are omitted. */
+	params?: Record<string, string | undefined>;
+	/**
+	 * token68 value for schemes that carry one instead of auth-params (e.g.
+	 * `Basic`). mutually exclusive with `params`.
+	 */
+	token68?: string;
+}
+
+/**
+ * formats one or more WWW-Authenticate challenges into a single header value.
+ *
+ * each challenge is emitted as `<scheme>` followed by its params or token68.
+ * multiple challenges are joined with `, `. auth-param values are quoted using
+ * `JSON.stringify` (RFC 7230 quoted-string semantics for ASCII content).
+ *
+ * @param challenges one challenge, or an ordered array of challenges
+ * @returns the formatted header value
+ *
+ * @example
+ * ```ts
+ * formatWWWAuthenticate({ scheme: 'Bearer', params: { error: 'BadJwtSignature' } })
+ * // => `Bearer error="BadJwtSignature"`
+ * ```
+ */
+export const formatWWWAuthenticate = (
+	challenges: WWWAuthenticateChallenge | WWWAuthenticateChallenge[],
+): string => {
+	const list = Array.isArray(challenges) ? challenges : [challenges];
+	return list.map(formatChallenge).join(', ');
+};
+
+const formatChallenge = (challenge: WWWAuthenticateChallenge): string => {
+	if (challenge.token68 !== undefined) {
+		return `${challenge.scheme} ${challenge.token68}`;
+	}
+
+	if (challenge.params !== undefined) {
+		const parts: string[] = [];
+		for (const name in challenge.params) {
+			const value = challenge.params[name];
+			if (value !== undefined) {
+				parts.push(`${name}=${JSON.stringify(value)}`);
+			}
+		}
+
+		if (parts.length > 0) {
+			return `${challenge.scheme} ${parts.join(', ')}`;
+		}
+	}
+
+	return challenge.scheme;
+};
+
 export interface XRPCErrorOptions {
 	status: number;
 	error: string;
-	description?: string;
+	message?: string;
 	headers?: HeadersInit;
 }
 
@@ -11,54 +75,65 @@ export class XRPCError extends Error {
 
 	/** error name */
 	readonly error: string;
-	/** error message */
-	readonly description?: string;
 	/** response headers */
 	readonly headers?: HeadersInit;
 
-	constructor({ status, error, description, headers }: XRPCErrorOptions) {
-		super(`${error} > ${description ?? '(unspecified description)'}`);
+	constructor({ status, error, message, headers }: XRPCErrorOptions) {
+		super(message);
 
 		this.status = status;
 
 		this.error = error;
-		this.description = description;
 		this.headers = headers;
 	}
 
 	toResponse(): Response {
 		return Response.json(
-			{ error: this.error, message: this.description },
+			{ error: this.error, message: this.message || undefined },
 			{ status: this.status, headers: this.headers },
 		);
 	}
 }
 
 export class InvalidRequestError extends XRPCError {
-	constructor({
-		status = 400,
-		error = 'InvalidRequest',
-		description,
-		headers,
-	}: Partial<XRPCErrorOptions> = {}) {
-		super({ status, error, description, headers });
+	constructor({ status = 400, error = 'InvalidRequest', message, headers }: Partial<XRPCErrorOptions> = {}) {
+		super({ status, error, message, headers });
 	}
 }
 
+export interface AuthRequiredErrorOptions extends Partial<XRPCErrorOptions> {
+	/**
+	 * WWW-Authenticate challenge(s) to attach to the response. the formatted
+	 * header is set on `headers` automatically, and `access-control-expose-headers`
+	 * is appended so browsers can read it from CORS responses.
+	 */
+	wwwAuthenticate?: WWWAuthenticateChallenge | WWWAuthenticateChallenge[];
+}
+
 export class AuthRequiredError extends XRPCError {
 	constructor({
 		status = 401,
 		error = 'AuthenticationRequired',
-		description,
+		message,
 		headers,
-	}: Partial<XRPCErrorOptions> = {}) {
-		super({ status, error, description, headers });
+		wwwAuthenticate,
+	}: AuthRequiredErrorOptions = {}) {
+		let mergedHeaders = headers;
+
+		if (wwwAuthenticate !== undefined) {
+			const target = new Headers(headers);
+			target.set('www-authenticate', formatWWWAuthenticate(wwwAuthenticate));
+			target.append('access-control-expose-headers', 'www-authenticate');
+			mergedHeaders = target;
+		}
+
+		super({ status, error, message, headers: mergedHeaders });
 	}
 }
 
 export class ForbiddenError extends XRPCError {
-	constructor({ status = 403, error = 'Forbidden', description, headers }: Partial<XRPCErrorOptions> = {}) {
-		super({ status, error, description, headers });
+	constructor({ status = 403, error = 'Forbidden', message, headers }: Partial<XRPCErrorOptions> = {}) {
+		super({ status, error, message, headers });
 	}
 }
 
@@ -66,10 +141,10 @@ export class RateLimitExceededError extends XRPCError {
 	constructor({
 		status = 429,
 		error = 'RateLimitExceeded',
-		description,
+		message,
 		headers,
 	}: Partial<XRPCErrorOptions> = {}) {
-		super({ status, error, description, headers });
+		super({ status, error, message, headers });
 	}
 }
 
@@ -77,21 +152,16 @@ export class InternalServerError extends XRPCError {
 	constructor({
 		status = 500,
 		error = 'InternalServerError',
-		description,
+		message,
 		headers,
 	}: Partial<XRPCErrorOptions> = {}) {
-		super({ status, error, description, headers });
+		super({ status, error, message, headers });
 	}
 }
 
 export class UpstreamFailureError extends XRPCError {
-	constructor({
-		status = 502,
-		error = 'UpstreamFailure',
-		description,
-		headers,
-	}: Partial<XRPCErrorOptions> = {}) {
-		super({ status, error, description, headers });
+	constructor({ status = 502, error = 'UpstreamFailure', message, headers }: Partial<XRPCErrorOptions> = {}) {
+		super({ status, error, message, headers });
 	}
 }
 
@@ -99,40 +169,33 @@ export class NotEnoughResourcesError extends XRPCError {
 	constructor({
 		status = 503,
 		error = 'NotEnoughResources',
-		description,
+		message,
 		headers,
 	}: Partial<XRPCErrorOptions> = {}) {
-		super({ status, error, description, headers });
+		super({ status, error, message, headers });
 	}
 }
 
 export class UpstreamTimeoutError extends XRPCError {
-	constructor({
-		status = 504,
-		error = 'UpstreamTimeout',
-		description,
-		headers,
-	}: Partial<XRPCErrorOptions> = {}) {
-		super({ status, error, description, headers });
+	constructor({ status = 504, error = 'UpstreamTimeout', message, headers }: Partial<XRPCErrorOptions> = {}) {
+		super({ status, error, message, headers });
 	}
 }
 
 export interface XRPCSubscriptionErrorOptions {
 	closeCode?: number;
 	error: string;
-	description?: string;
+	message?: string;
 }
 
 export class XRPCSubscriptionError extends Error {
 	readonly closeCode: number;
 	readonly error: string;
-	readonly description?: string;
 
-	constructor({ closeCode = 1008, error, description }: XRPCSubscriptionErrorOptions) {
-		super(`Subscription error: ${error}${description ? ` - ${description}` : ''}`);
+	constructor({ closeCode = 1008, error, message }: XRPCSubscriptionErrorOptions) {
+		super(message);
 
 		this.closeCode = closeCode;
 		this.error = error;
-		this.description = description;
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atcute/xrpc-server",
-  "version": "0.1.11",
+  "version": "1.0.0",
   "description": "a small web framework for handling XRPC operations",
   "license": "0BSD",
   "repository": {
@@ -11,7 +11,8 @@
     "dist/",
     "lib/",
     "!lib/**/*.bench.ts",
-    "!lib/**/*.test.ts"
+    "!lib/**/*.test.ts",
+    "!dist/**/*.{test,bench}.*"
   ],
   "type": "module",
   "exports": {
@@ -24,25 +25,29 @@
   },
   "dependencies": {
     "@badrap/valita": "^0.4.6",
-    "nanoid": "^5.1.6",
-    "@atcute/cbor": "^2.3.2",
-    "@atcute/crypto": "^2.3.0",
-    "@atcute/identity-resolver": "^1.2.2",
-    "@atcute/lexicons": "^1.2.9",
-    "@atcute/identity": "^1.1.3",
-    "@atcute/multibase": "^1.1.8",
+    "nanoid": "^5.1.11",
+    "@atcute/cbor": "^2.3.3",
+    "@atcute/identity-resolver": "^1.2.3",
+    "@atcute/crypto": "^2.4.1",
+    "@atcute/lexicons": "^1.3.1",
+    "@atcute/identity": "^1.1.5",
+    "@atcute/multibase": "^1.2.0",
     "@atcute/uint8array": "^1.1.1"
   },
   "devDependencies": {
     "@atcute/xrpc-server": "file:",
-    "@types/node": "^25.3.0",
-    "@vitest/coverage-v8": "^4.0.18",
-    "vitest": "^4.0.18",
-    "@atcute/atproto": "^3.1.10",
-    "@atcute/bluesky": "^3.2.19"
+    "@mary-ext/simple-event-emitter": "^1.0.1",
+    "@types/node": "^25.6.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    "vitest": "^4.1.5",
+    "@atcute/atproto": "^3.1.12",
+    "@atcute/bluesky": "^3.3.4"
+  },
+  "peerDependencies": {
+    "@atcute/lexicons": "^1.0.0"
   },
   "scripts": {
-    "build": "tsgo --project tsconfig.build.json",
+    "build": "tsgo",
     "test": "vitest --coverage",
     "prepublish": "rm -rf dist; pnpm run build"
   }

package/dist/main/utils/event-emitter.d.ts

@@ -1,37 +0,0 @@
-/** Converts a tuple into a listener function */
-export type ListenerFor<T extends any[]> = (...args: T) => void;
-/** Generic record of the event name and its argument tuple */
-export type EventMap = {
-    [key: string | symbol]: any[];
-};
-/** Event emitter */
-export declare class EventEmitter<Events extends EventMap> {
-    #private;
-    /**
-     * Appends a listener for the specified event name
-     * @param name Name of the event
-     * @param listener Callback that should be invoked when an event is dispatched
-     * @returns Cleanup function that can be called to remove it
-     */
-    on<E extends keyof Events>(name: E, listener: ListenerFor<Events[E]>): () => void;
-    /**
-     * Remove listener from the specified event name
-     * @param name Name of the event
-     * @param listener Callback to remove
-     */
-    off<E extends keyof Events>(name: E, listener: ListenerFor<Events[E]>): void;
-    /**
-     * Emit an event with the specified name and its payload
-     * @param name Name of the event
-     * @param args Payload for the event
-     * @returns Whether a listener has been called
-     */
-    emit<E extends keyof Events>(name: E, ...args: Events[E]): boolean;
-    /**
-     * Determines if there is a listener on a specified event name
-     * @param name Name of the event
-     * @returns Whether there is a listener registered
-     */
-    has(name: keyof Events): boolean;
-}
-//# sourceMappingURL=event-emitter.d.ts.map

package/dist/main/utils/event-emitter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../../lib/main/utils/event-emitter.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEhE,8DAA8D;AAC9D,MAAM,MAAM,QAAQ,GAAG;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC;CAC9B,CAAC;AAIF,oBAAoB;AACpB,qBAAa,YAAY,CAAC,MAAM,SAAS,QAAQ;;IAGhD;;;;;OAKG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAoBhF;IAED;;;;OAIG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CA2B3E;IAED;;;;;OAKG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAsBjE;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,MAAM,GAAG,OAAO,CAG/B;CACD"}

package/dist/main/utils/event-emitter.js

@@ -1,96 +0,0 @@
-/** Event emitter */
-export class EventEmitter {
-    #events;
-    /**
-     * Appends a listener for the specified event name
-     * @param name Name of the event
-     * @param listener Callback that should be invoked when an event is dispatched
-     * @returns Cleanup function that can be called to remove it
-     */
-    on(name, listener) {
-        let events = this.#events;
-        let existing;
-        if (events === undefined) {
-            events = this.#events = Object.create(null);
-        }
-        else {
-            existing = events[name];
-        }
-        if (existing === undefined) {
-            events[name] = listener;
-        }
-        else if (typeof existing === 'function') {
-            events[name] = [existing, listener];
-        }
-        else {
-            events[name] = existing.concat(listener);
-        }
-        // @ts-expect-error: complains about `listener`
-        return this.off.bind(this, name, listener);
-    }
-    /**
-     * Remove listener from the specified event name
-     * @param name Name of the event
-     * @param listener Callback to remove
-     */
-    off(name, listener) {
-        const events = this.#events;
-        if (events === undefined) {
-            return;
-        }
-        const list = events[name];
-        if (list == undefined) {
-            return;
-        }
-        if (list === listener) {
-            delete events[name];
-        }
-        else if (typeof list !== 'function') {
-            const index = list.indexOf(listener);
-            if (index !== -1) {
-                if (list.length === 2) {
-                    // ^ flips the bit, it's either 0 or 1 here.
-                    events[name] = list[index ^ 1];
-                }
-                else {
-                    events[name] = list.toSpliced(index, 1);
-                }
-            }
-        }
-    }
-    /**
-     * Emit an event with the specified name and its payload
-     * @param name Name of the event
-     * @param args Payload for the event
-     * @returns Whether a listener has been called
-     */
-    emit(name, ...args) {
-        const events = this.#events;
-        if (events === undefined) {
-            return false;
-        }
-        const handler = events[name];
-        if (handler === undefined) {
-            return false;
-        }
-        if (typeof handler === 'function') {
-            handler.apply(this, args);
-        }
-        else {
-            for (let idx = 0, len = handler.length; idx < len; idx++) {
-                handler[idx].apply(this, args);
-            }
-        }
-        return true;
-    }
-    /**
-     * Determines if there is a listener on a specified event name
-     * @param name Name of the event
-     * @returns Whether there is a listener registered
-     */
-    has(name) {
-        const events = this.#events;
-        return events !== undefined && name in events;
-    }
-}
-//# sourceMappingURL=event-emitter.js.map

package/dist/main/utils/event-emitter.js.map

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

package/lib/main/utils/event-emitter.ts

@@ -1,116 +0,0 @@
-/** Converts a tuple into a listener function */
-export type ListenerFor<T extends any[]> = (...args: T) => void;
-
-/** Generic record of the event name and its argument tuple */
-export type EventMap = {
-	[key: string | symbol]: any[];
-};
-
-type MaybeArray<T> = T | T[];
-
-/** Event emitter */
-export class EventEmitter<Events extends EventMap> {
-	#events?: { [E in keyof Events]?: MaybeArray<ListenerFor<Events[E]>> };
-
-	/**
-	 * Appends a listener for the specified event name
-	 * @param name Name of the event
-	 * @param listener Callback that should be invoked when an event is dispatched
-	 * @returns Cleanup function that can be called to remove it
-	 */
-	on<E extends keyof Events>(name: E, listener: ListenerFor<Events[E]>): () => void {
-		let events = this.#events;
-		let existing: MaybeArray<ListenerFor<Events[E]>> | undefined;
-
-		if (events === undefined) {
-			events = this.#events = Object.create(null);
-		} else {
-			existing = events[name];
-		}
-
-		if (existing === undefined) {
-			events![name] = listener;
-		} else if (typeof existing === 'function') {
-			events![name] = [existing, listener];
-		} else {
-			events![name] = existing.concat(listener);
-		}
-
-		// @ts-expect-error: complains about `listener`
-		return this.off.bind(this, name, listener);
-	}
-
-	/**
-	 * Remove listener from the specified event name
-	 * @param name Name of the event
-	 * @param listener Callback to remove
-	 */
-	off<E extends keyof Events>(name: E, listener: ListenerFor<Events[E]>): void {
-		const events = this.#events;
-
-		if (events === undefined) {
-			return;
-		}
-
-		const list = events[name];
-
-		if (list == undefined) {
-			return;
-		}
-
-		if (list === listener) {
-			delete events[name];
-		} else if (typeof list !== 'function') {
-			const index = list.indexOf(listener);
-
-			if (index !== -1) {
-				if (list.length === 2) {
-					// ^ flips the bit, it's either 0 or 1 here.
-					events[name] = list[index ^ 1];
-				} else {
-					events[name] = list.toSpliced(index, 1);
-				}
-			}
-		}
-	}
-
-	/**
-	 * Emit an event with the specified name and its payload
-	 * @param name Name of the event
-	 * @param args Payload for the event
-	 * @returns Whether a listener has been called
-	 */
-	emit<E extends keyof Events>(name: E, ...args: Events[E]): boolean {
-		const events = this.#events;
-
-		if (events === undefined) {
-			return false;
-		}
-
-		const handler = events[name];
-
-		if (handler === undefined) {
-			return false;
-		}
-
-		if (typeof handler === 'function') {
-			handler.apply(this, args);
-		} else {
-			for (let idx = 0, len = handler.length; idx < len; idx++) {
-				handler[idx].apply(this, args);
-			}
-		}
-
-		return true;
-	}
-
-	/**
-	 * Determines if there is a listener on a specified event name
-	 * @param name Name of the event
-	 * @returns Whether there is a listener registered
-	 */
-	has(name: keyof Events): boolean {
-		const events = this.#events;
-		return events !== undefined && name in events;
-	}
-}