@atproto/lex-schema 0.0.0

package/dist/schema/ref.d.ts

@@ -0,0 +1,10 @@
+import { ValidationResult, Validator, ValidatorContext } from '../validation.js';
+export type RefSchemaGetter<V> = () => Validator<V>;
+export declare class RefSchema<V = any> extends Validator<V> {
+    #private;
+    readonly lexiconType: "ref";
+    constructor(getter: RefSchemaGetter<V>);
+    get schema(): Validator<V>;
+    validateInContext(input: unknown, ctx: ValidatorContext): ValidationResult<V>;
+}
+//# sourceMappingURL=ref.d.ts.map

package/dist/schema/ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.d.ts","sourceRoot":"","sources":["../../src/schema/ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEhF,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,MAAM,SAAS,CAAC,CAAC,CAAC,CAAA;AAEnD,qBAAa,SAAS,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;;IAClD,QAAQ,CAAC,WAAW,EAAG,KAAK,CAAS;gBAIzB,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAStC,IAAI,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,CAgBzB;IAEQ,iBAAiB,CACxB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,gBAAgB,GACpB,gBAAgB,CAAC,CAAC,CAAC;CAGvB"}

package/dist/schema/ref.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefSchema = void 0;
+const validation_js_1 = require("../validation.js");
+class RefSchema extends validation_js_1.Validator {
+    lexiconType = 'ref';
+    #getter;
+    constructor(getter) {
+        // @NOTE In order to avoid circular dependency issues, we don't resolve
+        // the schema here. Instead, we resolve it lazily when first accessed.
+        super();
+        this.#getter = getter;
+    }
+    get schema() {
+        const value = this.#getter.call(null);
+        // Prevents a getter from depending on itself recursively, also allows GC to
+        // clean up the getter function.
+        this.#getter = throwAlreadyCalled;
+        // Disable the getter and cache the resolved schema on the instance
+        Object.defineProperty(this, 'schema', {
+            value,
+            writable: false,
+            enumerable: false,
+            configurable: true,
+        });
+        return value;
+    }
+    validateInContext(input, ctx) {
+        return ctx.validate(input, this.schema);
+    }
+}
+exports.RefSchema = RefSchema;
+function throwAlreadyCalled() {
+    throw new Error('RefSchema getter called multiple times');
+}
+//# sourceMappingURL=ref.js.map

