@atproto/lex-client 0.0.13 → 0.0.14

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @atproto/lex-client
 
+## 0.0.14
+
+### Patch Changes
+
+- [#4672](https://github.com/bluesky-social/atproto/pull/4672) [`38852f0`](https://github.com/bluesky-social/atproto/commit/38852f0ddfa9fbce8036233dc6af87614e9ae4b2) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Allow calling `xrpc` and `xrpcSafe` functions with a service URL
+
 ## 0.0.13
 
 ### Patch Changes

package/dist/agent.d.ts

@@ -4,7 +4,7 @@ import { DidString } from '@atproto/lex-schema';
  *
  * The handler is responsible for adding the origin (protocol, hostname, and
  * port) to the provided path, typically based on authentication or service
- * configuration. The handler are also responsible for adding any necessary
+ * configuration. The handler can also be responsible for adding any necessary
  * headers, such as authorization tokens.
  *
  * @param path - The URL path (pathname + query parameters) without the origin
@@ -17,13 +17,20 @@ export type FetchHandler = (
  * origin. The origin (protocol, hostname, and port) must be added by this
  * {@link FetchHandler}, typically based on authentication or other factors.
  */
-path: string, init: RequestInit) => Promise<Response>;
+path: `/${string}`, init: RequestInit) => Promise<Response>;
 /**
- * Core interface for making XRPC requests.
+ * Core interface for making XRPC requests towards a specific service.
  *
- * An Agent encapsulates an identity and request handling for AT Protocol
- * operations. It can represent an authenticated user session or an
- * unauthenticated service client.
+ * An {@link Agent} encapsulates an identity and request handling for AT
+ * Protocol operations. Agents will typically handle authentication, service URL
+ * resolution, and other request configuration, allowing client code to make
+ * requests without needing to manage these details directly. The key component
+ * of an Agent is the {@link FetchHandler}, which is responsible for
+ * constructing the full request URL and adding any necessary headers or
+ * authentication tokens. The Agent's `did` property represents the
+ * authenticated user's DID, if available, and can be used for operations that
+ * require knowledge of the user's identity (such as creating AT Protocol
+ * records).
  *
  * @see {@link buildAgent} for creating (simple) Agent instances.
  *
@@ -31,7 +38,10 @@ path: string, init: RequestInit) => Promise<Response>;
  * ```typescript
  * const agent: Agent = {
  *   did: 'did:plc:example123',
- *   fetchHandler: (path, init) => fetch(new URL(path, 'https://bsky.social'), init)
+ *   fetchHandler: async (path, init) => {
+ *     const url = new URL(path, 'https://bsky.social')
+ *     return fetch(url, init)
+ *   }
  * }
  * ```
  */
@@ -41,6 +51,7 @@ export interface Agent {
     /** The fetch handler used to make HTTP requests. */
     fetchHandler: FetchHandler;
 }
+export declare function isAgent(value: unknown): value is Agent;
 export type AgentConfig = {
     /**
      * The identifier (DID) of the user represented by this agent.
@@ -74,20 +85,20 @@ export type AgentOptions = AgentConfig | string | URL;
 /**
  * Creates an {@link Agent} from various input types.
  *
- * This factory function accepts an existing Agent (returned as-is), a service URL,
- * or a full configuration object. It handles the common case of creating an
- * unauthenticated agent from just a service URL.
+ * This factory function accepts an existing Agent (returned as-is), a service
+ * URL, or a full configuration object. It handles the common case of creating
+ * an unauthenticated agent from just a service URL.
  *
  * @param options - Agent instance, configuration object, or service URL
  * @returns A configured Agent ready for making requests
  * @throws {TypeError} If fetch() is not available in the environment
  *
- * @example From URL string
+ * @example // From URL string
  * ```typescript
  * const agent = buildAgent('https://public.api.bsky.app')
  * ```
  *
- * @example From configuration
+ * @example // From configuration
  * ```typescript
  * const agent = buildAgent({
  *   did: 'did:plc:example',
@@ -95,12 +106,6 @@ export type AgentOptions = AgentConfig | string | URL;
  *   headers: { 'Authorization': 'Bearer ...' }
  * })
  * ```
- *
- * @example Pass-through existing agent
- * ```typescript
- * const existing: Agent = { ... }
- * const agent = buildAgent(existing) // Returns existing unchanged
- * ```
  */
-export declare function buildAgent(options: Agent | AgentOptions): Agent;
+export declare function buildAgent<O extends Agent | AgentOptions>(options: O): O extends Agent ? O : Agent;
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAE/C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG;AACzB;;;;GAIG;AACH,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEtB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,KAAK;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAA;IACxB,oDAAoD;IACpD,YAAY,EAAE,YAAY,CAAA;CAC3B;AAED,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,GAAG,CAAC,EAAE,SAAS,CAAA;IAEf;;;;OAIG;IACH,OAAO,EAAE,MAAM,GAAG,GAAG,CAAA;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAA;IAErB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,MAAM,GAAG,GAAG,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,KAAK,GAAG,YAAY,GAAG,KAAK,CAiC/D"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAE/C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG;AACzB;;;;GAIG;AACH,IAAI,EAAE,IAAI,MAAM,EAAE,EAClB,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,KAAK;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAA;IACxB,oDAAoD;IACpD,YAAY,EAAE,YAAY,CAAA;CAC3B;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAUtD;AAED,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,GAAG,CAAC,EAAE,SAAS,CAAA;IAEf;;;;OAIG;IACH,OAAO,EAAE,MAAM,GAAG,GAAG,CAAA;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAA;IAErB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,MAAM,GAAG,GAAG,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,KAAK,GAAG,YAAY,EACvD,OAAO,EAAE,CAAC,GACT,CAAC,SAAS,KAAK,GAAG,CAAC,GAAG,KAAK,CAAA"}

package/dist/agent.js

@@ -1,41 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAgent = isAgent;
 exports.buildAgent = buildAgent;
