@atproto/lex-client 0.3.6 → 0.4.0

package/dist/lexicons/com/atproto.js.map

@@ -1 +1 @@
-{"version":3,"file":"atproto.js","sourceRoot":"","sources":["../../../src/lexicons/com/atproto.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,IAAI,MAAM,mBAAmB,CAAA;AACzC,OAAO,KAAK,IAAI,MAAM,mBAAmB,CAAA","sourcesContent":["/*\n * THIS FILE WAS GENERATED BY \"@atproto/lex\". DO NOT EDIT.\n */\n\nexport * as repo from './atproto/repo.js'\nexport * as sync from './atproto/sync.js'\n"]}
+{"version":3,"file":"atproto.js","sourceRoot":"","sources":["../../../src/lexicons/com/atproto.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,IAAI,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,IAAI,MAAM,mBAAmB,CAAC","sourcesContent":["/*\n * THIS FILE WAS GENERATED BY \"@atproto/lex\". DO NOT EDIT.\n */\n\nexport * as repo from \"./atproto/repo.js\";\nexport * as sync from \"./atproto/sync.js\";\n"]}

package/dist/lexicons/com.d.ts

@@ -1,2 +1,2 @@
-export * as atproto from './com/atproto.js';
+export * as atproto from "./com/atproto.js";
 //# sourceMappingURL=com.d.ts.map

package/dist/lexicons/com.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"com.d.ts","sourceRoot":"","sources":["../../src/lexicons/com.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"com.d.ts","sourceRoot":"","sources":["../../src/lexicons/com.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC"}

package/dist/lexicons/com.js

@@ -1,5 +1,5 @@
 /*
  * THIS FILE WAS GENERATED BY "@atproto/lex". DO NOT EDIT.
  */
-export * as atproto from './com/atproto.js';
+export * as atproto from "./com/atproto.js";
 //# sourceMappingURL=com.js.map

package/dist/lexicons/com.js.map

@@ -1 +1 @@
-{"version":3,"file":"com.js","sourceRoot":"","sources":["../../src/lexicons/com.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA","sourcesContent":["/*\n * THIS FILE WAS GENERATED BY \"@atproto/lex\". DO NOT EDIT.\n */\n\nexport * as atproto from './com/atproto.js'\n"]}
+{"version":3,"file":"com.js","sourceRoot":"","sources":["../../src/lexicons/com.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC","sourcesContent":["/*\n * THIS FILE WAS GENERATED BY \"@atproto/lex\". DO NOT EDIT.\n */\n\nexport * as atproto from \"./com/atproto.js\";\n"]}

package/dist/lexicons/index.d.ts

@@ -1,2 +1,2 @@
-export * as com from './com.js';
+export * as com from "./com.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/lexicons/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lexicons/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lexicons/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC"}

package/dist/lexicons/index.js

@@ -1,5 +1,5 @@
 /*
  * THIS FILE WAS GENERATED BY "@atproto/lex". DO NOT EDIT.
  */
-export * as com from './com.js';
+export * as com from "./com.js";
 //# sourceMappingURL=index.js.map

package/dist/lexicons/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lexicons/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA","sourcesContent":["/*\n * THIS FILE WAS GENERATED BY \"@atproto/lex\". DO NOT EDIT.\n */\n\nexport * as com from './com.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lexicons/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC","sourcesContent":["/*\n * THIS FILE WAS GENERATED BY \"@atproto/lex\". DO NOT EDIT.\n */\n\nexport * as com from \"./com.js\";\n"]}

package/dist/write-operation-builder.d.ts

@@ -1,6 +1,6 @@
+import { type RecordKeyOptions } from '@atproto/lex-rpc';
 import { type $Typed, type InferInput, type Main, type RecordSchema, type Restricted } from '@atproto/lex-schema';
 import { com } from './lexicons/index.js';
-import type { RecordKeyOptions } from './util.js';
 export type WriteOperation = $Typed<com.atproto.repo.applyWrites.Create> | $Typed<com.atproto.repo.applyWrites.Update> | $Typed<com.atproto.repo.applyWrites.Delete>;
 export type WriteOperationCreateOptions<T extends RecordSchema> = RecordKeyOptions<T, 'tid' | 'any'>;
 export type WriteOperationUpdateOptions<T extends RecordSchema> = RecordKeyOptions<T>;

package/dist/write-operation-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-operation-builder.d.ts","sourceRoot":"","sources":["../src/write-operation-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"write-operation-builder.d.ts","sourceRoot":"","sources":["../src/write-operation-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAA0B,MAAM,kBAAkB,CAAA;AAChF,OAAO,EACL,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,UAAU,EAEhB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AAEzC,MAAM,MAAM,cAAc,GACtB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAC3C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAC3C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;AAE/C,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,YAAY,IAC5D,gBAAgB,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,CAAA;AAEpC,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,YAAY,IAC5D,gBAAgB,CAAC,CAAC,CAAC,CAAA;AAErB,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,YAAY,IAC5D,gBAAgB,CAAC,CAAC,CAAC,CAAA;AAErB,MAAM,MAAM,sBAAsB,GAAG,CACnC,MAAM,EAAE,oBAAoB,KACzB,QAAQ,CAAC,cAAc,CAAC,CAAA;AAE7B,qBAAa,oBAAoB;IAC/B,OAAO,eAAiB;IAExB,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EACjC,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,2BAA2B,CAAC,CAAC,CAAC,GAC3D,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,iDAAiD,CAAC,EACjE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAC9C,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EACjC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EACnC,OAAO,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACtC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAe9C,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EACjC,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,2BAA2B,CAAC,CAAC,CAAC,GAC3D,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,iDAAiD,CAAC,EACjE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAC9C,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EACjC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EACnC,OAAO,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACtC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAe9C,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EACjC,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,2BAA2B,CAAC,CAAC,CAAC,GAC3D,IAAI,CAAC,CAAC,CAAC,GACP,UAAU,CAAC,iDAAiD,CAAC,GAChE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAC9C,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EACjC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EACX,OAAO,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACtC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAY9C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,cAAc,EAAE,CAE9D;CACF"}

package/dist/write-operation-builder.js

@@ -1,6 +1,6 @@
+import { rkeyFor, rkeyForCreate } from '@atproto/lex-rpc';
 import { getMain, } from '@atproto/lex-schema';
 import { com } from './lexicons/index.js';
-import { getDefaultRecordKey, getLiteralRecordKey } from './util.js';
 export class WriteOperationHelper {
     constructor() { }
     create(ns, input, options = {}) {
@@ -9,7 +9,7 @@ export class WriteOperationHelper {
         return com.atproto.repo.applyWrites.create.$build({
             collection: schema.$type,
             value,
-            rkey: options?.rkey ?? getDefaultRecordKey(schema),
+            rkey: rkeyForCreate(schema, options?.rkey),
         });
     }
     update(ns, input, options = {}) {
@@ -18,14 +18,14 @@ export class WriteOperationHelper {
         return com.atproto.repo.applyWrites.update.$build({
             collection: schema.$type,
             value,
-            rkey: options?.rkey ?? getLiteralRecordKey(schema),
+            rkey: rkeyFor(schema, options?.rkey),
         });
     }
     delete(ns, options = {}) {
         const schema = getMain(ns);
         return com.atproto.repo.applyWrites.delete.$build({
             collection: schema.$type,
-            rkey: options?.rkey ?? getLiteralRecordKey(schema),
+            rkey: rkeyFor(schema, options?.rkey),
         });
     }
     static build(factory) {

package/dist/write-operation-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-operation-builder.js","sourceRoot":"","sources":["../src/write-operation-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,OAAO,GACR,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AAEzC,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAoBpE,MAAM,OAAO,oBAAoB;IAC/B,gBAAuB,CAAC;IAaxB,MAAM,CACJ,EAAW,EACX,KAAmC,EACnC,OAAO,GAAmC,EAAoC;QAE9E,MAAM,MAAM,GAAM,OAAO,CAAC,EAAE,CAAC,CAAA;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACjC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;YAChD,UAAU,EAAE,MAAM,CAAC,KAAK;YACxB,KAAK;YACL,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,mBAAmB,CAAC,MAAM,CAAC;SACnD,CAAC,CAAA;IACJ,CAAC;IAaD,MAAM,CACJ,EAAW,EACX,KAAmC,EACnC,OAAO,GAAmC,EAAoC;QAE9E,MAAM,MAAM,GAAM,OAAO,CAAC,EAAE,CAAC,CAAA;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACjC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;YAChD,UAAU,EAAE,MAAM,CAAC,KAAK;YACxB,KAAK;YACL,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,mBAAmB,CAAC,MAAM,CAAC;SACnD,CAAC,CAAA;IACJ,CAAC;IAWD,MAAM,CACJ,EAAW,EACX,OAAO,GAAmC,EAAoC;QAE9E,MAAM,MAAM,GAAM,OAAO,CAAC,EAAE,CAAC,CAAA;QAC7B,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;YAChD,UAAU,EAAE,MAAM,CAAC,KAAK;YACxB,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,mBAAmB,CAAC,MAAM,CAAC;SACnD,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAA+B;QAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC,CAAA;IACxD,CAAC;CACF","sourcesContent":["import {\n  type $Typed,\n  type InferInput,\n  type Main,\n  type RecordSchema,\n  type Restricted,\n  getMain,\n} from '@atproto/lex-schema'\nimport { com } from './lexicons/index.js'\nimport type { RecordKeyOptions } from './util.js'\nimport { getDefaultRecordKey, getLiteralRecordKey } from './util.js'\n\nexport type WriteOperation =\n  | $Typed<com.atproto.repo.applyWrites.Create>\n  | $Typed<com.atproto.repo.applyWrites.Update>\n  | $Typed<com.atproto.repo.applyWrites.Delete>\n\nexport type WriteOperationCreateOptions<T extends RecordSchema> =\n  RecordKeyOptions<T, 'tid' | 'any'>\n\nexport type WriteOperationUpdateOptions<T extends RecordSchema> =\n  RecordKeyOptions<T>\n\nexport type WriteOperationDeleteOptions<T extends RecordSchema> =\n  RecordKeyOptions<T>\n\nexport type WriteOperationsFactory = (\n  helper: WriteOperationHelper,\n) => Iterable<WriteOperation>\n\nexport class WriteOperationHelper {\n  private constructor() {}\n\n  create<const T extends RecordSchema>(\n    ns: NonNullable<unknown> extends WriteOperationCreateOptions<T>\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n    input: Omit<InferInput<T>, '$type'>,\n  ): $Typed<com.atproto.repo.applyWrites.Create>\n  create<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<InferInput<T>, '$type'>,\n    options: WriteOperationCreateOptions<T>,\n  ): $Typed<com.atproto.repo.applyWrites.Create>\n  create<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<InferInput<T>, '$type'>,\n    options: WriteOperationCreateOptions<T> = {} as WriteOperationCreateOptions<T>,\n  ): $Typed<com.atproto.repo.applyWrites.Create> {\n    const schema: T = getMain(ns)\n    const value = schema.build(input)\n    return com.atproto.repo.applyWrites.create.$build({\n      collection: schema.$type,\n      value,\n      rkey: options?.rkey ?? getDefaultRecordKey(schema),\n    })\n  }\n\n  update<const T extends RecordSchema>(\n    ns: NonNullable<unknown> extends WriteOperationUpdateOptions<T>\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n    input: Omit<InferInput<T>, '$type'>,\n  ): $Typed<com.atproto.repo.applyWrites.Update>\n  update<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<InferInput<T>, '$type'>,\n    options: WriteOperationUpdateOptions<T>,\n  ): $Typed<com.atproto.repo.applyWrites.Update>\n  update<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<InferInput<T>, '$type'>,\n    options: WriteOperationUpdateOptions<T> = {} as WriteOperationUpdateOptions<T>,\n  ): $Typed<com.atproto.repo.applyWrites.Update> {\n    const schema: T = getMain(ns)\n    const value = schema.build(input)\n    return com.atproto.repo.applyWrites.update.$build({\n      collection: schema.$type,\n      value,\n      rkey: options?.rkey ?? getLiteralRecordKey(schema),\n    })\n  }\n\n  delete<const T extends RecordSchema>(\n    ns: NonNullable<unknown> extends WriteOperationDeleteOptions<T>\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n  ): $Typed<com.atproto.repo.applyWrites.Delete>\n  delete<const T extends RecordSchema>(\n    ns: Main<T>,\n    options: WriteOperationDeleteOptions<T>,\n  ): $Typed<com.atproto.repo.applyWrites.Delete>\n  delete<const T extends RecordSchema>(\n    ns: Main<T>,\n    options: WriteOperationDeleteOptions<T> = {} as WriteOperationDeleteOptions<T>,\n  ): $Typed<com.atproto.repo.applyWrites.Delete> {\n    const schema: T = getMain(ns)\n    return com.atproto.repo.applyWrites.delete.$build({\n      collection: schema.$type,\n      rkey: options?.rkey ?? getLiteralRecordKey(schema),\n    })\n  }\n\n  static build(factory: WriteOperationsFactory): WriteOperation[] {\n    return Array.from(factory(new WriteOperationHelper()))\n  }\n}\n"]}
+{"version":3,"file":"write-operation-builder.js","sourceRoot":"","sources":["../src/write-operation-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChF,OAAO,EAML,OAAO,GACR,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AAoBzC,MAAM,OAAO,oBAAoB;IAC/B,gBAAuB,CAAC;IAaxB,MAAM,CACJ,EAAW,EACX,KAAmC,EACnC,OAAO,GAAmC,EAAoC;QAE9E,MAAM,MAAM,GAAM,OAAO,CAAC,EAAE,CAAC,CAAA;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACjC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;YAChD,UAAU,EAAE,MAAM,CAAC,KAAK;YACxB,KAAK;YACL,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;SAC3C,CAAC,CAAA;IACJ,CAAC;IAaD,MAAM,CACJ,EAAW,EACX,KAAmC,EACnC,OAAO,GAAmC,EAAoC;QAE9E,MAAM,MAAM,GAAM,OAAO,CAAC,EAAE,CAAC,CAAA;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACjC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;YAChD,UAAU,EAAE,MAAM,CAAC,KAAK;YACxB,KAAK;YACL,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;SACrC,CAAC,CAAA;IACJ,CAAC;IAWD,MAAM,CACJ,EAAW,EACX,OAAO,GAAmC,EAAoC;QAE9E,MAAM,MAAM,GAAM,OAAO,CAAC,EAAE,CAAC,CAAA;QAC7B,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;YAChD,UAAU,EAAE,MAAM,CAAC,KAAK;YACxB,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;SACrC,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAA+B;QAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC,CAAA;IACxD,CAAC;CACF","sourcesContent":["import { type RecordKeyOptions, rkeyFor, rkeyForCreate } from '@atproto/lex-rpc'\nimport {\n  type $Typed,\n  type InferInput,\n  type Main,\n  type RecordSchema,\n  type Restricted,\n  getMain,\n} from '@atproto/lex-schema'\nimport { com } from './lexicons/index.js'\n\nexport type WriteOperation =\n  | $Typed<com.atproto.repo.applyWrites.Create>\n  | $Typed<com.atproto.repo.applyWrites.Update>\n  | $Typed<com.atproto.repo.applyWrites.Delete>\n\nexport type WriteOperationCreateOptions<T extends RecordSchema> =\n  RecordKeyOptions<T, 'tid' | 'any'>\n\nexport type WriteOperationUpdateOptions<T extends RecordSchema> =\n  RecordKeyOptions<T>\n\nexport type WriteOperationDeleteOptions<T extends RecordSchema> =\n  RecordKeyOptions<T>\n\nexport type WriteOperationsFactory = (\n  helper: WriteOperationHelper,\n) => Iterable<WriteOperation>\n\nexport class WriteOperationHelper {\n  private constructor() {}\n\n  create<const T extends RecordSchema>(\n    ns: NonNullable<unknown> extends WriteOperationCreateOptions<T>\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n    input: Omit<InferInput<T>, '$type'>,\n  ): $Typed<com.atproto.repo.applyWrites.Create>\n  create<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<InferInput<T>, '$type'>,\n    options: WriteOperationCreateOptions<T>,\n  ): $Typed<com.atproto.repo.applyWrites.Create>\n  create<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<InferInput<T>, '$type'>,\n    options: WriteOperationCreateOptions<T> = {} as WriteOperationCreateOptions<T>,\n  ): $Typed<com.atproto.repo.applyWrites.Create> {\n    const schema: T = getMain(ns)\n    const value = schema.build(input)\n    return com.atproto.repo.applyWrites.create.$build({\n      collection: schema.$type,\n      value,\n      rkey: rkeyForCreate(schema, options?.rkey),\n    })\n  }\n\n  update<const T extends RecordSchema>(\n    ns: NonNullable<unknown> extends WriteOperationUpdateOptions<T>\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n    input: Omit<InferInput<T>, '$type'>,\n  ): $Typed<com.atproto.repo.applyWrites.Update>\n  update<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<InferInput<T>, '$type'>,\n    options: WriteOperationUpdateOptions<T>,\n  ): $Typed<com.atproto.repo.applyWrites.Update>\n  update<const T extends RecordSchema>(\n    ns: Main<T>,\n    input: Omit<InferInput<T>, '$type'>,\n    options: WriteOperationUpdateOptions<T> = {} as WriteOperationUpdateOptions<T>,\n  ): $Typed<com.atproto.repo.applyWrites.Update> {\n    const schema: T = getMain(ns)\n    const value = schema.build(input)\n    return com.atproto.repo.applyWrites.update.$build({\n      collection: schema.$type,\n      value,\n      rkey: rkeyFor(schema, options?.rkey),\n    })\n  }\n\n  delete<const T extends RecordSchema>(\n    ns: NonNullable<unknown> extends WriteOperationDeleteOptions<T>\n      ? Main<T>\n      : Restricted<'This record type requires an \"options\" argument'>,\n  ): $Typed<com.atproto.repo.applyWrites.Delete>\n  delete<const T extends RecordSchema>(\n    ns: Main<T>,\n    options: WriteOperationDeleteOptions<T>,\n  ): $Typed<com.atproto.repo.applyWrites.Delete>\n  delete<const T extends RecordSchema>(\n    ns: Main<T>,\n    options: WriteOperationDeleteOptions<T> = {} as WriteOperationDeleteOptions<T>,\n  ): $Typed<com.atproto.repo.applyWrites.Delete> {\n    const schema: T = getMain(ns)\n    return com.atproto.repo.applyWrites.delete.$build({\n      collection: schema.$type,\n      rkey: rkeyFor(schema, options?.rkey),\n    })\n  }\n\n  static build(factory: WriteOperationsFactory): WriteOperation[] {\n    return Array.from(factory(new WriteOperationHelper()))\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atproto/lex-client",
-  "version": "0.3.6",
+  "version": "0.4.0",
   "license": "MIT",
   "description": "HTTP client for interacting with Lexicon based APIs",
   "keywords": [
@@ -33,17 +33,24 @@
   },
   "dependencies": {
     "tslib": "^2.8.1",
-    "@atproto/lex-data": "^0.1.7",
-    "@atproto/lex-json": "^0.1.6",
-    "@atproto/lex-schema": "^0.2.7"
+    "@atproto/lex-data": "^0.1.8",
+    "@atproto/lex-schema": "^0.2.9",
+    "@atproto/lex-rpc": "^0.0.1"
   },
   "devDependencies": {
     "vitest": "^4.1.10",
-    "@atproto/lex-builder": "^0.1.15",
-    "@atproto/lex-cbor": "^0.1.6"
+    "@atproto/lex-cbor": "^0.1.7",
+    "@atproto/lex-builder": "^0.1.18",
+    "@atproto/lex-installer": "^0.2.0",
+    "@atproto/lex-json": "^0.1.7"
   },
   "scripts": {
-    "codegen:lex": "node ./scripts/lex-build.js",
+    "lex:build": "lex-builder build --out ./src/lexicons --clear --lib @atproto/lex-schema --index-file --default-export",
+    "lex:install": "lex-installer install",
+    "postlex:install": "pnpm run lex:build",
+    "lex:update": "lex-installer update",
+    "postlex:update": "pnpm run lex:build",
+    "codegen:lex": "pnpm run lex:install --ci",
     "prebuild": "pnpm run '/^(codegen:.+)$/'",
     "build": "tsc --build tsconfig.build.json",
     "test": "vitest run"

package/dist/agent.d.ts

@@ -1,127 +0,0 @@
-import type { DidString } from '@atproto/lex-schema';
-/**
- * A function that performs HTTP requests towards a service endpoint.
- *
- * 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 can also be responsible for adding any necessary
- * headers, such as authorization tokens.
- *
- * @param path - The URL path (pathname + query parameters) without the origin
- * @param init - Standard fetch RequestInit options
- * @returns A Promise resolving to the HTTP Response
- */
-export type FetchHandler = (
-/**
- * The URL (pathname + query parameters) to make the request to, without the
- * 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>;
-/**
- * Core interface for making XRPC requests towards a specific service.
- *
- * 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.
- *
- * @example
- * ```typescript
- * const agent: Agent = {
- *   did: 'did:plc:example123',
- *   fetchHandler: async (path, init) => {
- *     const url = new URL(path, 'https://bsky.social')
- *     return fetch(url, init)
- *   }
- * }
- * ```
- */
-export interface Agent {
-    /** The DID of the authenticated user, or `undefined` if unauthenticated. */
-    readonly did?: DidString;
-    /** 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.
-     */
-    did?: DidString;
-    /**
-     * The service URL to make requests to. This can be a string, URL, or a
-     * function that returns a string or URL. This is useful for dynamic URLs,
-     * such as a service URL that changes based on authentication.
-     */
-    service: string | URL;
-    /**
-     * Optional headers to include with every request made by this agent, unless
-     * overridden by the request-specific headers provided to the fetch handler.
-     */
-    headers?: HeadersInit;
-    /**
-     * Bring your own fetch implementation. Typically useful for testing, logging,
-     * mocking, or adding retries, session management, signatures, proof of
-     * possession (DPoP), SSRF protection, etc. Defaults to the global `fetch`
-     * function.
-     */
-    fetch?: typeof globalThis.fetch;
-    fetchHandler?: never;
-};
-/**
- * Options for creating an Agent.
- *
- * Can be a full {@link AgentConfig} object, or a simple service URL string/{@link URL}.
- */
-export type AgentOptions = AgentConfig | FetchHandler | 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.
- *
- * @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 // From existing Agent
- * ```typescript
- * const existingAgent: Agent = { ... }
- * const agent = buildAgent(existingAgent)
- * ```
- *
- * @example // From agent like object with fetchHandler
- * ```typescript
- * const agent = buildAgent({
- *   did: 'did:plc:example',
- *   fetchHandler: async (path, init) => { ... }
- *   // @NOTE "headers" and "service" are not allowed when providing a fetchHandler, because the input will returned "as is" if it matched the "Agent" interface.
- * })
- * ```
- */
-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 +0,0 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGpD;;;;;;;;;;;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;IAK/B,YAAY,CAAC,EAAE,KAAK,CAAA;CACrB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,GAAG,GAAG,CAAA;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;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 +0,0 @@
-import { mergeHeaders } from './util.js';
-export 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'));
-}
-export function buildAgent(options) {
-    if (typeof options === 'function') {
-        return { did: undefined, fetchHandler: options };
-    }
-    const config = typeof options === 'string' || options instanceof URL
-        ? { did: undefined, service: options }
-        : options;
-    // Prevent mismatch between `fetchHandler` and `headers` in the config, since
-    // `headers` would be ignored if `fetchHandler` is provided.
-    if ('fetchHandler' in config) {
-        if (isAgent(config))
-            return config;
-        throw new TypeError('fetchHandler must not be provided when using AgentConfig');
-    }
-    const { did, service, fetch = globalThis.fetch, headers: defaultHeaders, } = config;
-    if (typeof fetch !== 'function') {
-        throw new TypeError('fetch() is not available in this environment');
-    }
-    return {
-        get did() {
-            return did;
-        },
-        async fetchHandler(path, init) {
-            const headers = defaultHeaders != null && init.headers != null
-                ? mergeHeaders(defaultHeaders, init.headers)
-                : defaultHeaders || init.headers;
-            return fetch(new URL(path, service), headers !== init.headers ? { ...init, headers } : init);
-        },
-    };
-}
-//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AA0DxC,MAAM,UAAU,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;AAqFD,MAAM,UAAU,UAAU,CAAC,OAA6B;IACtD,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,CAAA;IAClD,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,6EAA6E;IAC7E,4DAA4D;IAC5D,IAAI,cAAc,IAAI,MAAM,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAA;QAElC,MAAM,IAAI,SAAS,CACjB,0DAA0D,CAC3D,CAAA;IACH,CAAC;IAED,MAAM,EACJ,GAAG,EACH,OAAO,EACP,KAAK,GAAG,UAAU,CAAC,KAAK,EACxB,OAAO,EAAE,cAAc,GACxB,GAAG,MAAM,CAAA;IAEV,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAA;IACrE,CAAC;IAED,OAAO;QACL,IAAI,GAAG;YACL,OAAO,GAAG,CAAA;QACZ,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI;YAC3B,MAAM,OAAO,GACX,cAAc,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI;gBAC5C,CAAC,CAAC,YAAY,CAAC,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC;gBAC5C,CAAC,CAAC,cAAc,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","sourcesContent":["import type { DidString } from '@atproto/lex-schema'\nimport { mergeHeaders } from './util.js'\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  // Because this type get unioned with `Agent`, we need to prevent TypeScript\n  // from accepting `headers` when `fetchHandler` is provided, since `headers`\n  // would not be used (while the user might expect it to be).\n  fetchHandler?: never\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 | FetchHandler | 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 *\n * @example // From existing Agent\n * ```typescript\n * const existingAgent: Agent = { ... }\n * const agent = buildAgent(existingAgent)\n * ```\n *\n * @example // From agent like object with fetchHandler\n * ```typescript\n * const agent = buildAgent({\n *   did: 'did:plc:example',\n *   fetchHandler: async (path, init) => { ... }\n *   // @NOTE \"headers\" and \"service\" are not allowed when providing a fetchHandler, because the input will returned \"as is\" if it matched the \"Agent\" interface.\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 (typeof options === 'function') {\n    return { did: undefined, fetchHandler: options }\n  }\n\n  const config: Agent | AgentConfig =\n    typeof options === 'string' || options instanceof URL\n      ? { did: undefined, service: options }\n      : options\n\n  // Prevent mismatch between `fetchHandler` and `headers` in the config, since\n  // `headers` would be ignored if `fetchHandler` is provided.\n  if ('fetchHandler' in config) {\n    if (isAgent(config)) return config\n\n    throw new TypeError(\n      'fetchHandler must not be provided when using AgentConfig',\n    )\n  }\n\n  const {\n    did,\n    service,\n    fetch = globalThis.fetch,\n    headers: defaultHeaders,\n  } = 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 did\n    },\n\n    async fetchHandler(path, init) {\n      const headers =\n        defaultHeaders != null && init.headers != null\n          ? mergeHeaders(defaultHeaders, init.headers)\n          : defaultHeaders || init.headers\n\n      return fetch(\n        new URL(path, service),\n        headers !== init.headers ? { ...init, headers } : init,\n      )\n    },\n  }\n}\n"]}

package/dist/errors.d.ts

@@ -1,277 +0,0 @@
-import type { LexErrorCode, LexErrorData, LexValue } from '@atproto/lex-data';
-import { LexError } from '@atproto/lex-data';
-import { type InferMethodError, type LexValidationError, type Procedure, type Query, type ResultFailure } from '@atproto/lex-schema';
-import type { XrpcUnknownResponsePayload } from './types.js';
-import type { WWWAuthenticate } from './www-authenticate.js';
-export type { XrpcUnknownResponsePayload };
-export type DownstreamError<N extends LexErrorCode = LexErrorCode> = {
-    status: number;
-    headers?: Headers;
-    encoding?: 'application/json';
-    body: LexErrorData<N>;
-};
-/**
- * HTTP status codes that indicate a transient error that may succeed on retry.
- *
- * Includes:
- * - 408 Request Timeout
- * - 425 Too Early
- * - 429 Too Many Requests (rate limited)
- * - 500 Internal Server Error
- * - 502 Bad Gateway
- * - 503 Service Unavailable
- * - 504 Gateway Timeout
- * - 522 Connection Timed Out (Cloudflare)
- * - 524 A Timeout Occurred (Cloudflare)
- */
-export declare const RETRYABLE_HTTP_STATUS_CODES: ReadonlySet<number>;
-export { LexError };
-export type { LexErrorCode, LexErrorData };
-/**
- * The payload structure for XRPC error responses.
- *
- * All XRPC errors return JSON with an `error` code and optional `message`.
- *
- * @typeParam N - The specific error code type
- */
-export type XrpcErrorPayload<N extends LexErrorCode = LexErrorCode> = {
-    body: LexErrorData<N>;
-    encoding: 'application/json';
-};
-/**
- * All unsuccessful responses should follow a standard error response
- * schema. The Content-Type should be application/json, and the payload
- * should be a JSON object with the following fields:
- *
- * - `error` (string, required): type name of the error (generic ASCII
- *   constant, no whitespace)
- * - `message` (string, optional): description of the error, appropriate for
- *   display to humans
- *
- * This function checks whether a given payload matches this schema.
- */
-export declare function isXrpcErrorPayload(payload: XrpcUnknownResponsePayload | null | undefined): payload is XrpcErrorPayload;
-/**
- * Abstract base class for all XRPC errors.
- *
- * Extends {@link LexError} and implements {@link ResultFailure} for use with
- * safe/result-based error handling patterns.
- *
- * @typeParam M - The XRPC method type (Procedure or Query)
- * @typeParam N - The error code type
- * @typeParam TReason - The reason type for ResultFailure
- *
- * @see {@link XrpcResponseError} - For valid XRPC error responses
- * @see {@link XrpcInvalidResponseError} - For invalid/unexpected responses
- * @see {@link XrpcInternalError} - For network/internal errors
- */
-export declare abstract class XrpcError<M extends Procedure | Query = Procedure | Query, N extends LexErrorCode = LexErrorCode, TReason = unknown> extends LexError<N> implements ResultFailure<TReason> {
-    readonly method: M;
-    name: string;
-    constructor(method: M, error: N, message?: string, options?: ErrorOptions);
-    /**
-     * @see {@link ResultFailure.success}
-     */
-    readonly success: false;
-    /**
-     * @see {@link ResultFailure.reason}
-     */
-    abstract readonly reason: TReason;
-    /**
-     * Indicates whether the error is transient and can be retried.
-     */
-    abstract shouldRetry(): boolean;
-    abstract toDownstreamError(): DownstreamError;
-    matchesSchemaErrors(): this is XrpcError<M, InferMethodError<M>>;
-}
-/**
- * Error class for valid XRPC error responses from the server.
- *
- * This represents a properly formatted XRPC error where the server returned
- * a non-2xx status with a valid JSON error payload containing `error` and
- * optional `message` fields.
- *
- * Use {@link matchesSchemaErrors} to check if the error matches the method's declared
- * error types for type-safe error handling.
- *
- * @typeParam M - The XRPC method type
- * @typeParam N - The error code type (inferred from method or generic)
- *
- * @example Handling specific errors
- * ```typescript
- * try {
- *   await client.xrpc(someMethod, options)
- * } catch (err) {
- *   if (err instanceof XrpcResponseError && err.error === 'RecordNotFound') {
- *     // Handle not found case
- *   }
- * }
- * ```
- */
-export declare class XrpcResponseError<M extends Procedure | Query = Procedure | Query> extends XrpcError<M, LexErrorCode, XrpcResponseError<M>> {
-    readonly response: Response;
-    readonly payload?: XrpcUnknownResponsePayload | undefined;
-    name: string;
-    constructor(method: M, response: Response, payload?: XrpcUnknownResponsePayload | undefined, options?: ErrorOptions);
-    get reason(): this;
-    shouldRetry(): boolean;
-    toJSON(): LexErrorData;
-    toDownstreamError(): DownstreamError;
-    get status(): number;
-    get headers(): Headers;
-    get body(): undefined | Uint8Array | LexValue;
-}
-export type { WWWAuthenticate };
-/**
- * Error class for 401 Unauthorized XRPC responses.
- *
- * Extends {@link XrpcResponseError} with access to parsed WWW-Authenticate header
- * information, useful for implementing authentication flows.
- *
- * Authentication errors are never retryable as they require user intervention
- * (e.g., re-authentication, token refresh).
- *
- * @typeParam M - The XRPC method type
- * @typeParam N - The error code type
- *
- * @example Handling authentication errors
- * ```typescript
- * try {
- *   await client.xrpc(someMethod, options)
- * } catch (err) {
- *   if (err instanceof XrpcAuthenticationError) {
- *     const { DPoP } = err.wwwAuthenticate
- *     if (DPoP?.error === 'use_dpop_nonce') {
- *       // Handle DPoP nonce requirement
- *     }
- *   }
- * }
- * ```
- */
-export declare class XrpcAuthenticationError<M extends Procedure | Query = Procedure | Query> extends XrpcResponseError<M> {
-    #private;
-    name: string;
-    shouldRetry(): boolean;
-    /**
-     * Parsed WWW-Authenticate header from the response.
-     * Contains authentication scheme parameters (e.g., Bearer realm, DPoP nonce).
-     */
-    get wwwAuthenticate(): WWWAuthenticate;
-}
-/**
- * Error class for invalid or unprocessable XRPC responses from upstream servers.
- *
- * This occurs when the server returns a response that doesn't conform to the
- * XRPC protocol, such as:
- * - Missing or invalid Content-Type header
- * - Response body that doesn't match the method's output schema
- * - Non-JSON error responses
- * - Responses from non-XRPC endpoints
- *
- * The error code is always 'InvalidResponse' and maps to HTTP 502 Bad Gateway
- * when converted to a response. This should allow downstream clients to
- * determine at which boundary the error occurred.
- *
- * @typeParam M - The XRPC method type
- */
-export declare class XrpcInvalidResponseError<M extends Procedure | Query = Procedure | Query> extends XrpcError<M, 'InvalidResponse', XrpcInvalidResponseError<M>> {
-    readonly response: Response;
-    readonly payload?: XrpcUnknownResponsePayload | undefined;
-    name: string;
-    constructor(method: M, response: Response, payload?: XrpcUnknownResponsePayload | undefined, message?: string, options?: ErrorOptions);
-    get reason(): this;
-    shouldRetry(): boolean;
-    toDownstreamError(): DownstreamError;
-}
-/**
- * Error class for invalid XRPC responses that fail schema validation.
- *
- * This is a specific type of {@link XrpcInvalidResponseError} that indicates the
- * upstream server returned a response that was structurally valid but did not
- * conform to the expected schema for the method. This likely indicates a
- * mismatch between client and server versions or an issue with the server's
- * XRPC implementation.
- *
- * @typeParam M - The XRPC method type
- */
-export declare class XrpcResponseValidationError<M extends Procedure | Query = Procedure | Query> extends XrpcInvalidResponseError<M> {
-    readonly cause: LexValidationError;
-    name: string;
-    constructor(method: M, response: Response, payload: XrpcUnknownResponsePayload, cause: LexValidationError);
-}
-/**
- * Error class for unexpected internal/client-side errors during XRPC requests.
- *
- * The error code is always 'InternalServerError' and these errors not
- * considered retryable as they stem from unforeseen issues in the
- * implementation.
- *
- * @typeParam M - The XRPC method type
- */
-export declare class XrpcInternalError<M extends Procedure | Query = Procedure | Query> extends XrpcError<M, 'InternalServerError', XrpcInternalError<M>> {
-    name: string;
-    constructor(method: M, message?: string, options?: ErrorOptions);
-    get reason(): this;
-    shouldRetry(): boolean;
-    toJSON(): LexErrorData;
-    toDownstreamError(): DownstreamError;
-}
-/**
- * Special case of XrpcInternalError that specifically represents errors thrown
- * by {@link Agent.fetchHandler} during the XRPC request. This includes:
- * - Network errors (connection refused, DNS failure)
- * - Request timeouts
- * - Request aborted via AbortSignal
- *
- * These errors are optimistically considered retryable, as many fetch errors
- * are transient and may succeed on retry.
- */
-export declare class XrpcFetchError<M extends Procedure | Query = Procedure | Query> extends XrpcInternalError<M> {
-    name: string;
-    constructor(method: M, cause: unknown);
-    shouldRetry(): boolean;
-    toJSON(): LexErrorData;
-    toDownstreamError(): DownstreamError;
-}
-/**
- * Union type of all possible XRPC failure types.
- *
- * Used as the return type for safe/non-throwing XRPC methods. Check the
- * `success` property to distinguish between success and failure:
- *
- * @typeParam M - The XRPC method type
- *
- * @example
- * ```typescript
- * const result = await client.xrpcSafe(someMethod, options)
- * if (result.success) {
- *   console.log(result.body) // XrpcResponse
- * } else {
- *   // result is XrpcFailure (XrpcResponseError | XrpcInvalidResponseError | XrpcInternalError)
- *   console.error(result.error, result.message)
- * }
- * ```
- */
-export type XrpcFailure<M extends Procedure | Query = Procedure | Query> = XrpcResponseError<M> | XrpcInvalidResponseError<M> | XrpcInternalError<M>;
-/**
- * Converts an unknown error into an appropriate {@link XrpcFailure} type.
- *
- * If the error is already an XrpcFailure for the given method, returns it as-is.
- * Otherwise, wraps it in an {@link XrpcInternalError}.
- *
- * @param method - The XRPC method that was called
- * @param cause - The error to convert
- * @returns An XrpcFailure instance
- *
- * @example
- * ```typescript
- * try {
- *   const response = await fetch(...)
- *   // ... process response
- * } catch (err) {
- *   return asXrpcFailure(method, err)
- * }
- * ```
- */
-export declare function asXrpcFailure<M extends Procedure | Query>(method: M, cause: unknown): XrpcFailure<M>;
-//# sourceMappingURL=errors.d.ts.map