package/dist/schema/ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../../src/schema/ref.ts"],"names":[],"mappings":";;;AAAA,oDAAgF;AAIhF,MAAa,SAAmB,SAAQ,yBAAY;IACzC,WAAW,GAAG,KAAc,CAAA;IAErC,OAAO,CAAoB;IAE3B,YAAY,MAA0B;QACpC,uEAAuE;QACvE,sEAAsE;QAEtE,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAED,IAAI,MAAM;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAErC,4EAA4E;QAC5E,gCAAgC;QAChC,IAAI,CAAC,OAAO,GAAG,kBAAkB,CAAA;QAEjC,mEAAmE;QACnE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE;YACpC,KAAK;YACL,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAA;QAEF,OAAO,KAAK,CAAA;IACd,CAAC;IAEQ,iBAAiB,CACxB,KAAc,EACd,GAAqB;QAErB,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;IACzC,CAAC;CACF;AAtCD,8BAsCC;AAED,SAAS,kBAAkB;IACzB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;AAC3D,CAAC","sourcesContent":["import { ValidationResult, Validator, ValidatorContext } from '../validation.js'\n\nexport type RefSchemaGetter<V> = () => Validator<V>\n\nexport class RefSchema<V = any> extends Validator<V> {\n  readonly lexiconType = 'ref' as const\n\n  #getter: RefSchemaGetter<V>\n\n  constructor(getter: RefSchemaGetter<V>) {\n    // @NOTE In order to avoid circular dependency issues, we don't resolve\n    // the schema here. Instead, we resolve it lazily when first accessed.\n\n    super()\n\n    this.#getter = getter\n  }\n\n  get schema(): Validator<V> {\n    const value = this.#getter.call(null)\n\n    // Prevents a getter from depending on itself recursively, also allows GC to\n    // clean up the getter function.\n    this.#getter = throwAlreadyCalled\n\n    // Disable the getter and cache the resolved schema on the instance\n    Object.defineProperty(this, 'schema', {\n      value,\n      writable: false,\n      enumerable: false,\n      configurable: true,\n    })\n\n    return value\n  }\n\n  override validateInContext(\n    input: unknown,\n    ctx: ValidatorContext,\n  ): ValidationResult<V> {\n    return ctx.validate(input, this.schema)\n  }\n}\n\nfunction throwAlreadyCalled(): never {\n  throw new Error('RefSchema getter called multiple times')\n}\n"]}

package/dist/schema/string.d.ts

@@ -0,0 +1,24 @@
+import { InferStringFormat, StringFormat, UnknownString } from '../core.js';
+import { ValidationResult, Validator, ValidatorContext } from '../validation.js';
+export type StringSchemaOptions = {
+    default?: string;
+    knownValues?: readonly string[];
+    format?: StringFormat;
+    minLength?: number;
+    maxLength?: number;
+    minGraphemes?: number;
+    maxGraphemes?: number;
+};
+export type StringSchemaOutput<Options> = Options extends {
+    format: infer F extends StringFormat;
+} ? InferStringFormat<F> : Options extends {
+    knownValues: readonly (infer K extends string)[];
+} ? K | UnknownString : string;
+export declare class StringSchema<const Options extends StringSchemaOptions = any> extends Validator<StringSchemaOutput<Options>> {
+    readonly options: Options;
+    readonly lexiconType: "string";
+    constructor(options: Options);
+    validateInContext(input: unknown | undefined, ctx: ValidatorContext): ValidationResult<StringSchemaOutput<Options>>;
+}
+export declare function coerceToString(input: unknown): string | null;
+//# sourceMappingURL=string.d.ts.map

package/dist/schema/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/schema/string.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,aAAa,EAEd,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAGhF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,kBAAkB,CAAC,OAAO,IAEpC,OAAO,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,SAAS,YAAY,CAAA;CAAE,GACpD,iBAAiB,CAAC,CAAC,CAAC,GACpB,OAAO,SAAS;IAAE,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,EAAE,CAAA;CAAE,GAClE,CAAC,GAAG,aAAa,GACjB,MAAM,CAAA;AAEd,qBAAa,YAAY,CACvB,KAAK,CAAC,OAAO,SAAS,mBAAmB,GAAG,GAAG,CAC/C,SAAQ,SAAS,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAGlC,QAAQ,CAAC,OAAO,EAAE,OAAO;IAFrC,QAAQ,CAAC,WAAW,EAAG,QAAQ,CAAS;gBAEnB,OAAO,EAAE,OAAO;IAI5B,iBAAiB,CAExB,KAAK,EAAE,OAAO,YAAuB,EACrC,GAAG,EAAE,gBAAgB,GACpB,gBAAgB,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;CA6DjD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAkC5D"}

package/dist/schema/string.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StringSchema = void 0;
+exports.coerceToString = coerceToString;
+const lex_data_1 = require("@atproto/lex-data");
+const core_js_1 = require("../core.js");
+const validation_js_1 = require("../validation.js");
+const token_js_1 = require("./token.js");
+class StringSchema extends validation_js_1.Validator {
+    options;
+    lexiconType = 'string';
+    constructor(options) {
+        super();
+        this.options = options;
+    }
+    validateInContext(
+    // @NOTE validation will be applied on the default value as well
+    input = this.options.default, ctx) {
+        const { options } = this;
+        const str = coerceToString(input);
+        if (str == null) {
+            return ctx.issueInvalidType(input, 'string');
+        }
+        let lazyUtf8Len;
+        const { minLength } = options;
+        if (minLength != null) {
+            if ((lazyUtf8Len ??= (0, lex_data_1.utf8Len)(str)) < minLength) {
+                return ctx.issueTooSmall(str, 'string', minLength, lazyUtf8Len);
+            }
+        }
+        const { maxLength } = options;
+        if (maxLength != null) {
+            // Optimization: we can avoid computing the UTF-8 length if the maximum
+            // possible length, in bytes, of the input JS string is smaller than the
+            // maxLength (in UTF-8 string bytes).
+            if (str.length * 3 <= maxLength) {
+                // Input string so small it can't possibly exceed maxLength
+            }
+            else if ((lazyUtf8Len ??= (0, lex_data_1.utf8Len)(str)) > maxLength) {
+                return ctx.issueTooBig(str, 'string', maxLength, lazyUtf8Len);
+            }
+        }
+        let lazyGraphLen;
+        const { minGraphemes } = options;
+        if (minGraphemes != null) {
+            // Optimization: avoid counting graphemes if the length check already fails
+            if (str.length < minGraphemes) {
+                return ctx.issueTooSmall(str, 'grapheme', minGraphemes, str.length);
+            }
+            else if ((lazyGraphLen ??= (0, lex_data_1.graphemeLen)(str)) < minGraphemes) {
+                return ctx.issueTooSmall(str, 'grapheme', minGraphemes, lazyGraphLen);
+            }
+        }
+        const { maxGraphemes } = options;
+        if (maxGraphemes != null) {
+            if ((lazyGraphLen ??= (0, lex_data_1.graphemeLen)(str)) > maxGraphemes) {
+                return ctx.issueTooBig(str, 'grapheme', maxGraphemes, lazyGraphLen);
+            }
+        }
+        if (options.format !== undefined) {
+            try {
+                // @TODO optimize to avoid throw cost (requires re-writing utilities
+                // from @atproto/syntax)
+                (0, core_js_1.assertStringFormat)(str, options.format);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : undefined;
+                return ctx.issueInvalidFormat(str, options.format, message);
+            }
+        }
+        return ctx.success(str);
+    }
+}
+exports.StringSchema = StringSchema;
+function coerceToString(input) {
+    switch (typeof input) {
+        case 'string':
+            return input;
+        case 'object': {
+            if (input == null)
+                return null;
+            // @NOTE Allow using TokenSchema instances in places expecting strings,
+            // converting them to their string value.
+            if (input instanceof token_js_1.TokenSchema) {
+                return input.toString();
+            }
+            if (input instanceof Date) {
+                if (Number.isNaN(input.getTime()))
+                    return null;
+                return input.toISOString();
+            }
+            if (input instanceof URL) {
+                return input.toString();
+            }
+            const cid = lex_data_1.CID.asCID(input);
+            if (cid)
+                return cid.toString();
+            if (input instanceof String) {
+                return input.valueOf();
+            }
+        }
+        // falls through
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=string.js.map

package/dist/schema/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../src/schema/string.ts"],"names":[],"mappings":"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","sourcesContent":["import { CID, graphemeLen, utf8Len } from '@atproto/lex-data'\nimport {\n  InferStringFormat,\n  StringFormat,\n  UnknownString,\n  assertStringFormat,\n} from '../core.js'\nimport { ValidationResult, Validator, ValidatorContext } from '../validation.js'\nimport { TokenSchema } from './token.js'\n\nexport type StringSchemaOptions = {\n  default?: string\n  knownValues?: readonly string[]\n  format?: StringFormat\n  minLength?: number\n  maxLength?: number\n  minGraphemes?: number\n  maxGraphemes?: number\n}\n\nexport type StringSchemaOutput<Options> =\n  //\n  Options extends { format: infer F extends StringFormat }\n    ? InferStringFormat<F>\n    : Options extends { knownValues: readonly (infer K extends string)[] }\n      ? K | UnknownString\n      : string\n\nexport class StringSchema<\n  const Options extends StringSchemaOptions = any,\n> extends Validator<StringSchemaOutput<Options>> {\n  readonly lexiconType = 'string' as const\n\n  constructor(readonly options: Options) {\n    super()\n  }\n\n  override validateInContext(\n    // @NOTE validation will be applied on the default value as well\n    input: unknown = this.options.default,\n    ctx: ValidatorContext,\n  ): ValidationResult<StringSchemaOutput<Options>> {\n    const { options } = this\n\n    const str = coerceToString(input)\n    if (str == null) {\n      return ctx.issueInvalidType(input, 'string')\n    }\n\n    let lazyUtf8Len: number\n\n    const { minLength } = options\n    if (minLength != null) {\n      if ((lazyUtf8Len ??= utf8Len(str)) < minLength) {\n        return ctx.issueTooSmall(str, 'string', minLength, lazyUtf8Len)\n      }\n    }\n\n    const { maxLength } = options\n    if (maxLength != null) {\n      // Optimization: we can avoid computing the UTF-8 length if the maximum\n      // possible length, in bytes, of the input JS string is smaller than the\n      // maxLength (in UTF-8 string bytes).\n      if (str.length * 3 <= maxLength) {\n        // Input string so small it can't possibly exceed maxLength\n      } else if ((lazyUtf8Len ??= utf8Len(str)) > maxLength) {\n        return ctx.issueTooBig(str, 'string', maxLength, lazyUtf8Len)\n      }\n    }\n\n    let lazyGraphLen: number\n\n    const { minGraphemes } = options\n    if (minGraphemes != null) {\n      // Optimization: avoid counting graphemes if the length check already fails\n      if (str.length < minGraphemes) {\n        return ctx.issueTooSmall(str, 'grapheme', minGraphemes, str.length)\n      } else if ((lazyGraphLen ??= graphemeLen(str)) < minGraphemes) {\n        return ctx.issueTooSmall(str, 'grapheme', minGraphemes, lazyGraphLen)\n      }\n    }\n\n    const { maxGraphemes } = options\n    if (maxGraphemes != null) {\n      if ((lazyGraphLen ??= graphemeLen(str)) > maxGraphemes) {\n        return ctx.issueTooBig(str, 'grapheme', maxGraphemes, lazyGraphLen)\n      }\n    }\n\n    if (options.format !== undefined) {\n      try {\n        // @TODO optimize to avoid throw cost (requires re-writing utilities\n        // from @atproto/syntax)\n        assertStringFormat(str, options.format)\n      } catch (err) {\n        const message = err instanceof Error ? err.message : undefined\n        return ctx.issueInvalidFormat(str, options.format, message)\n      }\n    }\n\n    return ctx.success(str as StringSchemaOutput<Options>)\n  }\n}\n\nexport function coerceToString(input: unknown): string | null {\n  switch (typeof input) {\n    case 'string':\n      return input\n    case 'object': {\n      if (input == null) return null\n\n      // @NOTE Allow using TokenSchema instances in places expecting strings,\n      // converting them to their string value.\n      if (input instanceof TokenSchema) {\n        return input.toString()\n      }\n\n      if (input instanceof Date) {\n        if (Number.isNaN(input.getTime())) return null\n        return input.toISOString()\n      }\n\n      if (input instanceof URL) {\n        return input.toString()\n      }\n\n      const cid = CID.asCID(input)\n      if (cid) return cid.toString()\n\n      if (input instanceof String) {\n        return input.valueOf()\n      }\n    }\n\n    // falls through\n    default:\n      return null\n  }\n}\n"]}

package/dist/schema/subscription.d.ts

@@ -0,0 +1,16 @@
+import { Infer } from '../validation.js';
+import { ObjectSchema } from './object.js';
+import { ParamsSchema } from './params.js';
+import { RefSchema } from './ref.js';
+import { TypedUnionSchema } from './typed-union.js';
+export type InferSubscriptionParameters<S extends Subscription> = S extends Subscription<any, infer P extends ParamsSchema, any> ? Infer<P> : never;
+export type InferSubscriptionMessage<S extends Subscription> = S extends Subscription<any, any, infer M extends RefSchema | TypedUnionSchema | ObjectSchema> ? Infer<M> : unknown;
+export declare class Subscription<N extends string = any, P extends ParamsSchema = any, M extends undefined | RefSchema | TypedUnionSchema | ObjectSchema = any, E extends undefined | readonly string[] = any> {
+    readonly nsid: N;
+    readonly parameters: P;
+    readonly message: M;
+    readonly errors: E;
+    readonly type: "subscription";
+    constructor(nsid: N, parameters: P, message: M, errors: E);
+}
+//# sourceMappingURL=subscription.d.ts.map

package/dist/schema/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/schema/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,YAAY,IAC5D,CAAC,SAAS,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,YAAY,EAAE,GAAG,CAAC,GAC1D,KAAK,CAAC,CAAC,CAAC,GACR,KAAK,CAAA;AAEX,MAAM,MAAM,wBAAwB,CAAC,CAAC,SAAS,YAAY,IACzD,CAAC,SAAS,YAAY,CACpB,GAAG,EACH,GAAG,EACH,MAAM,CAAC,SAAS,SAAS,GAAG,gBAAgB,GAAG,YAAY,CAC5D,GACG,KAAK,CAAC,CAAC,CAAC,GACR,OAAO,CAAA;AAEb,qBAAa,YAAY,CACvB,CAAC,SAAS,MAAM,GAAG,GAAG,EACtB,CAAC,SAAS,YAAY,GAAG,GAAG,EAC5B,CAAC,SAAS,SAAS,GAAG,SAAS,GAAG,gBAAgB,GAAG,YAAY,GAAG,GAAG,EACvE,CAAC,SAAS,SAAS,GAAG,SAAS,MAAM,EAAE,GAAG,GAAG;IAK3C,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChB,QAAQ,CAAC,UAAU,EAAE,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,CAAC;IANpB,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAS;gBAG5B,IAAI,EAAE,CAAC,EACP,UAAU,EAAE,CAAC,EACb,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,CAAC;CAErB"}

package/dist/schema/subscription.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Subscription = void 0;
+class Subscription {
+    nsid;
+    parameters;
+    message;
+    errors;
+    type = 'subscription';
+    constructor(nsid, parameters, message, errors) {
+        this.nsid = nsid;
+        this.parameters = parameters;
+        this.message = message;
+        this.errors = errors;
+    }
+}
+exports.Subscription = Subscription;
+//# sourceMappingURL=subscription.js.map

package/dist/schema/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/schema/subscription.ts"],"names":[],"mappings":";;;AAoBA,MAAa,YAAY;IASZ;IACA;IACA;IACA;IANF,IAAI,GAAG,cAAuB,CAAA;IAEvC,YACW,IAAO,EACP,UAAa,EACb,OAAU,EACV,MAAS;QAHT,SAAI,GAAJ,IAAI,CAAG;QACP,eAAU,GAAV,UAAU,CAAG;QACb,YAAO,GAAP,OAAO,CAAG;QACV,WAAM,GAAN,MAAM,CAAG;IACjB,CAAC;CACL;AAdD,oCAcC","sourcesContent":["import { Infer } from '../validation.js'\nimport { ObjectSchema } from './object.js'\nimport { ParamsSchema } from './params.js'\nimport { RefSchema } from './ref.js'\nimport { TypedUnionSchema } from './typed-union.js'\n\nexport type InferSubscriptionParameters<S extends Subscription> =\n  S extends Subscription<any, infer P extends ParamsSchema, any>\n    ? Infer<P>\n    : never\n\nexport type InferSubscriptionMessage<S extends Subscription> =\n  S extends Subscription<\n    any,\n    any,\n    infer M extends RefSchema | TypedUnionSchema | ObjectSchema\n  >\n    ? Infer<M>\n    : unknown\n\nexport class Subscription<\n  N extends string = any,\n  P extends ParamsSchema = any,\n  M extends undefined | RefSchema | TypedUnionSchema | ObjectSchema = any,\n  E extends undefined | readonly string[] = any,\n> {\n  readonly type = 'subscription' as const\n\n  constructor(\n    readonly nsid: N,\n    readonly parameters: P,\n    readonly message: M,\n    readonly errors: E,\n  ) {}\n}\n"]}

package/dist/schema/token.d.ts

@@ -0,0 +1,10 @@
+import { ValidationResult, Validator, ValidatorContext } from '../validation.js';
+export declare class TokenSchema<V extends string = any> extends Validator<V> {
+    protected readonly value: V;
+    readonly lexiconType: "token";
+    constructor(value: V);
+    validateInContext(input: unknown, ctx: ValidatorContext): ValidationResult<V>;
+    toJSON(): string;
+    toString(): string;
+}
+//# sourceMappingURL=token.d.ts.map

package/dist/schema/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/schema/token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEhF,qBAAa,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAGvD,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAFvC,QAAQ,CAAC,WAAW,EAAG,OAAO,CAAS;gBAER,KAAK,EAAE,CAAC;IAI9B,iBAAiB,CACxB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,gBAAgB,GACpB,gBAAgB,CAAC,CAAC,CAAC;IAqBtB,MAAM,IAAI,MAAM;IAIhB,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/schema/token.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenSchema = void 0;
+const validation_js_1 = require("../validation.js");
+class TokenSchema extends validation_js_1.Validator {
+    value;
+    lexiconType = 'token';
+    constructor(value) {
+        super();
+        this.value = value;
+    }
+    validateInContext(input, ctx) {
+        if (input === this.value) {
+            return ctx.success(this.value);
+        }
+        // @NOTE: allow using the token instance itself (but convert to the actual
+        // token value)
+        if (input instanceof TokenSchema && input.value === this.value) {
+            return ctx.success(this.value);
+        }
+        if (typeof input !== 'string') {
+            return ctx.issueInvalidType(input, 'token');
+        }
+        return ctx.issueInvalidValue(input, [this.value]);
+    }
+    // When using the TokenSchema instance as data, let's serialize it to the
+    // token value
+    toJSON() {
+        return this.value;
+    }
+    toString() {
+        return this.value;
+    }
+}
+exports.TokenSchema = TokenSchema;
+//# sourceMappingURL=token.js.map

package/dist/schema/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/schema/token.ts"],"names":[],"mappings":";;;AAAA,oDAAgF;AAEhF,MAAa,WAAoC,SAAQ,yBAAY;IAGpC;IAFtB,WAAW,GAAG,OAAgB,CAAA;IAEvC,YAA+B,KAAQ;QACrC,KAAK,EAAE,CAAA;QADsB,UAAK,GAAL,KAAK,CAAG;IAEvC,CAAC;IAEQ,iBAAiB,CACxB,KAAc,EACd,GAAqB;QAErB,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACzB,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAChC,CAAC;QAED,0EAA0E;QAC1E,eAAe;QACf,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/D,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAChC,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,GAAG,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC7C,CAAC;QAED,OAAO,GAAG,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IACnD,CAAC;IAED,yEAAyE;IACzE,cAAc;IAEd,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;CACF;AAtCD,kCAsCC","sourcesContent":["import { ValidationResult, Validator, ValidatorContext } from '../validation.js'\n\nexport class TokenSchema<V extends string = any> extends Validator<V> {\n  readonly lexiconType = 'token' as const\n\n  constructor(protected readonly value: V) {\n    super()\n  }\n\n  override validateInContext(\n    input: unknown,\n    ctx: ValidatorContext,\n  ): ValidationResult<V> {\n    if (input === this.value) {\n      return ctx.success(this.value)\n    }\n\n    // @NOTE: allow using the token instance itself (but convert to the actual\n    // token value)\n    if (input instanceof TokenSchema && input.value === this.value) {\n      return ctx.success(this.value)\n    }\n\n    if (typeof input !== 'string') {\n      return ctx.issueInvalidType(input, 'token')\n    }\n\n    return ctx.issueInvalidValue(input, [this.value])\n  }\n\n  // When using the TokenSchema instance as data, let's serialize it to the\n  // token value\n\n  toJSON(): string {\n    return this.value\n  }\n\n  toString(): string {\n    return this.value\n  }\n}\n"]}

package/dist/schema/typed-object.d.ts

@@ -0,0 +1,32 @@
+import { $Type, Simplify } from '../core.js';
+import { Infer, ValidationResult, Validator, ValidatorContext } from '../validation.js';
+export declare class TypedObjectSchema<Type extends $Type = any, Schema extends Validator<Record<string, unknown>> = any, Output extends Infer<Schema> & {
+    $type?: Type;
+} = Infer<Schema> & {
+    $type?: Type;
+}> extends Validator<Output> {
+    readonly $type: Type;
+    readonly schema: Schema;
+    readonly lexiconType: "object";
+    constructor($type: Type, schema: Schema);
+    isTypeOf<X extends {
+        $type?: unknown;
+    }>(value: X): value is X extends {
+        $type?: Type;
+    } ? X : never;
+    build<X extends Omit<Output, '$type'>>(input: X): Simplify<Omit<X, '$type'> & {
+        $type: Type;
+    }>;
+    $isTypeOf<X extends {
+        $type?: unknown;
+    }>(value: X): value is X extends {
+        $type?: Type;
+    } ? X : never;
+    $build<X extends Omit<Output, '$type'>>(input: X): Omit<X, "$type"> & {
+        $type: Type;
+    } extends infer T ? { [K in keyof T]: (Omit<X, "$type"> & {
+        $type: Type;
+    })[K]; } : never;
+    validateInContext(input: unknown, ctx: ValidatorContext): ValidationResult<Output>;
+}
+//# sourceMappingURL=typed-object.d.ts.map

package/dist/schema/typed-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-object.d.ts","sourceRoot":"","sources":["../../src/schema/typed-object.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EACL,KAAK,EACL,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AAEzB,qBAAa,iBAAiB,CAC5B,IAAI,SAAS,KAAK,GAAG,GAAG,EACxB,MAAM,SAAS,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,GAAG,EACvD,MAAM,SAAS,KAAK,CAAC,MAAM,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,IAAI,CAAA;CAAE,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG;IAChE,KAAK,CAAC,EAAE,IAAI,CAAA;CACb,CACD,SAAQ,SAAS,CAAC,MAAM,CAAC;IAIvB,QAAQ,CAAC,KAAK,EAAE,IAAI;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM;IAJzB,QAAQ,CAAC,WAAW,EAAG,QAAQ,CAAS;gBAG7B,KAAK,EAAE,IAAI,EACX,MAAM,EAAE,MAAM;IAKzB,QAAQ,CAAC,CAAC,SAAS;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EACpC,KAAK,EAAE,CAAC,GACP,KAAK,IAAI,CAAC,SAAS;QAAE,KAAK,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK;IAIlD,KAAK,CAAC,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,KAAK,EAAE,CAAC,GACP,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,EAAE,IAAI,CAAA;KAAE,CAAC;IAI/C,SAAS,CAAC,CAAC,SAAS;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,KAAK,EAAE,CAAC;gBAVjB,IAAI;;IAcpC,MAAM,CAAC,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;eARR,IAAI;;eAAJ,IAAI;;IAYnC,iBAAiB,CACxB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,gBAAgB,GACpB,gBAAgB,CAAC,MAAM,CAAC;CAe5B"}

package/dist/schema/typed-object.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedObjectSchema = void 0;
+const lex_data_1 = require("@atproto/lex-data");
+const validation_js_1 = require("../validation.js");
+class TypedObjectSchema extends validation_js_1.Validator {
+    $type;
+    schema;
+    lexiconType = 'object';
+    constructor($type, schema) {
+        super();
+        this.$type = $type;
+        this.schema = schema;
+    }
+    isTypeOf(value) {
+        return value.$type === undefined || value.$type === this.$type;
+    }
+    build(input) {
+        return { ...input, $type: this.$type };
+    }
+    $isTypeOf(value) {
+        return this.isTypeOf(value);
+    }
+    $build(input) {
+        return this.build(input);
+    }
+    validateInContext(input, ctx) {
+        if (!(0, lex_data_1.isPlainObject)(input)) {
+            return ctx.issueInvalidType(input, 'object');
+        }
+        if ('$type' in input &&
+            input.$type !== undefined &&
+            input.$type !== this.$type) {
+            return ctx.issueInvalidPropertyValue(input, '$type', [this.$type]);
+        }
+        return ctx.validate(input, this.schema);
+    }
+}
+exports.TypedObjectSchema = TypedObjectSchema;
+//# sourceMappingURL=typed-object.js.map

package/dist/schema/typed-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-object.js","sourceRoot":"","sources":["../../src/schema/typed-object.ts"],"names":[],"mappings":";;;AAAA,gDAAiD;AAEjD,oDAKyB;AAEzB,MAAa,iBAMX,SAAQ,yBAAiB;IAId;IACA;IAJF,WAAW,GAAG,QAAiB,CAAA;IAExC,YACW,KAAW,EACX,MAAc;QAEvB,KAAK,EAAE,CAAA;QAHE,UAAK,GAAL,KAAK,CAAM;QACX,WAAM,GAAN,MAAM,CAAQ;IAGzB,CAAC;IAED,QAAQ,CACN,KAAQ;QAER,OAAO,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAA;IAChE,CAAC;IAED,KAAK,CACH,KAAQ;QAER,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAA;IACxC,CAAC;IAED,SAAS,CAAgC,KAAQ;QAC/C,OAAO,IAAI,CAAC,QAAQ,CAAI,KAAK,CAAC,CAAA;IAChC,CAAC;IAED,MAAM,CAAkC,KAAQ;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAI,KAAK,CAAC,CAAA;IAC7B,CAAC;IAEQ,iBAAiB,CACxB,KAAc,EACd,GAAqB;QAErB,IAAI,CAAC,IAAA,wBAAa,EAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,GAAG,CAAC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QAC9C,CAAC;QAED,IACE,OAAO,IAAI,KAAK;YAChB,KAAK,CAAC,KAAK,KAAK,SAAS;YACzB,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,EAC1B,CAAC;YACD,OAAO,GAAG,CAAC,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QACpE,CAAC;QAED,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,MAA2B,CAAC,CAAA;IAC9D,CAAC;CACF;AAtDD,8CAsDC","sourcesContent":["import { isPlainObject } from '@atproto/lex-data'\nimport { $Type, Simplify } from '../core.js'\nimport {\n  Infer,\n  ValidationResult,\n  Validator,\n  ValidatorContext,\n} from '../validation.js'\n\nexport class TypedObjectSchema<\n  Type extends $Type = any,\n  Schema extends Validator<Record<string, unknown>> = any,\n  Output extends Infer<Schema> & { $type?: Type } = Infer<Schema> & {\n    $type?: Type\n  },\n> extends Validator<Output> {\n  readonly lexiconType = 'object' as const\n\n  constructor(\n    readonly $type: Type,\n    readonly schema: Schema,\n  ) {\n    super()\n  }\n\n  isTypeOf<X extends { $type?: unknown }>(\n    value: X,\n  ): value is X extends { $type?: Type } ? X : never {\n    return value.$type === undefined || value.$type === this.$type\n  }\n\n  build<X extends Omit<Output, '$type'>>(\n    input: X,\n  ): Simplify<Omit<X, '$type'> & { $type: Type }> {\n    return { ...input, $type: this.$type }\n  }\n\n  $isTypeOf<X extends { $type?: unknown }>(value: X) {\n    return this.isTypeOf<X>(value)\n  }\n\n  $build<X extends Omit<Output, '$type'>>(input: X) {\n    return this.build<X>(input)\n  }\n\n  override validateInContext(\n    input: unknown,\n    ctx: ValidatorContext,\n  ): ValidationResult<Output> {\n    if (!isPlainObject(input)) {\n      return ctx.issueInvalidType(input, 'object')\n    }\n\n    if (\n      '$type' in input &&\n      input.$type !== undefined &&\n      input.$type !== this.$type\n    ) {\n      return ctx.issueInvalidPropertyValue(input, '$type', [this.$type])\n    }\n\n    return ctx.validate(input, this.schema as Validator<Output>)\n  }\n}\n"]}

package/dist/schema/typed-ref.d.ts

@@ -0,0 +1,30 @@
+import { ValidationResult, Validator, ValidatorContext } from '../validation.js';
+export type TypedRefSchemaValidator<V extends {
+    $type?: string;
+} = any> = V extends {
+    $type?: infer T extends string;
+} ? {
+    $type: T;
+} & Validator<V & {
+    $type?: T;
+}> : never;
+export type TypedRefGetter<V extends {
+    $type?: string;
+} = any> = () => TypedRefSchemaValidator<V>;
+export type TypedRefSchemaOutput<V extends {
+    $type?: string;
+} = any> = V extends {
+    $type?: infer T extends string;
+} ? V & {
+    $type: T;
+} : never;
+export declare class TypedRefSchema<V extends {
+    $type?: string;
+} = any> extends Validator<TypedRefSchemaOutput<V>> {
+    #private;
+    constructor(getter: TypedRefGetter<V>);
+    get schema(): TypedRefSchemaValidator<V>;
+    get $type(): TypedRefSchemaOutput<V>['$type'];
+    validateInContext(input: unknown, ctx: ValidatorContext): ValidationResult<TypedRefSchemaOutput<V>>;
+}
+//# sourceMappingURL=typed-ref.d.ts.map

package/dist/schema/typed-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-ref.d.ts","sourceRoot":"","sources":["../../src/schema/typed-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAGhF,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,IACpE,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CAAE,GACxC;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG,SAAS,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC,GAC3C,KAAK,CAAA;AAEX,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,IAC3D,MAAM,uBAAuB,CAAC,CAAC,CAAC,CAAA;AAElC,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,IACjE,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;CAAE,GAAG,CAAC,GAAG;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG,KAAK,CAAA;AAEzE,qBAAa,cAAc,CACzB,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,CAClC,SAAQ,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;;gBAG9B,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IASrC,IAAI,MAAM,IAAI,uBAAuB,CAAC,CAAC,CAAC,CAgBvC;IAED,IAAI,KAAK,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAE5C;IAEQ,iBAAiB,CACxB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,gBAAgB,GACpB,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;CAU7C"}

package/dist/schema/typed-ref.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedRefSchema = void 0;
+const validation_js_1 = require("../validation.js");
+class TypedRefSchema extends validation_js_1.Validator {
+    #getter;
+    constructor(getter) {
+        // @NOTE In order to avoid circular dependency issues, we don't resolve
+        // the schema here. Instead, we resolve it lazily when first accessed.
+        super();
+        this.#getter = getter;
+    }
+    get schema() {
+        const value = this.#getter.call(null);
+        // Prevents a getter from depending on itself recursively, also allows GC to
+        // clean up the getter function.
+        this.#getter = throwAlreadyCalled;
+        // Cache the resolved schema on the instance
+        Object.defineProperty(this, 'schema', {
+            value,
+            writable: false,
+            enumerable: false,
+            configurable: true,
+        });
+        return value;
+    }
+    get $type() {
+        return this.schema.$type;
+    }
+    validateInContext(input, ctx) {
+        const result = ctx.validate(input, this.schema);
+        if (!result.success)
+            return result;
+        if (result.value.$type !== this.$type) {
+            return ctx.issueInvalidPropertyValue(result.value, '$type', [this.$type]);
+        }
+        return result;
+    }
+}
+exports.TypedRefSchema = TypedRefSchema;
+function throwAlreadyCalled() {
+    throw new Error('TypedRefSchema getter called multiple times');
+}
+//# sourceMappingURL=typed-ref.js.map

package/dist/schema/typed-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-ref.js","sourceRoot":"","sources":["../../src/schema/typed-ref.ts"],"names":[],"mappings":";;;AAAA,oDAAgF;AAchF,MAAa,cAEX,SAAQ,yBAAkC;IAC1C,OAAO,CAAmB;IAE1B,YAAY,MAAyB;QACnC,uEAAuE;QACvE,sEAAsE;QAEtE,KAAK,EAAE,CAAA;QAEP,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAED,IAAI,MAAM;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAErC,4EAA4E;QAC5E,gCAAgC;QAChC,IAAI,CAAC,OAAO,GAAG,kBAAkB,CAAA;QAEjC,4CAA4C;QAC5C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE;YACpC,KAAK;YACL,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAA;QAEF,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAA;IAC1B,CAAC;IAEQ,iBAAiB,CACxB,KAAc,EACd,GAAqB;QAErB,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAC/C,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,MAAM,CAAA;QAElC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACtC,OAAO,GAAG,CAAC,yBAAyB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QAC3E,CAAC;QAED,OAAO,MAAmD,CAAA;IAC5D,CAAC;CACF;AAjDD,wCAiDC;AAED,SAAS,kBAAkB;IACzB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;AAChE,CAAC","sourcesContent":["import { ValidationResult, Validator, ValidatorContext } from '../validation.js'\n\n// Basically a RecordSchema or TypedObjectSchema\nexport type TypedRefSchemaValidator<V extends { $type?: string } = any> =\n  V extends { $type?: infer T extends string }\n    ? { $type: T } & Validator<V & { $type?: T }>\n    : never\n\nexport type TypedRefGetter<V extends { $type?: string } = any> =\n  () => TypedRefSchemaValidator<V>\n\nexport type TypedRefSchemaOutput<V extends { $type?: string } = any> =\n  V extends { $type?: infer T extends string } ? V & { $type: T } : never\n\nexport class TypedRefSchema<\n  V extends { $type?: string } = any,\n> extends Validator<TypedRefSchemaOutput<V>> {\n  #getter: TypedRefGetter<V>\n\n  constructor(getter: TypedRefGetter<V>) {\n    // @NOTE In order to avoid circular dependency issues, we don't resolve\n    // the schema here. Instead, we resolve it lazily when first accessed.\n\n    super()\n\n    this.#getter = getter\n  }\n\n  get schema(): TypedRefSchemaValidator<V> {\n    const value = this.#getter.call(null)\n\n    // Prevents a getter from depending on itself recursively, also allows GC to\n    // clean up the getter function.\n    this.#getter = throwAlreadyCalled\n\n    // Cache the resolved schema on the instance\n    Object.defineProperty(this, 'schema', {\n      value,\n      writable: false,\n      enumerable: false,\n      configurable: true,\n    })\n\n    return value\n  }\n\n  get $type(): TypedRefSchemaOutput<V>['$type'] {\n    return this.schema.$type\n  }\n\n  override validateInContext(\n    input: unknown,\n    ctx: ValidatorContext,\n  ): ValidationResult<TypedRefSchemaOutput<V>> {\n    const result = ctx.validate(input, this.schema)\n    if (!result.success) return result\n\n    if (result.value.$type !== this.$type) {\n      return ctx.issueInvalidPropertyValue(result.value, '$type', [this.$type])\n    }\n\n    return result as ValidationResult<TypedRefSchemaOutput<V>>\n  }\n}\n\nfunction throwAlreadyCalled(): never {\n  throw new Error('TypedRefSchema getter called multiple times')\n}\n"]}

package/dist/schema/typed-union.d.ts

@@ -0,0 +1,26 @@
+import { Restricted, UnknownString } from '../core.js';
+import { Infer, ValidationResult, Validator, ValidatorContext } from '../validation.js';
+import { TypedRefSchema, TypedRefSchemaOutput } from './typed-ref.js';
+export type TypedRef<T extends {
+    $type?: string;
+}> = TypedRefSchemaOutput<T>;
+export type TypedObject = {
+    $type: UnknownString;
+} & {
+    [K in string]: Restricted<'Unknown property'>;
+};
+type TypedRefSchemasToUnion<T extends readonly TypedRefSchema[]> = {
+    [K in keyof T]: Infer<T[K]>;
+}[number];
+export type TypedUnionSchemaOutput<TypedRefs extends readonly TypedRefSchema[], Closed extends boolean> = Closed extends true ? TypedRefSchemasToUnion<TypedRefs> : TypedRefSchemasToUnion<TypedRefs> | TypedObject;
+export declare class TypedUnionSchema<TypedRefs extends readonly TypedRefSchema[] = any, Closed extends boolean = any> extends Validator<TypedUnionSchemaOutput<TypedRefs, Closed>> {
+    protected readonly refs: TypedRefs;
+    readonly closed: Closed;
+    readonly lexiconType: "union";
+    constructor(refs: TypedRefs, closed: Closed);
+    protected get refsMap(): Map<unknown, TypedRefs[number]>;
+    get $types(): unknown[];
+    validateInContext(input: unknown, ctx: ValidatorContext): ValidationResult<TypedUnionSchemaOutput<TypedRefs, Closed>>;
+}
+export {};
+//# sourceMappingURL=typed-union.d.ts.map

package/dist/schema/typed-union.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-union.d.ts","sourceRoot":"","sources":["../../src/schema/typed-union.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,EACL,KAAK,EACL,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAErE,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAA;AAE5E,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,GAAG;KAgBlD,CAAC,IAAI,MAAM,GAAG,UAAU,CAAC,kBAAkB,CAAC;CAC9C,CAAA;AAED,KAAK,sBAAsB,CAAC,CAAC,SAAS,SAAS,cAAc,EAAE,IAAI;KAChE,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5B,CAAC,MAAM,CAAC,CAAA;AAET,MAAM,MAAM,sBAAsB,CAChC,SAAS,SAAS,SAAS,cAAc,EAAE,EAC3C,MAAM,SAAS,OAAO,IACpB,MAAM,SAAS,IAAI,GACnB,sBAAsB,CAAC,SAAS,CAAC,GACjC,sBAAsB,CAAC,SAAS,CAAC,GAAG,WAAW,CAAA;AAEnD,qBAAa,gBAAgB,CAC3B,SAAS,SAAS,SAAS,cAAc,EAAE,GAAG,GAAG,EACjD,MAAM,SAAS,OAAO,GAAG,GAAG,CAC5B,SAAQ,SAAS,CAAC,sBAAsB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAI1D,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS;aAClB,MAAM,EAAE,MAAM;IAJhC,QAAQ,CAAC,WAAW,EAAG,OAAO,CAAS;gBAGlB,IAAI,EAAE,SAAS,EAClB,MAAM,EAAE,MAAM;IAShC,SAAS,KAAK,OAAO,oCAapB;IAED,IAAI,MAAM,cAET;IAEQ,iBAAiB,CACxB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,gBAAgB,GACpB,gBAAgB,CAAC,sBAAsB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;CAwB/D"}

package/dist/schema/typed-union.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedUnionSchema = void 0;
+const lex_data_1 = require("@atproto/lex-data");
+const validation_js_1 = require("../validation.js");
+class TypedUnionSchema extends validation_js_1.Validator {
+    refs;
+    closed;
+    lexiconType = 'union';
+    constructor(refs, closed) {
+        // @NOTE In order to avoid circular dependency issues, we don't access the
+        // refs's schema (or $type) here. Instead, we access them lazily when first
+        // needed.
+        super();
+        this.refs = refs;
+        this.closed = closed;
+    }
+    get refsMap() {
+        const map = new Map();
+        for (const ref of this.refs)
+            map.set(ref.$type, ref);
+        // Cache the map on the instance
+        Object.defineProperty(this, 'refsMap', {
+            value: map,
+            writable: false,
+            enumerable: false,
+            configurable: true,
+        });
+        return map;
+    }
+    get $types() {
+        return Array.from(this.refsMap.keys());
+    }
+    validateInContext(input, ctx) {
+        if (!(0, lex_data_1.isPlainObject)(input) || !('$type' in input)) {
+            return ctx.issueInvalidType(input, '$typed');
+        }
+        const { $type } = input;
+        const def = this.refsMap.get($type);
+        if (def) {
+            const result = ctx.validate(input, def);
+            return result;
+        }
+        if (this.closed) {
+            return ctx.issueInvalidPropertyValue(input, '$type', this.$types);
+        }
+        if (typeof $type !== 'string') {
+            return ctx.issueInvalidPropertyType(input, '$type', 'string');
+        }
+        return ctx.success(input);
+    }
+}
+exports.TypedUnionSchema = TypedUnionSchema;
+//# sourceMappingURL=typed-union.js.map

package/dist/schema/typed-union.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-union.js","sourceRoot":"","sources":["../../src/schema/typed-union.ts"],"names":[],"mappings":";;;AAAA,gDAAiD;AAEjD,oDAKyB;AAmCzB,MAAa,gBAGX,SAAQ,yBAAoD;IAIvC;IACH;IAJT,WAAW,GAAG,OAAgB,CAAA;IAEvC,YACqB,IAAe,EAClB,MAAc;QAE9B,0EAA0E;QAC1E,2EAA2E;QAC3E,UAAU;QAEV,KAAK,EAAE,CAAA;QAPY,SAAI,GAAJ,IAAI,CAAW;QAClB,WAAM,GAAN,MAAM,CAAQ;IAOhC,CAAC;IAED,IAAc,OAAO;QACnB,MAAM,GAAG,GAAG,IAAI,GAAG,EAA8B,CAAA;QACjD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAEpD,gCAAgC;QAChC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE;YACrC,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAA;QAEF,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,IAAI,MAAM;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IACxC,CAAC;IAEQ,iBAAiB,CACxB,KAAc,EACd,GAAqB;QAErB,IAAI,CAAC,IAAA,wBAAa,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO,GAAG,CAAC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QAC9C,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;QAEvB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACnC,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YACvC,OAAO,MAEN,CAAA;QACH,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,GAAG,CAAC,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACnE,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,GAAG,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;QAC/D,CAAC;QAED,OAAO,GAAG,CAAC,OAAO,CAAC,KAAkD,CAAC,CAAA;IACxE,CAAC;CACF;AA/DD,4CA+DC","sourcesContent":["import { isPlainObject } from '@atproto/lex-data'\nimport { Restricted, UnknownString } from '../core.js'\nimport {\n  Infer,\n  ValidationResult,\n  Validator,\n  ValidatorContext,\n} from '../validation.js'\nimport { TypedRefSchema, TypedRefSchemaOutput } from './typed-ref.js'\n\nexport type TypedRef<T extends { $type?: string }> = TypedRefSchemaOutput<T>\n\nexport type TypedObject = { $type: UnknownString } & {\n  // In order to prevent places that expect an open union from accepting an\n  // invalid version of the known typed objects, we need to prevent any other\n  // properties from being present.\n  //\n  // For example, if an open union expects:\n  // ```ts\n  // TypedObject | { $type: 'A'; a: number }\n  // ```\n  // we don't want it to accept:\n  // ```ts\n  // { $type: 'A' }\n  // ```\n  // Which would be the case as `{ $type: 'A' }` is a valid\n  // `TypedObject`. By adding an index signature that forbids any\n  // property, we ensure that only valid known typed objects can be used.\n  [K in string]: Restricted<'Unknown property'>\n}\n\ntype TypedRefSchemasToUnion<T extends readonly TypedRefSchema[]> = {\n  [K in keyof T]: Infer<T[K]>\n}[number]\n\nexport type TypedUnionSchemaOutput<\n  TypedRefs extends readonly TypedRefSchema[],\n  Closed extends boolean,\n> = Closed extends true\n  ? TypedRefSchemasToUnion<TypedRefs>\n  : TypedRefSchemasToUnion<TypedRefs> | TypedObject\n\nexport class TypedUnionSchema<\n  TypedRefs extends readonly TypedRefSchema[] = any,\n  Closed extends boolean = any,\n> extends Validator<TypedUnionSchemaOutput<TypedRefs, Closed>> {\n  readonly lexiconType = 'union' as const\n\n  constructor(\n    protected readonly refs: TypedRefs,\n    public readonly closed: Closed,\n  ) {\n    // @NOTE In order to avoid circular dependency issues, we don't access the\n    // refs's schema (or $type) here. Instead, we access them lazily when first\n    // needed.\n\n    super()\n  }\n\n  protected get refsMap() {\n    const map = new Map<unknown, TypedRefs[number]>()\n    for (const ref of this.refs) map.set(ref.$type, ref)\n\n    // Cache the map on the instance\n    Object.defineProperty(this, 'refsMap', {\n      value: map,\n      writable: false,\n      enumerable: false,\n      configurable: true,\n    })\n\n    return map\n  }\n\n  get $types() {\n    return Array.from(this.refsMap.keys())\n  }\n\n  override validateInContext(\n    input: unknown,\n    ctx: ValidatorContext,\n  ): ValidationResult<TypedUnionSchemaOutput<TypedRefs, Closed>> {\n    if (!isPlainObject(input) || !('$type' in input)) {\n      return ctx.issueInvalidType(input, '$typed')\n    }\n\n    const { $type } = input\n\n    const def = this.refsMap.get($type)\n    if (def) {\n      const result = ctx.validate(input, def)\n      return result as ValidationResult<\n        TypedUnionSchemaOutput<TypedRefs, Closed>\n      >\n    }\n\n    if (this.closed) {\n      return ctx.issueInvalidPropertyValue(input, '$type', this.$types)\n    }\n    if (typeof $type !== 'string') {\n      return ctx.issueInvalidPropertyType(input, '$type', 'string')\n    }\n\n    return ctx.success(input as TypedUnionSchemaOutput<TypedRefs, Closed>)\n  }\n}\n"]}

package/dist/schema/union.d.ts

@@ -0,0 +1,9 @@
+import { Infer, ValidationResult, Validator, ValidatorContext } from '../validation.js';
+export type UnionSchemaValidators = readonly [Validator, ...Validator[]];
+export type UnionSchemaOutput<V extends readonly Validator[]> = Infer<V[number]>;
+export declare class UnionSchema<V extends UnionSchemaValidators = any> extends Validator<UnionSchemaOutput<V>> {
+    protected readonly validators: V;
+    constructor(validators: V);
+    validateInContext(input: unknown, ctx: ValidatorContext): ValidationResult<UnionSchemaOutput<V>>;
+}
+//# sourceMappingURL=union.d.ts.map

package/dist/schema/union.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"union.d.ts","sourceRoot":"","sources":["../../src/schema/union.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAGL,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AAEzB,MAAM,MAAM,qBAAqB,GAAG,SAAS,CAAC,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC,CAAA;AACxE,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,SAAS,SAAS,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;AAEhF,qBAAa,WAAW,CACtB,CAAC,SAAS,qBAAqB,GAAG,GAAG,CACrC,SAAQ,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC3B,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;gBAAb,UAAU,EAAE,CAAC;IAInC,iBAAiB,CACxB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,gBAAgB,GACpB,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;CAiB1C"}