@atproto/lex-client 0.1.5 → 0.2.1

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { LexMap, LexValue, TypedLexMap } from '@atproto/lex-data'\nimport {\n  AtIdentifierString,\n  AtUriString,\n  CidString,\n  DidString,\n  Infer,\n  InferMethodInputBody,\n  InferMethodOutputBody,\n  InferRecordKey,\n  LexiconRecordKey,\n  Main,\n  NsidString,\n  Params,\n  Procedure,\n  Query,\n  RecordSchema,\n  Restricted,\n  getMain,\n} from '@atproto/lex-schema'\nimport { Agent, AgentOptions, buildAgent } from './agent.js'\nimport { XrpcFailure } from './errors.js'\n// @NOTE We could use import { com } from \"./lexicons/index.js\" here, but some\n// consumers might not know how to properly tree-shake that, so we import only\n// the needed lexicon schemas directly.\nimport applyWrites from './lexicons/com/atproto/repo/applyWrites.js'\nimport createRecord from './lexicons/com/atproto/repo/createRecord.js'\nimport deleteRecord from './lexicons/com/atproto/repo/deleteRecord.js'\nimport getRecord from './lexicons/com/atproto/repo/getRecord.js'\nimport listRecords from './lexicons/com/atproto/repo/listRecords.js'\nimport putRecord from './lexicons/com/atproto/repo/putRecord.js'\nimport uploadBlob from './lexicons/com/atproto/repo/uploadBlob.js'\nimport getBlob from './lexicons/com/atproto/sync/getBlob.js'\nimport {\n  XrpcResponse,\n  XrpcResponseBody,\n  XrpcResponseOptions,\n} from './response.js'\nimport { BinaryBodyInit, Service } from './types.js'\nimport {\n  RecordKeyOptions,\n  XrpcRequestHeadersOptions,\n  applyDefaults,\n  buildXrpcRequestHeaders,\n  getDefaultRecordKey,\n  getLiteralRecordKey,\n} from './util.js'\nimport {\n  WriteOperation,\n  WriteOperationCreateOptions,\n  WriteOperationDeleteOptions,\n  WriteOperationHelper,\n  WriteOperationUpdateOptions,\n  WriteOperationsFactory,\n} from './write-operation-builder.js'\nimport {\n  XrpcOptions,\n  XrpcRequestParams,\n  XrpcRequestProcessingOptions,\n  xrpc,\n  xrpcSafe,\n} from './xrpc.js'\n\nexport {\n  type AtIdentifierString,\n  type CidString,\n  type DidString,\n  type Infer,\n  type InferMethodInputBody,\n  type InferMethodOutputBody,\n  type InferRecordKey,\n  type LexMap,\n  type LexValue,\n  type LexiconRecordKey,\n  type Main,\n  type NsidString,\n  type Params,\n  Procedure,\n  Query,\n  RecordSchema,\n  type Restricted,\n  type TypedLexMap,\n  type WriteOperation,\n  type WriteOperationCreateOptions,\n  type WriteOperationDeleteOptions,\n  WriteOperationHelper,\n  type WriteOperationUpdateOptions,\n  type WriteOperationsFactory,\n}\n\n/**\n * Configuration options for creating a {@link Client}.\n *\n * @property {@link ClientOptions.labelers} - An iterable of labeler DIDs to include in requests. These will be combined with any global app labelers configured via {@link Client.configure}.\n * @property {@link ClientOptions.service} - An optional service identifier (DID or URL) for routing requests with service proxying.\n * @property {@link ClientOptions.headers} - Custom headers to include in all requests made by this client instance.\n * @property {@link ClientOptions.validateRequest} - If true, validates request bodies against their lexicon schemas before sending. Defaults to false for performance.\n * @property {@link ClientOptions.validateResponse} - If false, skips validation of response bodies against their lexicon schemas. Defaults to true to catch errors, but can be disabled for performance if you trust the server responses. Note that defaults will not be applied if validation is disabled, which can cause typing inconsistencies, so use with caution.\n * @property {@link ClientOptions.strictResponseProcessing} - If false, relaxes certain validation rules during response processing (e.g., allowing floats, deeper nesting, etc.). Defaults to true for strict compliance with {@link https://atproto.com/specs/data-model lexicon data model}, but can be disabled to handle non-compliant responses.\n *\n * @see {@link XrpcRequestHeadersOptions}\n * @see {@link XrpcRequestProcessingOptions}\n * @see {@link XrpcResponseOptions}\n *\n * @example\n * ```typescript\n * const options: ClientOptions = {\n *   labelers: ['did:plc:labeler1'],\n *   service: 'did:web:api.bsky.app#bsky_appview',\n *   headers: { 'X-Custom-Header': 'value' },\n *   validateRequest: false,\n *   validateResponse: true,\n *   strictResponseProcessing: false,\n * }\n * ```\n */\nexport type ClientOptions = XrpcRequestHeadersOptions &\n  Pick<XrpcRequestProcessingOptions, 'validateRequest'> &\n  XrpcResponseOptions\n\nexport type ActionOptions = {\n  /** AbortSignal to cancel the request. */\n  signal?: AbortSignal\n}\n\n/**\n * A composable action that can be invoked via {@link Client.call}.\n *\n * Actions provide a way to define custom operations that integrate with the\n * Client's call interface, enabling type-safe, reusable business logic.\n *\n * @typeParam I - The input type for the action\n * @typeParam O - The output type for the action\n *\n * @example\n * ```typescript\n * const myAction: Action<{ userId: string }, { profile: Profile }> = async (client, input, options) => {\n *   const response = await client.xrpc(someMethod, { params: { actor: input.userId }, ...options })\n *   return { profile: response.body }\n * }\n * ```\n */\nexport type Action<I = any, O = any> = (\n  client: Client,\n  input: I,\n  options: ActionOptions,\n) => O | Promise<O>\n\n/**\n * Extracts the input type from an {@link Action}.\n * @typeParam A - The Action type to extract from\n */\nexport type InferActionInput<A extends Action> =\n  A extends Action<infer I, any> ? I : never\n\n/**\n * Extracts the output type from an {@link Action}.\n * @typeParam A - The Action type to extract from\n */\nexport type InferActionOutput<A extends Action> =\n  A extends Action<any, infer O> ? O : never\n\n/**\n * Options for creating a record in an AT Protocol repository.\n *\n * @see {@link Client.createRecord}\n */\nexport type CreateRecordOptions = Omit<\n  XrpcOptions<typeof createRecord>,\n  'body'\n> & {\n  /** Repository identifier (DID or handle). Defaults to authenticated user's DID. */\n  repo?: AtIdentifierString\n  /** Compare-and-swap on the repo commit. If specified, must match current commit. */\n  swapCommit?: string\n  /**\n   * Whether the PDS should validate the record against its lexicon schema.\n   * When `true`, the PDS is asked to explicitly validate the record. When\n   * `false`, the PDS is asked to explicitly skip validation. When `undefined`\n   * (default), the PDS decides -- typically validating only collections whose\n   * schemas it knows. This is server-side validation; for client-side\n   * validation before sending, use {@link XrpcRequestProcessingOptions.validateRequest}.\n   */\n  validate?: boolean\n}\n\n/**\n * Options for deleting a record from an AT Protocol repository.\n *\n * @see {@link Client.deleteRecord}\n */\nexport type DeleteRecordOptions = Omit<\n  XrpcOptions<typeof deleteRecord>,\n  'body'\n> & {\n  /** Repository identifier (DID or handle). Defaults to authenticated user's DID. */\n  repo?: AtIdentifierString\n  /** Compare-and-swap on the repo commit. If specified, must match current commit. */\n  swapCommit?: string\n  /** Compare-and-swap on the record CID. If specified, must match current record. */\n  swapRecord?: string\n}\n\n/**\n * Options for retrieving a record from an AT Protocol repository.\n *\n * @see {@link Client.getRecord}\n */\nexport type GetRecordOptions = Omit<XrpcOptions<typeof getRecord>, 'params'> & {\n  /** Repository identifier (DID or handle). Defaults to authenticated user's DID. */\n  repo?: AtIdentifierString\n}\n\n/**\n * Options for creating or updating a record in an AT Protocol repository.\n *\n * @see {@link Client.putRecord}\n */\nexport type PutRecordOptions = Omit<XrpcOptions<typeof putRecord>, 'body'> & {\n  /** Repository identifier (DID or handle). Defaults to authenticated user's DID. */\n  repo?: AtIdentifierString\n  /** Compare-and-swap on the repo commit. If specified, must match current commit. */\n  swapCommit?: string\n  /** Compare-and-swap on the record CID. If specified, must match current record. */\n  swapRecord?: string\n  /**\n   * Whether the PDS should validate the record against its lexicon schema.\n   * When `true`, the PDS is asked to explicitly validate the record. When\n   * `false`, the PDS is asked to explicitly skip validation. When `undefined`\n   * (default), the PDS decides — typically validating only collections whose\n   * schemas it knows. This is server-side validation; for client-side\n   * validation before sending, use {@link XrpcRequestProcessingOptions.validateRequest}.\n   */\n  validate?: boolean\n}\n\n/**\n * Options for listing records in an AT Protocol repository collection.\n *\n * @see {@link Client.listRecords}\n */\nexport type ListRecordsOptions = Omit<\n  XrpcOptions<typeof listRecords>,\n  'params'\n> & {\n  /** Repository identifier (DID or handle). Defaults to authenticated user's DID. */\n  repo?: AtIdentifierString\n  /** Maximum number of records to return. */\n  limit?: number\n  /** Pagination cursor from a previous response. */\n  cursor?: string\n  /** If true, returns records in reverse chronological order. */\n  reverse?: boolean\n}\n\n/**\n * Options for applying a batch of writes (create/update/delete) to an AT Protocol repository.\n *\n * @see {@link Client.applyWrites}\n */\nexport type ApplyWritesOptions = Omit<\n  XrpcOptions<typeof applyWrites>,\n  'body'\n> & {\n  /** Repository identifier (DID or handle). Defaults to authenticated user's DID. */\n  repo?: AtIdentifierString\n  /**\n   * Whether the PDS should validate the records against their lexicon schemas.\n   * When `true`, the PDS is asked to explicitly validate every record. When\n   * `false`, the PDS is asked to explicitly skip validation. When `undefined`\n   * (default), the PDS decides — typically validating only collections whose\n   * schemas it knows.\n   */\n  validate?: boolean\n  /** Compare-and-swap on the repo commit. If specified, must match current commit. */\n  swapCommit?: CidString\n}\n\nexport type UploadBlobOptions = Omit<XrpcOptions<typeof uploadBlob>, 'body'>\n\nexport type GetBlobOptions = Omit<XrpcOptions<typeof getBlob>, 'params'>\n\n/**\n * Type-safe options for {@link Client.create}, combining record options with key requirements.\n * @typeParam T - The record schema type\n * @see {@link CreateRecordOptions}\n */\nexport type CreateOptions<T extends RecordSchema> = CreateRecordOptions &\n  RecordKeyOptions<T, 'tid' | 'any'>\n\n/**\n * Output type for record creation operations.\n * Contains the URI and CID of the newly created record.\n */\nexport type CreateOutput = InferMethodOutputBody<\n  typeof createRecord,\n  Uint8Array\n>\n\n/**\n * Type-safe options for {@link Client.delete}, combining delete options with key requirements.\n * @typeParam T - The record schema type\n */\nexport type DeleteOptions<T extends RecordSchema> = DeleteRecordOptions &\n  RecordKeyOptions<T>\n\n/**\n * Output type for record deletion operations.\n */\nexport type DeleteOutput = InferMethodOutputBody<\n  typeof deleteRecord,\n  Uint8Array\n>\n\n/**\n * Type-safe options for {@link Client.get}, combining get options with key requirements.\n * @typeParam T - The record schema type\n */\nexport type GetOptions<T extends RecordSchema> = GetRecordOptions &\n  RecordKeyOptions<T>\n\n/**\n * Output type for record retrieval operations.\n * Contains the record value validated against the schema type.\n * @typeParam T - The record schema type\n */\nexport type GetOutput<T extends RecordSchema> = Omit<\n  InferMethodOutputBody<typeof getRecord, Uint8Array>,\n  'value'\n> & { value: Infer<T> }\n\n/**\n * Type-safe options for {@link Client.put}, combining put options with key requirements.\n * @typeParam T - The record schema type\n */\nexport type PutOptions<T extends RecordSchema> = PutRecordOptions &\n  RecordKeyOptions<T>\n\n/**\n * Output type for record put (create/update) operations.\n * Contains the URI and CID of the record.\n */\nexport type PutOutput = InferMethodOutputBody<typeof putRecord, Uint8Array>\n\n/**\n * Options for {@link Client.list} operations.\n */\nexport type ListOptions = ListRecordsOptions\n\n/**\n * Output type for record listing operations.\n * Contains validated records and any invalid records that failed schema validation.\n * @typeParam T - The record schema type\n */\nexport type ListOutput<T extends RecordSchema> = InferMethodOutputBody<\n  typeof listRecords,\n  Uint8Array\n> & {\n  /** Records that successfully validated against the schema. */\n  records: ListRecord<Infer<T>>[]\n  // @NOTE Because the schema uses \"type\": \"unknown\" instead of an open union,\n  // we have to use LexMap instead of Unknown$TypedObject here, which is\n  // unfortunate.\n  /** Records that failed schema validation. */\n  invalid: LexMap[]\n}\n\n/**\n * A record from a list operation with its value typed to the schema.\n * @typeParam Value - The validated record value type\n */\nexport type ListRecord<Value extends LexMap> = {\n  uri: AtUriString\n  cid: CidString\n  value: Value\n}\n\n/**\n * The Client class is the primary interface for interacting with AT Protocol\n * services. It provides type-safe methods for XRPC calls, record operations,\n * and blob handling.\n *\n * @example\n * ```typescript\n * import { Client } from '@atproto/lex'\n * import { app } from '#/lexicons\n *\n * const client = new Client(oauthSession)\n *\n * const response = await client.xrpc(app.bsky.feed.getTimeline.main, {\n *   params: { limit: 50 }\n * })\n * ```\n */\nexport class Client implements Agent {\n  static appLabelers: readonly DidString[] = []\n\n  /**\n   * Configures the Client (or its sub classes) globally.\n   */\n  static configure(opts: { appLabelers?: Iterable<DidString> }) {\n    if (opts.appLabelers) this.appLabelers = [...opts.appLabelers]\n  }\n\n  /** The underlying agent used for making requests. */\n  public readonly agent: Agent\n\n  /** Custom headers included in all requests. */\n  public readonly headers: Headers\n\n  /** Optional service identifier for routing requests. */\n  public readonly service?: Service\n\n  /** Set of labeler DIDs specific to this client instance. */\n  public readonly labelers: Set<DidString>\n\n  public readonly xrpcDefaults: {\n    readonly validateRequest: boolean\n    readonly validateResponse: boolean\n    readonly strictResponseProcessing: boolean\n  }\n\n  constructor(agent: Agent | AgentOptions, options: ClientOptions = {}) {\n    this.agent = buildAgent(agent)\n    this.service = options.service\n    this.labelers = new Set(options.labelers)\n    this.headers = new Headers(options.headers)\n    this.xrpcDefaults = Object.freeze({\n      validateRequest: options.validateRequest ?? false,\n      validateResponse: options.validateResponse ?? true,\n      strictResponseProcessing: options.strictResponseProcessing ?? true,\n    })\n  }\n\n  /**\n   * The DID of the authenticated user, or `undefined` if not authenticated.\n   */\n  get did(): DidString | undefined {\n    return this.agent.did\n  }\n\n  /**\n   * The DID of the authenticated user.\n   * @throws {Error} if not authenticated\n   */\n  get assertDid(): DidString {\n    this.assertAuthenticated()\n    return this.did\n  }\n\n  /**\n   * Asserts that the client is authenticated.\n   * Use as a type guard when you need to ensure authentication.\n   *\n   * @throws {Error} if not authenticated\n   *\n   * @example\n   * ```typescript\n   * client.assertAuthenticated()\n   * // TypeScript now knows client.did is defined\n   * console.log(client.did)\n   * ```\n   */\n  public assertAuthenticated(): asserts this is { did: DidString } {\n    if (!this.did) throw new Error('Client is not authenticated')\n  }\n\n  /**\n   * Replaces all labelers with the given set.\n   * @param labelers - Iterable of labeler DIDs\n   */\n  public setLabelers(labelers: Iterable<DidString> = []) {\n    this.clearLabelers()\n    this.addLabelers(labelers)\n  }\n\n  /**\n   * Adds labelers to the current set.\n   * @param labelers - Iterable of labeler DIDs to add\n   */\n  public addLabelers(labelers: Iterable<DidString>) {\n    for (const labeler of labelers) this.labelers.add(labeler)\n  }\n\n  /**\n   * Removes all labelers from this client instance.\n   */\n  public clearLabelers() {\n    this.labelers.clear()\n  }\n\n  /**\n   * {@link Agent}'s {@link Agent.fetchHandler} implementation, which adds\n   * labelers and service proxying headers. This method allow a {@link Client}\n   * instance to be used directly as an {@link Agent} for another\n   * {@link Client}, enabling composition of headers (labelers, proxying, etc.).\n   *\n   * @param path - The request path\n   * @param init - Request initialization options\n   */\n  public fetchHandler(\n    path: `/${string}`,\n    init: RequestInit,\n  ): Promise<Response> {\n    const headers = buildXrpcRequestHeaders({\n      headers: init.headers,\n      service: this.service,\n      labelers: [\n        ...(this.constructor as typeof Client).appLabelers.map(\n          (l) => `${l};redact` as const,\n        ),\n        ...this.labelers,\n      ],\n    })\n\n    // Incoming headers take precedence\n    for (const [key, value] of this.headers) {\n      if (!headers.has(key)) headers.set(key, value)\n    }\n\n    // @NOTE The agent here could be another Client instance.\n    return this.agent.fetchHandler(path, { ...init, headers })\n  }\n\n  /**\n   * Makes an XRPC request. Throws on failure.\n   *\n   * @param ns - The lexicon method definition (e.g., `app.bsky.feed.getTimeline`)\n   * @param options - Request options including params and body\n   * @returns The successful XRPC response\n   * @throws {XrpcFailure} when the request fails or returns an error\n   *\n   * @example Query with parameters\n   * ```typescript\n   * const response = await client.xrpc(app.bsky.feed.getTimeline, {\n   *   params: { limit: 50, cursor: 'abc123' }\n   * })\n   * console.log(response.body.feed)\n   * ```\n   *\n   * @example Procedure with body\n   * ```typescript\n   * const response = await client.xrpc(com.atproto.repo.createRecord, {\n   *   body: {\n   *     repo: client.assertDid,\n   *     collection: 'app.bsky.feed.post',\n   *     record: { text: 'Hello!', createdAt: new Date().toISOString() }\n   *   }\n   * })\n   * ```\n   *\n   * @see {@link xrpcSafe} for a non-throwing variant\n   */\n  async xrpc<const M extends Query | Procedure>(\n    ns: NonNullable<unknown> extends XrpcOptions<M>\n      ? Main<M>\n      : Restricted<'This XRPC method requires an \"options\" argument'>,\n  ): Promise<XrpcResponse<M>>\n  async xrpc<const M extends Query | Procedure>(\n    ns: Main<M>,\n    options: XrpcOptions<M>,\n  ): Promise<XrpcResponse<M>>\n  async xrpc<const M extends Query | Procedure>(\n    ns: Main<M>,\n    options: XrpcOptions<M> = {} as XrpcOptions<M>,\n  ): Promise<XrpcResponse<M>> {\n    return xrpc(this, ns, applyDefaults(options, this.xrpcDefaults))\n  }\n\n  /**\n   * Makes an XRPC request without throwing on failure.\n   * Returns either a successful response or a failure object.\n   *\n   * @param ns - The lexicon method definition\n   * @param options - Request options\n   * @returns Either an XrpcResponse on success or XrpcFailure on failure\n   *\n   * @example\n   * ```typescript\n   * const result = await client.xrpcSafe(app.bsky.actor.getProfile.main, {\n   *   params: { actor: 'alice.bsky.social' }\n   * })\n   *\n   * if (result.success) {\n   *   console.log(result.body.displayName)\n   * } else {\n   *   console.error('Failed:', result.error)\n   * }\n   * ```\n   *\n   * @see {@link xrpc} for a throwing variant\n   */\n  async xrpcSafe<const M extends Query | Procedure>(\n    ns: NonNullable<unknown> extends XrpcOptions<M>\n      ? Main<M>\n      : Restricted<'This XRPC method requires an \"options\" argument'>,\n  ): Promise<XrpcResponse<M> | XrpcFailure<M>>\n  async xrpcSafe<const M extends Query | Procedure>(\n    ns: Main<M>,\n    options: XrpcOptions<M>,\n  ): Promise<XrpcResponse<M> | XrpcFailure<M>>\n  async xrpcSafe<const M extends Query | Procedure>(\n    ns: Main<M>,\n    options: XrpcOptions<M> = {} as XrpcOptions<M>,\n  ): Promise<XrpcResponse<M> | XrpcFailure<M>> {\n    return xrpcSafe(this, ns, applyDefaults(options, this.xrpcDefaults))\n  }\n\n  /**\n   * Creates a new record in an AT Protocol repository.\n   *\n   * @param record - The record to create, must include an {@link NsidString} `$type`\n   * @param rkey - Optional record key; if omitted, server generates a TID\n   * @param options - Create options including repo, swapCommit, validate\n   * @returns The XRPC response containing the created record's URI and CID\n   *\n   * @example\n   * ```typescript\n   * const response = await client.createRecord(\n   *   { $type: 'app.bsky.feed.post', text: 'Hello!', createdAt: new Date().toISOString() },\n   *   undefined, // Let server generate rkey\n   *   { validate: true }\n   * )\n   * console.log(response.body.uri)\n   * ```\n   *\n   * @see {@link create} for a higher-level typed alternative\n   */\n  public async createRecord(\n    record: TypedLexMap<NsidString>,\n    rkey?: string,\n    options?: CreateRecordOptions,\n  ) {\n    return this.xrpc(createRecord, {\n      ...options,\n      body: {\n        repo: options?.repo ?? this.assertDid,\n        collection: record.$type,\n        record,\n        rkey,\n        validate: options?.validate,\n        swapCommit: options?.swapCommit,\n      },\n    })\n  }\n\n  /**\n   * Deletes a record from an AT Protocol repository.\n   *\n   * @param collection - The collection NSID\n   * @param rkey - The record key\n   * @param options - Delete options including repo, swapCommit, swapRecord\n   *\n   * @see {@link delete} for a higher-level typed alternative\n   */\n  async deleteRecord(\n    collection: NsidString,\n    rkey: string,\n    options?: DeleteRecordOptions,\n  ) {\n    return this.xrpc(deleteRecord, {\n      ...options,\n      body: {\n        repo: options?.repo ?? this.assertDid,\n        collection,\n        rkey,\n        swapCommit: options?.swapCommit,\n        swapRecord: options?.swapRecord,\n      },\n    })\n  }\n\n  /**\n   * Retrieves a record from an AT Protocol repository.\n   *\n   * @param collection - The collection NSID\n   * @param rkey - The record key\n   * @param options - Get options including repo\n   *\n   * @see {@link get} for a higher-level typed alternative\n   */\n  public async getRecord(\n    collection: NsidString,\n    rkey: string,\n    options?: GetRecordOptions,\n  ) {\n    return this.xrpc(getRecord, {\n      ...options,\n      params: {\n        repo: options?.repo ?? this.assertDid,\n        collection,\n        rkey,\n      },\n    })\n  }\n\n  /**\n   * Creates or updates a record in a repository.\n   *\n   * @param record - The record to put, must include an {@link NsidString} `$type`\n   * @param rkey - The record key\n   * @param options - Put options including repo, swapCommit, swapRecord, validate\n   *\n   * @see {@link put} for a higher-level typed alternative\n   */\n  async putRecord(\n    record: TypedLexMap<NsidString>,\n    rkey: string,\n    options?: PutRecordOptions,\n  ) {\n    return this.xrpc(putRecord, {\n      ...options,\n      body: {\n        repo: options?.repo ?? this.assertDid,\n        collection: record.$type,\n        rkey,\n        record,\n        validate: options?.validate,\n        swapCommit: options?.swapCommit,\n        swapRecord: options?.swapRecord,\n      },\n    })\n  }\n\n  /**\n   * Lists records in a collection.\n   *\n   * @param nsid - The collection NSID\n   * @param options - List options including repo, limit, cursor, reverse\n   *\n   * @see {@link list} for a higher-level typed alternative\n   */\n  async listRecords(nsid: NsidString, options?: ListRecordsOptions) {\n    return this.xrpc(listRecords, {\n      ...options,\n      params: {\n        repo: options?.repo ?? this.assertDid,\n        collection: nsid,\n        cursor: options?.cursor,\n        limit: options?.limit,\n        reverse: options?.reverse,\n      },\n    })\n  }\n\n  /**\n   * Performs an atomic batch of create, update, and delete operations on records in a repository.\n   *\n   * @param builder - A function that receives an {@link ApplyWritesOperations} instance to build the operations\n   * @param options - ApplyWrites options including repo, validate, swapCommit\n   * @returns The XRPC response from the applyWrites call\n   *\n   * @example\n   * ```typescript\n   * const response = await client.applyWrites((op) => [\n   *   op.create(app.bsky.feed.post, { text: 'Hello!' }),\n   *   op.update(app.bsky.feed.post, { text: 'Updated text' }, { rkey: 'post123' }),\n   *   op.delete(app.bsky.feed.post, 'post456'),\n   *   op.update(app.bsky.actor.profile, { displayName: 'Alice' }),\n   * ], {\n   *   validate: true,\n   * })\n   *\n   * for (const result of response.body.results) {\n   *   console.log(result.uri)\n   * }\n   * ```\n   */\n  async applyWrites(\n    factory: WriteOperationsFactory,\n    options?: ApplyWritesOptions,\n  ) {\n    return this.xrpc(applyWrites, {\n      ...options,\n      body: {\n        repo: options?.repo ?? this.assertDid,\n        writes: WriteOperationHelper.build(factory),\n        validate: options?.validate,\n        swapCommit: options?.swapCommit,\n      },\n    })\n  }\n\n  /**\n   * Uploads a blob to an AT Protocol repository.\n   *\n   * @param body - The blob data (Uint8Array, ReadableStream, Blob, etc.)\n   * @param options - Upload options including encoding hint\n   * @returns Response containing the blob reference\n   *\n   * @example\n   * ```typescript\n   * const imageData = await fetch('image.png').then(r => r.arrayBuffer())\n   * const response = await client.uploadBlob(new Uint8Array(imageData), {\n   *   encoding: 'image/png'\n   * })\n   * console.log(response.body.blob) // Use this ref in records\n   * ```\n   */\n  async uploadBlob(body: BinaryBodyInit, options?: UploadBlobOptions) {\n    return this.xrpc(uploadBlob, { ...options, body })\n  }\n\n  /**\n   * Retrieves a blob by DID and CID.\n   *\n   * @param did - The DID of the repository containing the blob\n   * @param cid - The CID of the blob\n   * @param options - Call options\n   */\n  async getBlob(did: DidString, cid: CidString, options?: GetBlobOptions) {\n    return this.xrpc(getBlob, {\n      ...options,\n      params: { did, cid },\n    })\n  }\n\n  /**\n   * Universal call method for queries, procedures, and custom actions.\n   * Automatically determines the call type based on the lexicon definition.\n   *\n   * @param ns - The lexicon method or action definition\n   * @param arg - The input argument (params for queries, body for procedures, input for actions)\n   * @param options - Call options\n   * @returns The method response body or action output\n   * @see {@link xrpc} if you need access to the full response object\n   *\n   * @example Query\n   * ```typescript\n   * const profile = await client.call(app.bsky.actor.getProfile.main, {\n   *   actor: 'alice.bsky.social'\n   * })\n   * ```\n   *\n   * @example Procedure\n   * ```typescript\n   * const result = await client.call(com.atproto.repo.createRecord.main, {\n   *   repo: did,\n   *   collection: 'app.bsky.feed.post',\n   *   record: { text: 'Hello!' }\n   * })\n   * ```\n   */\n  public async call<const T extends Query>(\n    ns: NonNullable<unknown> extends XrpcRequestParams<T>\n      ? Main<T>\n      : Restricted<'This query type requires a \"params\" argument'>,\n  ): Promise<XrpcResponseBody<T>>\n  public async call<const T extends Procedure>(\n    ns: undefined extends InferMethodInputBody<T, Uint8Array>\n      ? Main<T>\n      : Restricted<'This procedure type requires an \"input\" argument'>,\n  ): Promise<XrpcResponseBody<T>>\n  public async call<const T extends Action>(\n    ns: void extends InferActionInput<T>\n      ? Main<T>\n      : Restricted<'This action type requires an \"input\" argument'>,\n  ): Promise<InferActionOutput<T>>\n  public async call<const T extends Action | Procedure | Query>(\n    ns: Main<T>,\n    arg: T extends Action\n      ? InferActionInput<T>\n      : T extends Procedure\n        ? InferMethodInputBody<T, Uint8Array>\n        : T extends Query\n          ? XrpcRequestParams<T>\n          : never,\n    options?: T extends Action\n      ? ActionOptions\n      : T extends Procedure\n        ? Omit<XrpcOptions<T>, 'body'>\n        : T extends Query\n          ? Omit<XrpcOptions<T>, 'params'>\n          : never,\n  ): Promise<\n    T extends Action\n      ? InferActionOutput<T>\n      : T extends Procedure\n        ? XrpcResponseBody<T>\n        : T extends Query\n          ? XrpcResponseBody<T>\n          : never\n  >\n  public async call(\n    ns: Main<Action> | Main<Procedure> | Main<Query>,\n    arg?: LexValue | Params,\n    options: ActionOptions = {},\n  ): Promise<unknown> {\n    const method = getMain(ns)\n\n    if (typeof method === 'function') {\n      return method(this, arg, options)\n    }\n\n    if (method instanceof Procedure) {\n      const result = await this.xrpc(method, { ...options, body: arg as any })\n      return result.body\n    } else if (method instanceof Query) {\n      const result = await this.xrpc(method, { ...options, params: arg as any })\n      return result.body\n    } else {\n      throw new TypeError('Invalid lexicon')\n    }\n  }\n\n  /**\n   * Creates a new record with full type safety based on the schema.\n   *\n   * @param ns - The record schema definition\n   * @param input - The record data (without `$type`, which is added automatically)\n   * @param options - Create options including rkey (required for some record types)\n   * @returns The create output including URI and CID\n   *\n   * @example Creating a post\n   * ```typescript\n   * const result = await client.create(app.bsky.feed.post.main, {\n   *   text: 'Hello, world!',\n   *   createdAt: new Date().toISOString()\n   * })\n   * console.log(result.uri)\n   * ```\n   *\n   * @example Creating a record with explicit rkey\n   * ```typescript\n   * const result = await client.create(app.bsky.actor.profile.main, {\n   *   displayName: 'Alice'\n   * }, { rkey: 'self' })\n   * ```\n   */\n  public async create<const T extends RecordSchema>(\n    ns: NonNullable<unknown> extends CreateOptions<T>\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n    input: Omit<Infer<T>, '$type'>,\n  ): Promise<CreateOutput>\n  public async create<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<Infer<T>, '$type'>,\n    options: CreateOptions<T>,\n  ): Promise<CreateOutput>\n  public async create<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<Infer<T>, '$type'>,\n    options: CreateOptions<T> = {} as CreateOptions<T>,\n  ): Promise<CreateOutput> {\n    const schema: T = getMain(ns)\n    const record = schema.build(input) as TypedLexMap<NsidString>\n    if (options?.validateRequest) schema.validate(record)\n    const rkey = options.rkey ?? getDefaultRecordKey(schema)\n    if (rkey !== undefined) schema.keySchema.assert(rkey)\n    const response = await this.createRecord(record, rkey, options)\n    return response.body\n  }\n\n  /**\n   * Deletes a record with type-safe options.\n   *\n   * @param ns - The record schema definition\n   * @param options - Delete options (rkey required for non-literal keys)\n   * @returns The delete output\n   */\n  public async delete<const T extends RecordSchema>(\n    ns: NonNullable<unknown> extends DeleteOptions<T>\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n  ): Promise<DeleteOutput>\n  public async delete<const T extends RecordSchema>(\n    ns: Main<T>,\n    options?: DeleteOptions<T>,\n  ): Promise<DeleteOutput>\n  public async delete<const T extends RecordSchema>(\n    ns: Main<T>,\n    options: DeleteOptions<T> = {} as DeleteOptions<T>,\n  ): Promise<DeleteOutput> {\n    const schema = getMain(ns)\n    const rkey = schema.keySchema.parse(\n      options.rkey ?? getLiteralRecordKey(schema),\n    )\n    const response = await this.deleteRecord(schema.$type, rkey, options)\n    return response.body\n  }\n\n  /**\n   * Retrieves a record with type-safe validation.\n   *\n   * @param ns - The record schema definition\n   * @param options - Get options (rkey required for non-literal keys)\n   * @returns The record data validated against the schema\n   *\n   * @example\n   * ```typescript\n   * const profile = await client.get(app.bsky.actor.profile.main)\n   * // profile.value is typed as app.bsky.actor.profile.Record\n   * console.log(profile.value.displayName)\n   * ```\n   */\n  public async get<const T extends RecordSchema>(\n    ns: T['key'] extends `literal:${string}`\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n  ): Promise<GetOutput<T>>\n  public async get<const T extends RecordSchema>(\n    ns: Main<T>,\n    options: GetOptions<T>,\n  ): Promise<GetOutput<T>>\n  public async get<const T extends RecordSchema>(\n    ns: Main<T>,\n    options: GetOptions<T> = {} as GetOptions<T>,\n  ): Promise<GetOutput<T>> {\n    const schema = getMain(ns)\n    const rkey = schema.keySchema.parse(\n      options.rkey ?? getLiteralRecordKey(schema),\n    )\n    const response = await this.getRecord(schema.$type, rkey, options)\n    const value = schema.validate(response.body.value)\n    return { ...response.body, value }\n  }\n\n  /**\n   * Creates or updates a record with full type safety.\n   *\n   * @param ns - The record schema definition\n   * @param input - The record data\n   * @param options - Put options (rkey required for non-literal keys)\n   * @returns The put output including URI and CID\n   */\n  public async put<const T extends RecordSchema>(\n    ns: NonNullable<unknown> extends PutOptions<T>\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n    input: Omit<Infer<T>, '$type'>,\n  ): Promise<PutOutput>\n  public async put<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<Infer<T>, '$type'>,\n    options: PutOptions<T>,\n  ): Promise<PutOutput>\n  public async put<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<Infer<T>, '$type'>,\n    options: PutOptions<T> = {} as PutOptions<T>,\n  ): Promise<PutOutput> {\n    const schema: T = getMain(ns)\n    const record = schema.build(input) as TypedLexMap<NsidString>\n    if (options?.validateRequest) schema.validate(record)\n    const rkey = options.rkey ?? getLiteralRecordKey(schema)\n    const response = await this.putRecord(record, rkey, options)\n    return response.body\n  }\n\n  /**\n   * Lists records with type-safe validation and separation of valid/invalid records.\n   *\n   * @param ns - The record schema definition\n   * @param options - List options\n   * @returns Records split into valid (matching schema) and invalid arrays\n   *\n   * @example\n   * ```typescript\n   * const result = await client.list(app.bsky.feed.post.main, { limit: 100 })\n   * console.log(`Found ${result.records.length} valid posts`)\n   * console.log(`Found ${result.invalid.length} invalid records`)\n   * ```\n   */\n  async list<const T extends RecordSchema>(\n    ns: Main<T>,\n    options?: ListOptions,\n  ): Promise<ListOutput<T>> {\n    const schema = getMain(ns)\n    const { body } = await this.listRecords(schema.$type, options)\n\n    const records: ListRecord<Infer<T>>[] = []\n    const invalid: LexMap[] = []\n\n    for (const record of body.records) {\n      const parsed = schema.safeValidate(record.value)\n      if (parsed.success) {\n        records.push({ ...record, value: parsed.value })\n      } else {\n        invalid.push(record.value)\n      }\n    }\n\n    return { ...body, records, invalid }\n  }\n}\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import type { LexMap, LexValue, TypedLexMap } from '@atproto/lex-data'\nimport type {\n  AtIdentifierString,\n  AtUriString,\n  CidString,\n  DidString,\n  Infer,\n  InferMethodInputBody,\n  InferMethodOutputBody,\n  InferRecordKey,\n  LexiconRecordKey,\n  Main,\n  NsidString,\n  Params,\n  Restricted,\n} from '@atproto/lex-schema'\nimport { Procedure, Query, RecordSchema, getMain } from '@atproto/lex-schema'\nimport type { Agent, AgentOptions } from './agent.js'\nimport { buildAgent } from './agent.js'\nimport type { XrpcFailure } from './errors.js'\nimport { XrpcError, XrpcResponseError } from './errors.js'\n// @NOTE We could use import { com } from \"./lexicons/index.js\" here, but some\n// consumers might not know how to properly tree-shake that, so we import only\n// the needed lexicon schemas directly.\nimport applyWrites from './lexicons/com/atproto/repo/applyWrites.js'\nimport createRecord from './lexicons/com/atproto/repo/createRecord.js'\nimport deleteRecord from './lexicons/com/atproto/repo/deleteRecord.js'\nimport getRecord from './lexicons/com/atproto/repo/getRecord.js'\nimport listRecords, {\n  type Record as ListRecordsRecord,\n} from './lexicons/com/atproto/repo/listRecords.js'\nimport putRecord from './lexicons/com/atproto/repo/putRecord.js'\nimport uploadBlob from './lexicons/com/atproto/repo/uploadBlob.js'\nimport getBlob from './lexicons/com/atproto/sync/getBlob.js'\nimport {\n  XrpcResponse,\n  type XrpcResponseBody,\n  type XrpcResponseOptions,\n} from './response.js'\nimport type { BinaryBodyInit, Service } from './types.js'\nimport {\n  type RecordKeyOptions,\n  type XrpcRequestHeadersOptions,\n  applyDefaults,\n  buildXrpcRequestHeaders,\n  getDefaultRecordKey,\n  getLiteralRecordKey,\n  wait,\n} from './util.js'\nimport {\n  type WriteOperation,\n  type WriteOperationCreateOptions,\n  type WriteOperationDeleteOptions,\n  WriteOperationHelper,\n  type WriteOperationUpdateOptions,\n  type WriteOperationsFactory,\n} from './write-operation-builder.js'\nimport {\n  type XrpcOptions,\n  type XrpcRequestParams,\n  type XrpcRequestProcessingOptions,\n  xrpc,\n  xrpcSafe,\n} from './xrpc.js'\n\nexport {\n  type AtIdentifierString,\n  type CidString,\n  type DidString,\n  type Infer,\n  type InferMethodInputBody,\n  type InferMethodOutputBody,\n  type InferRecordKey,\n  type LexMap,\n  type LexValue,\n  type LexiconRecordKey,\n  type Main,\n  type NsidString,\n  type Params,\n  Procedure,\n  Query,\n  RecordSchema,\n  type Restricted,\n  type TypedLexMap,\n  type WriteOperation,\n  type WriteOperationCreateOptions,\n  type WriteOperationDeleteOptions,\n  WriteOperationHelper,\n  type WriteOperationUpdateOptions,\n  type WriteOperationsFactory,\n}\n\n/**\n * Configuration options for creating a {@link Client}.\n *\n * @property {@link ClientOptions.labelers} - An iterable of labeler DIDs to include in requests. These will be combined with any global app labelers configured via {@link Client.configure}.\n * @property {@link ClientOptions.service} - An optional service identifier (DID or URL) for routing requests with service proxying.\n * @property {@link ClientOptions.headers} - Custom headers to include in all requests made by this client instance.\n * @property {@link ClientOptions.validateRequest} - If true, validates request bodies against their lexicon schemas before sending. Defaults to false for performance.\n * @property {@link ClientOptions.validateResponse} - If false, skips validation of response bodies against their lexicon schemas. Defaults to true to catch errors, but can be disabled for performance if you trust the server responses. Note that defaults will not be applied if validation is disabled, which can cause typing inconsistencies, so use with caution.\n * @property {@link ClientOptions.strictResponseProcessing} - If false, relaxes certain validation rules during response processing (e.g., allowing floats, deeper nesting, etc.). Defaults to true for strict compliance with {@link https://atproto.com/specs/data-model lexicon data model}, but can be disabled to handle non-compliant responses.\n *\n * @see {@link XrpcRequestHeadersOptions}\n * @see {@link XrpcRequestProcessingOptions}\n * @see {@link XrpcResponseOptions}\n *\n * @example\n * ```typescript\n * const options: ClientOptions = {\n *   labelers: ['did:plc:labeler1'],\n *   service: 'did:web:api.bsky.app#bsky_appview',\n *   headers: { 'X-Custom-Header': 'value' },\n *   validateRequest: false,\n *   validateResponse: true,\n *   strictResponseProcessing: false,\n * }\n * ```\n */\nexport type ClientOptions = XrpcRequestHeadersOptions &\n  Pick<XrpcRequestProcessingOptions, 'validateRequest'> &\n  XrpcResponseOptions\n\nexport type ActionOptions = {\n  /** AbortSignal to cancel the request. */\n  signal?: AbortSignal\n}\n\n/**\n * A composable action that can be invoked via {@link Client.call}.\n *\n * Actions provide a way to define custom operations that integrate with the\n * Client's call interface, enabling type-safe, reusable business logic.\n *\n * @typeParam I - The input type for the action\n * @typeParam O - The output type for the action\n *\n * @example\n * ```typescript\n * const myAction: Action<{ userId: string }, { profile: Profile }> = async (client, input, options) => {\n *   const response = await client.xrpc(someMethod, { params: { actor: input.userId }, ...options })\n *   return { profile: response.body }\n * }\n * ```\n */\nexport type Action<I = any, O = any> = (\n  client: Client,\n  input: I,\n  options: ActionOptions,\n) => O | Promise<O>\n\n/**\n * Extracts the input type from an {@link Action}.\n * @typeParam A - The Action type to extract from\n */\nexport type InferActionInput<A extends Action> =\n  A extends Action<infer I, any> ? I : never\n\n/**\n * Extracts the output type from an {@link Action}.\n * @typeParam A - The Action type to extract from\n */\nexport type InferActionOutput<A extends Action> =\n  A extends Action<any, infer O> ? O : never\n\n/**\n * Options for creating a record in an AT Protocol repository.\n *\n * @see {@link Client.createRecord}\n */\nexport type CreateRecordOptions = Omit<\n  XrpcOptions<typeof createRecord>,\n  'body'\n> & {\n  /** Repository identifier (DID or handle). Defaults to authenticated user's DID. */\n  repo?: AtIdentifierString\n  /** Compare-and-swap on the repo commit. If specified, must match current commit. */\n  swapCommit?: string\n  /**\n   * Whether the PDS should validate the record against its lexicon schema.\n   * When `true`, the PDS is asked to explicitly validate the record. When\n   * `false`, the PDS is asked to explicitly skip validation. When `undefined`\n   * (default), the PDS decides -- typically validating only collections whose\n   * schemas it knows. This is server-side validation; for client-side\n   * validation before sending, use {@link XrpcRequestProcessingOptions.validateRequest}.\n   */\n  validate?: boolean\n}\n\n/**\n * Options for deleting a record from an AT Protocol repository.\n *\n * @see {@link Client.deleteRecord}\n */\nexport type DeleteRecordOptions = Omit<\n  XrpcOptions<typeof deleteRecord>,\n  'body'\n> & {\n  /** Repository identifier (DID or handle). Defaults to authenticated user's DID. */\n  repo?: AtIdentifierString\n  /** Compare-and-swap on the repo commit. If specified, must match current commit. */\n  swapCommit?: string\n  /** Compare-and-swap on the record CID. If specified, must match current record. */\n  swapRecord?: string\n}\n\n/**\n * Options for retrieving a record from an AT Protocol repository.\n *\n * @see {@link Client.getRecord}\n */\nexport type GetRecordOptions = Omit<XrpcOptions<typeof getRecord>, 'params'> & {\n  /** Repository identifier (DID or handle). Defaults to authenticated user's DID. */\n  repo?: AtIdentifierString\n}\n\n/**\n * Options for creating or updating a record in an AT Protocol repository.\n *\n * @see {@link Client.putRecord}\n */\nexport type PutRecordOptions = Omit<XrpcOptions<typeof putRecord>, 'body'> & {\n  /** Repository identifier (DID or handle). Defaults to authenticated user's DID. */\n  repo?: AtIdentifierString\n  /** Compare-and-swap on the repo commit. If specified, must match current commit. */\n  swapCommit?: string\n  /** Compare-and-swap on the record CID. If specified, must match current record. */\n  swapRecord?: string\n  /**\n   * Whether the PDS should validate the record against its lexicon schema.\n   * When `true`, the PDS is asked to explicitly validate the record. When\n   * `false`, the PDS is asked to explicitly skip validation. When `undefined`\n   * (default), the PDS decides — typically validating only collections whose\n   * schemas it knows. This is server-side validation; for client-side\n   * validation before sending, use {@link XrpcRequestProcessingOptions.validateRequest}.\n   */\n  validate?: boolean\n}\n\n/**\n * Options for listing records in an AT Protocol repository collection.\n *\n * @see {@link Client.listRecords}\n */\nexport type ListRecordsOptions = Omit<\n  XrpcOptions<typeof listRecords>,\n  'params'\n> & {\n  /** Repository identifier (DID or handle). Defaults to authenticated user's DID. */\n  repo?: AtIdentifierString\n  /** Maximum number of records to return. */\n  limit?: number\n  /** Pagination cursor from a previous response. */\n  cursor?: string\n  /** If true, returns records in reverse chronological order. */\n  reverse?: boolean\n}\n\n/**\n * Options for applying a batch of writes (create/update/delete) to an AT Protocol repository.\n *\n * @see {@link Client.applyWrites}\n */\nexport type ApplyWritesOptions = Omit<\n  XrpcOptions<typeof applyWrites>,\n  'body'\n> & {\n  /** Repository identifier (DID or handle). Defaults to authenticated user's DID. */\n  repo?: AtIdentifierString\n  /**\n   * Whether the PDS should validate the records against their lexicon schemas.\n   * When `true`, the PDS is asked to explicitly validate every record. When\n   * `false`, the PDS is asked to explicitly skip validation. When `undefined`\n   * (default), the PDS decides — typically validating only collections whose\n   * schemas it knows.\n   */\n  validate?: boolean\n  /** Compare-and-swap on the repo commit. If specified, must match current commit. */\n  swapCommit?: CidString\n}\n\nexport type UploadBlobOptions = Omit<XrpcOptions<typeof uploadBlob>, 'body'>\n\nexport type GetBlobOptions = Omit<XrpcOptions<typeof getBlob>, 'params'>\n\n/**\n * Type-safe options for {@link Client.create}, combining record options with key requirements.\n * @typeParam T - The record schema type\n * @see {@link CreateRecordOptions}\n */\nexport type CreateOptions<T extends RecordSchema> = CreateRecordOptions &\n  RecordKeyOptions<T, 'tid' | 'any'>\n\n/**\n * Output type for record creation operations.\n * Contains the URI and CID of the newly created record.\n */\nexport type CreateOutput = InferMethodOutputBody<\n  typeof createRecord,\n  Uint8Array\n>\n\n/**\n * Type-safe options for {@link Client.delete}, combining delete options with key requirements.\n * @typeParam T - The record schema type\n */\nexport type DeleteOptions<T extends RecordSchema> = DeleteRecordOptions &\n  RecordKeyOptions<T>\n\n/**\n * Output type for record deletion operations.\n */\nexport type DeleteOutput = InferMethodOutputBody<\n  typeof deleteRecord,\n  Uint8Array\n>\n\n/**\n * Type-safe options for {@link Client.get}, combining get options with key requirements.\n * @typeParam T - The record schema type\n */\nexport type GetOptions<T extends RecordSchema> = GetRecordOptions &\n  RecordKeyOptions<T>\n\n/**\n * Output type for record retrieval operations.\n * Contains the record value validated against the schema type.\n * @typeParam T - The record schema type\n */\nexport type GetOutput<T extends RecordSchema> = Omit<\n  InferMethodOutputBody<typeof getRecord, Uint8Array>,\n  'value'\n> & { value: Infer<T> }\n\n/**\n * Type-safe options for {@link Client.put}, combining put options with key requirements.\n * @typeParam T - The record schema type\n */\nexport type PutOptions<T extends RecordSchema> = PutRecordOptions &\n  RecordKeyOptions<T>\n\n/**\n * Output type for record put (create/update) operations.\n * Contains the URI and CID of the record.\n */\nexport type PutOutput = InferMethodOutputBody<typeof putRecord, Uint8Array>\n\n/**\n * Options for {@link Client.list} operations.\n */\nexport type ListOptions = ListRecordsOptions\n\n/**\n * Output type for record listing operations.\n * Contains validated records and any invalid records that failed schema validation.\n * @typeParam T - The record schema type\n */\nexport type ListOutput<T extends RecordSchema> = Omit<\n  InferMethodOutputBody<typeof listRecords>,\n  'records'\n> & {\n  /** Records that successfully validated against the schema. */\n  records: ListRecordItem<Infer<T>>[]\n}\n\n/**\n * A discriminated union type representing the result of a record listing\n * operation.\n */\nexport type ListRecordItem<Value extends LexMap> =\n  | { uri: AtUriString; cid: CidString; valid: true; value: Value }\n  | { uri: AtUriString; cid: CidString; valid: false; value: LexMap }\n\n/**\n * The Client class is the primary interface for interacting with AT Protocol\n * services. It provides type-safe methods for XRPC calls, record operations,\n * and blob handling.\n *\n * @example\n * ```typescript\n * import { Client } from '@atproto/lex'\n * import { app } from '#/lexicons\n *\n * const client = new Client(oauthSession)\n *\n * const response = await client.xrpc(app.bsky.feed.getTimeline.main, {\n *   params: { limit: 50 }\n * })\n * ```\n */\nexport class Client implements Agent {\n  static appLabelers: readonly DidString[] = []\n\n  /**\n   * Configures the Client (or its sub classes) globally.\n   */\n  static configure(opts: { appLabelers?: Iterable<DidString> }) {\n    if (opts.appLabelers) this.appLabelers = [...opts.appLabelers]\n  }\n\n  /** The underlying agent used for making requests. */\n  public readonly agent: Agent\n\n  /** Custom headers included in all requests. */\n  public readonly headers: Headers\n\n  /** Optional service identifier for routing requests. */\n  public readonly service?: Service\n\n  /** Set of labeler DIDs specific to this client instance. */\n  public readonly labelers: Set<DidString>\n\n  public readonly xrpcDefaults: {\n    readonly validateRequest: boolean\n    readonly validateResponse: boolean\n    readonly strictResponseProcessing: boolean\n  }\n\n  constructor(agent: Agent | AgentOptions, options: ClientOptions = {}) {\n    this.agent = buildAgent(agent)\n    this.service = options.service\n    this.labelers = new Set(options.labelers)\n    this.headers = new Headers(options.headers)\n    this.xrpcDefaults = Object.freeze({\n      validateRequest: options.validateRequest ?? false,\n      validateResponse: options.validateResponse ?? true,\n      strictResponseProcessing: options.strictResponseProcessing ?? true,\n    })\n  }\n\n  /**\n   * The DID of the authenticated user, or `undefined` if not authenticated.\n   */\n  get did(): DidString | undefined {\n    return this.agent.did\n  }\n\n  /**\n   * The DID of the authenticated user.\n   * @throws {Error} if not authenticated\n   */\n  get assertDid(): DidString {\n    this.assertAuthenticated()\n    return this.did\n  }\n\n  /**\n   * Asserts that the client is authenticated.\n   * Use as a type guard when you need to ensure authentication.\n   *\n   * @throws {Error} if not authenticated\n   *\n   * @example\n   * ```typescript\n   * client.assertAuthenticated()\n   * // TypeScript now knows client.did is defined\n   * console.log(client.did)\n   * ```\n   */\n  public assertAuthenticated(): asserts this is { did: DidString } {\n    if (!this.did) throw new Error('Client is not authenticated')\n  }\n\n  /**\n   * Replaces all labelers with the given set.\n   * @param labelers - Iterable of labeler DIDs\n   */\n  public setLabelers(labelers: Iterable<DidString> = []) {\n    this.clearLabelers()\n    this.addLabelers(labelers)\n  }\n\n  /**\n   * Adds labelers to the current set.\n   * @param labelers - Iterable of labeler DIDs to add\n   */\n  public addLabelers(labelers: Iterable<DidString>) {\n    for (const labeler of labelers) this.labelers.add(labeler)\n  }\n\n  /**\n   * Removes all labelers from this client instance.\n   */\n  public clearLabelers() {\n    this.labelers.clear()\n  }\n\n  /**\n   * {@link Agent}'s {@link Agent.fetchHandler} implementation, which adds\n   * labelers and service proxying headers. This method allow a {@link Client}\n   * instance to be used directly as an {@link Agent} for another\n   * {@link Client}, enabling composition of headers (labelers, proxying, etc.).\n   *\n   * @param path - The request path\n   * @param init - Request initialization options\n   */\n  public fetchHandler(\n    path: `/${string}`,\n    init: RequestInit,\n  ): Promise<Response> {\n    const headers = buildXrpcRequestHeaders({\n      headers: init.headers,\n      service: this.service,\n      labelers: [\n        ...(this.constructor as typeof Client).appLabelers.map(\n          (l) => `${l};redact` as const,\n        ),\n        ...this.labelers,\n      ],\n    })\n\n    // Incoming headers take precedence\n    for (const [key, value] of this.headers) {\n      if (!headers.has(key)) headers.set(key, value)\n    }\n\n    // @NOTE The agent here could be another Client instance.\n    return this.agent.fetchHandler(path, { ...init, headers })\n  }\n\n  /**\n   * Makes an XRPC request. Throws on failure.\n   *\n   * @param ns - The lexicon method definition (e.g., `app.bsky.feed.getTimeline`)\n   * @param options - Request options including params and body\n   * @returns The successful XRPC response\n   * @throws {XrpcFailure} when the request fails or returns an error\n   *\n   * @example Query with parameters\n   * ```typescript\n   * const response = await client.xrpc(app.bsky.feed.getTimeline, {\n   *   params: { limit: 50, cursor: 'abc123' }\n   * })\n   * console.log(response.body.feed)\n   * ```\n   *\n   * @example Procedure with body\n   * ```typescript\n   * const response = await client.xrpc(com.atproto.repo.createRecord, {\n   *   body: {\n   *     repo: client.assertDid,\n   *     collection: 'app.bsky.feed.post',\n   *     record: { text: 'Hello!', createdAt: new Date().toISOString() }\n   *   }\n   * })\n   * ```\n   *\n   * @see {@link xrpcSafe} for a non-throwing variant\n   */\n  async xrpc<const M extends Query | Procedure>(\n    ns: NonNullable<unknown> extends XrpcOptions<M>\n      ? Main<M>\n      : Restricted<'This XRPC method requires an \"options\" argument'>,\n  ): Promise<XrpcResponse<M>>\n  async xrpc<const M extends Query | Procedure>(\n    ns: Main<M>,\n    options: XrpcOptions<M>,\n  ): Promise<XrpcResponse<M>>\n  async xrpc<const M extends Query | Procedure>(\n    ns: Main<M>,\n    options: XrpcOptions<M> = {} as XrpcOptions<M>,\n  ): Promise<XrpcResponse<M>> {\n    return xrpc(this, ns, applyDefaults(options, this.xrpcDefaults))\n  }\n\n  /**\n   * Makes an XRPC request without throwing on failure.\n   * Returns either a successful response or a failure object.\n   *\n   * @param ns - The lexicon method definition\n   * @param options - Request options\n   * @returns Either an XrpcResponse on success or XrpcFailure on failure\n   *\n   * @example\n   * ```typescript\n   * const result = await client.xrpcSafe(app.bsky.actor.getProfile.main, {\n   *   params: { actor: 'alice.bsky.social' }\n   * })\n   *\n   * if (result.success) {\n   *   console.log(result.body.displayName)\n   * } else {\n   *   console.error('Failed:', result.error)\n   * }\n   * ```\n   *\n   * @see {@link xrpc} for a throwing variant\n   */\n  async xrpcSafe<const M extends Query | Procedure>(\n    ns: NonNullable<unknown> extends XrpcOptions<M>\n      ? Main<M>\n      : Restricted<'This XRPC method requires an \"options\" argument'>,\n  ): Promise<XrpcResponse<M> | XrpcFailure<M>>\n  async xrpcSafe<const M extends Query | Procedure>(\n    ns: Main<M>,\n    options: XrpcOptions<M>,\n  ): Promise<XrpcResponse<M> | XrpcFailure<M>>\n  async xrpcSafe<const M extends Query | Procedure>(\n    ns: Main<M>,\n    options: XrpcOptions<M> = {} as XrpcOptions<M>,\n  ): Promise<XrpcResponse<M> | XrpcFailure<M>> {\n    return xrpcSafe(this, ns, applyDefaults(options, this.xrpcDefaults))\n  }\n\n  /**\n   * Creates a new record in an AT Protocol repository.\n   *\n   * @param record - The record to create, must include an {@link NsidString} `$type`\n   * @param rkey - Optional record key; if omitted, server generates a TID\n   * @param options - Create options including repo, swapCommit, validate\n   * @returns The XRPC response containing the created record's URI and CID\n   *\n   * @example\n   * ```typescript\n   * const response = await client.createRecord(\n   *   { $type: 'app.bsky.feed.post', text: 'Hello!', createdAt: new Date().toISOString() },\n   *   undefined, // Let server generate rkey\n   *   { validate: true }\n   * )\n   * console.log(response.body.uri)\n   * ```\n   *\n   * @see {@link create} for a higher-level typed alternative\n   */\n  public async createRecord(\n    record: TypedLexMap<NsidString>,\n    rkey?: string,\n    options?: CreateRecordOptions,\n  ) {\n    return this.xrpc(createRecord, {\n      ...options,\n      body: {\n        repo: options?.repo ?? this.assertDid,\n        collection: record.$type,\n        record,\n        rkey,\n        validate: options?.validate,\n        swapCommit: options?.swapCommit,\n      },\n    })\n  }\n\n  /**\n   * Deletes a record from an AT Protocol repository.\n   *\n   * @param collection - The collection NSID\n   * @param rkey - The record key\n   * @param options - Delete options including repo, swapCommit, swapRecord\n   *\n   * @see {@link delete} for a higher-level typed alternative\n   */\n  async deleteRecord(\n    collection: NsidString,\n    rkey: string,\n    options?: DeleteRecordOptions,\n  ) {\n    return this.xrpc(deleteRecord, {\n      ...options,\n      body: {\n        repo: options?.repo ?? this.assertDid,\n        collection,\n        rkey,\n        swapCommit: options?.swapCommit,\n        swapRecord: options?.swapRecord,\n      },\n    })\n  }\n\n  /**\n   * Retrieves a record from an AT Protocol repository.\n   *\n   * @param collection - The collection NSID\n   * @param rkey - The record key\n   * @param options - Get options including repo\n   *\n   * @see {@link get} for a higher-level typed alternative\n   */\n  public async getRecord(\n    collection: NsidString,\n    rkey: string,\n    options?: GetRecordOptions,\n  ) {\n    return this.xrpc(getRecord, {\n      ...options,\n      params: {\n        repo: options?.repo ?? this.assertDid,\n        collection,\n        rkey,\n      },\n    })\n  }\n\n  /**\n   * Creates or updates a record in a repository.\n   *\n   * @param record - The record to put, must include an {@link NsidString} `$type`\n   * @param rkey - The record key\n   * @param options - Put options including repo, swapCommit, swapRecord, validate\n   *\n   * @see {@link put} for a higher-level typed alternative\n   */\n  async putRecord(\n    record: TypedLexMap<NsidString>,\n    rkey: string,\n    options?: PutRecordOptions,\n  ) {\n    return this.xrpc(putRecord, {\n      ...options,\n      body: {\n        repo: options?.repo ?? this.assertDid,\n        collection: record.$type,\n        rkey,\n        record,\n        validate: options?.validate,\n        swapCommit: options?.swapCommit,\n        swapRecord: options?.swapRecord,\n      },\n    })\n  }\n\n  /**\n   * Lists records in a collection.\n   *\n   * @param nsid - The collection NSID\n   * @param options - List options including repo, limit, cursor, reverse\n   *\n   * @see {@link list} for a higher-level typed alternative\n   */\n  async listRecords(nsid: NsidString, options?: ListRecordsOptions) {\n    return this.xrpc(listRecords, {\n      ...options,\n      params: {\n        repo: options?.repo ?? this.assertDid,\n        collection: nsid,\n        cursor: options?.cursor,\n        limit: options?.limit,\n        reverse: options?.reverse,\n      },\n    })\n  }\n\n  /**\n   * Performs an atomic batch of create, update, and delete operations on records in a repository.\n   *\n   * @param builder - A function that receives an {@link ApplyWritesOperations} instance to build the operations\n   * @param options - ApplyWrites options including repo, validate, swapCommit\n   * @returns The XRPC response from the applyWrites call\n   *\n   * @example\n   * ```typescript\n   * const response = await client.applyWrites((op) => [\n   *   op.create(app.bsky.feed.post, { text: 'Hello!' }),\n   *   op.update(app.bsky.feed.post, { text: 'Updated text' }, { rkey: 'post123' }),\n   *   op.delete(app.bsky.feed.post, 'post456'),\n   *   op.update(app.bsky.actor.profile, { displayName: 'Alice' }),\n   * ], {\n   *   validate: true,\n   * })\n   *\n   * for (const result of response.body.results) {\n   *   console.log(result.uri)\n   * }\n   * ```\n   */\n  async applyWrites(\n    factory: WriteOperationsFactory,\n    options?: ApplyWritesOptions,\n  ) {\n    return this.xrpc(applyWrites, {\n      ...options,\n      body: {\n        repo: options?.repo ?? this.assertDid,\n        writes: WriteOperationHelper.build(factory),\n        validate: options?.validate,\n        swapCommit: options?.swapCommit,\n      },\n    })\n  }\n\n  /**\n   * Uploads a blob to an AT Protocol repository.\n   *\n   * @param body - The blob data (Uint8Array, ReadableStream, Blob, etc.)\n   * @param options - Upload options including encoding hint\n   * @returns Response containing the blob reference\n   *\n   * @example\n   * ```typescript\n   * const imageData = await fetch('image.png').then(r => r.arrayBuffer())\n   * const response = await client.uploadBlob(new Uint8Array(imageData), {\n   *   encoding: 'image/png'\n   * })\n   * console.log(response.body.blob) // Use this ref in records\n   * ```\n   */\n  async uploadBlob(body: BinaryBodyInit, options?: UploadBlobOptions) {\n    return this.xrpc(uploadBlob, { ...options, body })\n  }\n\n  /**\n   * Retrieves a blob by DID and CID.\n   *\n   * @param did - The DID of the repository containing the blob\n   * @param cid - The CID of the blob\n   * @param options - Call options\n   */\n  async getBlob(did: DidString, cid: CidString, options?: GetBlobOptions) {\n    return this.xrpc(getBlob, {\n      ...options,\n      params: { did, cid },\n    })\n  }\n\n  /**\n   * Universal call method for queries, procedures, and custom actions.\n   * Automatically determines the call type based on the lexicon definition.\n   *\n   * @param ns - The lexicon method or action definition\n   * @param arg - The input argument (params for queries, body for procedures, input for actions)\n   * @param options - Call options\n   * @returns The method response body or action output\n   * @see {@link xrpc} if you need access to the full response object\n   *\n   * @example Query\n   * ```typescript\n   * const profile = await client.call(app.bsky.actor.getProfile.main, {\n   *   actor: 'alice.bsky.social'\n   * })\n   * ```\n   *\n   * @example Procedure\n   * ```typescript\n   * const result = await client.call(com.atproto.repo.createRecord.main, {\n   *   repo: did,\n   *   collection: 'app.bsky.feed.post',\n   *   record: { text: 'Hello!' }\n   * })\n   * ```\n   */\n  public async call<const T extends Query>(\n    ns: NonNullable<unknown> extends XrpcRequestParams<T>\n      ? Main<T>\n      : Restricted<'This query type requires a \"params\" argument'>,\n  ): Promise<XrpcResponseBody<T>>\n  public async call<const T extends Procedure>(\n    ns: undefined extends InferMethodInputBody<T, Uint8Array>\n      ? Main<T>\n      : Restricted<'This procedure type requires an \"input\" argument'>,\n  ): Promise<XrpcResponseBody<T>>\n  public async call<const T extends Action>(\n    ns: void extends InferActionInput<T>\n      ? Main<T>\n      : Restricted<'This action type requires an \"input\" argument'>,\n  ): Promise<InferActionOutput<T>>\n  public async call<const T extends Action | Procedure | Query>(\n    ns: Main<T>,\n    arg: T extends Action\n      ? InferActionInput<T>\n      : T extends Procedure\n        ? InferMethodInputBody<T, Uint8Array>\n        : T extends Query\n          ? XrpcRequestParams<T>\n          : never,\n    options?: T extends Action\n      ? ActionOptions\n      : T extends Procedure\n        ? Omit<XrpcOptions<T>, 'body'>\n        : T extends Query\n          ? Omit<XrpcOptions<T>, 'params'>\n          : never,\n  ): Promise<\n    T extends Action\n      ? InferActionOutput<T>\n      : T extends Procedure\n        ? XrpcResponseBody<T>\n        : T extends Query\n          ? XrpcResponseBody<T>\n          : never\n  >\n  public async call(\n    ns: Main<Action> | Main<Procedure> | Main<Query>,\n    arg?: LexValue | Params,\n    options: ActionOptions = {},\n  ): Promise<unknown> {\n    const method = getMain(ns)\n\n    if (typeof method === 'function') {\n      return method(this, arg, options)\n    }\n\n    if (method instanceof Procedure) {\n      const result = await this.xrpc(method, { ...options, body: arg as any })\n      return result.body\n    } else if (method instanceof Query) {\n      const result = await this.xrpc(method, { ...options, params: arg as any })\n      return result.body\n    } else {\n      throw new TypeError('Invalid lexicon')\n    }\n  }\n\n  /**\n   * Creates a new record with full type safety based on the schema.\n   *\n   * @param ns - The record schema definition\n   * @param input - The record data (without `$type`, which is added automatically)\n   * @param options - Create options including rkey (required for some record types)\n   * @returns The create output including URI and CID\n   *\n   * @example Creating a post\n   * ```typescript\n   * const result = await client.create(app.bsky.feed.post.main, {\n   *   text: 'Hello, world!',\n   *   createdAt: new Date().toISOString()\n   * })\n   * console.log(result.uri)\n   * ```\n   *\n   * @example Creating a record with explicit rkey\n   * ```typescript\n   * const result = await client.create(app.bsky.actor.profile.main, {\n   *   displayName: 'Alice'\n   * }, { rkey: 'self' })\n   * ```\n   */\n  public async create<const T extends RecordSchema>(\n    ns: NonNullable<unknown> extends CreateOptions<T>\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n    input: Omit<Infer<T>, '$type'>,\n  ): Promise<CreateOutput>\n  public async create<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<Infer<T>, '$type'>,\n    options: CreateOptions<T>,\n  ): Promise<CreateOutput>\n  public async create<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<Infer<T>, '$type'>,\n    options: CreateOptions<T> = {} as CreateOptions<T>,\n  ): Promise<CreateOutput> {\n    const schema: T = getMain(ns)\n    const record = schema.build(input) as TypedLexMap<NsidString>\n    if (options?.validateRequest) schema.validate(record)\n    const rkey = options.rkey ?? getDefaultRecordKey(schema)\n    if (rkey !== undefined) schema.keySchema.assert(rkey)\n    const response = await this.createRecord(record, rkey, options)\n    return response.body\n  }\n\n  /**\n   * Deletes a record with type-safe options.\n   *\n   * @param ns - The record schema definition\n   * @param options - Delete options (rkey required for non-literal keys)\n   * @returns The delete output\n   */\n  public async delete<const T extends RecordSchema>(\n    ns: NonNullable<unknown> extends DeleteOptions<T>\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n  ): Promise<DeleteOutput>\n  public async delete<const T extends RecordSchema>(\n    ns: Main<T>,\n    options?: DeleteOptions<T>,\n  ): Promise<DeleteOutput>\n  public async delete<const T extends RecordSchema>(\n    ns: Main<T>,\n    options: DeleteOptions<T> = {} as DeleteOptions<T>,\n  ): Promise<DeleteOutput> {\n    const schema = getMain(ns)\n    const rkey = schema.keySchema.parse(\n      options.rkey ?? getLiteralRecordKey(schema),\n    )\n    const response = await this.deleteRecord(schema.$type, rkey, options)\n    return response.body\n  }\n\n  /**\n   * Retrieves a record with type-safe validation.\n   *\n   * @param ns - The record schema definition\n   * @param options - Get options (rkey required for non-literal keys)\n   * @returns The record data validated against the schema\n   *\n   * @example\n   * ```typescript\n   * const profile = await client.get(app.bsky.actor.profile.main)\n   * // profile.value is typed as app.bsky.actor.profile.Record\n   * console.log(profile.value.displayName)\n   * ```\n   */\n  public async get<const T extends RecordSchema>(\n    ns: T['key'] extends `literal:${string}`\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n  ): Promise<GetOutput<T>>\n  public async get<const T extends RecordSchema>(\n    ns: Main<T>,\n    options: GetOptions<T>,\n  ): Promise<GetOutput<T>>\n  public async get<const T extends RecordSchema>(\n    ns: Main<T>,\n    options: GetOptions<T> = {} as GetOptions<T>,\n  ): Promise<GetOutput<T>> {\n    const schema = getMain(ns)\n    const rkey = schema.keySchema.parse(\n      options.rkey ?? getLiteralRecordKey(schema),\n    )\n    const response = await this.getRecord(schema.$type, rkey, options)\n    const value = schema.validate(response.body.value)\n    return { ...response.body, value }\n  }\n\n  /**\n   * Creates or updates a record with full type safety.\n   *\n   * @param ns - The record schema definition\n   * @param input - The record data\n   * @param options - Put options (rkey required for non-literal keys)\n   * @returns The put output including URI and CID\n   */\n  public async put<const T extends RecordSchema>(\n    ns: NonNullable<unknown> extends PutOptions<T>\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n    input: Omit<Infer<T>, '$type'>,\n  ): Promise<PutOutput>\n  public async put<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<Infer<T>, '$type'>,\n    options: PutOptions<T>,\n  ): Promise<PutOutput>\n  public async put<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<Infer<T>, '$type'>,\n    options: PutOptions<T> = {} as PutOptions<T>,\n  ): Promise<PutOutput> {\n    const schema: T = getMain(ns)\n    const record = schema.build(input) as TypedLexMap<NsidString>\n    if (options?.validateRequest) schema.validate(record)\n    const rkey = options.rkey ?? getLiteralRecordKey(schema)\n    const response = await this.putRecord(record, rkey, options)\n    return response.body\n  }\n\n  /**\n   * Lists records with type-safe validation and separation of valid/invalid records.\n   *\n   * @param ns - The record schema definition\n   * @param options - List options\n   * @returns Records validated against the schema, with invalid records included as LexMap\n   *\n   * @example\n   * ```typescript\n   * const result = await client.list(app.bsky.feed.post.main, { limit: 100 })\n   * for (const record of result.records) {\n   *   if (record.valid) {\n   *     record.value // Fully typed\n   *   } else {\n   *     record.value // Invalid record, typed as LexMap\n   *   }\n   * }\n   * ```\n   */\n  async list<const T extends RecordSchema>(\n    ns: Main<T>,\n    options?: ListOptions,\n  ): Promise<ListOutput<T>> {\n    const schema = getMain(ns)\n    const { body } = await this.listRecords(schema.$type, options)\n    const records = body.records.map(processListRecord, schema)\n    return { ...body, records }\n  }\n\n  /**\n   * Asynchronously iterates over all records in a collection, handling\n   * pagination automatically.\n   *\n   * @param ns - The record schema definition\n   * @param options - List options including limit and cursor\n   * @returns An async generator yielding each record validated against the schema\n   */\n  async *listAll<const T extends RecordSchema>(\n    ns: Main<T>,\n    { maxRetries = 3, ...options }: ListOptions & { maxRetries?: number } = {},\n  ): AsyncGenerator<ListRecordItem<Infer<T>>, void, unknown> {\n    const schema = getMain(ns)\n    let currentErrorCount = 0\n\n    do {\n      options.signal?.throwIfAborted()\n\n      try {\n        const { body } = await this.listRecords(schema.$type, options)\n\n        // We got a successful response, reset error count\n        currentErrorCount = 0\n\n        // We don't use this.list() here so that we can lazily process records as\n        // they come in, rather than mapping and yielding the entire page at once.\n        for (const record of body.records) {\n          yield processListRecord.call(schema, record)\n        }\n\n        // If the server returns the same cursor, we may be in a loop. Stop\n        // iteration.\n        if (body.cursor && body.cursor === options.cursor) {\n          return\n        }\n\n        options.cursor = body.cursor\n      } catch (err) {\n        currentErrorCount++\n        if (currentErrorCount > maxRetries) {\n          throw err\n        }\n\n        if (err instanceof XrpcResponseError) {\n          // Page not found, return empty iterator\n          if (err.status === 404 || err.error === 'NotFound') {\n            return\n          }\n\n          // Rate limit error\n          if (err.status === 429 || err.error === 'RateLimitExceeded') {\n            const resetsAt = err.headers.get('RateLimit-Reset') // epoch\n            if (resetsAt != null && /^\\s*\\d+\\s*$/.test(resetsAt)) {\n              const resetsIn = Number(resetsAt) * 1000 - Date.now()\n              await wait(Math.max(resetsIn, 1e3), options)\n              continue\n            }\n\n            // Unable to determine when to retry; fall through\n          }\n\n          // Server asks to retry after a certain time\n          const retryAfter = err.headers.get('Retry-After')\n          if (retryAfter != null) {\n            const waitTime = /^\\s*\\d+\\s*$/.test(retryAfter)\n              ? // Retry-After is in seconds\n                Number(retryAfter) * 1000\n              : // Retry-After is an http-date\n                new Date(retryAfter).getTime() - Date.now()\n\n            if (!Number.isNaN(waitTime)) {\n              await wait(Math.max(waitTime, 1e3), options)\n              continue\n            }\n\n            // Invalid date; fall through\n          }\n        }\n\n        // Exponential backoff for transient errors\n        if (err instanceof XrpcError && err.shouldRetry()) {\n          const waitTime = Math.min(2 ** currentErrorCount * 1000, 30_000)\n          await wait(waitTime, options)\n          continue\n        }\n\n        // Propagate unexpected and non-retryable errors\n        throw err\n      }\n    } while (options.cursor)\n  }\n}\n\nfunction processListRecord<T extends RecordSchema>(\n  this: T,\n  record: ListRecordsRecord,\n): ListRecordItem<Infer<T>> {\n  const result = this.safeValidate(record.value)\n  if (result.success) {\n    return { ...record, valid: true, value: result.value }\n  } else {\n    return { ...record, valid: false }\n  }\n}\n"]}