-/**
- * Creates an {@link Agent} from various input types.
- *
- * This factory function accepts an existing Agent (returned as-is), a service URL,
- * or a full configuration object. It handles the common case of creating an
- * unauthenticated agent from just a service URL.
- *
- * @param options - Agent instance, configuration object, or service URL
- * @returns A configured Agent ready for making requests
- * @throws {TypeError} If fetch() is not available in the environment
- *
- * @example From URL string
- * ```typescript
- * const agent = buildAgent('https://public.api.bsky.app')
- * ```
- *
- * @example From configuration
- * ```typescript
- * const agent = buildAgent({
- *   did: 'did:plc:example',
- *   service: 'https://bsky.social',
- *   headers: { 'Authorization': 'Bearer ...' }
- * })
- * ```
- *
- * @example Pass-through existing agent
- * ```typescript
- * const existing: Agent = { ... }
- * const agent = buildAgent(existing) // Returns existing unchanged
- * ```
- */
+function isAgent(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'fetchHandler' in value &&
+        typeof value.fetchHandler === 'function' &&
+        (!('did' in value) ||
+            value.did === undefined ||
+            typeof value.did === 'string'));
+}
 function buildAgent(options) {
-    if (typeof options === 'object' && 'fetchHandler' in options) {
+    if (isAgent(options))
         return options;
-    }
     const config = typeof options === 'string' || options instanceof URL
         ? { did: undefined, service: options }
         : options;

package/dist/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":";;AAkHA,gCAiCC;AAhED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,SAAgB,UAAU,CAAC,OAA6B;IACtD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,cAAc,IAAI,OAAO,EAAE,CAAC;QAC7D,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,MAAM,MAAM,GACV,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,YAAY,GAAG;QACnD,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE;QACtC,CAAC,CAAC,OAAO,CAAA;IAEb,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,MAAM,CAAA;IAEpD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAA;IACrE,CAAC;IAED,OAAO;QACL,IAAI,GAAG;YACL,OAAO,MAAM,CAAC,GAAG,CAAA;QACnB,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI;YAC3B,MAAM,OAAO,GACX,MAAM,CAAC,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI;gBAC5C,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC;gBAC5C,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAA;YAEpC,OAAO,KAAK,CACV,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,EACtB,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CACvD,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CACnB,cAA2B,EAC3B,cAA2B;IAE3B,8EAA8E;IAC9E,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,CAAA;IAE1C,MAAM,SAAS,GACb,cAAc,YAAY,OAAO;QAC/B,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,IAAI,OAAO,CAAC,cAAc,CAAC,CAAA;IAEjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import { DidString } from '@atproto/lex-schema'\n\n/**\n * A function that performs HTTP requests towards a service endpoint.\n *\n * The handler is responsible for adding the origin (protocol, hostname, and\n * port) to the provided path, typically based on authentication or service\n * configuration. The handler are also responsible for adding any necessary\n * headers, such as authorization tokens.\n *\n * @param path - The URL path (pathname + query parameters) without the origin\n * @param init - Standard fetch RequestInit options\n * @returns A Promise resolving to the HTTP Response\n */\nexport type FetchHandler = (\n  /**\n   * The URL (pathname + query parameters) to make the request to, without the\n   * origin. The origin (protocol, hostname, and port) must be added by this\n   * {@link FetchHandler}, typically based on authentication or other factors.\n   */\n  path: string,\n  init: RequestInit,\n) => Promise<Response>\n\n/**\n * Core interface for making XRPC requests.\n *\n * An Agent encapsulates an identity and request handling for AT Protocol\n * operations. It can represent an authenticated user session or an\n * unauthenticated service client.\n *\n * @see {@link buildAgent} for creating (simple) Agent instances.\n *\n * @example\n * ```typescript\n * const agent: Agent = {\n *   did: 'did:plc:example123',\n *   fetchHandler: (path, init) => fetch(new URL(path, 'https://bsky.social'), init)\n * }\n * ```\n */\nexport interface Agent {\n  /** The DID of the authenticated user, or `undefined` if unauthenticated. */\n  readonly did?: DidString\n  /** The fetch handler used to make HTTP requests. */\n  fetchHandler: FetchHandler\n}\n\nexport type AgentConfig = {\n  /**\n   * The identifier (DID) of the user represented by this agent.\n   */\n  did?: DidString\n\n  /**\n   * The service URL to make requests to. This can be a string, URL, or a\n   * function that returns a string or URL. This is useful for dynamic URLs,\n   * such as a service URL that changes based on authentication.\n   */\n  service: string | URL\n\n  /**\n   * Optional headers to include with every request made by this agent, unless\n   * overridden by the request-specific headers provided to the fetch handler.\n   */\n  headers?: HeadersInit\n\n  /**\n   * Bring your own fetch implementation. Typically useful for testing, logging,\n   * mocking, or adding retries, session management, signatures, proof of\n   * possession (DPoP), SSRF protection, etc. Defaults to the global `fetch`\n   * function.\n   */\n  fetch?: typeof globalThis.fetch\n}\n\n/**\n * Options for creating an Agent.\n *\n * Can be a full {@link AgentConfig} object, or a simple service URL string/{@link URL}.\n */\nexport type AgentOptions = AgentConfig | string | URL\n\n/**\n * Creates an {@link Agent} from various input types.\n *\n * This factory function accepts an existing Agent (returned as-is), a service URL,\n * or a full configuration object. It handles the common case of creating an\n * unauthenticated agent from just a service URL.\n *\n * @param options - Agent instance, configuration object, or service URL\n * @returns A configured Agent ready for making requests\n * @throws {TypeError} If fetch() is not available in the environment\n *\n * @example From URL string\n * ```typescript\n * const agent = buildAgent('https://public.api.bsky.app')\n * ```\n *\n * @example From configuration\n * ```typescript\n * const agent = buildAgent({\n *   did: 'did:plc:example',\n *   service: 'https://bsky.social',\n *   headers: { 'Authorization': 'Bearer ...' }\n * })\n * ```\n *\n * @example Pass-through existing agent\n * ```typescript\n * const existing: Agent = { ... }\n * const agent = buildAgent(existing) // Returns existing unchanged\n * ```\n */\nexport function buildAgent(options: Agent | AgentOptions): Agent {\n  if (typeof options === 'object' && 'fetchHandler' in options) {\n    return options\n  }\n\n  const config: Agent | AgentConfig =\n    typeof options === 'string' || options instanceof URL\n      ? { did: undefined, service: options }\n      : options\n\n  const { service, fetch = globalThis.fetch } = config\n\n  if (typeof fetch !== 'function') {\n    throw new TypeError('fetch() is not available in this environment')\n  }\n\n  return {\n    get did() {\n      return config.did\n    },\n\n    async fetchHandler(path, init) {\n      const headers =\n        config.headers != null && init.headers != null\n          ? mergeHeaders(config.headers, init.headers)\n          : config.headers || init.headers\n\n      return fetch(\n        new URL(path, service),\n        headers !== init.headers ? { ...init, headers } : init,\n      )\n    },\n  }\n}\n\nfunction mergeHeaders(\n  defaultHeaders: HeadersInit,\n  requestHeaders: HeadersInit,\n): Headers {\n  // We don't want to alter the original Headers objects, so we create a new one\n  const result = new Headers(defaultHeaders)\n\n  const overrides =\n    requestHeaders instanceof Headers\n      ? requestHeaders\n      : new Headers(requestHeaders)\n\n  for (const [key, value] of overrides.entries()) {\n    result.set(key, value)\n  }\n\n  return result\n}\n"]}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":";;AA0DA,0BAUC;AAiED,gCA+BC;AA1GD,SAAgB,OAAO,CAAC,KAAc;IACpC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,cAAc,IAAI,KAAK;QACvB,OAAO,KAAK,CAAC,YAAY,KAAK,UAAU;QACxC,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC;YAChB,KAAK,CAAC,GAAG,KAAK,SAAS;YACvB,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CACjC,CAAA;AACH,CAAC;AAiED,SAAgB,UAAU,CAAC,OAA6B;IACtD,IAAI,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IAEpC,MAAM,MAAM,GACV,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,YAAY,GAAG;QACnD,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE;QACtC,CAAC,CAAC,OAAO,CAAA;IAEb,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,MAAM,CAAA;IAEpD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAA;IACrE,CAAC;IAED,OAAO;QACL,IAAI,GAAG;YACL,OAAO,MAAM,CAAC,GAAG,CAAA;QACnB,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI;YAC3B,MAAM,OAAO,GACX,MAAM,CAAC,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI;gBAC5C,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC;gBAC5C,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAA;YAEpC,OAAO,KAAK,CACV,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,EACtB,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CACvD,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CACnB,cAA2B,EAC3B,cAA2B;IAE3B,8EAA8E;IAC9E,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,CAAA;IAE1C,MAAM,SAAS,GACb,cAAc,YAAY,OAAO;QAC/B,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,IAAI,OAAO,CAAC,cAAc,CAAC,CAAA;IAEjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import { DidString } from '@atproto/lex-schema'\n\n/**\n * A function that performs HTTP requests towards a service endpoint.\n *\n * The handler is responsible for adding the origin (protocol, hostname, and\n * port) to the provided path, typically based on authentication or service\n * configuration. The handler can also be responsible for adding any necessary\n * headers, such as authorization tokens.\n *\n * @param path - The URL path (pathname + query parameters) without the origin\n * @param init - Standard fetch RequestInit options\n * @returns A Promise resolving to the HTTP Response\n */\nexport type FetchHandler = (\n  /**\n   * The URL (pathname + query parameters) to make the request to, without the\n   * origin. The origin (protocol, hostname, and port) must be added by this\n   * {@link FetchHandler}, typically based on authentication or other factors.\n   */\n  path: `/${string}`,\n  init: RequestInit,\n) => Promise<Response>\n\n/**\n * Core interface for making XRPC requests towards a specific service.\n *\n * An {@link Agent} encapsulates an identity and request handling for AT\n * Protocol operations. Agents will typically handle authentication, service URL\n * resolution, and other request configuration, allowing client code to make\n * requests without needing to manage these details directly. The key component\n * of an Agent is the {@link FetchHandler}, which is responsible for\n * constructing the full request URL and adding any necessary headers or\n * authentication tokens. The Agent's `did` property represents the\n * authenticated user's DID, if available, and can be used for operations that\n * require knowledge of the user's identity (such as creating AT Protocol\n * records).\n *\n * @see {@link buildAgent} for creating (simple) Agent instances.\n *\n * @example\n * ```typescript\n * const agent: Agent = {\n *   did: 'did:plc:example123',\n *   fetchHandler: async (path, init) => {\n *     const url = new URL(path, 'https://bsky.social')\n *     return fetch(url, init)\n *   }\n * }\n * ```\n */\nexport interface Agent {\n  /** The DID of the authenticated user, or `undefined` if unauthenticated. */\n  readonly did?: DidString\n  /** The fetch handler used to make HTTP requests. */\n  fetchHandler: FetchHandler\n}\n\nexport function isAgent(value: unknown): value is Agent {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'fetchHandler' in value &&\n    typeof value.fetchHandler === 'function' &&\n    (!('did' in value) ||\n      value.did === undefined ||\n      typeof value.did === 'string')\n  )\n}\n\nexport type AgentConfig = {\n  /**\n   * The identifier (DID) of the user represented by this agent.\n   */\n  did?: DidString\n\n  /**\n   * The service URL to make requests to. This can be a string, URL, or a\n   * function that returns a string or URL. This is useful for dynamic URLs,\n   * such as a service URL that changes based on authentication.\n   */\n  service: string | URL\n\n  /**\n   * Optional headers to include with every request made by this agent, unless\n   * overridden by the request-specific headers provided to the fetch handler.\n   */\n  headers?: HeadersInit\n\n  /**\n   * Bring your own fetch implementation. Typically useful for testing, logging,\n   * mocking, or adding retries, session management, signatures, proof of\n   * possession (DPoP), SSRF protection, etc. Defaults to the global `fetch`\n   * function.\n   */\n  fetch?: typeof globalThis.fetch\n}\n\n/**\n * Options for creating an Agent.\n *\n * Can be a full {@link AgentConfig} object, or a simple service URL string/{@link URL}.\n */\nexport type AgentOptions = AgentConfig | string | URL\n\n/**\n * Creates an {@link Agent} from various input types.\n *\n * This factory function accepts an existing Agent (returned as-is), a service\n * URL, or a full configuration object. It handles the common case of creating\n * an unauthenticated agent from just a service URL.\n *\n * @param options - Agent instance, configuration object, or service URL\n * @returns A configured Agent ready for making requests\n * @throws {TypeError} If fetch() is not available in the environment\n *\n * @example // From URL string\n * ```typescript\n * const agent = buildAgent('https://public.api.bsky.app')\n * ```\n *\n * @example // From configuration\n * ```typescript\n * const agent = buildAgent({\n *   did: 'did:plc:example',\n *   service: 'https://bsky.social',\n *   headers: { 'Authorization': 'Bearer ...' }\n * })\n * ```\n */\nexport function buildAgent<O extends Agent | AgentOptions>(\n  options: O,\n): O extends Agent ? O : Agent\nexport function buildAgent(options: Agent | AgentOptions): Agent {\n  if (isAgent(options)) return options\n\n  const config: Agent | AgentConfig =\n    typeof options === 'string' || options instanceof URL\n      ? { did: undefined, service: options }\n      : options\n\n  const { service, fetch = globalThis.fetch } = config\n\n  if (typeof fetch !== 'function') {\n    throw new TypeError('fetch() is not available in this environment')\n  }\n\n  return {\n    get did() {\n      return config.did\n    },\n\n    async fetchHandler(path, init) {\n      const headers =\n        config.headers != null && init.headers != null\n          ? mergeHeaders(config.headers, init.headers)\n          : config.headers || init.headers\n\n      return fetch(\n        new URL(path, service),\n        headers !== init.headers ? { ...init, headers } : init,\n      )\n    },\n  }\n}\n\nfunction mergeHeaders(\n  defaultHeaders: HeadersInit,\n  requestHeaders: HeadersInit,\n): Headers {\n  // We don't want to alter the original Headers objects, so we create a new one\n  const result = new Headers(defaultHeaders)\n\n  const overrides =\n    requestHeaders instanceof Headers\n      ? requestHeaders\n      : new Headers(requestHeaders)\n\n  for (const [key, value] of overrides.entries()) {\n    result.set(key, value)\n  }\n\n  return result\n}\n"]}

package/dist/client.d.ts

@@ -194,11 +194,12 @@ export type ListRecord<Value extends LexMap> = com.atproto.repo.listRecords.Reco
  * services. It provides type-safe methods for XRPC calls, record operations,
  * and blob handling.
  *
- * @example Basic usage
+ * @example // Basic usage
  * ```typescript
  * import { Client } from '@atproto/lex'
  *
- * const client = new Client(agent)
+ * const client = new Client(oauthSession)
+ *
  * const response = await client.xrpc(app.bsky.feed.getTimeline.main, {
  *   params: { limit: 50 }
  * })
@@ -261,11 +262,15 @@ export declare class Client implements Agent {
      */
     clearLabelers(): void;
     /**
-     * Low-level fetch handler for making requests.
+     * {@link Agent}'s {@link Agent.fetchHandler} implementation, which adds
+     * labelers and service proxying headers. This method allow a {@link Client}
+     * instance to be used directly as an {@link Agent} for another
+     * {@link Client}, enabling composition of headers (labelers, proxying, etc.).
+     *
      * @param path - The request path
      * @param init - Request initialization options
      */
-    fetchHandler(path: string, init: RequestInit): Promise<Response>;
+    fetchHandler(path: `/${string}`, init: RequestInit): Promise<Response>;
     /**
      * Makes an XRPC request. Throws on failure.
      *

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC3E,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,KAAK,EACL,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,MAAM,EACN,SAAS,EACT,KAAK,EACL,YAAY,EACZ,UAAU,EAEX,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,KAAK,EAAE,YAAY,EAAc,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEjE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAkB,MAAM,WAAW,CAAA;AAE1E,YAAY,EACV,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,KAAK,EACL,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,MAAM,EACN,QAAQ,EACR,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,MAAM,EACN,SAAS,EACT,KAAK,EACL,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC9B,qEAAqE;IACrE,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,IAAI,CACrC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,WAAW,KACjB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAEnB;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAC3C,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAE5C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,IAC5C,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAE5C;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAC9C,mFAAmF;IACnF,IAAI,CAAC,EAAE,kBAAkB,CAAA;IACzB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAC9C,mFAAmF;IACnF,IAAI,CAAC,EAAE,kBAAkB,CAAA;IACzB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAC3C,mFAAmF;IACnF,IAAI,CAAC,EAAE,kBAAkB,CAAA;CAC1B,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAC3C,mFAAmF;IACnF,IAAI,CAAC,EAAE,kBAAkB,CAAA;IACzB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG;IAC7C,mFAAmF;IACnF,IAAI,CAAC,EAAE,kBAAkB,CAAA;IACzB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;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;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,YAAY,IAAI,mBAAmB,GACrE,gBAAgB,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,CAAA;AAEpC;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,qBAAqB,CAC9C,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EACzC,UAAU,CACX,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,YAAY,IAAI,mBAAmB,GACrE,gBAAgB,CAAC,CAAC,CAAC,CAAA;AAErB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,qBAAqB,CAC9C,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EACzC,UAAU,CACX,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,YAAY,IAAI,gBAAgB,GAC/D,gBAAgB,CAAC,CAAC,CAAC,CAAA;AAErB;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,YAAY,IAAI,IAAI,CAClD,qBAAqB,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,EACzE,OAAO,CACR,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;CAAE,CAAA;AAEvB;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,YAAY,IAAI,gBAAgB,GAC/D,gBAAgB,CAAC,CAAC,CAAC,CAAA;AAErB;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,qBAAqB,CAC3C,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EACtC,UAAU,CACX,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,kBAAkB,CAAA;AAE5C;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,YAAY,IAAI,qBAAqB,CACpE,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EACxC,UAAU,CACX,GAAG;IACF,8DAA8D;IAC9D,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAI/B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,KAAK,SAAS,MAAM,IACzC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG;IACpC,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAEH;;;;;;;;;;;;;;GAcG;AACH,qBAAa,MAAO,YAAW,KAAK;IAClC,MAAM,CAAC,WAAW,EAAE,SAAS,SAAS,EAAE,CAAK;IAE7C;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAA;KAAE;IAI5D,qDAAqD;IACrD,SAAgB,KAAK,EAAE,KAAK,CAAA;IAE5B,+CAA+C;IAC/C,SAAgB,OAAO,EAAE,OAAO,CAAA;IAEhC,wDAAwD;IACxD,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjC,4DAA4D;IAC5D,SAAgB,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;gBAE5B,KAAK,EAAE,KAAK,GAAG,YAAY,EAAE,OAAO,GAAE,aAAkB;IAOpE;;OAEG;IACH,IAAI,GAAG,IAAI,SAAS,GAAG,SAAS,CAE/B;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,SAAS,CAGzB;IAED;;;;;;;;;;;;OAYG;IACI,mBAAmB,IAAI,OAAO,CAAC,IAAI,IAAI;QAAE,GAAG,EAAE,SAAS,CAAA;KAAE;IAIhE;;;OAGG;IACI,WAAW,CAAC,QAAQ,GAAE,QAAQ,CAAC,SAAS,CAAM;IAKrD;;;OAGG;IACI,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC;IAIhD;;OAEG;IACI,aAAa;IAIpB;;;;OAIG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAqBvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,KAAK,GAAG,SAAS,EAC1C,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,GAC3C,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,iDAAiD,CAAC,GAChE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,KAAK,GAAG,SAAS,EAC1C,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAQ3B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,KAAK,GAAG,SAAS,EAC9C,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,GAC3C,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,iDAAiD,CAAC,GAChE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,KAAK,GAAG,SAAS,EAC9C,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAQ5C;;;;;;;;;;;;;;;;;;;OAmBG;IACU,YAAY,CACvB,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAe/B;;;;;;;;OAQG;IACG,YAAY,CAChB,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;IAc/B;;;;;;;;OAQG;IACU,SAAS,CACpB,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;IAY5B;;;;;;;;OAQG;IACG,SAAS,CACb,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgB5B;;;;;;;OAOG;IACG,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,kBAAkB;;;;;;;;;;;;;;IAahE;;;;;;;;;;;;;;;OAeG;IACG,UAAU,CACd,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,WAAW,GAAG;QAAE,QAAQ,CAAC,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;KAAE;;;;;IAQ9D;;;;;;OAMG;IACG,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,WAAW;;;;;;;;IAOnE;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACU,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,KAAK,EACrC,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,iBAAiB,CAAC,CAAC,CAAC,GACjD,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,8CAA8C,CAAC,GAC7D,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,EACzC,EAAE,EAAE,SAAS,SAAS,oBAAoB,CAAC,CAAC,EAAE,UAAU,CAAC,GACrD,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,kDAAkD,CAAC,GACjE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACtC,EAAE,EAAE,IAAI,SAAS,gBAAgB,CAAC,CAAC,CAAC,GAChC,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,+CAA+C,CAAC,GAC9D,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACnB,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,GAAG,KAAK,EAC1D,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,GAAG,EAAE,CAAC,SAAS,MAAM,GACjB,gBAAgB,CAAC,CAAC,CAAC,GACnB,CAAC,SAAS,SAAS,GACjB,oBAAoB,CAAC,CAAC,EAAE,UAAU,CAAC,GACnC,CAAC,SAAS,KAAK,GACb,iBAAiB,CAAC,CAAC,CAAC,GACpB,KAAK,EACb,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CACR,CAAC,SAAS,MAAM,GACZ,iBAAiB,CAAC,CAAC,CAAC,GACpB,CAAC,SAAS,SAAS,GACjB,gBAAgB,CAAC,CAAC,CAAC,GACnB,CAAC,SAAS,KAAK,GACb,gBAAgB,CAAC,CAAC,CAAC,GACnB,KAAK,CACd;IAuBD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACU,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC9C,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,GAC7C,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,iDAAiD,CAAC,EACjE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,YAAY,CAAC;IACX,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC9C,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,YAAY,CAAC;IAcxB;;;;;;OAMG;IACU,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC9C,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,GAC7C,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,iDAAiD,CAAC,GAChE,OAAO,CAAC,YAAY,CAAC;IACX,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC9C,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,YAAY,CAAC;IAaxB;;;;;;;;;;;;;OAaG;IACU,GAAG,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC3C,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,WAAW,MAAM,EAAE,GACpC,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,iDAAiD,CAAC,GAChE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACX,GAAG,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC3C,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAcxB;;;;;;;OAOG;IACU,GAAG,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC3C,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,GAC1C,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,iDAAiD,CAAC,EACjE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,SAAS,CAAC;IACR,GAAG,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAC3C,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,SAAS,CAAC;IAarB;;;;;;;;;;;;;OAaG;IACG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EACrC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAkB1B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -12,11 +12,12 @@ const xrpc_js_1 = require("./xrpc.js");
  * services. It provides type-safe methods for XRPC calls, record operations,
  * and blob handling.
  *
- * @example Basic usage
+ * @example // Basic usage
  * ```typescript
  * import { Client } from '@atproto/lex'
  *
- * const client = new Client(agent)
+ * const client = new Client(oauthSession)
+ *
  * const response = await client.xrpc(app.bsky.feed.getTimeline.main, {
  *   params: { limit: 50 }
  * })
@@ -99,7 +100,11 @@ class Client {
         this.labelers.clear();
     }
     /**
-     * Low-level fetch handler for making requests.
+     * {@link Agent}'s {@link Agent.fetchHandler} implementation, which adds
+     * labelers and service proxying headers. This method allow a {@link Client}
+     * instance to be used directly as an {@link Agent} for another
+     * {@link Client}, enabling composition of headers (labelers, proxying, etc.).
+     *
      * @param path - The request path
      * @param init - Request initialization options
      */

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 { LexError, LexMap, LexValue, TypedLexMap } from '@atproto/lex-data'\nimport {\n  AtIdentifierString,\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'\nimport { com } from './lexicons/index.js'\nimport { XrpcResponse, XrpcResponseBody } from './response.js'\nimport { BinaryBodyInit, CallOptions, Service } from './types.js'\nimport { buildAtprotoHeaders } from './util.js'\nimport { XrpcOptions, XrpcRequestParams, xrpc, xrpcSafe } from './xrpc.js'\n\nexport type {\n  AtIdentifierString,\n  CidString,\n  DidString,\n  Infer,\n  InferMethodInputBody,\n  InferMethodOutputBody,\n  InferRecordKey,\n  LexMap,\n  LexValue,\n  LexiconRecordKey,\n  Main,\n  NsidString,\n  Params,\n  Procedure,\n  Query,\n  RecordSchema,\n  Restricted,\n  TypedLexMap,\n}\n\n/**\n * Configuration options for creating a {@link Client}.\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 * }\n * ```\n */\nexport type ClientOptions = {\n  /** Labeler DIDs to include in requests for content moderation. */\n  labelers?: Iterable<DidString>\n  /** Custom headers to include in all requests made by this client. */\n  headers?: HeadersInit\n  /** Service proxy identifier for routing requests through a specific service. */\n  service?: Service\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: CallOptions,\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 = CallOptions & {\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  /** Whether to validate the record against its lexicon schema. */\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 = CallOptions & {\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 = CallOptions & {\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 = CallOptions & {\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  /** Whether to validate the record against its lexicon schema. */\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 = CallOptions & {\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\nexport type RecordKeyOptions<\n  T extends RecordSchema,\n  AlsoOptionalWhenRecordKeyIs extends LexiconRecordKey = never,\n> = T['key'] extends `literal:${string}` | AlsoOptionalWhenRecordKeyIs\n  ? { rkey?: InferRecordKey<T> }\n  : { rkey: InferRecordKey<T> }\n\n/**\n * Type-safe options for {@link Client.create}, combining record options with key requirements.\n * @typeParam T - The record schema type\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 com.atproto.repo.createRecord.main,\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 com.atproto.repo.deleteRecord.main,\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 com.atproto.repo.getRecord.main, 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<\n  typeof com.atproto.repo.putRecord.main,\n  Uint8Array\n>\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 com.atproto.repo.listRecords.main,\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  com.atproto.repo.listRecords.Record & {\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 Basic usage\n * ```typescript\n * import { Client } from '@atproto/lex'\n *\n * const client = new Client(agent)\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  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  }\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 {LexError} with code 'AuthenticationRequired' 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 {LexError} with code 'AuthenticationRequired' 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 LexError('AuthenticationRequired')\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   * Low-level fetch handler for making requests.\n   * @param path - The request path\n   * @param init - Request initialization options\n   */\n  public fetchHandler(path: string, init: RequestInit): Promise<Response> {\n    const headers = buildAtprotoHeaders({\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, options)\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, options)\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(com.atproto.repo.createRecord.main, {\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(com.atproto.repo.deleteRecord.main, {\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(com.atproto.repo.getRecord.main, {\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(com.atproto.repo.putRecord.main, {\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(com.atproto.repo.listRecords.main, {\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   * 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(\n    body: BinaryBodyInit,\n    options?: CallOptions & { encoding?: `${string}/${string}` },\n  ) {\n    return this.xrpc(com.atproto.repo.uploadBlob.main, {\n      ...options,\n      body,\n    })\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?: CallOptions) {\n    return this.xrpc(com.atproto.sync.getBlob.main, {\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?: CallOptions,\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: CallOptions = {},\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    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    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\nfunction getDefaultRecordKey<const T extends RecordSchema>(\n  schema: T,\n): undefined | InferRecordKey<T> {\n  // Let the server generate the TID\n  if (schema.key === 'tid') return undefined\n  if (schema.key === 'any') return undefined\n\n  return getLiteralRecordKey(schema)\n}\n\nfunction getLiteralRecordKey<const T extends RecordSchema>(\n  schema: T,\n): InferRecordKey<T> {\n  if (schema.key.startsWith('literal:')) {\n    return schema.key.slice(8) as InferRecordKey<T>\n  }\n\n  throw new TypeError(\n    `An \"rkey\" must be provided for record key type \"${schema.key}\" (${schema.$type})`,\n  )\n}\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { LexError, LexMap, LexValue, TypedLexMap } from '@atproto/lex-data'\nimport {\n  AtIdentifierString,\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'\nimport { com } from './lexicons/index.js'\nimport { XrpcResponse, XrpcResponseBody } from './response.js'\nimport { BinaryBodyInit, CallOptions, Service } from './types.js'\nimport { buildAtprotoHeaders } from './util.js'\nimport { XrpcOptions, XrpcRequestParams, xrpc, xrpcSafe } from './xrpc.js'\n\nexport type {\n  AtIdentifierString,\n  CidString,\n  DidString,\n  Infer,\n  InferMethodInputBody,\n  InferMethodOutputBody,\n  InferRecordKey,\n  LexMap,\n  LexValue,\n  LexiconRecordKey,\n  Main,\n  NsidString,\n  Params,\n  Procedure,\n  Query,\n  RecordSchema,\n  Restricted,\n  TypedLexMap,\n}\n\n/**\n * Configuration options for creating a {@link Client}.\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 * }\n * ```\n */\nexport type ClientOptions = {\n  /** Labeler DIDs to include in requests for content moderation. */\n  labelers?: Iterable<DidString>\n  /** Custom headers to include in all requests made by this client. */\n  headers?: HeadersInit\n  /** Service proxy identifier for routing requests through a specific service. */\n  service?: Service\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: CallOptions,\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 = CallOptions & {\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  /** Whether to validate the record against its lexicon schema. */\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 = CallOptions & {\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 = CallOptions & {\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 = CallOptions & {\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  /** Whether to validate the record against its lexicon schema. */\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 = CallOptions & {\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\nexport type RecordKeyOptions<\n  T extends RecordSchema,\n  AlsoOptionalWhenRecordKeyIs extends LexiconRecordKey = never,\n> = T['key'] extends `literal:${string}` | AlsoOptionalWhenRecordKeyIs\n  ? { rkey?: InferRecordKey<T> }\n  : { rkey: InferRecordKey<T> }\n\n/**\n * Type-safe options for {@link Client.create}, combining record options with key requirements.\n * @typeParam T - The record schema type\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 com.atproto.repo.createRecord.main,\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 com.atproto.repo.deleteRecord.main,\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 com.atproto.repo.getRecord.main, 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<\n  typeof com.atproto.repo.putRecord.main,\n  Uint8Array\n>\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 com.atproto.repo.listRecords.main,\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  com.atproto.repo.listRecords.Record & {\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 // Basic usage\n * ```typescript\n * import { Client } from '@atproto/lex'\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  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  }\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 {LexError} with code 'AuthenticationRequired' 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 {LexError} with code 'AuthenticationRequired' 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 LexError('AuthenticationRequired')\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 = buildAtprotoHeaders({\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, options)\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, options)\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(com.atproto.repo.createRecord.main, {\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(com.atproto.repo.deleteRecord.main, {\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(com.atproto.repo.getRecord.main, {\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(com.atproto.repo.putRecord.main, {\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(com.atproto.repo.listRecords.main, {\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   * 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(\n    body: BinaryBodyInit,\n    options?: CallOptions & { encoding?: `${string}/${string}` },\n  ) {\n    return this.xrpc(com.atproto.repo.uploadBlob.main, {\n      ...options,\n      body,\n    })\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?: CallOptions) {\n    return this.xrpc(com.atproto.sync.getBlob.main, {\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?: CallOptions,\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: CallOptions = {},\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    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    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\nfunction getDefaultRecordKey<const T extends RecordSchema>(\n  schema: T,\n): undefined | InferRecordKey<T> {\n  // Let the server generate the TID\n  if (schema.key === 'tid') return undefined\n  if (schema.key === 'any') return undefined\n\n  return getLiteralRecordKey(schema)\n}\n\nfunction getLiteralRecordKey<const T extends RecordSchema>(\n  schema: T,\n): InferRecordKey<T> {\n  if (schema.key.startsWith('literal:')) {\n    return schema.key.slice(8) as InferRecordKey<T>\n  }\n\n  throw new TypeError(\n    `An \"rkey\" must be provided for record key type \"${schema.key}\" (${schema.$type})`,\n  )\n}\n"]}

package/dist/xrpc.d.ts

@@ -1,5 +1,5 @@
 import { InferInput, InferPayload, Main, Params, Procedure, Query, Restricted, Subscription } from '@atproto/lex-schema';
-import { Agent } from './agent.js';
+import { Agent, AgentOptions } from './agent.js';
 import { XrpcFailure } from './errors.js';
 import { XrpcResponse } from './response.js';
 import { BinaryBodyInit, CallOptions } from './types.js';
@@ -54,8 +54,7 @@ export type XrpcOptions<M extends Procedure | Query = Procedure | Query> = CallO
 /**
  * Makes an XRPC request and throws on failure.
  *
- * This is the low-level function for making XRPC calls. For most use cases,
- * prefer using {@link Client.xrpc} which provides a more ergonomic API.
+ * This is the low-level function for making XRPC calls.
  *
  * @param agent - The {@link Agent} to use for making the request
  * @param ns - The lexicon method definition
@@ -65,13 +64,20 @@ export type XrpcOptions<M extends Procedure | Query = Procedure | Query> = CallO
  *
  * @example
  * ```typescript
+ * const response = await xrpc('https://bsky.network', com.atproto.identity.resolveHandle, {
+ *   params: { handle: "atproto.com" }
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
  * const response = await xrpc(agent, app.bsky.feed.getTimeline.main, {
  *   params: { limit: 50 }
  * })
  * ```
  */
-export declare function xrpc<const M extends Query | Procedure>(agent: Agent, ns: NonNullable<unknown> extends XrpcOptions<M> ? Main<M> : Restricted<'This XRPC method requires an "options" argument'>): Promise<XrpcResponse<M>>;
-export declare function xrpc<const M extends Query | Procedure>(agent: Agent, ns: Main<M>, options: XrpcOptions<M>): Promise<XrpcResponse<M>>;
+export declare function xrpc<const M extends Query | Procedure>(agentOpts: Agent | AgentOptions, ns: NonNullable<unknown> extends XrpcOptions<M> ? Main<M> : Restricted<'This XRPC method requires an "options" argument'>): Promise<XrpcResponse<M>>;
+export declare function xrpc<const M extends Query | Procedure>(agentOpts: Agent | AgentOptions, ns: Main<M>, options: XrpcOptions<M>): Promise<XrpcResponse<M>>;
 /**
  * Union type representing either a successful response or a failure.
  *
@@ -96,7 +102,7 @@ export type XrpcResult<M extends Procedure | Query> = XrpcResponse<M> | XrpcFail
  *
  * @example
  * ```typescript
- * const result = await xrpcSafe(agent, app.bsky.actor.getProfile.main, {
+ * const result = await xrpcSafe('https://example.com', app.bsky.actor.getProfile, {
  *   params: { actor: 'alice.bsky.social' }
  * })
  *
@@ -107,7 +113,7 @@ export type XrpcResult<M extends Procedure | Query> = XrpcResponse<M> | XrpcFail
  * }
  * ```
  */
-export declare function xrpcSafe<const M extends Query | Procedure>(agent: Agent, ns: NonNullable<unknown> extends XrpcOptions<M> ? Main<M> : Restricted<'This XRPC method requires an "options" argument'>): Promise<XrpcResult<M>>;
-export declare function xrpcSafe<const M extends Query | Procedure>(agent: Agent, ns: Main<M>, options: XrpcOptions<M>): Promise<XrpcResult<M>>;
+export declare function xrpcSafe<const M extends Query | Procedure>(agentOpts: Agent | AgentOptions, ns: NonNullable<unknown> extends XrpcOptions<M> ? Main<M> : Restricted<'This XRPC method requires an "options" argument'>): Promise<XrpcResult<M>>;
+export declare function xrpcSafe<const M extends Query | Procedure>(agentOpts: Agent | AgentOptions, ns: Main<M>, options: XrpcOptions<M>): Promise<XrpcResult<M>>;
 export {};
 //# sourceMappingURL=xrpc.d.ts.map

package/dist/xrpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xrpc.d.ts","sourceRoot":"","sources":["../src/xrpc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"xrpc.d.ts","sourceRoot":"","sources":["../src/xrpc.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,IAAI,EAEJ,MAAM,EAEN,SAAS,EACT,KAAK,EACL,UAAU,EACV,YAAY,EAEb,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,KAAK,EAAE,YAAY,EAAc,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AASxD,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,IACrC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,CAAC,CAAA;CAAE,CAAA;AAEjE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,YAAY,IACtE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAA;AAE7B,KAAK,kBAAkB,CAAC,CAAC,SAAS,SAAS,GAAG,KAAK,IAAI,CAAC,SAAS,SAAS,GACtE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,GACxC,SAAS,CAAA;AAEb,KAAK,gBAAgB,CAAC,EAAE,IAAI,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;CAAE,GAEvE;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;CAAE,GACzB;IAAE,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,IACrE,WAAW,GACT,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,GACvC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,KAAK,GAAG,SAAS,EAC1D,SAAS,EAAE,KAAK,GAAG,YAAY,EAC/B,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,GAC3C,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,iDAAiD,CAAC,GAChE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;AAC3B,wBAAsB,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,KAAK,GAAG,SAAS,EAC1D,SAAS,EAAE,KAAK,GAAG,YAAY,EAC/B,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;AAW3B;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,SAAS,GAAG,KAAK,IAC9C,YAAY,CAAC,CAAC,CAAC,GACf,WAAW,CAAC,CAAC,CAAC,CAAA;AAElB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,KAAK,GAAG,SAAS,EAC9D,SAAS,EAAE,KAAK,GAAG,YAAY,EAC/B,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,GAC3C,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,iDAAiD,CAAC,GAChE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;AACzB,wBAAsB,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,KAAK,GAAG,SAAS,EAC9D,SAAS,EAAE,KAAK,GAAG,YAAY,EAC/B,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/xrpc.js

@@ -5,20 +5,22 @@ exports.xrpcSafe = xrpcSafe;
 const lex_data_1 = require("@atproto/lex-data");
 const lex_json_1 = require("@atproto/lex-json");
 const lex_schema_1 = require("@atproto/lex-schema");
+const agent_js_1 = require("./agent.js");
 const errors_js_1 = require("./errors.js");
 const response_js_1 = require("./response.js");
 const util_js_1 = require("./util.js");
-async function xrpc(agent, ns, options = {}) {
-    const response = await xrpcSafe(agent, ns, options);
+async function xrpc(agentOpts, ns, options = {}) {
+    const response = await xrpcSafe(agentOpts, ns, options);
     if (response.success)
         return response;
     else
         throw response;
 }
-async function xrpcSafe(agent, ns, options = {}) {
+async function xrpcSafe(agentOpts, ns, options = {}) {
     options.signal?.throwIfAborted();
     const method = (0, lex_schema_1.getMain)(ns);
     try {
+        const agent = (0, agent_js_1.buildAgent)(agentOpts);
         const url = xrpcRequestUrl(method, options);
         const request = xrpcRequestInit(method, options);
         const response = await agent.fetchHandler(url, request);

package/dist/xrpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"xrpc.js","sourceRoot":"","sources":["../src/xrpc.ts"],"names":[],"mappings":"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","sourcesContent":["import { LexValue, isLexScalar, isPlainObject } from '@atproto/lex-data'\nimport { lexStringify } from '@atproto/lex-json'\nimport {\n  InferInput,\n  InferPayload,\n  Main,\n  Params,\n  Payload,\n  Procedure,\n  Query,\n  Restricted,\n  Subscription,\n  getMain,\n} from '@atproto/lex-schema'\nimport { Agent } from './agent.js'\nimport { XrpcFailure, asXrpcFailure } from './errors.js'\nimport { XrpcResponse } from './response.js'\nimport { BinaryBodyInit, CallOptions } from './types.js'\nimport {\n  buildAtprotoHeaders,\n  isAsyncIterable,\n  isBlobLike,\n  toReadableStream,\n} from './util.js'\n\n// If all params are optional, allow omitting the params object\ntype XrpcParamsOptions<P extends Params> =\n  NonNullable<unknown> extends P ? { params?: P } : { params: P }\n\n/**\n * The query/path parameters type for an XRPC method, inferred from its schema.\n *\n * @typeParam M - The XRPC method type (Procedure, Query, or Subscription)\n */\nexport type XrpcRequestParams<M extends Procedure | Query | Subscription> =\n  InferInput<M['parameters']>\n\ntype XrpcRequestPayload<M extends Procedure | Query> = M extends Procedure\n  ? InferPayload<M['input'], BinaryBodyInit>\n  : undefined\n\ntype XrpcInputOptions<In> = In extends { body: infer B; encoding: infer E }\n  ? // encoding will be inferred from the schema at runtime if not provided\n    { body: B; encoding?: E }\n  : { body?: undefined; encoding?: undefined }\n\n/**\n * Options for making an XRPC request.\n *\n * Combines {@link CallOptions} with method-specific params and body requirements.\n * The type system ensures required params/body are provided based on the method schema.\n *\n * @typeParam M - The XRPC method type (Procedure or Query)\n * @see {@link CallOptions} for general request options like signal and validateRequest\n * @see {@link XrpcParamsOptions} for method-specific query parameters\n * @see {@link XrpcInputOptions} for method-specific body and encoding requirements\n *\n * @example Query with params\n * ```typescript\n * const options: XrpcOptions<typeof app.bsky.feed.getTimeline.main> = {\n *   params: { limit: 50 }\n * }\n * ```\n *\n * @example Procedure with body\n * ```typescript\n * const options: XrpcOptions<typeof com.atproto.repo.createRecord.main> = {\n *   body: { repo: did, collection: 'app.bsky.feed.post', record: { ... } }\n * }\n * ```\n */\nexport type XrpcOptions<M extends Procedure | Query = Procedure | Query> =\n  CallOptions &\n    XrpcInputOptions<XrpcRequestPayload<M>> &\n    XrpcParamsOptions<XrpcRequestParams<M>>\n\n/**\n * Makes an XRPC request and throws on failure.\n *\n * This is the low-level function for making XRPC calls. For most use cases,\n * prefer using {@link Client.xrpc} which provides a more ergonomic API.\n *\n * @param agent - The {@link Agent} to use for making the request\n * @param ns - The lexicon method definition\n * @param options - Request {@link XrpcOptions options} (params, body, headers, etc.)\n * @returns The successful {@link XrpcResponse}\n * @throws {XrpcFailure} When the request fails\n *\n * @example\n * ```typescript\n * const response = await xrpc(agent, app.bsky.feed.getTimeline.main, {\n *   params: { limit: 50 }\n * })\n * ```\n */\nexport async function xrpc<const M extends Query | Procedure>(\n  agent: Agent,\n  ns: NonNullable<unknown> extends XrpcOptions<M>\n    ? Main<M>\n    : Restricted<'This XRPC method requires an \"options\" argument'>,\n): Promise<XrpcResponse<M>>\nexport async function xrpc<const M extends Query | Procedure>(\n  agent: Agent,\n  ns: Main<M>,\n  options: XrpcOptions<M>,\n): Promise<XrpcResponse<M>>\nexport async function xrpc<const M extends Query | Procedure>(\n  agent: Agent,\n  ns: Main<M>,\n  options: XrpcOptions<M> = {} as XrpcOptions<M>,\n): Promise<XrpcResponse<M>> {\n  const response = await xrpcSafe<M>(agent, ns, options)\n  if (response.success) return response\n  else throw response\n}\n\n/**\n * Union type representing either a successful response or a failure.\n *\n * Both {@link XrpcResponse} and {@link XrpcFailure} have a `success` property\n * that can be used to discriminate between them.\n *\n * @typeParam M - The XRPC method type\n */\nexport type XrpcResult<M extends Procedure | Query> =\n  | XrpcResponse<M>\n  | XrpcFailure<M>\n\n/**\n * Makes an XRPC request without throwing on failure.\n *\n * Returns a discriminated union that can be checked via the `success` property.\n * This is useful for handling errors without try/catch blocks. This also allow\n * failure results to be typed with the method schema, which can provide better\n * type safety when handling errors (e.g. checking for specific error codes).\n *\n * @param agent - The {@link Agent} to use for making the request\n * @param ns - The lexicon method definition\n * @param options - Request {@link XrpcOptions options} (params, body, headers, etc.)\n * @returns Either a successful {@link XrpcResponse} or an {@link XrpcFailure}\n *\n * @example\n * ```typescript\n * const result = await xrpcSafe(agent, 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('Request failed:', result.error)\n * }\n * ```\n */\nexport async function xrpcSafe<const M extends Query | Procedure>(\n  agent: Agent,\n  ns: NonNullable<unknown> extends XrpcOptions<M>\n    ? Main<M>\n    : Restricted<'This XRPC method requires an \"options\" argument'>,\n): Promise<XrpcResult<M>>\nexport async function xrpcSafe<const M extends Query | Procedure>(\n  agent: Agent,\n  ns: Main<M>,\n  options: XrpcOptions<M>,\n): Promise<XrpcResult<M>>\nexport async function xrpcSafe<const M extends Query | Procedure>(\n  agent: Agent,\n  ns: Main<M>,\n  options: XrpcOptions<M> = {} as XrpcOptions<M>,\n): Promise<XrpcResult<M>> {\n  options.signal?.throwIfAborted()\n  const method: M = getMain(ns)\n  try {\n    const url = xrpcRequestUrl(method, options)\n    const request = xrpcRequestInit(method, options)\n    const response = await agent.fetchHandler(url, request)\n    return await XrpcResponse.fromFetchResponse<M>(method, response, options)\n  } catch (cause) {\n    return asXrpcFailure(method, cause)\n  }\n}\n\nfunction xrpcRequestUrl<M extends Procedure | Query | Subscription>(\n  method: M,\n  options: CallOptions & { params?: Params },\n) {\n  const path = `/xrpc/${method.nsid}`\n\n  const queryString = method.parameters\n    ?.toURLSearchParams(options.params ?? {})\n    .toString()\n\n  return queryString ? `${path}?${queryString}` : path\n}\n\nfunction xrpcRequestInit<T extends Procedure | Query>(\n  schema: T,\n  options: CallOptions & {\n    body?: LexValue | BinaryBodyInit\n    encoding?: string\n  },\n): RequestInit & { duplex?: 'half' } {\n  const headers = buildAtprotoHeaders(options)\n\n  // Tell the server what type of response we're expecting\n  if (schema.output.encoding) {\n    headers.set('accept', schema.output.encoding)\n  }\n\n  // Caller should not set content-type header\n  if (headers.has('content-type')) {\n    const contentType = headers.get('content-type')\n    throw new TypeError(`Unexpected content-type header (${contentType})`)\n  }\n\n  // Requests with body\n  if ('input' in schema) {\n    const encodingHint = options.encoding\n    const input = xrpcProcedureInput(schema, options, encodingHint)\n\n    if (input) {\n      headers.set('content-type', input.encoding)\n    } else if (encodingHint != null) {\n      throw new TypeError(`Unexpected encoding hint (${encodingHint})`)\n    }\n\n    return {\n      duplex: 'half',\n      redirect: 'follow',\n      referrerPolicy: 'strict-origin-when-cross-origin', // (default)\n      mode: 'cors', // (default)\n      signal: options.signal,\n      method: 'POST',\n      headers,\n      body: input?.body,\n    }\n  }\n\n  // Requests without body\n  return {\n    duplex: 'half',\n    redirect: 'follow',\n    referrerPolicy: 'strict-origin-when-cross-origin', // (default)\n    mode: 'cors', // (default)\n    signal: options.signal,\n    method: 'GET',\n    headers,\n  }\n}\n\nfunction xrpcProcedureInput(\n  method: Procedure,\n  options: CallOptions & { body?: LexValue | BinaryBodyInit },\n  encodingHint?: string,\n): null | { body: BodyInit; encoding: string } {\n  const { input } = method\n  const { body } = options\n\n  if (options.validateRequest) {\n    input.schema?.check(body)\n  }\n\n  // Special handling for endpoints expecting application/json input\n  if (input.encoding === 'application/json') {\n    // @NOTE **NOT** using isLexValue here to avoid deep checks in order to\n    // distinguish between LexValue and BinaryBodyInit.\n    if (!isLexScalar(body) && !isPlainObject(body) && !Array.isArray(body)) {\n      throw new TypeError(`Expected LexValue body, got ${typeof body}`)\n    }\n\n    return buildPayload(input, lexStringify(body), encodingHint)\n  }\n\n  // Other encodings will be sent unaltered (ie. as binary data)\n  switch (typeof body) {\n    case 'undefined':\n    case 'string':\n      return buildPayload(input, body, encodingHint)\n    case 'object': {\n      if (body === null) break\n      if (\n        ArrayBuffer.isView(body) ||\n        body instanceof ArrayBuffer ||\n        body instanceof ReadableStream\n      ) {\n        return buildPayload(input, body, encodingHint)\n      } else if (isAsyncIterable(body)) {\n        return buildPayload(input, toReadableStream(body), encodingHint)\n      } else if (isBlobLike(body)) {\n        return buildPayload(input, body, encodingHint || body.type)\n      }\n    }\n  }\n\n  throw new TypeError(\n    `Invalid ${typeof body} body for ${input.encoding} encoding`,\n  )\n}\n\nfunction buildPayload(\n  schema: Payload,\n  body: undefined | BodyInit,\n  encodingHint?: string,\n): null | { body: BodyInit; encoding: string } {\n  if (schema.encoding === undefined) {\n    if (body !== undefined) {\n      throw new TypeError(\n        `Cannot send a ${typeof body} body with undefined encoding`,\n      )\n    }\n\n    return null\n  }\n\n  if (body === undefined) {\n    // This error would be returned by the server, but we can catch it earlier\n    // to avoid un-necessary requests. Note that a content-length of 0 does not\n    // necessary mean that the body is \"empty\" (e.g. an empty txt file).\n    throw new TypeError(`A request body is expected but none was provided`)\n  }\n\n  const encoding = buildEncoding(schema, encodingHint)\n  return { encoding, body }\n}\n\nfunction buildEncoding(schema: Payload, encodingHint?: string): string {\n  // Should never happen (required for type safety)\n  if (!schema.encoding) {\n    throw new TypeError('Unexpected payload')\n  }\n\n  if (encodingHint?.length) {\n    if (!schema.matchesEncoding(encodingHint)) {\n      throw new TypeError(\n        `Cannot send a body with content-type \"${encodingHint}\" for \"${schema.encoding}\" encoding`,\n      )\n    }\n    return encodingHint\n  }\n\n  // Fallback\n\n  if (schema.encoding === '*/*') {\n    return 'application/octet-stream'\n  }\n\n  if (schema.encoding.startsWith('text/')) {\n    return schema.encoding.includes('*')\n      ? 'text/plain; charset=utf-8'\n      : `${schema.encoding}; charset=utf-8`\n  }\n\n  if (!schema.encoding.includes('*')) {\n    return schema.encoding\n  }\n\n  throw new TypeError(\n    `Unable to determine payload encoding. Please provide a 'content-type' header matching ${schema.encoding}.`,\n  )\n}\n"]}
+{"version":3,"file":"xrpc.js","sourceRoot":"","sources":["../src/xrpc.ts"],"names":[],"mappings":"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","sourcesContent":["import { LexValue, isLexScalar, isPlainObject } from '@atproto/lex-data'\nimport { lexStringify } from '@atproto/lex-json'\nimport {\n  InferInput,\n  InferPayload,\n  Main,\n  NsidString,\n  Params,\n  Payload,\n  Procedure,\n  Query,\n  Restricted,\n  Subscription,\n  getMain,\n} from '@atproto/lex-schema'\nimport { Agent, AgentOptions, buildAgent } from './agent.js'\nimport { XrpcFailure, asXrpcFailure } from './errors.js'\nimport { XrpcResponse } from './response.js'\nimport { BinaryBodyInit, CallOptions } from './types.js'\nimport {\n  buildAtprotoHeaders,\n  isAsyncIterable,\n  isBlobLike,\n  toReadableStream,\n} from './util.js'\n\n// If all params are optional, allow omitting the params object\ntype XrpcParamsOptions<P extends Params> =\n  NonNullable<unknown> extends P ? { params?: P } : { params: P }\n\n/**\n * The query/path parameters type for an XRPC method, inferred from its schema.\n *\n * @typeParam M - The XRPC method type (Procedure, Query, or Subscription)\n */\nexport type XrpcRequestParams<M extends Procedure | Query | Subscription> =\n  InferInput<M['parameters']>\n\ntype XrpcRequestPayload<M extends Procedure | Query> = M extends Procedure\n  ? InferPayload<M['input'], BinaryBodyInit>\n  : undefined\n\ntype XrpcInputOptions<In> = In extends { body: infer B; encoding: infer E }\n  ? // encoding will be inferred from the schema at runtime if not provided\n    { body: B; encoding?: E }\n  : { body?: undefined; encoding?: undefined }\n\n/**\n * Options for making an XRPC request.\n *\n * Combines {@link CallOptions} with method-specific params and body requirements.\n * The type system ensures required params/body are provided based on the method schema.\n *\n * @typeParam M - The XRPC method type (Procedure or Query)\n * @see {@link CallOptions} for general request options like signal and validateRequest\n * @see {@link XrpcParamsOptions} for method-specific query parameters\n * @see {@link XrpcInputOptions} for method-specific body and encoding requirements\n *\n * @example Query with params\n * ```typescript\n * const options: XrpcOptions<typeof app.bsky.feed.getTimeline.main> = {\n *   params: { limit: 50 }\n * }\n * ```\n *\n * @example Procedure with body\n * ```typescript\n * const options: XrpcOptions<typeof com.atproto.repo.createRecord.main> = {\n *   body: { repo: did, collection: 'app.bsky.feed.post', record: { ... } }\n * }\n * ```\n */\nexport type XrpcOptions<M extends Procedure | Query = Procedure | Query> =\n  CallOptions &\n    XrpcInputOptions<XrpcRequestPayload<M>> &\n    XrpcParamsOptions<XrpcRequestParams<M>>\n\n/**\n * Makes an XRPC request and throws on failure.\n *\n * This is the low-level function for making XRPC calls.\n *\n * @param agent - The {@link Agent} to use for making the request\n * @param ns - The lexicon method definition\n * @param options - Request {@link XrpcOptions options} (params, body, headers, etc.)\n * @returns The successful {@link XrpcResponse}\n * @throws {XrpcFailure} When the request fails\n *\n * @example\n * ```typescript\n * const response = await xrpc('https://bsky.network', com.atproto.identity.resolveHandle, {\n *   params: { handle: \"atproto.com\" }\n * })\n * ```\n *\n * @example\n * ```typescript\n * const response = await xrpc(agent, app.bsky.feed.getTimeline.main, {\n *   params: { limit: 50 }\n * })\n * ```\n */\nexport async function xrpc<const M extends Query | Procedure>(\n  agentOpts: Agent | AgentOptions,\n  ns: NonNullable<unknown> extends XrpcOptions<M>\n    ? Main<M>\n    : Restricted<'This XRPC method requires an \"options\" argument'>,\n): Promise<XrpcResponse<M>>\nexport async function xrpc<const M extends Query | Procedure>(\n  agentOpts: Agent | AgentOptions,\n  ns: Main<M>,\n  options: XrpcOptions<M>,\n): Promise<XrpcResponse<M>>\nexport async function xrpc<const M extends Query | Procedure>(\n  agentOpts: Agent | AgentOptions,\n  ns: Main<M>,\n  options: XrpcOptions<M> = {} as XrpcOptions<M>,\n): Promise<XrpcResponse<M>> {\n  const response = await xrpcSafe<M>(agentOpts, ns, options)\n  if (response.success) return response\n  else throw response\n}\n\n/**\n * Union type representing either a successful response or a failure.\n *\n * Both {@link XrpcResponse} and {@link XrpcFailure} have a `success` property\n * that can be used to discriminate between them.\n *\n * @typeParam M - The XRPC method type\n */\nexport type XrpcResult<M extends Procedure | Query> =\n  | XrpcResponse<M>\n  | XrpcFailure<M>\n\n/**\n * Makes an XRPC request without throwing on failure.\n *\n * Returns a discriminated union that can be checked via the `success` property.\n * This is useful for handling errors without try/catch blocks. This also allow\n * failure results to be typed with the method schema, which can provide better\n * type safety when handling errors (e.g. checking for specific error codes).\n *\n * @param agent - The {@link Agent} to use for making the request\n * @param ns - The lexicon method definition\n * @param options - Request {@link XrpcOptions options} (params, body, headers, etc.)\n * @returns Either a successful {@link XrpcResponse} or an {@link XrpcFailure}\n *\n * @example\n * ```typescript\n * const result = await xrpcSafe('https://example.com', app.bsky.actor.getProfile, {\n *   params: { actor: 'alice.bsky.social' }\n * })\n *\n * if (result.success) {\n *   console.log(result.body.displayName)\n * } else {\n *   console.error('Request failed:', result.error)\n * }\n * ```\n */\nexport async function xrpcSafe<const M extends Query | Procedure>(\n  agentOpts: Agent | AgentOptions,\n  ns: NonNullable<unknown> extends XrpcOptions<M>\n    ? Main<M>\n    : Restricted<'This XRPC method requires an \"options\" argument'>,\n): Promise<XrpcResult<M>>\nexport async function xrpcSafe<const M extends Query | Procedure>(\n  agentOpts: Agent | AgentOptions,\n  ns: Main<M>,\n  options: XrpcOptions<M>,\n): Promise<XrpcResult<M>>\nexport async function xrpcSafe<const M extends Query | Procedure>(\n  agentOpts: Agent | AgentOptions,\n  ns: Main<M>,\n  options: XrpcOptions<M> = {} as XrpcOptions<M>,\n): Promise<XrpcResult<M>> {\n  options.signal?.throwIfAborted()\n  const method: M = getMain(ns)\n  try {\n    const agent = buildAgent(agentOpts)\n    const url = xrpcRequestUrl(method, options)\n    const request = xrpcRequestInit(method, options)\n    const response = await agent.fetchHandler(url, request)\n    return await XrpcResponse.fromFetchResponse<M>(method, response, options)\n  } catch (cause) {\n    return asXrpcFailure(method, cause)\n  }\n}\n\nfunction xrpcRequestUrl<M extends Procedure | Query | Subscription>(\n  method: M,\n  options: CallOptions & { params?: Params },\n): `/xrpc/${NsidString}${'' | `?${string}`}` {\n  const path = `/xrpc/${method.nsid}` as const\n\n  const queryString = method.parameters\n    ?.toURLSearchParams(options.params ?? {})\n    .toString()\n\n  return queryString ? (`${path}?${queryString}` as const) : path\n}\n\nfunction xrpcRequestInit<T extends Procedure | Query>(\n  schema: T,\n  options: CallOptions & {\n    body?: LexValue | BinaryBodyInit\n    encoding?: string\n  },\n): RequestInit & { duplex?: 'half' } {\n  const headers = buildAtprotoHeaders(options)\n\n  // Tell the server what type of response we're expecting\n  if (schema.output.encoding) {\n    headers.set('accept', schema.output.encoding)\n  }\n\n  // Caller should not set content-type header\n  if (headers.has('content-type')) {\n    const contentType = headers.get('content-type')\n    throw new TypeError(`Unexpected content-type header (${contentType})`)\n  }\n\n  // Requests with body\n  if ('input' in schema) {\n    const encodingHint = options.encoding\n    const input = xrpcProcedureInput(schema, options, encodingHint)\n\n    if (input) {\n      headers.set('content-type', input.encoding)\n    } else if (encodingHint != null) {\n      throw new TypeError(`Unexpected encoding hint (${encodingHint})`)\n    }\n\n    return {\n      duplex: 'half',\n      redirect: 'follow',\n      referrerPolicy: 'strict-origin-when-cross-origin', // (default)\n      mode: 'cors', // (default)\n      signal: options.signal,\n      method: 'POST',\n      headers,\n      body: input?.body,\n    }\n  }\n\n  // Requests without body\n  return {\n    duplex: 'half',\n    redirect: 'follow',\n    referrerPolicy: 'strict-origin-when-cross-origin', // (default)\n    mode: 'cors', // (default)\n    signal: options.signal,\n    method: 'GET',\n    headers,\n  }\n}\n\nfunction xrpcProcedureInput(\n  method: Procedure,\n  options: CallOptions & { body?: LexValue | BinaryBodyInit },\n  encodingHint?: string,\n): null | { body: BodyInit; encoding: string } {\n  const { input } = method\n  const { body } = options\n\n  if (options.validateRequest) {\n    input.schema?.check(body)\n  }\n\n  // Special handling for endpoints expecting application/json input\n  if (input.encoding === 'application/json') {\n    // @NOTE **NOT** using isLexValue here to avoid deep checks in order to\n    // distinguish between LexValue and BinaryBodyInit.\n    if (!isLexScalar(body) && !isPlainObject(body) && !Array.isArray(body)) {\n      throw new TypeError(`Expected LexValue body, got ${typeof body}`)\n    }\n\n    return buildPayload(input, lexStringify(body), encodingHint)\n  }\n\n  // Other encodings will be sent unaltered (ie. as binary data)\n  switch (typeof body) {\n    case 'undefined':\n    case 'string':\n      return buildPayload(input, body, encodingHint)\n    case 'object': {\n      if (body === null) break\n      if (\n        ArrayBuffer.isView(body) ||\n        body instanceof ArrayBuffer ||\n        body instanceof ReadableStream\n      ) {\n        return buildPayload(input, body, encodingHint)\n      } else if (isAsyncIterable(body)) {\n        return buildPayload(input, toReadableStream(body), encodingHint)\n      } else if (isBlobLike(body)) {\n        return buildPayload(input, body, encodingHint || body.type)\n      }\n    }\n  }\n\n  throw new TypeError(\n    `Invalid ${typeof body} body for ${input.encoding} encoding`,\n  )\n}\n\nfunction buildPayload(\n  schema: Payload,\n  body: undefined | BodyInit,\n  encodingHint?: string,\n): null | { body: BodyInit; encoding: string } {\n  if (schema.encoding === undefined) {\n    if (body !== undefined) {\n      throw new TypeError(\n        `Cannot send a ${typeof body} body with undefined encoding`,\n      )\n    }\n\n    return null\n  }\n\n  if (body === undefined) {\n    // This error would be returned by the server, but we can catch it earlier\n    // to avoid un-necessary requests. Note that a content-length of 0 does not\n    // necessary mean that the body is \"empty\" (e.g. an empty txt file).\n    throw new TypeError(`A request body is expected but none was provided`)\n  }\n\n  const encoding = buildEncoding(schema, encodingHint)\n  return { encoding, body }\n}\n\nfunction buildEncoding(schema: Payload, encodingHint?: string): string {\n  // Should never happen (required for type safety)\n  if (!schema.encoding) {\n    throw new TypeError('Unexpected payload')\n  }\n\n  if (encodingHint?.length) {\n    if (!schema.matchesEncoding(encodingHint)) {\n      throw new TypeError(\n        `Cannot send a body with content-type \"${encodingHint}\" for \"${schema.encoding}\" encoding`,\n      )\n    }\n    return encodingHint\n  }\n\n  // Fallback\n\n  if (schema.encoding === '*/*') {\n    return 'application/octet-stream'\n  }\n\n  if (schema.encoding.startsWith('text/')) {\n    return schema.encoding.includes('*')\n      ? 'text/plain; charset=utf-8'\n      : `${schema.encoding}; charset=utf-8`\n  }\n\n  if (!schema.encoding.includes('*')) {\n    return schema.encoding\n  }\n\n  throw new TypeError(\n    `Unable to determine payload encoding. Please provide a 'content-type' header matching ${schema.encoding}.`,\n  )\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atproto/lex-client",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "license": "MIT",
   "description": "HTTP client for interacting with Lexicon based APIs",
   "keywords": [
@@ -43,7 +43,7 @@
   },
   "devDependencies": {
     "vitest": "^4.0.16",
-    "@atproto/lex-cbor": "^0.0.12",
+    "@atproto/lex-cbor": "^0.0.13",
     "@atproto/lex-builder": "^0.0.16"
   },
   "scripts": {

package/src/agent.ts

@@ -5,7 +5,7 @@ import { DidString } from '@atproto/lex-schema'
  *
  * The handler is responsible for adding the origin (protocol, hostname, and
  * port) to the provided path, typically based on authentication or service
- * configuration. The handler are also responsible for adding any necessary
+ * configuration. The handler can also be responsible for adding any necessary
  * headers, such as authorization tokens.
  *
  * @param path - The URL path (pathname + query parameters) without the origin
@@ -18,16 +18,23 @@ export type FetchHandler = (
    * origin. The origin (protocol, hostname, and port) must be added by this
    * {@link FetchHandler}, typically based on authentication or other factors.
    */
-  path: string,
+  path: `/${string}`,
   init: RequestInit,
 ) => Promise<Response>
 
 /**
- * Core interface for making XRPC requests.
+ * Core interface for making XRPC requests towards a specific service.
  *
- * An Agent encapsulates an identity and request handling for AT Protocol
- * operations. It can represent an authenticated user session or an
- * unauthenticated service client.
+ * An {@link Agent} encapsulates an identity and request handling for AT
+ * Protocol operations. Agents will typically handle authentication, service URL
+ * resolution, and other request configuration, allowing client code to make
+ * requests without needing to manage these details directly. The key component
+ * of an Agent is the {@link FetchHandler}, which is responsible for
+ * constructing the full request URL and adding any necessary headers or
+ * authentication tokens. The Agent's `did` property represents the
+ * authenticated user's DID, if available, and can be used for operations that
+ * require knowledge of the user's identity (such as creating AT Protocol
+ * records).
  *
  * @see {@link buildAgent} for creating (simple) Agent instances.
  *
@@ -35,7 +42,10 @@ export type FetchHandler = (
  * ```typescript
  * const agent: Agent = {
  *   did: 'did:plc:example123',
- *   fetchHandler: (path, init) => fetch(new URL(path, 'https://bsky.social'), init)
+ *   fetchHandler: async (path, init) => {
+ *     const url = new URL(path, 'https://bsky.social')
+ *     return fetch(url, init)
+ *   }
  * }
  * ```
  */
@@ -46,6 +56,18 @@ export interface Agent {
   fetchHandler: FetchHandler
 }
 
+export function isAgent(value: unknown): value is Agent {
+  return (
+    typeof value === 'object' &&
+    value !== null &&
+    'fetchHandler' in value &&
+    typeof value.fetchHandler === 'function' &&
+    (!('did' in value) ||
+      value.did === undefined ||
+      typeof value.did === 'string')
+  )
+}
+
 export type AgentConfig = {
   /**
    * The identifier (DID) of the user represented by this agent.
@@ -84,20 +106,20 @@ export type AgentOptions = AgentConfig | string | URL
 /**
  * Creates an {@link Agent} from various input types.
  *
- * This factory function accepts an existing Agent (returned as-is), a service URL,
- * or a full configuration object. It handles the common case of creating an
- * unauthenticated agent from just a service URL.
+ * This factory function accepts an existing Agent (returned as-is), a service
+ * URL, or a full configuration object. It handles the common case of creating
+ * an unauthenticated agent from just a service URL.
  *
  * @param options - Agent instance, configuration object, or service URL
  * @returns A configured Agent ready for making requests
  * @throws {TypeError} If fetch() is not available in the environment
  *
- * @example From URL string
+ * @example // From URL string
  * ```typescript
  * const agent = buildAgent('https://public.api.bsky.app')
  * ```
  *
- * @example From configuration
+ * @example // From configuration
  * ```typescript
  * const agent = buildAgent({
  *   did: 'did:plc:example',
@@ -105,17 +127,12 @@ export type AgentOptions = AgentConfig | string | URL
  *   headers: { 'Authorization': 'Bearer ...' }
  * })
  * ```
- *
- * @example Pass-through existing agent
- * ```typescript
- * const existing: Agent = { ... }
- * const agent = buildAgent(existing) // Returns existing unchanged
- * ```
  */
+export function buildAgent<O extends Agent | AgentOptions>(
+  options: O,
+): O extends Agent ? O : Agent
 export function buildAgent(options: Agent | AgentOptions): Agent {
-  if (typeof options === 'object' && 'fetchHandler' in options) {
-    return options
-  }
+  if (isAgent(options)) return options
 
   const config: Agent | AgentConfig =
     typeof options === 'string' || options instanceof URL

package/src/client.ts

@@ -282,11 +282,12 @@ export type ListRecord<Value extends LexMap> =
  * services. It provides type-safe methods for XRPC calls, record operations,
  * and blob handling.
  *
- * @example Basic usage
+ * @example // Basic usage
  * ```typescript
  * import { Client } from '@atproto/lex'
  *
- * const client = new Client(agent)
+ * const client = new Client(oauthSession)
+ *
  * const response = await client.xrpc(app.bsky.feed.getTimeline.main, {
  *   params: { limit: 50 }
  * })
@@ -379,11 +380,18 @@ export class Client implements Agent {
   }
 
   /**
-   * Low-level fetch handler for making requests.
+   * {@link Agent}'s {@link Agent.fetchHandler} implementation, which adds
+   * labelers and service proxying headers. This method allow a {@link Client}
+   * instance to be used directly as an {@link Agent} for another
+   * {@link Client}, enabling composition of headers (labelers, proxying, etc.).
+   *
    * @param path - The request path
    * @param init - Request initialization options
    */
-  public fetchHandler(path: string, init: RequestInit): Promise<Response> {
+  public fetchHandler(
+    path: `/${string}`,
+    init: RequestInit,
+  ): Promise<Response> {
     const headers = buildAtprotoHeaders({
       headers: init.headers,
       service: this.service,

package/src/xrpc.ts

@@ -4,6 +4,7 @@ import {
   InferInput,
   InferPayload,
   Main,
+  NsidString,
   Params,
   Payload,
   Procedure,
@@ -12,7 +13,7 @@ import {
   Subscription,
   getMain,
 } from '@atproto/lex-schema'
-import { Agent } from './agent.js'
+import { Agent, AgentOptions, buildAgent } from './agent.js'
 import { XrpcFailure, asXrpcFailure } from './errors.js'
 import { XrpcResponse } from './response.js'
 import { BinaryBodyInit, CallOptions } from './types.js'
@@ -77,8 +78,7 @@ export type XrpcOptions<M extends Procedure | Query = Procedure | Query> =
 /**
  * Makes an XRPC request and throws on failure.
  *
- * This is the low-level function for making XRPC calls. For most use cases,
- * prefer using {@link Client.xrpc} which provides a more ergonomic API.
+ * This is the low-level function for making XRPC calls.
  *
  * @param agent - The {@link Agent} to use for making the request
  * @param ns - The lexicon method definition
@@ -88,28 +88,35 @@ export type XrpcOptions<M extends Procedure | Query = Procedure | Query> =
  *
  * @example
  * ```typescript
+ * const response = await xrpc('https://bsky.network', com.atproto.identity.resolveHandle, {
+ *   params: { handle: "atproto.com" }
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
  * const response = await xrpc(agent, app.bsky.feed.getTimeline.main, {
  *   params: { limit: 50 }
  * })
  * ```
  */
 export async function xrpc<const M extends Query | Procedure>(
-  agent: Agent,
+  agentOpts: Agent | AgentOptions,
   ns: NonNullable<unknown> extends XrpcOptions<M>
     ? Main<M>
     : Restricted<'This XRPC method requires an "options" argument'>,
 ): Promise<XrpcResponse<M>>
 export async function xrpc<const M extends Query | Procedure>(
-  agent: Agent,
+  agentOpts: Agent | AgentOptions,
   ns: Main<M>,
   options: XrpcOptions<M>,
 ): Promise<XrpcResponse<M>>
 export async function xrpc<const M extends Query | Procedure>(
-  agent: Agent,
+  agentOpts: Agent | AgentOptions,
   ns: Main<M>,
   options: XrpcOptions<M> = {} as XrpcOptions<M>,
 ): Promise<XrpcResponse<M>> {
-  const response = await xrpcSafe<M>(agent, ns, options)
+  const response = await xrpcSafe<M>(agentOpts, ns, options)
   if (response.success) return response
   else throw response
 }
@@ -141,7 +148,7 @@ export type XrpcResult<M extends Procedure | Query> =
  *
  * @example
  * ```typescript
- * const result = await xrpcSafe(agent, app.bsky.actor.getProfile.main, {
+ * const result = await xrpcSafe('https://example.com', app.bsky.actor.getProfile, {
  *   params: { actor: 'alice.bsky.social' }
  * })
  *
@@ -153,24 +160,25 @@ export type XrpcResult<M extends Procedure | Query> =
  * ```
  */
 export async function xrpcSafe<const M extends Query | Procedure>(
-  agent: Agent,
+  agentOpts: Agent | AgentOptions,
   ns: NonNullable<unknown> extends XrpcOptions<M>
     ? Main<M>
     : Restricted<'This XRPC method requires an "options" argument'>,
 ): Promise<XrpcResult<M>>
 export async function xrpcSafe<const M extends Query | Procedure>(
-  agent: Agent,
+  agentOpts: Agent | AgentOptions,
   ns: Main<M>,
   options: XrpcOptions<M>,
 ): Promise<XrpcResult<M>>
 export async function xrpcSafe<const M extends Query | Procedure>(
-  agent: Agent,
+  agentOpts: Agent | AgentOptions,
   ns: Main<M>,
   options: XrpcOptions<M> = {} as XrpcOptions<M>,
 ): Promise<XrpcResult<M>> {
   options.signal?.throwIfAborted()
   const method: M = getMain(ns)
   try {
+    const agent = buildAgent(agentOpts)
     const url = xrpcRequestUrl(method, options)
     const request = xrpcRequestInit(method, options)
     const response = await agent.fetchHandler(url, request)
@@ -183,14 +191,14 @@ export async function xrpcSafe<const M extends Query | Procedure>(
 function xrpcRequestUrl<M extends Procedure | Query | Subscription>(
   method: M,
   options: CallOptions & { params?: Params },
-) {
-  const path = `/xrpc/${method.nsid}`
+): `/xrpc/${NsidString}${'' | `?${string}`}` {
+  const path = `/xrpc/${method.nsid}` as const
 
   const queryString = method.parameters
     ?.toURLSearchParams(options.params ?? {})
     .toString()
 
-  return queryString ? `${path}?${queryString}` : path
+  return queryString ? (`${path}?${queryString}` as const) : path
 }
 
 function xrpcRequestInit<T extends Procedure | Query>(