decoders 2.5.0 → 2.6.1

package/dist/index.cjs

@@ -18,7 +18,8 @@ function isPojo(value) {
 }
 
 // src/core/annotate.ts
-var _register = /* @__PURE__ */ new WeakSet();
+var kAnnotationRegistry = Symbol.for("decoders.kAnnotationRegistry");
+var _register = globalThis[kAnnotationRegistry] ??= /* @__PURE__ */ new WeakSet();
 function brand(ann) {
   _register.add(ann);
   return ann;
@@ -102,7 +103,7 @@ function public_annotateObject(obj, text) {
 // src/lib/text.ts
 var INDENT = "  ";
 function isMultiline(s) {
-  return s.indexOf("\n") >= 0;
+  return s.includes("\n");
 }
 function indent(s, prefix = INDENT) {
   if (isMultiline(s)) {
@@ -166,7 +167,7 @@ function serializeArray(annotation, prefix) {
   const result = [];
   for (const item of items) {
     const [ser, ann] = serializeAnnotation(item, `${prefix}${INDENT}`);
-    result.push(`${prefix}${INDENT}${ser}${","}`);
+    result.push(`${prefix}${INDENT}${ser},`);
     if (ann !== void 0) {
       result.push(indent(ann, `${prefix}${INDENT}`));
     }
@@ -242,6 +243,41 @@ ${annotation}`;
 function formatShort(ann) {
   return summarize(ann, []).join("\n");
 }
+function* iterAnnotation(ann, stack) {
+  if (ann.text) {
+    if (stack.length > 0) {
+      yield { message: ann.text, path: [...stack] };
+    } else {
+      yield { message: ann.text };
+    }
+  }
+  switch (ann.type) {
+    case "array": {
+      let index = 0;
+      for (const item of ann.items) {
+        stack.push(index++);
+        yield* iterAnnotation(item, stack);
+        stack.pop();
+      }
+      break;
+    }
+    case "object": {
+      for (const [key, value] of ann.fields) {
+        stack.push(key);
+        yield* iterAnnotation(value, stack);
+        stack.pop();
+      }
+      break;
+    }
+    case "scalar":
+    case "opaque": {
+      break;
+    }
+  }
+}
+function formatAsIssues(ann) {
+  return Array.from(iterAnnotation(ann, []));
+}
 
 // src/core/Result.ts
 function ok(value) {
@@ -342,10 +378,24 @@ function define(fn) {
     reject,
     describe,
     then,
-    pipe
+    pipe,
+    "~standard": {
+      version: 1,
+      vendor: "decoders",
+      validate: (blob) => {
+        const result = decode(blob);
+        if (result.ok) {
+          return { value: result.value };
+        } else {
+          const issues = formatAsIssues(result.error);
+          return { issues };
+        }
+      }
+    }
   });
 }
-var _register2 = /* @__PURE__ */ new WeakSet();
+var kDecoderRegistry = Symbol.for("decoders.kDecoderRegistry");
+var _register2 = globalThis[kDecoderRegistry] ??= /* @__PURE__ */ new WeakSet();
 function brand2(decoder) {
   _register2.add(decoder);
   return decoder;
@@ -418,7 +468,10 @@ function tuple(...decoders) {
 // src/misc.ts
 function instanceOf(klass) {
   return define(
-    (blob, ok2, err2) => blob instanceof klass ? ok2(blob) : err2(`Must be ${klass.name} instance`)
+    (blob, ok2, err2) => (
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+      blob instanceof klass ? ok2(blob) : err2(`Must be ${klass.name} instance`)
+    )
   );
 }
 function lazy(decoderFn) {
@@ -547,8 +600,8 @@ function either(...decoders) {
   }
   return define((blob, _, err2) => {
     const errors = [];
-    for (let i = 0; i < decoders.length; i++) {
-      const result = decoders[i].decode(blob);
+    for (const decoder of decoders) {
+      const result = decoder.decode(blob);
       if (result.ok) {
         return result;
       } else {
@@ -649,7 +702,7 @@ var truthy = define((blob, ok2, _) => ok2(!!blob));
 // src/collections.ts
 function record(fst, snd) {
   const keyDecoder = snd !== void 0 ? fst : void 0;
-  const valueDecoder = snd !== void 0 ? snd : fst;
+  const valueDecoder = _nullishCoalesce(snd, () => ( fst));
   return pojo.then((input, ok2, err2) => {
     let rv = {};
     const errors = /* @__PURE__ */ new Map();
@@ -690,9 +743,9 @@ function mapping(decoder) {
 
 // src/lib/size-options.ts
 function bySizeOptions(options) {
-  const size = _optionalChain([options, 'optionalAccess', _6 => _6.size]);
-  const min = _nullishCoalesce(size, () => ( _optionalChain([options, 'optionalAccess', _7 => _7.min])));
-  const max = _nullishCoalesce(size, () => ( _optionalChain([options, 'optionalAccess', _8 => _8.max])));
+  const size = options.size;
+  const min = _nullishCoalesce(size, () => ( options.min));
+  const max = _nullishCoalesce(size, () => ( options.max));
   const atLeast = min === max ? "" : "at least ";
   const atMost = min === max ? "" : "at most ";
   const tooShort = min !== void 0 && `Too short, must be ${atLeast}${min} chars`;

package/dist/index.d.cts

@@ -45,6 +45,62 @@ declare function ok<T>(value: T): Ok<T>;
  */
 declare function err<E>(error: E): Err<E>;
 
+/** The Standard Schema interface. */
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+    /** The Standard Schema properties. */
+    readonly '~standard': StandardSchemaV1.Props<Input, Output>;
+}
+declare namespace StandardSchemaV1 {
+    /** The Standard Schema properties interface. */
+    interface Props<Input = unknown, Output = Input> {
+        /** The version number of the standard. */
+        readonly version: 1;
+        /** The vendor name of the schema library. */
+        readonly vendor: string;
+        /** Validates unknown input values. */
+        readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
+        /** Inferred types associated with the schema. */
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    /** The result interface of the validate function. */
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    /** The result interface if validation succeeds. */
+    interface SuccessResult<Output> {
+        /** The typed output value. */
+        readonly value: Output;
+        /** The non-existent issues. */
+        readonly issues?: undefined;
+    }
+    /** The result interface if validation fails. */
+    interface FailureResult {
+        /** The issues of failed validation. */
+        readonly issues: ReadonlyArray<Issue>;
+    }
+    /** The issue interface of the failure output. */
+    interface Issue {
+        /** The error message of the issue. */
+        readonly message: string;
+        /** The path of the issue, if any. */
+        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+    }
+    /** The path segment interface of the issue. */
+    interface PathSegment {
+        /** The key representing a path segment. */
+        readonly key: PropertyKey;
+    }
+    /** The Standard Schema types interface. */
+    interface Types<Input = unknown, Output = Input> {
+        /** The input type of the schema. */
+        readonly input: Input;
+        /** The output type of the schema. */
+        readonly output: Output;
+    }
+    /** Infers the input type of a Standard Schema. */
+    type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['input'];
+    /** Infers the output type of a Standard Schema. */
+    type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
+}
+
 type DecodeResult<T> = Result<T, Annotation>;
 /**
  * A function taking a untrusted input, and returning a DecodeResult<T>. The
@@ -112,8 +168,11 @@ interface Decoder<T> {
      *
      *   string.pipe((s) => s.startsWith('@') ? username : email)
      */
-    pipe<V, D extends Decoder<V>>(next: D): Decoder<DecoderType<D>>;
-    pipe<V, D extends Decoder<V>>(next: (blob: T) => D): Decoder<DecoderType<D>>;
+    pipe<V, D extends Decoder<V>>(next: D | ((blob: T) => D)): Decoder<DecoderType<D>>;
+    /**
+     * The Standard Schema interface for this decoder.
+     */
+    '~standard': StandardSchemaV1.Props<unknown, T>;
 }
 /**
  * Helper type to return the output type of a Decoder.

package/dist/index.d.ts

@@ -45,6 +45,62 @@ declare function ok<T>(value: T): Ok<T>;
  */
 declare function err<E>(error: E): Err<E>;
 
+/** The Standard Schema interface. */
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+    /** The Standard Schema properties. */
+    readonly '~standard': StandardSchemaV1.Props<Input, Output>;
+}
+declare namespace StandardSchemaV1 {
+    /** The Standard Schema properties interface. */
+    interface Props<Input = unknown, Output = Input> {
+        /** The version number of the standard. */
+        readonly version: 1;
+        /** The vendor name of the schema library. */
+        readonly vendor: string;
+        /** Validates unknown input values. */
+        readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
+        /** Inferred types associated with the schema. */
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    /** The result interface of the validate function. */
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    /** The result interface if validation succeeds. */
+    interface SuccessResult<Output> {
+        /** The typed output value. */
+        readonly value: Output;
+        /** The non-existent issues. */
+        readonly issues?: undefined;
+    }
+    /** The result interface if validation fails. */
+    interface FailureResult {
+        /** The issues of failed validation. */
+        readonly issues: ReadonlyArray<Issue>;
+    }
+    /** The issue interface of the failure output. */
+    interface Issue {
+        /** The error message of the issue. */
+        readonly message: string;
+        /** The path of the issue, if any. */
+        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+    }
+    /** The path segment interface of the issue. */
+    interface PathSegment {
+        /** The key representing a path segment. */
+        readonly key: PropertyKey;
+    }
+    /** The Standard Schema types interface. */
+    interface Types<Input = unknown, Output = Input> {
+        /** The input type of the schema. */
+        readonly input: Input;
+        /** The output type of the schema. */
+        readonly output: Output;
+    }
+    /** Infers the input type of a Standard Schema. */
+    type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['input'];
+    /** Infers the output type of a Standard Schema. */
+    type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
+}
+
 type DecodeResult<T> = Result<T, Annotation>;
 /**
  * A function taking a untrusted input, and returning a DecodeResult<T>. The
@@ -112,8 +168,11 @@ interface Decoder<T> {
      *
      *   string.pipe((s) => s.startsWith('@') ? username : email)
      */
-    pipe<V, D extends Decoder<V>>(next: D): Decoder<DecoderType<D>>;
-    pipe<V, D extends Decoder<V>>(next: (blob: T) => D): Decoder<DecoderType<D>>;
+    pipe<V, D extends Decoder<V>>(next: D | ((blob: T) => D)): Decoder<DecoderType<D>>;
+    /**
+     * The Standard Schema interface for this decoder.
+     */
+    '~standard': StandardSchemaV1.Props<unknown, T>;
 }
 /**
  * Helper type to return the output type of a Decoder.

package/dist/index.js

@@ -18,7 +18,8 @@ function isPojo(value) {
 }
 
 // src/core/annotate.ts
-var _register = /* @__PURE__ */ new WeakSet();
+var kAnnotationRegistry = Symbol.for("decoders.kAnnotationRegistry");
+var _register = globalThis[kAnnotationRegistry] ??= /* @__PURE__ */ new WeakSet();
 function brand(ann) {
   _register.add(ann);
   return ann;
@@ -102,7 +103,7 @@ function public_annotateObject(obj, text) {
 // src/lib/text.ts
 var INDENT = "  ";
 function isMultiline(s) {
-  return s.indexOf("\n") >= 0;
+  return s.includes("\n");
 }
 function indent(s, prefix = INDENT) {
   if (isMultiline(s)) {
@@ -166,7 +167,7 @@ function serializeArray(annotation, prefix) {
   const result = [];
   for (const item of items) {
     const [ser, ann] = serializeAnnotation(item, `${prefix}${INDENT}`);
-    result.push(`${prefix}${INDENT}${ser}${","}`);
+    result.push(`${prefix}${INDENT}${ser},`);
     if (ann !== void 0) {
       result.push(indent(ann, `${prefix}${INDENT}`));
     }
@@ -242,6 +243,41 @@ ${annotation}`;
 function formatShort(ann) {
   return summarize(ann, []).join("\n");
 }
+function* iterAnnotation(ann, stack) {
+  if (ann.text) {
+    if (stack.length > 0) {
+      yield { message: ann.text, path: [...stack] };
+    } else {
+      yield { message: ann.text };
+    }
+  }
+  switch (ann.type) {
+    case "array": {
+      let index = 0;
+      for (const item of ann.items) {
+        stack.push(index++);
+        yield* iterAnnotation(item, stack);
+        stack.pop();
+      }
+      break;
+    }
+    case "object": {
+      for (const [key, value] of ann.fields) {
+        stack.push(key);
+        yield* iterAnnotation(value, stack);
+        stack.pop();
+      }
+      break;
+    }
+    case "scalar":
+    case "opaque": {
+      break;
+    }
+  }
+}
+function formatAsIssues(ann) {
+  return Array.from(iterAnnotation(ann, []));
+}
 
 // src/core/Result.ts
 function ok(value) {
@@ -342,10 +378,24 @@ function define(fn) {
     reject,
     describe,
     then,
-    pipe
+    pipe,
+    "~standard": {
+      version: 1,
+      vendor: "decoders",
+      validate: (blob) => {
+        const result = decode(blob);
+        if (result.ok) {
+          return { value: result.value };
+        } else {
+          const issues = formatAsIssues(result.error);
+          return { issues };
+        }
+      }
+    }
   });
 }
-var _register2 = /* @__PURE__ */ new WeakSet();
+var kDecoderRegistry = Symbol.for("decoders.kDecoderRegistry");
+var _register2 = globalThis[kDecoderRegistry] ??= /* @__PURE__ */ new WeakSet();
 function brand2(decoder) {
   _register2.add(decoder);
   return decoder;
@@ -418,7 +468,10 @@ function tuple(...decoders) {
 // src/misc.ts
 function instanceOf(klass) {
   return define(
-    (blob, ok2, err2) => blob instanceof klass ? ok2(blob) : err2(`Must be ${klass.name} instance`)
+    (blob, ok2, err2) => (
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+      blob instanceof klass ? ok2(blob) : err2(`Must be ${klass.name} instance`)
+    )
   );
 }
 function lazy(decoderFn) {
@@ -547,8 +600,8 @@ function either(...decoders) {
   }
   return define((blob, _, err2) => {
     const errors = [];
-    for (let i = 0; i < decoders.length; i++) {
-      const result = decoders[i].decode(blob);
+    for (const decoder of decoders) {
+      const result = decoder.decode(blob);
       if (result.ok) {
         return result;
       } else {
@@ -649,7 +702,7 @@ var truthy = define((blob, ok2, _) => ok2(!!blob));
 // src/collections.ts
 function record(fst, snd) {
   const keyDecoder = snd !== void 0 ? fst : void 0;
-  const valueDecoder = snd !== void 0 ? snd : fst;
+  const valueDecoder = snd ?? fst;
   return pojo.then((input, ok2, err2) => {
     let rv = {};
     const errors = /* @__PURE__ */ new Map();
@@ -690,9 +743,9 @@ function mapping(decoder) {
 
 // src/lib/size-options.ts
 function bySizeOptions(options) {
-  const size = options?.size;
-  const min = size ?? options?.min;
-  const max = size ?? options?.max;
+  const size = options.size;
+  const min = size ?? options.min;
+  const max = size ?? options.max;
   const atLeast = min === max ? "" : "at least ";
   const atMost = min === max ? "" : "at most ";
   const tooShort = min !== void 0 && `Too short, must be ${atLeast}${min} chars`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "decoders",
-  "version": "2.5.0",
+  "version": "2.6.1",
   "description": "Elegant and battle-tested validation library for type-safe input data for TypeScript",
   "license": "MIT",
   "repository": {
@@ -14,7 +14,6 @@
   },
   "type": "module",
   "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
   "types": "./dist/index.d.cts",
   "exports": {
     ".": {
@@ -61,27 +60,27 @@
     "verify"
   ],
   "devDependencies": {
-    "@arethetypeswrong/cli": "^0.16.4",
-    "@release-it/keep-a-changelog": "^5.0.0",
-    "@types/eslint": "^8.56.10",
-    "@typescript-eslint/eslint-plugin": "^7.14.1",
-    "@typescript-eslint/parser": "^7.14.1",
-    "@vitest/coverage-istanbul": "^1.6.0",
-    "eslint": "^8.57.0",
-    "eslint-plugin-import": "^2.29.1",
-    "eslint-plugin-simple-import-sort": "^12.1.0",
-    "fast-check": "^3.22.0",
-    "itertools": "^2.3.2",
-    "pkg-pr-new": "^0.0.24",
-    "prettier": "^3.3.3",
-    "publint": "^0.2.11",
-    "release-it": "^17.6.0",
-    "ts-morph": "^23.0.0",
+    "@arethetypeswrong/cli": "^0.17.4",
+    "@eslint/js": "^9.21.0",
+    "@release-it/keep-a-changelog": "^6.0.0",
+    "@standard-schema/spec": "^1.0.0",
+    "@vitest/coverage-istanbul": "^3.0.7",
+    "eslint": "^9.21.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "fast-check": "^3.23.2",
+    "itertools": "^2.4.1",
+    "pkg-pr-new": "^0.0.39",
+    "prettier": "^3.5.2",
+    "publint": "^0.3.6",
+    "release-it": "^18.1.2",
+    "ts-morph": "^25.0.1",
     "tsd": "^0.31.2",
-    "tsup": "^8.3.0",
-    "typescript": "^5.5.2",
-    "vite-tsconfig-paths": "^4.3.2",
-    "vitest": "^1.6.0"
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.25.0",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.0.7"
   },
   "githubUrl": "https://github.com/nvie/decoders",
   "sideEffects": false