package/dist/errors.d.ts

@@ -1,7 +1,9 @@
-import { LexError, LexErrorCode, LexErrorData, LexValue } from '@atproto/lex-data';
-import { InferMethodError, LexValidationError, Procedure, Query, ResultFailure } from '@atproto/lex-schema';
-import { XrpcUnknownResponsePayload } from './types.js';
-import { WWWAuthenticate } from './www-authenticate.js';
+import type { LexErrorCode, LexErrorData, LexValue } from '@atproto/lex-data';
+import { LexError } from '@atproto/lex-data';
+import { LexValidationError, Procedure, Query } from '@atproto/lex-schema';
+import type { InferMethodError, ResultFailure } from '@atproto/lex-schema';
+import type { XrpcUnknownResponsePayload } from './types.js';
+import type { WWWAuthenticate } from './www-authenticate.js';
 export type { XrpcUnknownResponsePayload };
 export type DownstreamError<N extends LexErrorCode = LexErrorCode> = {
     status: number;

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,KAAK,EAEN,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAG1E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAyB5D,YAAY,EAAE,0BAA0B,EAAE,CAAA;AAE1C,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI;IACnE,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;CACtB,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAE1D,CAAA;AAEF,OAAO,EAAE,QAAQ,EAAE,CAAA;AACnB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI;IACpE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;IACrB,QAAQ,EAAE,kBAAkB,CAAA;CAC7B,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,0BAA0B,GAAG,IAAI,GAAG,SAAS,GACrD,OAAO,IAAI,gBAAgB,CAM7B;AAED;;;;;;;;;;;;;GAaG;AACH,8BAAsB,SAAS,CAC3B,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,EAC/C,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,OAAO,GAAG,OAAO,CAEnB,SAAQ,QAAQ,CAAC,CAAC,CAClB,YAAW,aAAa,CAAC,OAAO,CAAC;IAK/B,QAAQ,CAAC,MAAM,EAAE,CAAC;IAHpB,IAAI,SAAc;IAElB,YACW,MAAM,EAAE,CAAC,EAClB,KAAK,EAAE,CAAC,EACR,OAAO,GAAE,MAAqC,EAC9C,OAAO,CAAC,EAAE,YAAY,EAGvB;IAED;;OAEG;IACH,QAAQ,CAAC,OAAO,QAAiB;IAEjC;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IAEjC;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAA;IAE/B,QAAQ,CAAC,iBAAiB,IAAI,eAAe,CAAA;IAE7C,mBAAmB,IAAI,IAAI,IAAI,SAAS,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAE/D;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,iBAAiB,CAC5B,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAC/C,SAAQ,SAAS,CAAC,CAAC,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAKtD,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B;IAL/C,IAAI,SAAsB;IAE1B,YACE,MAAM,EAAE,CAAC,EACA,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,0BAA0B,YAAA,EAC7C,OAAO,CAAC,EAAE,YAAY,EAWvB;IAED,IAAa,MAAM,IAAI,IAAI,CAE1B;IAEQ,WAAW,IAAI,OAAO,CAE9B;IAEQ,MAAM,IAAI,YAAY,CAS9B;IAEQ,iBAAiB,IAAI,eAAe,CAY5C;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,IAAI,IAAI,SAAS,GAAG,UAAU,GAAG,QAAQ,CAE5C;CACF;AAED,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,uBAAuB,CAClC,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAC/C,SAAQ,iBAAiB,CAAC,CAAC,CAAC;;IAC5B,IAAI,SAA4B;IAEvB,WAAW,IAAI,OAAO,CAE9B;IAGD;;;OAGG;IACH,IAAI,eAAe,IAAI,eAAe,CAKrC;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,wBAAwB,CACnC,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAC/C,SAAQ,SAAS,CAAC,CAAC,EAAE,iBAAiB,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAKlE,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B;IAL/C,IAAI,SAA6B;IAEjC,YACE,MAAM,EAAE,CAAC,EACA,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,0BAA0B,YAAA,EAC7C,OAAO,GAAE,MAA+C,EACxD,OAAO,CAAC,EAAE,YAAY,EAGvB;IAED,IAAa,MAAM,IAAI,IAAI,CAE1B;IAEQ,WAAW,IAAI,OAAO,CAE9B;IAEQ,iBAAiB,IAAI,eAAe,CAE5C;CACF;AAED;;;;;;;;;;GAUG;AACH,qBAAa,2BAA2B,CACtC,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAC/C,SAAQ,wBAAwB,CAAC,CAAC,CAAC;IAOjC,QAAQ,CAAC,KAAK,EAAE,kBAAkB;IANpC,IAAI,SAAgC;IAEpC,YACE,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,0BAA0B,EAC1B,KAAK,EAAE,kBAAkB,EASnC;CACF;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB,CAC5B,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAC/C,SAAQ,SAAS,CAAC,CAAC,EAAE,qBAAqB,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,SAAsB;IAE1B,YAAY,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAO9D;IAED,IAAa,MAAM,IAAI,IAAI,CAE1B;IAEQ,WAAW,IAAI,OAAO,CAE9B;IAEQ,MAAM,IAAI,YAAY,CAG9B;IAEQ,iBAAiB,IAAI,eAAe,CAE5C;CACF;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc,CACzB,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAC/C,SAAQ,iBAAiB,CAAC,CAAC,CAAC;IAC5B,IAAI,SAAmB;IAEvB,YAAY,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAGpC;IAEQ,WAAW,IAAI,OAAO,CAM9B;IAEQ,MAAM,IAAI,YAAY,CAG9B;IAEQ,iBAAiB,IAAI,eAAe,CAO5C;CACF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,IAEnE,iBAAiB,CAAC,CAAC,CAAC,GAEpB,wBAAwB,CAAC,CAAC,CAAC,GAE3B,iBAAiB,CAAC,CAAC,CAAC,CAAA;AAExB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,KAAK,EACvD,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,GACb,WAAW,CAAC,CAAC,CAAC,CAUhB"}

package/dist/errors.js

@@ -1,6 +1,6 @@
-import { LexError, } from '@atproto/lex-data';
-import { lexErrorDataSchema, } from '@atproto/lex-schema';
-import { parseWWWAuthenticateHeader, } from './www-authenticate.js';
+import { LexError } from '@atproto/lex-data';
+import { LexValidationError, Procedure, Query, lexErrorDataSchema, } from '@atproto/lex-schema';
+import { parseWWWAuthenticateHeader } from './www-authenticate.js';
 /**
  * Mapping that allows generating an XRPC error code from an HTTP status code
  * when the response does not contain a valid XRPC error payload. This is used

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  LexError,\n  LexErrorCode,\n  LexErrorData,\n  LexValue,\n} from '@atproto/lex-data'\nimport {\n  InferMethodError,\n  LexValidationError,\n  Procedure,\n  Query,\n  ResultFailure,\n  lexErrorDataSchema,\n} from '@atproto/lex-schema'\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport { Agent } from './agent.js'\nimport { XrpcUnknownResponsePayload } from './types.js'\nimport {\n  WWWAuthenticate,\n  parseWWWAuthenticateHeader,\n} from './www-authenticate.js'\n\n/**\n * Mapping that allows generating an XRPC error code from an HTTP status code\n * when the response does not contain a valid XRPC error payload. This is used\n * to convert non-XRPC error responses from upstream servers into a standardized\n * XRPC error for downstream clients.\n */\nconst StatusErrorCodes = new Map<number, LexErrorCode>([\n  [400, 'InvalidRequest'],\n  [401, 'AuthenticationRequired'],\n  [403, 'Forbidden'],\n  [404, 'XRPCNotSupported'],\n  [406, 'NotAcceptable'],\n  [413, 'PayloadTooLarge'],\n  [415, 'UnsupportedMediaType'],\n  [429, 'RateLimitExceeded'],\n  [500, 'InternalServerError'],\n  [501, 'MethodNotImplemented'],\n  [502, 'UpstreamFailure'],\n  [503, 'NotEnoughResources'],\n  [504, 'UpstreamTimeout'],\n])\n\nexport type { XrpcUnknownResponsePayload }\n\nexport type DownstreamError<N extends LexErrorCode = LexErrorCode> = {\n  status: number\n  headers?: Headers\n  encoding?: 'application/json'\n  body: LexErrorData<N>\n}\n\n/**\n * HTTP status codes that indicate a transient error that may succeed on retry.\n *\n * Includes:\n * - 408 Request Timeout\n * - 425 Too Early\n * - 429 Too Many Requests (rate limited)\n * - 500 Internal Server Error\n * - 502 Bad Gateway\n * - 503 Service Unavailable\n * - 504 Gateway Timeout\n * - 522 Connection Timed Out (Cloudflare)\n * - 524 A Timeout Occurred (Cloudflare)\n */\nexport const RETRYABLE_HTTP_STATUS_CODES: ReadonlySet<number> = new Set([\n  408, 425, 429, 500, 502, 503, 504, 522, 524,\n])\n\nexport { LexError }\nexport type { LexErrorCode, LexErrorData }\n\n/**\n * The payload structure for XRPC error responses.\n *\n * All XRPC errors return JSON with an `error` code and optional `message`.\n *\n * @typeParam N - The specific error code type\n */\nexport type XrpcErrorPayload<N extends LexErrorCode = LexErrorCode> = {\n  body: LexErrorData<N>\n  encoding: 'application/json'\n}\n\n/**\n * All unsuccessful responses should follow a standard error response\n * schema. The Content-Type should be application/json, and the payload\n * should be a JSON object with the following fields:\n *\n * - `error` (string, required): type name of the error (generic ASCII\n *   constant, no whitespace)\n * - `message` (string, optional): description of the error, appropriate for\n *   display to humans\n *\n * This function checks whether a given payload matches this schema.\n */\nexport function isXrpcErrorPayload(\n  payload: XrpcUnknownResponsePayload | null | undefined,\n): payload is XrpcErrorPayload {\n  return (\n    payload != null &&\n    payload.encoding === 'application/json' &&\n    lexErrorDataSchema.matches(payload.body)\n  )\n}\n\n/**\n * Abstract base class for all XRPC errors.\n *\n * Extends {@link LexError} and implements {@link ResultFailure} for use with\n * safe/result-based error handling patterns.\n *\n * @typeParam M - The XRPC method type (Procedure or Query)\n * @typeParam N - The error code type\n * @typeParam TReason - The reason type for ResultFailure\n *\n * @see {@link XrpcResponseError} - For valid XRPC error responses\n * @see {@link XrpcInvalidResponseError} - For invalid/unexpected responses\n * @see {@link XrpcInternalError} - For network/internal errors\n */\nexport abstract class XrpcError<\n    M extends Procedure | Query = Procedure | Query,\n    N extends LexErrorCode = LexErrorCode,\n    TReason = unknown,\n  >\n  extends LexError<N>\n  implements ResultFailure<TReason>\n{\n  name = 'XrpcError'\n\n  constructor(\n    readonly method: M,\n    error: N,\n    message: string = `${error} Lexicon RPC error`,\n    options?: ErrorOptions,\n  ) {\n    super(error, message, options)\n  }\n\n  /**\n   * @see {@link ResultFailure.success}\n   */\n  readonly success = false as const\n\n  /**\n   * @see {@link ResultFailure.reason}\n   */\n  abstract readonly reason: TReason\n\n  /**\n   * Indicates whether the error is transient and can be retried.\n   */\n  abstract shouldRetry(): boolean\n\n  abstract toDownstreamError(): DownstreamError\n\n  matchesSchemaErrors(): this is XrpcError<M, InferMethodError<M>> {\n    return this.method.errors?.includes(this.error) ?? false\n  }\n}\n\n/**\n * Error class for valid XRPC error responses from the server.\n *\n * This represents a properly formatted XRPC error where the server returned\n * a non-2xx status with a valid JSON error payload containing `error` and\n * optional `message` fields.\n *\n * Use {@link matchesSchemaErrors} to check if the error matches the method's declared\n * error types for type-safe error handling.\n *\n * @typeParam M - The XRPC method type\n * @typeParam N - The error code type (inferred from method or generic)\n *\n * @example Handling specific errors\n * ```typescript\n * try {\n *   await client.xrpc(someMethod, options)\n * } catch (err) {\n *   if (err instanceof XrpcResponseError && err.error === 'RecordNotFound') {\n *     // Handle not found case\n *   }\n * }\n * ```\n */\nexport class XrpcResponseError<\n  M extends Procedure | Query = Procedure | Query,\n> extends XrpcError<M, LexErrorCode, XrpcResponseError<M>> {\n  name = 'XrpcResponseError'\n\n  constructor(\n    method: M,\n    readonly response: Response,\n    readonly payload?: XrpcUnknownResponsePayload,\n    options?: ErrorOptions,\n  ) {\n    const { error, message } = isXrpcErrorPayload(payload)\n      ? payload.body\n      : {\n          error:\n            StatusErrorCodes.get(response.status) ??\n            (response.status >= 500 ? 'UpstreamFailure' : 'InvalidRequest'),\n          message: buildResponseOverviewMessage(response),\n        }\n    super(method, error, message, options)\n  }\n\n  override get reason(): this {\n    return this\n  }\n\n  override shouldRetry(): boolean {\n    return RETRYABLE_HTTP_STATUS_CODES.has(this.response.status)\n  }\n\n  override toJSON(): LexErrorData {\n    // Return the original error payload if it's a valid XRPC error, otherwise\n    // convert to an XRPC error format.\n    const { payload } = this\n    if (isXrpcErrorPayload(payload)) {\n      return payload.body\n    }\n\n    return super.toJSON()\n  }\n\n  override toDownstreamError(): DownstreamError {\n    const { status, headers } = this.response\n    // If the upstream server returned a 500 error, we want to return a 502 Bad\n    // Gateway to downstream clients, as the issue is with the upstream server,\n    // not us. We still return the original error code and message in the body\n    // for transparency, but we do not want to expose internal server errors\n    // from the upstream server as-is to downstream clients.\n    return {\n      status: status === 500 ? 502 : status,\n      headers: stripHopByHopHeaders(headers),\n      body: this.toJSON(),\n    }\n  }\n\n  get status(): number {\n    return this.response.status\n  }\n\n  get headers(): Headers {\n    return this.response.headers\n  }\n\n  get body(): undefined | Uint8Array | LexValue {\n    return this.payload?.body\n  }\n}\n\nexport type { WWWAuthenticate }\n\n/**\n * Error class for 401 Unauthorized XRPC responses.\n *\n * Extends {@link XrpcResponseError} with access to parsed WWW-Authenticate header\n * information, useful for implementing authentication flows.\n *\n * Authentication errors are never retryable as they require user intervention\n * (e.g., re-authentication, token refresh).\n *\n * @typeParam M - The XRPC method type\n * @typeParam N - The error code type\n *\n * @example Handling authentication errors\n * ```typescript\n * try {\n *   await client.xrpc(someMethod, options)\n * } catch (err) {\n *   if (err instanceof XrpcAuthenticationError) {\n *     const { DPoP } = err.wwwAuthenticate\n *     if (DPoP?.error === 'use_dpop_nonce') {\n *       // Handle DPoP nonce requirement\n *     }\n *   }\n * }\n * ```\n */\nexport class XrpcAuthenticationError<\n  M extends Procedure | Query = Procedure | Query,\n> extends XrpcResponseError<M> {\n  name = 'XrpcAuthenticationError'\n\n  override shouldRetry(): boolean {\n    return false\n  }\n\n  #wwwAuthenticateCached?: WWWAuthenticate\n  /**\n   * Parsed WWW-Authenticate header from the response.\n   * Contains authentication scheme parameters (e.g., Bearer realm, DPoP nonce).\n   */\n  get wwwAuthenticate(): WWWAuthenticate {\n    return (this.#wwwAuthenticateCached ??=\n      parseWWWAuthenticateHeader(\n        this.response.headers.get('www-authenticate'),\n      ) ?? {})\n  }\n}\n\n/**\n * Error class for invalid or unprocessable XRPC responses from upstream servers.\n *\n * This occurs when the server returns a response that doesn't conform to the\n * XRPC protocol, such as:\n * - Missing or invalid Content-Type header\n * - Response body that doesn't match the method's output schema\n * - Non-JSON error responses\n * - Responses from non-XRPC endpoints\n *\n * The error code is always 'InvalidResponse' and maps to HTTP 502 Bad Gateway\n * when converted to a response. This should allow downstream clients to\n * determine at which boundary the error occurred.\n *\n * @typeParam M - The XRPC method type\n */\nexport class XrpcInvalidResponseError<\n  M extends Procedure | Query = Procedure | Query,\n> extends XrpcError<M, 'InvalidResponse', XrpcInvalidResponseError<M>> {\n  name = 'XrpcInvalidResponseError'\n\n  constructor(\n    method: M,\n    readonly response: Response,\n    readonly payload?: XrpcUnknownResponsePayload,\n    message: string = buildResponseOverviewMessage(response),\n    options?: ErrorOptions,\n  ) {\n    super(method, 'InvalidResponse', message, options)\n  }\n\n  override get reason(): this {\n    return this\n  }\n\n  override shouldRetry(): boolean {\n    return RETRYABLE_HTTP_STATUS_CODES.has(this.response.status)\n  }\n\n  override toDownstreamError(): DownstreamError {\n    return { status: 502, body: this.toJSON() }\n  }\n}\n\n/**\n * Error class for invalid XRPC responses that fail schema validation.\n *\n * This is a specific type of {@link XrpcInvalidResponseError} that indicates the\n * upstream server returned a response that was structurally valid but did not\n * conform to the expected schema for the method. This likely indicates a\n * mismatch between client and server versions or an issue with the server's\n * XRPC implementation.\n *\n * @typeParam M - The XRPC method type\n */\nexport class XrpcResponseValidationError<\n  M extends Procedure | Query = Procedure | Query,\n> extends XrpcInvalidResponseError<M> {\n  name = 'XrpcResponseValidationError'\n\n  constructor(\n    method: M,\n    response: Response,\n    payload: XrpcUnknownResponsePayload,\n    readonly cause: LexValidationError,\n  ) {\n    super(\n      method,\n      response,\n      payload,\n      `Invalid response payload: ${cause.message}`,\n      { cause },\n    )\n  }\n}\n\n/**\n * Error class for unexpected internal/client-side errors during XRPC requests.\n *\n * The error code is always 'InternalServerError' and these errors not\n * considered retryable as they stem from unforeseen issues in the\n * implementation.\n *\n * @typeParam M - The XRPC method type\n */\nexport class XrpcInternalError<\n  M extends Procedure | Query = Procedure | Query,\n> extends XrpcError<M, 'InternalServerError', XrpcInternalError<M>> {\n  name = 'XrpcInternalError'\n\n  constructor(method: M, message?: string, options?: ErrorOptions) {\n    super(\n      method,\n      'InternalServerError',\n      message ?? 'Unable to fulfill XRPC request',\n      options,\n    )\n  }\n\n  override get reason(): this {\n    return this\n  }\n\n  override shouldRetry(): boolean {\n    return false\n  }\n\n  override toJSON(): LexErrorData {\n    // @NOTE Do not expose internal error details to downstream clients\n    return { error: this.error, message: 'Internal Server Error' }\n  }\n\n  override toDownstreamError(): DownstreamError {\n    return { status: 500, body: this.toJSON() }\n  }\n}\n\n/**\n * Special case of XrpcInternalError that specifically represents errors thrown\n * by {@link Agent.fetchHandler} during the XRPC request. This includes:\n * - Network errors (connection refused, DNS failure)\n * - Request timeouts\n * - Request aborted via AbortSignal\n *\n * These errors are optimistically considered retryable, as many fetch errors\n * are transient and may succeed on retry.\n */\nexport class XrpcFetchError<\n  M extends Procedure | Query = Procedure | Query,\n> extends XrpcInternalError<M> {\n  name = 'XrpcFetchError'\n\n  constructor(method: M, cause: unknown) {\n    const message = cause instanceof Error ? cause.message : String(cause)\n    super(method, `Unexpected fetchHandler() error: ${message}`, { cause })\n  }\n\n  override shouldRetry(): boolean {\n    // Ideally, we would inspect the reason to determine if it's retryable (by\n    // detecting network errors, timeouts, etc.). Since these cases are highly\n    // platform-dependent, we optimistically assume all fetch errors are\n    // transient and retryable.\n    return true\n  }\n\n  override toJSON(): LexErrorData {\n    // @NOTE Do not expose internal error details to downstream clients\n    return { error: this.error, message: 'Failed to perform upstream request' }\n  }\n\n  override toDownstreamError(): DownstreamError {\n    // While it might technically be a 500 error, we use 502 Bad Gateway here to\n    // indicate that the error occurred while communicating with the upstream\n    // server, allowing downstream clients to distinguish between errors in our\n    // internal processing (500) and errors in the upstream server or network\n    // (502).\n    return { status: 502, body: this.toJSON() }\n  }\n}\n\n/**\n * Union type of all possible XRPC failure types.\n *\n * Used as the return type for safe/non-throwing XRPC methods. Check the\n * `success` property to distinguish between success and failure:\n *\n * @typeParam M - The XRPC method type\n *\n * @example\n * ```typescript\n * const result = await client.xrpcSafe(someMethod, options)\n * if (result.success) {\n *   console.log(result.body) // XrpcResponse\n * } else {\n *   // result is XrpcFailure (XrpcResponseError | XrpcInvalidResponseError | XrpcInternalError)\n *   console.error(result.error, result.message)\n * }\n * ```\n */\nexport type XrpcFailure<M extends Procedure | Query = Procedure | Query> =\n  // The server returned a valid XRPC error response\n  | XrpcResponseError<M>\n  // The response was not a valid XRPC response, or it does not match the schema\n  | XrpcInvalidResponseError<M>\n  // Something went wrong (network error, etc.)\n  | XrpcInternalError<M>\n\n/**\n * Converts an unknown error into an appropriate {@link XrpcFailure} type.\n *\n * If the error is already an XrpcFailure for the given method, returns it as-is.\n * Otherwise, wraps it in an {@link XrpcInternalError}.\n *\n * @param method - The XRPC method that was called\n * @param cause - The error to convert\n * @returns An XrpcFailure instance\n *\n * @example\n * ```typescript\n * try {\n *   const response = await fetch(...)\n *   // ... process response\n * } catch (err) {\n *   return asXrpcFailure(method, err)\n * }\n * ```\n */\nexport function asXrpcFailure<M extends Procedure | Query>(\n  method: M,\n  cause: unknown,\n): XrpcFailure<M> {\n  if (\n    cause instanceof XrpcResponseError ||\n    cause instanceof XrpcInvalidResponseError ||\n    cause instanceof XrpcInternalError\n  ) {\n    if (cause.method === method) return cause\n  }\n\n  return new XrpcInternalError(method, undefined, { cause })\n}\n\nconst HOP_BY_HOP_HEADERS = new Set([\n  'connection',\n  'keep-alive',\n  'proxy-authenticate',\n  'proxy-authorization',\n  'te',\n  'trailer',\n  'transfer-encoding',\n  'upgrade',\n])\n\nfunction stripHopByHopHeaders(headers: Headers): Headers {\n  const result = new Headers(headers)\n\n  // Remove statically known hop-by-hop headers\n  for (const name of HOP_BY_HOP_HEADERS) {\n    result.delete(name)\n  }\n\n  // Remove headers listed in the \"Connection\" header\n  const connection = headers.get('connection')\n  if (connection) {\n    for (const name of connection.split(',')) {\n      result.delete(name.trim())\n    }\n  }\n\n  // These are not actually hop-by-hop headers, but we remove them because the\n  // upstream payload gets parsed and re-serialized, so content length and\n  // encoding may no longer be accurate.\n  result.delete('content-length')\n  result.delete('content-encoding')\n\n  return result\n}\n\nfunction buildResponseOverviewMessage(response: Response): string {\n  if (response.status < 400) {\n    return `Upstream server responded with an invalid status code (${response.status})`\n  }\n\n  return `Upstream server responded with a ${response.status} error`\n}\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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","sourcesContent":["import type { LexErrorCode, LexErrorData, LexValue } from '@atproto/lex-data'\nimport { LexError } from '@atproto/lex-data'\nimport {\n  LexValidationError,\n  Procedure,\n  Query,\n  lexErrorDataSchema,\n} from '@atproto/lex-schema'\nimport type { InferMethodError, ResultFailure } from '@atproto/lex-schema'\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport type { Agent } from './agent.js'\nimport type { XrpcUnknownResponsePayload } from './types.js'\nimport type { WWWAuthenticate } from './www-authenticate.js'\nimport { parseWWWAuthenticateHeader } from './www-authenticate.js'\n\n/**\n * Mapping that allows generating an XRPC error code from an HTTP status code\n * when the response does not contain a valid XRPC error payload. This is used\n * to convert non-XRPC error responses from upstream servers into a standardized\n * XRPC error for downstream clients.\n */\nconst StatusErrorCodes = new Map<number, LexErrorCode>([\n  [400, 'InvalidRequest'],\n  [401, 'AuthenticationRequired'],\n  [403, 'Forbidden'],\n  [404, 'XRPCNotSupported'],\n  [406, 'NotAcceptable'],\n  [413, 'PayloadTooLarge'],\n  [415, 'UnsupportedMediaType'],\n  [429, 'RateLimitExceeded'],\n  [500, 'InternalServerError'],\n  [501, 'MethodNotImplemented'],\n  [502, 'UpstreamFailure'],\n  [503, 'NotEnoughResources'],\n  [504, 'UpstreamTimeout'],\n])\n\nexport type { XrpcUnknownResponsePayload }\n\nexport type DownstreamError<N extends LexErrorCode = LexErrorCode> = {\n  status: number\n  headers?: Headers\n  encoding?: 'application/json'\n  body: LexErrorData<N>\n}\n\n/**\n * HTTP status codes that indicate a transient error that may succeed on retry.\n *\n * Includes:\n * - 408 Request Timeout\n * - 425 Too Early\n * - 429 Too Many Requests (rate limited)\n * - 500 Internal Server Error\n * - 502 Bad Gateway\n * - 503 Service Unavailable\n * - 504 Gateway Timeout\n * - 522 Connection Timed Out (Cloudflare)\n * - 524 A Timeout Occurred (Cloudflare)\n */\nexport const RETRYABLE_HTTP_STATUS_CODES: ReadonlySet<number> = new Set([\n  408, 425, 429, 500, 502, 503, 504, 522, 524,\n])\n\nexport { LexError }\nexport type { LexErrorCode, LexErrorData }\n\n/**\n * The payload structure for XRPC error responses.\n *\n * All XRPC errors return JSON with an `error` code and optional `message`.\n *\n * @typeParam N - The specific error code type\n */\nexport type XrpcErrorPayload<N extends LexErrorCode = LexErrorCode> = {\n  body: LexErrorData<N>\n  encoding: 'application/json'\n}\n\n/**\n * All unsuccessful responses should follow a standard error response\n * schema. The Content-Type should be application/json, and the payload\n * should be a JSON object with the following fields:\n *\n * - `error` (string, required): type name of the error (generic ASCII\n *   constant, no whitespace)\n * - `message` (string, optional): description of the error, appropriate for\n *   display to humans\n *\n * This function checks whether a given payload matches this schema.\n */\nexport function isXrpcErrorPayload(\n  payload: XrpcUnknownResponsePayload | null | undefined,\n): payload is XrpcErrorPayload {\n  return (\n    payload != null &&\n    payload.encoding === 'application/json' &&\n    lexErrorDataSchema.matches(payload.body)\n  )\n}\n\n/**\n * Abstract base class for all XRPC errors.\n *\n * Extends {@link LexError} and implements {@link ResultFailure} for use with\n * safe/result-based error handling patterns.\n *\n * @typeParam M - The XRPC method type (Procedure or Query)\n * @typeParam N - The error code type\n * @typeParam TReason - The reason type for ResultFailure\n *\n * @see {@link XrpcResponseError} - For valid XRPC error responses\n * @see {@link XrpcInvalidResponseError} - For invalid/unexpected responses\n * @see {@link XrpcInternalError} - For network/internal errors\n */\nexport abstract class XrpcError<\n    M extends Procedure | Query = Procedure | Query,\n    N extends LexErrorCode = LexErrorCode,\n    TReason = unknown,\n  >\n  extends LexError<N>\n  implements ResultFailure<TReason>\n{\n  name = 'XrpcError'\n\n  constructor(\n    readonly method: M,\n    error: N,\n    message: string = `${error} Lexicon RPC error`,\n    options?: ErrorOptions,\n  ) {\n    super(error, message, options)\n  }\n\n  /**\n   * @see {@link ResultFailure.success}\n   */\n  readonly success = false as const\n\n  /**\n   * @see {@link ResultFailure.reason}\n   */\n  abstract readonly reason: TReason\n\n  /**\n   * Indicates whether the error is transient and can be retried.\n   */\n  abstract shouldRetry(): boolean\n\n  abstract toDownstreamError(): DownstreamError\n\n  matchesSchemaErrors(): this is XrpcError<M, InferMethodError<M>> {\n    return this.method.errors?.includes(this.error) ?? false\n  }\n}\n\n/**\n * Error class for valid XRPC error responses from the server.\n *\n * This represents a properly formatted XRPC error where the server returned\n * a non-2xx status with a valid JSON error payload containing `error` and\n * optional `message` fields.\n *\n * Use {@link matchesSchemaErrors} to check if the error matches the method's declared\n * error types for type-safe error handling.\n *\n * @typeParam M - The XRPC method type\n * @typeParam N - The error code type (inferred from method or generic)\n *\n * @example Handling specific errors\n * ```typescript\n * try {\n *   await client.xrpc(someMethod, options)\n * } catch (err) {\n *   if (err instanceof XrpcResponseError && err.error === 'RecordNotFound') {\n *     // Handle not found case\n *   }\n * }\n * ```\n */\nexport class XrpcResponseError<\n  M extends Procedure | Query = Procedure | Query,\n> extends XrpcError<M, LexErrorCode, XrpcResponseError<M>> {\n  name = 'XrpcResponseError'\n\n  constructor(\n    method: M,\n    readonly response: Response,\n    readonly payload?: XrpcUnknownResponsePayload,\n    options?: ErrorOptions,\n  ) {\n    const { error, message } = isXrpcErrorPayload(payload)\n      ? payload.body\n      : {\n          error:\n            StatusErrorCodes.get(response.status) ??\n            (response.status >= 500 ? 'UpstreamFailure' : 'InvalidRequest'),\n          message: buildResponseOverviewMessage(response),\n        }\n    super(method, error, message, options)\n  }\n\n  override get reason(): this {\n    return this\n  }\n\n  override shouldRetry(): boolean {\n    return RETRYABLE_HTTP_STATUS_CODES.has(this.response.status)\n  }\n\n  override toJSON(): LexErrorData {\n    // Return the original error payload if it's a valid XRPC error, otherwise\n    // convert to an XRPC error format.\n    const { payload } = this\n    if (isXrpcErrorPayload(payload)) {\n      return payload.body\n    }\n\n    return super.toJSON()\n  }\n\n  override toDownstreamError(): DownstreamError {\n    const { status, headers } = this.response\n    // If the upstream server returned a 500 error, we want to return a 502 Bad\n    // Gateway to downstream clients, as the issue is with the upstream server,\n    // not us. We still return the original error code and message in the body\n    // for transparency, but we do not want to expose internal server errors\n    // from the upstream server as-is to downstream clients.\n    return {\n      status: status === 500 ? 502 : status,\n      headers: stripHopByHopHeaders(headers),\n      body: this.toJSON(),\n    }\n  }\n\n  get status(): number {\n    return this.response.status\n  }\n\n  get headers(): Headers {\n    return this.response.headers\n  }\n\n  get body(): undefined | Uint8Array | LexValue {\n    return this.payload?.body\n  }\n}\n\nexport type { WWWAuthenticate }\n\n/**\n * Error class for 401 Unauthorized XRPC responses.\n *\n * Extends {@link XrpcResponseError} with access to parsed WWW-Authenticate header\n * information, useful for implementing authentication flows.\n *\n * Authentication errors are never retryable as they require user intervention\n * (e.g., re-authentication, token refresh).\n *\n * @typeParam M - The XRPC method type\n * @typeParam N - The error code type\n *\n * @example Handling authentication errors\n * ```typescript\n * try {\n *   await client.xrpc(someMethod, options)\n * } catch (err) {\n *   if (err instanceof XrpcAuthenticationError) {\n *     const { DPoP } = err.wwwAuthenticate\n *     if (DPoP?.error === 'use_dpop_nonce') {\n *       // Handle DPoP nonce requirement\n *     }\n *   }\n * }\n * ```\n */\nexport class XrpcAuthenticationError<\n  M extends Procedure | Query = Procedure | Query,\n> extends XrpcResponseError<M> {\n  name = 'XrpcAuthenticationError'\n\n  override shouldRetry(): boolean {\n    return false\n  }\n\n  #wwwAuthenticateCached?: WWWAuthenticate\n  /**\n   * Parsed WWW-Authenticate header from the response.\n   * Contains authentication scheme parameters (e.g., Bearer realm, DPoP nonce).\n   */\n  get wwwAuthenticate(): WWWAuthenticate {\n    return (this.#wwwAuthenticateCached ??=\n      parseWWWAuthenticateHeader(\n        this.response.headers.get('www-authenticate'),\n      ) ?? {})\n  }\n}\n\n/**\n * Error class for invalid or unprocessable XRPC responses from upstream servers.\n *\n * This occurs when the server returns a response that doesn't conform to the\n * XRPC protocol, such as:\n * - Missing or invalid Content-Type header\n * - Response body that doesn't match the method's output schema\n * - Non-JSON error responses\n * - Responses from non-XRPC endpoints\n *\n * The error code is always 'InvalidResponse' and maps to HTTP 502 Bad Gateway\n * when converted to a response. This should allow downstream clients to\n * determine at which boundary the error occurred.\n *\n * @typeParam M - The XRPC method type\n */\nexport class XrpcInvalidResponseError<\n  M extends Procedure | Query = Procedure | Query,\n> extends XrpcError<M, 'InvalidResponse', XrpcInvalidResponseError<M>> {\n  name = 'XrpcInvalidResponseError'\n\n  constructor(\n    method: M,\n    readonly response: Response,\n    readonly payload?: XrpcUnknownResponsePayload,\n    message: string = buildResponseOverviewMessage(response),\n    options?: ErrorOptions,\n  ) {\n    super(method, 'InvalidResponse', message, options)\n  }\n\n  override get reason(): this {\n    return this\n  }\n\n  override shouldRetry(): boolean {\n    return RETRYABLE_HTTP_STATUS_CODES.has(this.response.status)\n  }\n\n  override toDownstreamError(): DownstreamError {\n    return { status: 502, body: this.toJSON() }\n  }\n}\n\n/**\n * Error class for invalid XRPC responses that fail schema validation.\n *\n * This is a specific type of {@link XrpcInvalidResponseError} that indicates the\n * upstream server returned a response that was structurally valid but did not\n * conform to the expected schema for the method. This likely indicates a\n * mismatch between client and server versions or an issue with the server's\n * XRPC implementation.\n *\n * @typeParam M - The XRPC method type\n */\nexport class XrpcResponseValidationError<\n  M extends Procedure | Query = Procedure | Query,\n> extends XrpcInvalidResponseError<M> {\n  name = 'XrpcResponseValidationError'\n\n  constructor(\n    method: M,\n    response: Response,\n    payload: XrpcUnknownResponsePayload,\n    readonly cause: LexValidationError,\n  ) {\n    super(\n      method,\n      response,\n      payload,\n      `Invalid response payload: ${cause.message}`,\n      { cause },\n    )\n  }\n}\n\n/**\n * Error class for unexpected internal/client-side errors during XRPC requests.\n *\n * The error code is always 'InternalServerError' and these errors not\n * considered retryable as they stem from unforeseen issues in the\n * implementation.\n *\n * @typeParam M - The XRPC method type\n */\nexport class XrpcInternalError<\n  M extends Procedure | Query = Procedure | Query,\n> extends XrpcError<M, 'InternalServerError', XrpcInternalError<M>> {\n  name = 'XrpcInternalError'\n\n  constructor(method: M, message?: string, options?: ErrorOptions) {\n    super(\n      method,\n      'InternalServerError',\n      message ?? 'Unable to fulfill XRPC request',\n      options,\n    )\n  }\n\n  override get reason(): this {\n    return this\n  }\n\n  override shouldRetry(): boolean {\n    return false\n  }\n\n  override toJSON(): LexErrorData {\n    // @NOTE Do not expose internal error details to downstream clients\n    return { error: this.error, message: 'Internal Server Error' }\n  }\n\n  override toDownstreamError(): DownstreamError {\n    return { status: 500, body: this.toJSON() }\n  }\n}\n\n/**\n * Special case of XrpcInternalError that specifically represents errors thrown\n * by {@link Agent.fetchHandler} during the XRPC request. This includes:\n * - Network errors (connection refused, DNS failure)\n * - Request timeouts\n * - Request aborted via AbortSignal\n *\n * These errors are optimistically considered retryable, as many fetch errors\n * are transient and may succeed on retry.\n */\nexport class XrpcFetchError<\n  M extends Procedure | Query = Procedure | Query,\n> extends XrpcInternalError<M> {\n  name = 'XrpcFetchError'\n\n  constructor(method: M, cause: unknown) {\n    const message = cause instanceof Error ? cause.message : String(cause)\n    super(method, `Unexpected fetchHandler() error: ${message}`, { cause })\n  }\n\n  override shouldRetry(): boolean {\n    // Ideally, we would inspect the reason to determine if it's retryable (by\n    // detecting network errors, timeouts, etc.). Since these cases are highly\n    // platform-dependent, we optimistically assume all fetch errors are\n    // transient and retryable.\n    return true\n  }\n\n  override toJSON(): LexErrorData {\n    // @NOTE Do not expose internal error details to downstream clients\n    return { error: this.error, message: 'Failed to perform upstream request' }\n  }\n\n  override toDownstreamError(): DownstreamError {\n    // While it might technically be a 500 error, we use 502 Bad Gateway here to\n    // indicate that the error occurred while communicating with the upstream\n    // server, allowing downstream clients to distinguish between errors in our\n    // internal processing (500) and errors in the upstream server or network\n    // (502).\n    return { status: 502, body: this.toJSON() }\n  }\n}\n\n/**\n * Union type of all possible XRPC failure types.\n *\n * Used as the return type for safe/non-throwing XRPC methods. Check the\n * `success` property to distinguish between success and failure:\n *\n * @typeParam M - The XRPC method type\n *\n * @example\n * ```typescript\n * const result = await client.xrpcSafe(someMethod, options)\n * if (result.success) {\n *   console.log(result.body) // XrpcResponse\n * } else {\n *   // result is XrpcFailure (XrpcResponseError | XrpcInvalidResponseError | XrpcInternalError)\n *   console.error(result.error, result.message)\n * }\n * ```\n */\nexport type XrpcFailure<M extends Procedure | Query = Procedure | Query> =\n  // The server returned a valid XRPC error response\n  | XrpcResponseError<M>\n  // The response was not a valid XRPC response, or it does not match the schema\n  | XrpcInvalidResponseError<M>\n  // Something went wrong (network error, etc.)\n  | XrpcInternalError<M>\n\n/**\n * Converts an unknown error into an appropriate {@link XrpcFailure} type.\n *\n * If the error is already an XrpcFailure for the given method, returns it as-is.\n * Otherwise, wraps it in an {@link XrpcInternalError}.\n *\n * @param method - The XRPC method that was called\n * @param cause - The error to convert\n * @returns An XrpcFailure instance\n *\n * @example\n * ```typescript\n * try {\n *   const response = await fetch(...)\n *   // ... process response\n * } catch (err) {\n *   return asXrpcFailure(method, err)\n * }\n * ```\n */\nexport function asXrpcFailure<M extends Procedure | Query>(\n  method: M,\n  cause: unknown,\n): XrpcFailure<M> {\n  if (\n    cause instanceof XrpcResponseError ||\n    cause instanceof XrpcInvalidResponseError ||\n    cause instanceof XrpcInternalError\n  ) {\n    if (cause.method === method) return cause\n  }\n\n  return new XrpcInternalError(method, undefined, { cause })\n}\n\nconst HOP_BY_HOP_HEADERS = new Set([\n  'connection',\n  'keep-alive',\n  'proxy-authenticate',\n  'proxy-authorization',\n  'te',\n  'trailer',\n  'transfer-encoding',\n  'upgrade',\n])\n\nfunction stripHopByHopHeaders(headers: Headers): Headers {\n  const result = new Headers(headers)\n\n  // Remove statically known hop-by-hop headers\n  for (const name of HOP_BY_HOP_HEADERS) {\n    result.delete(name)\n  }\n\n  // Remove headers listed in the \"Connection\" header\n  const connection = headers.get('connection')\n  if (connection) {\n    for (const name of connection.split(',')) {\n      result.delete(name.trim())\n    }\n  }\n\n  // These are not actually hop-by-hop headers, but we remove them because the\n  // upstream payload gets parsed and re-serialized, so content length and\n  // encoding may no longer be accurate.\n  result.delete('content-length')\n  result.delete('content-encoding')\n\n  return result\n}\n\nfunction buildResponseOverviewMessage(response: Response): string {\n  if (response.status < 400) {\n    return `Upstream server responded with an invalid status code (${response.status})`\n  }\n\n  return `Upstream server responded with a ${response.status} error`\n}\n"]}

package/dist/response.d.ts

@@ -1,5 +1,6 @@
-import { InferMethodOutputEncoding, InferOutput, LexValue, Payload, Procedure, Query, ResultSuccess, Validator } from '@atproto/lex-schema';
-import { EncodingString } from './types.js';
+import type { InferMethodOutputEncoding, InferOutput, LexValue, ResultSuccess, Validator } from '@atproto/lex-schema';
+import { Payload, Procedure, Query } from '@atproto/lex-schema';
+import type { EncodingString } from './types.js';
 type InferEncodingType<TEncoding extends string> = TEncoding extends '*/*' ? EncodingString : TEncoding extends `${infer T extends string}/*` ? `${T}/${string}` : TEncoding;
 type InferBodyType<TEncoding extends string, TSchema> = TSchema extends Validator ? InferOutput<TSchema> : TEncoding extends `application/json` ? LexValue : Uint8Array;
 /**

package/dist/response.d.ts.map

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

package/dist/response.js

@@ -1,6 +1,7 @@
 import { jsonToLex } from '@atproto/lex-json';
+import { Payload, Procedure, Query } from '@atproto/lex-schema';
 import { XrpcAuthenticationError, XrpcInvalidResponseError, XrpcResponseError, XrpcResponseValidationError, } from './errors.js';
-import { isEncodingString, } from './types.js';
+import { isEncodingString } from './types.js';
 const CONTENT_TYPE_BINARY = 'application/octet-stream';
 const CONTENT_TYPE_JSON = 'application/json';
 /**

package/dist/response.js.map

@@ -1 +1 @@
-{"version":3,"file":"response.js","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAW9D,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,aAAa,CAAA;AACpB,OAAO,EAGL,gBAAgB,GACjB,MAAM,YAAY,CAAA;AAEnB,MAAM,mBAAmB,GAAG,0BAA0B,CAAA;AACtD,MAAM,iBAAiB,GAAG,kBAAkB,CAAA;AA8F5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,YAAY;IAMvB,uCAAuC;IACvC,IAAI,KAAK;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IAED,YACW,MAAS,EACT,MAAc,EACd,OAAgB,EAChB,OAA+B;QAH/B,WAAM,GAAN,MAAM,CAAG;QACT,WAAM,GAAN,MAAM,CAAQ;QACd,YAAO,GAAP,OAAO,CAAS;QAChB,YAAO,GAAP,OAAO,CAAwB;QAZ1C,yCAAyC;QAChC,YAAO,GAAG,IAAa,CAAA;IAY7B,CAAC;IAEJ;;;OAGG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,KAAK,iBAAiB,CAAA;IAC1D,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,OAAO,EAAE,QAAwC,CAAA;IAC/D,CAAC;IAED;;;;;;OAMG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,EAAE,IAA2B,CAAA;IAClD,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAC5B,MAAS,EACT,QAAkB,EAClB,OAA6B;QAE7B,0EAA0E;QAC1E,kEAAkE;QAClE,oDAAoD;QAEpD,uDAAuD;QACvD,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE;gBAClD,yCAAyC;gBACzC,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;aACzB,CAAC,CAAA;YAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,uBAAuB,CAAI,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;YACjE,CAAC;YAED,MAAM,IAAI,iBAAiB,CAAI,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;QAC3D,CAAC;QAED,4EAA4E;QAC5E,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YACpD,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAA;YAE7B,MAAM,IAAI,wBAAwB,CAChC,MAAM,EACN,QAAQ,EACR,SAAS,EACT,0BAA0B,QAAQ,CAAC,MAAM,EAAE,CAC5C,CAAA;QACH,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE;YAClD,6DAA6D;YAC7D,qBAAqB;YACrB,KAAK,EACH,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,KAAK,iBAAiB;gBAClE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,IAAI,IAAI,EAAE;gBACvD,CAAC,CAAC,kFAAkF;oBAClF,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI;wBAC9B,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;wBACnB,CAAC,CAAC,KAAK;SACd,CAAC,CAAA;QAEF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,wBAAwB,CAChC,MAAM,EACN,QAAQ,EACR,OAAO,EACP,YAAY,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAC/G,CAAA;QACH,CAAC;QAED,qFAAqF;QACrF,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;YACnC,uEAAuE;YACvE,uEAAuE;YACvE,sDAAsD;YAEtD,sEAAsE;YACtE,0EAA0E;YAC1E,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAA;YAEjD,8BAA8B;YAC9B,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,EAAE,gBAAgB,KAAK,KAAK,EAAE,CAAC;gBAChE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE;oBAC1D,MAAM,EAAE,OAAO,EAAE,wBAAwB,IAAI,IAAI;iBAClD,CAAC,CAAA;gBAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,MAAM,IAAI,2BAA2B,CACnC,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,CAAC,MAAM,CACd,CAAA;gBACH,CAAC;gBAED,MAAM,aAAa,GAAG;oBACpB,IAAI,EAAE,MAAM,CAAC,KAAK;oBAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;iBACD,CAAA;gBAE3B,OAAO,IAAI,YAAY,CACrB,MAAM,EACN,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,OAAO,EAChB,aAAa,CACd,CAAA;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,YAAY,CACrB,MAAM,EACN,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,OAAO,EAChB,OAAiC,CAClC,CAAA;IACH,CAAC;CACF;AAWD;;GAEG;AACH,KAAK,UAAU,WAAW,CACxB,MAAyB,EACzB,QAAkB,EAClB,OAA4B;IAE5B,IAAI,CAAC;QACH,2EAA2E;QAC3E,6BAA6B;QAE7B,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO;aAC9B,GAAG,CAAC,cAAc,CAAC;YACpB,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aACd,IAAI,EAAE;aACN,WAAW,EAAE,CAAA;QAEhB,qCAAqC;QACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,wDAAwD;YACxD,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAA;YAChD,IAAI,WAAW,CAAC,UAAU,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAA;YAElD,6DAA6D;YAC7D,OAAO;gBACL,QAAQ,EAAE,mBAAmB;gBAC7B,IAAI,EAAE,IAAI,UAAU,CAAC,WAAW,CAAC;aAClC,CAAA;QACH,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,SAAS,CAAC,yBAAyB,QAAQ,eAAe,CAAC,CAAA;QACvE,CAAC;QAED,IAAI,OAAO,EAAE,KAAK,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;YACrD,+EAA+E;YAC/E,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YAClC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;YAC3C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;QAC3B,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAA;QAChD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAA;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,kCAAkC,CAAA;QAClD,MAAM,aAAa,GAAG,KAAK,YAAY,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;QAC5E,MAAM,IAAI,wBAAwB,CAChC,MAAM,EACN,QAAQ,EACR,SAAS,EACT,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,aAAa,EAAE,CAAC,CAAC,CAAC,OAAO,EACxD,EAAE,KAAK,EAAE,CACV,CAAA;IACH,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,QAA4B;IACrD,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,YAAY,CAAA;AAClD,CAAC","sourcesContent":["import { LexParseOptions, jsonToLex } from '@atproto/lex-json'\nimport {\n  InferMethodOutputEncoding,\n  InferOutput,\n  LexValue,\n  Payload,\n  Procedure,\n  Query,\n  ResultSuccess,\n  Validator,\n} from '@atproto/lex-schema'\nimport {\n  XrpcAuthenticationError,\n  XrpcInvalidResponseError,\n  XrpcResponseError,\n  XrpcResponseValidationError,\n} from './errors.js'\nimport {\n  EncodingString,\n  XrpcUnknownResponsePayload,\n  isEncodingString,\n} from './types.js'\n\nconst CONTENT_TYPE_BINARY = 'application/octet-stream'\nconst CONTENT_TYPE_JSON = 'application/json'\n\n// @NOTE the output schema is used in \"parse\" mode (safeParse), which means that\n// defaults will be applied and coercions will be performed, so we need to use\n// InferOutput here to get the final parsed type, not Infer/InferInput. For this\n// reason, we cannot use InferMethodOutputBody and InferMethodOutput from\n// lex-schema here.\n\ntype InferEncodingType<TEncoding extends string> = TEncoding extends '*/*'\n  ? EncodingString\n  : TEncoding extends `${infer T extends string}/*`\n    ? `${T}/${string}`\n    : TEncoding\n\ntype InferBodyType<\n  TEncoding extends string,\n  TSchema,\n> = TSchema extends Validator\n  ? InferOutput<TSchema>\n  : TEncoding extends `application/json`\n    ? LexValue\n    : Uint8Array\n\n/**\n * The body type of an XRPC response, inferred from the method's output schema.\n *\n * For JSON responses, this is the parsed LexValue. For binary responses,\n * this is a Uint8Array.\n *\n * @typeParam M - The XRPC method type (Procedure or Query)\n */\nexport type XrpcResponseBody<M extends Procedure | Query> =\n  M['output'] extends Payload<infer TEncoding, infer TSchema>\n    ? TEncoding extends string\n      ? InferBodyType<TEncoding, TSchema>\n      : undefined | LexValue | Uint8Array\n    : never\n\n/**\n * The full payload type of an XRPC response, including body and encoding.\n *\n * Returns `null` for methods that have no output.\n *\n * @typeParam M - The XRPC method type (Procedure or Query)\n */\nexport type XrpcResponsePayload<M extends Procedure | Query> =\n  M['output'] extends Payload<infer TEncoding, infer TSchema>\n    ? TEncoding extends string\n      ? {\n          encoding: InferEncodingType<TEncoding>\n          body: InferBodyType<TEncoding, TSchema>\n        }\n      : // If the schema does not specify an output encoding, anything could be\n        // returned, including no payload at all (undefined).\n        undefined | { body: LexValue | Uint8Array; encoding: string }\n    : never\n\nexport type XrpcResponseOptions = {\n  /**\n   * Whether to validate the response against the method's output schema.\n   * Disabling this can improve performance but may lead to runtime errors if\n   * the response does not conform to the expected schema. Only set this to\n   * `false` if you are certain that the upstream service will always return\n   * valid responses.\n   *\n   * @default true\n   */\n  validateResponse?: boolean\n\n  /**\n   * Whether to strictly process response payloads according to Lex encoding\n   * rules. By default, the client will reject responses with invalid Lex data\n   * (floats and invalid $bytes / $link objects).\n   *\n   * Setting this option to `false` will allow the client to accept such\n   * responses in a non-strict mode, where invalid Lex data will be returned\n   * as-is (e.g., floats will not be rejected, and invalid $bytes / $link\n   * objects will not be converted to Uint8Array / Cid). When in non-strict\n   * mode, the validation will also be relaxed when validating the response\n   * against the method's output schema, allowing values that do not strictly\n   * conform to the schema (e.g. datetime strings that are not valid RFC3339\n   * format, blobs that are not of the right size/mime-type, etc.) to be\n   * accepted as long as their basic structure is correct.\n   *\n   * When validation is enabled (the default), the values defined through the\n   * method schema will be enforced, ensuring that the client can still process\n   * the response even if the server returns invalid Lex data.\n   *\n   * @default true\n   * @see {@link LexParseOptions.strict}\n   */\n  strictResponseProcessing?: boolean\n}\n\n/**\n * Small container for XRPC response.\n *\n * @implements {ResultSuccess<XrpcResponse<M>>} for convenience in result handling contexts.\n *\n * @example\n *\n * ```typescript\n * import { app } from '#/lexicons'\n * import { XrpcResponse } from '@atproto/lex-client'\n *\n * const fetchResponse = await fetch('https://example.com/xrpc/app.bsky.feed.getTimeline')\n *\n * const response = await XrpcResponse.fromFetchResponse(\n *   app.bsky.feed.getTimeline.main,\n *   fetchResponse,\n * )\n *\n * // Fully typed (validated) response body, according to the method's output schema\n * const { cursor, feed } = response.body\n * ```\n */\nexport class XrpcResponse<M extends Procedure | Query>\n  implements ResultSuccess<XrpcResponse<M>>\n{\n  /** @see {@link ResultSuccess.success} */\n  readonly success = true as const\n\n  /** @see {@link ResultSuccess.value} */\n  get value(): this {\n    return this\n  }\n\n  constructor(\n    readonly method: M,\n    readonly status: number,\n    readonly headers: Headers,\n    readonly payload: XrpcResponsePayload<M>,\n  ) {}\n\n  /**\n   * Whether the response payload was parsed as {@link LexValue} (`true`) or is\n   * in binary form {@link Uint8Array} (`false`).\n   */\n  get isParsed() {\n    return this.method.output.encoding === CONTENT_TYPE_JSON\n  }\n\n  /**\n   * The Content-Type encoding of the response (e.g., 'application/json').\n   * Returns `undefined` if the response has no body.\n   */\n  get encoding() {\n    return this.payload?.encoding as InferMethodOutputEncoding<M>\n  }\n\n  /**\n   * The parsed response body.\n   *\n   * For 'application/json' responses, this is the parsed and validated LexValue.\n   * For binary responses, this is a Uint8Array.\n   * Returns `undefined` if the response has no body.\n   */\n  get body() {\n    return this.payload?.body as XrpcResponseBody<M>\n  }\n\n  /**\n   * @throws {XrpcResponseError} in case of (valid) XRPC error responses. Use\n   * {@link XrpcResponseError.matchesSchemaErrors} to narrow the error type based on\n   * the method's declared error schema. This can be narrowed further as a\n   * {@link XrpcAuthenticationError} if the error is an authentication error.\n   * @throws {XrpcInvalidResponseError} when the response is not a valid XRPC\n   * response, or if the response does not conform to the method's schema.\n   */\n  static async fromFetchResponse<const M extends Procedure | Query>(\n    method: M,\n    response: Response,\n    options?: XrpcResponseOptions,\n  ): Promise<XrpcResponse<M>> {\n    // @NOTE The body MUST either be read or canceled to avoid resource leaks.\n    // Since nothing should cause an exception before \"readPayload\" is\n    // called, we can safely not use a try/finally here.\n\n    // Always turn 4xx/5xx responses into XrpcResponseError\n    if (response.status >= 400) {\n      const payload = await readPayload(method, response, {\n        // Always parse errors in non-strict mode\n        parse: { strict: false },\n      })\n\n      if (response.status === 401) {\n        throw new XrpcAuthenticationError<M>(method, response, payload)\n      }\n\n      throw new XrpcResponseError<M>(method, response, payload)\n    }\n\n    // @NOTE redirect is set to 'follow', so we shouldn't get 3xx responses here\n    if (response.status < 200 || response.status >= 300) {\n      await response.body?.cancel()\n\n      throw new XrpcInvalidResponseError(\n        method,\n        response,\n        undefined,\n        `Unexpected status code ${response.status}`,\n      )\n    }\n\n    const payload = await readPayload(method, response, {\n      // Parse response if there is a schema, or if the encoding is\n      // \"application/json\"\n      parse:\n        method.output.schema || method.output.encoding === CONTENT_TYPE_JSON\n          ? { strict: options?.strictResponseProcessing ?? true }\n          : // If there is no declared output encoding, we'll parse the output (in loose mode)\n            method.output.encoding == null\n            ? { strict: false }\n            : false,\n    })\n\n    if (!method.output.matchesEncoding(payload?.encoding)) {\n      throw new XrpcInvalidResponseError(\n        method,\n        response,\n        payload,\n        `Expected ${stringifyEncoding(method.output.encoding)} response (got ${stringifyEncoding(payload?.encoding)})`,\n      )\n    }\n\n    // Response is successful (2xx). Validate payload (data and encoding) against schema.\n    if (method.output.encoding != null) {\n      // If the schema specifies an output, verify that the response properly\n      // matches the expected format (encoding and schema, if present). If no\n      // output is specified, any payload could be returned.\n\n      // Needed for type safety. Should never happen since matchesEncoding()\n      // should return not succeed if there is a schema encoding but no payload.\n      if (!payload) throw new Error('Expected payload')\n\n      // Assert valid response body.\n      if (method.output.schema && options?.validateResponse !== false) {\n        const result = method.output.schema.safeParse(payload.body, {\n          strict: options?.strictResponseProcessing ?? true,\n        })\n\n        if (!result.success) {\n          throw new XrpcResponseValidationError(\n            method,\n            response,\n            payload,\n            result.reason,\n          )\n        }\n\n        const parsedPayload = {\n          body: result.value,\n          encoding: payload.encoding,\n        } as XrpcResponsePayload<M>\n\n        return new XrpcResponse<M>(\n          method,\n          response.status,\n          response.headers,\n          parsedPayload,\n        )\n      }\n    }\n\n    return new XrpcResponse<M>(\n      method,\n      response.status,\n      response.headers,\n      payload as XrpcResponsePayload<M>,\n    )\n  }\n}\n\ntype ReadPayloadOptions = {\n  /**\n   * Whether to parse the response body as JSON and convert it to LexValue.\n   *\n   * @default false\n   */\n  parse?: false | LexParseOptions\n}\n\n/**\n * @note this function always consumes the response body\n */\nasync function readPayload(\n  method: Query | Procedure,\n  response: Response,\n  options?: ReadPayloadOptions,\n): Promise<undefined | XrpcUnknownResponsePayload> {\n  try {\n    // @TODO Should we limit the maximum response size here (this could also be\n    // done by the FetchHandler)?\n\n    const encoding = response.headers\n      .get('content-type')\n      ?.split(';')[0]\n      .trim()\n      .toLowerCase()\n\n    // Response content-type is undefined\n    if (!encoding) {\n      // If the body is empty, return undefined (= no payload)\n      const arrayBuffer = await response.arrayBuffer()\n      if (arrayBuffer.byteLength === 0) return undefined\n\n      // If we got data despite no content-type, treat it as binary\n      return {\n        encoding: CONTENT_TYPE_BINARY,\n        body: new Uint8Array(arrayBuffer),\n      }\n    }\n\n    if (!isEncodingString(encoding)) {\n      throw new TypeError(`Invalid content-type \"${encoding}\" in response`)\n    }\n\n    if (options?.parse && encoding === CONTENT_TYPE_JSON) {\n      // @NOTE See ./response.bench.ts to comparison of different parsing approaches.\n      const json = await response.json()\n      const body = jsonToLex(json, options.parse)\n      return { encoding, body }\n    }\n\n    const arrayBuffer = await response.arrayBuffer()\n    return { encoding, body: new Uint8Array(arrayBuffer) }\n  } catch (cause) {\n    const message = 'Unable to parse response payload'\n    const messageDetail = cause instanceof TypeError ? cause.message : undefined\n    throw new XrpcInvalidResponseError(\n      method,\n      response,\n      undefined,\n      messageDetail ? `${message}: ${messageDetail}` : message,\n      { cause },\n    )\n  }\n}\n\nfunction stringifyEncoding(encoding: string | undefined) {\n  return encoding ? `\"${encoding}\"` : 'no payload'\n}\n"]}
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"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","sourcesContent":["import type { LexParseOptions } from '@atproto/lex-json'\nimport { jsonToLex } from '@atproto/lex-json'\nimport type {\n  InferMethodOutputEncoding,\n  InferOutput,\n  LexValue,\n  ResultSuccess,\n  Validator,\n} from '@atproto/lex-schema'\nimport { Payload, Procedure, Query } from '@atproto/lex-schema'\nimport {\n  XrpcAuthenticationError,\n  XrpcInvalidResponseError,\n  XrpcResponseError,\n  XrpcResponseValidationError,\n} from './errors.js'\nimport { isEncodingString } from './types.js'\nimport type { EncodingString, XrpcUnknownResponsePayload } from './types.js'\n\nconst CONTENT_TYPE_BINARY = 'application/octet-stream'\nconst CONTENT_TYPE_JSON = 'application/json'\n\n// @NOTE the output schema is used in \"parse\" mode (safeParse), which means that\n// defaults will be applied and coercions will be performed, so we need to use\n// InferOutput here to get the final parsed type, not Infer/InferInput. For this\n// reason, we cannot use InferMethodOutputBody and InferMethodOutput from\n// lex-schema here.\n\ntype InferEncodingType<TEncoding extends string> = TEncoding extends '*/*'\n  ? EncodingString\n  : TEncoding extends `${infer T extends string}/*`\n    ? `${T}/${string}`\n    : TEncoding\n\ntype InferBodyType<\n  TEncoding extends string,\n  TSchema,\n> = TSchema extends Validator\n  ? InferOutput<TSchema>\n  : TEncoding extends `application/json`\n    ? LexValue\n    : Uint8Array\n\n/**\n * The body type of an XRPC response, inferred from the method's output schema.\n *\n * For JSON responses, this is the parsed LexValue. For binary responses,\n * this is a Uint8Array.\n *\n * @typeParam M - The XRPC method type (Procedure or Query)\n */\nexport type XrpcResponseBody<M extends Procedure | Query> =\n  M['output'] extends Payload<infer TEncoding, infer TSchema>\n    ? TEncoding extends string\n      ? InferBodyType<TEncoding, TSchema>\n      : undefined | LexValue | Uint8Array\n    : never\n\n/**\n * The full payload type of an XRPC response, including body and encoding.\n *\n * Returns `null` for methods that have no output.\n *\n * @typeParam M - The XRPC method type (Procedure or Query)\n */\nexport type XrpcResponsePayload<M extends Procedure | Query> =\n  M['output'] extends Payload<infer TEncoding, infer TSchema>\n    ? TEncoding extends string\n      ? {\n          encoding: InferEncodingType<TEncoding>\n          body: InferBodyType<TEncoding, TSchema>\n        }\n      : // If the schema does not specify an output encoding, anything could be\n        // returned, including no payload at all (undefined).\n        undefined | { body: LexValue | Uint8Array; encoding: string }\n    : never\n\nexport type XrpcResponseOptions = {\n  /**\n   * Whether to validate the response against the method's output schema.\n   * Disabling this can improve performance but may lead to runtime errors if\n   * the response does not conform to the expected schema. Only set this to\n   * `false` if you are certain that the upstream service will always return\n   * valid responses.\n   *\n   * @default true\n   */\n  validateResponse?: boolean\n\n  /**\n   * Whether to strictly process response payloads according to Lex encoding\n   * rules. By default, the client will reject responses with invalid Lex data\n   * (floats and invalid $bytes / $link objects).\n   *\n   * Setting this option to `false` will allow the client to accept such\n   * responses in a non-strict mode, where invalid Lex data will be returned\n   * as-is (e.g., floats will not be rejected, and invalid $bytes / $link\n   * objects will not be converted to Uint8Array / Cid). When in non-strict\n   * mode, the validation will also be relaxed when validating the response\n   * against the method's output schema, allowing values that do not strictly\n   * conform to the schema (e.g. datetime strings that are not valid RFC3339\n   * format, blobs that are not of the right size/mime-type, etc.) to be\n   * accepted as long as their basic structure is correct.\n   *\n   * When validation is enabled (the default), the values defined through the\n   * method schema will be enforced, ensuring that the client can still process\n   * the response even if the server returns invalid Lex data.\n   *\n   * @default true\n   * @see {@link LexParseOptions.strict}\n   */\n  strictResponseProcessing?: boolean\n}\n\n/**\n * Small container for XRPC response.\n *\n * @implements {ResultSuccess<XrpcResponse<M>>} for convenience in result handling contexts.\n *\n * @example\n *\n * ```typescript\n * import { app } from '#/lexicons'\n * import { XrpcResponse } from '@atproto/lex-client'\n *\n * const fetchResponse = await fetch('https://example.com/xrpc/app.bsky.feed.getTimeline')\n *\n * const response = await XrpcResponse.fromFetchResponse(\n *   app.bsky.feed.getTimeline.main,\n *   fetchResponse,\n * )\n *\n * // Fully typed (validated) response body, according to the method's output schema\n * const { cursor, feed } = response.body\n * ```\n */\nexport class XrpcResponse<M extends Procedure | Query>\n  implements ResultSuccess<XrpcResponse<M>>\n{\n  /** @see {@link ResultSuccess.success} */\n  readonly success = true as const\n\n  /** @see {@link ResultSuccess.value} */\n  get value(): this {\n    return this\n  }\n\n  constructor(\n    readonly method: M,\n    readonly status: number,\n    readonly headers: Headers,\n    readonly payload: XrpcResponsePayload<M>,\n  ) {}\n\n  /**\n   * Whether the response payload was parsed as {@link LexValue} (`true`) or is\n   * in binary form {@link Uint8Array} (`false`).\n   */\n  get isParsed() {\n    return this.method.output.encoding === CONTENT_TYPE_JSON\n  }\n\n  /**\n   * The Content-Type encoding of the response (e.g., 'application/json').\n   * Returns `undefined` if the response has no body.\n   */\n  get encoding() {\n    return this.payload?.encoding as InferMethodOutputEncoding<M>\n  }\n\n  /**\n   * The parsed response body.\n   *\n   * For 'application/json' responses, this is the parsed and validated LexValue.\n   * For binary responses, this is a Uint8Array.\n   * Returns `undefined` if the response has no body.\n   */\n  get body() {\n    return this.payload?.body as XrpcResponseBody<M>\n  }\n\n  /**\n   * @throws {XrpcResponseError} in case of (valid) XRPC error responses. Use\n   * {@link XrpcResponseError.matchesSchemaErrors} to narrow the error type based on\n   * the method's declared error schema. This can be narrowed further as a\n   * {@link XrpcAuthenticationError} if the error is an authentication error.\n   * @throws {XrpcInvalidResponseError} when the response is not a valid XRPC\n   * response, or if the response does not conform to the method's schema.\n   */\n  static async fromFetchResponse<const M extends Procedure | Query>(\n    method: M,\n    response: Response,\n    options?: XrpcResponseOptions,\n  ): Promise<XrpcResponse<M>> {\n    // @NOTE The body MUST either be read or canceled to avoid resource leaks.\n    // Since nothing should cause an exception before \"readPayload\" is\n    // called, we can safely not use a try/finally here.\n\n    // Always turn 4xx/5xx responses into XrpcResponseError\n    if (response.status >= 400) {\n      const payload = await readPayload(method, response, {\n        // Always parse errors in non-strict mode\n        parse: { strict: false },\n      })\n\n      if (response.status === 401) {\n        throw new XrpcAuthenticationError<M>(method, response, payload)\n      }\n\n      throw new XrpcResponseError<M>(method, response, payload)\n    }\n\n    // @NOTE redirect is set to 'follow', so we shouldn't get 3xx responses here\n    if (response.status < 200 || response.status >= 300) {\n      await response.body?.cancel()\n\n      throw new XrpcInvalidResponseError(\n        method,\n        response,\n        undefined,\n        `Unexpected status code ${response.status}`,\n      )\n    }\n\n    const payload = await readPayload(method, response, {\n      // Parse response if there is a schema, or if the encoding is\n      // \"application/json\"\n      parse:\n        method.output.schema || method.output.encoding === CONTENT_TYPE_JSON\n          ? { strict: options?.strictResponseProcessing ?? true }\n          : // If there is no declared output encoding, we'll parse the output (in loose mode)\n            method.output.encoding == null\n            ? { strict: false }\n            : false,\n    })\n\n    if (!method.output.matchesEncoding(payload?.encoding)) {\n      throw new XrpcInvalidResponseError(\n        method,\n        response,\n        payload,\n        `Expected ${stringifyEncoding(method.output.encoding)} response (got ${stringifyEncoding(payload?.encoding)})`,\n      )\n    }\n\n    // Response is successful (2xx). Validate payload (data and encoding) against schema.\n    if (method.output.encoding != null) {\n      // If the schema specifies an output, verify that the response properly\n      // matches the expected format (encoding and schema, if present). If no\n      // output is specified, any payload could be returned.\n\n      // Needed for type safety. Should never happen since matchesEncoding()\n      // should return not succeed if there is a schema encoding but no payload.\n      if (!payload) throw new Error('Expected payload')\n\n      // Assert valid response body.\n      if (method.output.schema && options?.validateResponse !== false) {\n        const result = method.output.schema.safeParse(payload.body, {\n          strict: options?.strictResponseProcessing ?? true,\n        })\n\n        if (!result.success) {\n          throw new XrpcResponseValidationError(\n            method,\n            response,\n            payload,\n            result.reason,\n          )\n        }\n\n        const parsedPayload = {\n          body: result.value,\n          encoding: payload.encoding,\n        } as XrpcResponsePayload<M>\n\n        return new XrpcResponse<M>(\n          method,\n          response.status,\n          response.headers,\n          parsedPayload,\n        )\n      }\n    }\n\n    return new XrpcResponse<M>(\n      method,\n      response.status,\n      response.headers,\n      payload as XrpcResponsePayload<M>,\n    )\n  }\n}\n\ntype ReadPayloadOptions = {\n  /**\n   * Whether to parse the response body as JSON and convert it to LexValue.\n   *\n   * @default false\n   */\n  parse?: false | LexParseOptions\n}\n\n/**\n * @note this function always consumes the response body\n */\nasync function readPayload(\n  method: Query | Procedure,\n  response: Response,\n  options?: ReadPayloadOptions,\n): Promise<undefined | XrpcUnknownResponsePayload> {\n  try {\n    // @TODO Should we limit the maximum response size here (this could also be\n    // done by the FetchHandler)?\n\n    const encoding = response.headers\n      .get('content-type')\n      ?.split(';')[0]\n      .trim()\n      .toLowerCase()\n\n    // Response content-type is undefined\n    if (!encoding) {\n      // If the body is empty, return undefined (= no payload)\n      const arrayBuffer = await response.arrayBuffer()\n      if (arrayBuffer.byteLength === 0) return undefined\n\n      // If we got data despite no content-type, treat it as binary\n      return {\n        encoding: CONTENT_TYPE_BINARY,\n        body: new Uint8Array(arrayBuffer),\n      }\n    }\n\n    if (!isEncodingString(encoding)) {\n      throw new TypeError(`Invalid content-type \"${encoding}\" in response`)\n    }\n\n    if (options?.parse && encoding === CONTENT_TYPE_JSON) {\n      // @NOTE See ./response.bench.ts to comparison of different parsing approaches.\n      const json = await response.json()\n      const body = jsonToLex(json, options.parse)\n      return { encoding, body }\n    }\n\n    const arrayBuffer = await response.arrayBuffer()\n    return { encoding, body: new Uint8Array(arrayBuffer) }\n  } catch (cause) {\n    const message = 'Unable to parse response payload'\n    const messageDetail = cause instanceof TypeError ? cause.message : undefined\n    throw new XrpcInvalidResponseError(\n      method,\n      response,\n      undefined,\n      messageDetail ? `${message}: ${messageDetail}` : message,\n      { cause },\n    )\n  }\n}\n\nfunction stringifyEncoding(encoding: string | undefined) {\n  return encoding ? `\"${encoding}\"` : 'no payload'\n}\n"]}

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import { DidString, LexValue, UnknownString } from '@atproto/lex-schema';
+import type { DidString, LexValue, UnknownString } from '@atproto/lex-schema';
 export type { DidString, LexValue, UnknownString };
 /**
  * Service identifier fragment for DID service endpoints.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;AAElD;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,aAAa,CAAA;AAEpE;;;;;;;;;GASG;AACH,MAAM,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,oBAAoB,EAAE,CAAA;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,IAAI,GACJ,UAAU,GACV,WAAW,GACX,cAAc,CAAC,UAAU,CAAC,GAC1B,aAAa,CAAC,UAAU,CAAC,CAAA;AAE7B,MAAM,MAAM,cAAc,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;AAElD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAClB,WAAW,IAAI,cAAc,CAE/B;AAED,MAAM,MAAM,0BAA0B,CACpC,OAAO,SAAS,cAAc,GAAG,UAAU,IACzC;IACF,QAAQ,EAAE,cAAc,CAAA;IACxB,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAA;CACzB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAE7E,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;AAElD;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,aAAa,CAAA;AAEpE;;;;;;;;;GASG;AACH,MAAM,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,oBAAoB,EAAE,CAAA;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,IAAI,GACJ,UAAU,GACV,WAAW,GACX,cAAc,CAAC,UAAU,CAAC,GAC1B,aAAa,CAAC,UAAU,CAAC,CAAA;AAE7B,MAAM,MAAM,cAAc,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;AAElD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAClB,WAAW,IAAI,cAAc,CAE/B;AAED,MAAM,MAAM,0BAA0B,CACpC,OAAO,SAAS,cAAc,GAAG,UAAU,IACzC;IACF,QAAQ,EAAE,cAAc,CAAA;IACxB,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAA;CACzB,CAAA"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA2DA,MAAM,UAAU,gBAAgB,CAC9B,WAAmB;IAEnB,OAAO,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAClC,CAAC","sourcesContent":["import { DidString, LexValue, UnknownString } from '@atproto/lex-schema'\n\nexport type { DidString, LexValue, UnknownString }\n\n/**\n * Service identifier fragment for DID service endpoints.\n *\n * Common values include 'atproto_labeler' for labeling services,\n * or custom service identifiers.\n */\nexport type DidServiceIdentifier = 'atproto_labeler' | UnknownString\n\n/**\n * A full service proxy identifier combining a DID with a service fragment.\n *\n * Used to route requests through a specific service endpoint.\n *\n * @example\n * ```typescript\n * const service: Service = 'did:web:api.bsky.app#bsky_appview'\n * ```\n */\nexport type Service = `${DidString}#${DidServiceIdentifier}`\n\n/**\n * Valid input types for binary request bodies.\n *\n * These types can be used as the body for procedures that expect\n * non-JSON content (e.g., blob uploads, binary data).\n *\n * @example Uploading a blob\n * ```typescript\n * const imageData: BinaryBodyInit = new Uint8Array(buffer)\n * await client.uploadBlob(imageData, { encoding: 'image/png' })\n * ```\n *\n * @example Streaming upload\n * ```typescript\n * const stream: BinaryBodyInit = someReadableStream\n * await client.xrpc(uploadMethod, { body: stream })\n * ```\n *\n * @example File upload in browser\n * ```typescript\n * const fileInput = document.querySelector('input[type=\"file\"]') as HTMLInputElement\n * const file: BinaryBodyInit = fileInput.files[0]\n * await client.xrpc(uploadMethod, { body: file })\n * ```\n */\nexport type BinaryBodyInit =\n  | string\n  | Blob\n  | Uint8Array\n  | ArrayBuffer\n  | ReadableStream<Uint8Array>\n  | AsyncIterable<Uint8Array>\n\nexport type EncodingString = `${string}/${string}`\n\nexport function isEncodingString(\n  contentType: string,\n): contentType is EncodingString {\n  return contentType.includes('/')\n}\n\nexport type XrpcUnknownResponsePayload<\n  TBinary extends BinaryBodyInit = Uint8Array,\n> = {\n  encoding: EncodingString\n  body: LexValue | TBinary\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA2DA,MAAM,UAAU,gBAAgB,CAC9B,WAAmB;IAEnB,OAAO,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAClC,CAAC","sourcesContent":["import type { DidString, LexValue, UnknownString } from '@atproto/lex-schema'\n\nexport type { DidString, LexValue, UnknownString }\n\n/**\n * Service identifier fragment for DID service endpoints.\n *\n * Common values include 'atproto_labeler' for labeling services,\n * or custom service identifiers.\n */\nexport type DidServiceIdentifier = 'atproto_labeler' | UnknownString\n\n/**\n * A full service proxy identifier combining a DID with a service fragment.\n *\n * Used to route requests through a specific service endpoint.\n *\n * @example\n * ```typescript\n * const service: Service = 'did:web:api.bsky.app#bsky_appview'\n * ```\n */\nexport type Service = `${DidString}#${DidServiceIdentifier}`\n\n/**\n * Valid input types for binary request bodies.\n *\n * These types can be used as the body for procedures that expect\n * non-JSON content (e.g., blob uploads, binary data).\n *\n * @example Uploading a blob\n * ```typescript\n * const imageData: BinaryBodyInit = new Uint8Array(buffer)\n * await client.uploadBlob(imageData, { encoding: 'image/png' })\n * ```\n *\n * @example Streaming upload\n * ```typescript\n * const stream: BinaryBodyInit = someReadableStream\n * await client.xrpc(uploadMethod, { body: stream })\n * ```\n *\n * @example File upload in browser\n * ```typescript\n * const fileInput = document.querySelector('input[type=\"file\"]') as HTMLInputElement\n * const file: BinaryBodyInit = fileInput.files[0]\n * await client.xrpc(uploadMethod, { body: file })\n * ```\n */\nexport type BinaryBodyInit =\n  | string\n  | Blob\n  | Uint8Array\n  | ArrayBuffer\n  | ReadableStream<Uint8Array>\n  | AsyncIterable<Uint8Array>\n\nexport type EncodingString = `${string}/${string}`\n\nexport function isEncodingString(\n  contentType: string,\n): contentType is EncodingString {\n  return contentType.includes('/')\n}\n\nexport type XrpcUnknownResponsePayload<\n  TBinary extends BinaryBodyInit = Uint8Array,\n> = {\n  encoding: EncodingString\n  body: LexValue | TBinary\n}\n"]}

package/dist/util.d.ts

@@ -1,5 +1,6 @@
-import { InferRecordKey, LexiconRecordKey, RecordSchema } from '@atproto/lex-schema';
-import type { DidString, Service } from './types.js';
+import type { InferRecordKey, LexiconRecordKey } from '@atproto/lex-schema';
+import { RecordSchema } from '@atproto/lex-schema';
+import type { DidString, Service } from './types.ts';
 export declare function applyDefaults<TDefaults extends Record<string, unknown>, TOptions extends {
     [K in keyof TDefaults]?: TDefaults[K];
 }>(options: TOptions, defaults: TDefaults): TOptions & TDefaults;
@@ -43,4 +44,7 @@ export type RecordKeyOptions<T extends RecordSchema, AlsoOptionalWhenRecordKeyIs
 };
 export declare function getDefaultRecordKey<const T extends RecordSchema>(schema: T): undefined | InferRecordKey<T>;
 export declare function getLiteralRecordKey<const T extends RecordSchema>(schema: T): InferRecordKey<T>;
+export declare function wait(ms: number, { signal }?: {
+    signal?: AbortSignal;
+}): Promise<void>;
 //# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACb,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEpD,wBAAgB,aAAa,CAC3B,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,QAAQ,SAAS;KACd,CAAC,IAAI,MAAM,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;CACtC,EACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAY9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAexD;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,CAAC,GACP,KAAK,IAAI,OAAO,SAAS,CAAC,GACzB,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,GAC1B,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAIjC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,GAChB,UAAU,CAAC,WAAW,CAAC,CASzB;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,yDAAyD;IACzD,OAAO,CAAC,EAAE,WAAW,CAAA;IAErB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAA;IAE9B,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAiBT;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC,GAC9B,cAAc,CAAC,UAAU,CAAC,CAU5B;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC,GAC9B,cAAc,CAAC,UAAU,CAAC,CAmB5B;AAED,MAAM,MAAM,gBAAgB,CAC1B,CAAC,SAAS,YAAY,EACtB,2BAA2B,SAAS,gBAAgB,GAAG,KAAK,IAC1D,CAAC,CAAC,KAAK,CAAC,SAAS,WAAW,MAAM,EAAE,GAAG,2BAA2B,GAClE;IAAE,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;CAAE,CAAA;AAE/B,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC9D,MAAM,EAAE,CAAC,GACR,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,CAM/B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC9D,MAAM,EAAE,CAAC,GACR,cAAc,CAAC,CAAC,CAAC,CAQnB"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEpD,wBAAgB,aAAa,CAC3B,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,QAAQ,SAAS;KACd,CAAC,IAAI,MAAM,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;CACtC,EACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAY9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAexD;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,CAAC,GACP,KAAK,IAAI,OAAO,SAAS,CAAC,GACzB,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,GAC1B,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAIjC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,GAChB,UAAU,CAAC,WAAW,CAAC,CASzB;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,yDAAyD;IACzD,OAAO,CAAC,EAAE,WAAW,CAAA;IAErB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAA;IAE9B,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAiBT;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC,GAC9B,cAAc,CAAC,UAAU,CAAC,CAU5B;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC,GAC9B,cAAc,CAAC,UAAU,CAAC,CAmB5B;AAED,MAAM,MAAM,gBAAgB,CAC1B,CAAC,SAAS,YAAY,EACtB,2BAA2B,SAAS,gBAAgB,GAAG,KAAK,IAC1D,CAAC,CAAC,KAAK,CAAC,SAAS,WAAW,MAAM,EAAE,GAAG,2BAA2B,GAClE;IAAE,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;CAAE,CAAA;AAE/B,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC9D,MAAM,EAAE,CAAC,GACR,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,CAM/B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC9D,MAAM,EAAE,CAAC,GACR,cAAc,CAAC,CAAC,CAAC,CAQnB;AAED,wBAAgB,IAAI,CAClB,EAAE,EAAE,MAAM,EACV,EAAE,MAAM,EAAE,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACxC,OAAO,CAAC,IAAI,CAAC,CA4Bf"}