@atproto/lex-server 0.0.7 → 0.0.9

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @atproto/lex-server
 
+## 0.0.9
+
+### Patch Changes
+
+- [#4603](https://github.com/bluesky-social/atproto/pull/4603) [`7b9a98a`](https://github.com/bluesky-social/atproto/commit/7b9a98a763636c5f66a06da11fe6013f29dd9157) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Fix flaky test
+
+- [#4601](https://github.com/bluesky-social/atproto/pull/4601) [`ed61c62`](https://github.com/bluesky-social/atproto/commit/ed61c62f3161fcde85ee9a93f8ed339c7e06c015) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Fix `exports` field in package.json
+
+- [#4601](https://github.com/bluesky-social/atproto/pull/4601) [`ed61c62`](https://github.com/bluesky-social/atproto/commit/ed61c62f3161fcde85ee9a93f8ed339c7e06c015) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Add JSDoc
+
+- Updated dependencies [[`7b9a98a`](https://github.com/bluesky-social/atproto/commit/7b9a98a763636c5f66a06da11fe6013f29dd9157), [`7b9a98a`](https://github.com/bluesky-social/atproto/commit/7b9a98a763636c5f66a06da11fe6013f29dd9157), [`ed61c62`](https://github.com/bluesky-social/atproto/commit/ed61c62f3161fcde85ee9a93f8ed339c7e06c015), [`ed61c62`](https://github.com/bluesky-social/atproto/commit/ed61c62f3161fcde85ee9a93f8ed339c7e06c015), [`7b9a98a`](https://github.com/bluesky-social/atproto/commit/7b9a98a763636c5f66a06da11fe6013f29dd9157), [`7b9a98a`](https://github.com/bluesky-social/atproto/commit/7b9a98a763636c5f66a06da11fe6013f29dd9157), [`ed61c62`](https://github.com/bluesky-social/atproto/commit/ed61c62f3161fcde85ee9a93f8ed339c7e06c015)]:
+  - @atproto/lex-schema@0.0.12
+  - @atproto/lex-json@0.0.11
+  - @atproto/lex-cbor@0.0.11
+  - @atproto/lex-data@0.0.11
+
+## 0.0.8
+
+### Patch Changes
+
+- [#4589](https://github.com/bluesky-social/atproto/pull/4589) [`369bb02`](https://github.com/bluesky-social/atproto/commit/369bb02b9f80f0e15e5242e54f09bd4e01117f3a) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Make `LexRouter.handlers` property public
+
+- [#4589](https://github.com/bluesky-social/atproto/pull/4589) [`369bb02`](https://github.com/bluesky-social/atproto/commit/369bb02b9f80f0e15e5242e54f09bd4e01117f3a) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Expose `sendResponse` for writing a `Response` object to a NodeJS `ServerResponse`
+
+- Updated dependencies [[`369bb02`](https://github.com/bluesky-social/atproto/commit/369bb02b9f80f0e15e5242e54f09bd4e01117f3a)]:
+  - @atproto/lex-data@0.0.10
+  - @atproto/lex-cbor@0.0.10
+  - @atproto/lex-json@0.0.10
+  - @atproto/lex-schema@0.0.11
+
 ## 0.0.7
 
 ### Patch Changes

package/dist/errors.d.ts

@@ -1,13 +1,107 @@
 import { LexError, LexErrorCode } from '@atproto/lex-data';
 import { WWWAuthenticate } from './lib/www-authenticate.js';
 export type { WWWAuthenticate };
+/**
+ * Error class for authentication failures in XRPC server handlers.
+ *
+ * Extends {@link LexError} to include WWW-Authenticate header support,
+ * which is required by HTTP authentication standards (RFC 7235).
+ * The error automatically generates the appropriate 401 response with
+ * the WWW-Authenticate header when converted to a Response.
+ *
+ * @typeParam N - The Lexicon error code type
+ *
+ * @example Throwing an auth error
+ * ```typescript
+ * import { LexServerAuthError } from '@atproto/lex-server'
+ *
+ * throw new LexServerAuthError(
+ *   'AuthenticationRequired',
+ *   'Invalid or expired token',
+ *   { Bearer: { error: 'InvalidToken', realm: 'api.example.com' } }
+ * )
+ * ```
+ *
+ * @example Converting from a LexError
+ * ```typescript
+ * try {
+ *   await validateToken(token)
+ * } catch (error) {
+ *   if (error instanceof LexError) {
+ *     throw LexServerAuthError.from(error, {
+ *       Bearer: { error: 'InvalidToken' }
+ *     })
+ *   }
+ *   throw error
+ * }
+ * ```
+ */
 export declare class LexServerAuthError<N extends LexErrorCode = LexErrorCode> extends LexError<N> {
     readonly wwwAuthenticate: WWWAuthenticate;
     name: string;
+    /**
+     * Creates a new authentication error.
+     *
+     * @param error - The Lexicon error code (e.g., 'AuthenticationRequired')
+     * @param message - Human-readable error message
+     * @param wwwAuthenticate - WWW-Authenticate header parameters
+     * @param options - Standard Error options including `cause`
+     */
     constructor(error: N, message: string, wwwAuthenticate?: WWWAuthenticate, options?: ErrorOptions);
+    /**
+     * Gets the formatted WWW-Authenticate header value.
+     *
+     * @returns The formatted header string for the 401 response
+     *
+     * @example
+     * ```typescript
+     * const error = new LexServerAuthError('AuthenticationRequired', 'Token required', {
+     *   Bearer: { realm: 'api.example.com', error: 'MissingToken' }
+     * })
+     * console.log(error.wwwAuthenticateHeader)
+     * // Output: 'Bearer realm="api.example.com", error="MissingToken"'
+     * ```
+     */
     get wwwAuthenticateHeader(): string;
+    /**
+     * Converts the error to a JSON representation suitable for response bodies.
+     *
+     * If the error was created from another LexError (via `from()`), returns
+     * the original error's JSON representation.
+     *
+     * @returns JSON object with error code and message
+     */
     toJSON(): import("@atproto/lex-data").LexErrorData<any>;
+    /**
+     * Converts the error to an HTTP 401 Response with WWW-Authenticate header.
+     *
+     * The response includes:
+     * - Status code 401 (Unauthorized)
+     * - WWW-Authenticate header (if parameters were provided)
+     * - Access-Control-Expose-Headers for CORS compatibility
+     * - JSON body with error details
+     *
+     * @returns HTTP Response object ready to be sent to the client
+     */
     toResponse(): Response;
+    /**
+     * Creates a LexServerAuthError from an existing LexError.
+     *
+     * If the input is already a LexServerAuthError, returns it unchanged.
+     * Otherwise, wraps the error with the provided WWW-Authenticate parameters.
+     *
+     * @param cause - The original LexError to wrap
+     * @param wwwAuthenticate - WWW-Authenticate header parameters
+     * @returns A LexServerAuthError instance
+     *
+     * @example
+     * ```typescript
+     * const lexError = new LexError('AuthenticationRequired', 'Token expired')
+     * const authError = LexServerAuthError.from(lexError, {
+     *   Bearer: { error: 'ExpiredToken' }
+     * })
+     * ```
+     */
     static from(cause: LexError, wwwAuthenticate?: WWWAuthenticate): LexServerAuthError;
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EACL,eAAe,EAEhB,MAAM,2BAA2B,CAAA;AAElC,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B,qBAAa,kBAAkB,CAC7B,CAAC,SAAS,YAAY,GAAG,YAAY,CACrC,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAMjB,QAAQ,CAAC,eAAe,EAAE,eAAe;IAL3C,IAAI,SAAuB;gBAGzB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,MAAM,EACN,eAAe,GAAE,eAAoB,EAC9C,OAAO,CAAC,EAAE,YAAY;IAKxB,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED,MAAM;IAKN,UAAU,IAAI,QAAQ;IAatB,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,QAAQ,EACf,eAAe,CAAC,EAAE,eAAe,GAChC,kBAAkB;CAMtB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EACL,eAAe,EAEhB,MAAM,2BAA2B,CAAA;AAElC,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,kBAAkB,CAC7B,CAAC,SAAS,YAAY,GAAG,YAAY,CACrC,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAcjB,QAAQ,CAAC,eAAe,EAAE,eAAe;IAb3C,IAAI,SAAuB;IAE3B;;;;;;;OAOG;gBAED,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,MAAM,EACN,eAAe,GAAE,eAAoB,EAC9C,OAAO,CAAC,EAAE,YAAY;IAKxB;;;;;;;;;;;;;OAaG;IACH,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED;;;;;;;OAOG;IACH,MAAM;IAKN;;;;;;;;;;OAUG;IACH,UAAU,IAAI,QAAQ;IAatB;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,QAAQ,EACf,eAAe,CAAC,EAAE,eAAe,GAChC,kBAAkB;CAMtB"}

package/dist/errors.js

@@ -3,20 +3,96 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LexServerAuthError = void 0;
 const lex_data_1 = require("@atproto/lex-data");
 const www_authenticate_js_1 = require("./lib/www-authenticate.js");
+/**
+ * Error class for authentication failures in XRPC server handlers.
+ *
+ * Extends {@link LexError} to include WWW-Authenticate header support,
+ * which is required by HTTP authentication standards (RFC 7235).
+ * The error automatically generates the appropriate 401 response with
+ * the WWW-Authenticate header when converted to a Response.
+ *
+ * @typeParam N - The Lexicon error code type
+ *
+ * @example Throwing an auth error
+ * ```typescript
+ * import { LexServerAuthError } from '@atproto/lex-server'
+ *
+ * throw new LexServerAuthError(
+ *   'AuthenticationRequired',
+ *   'Invalid or expired token',
+ *   { Bearer: { error: 'InvalidToken', realm: 'api.example.com' } }
+ * )
+ * ```
+ *
+ * @example Converting from a LexError
+ * ```typescript
+ * try {
+ *   await validateToken(token)
+ * } catch (error) {
+ *   if (error instanceof LexError) {
+ *     throw LexServerAuthError.from(error, {
+ *       Bearer: { error: 'InvalidToken' }
+ *     })
+ *   }
+ *   throw error
+ * }
+ * ```
+ */
 class LexServerAuthError extends lex_data_1.LexError {
     wwwAuthenticate;
     name = 'LexServerAuthError';
+    /**
+     * Creates a new authentication error.
+     *
+     * @param error - The Lexicon error code (e.g., 'AuthenticationRequired')
+     * @param message - Human-readable error message
+     * @param wwwAuthenticate - WWW-Authenticate header parameters
+     * @param options - Standard Error options including `cause`
+     */
     constructor(error, message, wwwAuthenticate = {}, options) {
         super(error, message, options);
         this.wwwAuthenticate = wwwAuthenticate;
     }
+    /**
+     * Gets the formatted WWW-Authenticate header value.
+     *
+     * @returns The formatted header string for the 401 response
+     *
+     * @example
+     * ```typescript
+     * const error = new LexServerAuthError('AuthenticationRequired', 'Token required', {
+     *   Bearer: { realm: 'api.example.com', error: 'MissingToken' }
+     * })
+     * console.log(error.wwwAuthenticateHeader)
+     * // Output: 'Bearer realm="api.example.com", error="MissingToken"'
+     * ```
+     */
     get wwwAuthenticateHeader() {
         return (0, www_authenticate_js_1.formatWWWAuthenticateHeader)(this.wwwAuthenticate);
     }
+    /**
+     * Converts the error to a JSON representation suitable for response bodies.
+     *
+     * If the error was created from another LexError (via `from()`), returns
+     * the original error's JSON representation.
+     *
+     * @returns JSON object with error code and message
+     */
     toJSON() {
         const { cause } = this;
         return cause instanceof lex_data_1.LexError ? cause.toJSON() : super.toJSON();
     }
+    /**
+     * Converts the error to an HTTP 401 Response with WWW-Authenticate header.
+     *
+     * The response includes:
+     * - Status code 401 (Unauthorized)
+     * - WWW-Authenticate header (if parameters were provided)
+     * - Access-Control-Expose-Headers for CORS compatibility
+     * - JSON body with error details
+     *
+     * @returns HTTP Response object ready to be sent to the client
+     */
     toResponse() {
         const { wwwAuthenticateHeader } = this;
         const headers = wwwAuthenticateHeader
@@ -27,6 +103,24 @@ class LexServerAuthError extends lex_data_1.LexError {
             : undefined;
         return Response.json(this.toJSON(), { status: 401, headers });
     }
+    /**
+     * Creates a LexServerAuthError from an existing LexError.
+     *
+     * If the input is already a LexServerAuthError, returns it unchanged.
+     * Otherwise, wraps the error with the provided WWW-Authenticate parameters.
+     *
+     * @param cause - The original LexError to wrap
+     * @param wwwAuthenticate - WWW-Authenticate header parameters
+     * @returns A LexServerAuthError instance
+     *
+     * @example
+     * ```typescript
+     * const lexError = new LexError('AuthenticationRequired', 'Token expired')
+     * const authError = LexServerAuthError.from(lexError, {
+     *   Bearer: { error: 'ExpiredToken' }
+     * })
+     * ```
+     */
     static from(cause, wwwAuthenticate) {
         if (cause instanceof LexServerAuthError)
             return cause;

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,gDAA0D;AAC1D,mEAGkC;AAIlC,MAAa,kBAEX,SAAQ,mBAAW;IAMR;IALX,IAAI,GAAG,oBAAoB,CAAA;IAE3B,YACE,KAAQ,EACR,OAAe,EACN,kBAAmC,EAAE,EAC9C,OAAsB;QAEtB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QAHrB,oBAAe,GAAf,eAAe,CAAsB;IAIhD,CAAC;IAED,IAAI,qBAAqB;QACvB,OAAO,IAAA,iDAA2B,EAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAC1D,CAAC;IAED,MAAM;QACJ,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;QACtB,OAAO,KAAK,YAAY,mBAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAA;IACpE,CAAC;IAED,UAAU;QACR,MAAM,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAA;QAEtC,MAAM,OAAO,GAAG,qBAAqB;YACnC,CAAC,CAAC,IAAI,OAAO,CAAC;gBACV,kBAAkB,EAAE,qBAAqB;gBACzC,+BAA+B,EAAE,kBAAkB,EAAE,OAAO;aAC7D,CAAC;YACJ,CAAC,CAAC,SAAS,CAAA;QAEb,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;IAC/D,CAAC;IAED,MAAM,CAAC,IAAI,CACT,KAAe,EACf,eAAiC;QAEjC,IAAI,KAAK,YAAY,kBAAkB;YAAE,OAAO,KAAK,CAAA;QACrD,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE;YACzE,KAAK;SACN,CAAC,CAAA;IACJ,CAAC;CACF;AA7CD,gDA6CC","sourcesContent":["import { LexError, LexErrorCode } from '@atproto/lex-data'\nimport {\n  WWWAuthenticate,\n  formatWWWAuthenticateHeader,\n} from './lib/www-authenticate.js'\n\nexport type { WWWAuthenticate }\n\nexport class LexServerAuthError<\n  N extends LexErrorCode = LexErrorCode,\n> extends LexError<N> {\n  name = 'LexServerAuthError'\n\n  constructor(\n    error: N,\n    message: string,\n    readonly wwwAuthenticate: WWWAuthenticate = {},\n    options?: ErrorOptions,\n  ) {\n    super(error, message, options)\n  }\n\n  get wwwAuthenticateHeader(): string {\n    return formatWWWAuthenticateHeader(this.wwwAuthenticate)\n  }\n\n  toJSON() {\n    const { cause } = this\n    return cause instanceof LexError ? cause.toJSON() : super.toJSON()\n  }\n\n  toResponse(): Response {\n    const { wwwAuthenticateHeader } = this\n\n    const headers = wwwAuthenticateHeader\n      ? new Headers({\n          'WWW-Authenticate': wwwAuthenticateHeader,\n          'Access-Control-Expose-Headers': 'WWW-Authenticate', // CORS\n        })\n      : undefined\n\n    return Response.json(this.toJSON(), { status: 401, headers })\n  }\n\n  static from(\n    cause: LexError,\n    wwwAuthenticate?: WWWAuthenticate,\n  ): LexServerAuthError {\n    if (cause instanceof LexServerAuthError) return cause\n    return new LexServerAuthError(cause.error, cause.message, wwwAuthenticate, {\n      cause,\n    })\n  }\n}\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,gDAA0D;AAC1D,mEAGkC;AAIlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAa,kBAEX,SAAQ,mBAAW;IAcR;IAbX,IAAI,GAAG,oBAAoB,CAAA;IAE3B;;;;;;;OAOG;IACH,YACE,KAAQ,EACR,OAAe,EACN,kBAAmC,EAAE,EAC9C,OAAsB;QAEtB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QAHrB,oBAAe,GAAf,eAAe,CAAsB;IAIhD,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,qBAAqB;QACvB,OAAO,IAAA,iDAA2B,EAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAC1D,CAAC;IAED;;;;;;;OAOG;IACH,MAAM;QACJ,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;QACtB,OAAO,KAAK,YAAY,mBAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAA;IACpE,CAAC;IAED;;;;;;;;;;OAUG;IACH,UAAU;QACR,MAAM,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAA;QAEtC,MAAM,OAAO,GAAG,qBAAqB;YACnC,CAAC,CAAC,IAAI,OAAO,CAAC;gBACV,kBAAkB,EAAE,qBAAqB;gBACzC,+BAA+B,EAAE,kBAAkB,EAAE,OAAO;aAC7D,CAAC;YACJ,CAAC,CAAC,SAAS,CAAA;QAEb,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;IAC/D,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,IAAI,CACT,KAAe,EACf,eAAiC;QAEjC,IAAI,KAAK,YAAY,kBAAkB;YAAE,OAAO,KAAK,CAAA;QACrD,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE;YACzE,KAAK;SACN,CAAC,CAAA;IACJ,CAAC;CACF;AAxGD,gDAwGC","sourcesContent":["import { LexError, LexErrorCode } from '@atproto/lex-data'\nimport {\n  WWWAuthenticate,\n  formatWWWAuthenticateHeader,\n} from './lib/www-authenticate.js'\n\nexport type { WWWAuthenticate }\n\n/**\n * Error class for authentication failures in XRPC server handlers.\n *\n * Extends {@link LexError} to include WWW-Authenticate header support,\n * which is required by HTTP authentication standards (RFC 7235).\n * The error automatically generates the appropriate 401 response with\n * the WWW-Authenticate header when converted to a Response.\n *\n * @typeParam N - The Lexicon error code type\n *\n * @example Throwing an auth error\n * ```typescript\n * import { LexServerAuthError } from '@atproto/lex-server'\n *\n * throw new LexServerAuthError(\n *   'AuthenticationRequired',\n *   'Invalid or expired token',\n *   { Bearer: { error: 'InvalidToken', realm: 'api.example.com' } }\n * )\n * ```\n *\n * @example Converting from a LexError\n * ```typescript\n * try {\n *   await validateToken(token)\n * } catch (error) {\n *   if (error instanceof LexError) {\n *     throw LexServerAuthError.from(error, {\n *       Bearer: { error: 'InvalidToken' }\n *     })\n *   }\n *   throw error\n * }\n * ```\n */\nexport class LexServerAuthError<\n  N extends LexErrorCode = LexErrorCode,\n> extends LexError<N> {\n  name = 'LexServerAuthError'\n\n  /**\n   * Creates a new authentication error.\n   *\n   * @param error - The Lexicon error code (e.g., 'AuthenticationRequired')\n   * @param message - Human-readable error message\n   * @param wwwAuthenticate - WWW-Authenticate header parameters\n   * @param options - Standard Error options including `cause`\n   */\n  constructor(\n    error: N,\n    message: string,\n    readonly wwwAuthenticate: WWWAuthenticate = {},\n    options?: ErrorOptions,\n  ) {\n    super(error, message, options)\n  }\n\n  /**\n   * Gets the formatted WWW-Authenticate header value.\n   *\n   * @returns The formatted header string for the 401 response\n   *\n   * @example\n   * ```typescript\n   * const error = new LexServerAuthError('AuthenticationRequired', 'Token required', {\n   *   Bearer: { realm: 'api.example.com', error: 'MissingToken' }\n   * })\n   * console.log(error.wwwAuthenticateHeader)\n   * // Output: 'Bearer realm=\"api.example.com\", error=\"MissingToken\"'\n   * ```\n   */\n  get wwwAuthenticateHeader(): string {\n    return formatWWWAuthenticateHeader(this.wwwAuthenticate)\n  }\n\n  /**\n   * Converts the error to a JSON representation suitable for response bodies.\n   *\n   * If the error was created from another LexError (via `from()`), returns\n   * the original error's JSON representation.\n   *\n   * @returns JSON object with error code and message\n   */\n  toJSON() {\n    const { cause } = this\n    return cause instanceof LexError ? cause.toJSON() : super.toJSON()\n  }\n\n  /**\n   * Converts the error to an HTTP 401 Response with WWW-Authenticate header.\n   *\n   * The response includes:\n   * - Status code 401 (Unauthorized)\n   * - WWW-Authenticate header (if parameters were provided)\n   * - Access-Control-Expose-Headers for CORS compatibility\n   * - JSON body with error details\n   *\n   * @returns HTTP Response object ready to be sent to the client\n   */\n  toResponse(): Response {\n    const { wwwAuthenticateHeader } = this\n\n    const headers = wwwAuthenticateHeader\n      ? new Headers({\n          'WWW-Authenticate': wwwAuthenticateHeader,\n          'Access-Control-Expose-Headers': 'WWW-Authenticate', // CORS\n        })\n      : undefined\n\n    return Response.json(this.toJSON(), { status: 401, headers })\n  }\n\n  /**\n   * Creates a LexServerAuthError from an existing LexError.\n   *\n   * If the input is already a LexServerAuthError, returns it unchanged.\n   * Otherwise, wraps the error with the provided WWW-Authenticate parameters.\n   *\n   * @param cause - The original LexError to wrap\n   * @param wwwAuthenticate - WWW-Authenticate header parameters\n   * @returns A LexServerAuthError instance\n   *\n   * @example\n   * ```typescript\n   * const lexError = new LexError('AuthenticationRequired', 'Token expired')\n   * const authError = LexServerAuthError.from(lexError, {\n   *   Bearer: { error: 'ExpiredToken' }\n   * })\n   * ```\n   */\n  static from(\n    cause: LexError,\n    wwwAuthenticate?: WWWAuthenticate,\n  ): LexServerAuthError {\n    if (cause instanceof LexServerAuthError) return cause\n    return new LexServerAuthError(cause.error, cause.message, wwwAuthenticate, {\n      cause,\n    })\n  }\n}\n"]}