decoders 2.9.0-pre.4 → 2.9.0

package/dist/index.cjs

@@ -1,19 +1,25 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/lib/utils.ts
+// @__NO_SIDE_EFFECTS__
 function isNumber(value) {
   return typeof value === "number";
 }
+// @__NO_SIDE_EFFECTS__
 function isString(value) {
   return typeof value === "string";
 }
+// @__NO_SIDE_EFFECTS__
 function isBigInt(value) {
   return typeof value === "bigint";
 }
+// @__NO_SIDE_EFFECTS__
 function isDate(value) {
   return !!value && Object.prototype.toString.call(value) === "[object Date]" && !isNaN(value);
 }
+// @__NO_SIDE_EFFECTS__
 function isPromiseLike(value) {
   return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
 }
+// @__NO_SIDE_EFFECTS__
 function isPlainObject(value) {
   return value !== null && typeof value === "object" && // This still seems to be the only reliable way to determine whether
   // something is a pojo... ¯\_(ツ)_/¯
@@ -112,36 +118,40 @@ function public_annotateObject(obj, text) {
 
 // src/lib/text.ts
 var INDENT = "  ";
+// @__NO_SIDE_EFFECTS__
 function isMultiline(s) {
   return s.includes("\n");
 }
+// @__NO_SIDE_EFFECTS__
 function indent(s, prefix = INDENT) {
-  if (isMultiline(s)) {
+  if (/* @__PURE__ */ isMultiline(s)) {
     return s.split("\n").map((line) => `${prefix}${line}`).join("\n");
   } else {
     return `${prefix}${s}`;
   }
 }
 var quotePattern = /'/g;
+// @__NO_SIDE_EFFECTS__
 function quote(value) {
   return typeof value === "string" ? "'" + value.replace(quotePattern, "\\'") + "'" : value === void 0 ? "undefined" : JSON.stringify(value);
 }
 
 // src/core/format.ts
+// @__NO_SIDE_EFFECTS__
 function summarize(ann, keypath = []) {
   const result = [];
   if (ann.type === "array") {
     const items = ann.items;
     let index = 0;
     for (const ann2 of items) {
-      for (const item of summarize(ann2, [...keypath, index++])) {
+      for (const item of /* @__PURE__ */ summarize(ann2, [...keypath, index++])) {
         result.push(item);
       }
     }
   } else if (ann.type === "object") {
     const fields = ann.fields;
     for (const [key, value] of fields) {
-      for (const item of summarize(value, [...keypath, key])) {
+      for (const item of /* @__PURE__ */ summarize(value, [...keypath, key])) {
         result.push(item);
       }
     }
@@ -253,7 +263,7 @@ ${annotation}`;
   }
 }
 function formatShort(ann) {
-  return summarize(ann, []).join("\n");
+  return (/* @__PURE__ */ summarize(ann, [])).join("\n");
 }
 function* iterAnnotation(ann, stack) {
   if (ann.text) {
@@ -292,9 +302,11 @@ function formatAsIssues(ann) {
 }
 
 // src/core/Result.ts
+// @__NO_SIDE_EFFECTS__
 function ok(value) {
   return { ok: true, value, error: void 0 };
 }
+// @__NO_SIDE_EFFECTS__
 function err(error) {
   return { ok: false, value: void 0, error };
 }
@@ -321,6 +333,7 @@ ${formatted}`);
     return formatted;
   }
 }
+// @__NO_SIDE_EFFECTS__
 function define(fn) {
   function decode(blob) {
     const makeFlexErr = (msg) => err(isAnnotation(msg) ? msg : public_annotate(blob, msg));
@@ -355,11 +368,11 @@ function define(fn) {
     return self;
   }
   function chain(next) {
-    return define((blob, ok2, err2) => {
+    return /* @__PURE__ */ define((blob, ok2, err2) => {
       const r1 = decode(blob);
       if (!r1.ok) return r1;
-      const r2 = isDecoder(next) ? next : next(r1.value, ok2, err2);
-      return isDecoder(r2) ? r2.decode(r1.value) : r2;
+      const r2 = /* @__PURE__ */ isDecoder(next) ? next : next(r1.value, ok2, err2);
+      return /* @__PURE__ */ isDecoder(r2) ? r2.decode(r1.value) : r2;
     });
   }
   function pipe(next) {
@@ -372,7 +385,7 @@ function define(fn) {
     });
   }
   function describe(message) {
-    return define((blob, _, err2) => {
+    return /* @__PURE__ */ define((blob, _, err2) => {
       const result = decode(blob);
       if (result.ok) {
         return result;
@@ -415,6 +428,7 @@ function brand2(decoder) {
   _register2.add(decoder);
   return decoder;
 }
+// @__NO_SIDE_EFFECTS__
 function isDecoder(value) {
   return _register2.has(value);
 }
@@ -426,6 +440,7 @@ var poja = define((blob, ok2, err2) => {
   }
   return ok2(blob);
 });
+// @__NO_SIDE_EFFECTS__
 function array(decoder) {
   const decodeFn = decoder.decode;
   return poja.chain((inputs, ok2, err2) => {
@@ -453,12 +468,14 @@ function array(decoder) {
 function isNonEmpty(arr) {
   return arr.length > 0;
 }
+// @__NO_SIDE_EFFECTS__
 function nonEmptyArray(decoder) {
-  return array(decoder).refine(isNonEmpty, "Must be non-empty array");
+  return (/* @__PURE__ */ array(decoder)).refine(isNonEmpty, "Must be non-empty array");
 }
-var ntuple = (n) => poja.refine((arr) => arr.length === n, `Must be a ${n}-tuple`);
+var ntuple = /* @__NO_SIDE_EFFECTS__ */ (n) => poja.refine((arr) => arr.length === n, `Must be a ${n}-tuple`);
+// @__NO_SIDE_EFFECTS__
 function tuple(...decoders) {
-  return ntuple(decoders.length).chain((blobs, ok2, err2) => {
+  return (/* @__PURE__ */ ntuple(decoders.length)).chain((blobs, ok2, err2) => {
     let allOk = true;
     const rvs = decoders.map((decoder, i) => {
       const blob = blobs[i];
@@ -479,6 +496,7 @@ function tuple(...decoders) {
 }
 
 // src/lib/size-options.ts
+// @__NO_SIDE_EFFECTS__
 function bySizeOptions(options) {
   const size = options.size;
   const min2 = _nullishCoalesce(size, () => ( options.min));
@@ -501,6 +519,7 @@ function bySizeOptions(options) {
 }
 
 // src/misc.ts
+// @__NO_SIDE_EFFECTS__
 function instanceOf(klass) {
   return define(
     (blob, ok2, err2) => (
@@ -509,12 +528,15 @@ function instanceOf(klass) {
     )
   );
 }
+// @__NO_SIDE_EFFECTS__
 function lazy(decoderFn) {
   return define((blob) => decoderFn().decode(blob));
 }
+// @__NO_SIDE_EFFECTS__
 function sized(decoder, options) {
   return decoder.reject(bySizeOptions(options));
 }
+// @__NO_SIDE_EFFECTS__
 function prep(mapperFn, decoder) {
   return define((originalInput, _, err2) => {
     let blob;
@@ -535,6 +557,7 @@ function prep(mapperFn, decoder) {
 }
 
 // src/lib/set-methods.ts
+// @__NO_SIDE_EFFECTS__
 function difference(xs, ys) {
   const result = /* @__PURE__ */ new Set();
   for (const x of xs) {
@@ -549,6 +572,7 @@ function difference(xs, ys) {
 var pojo = define(
   (blob, ok2, err2) => isPlainObject(blob) ? ok2(blob) : err2("Must be an object")
 );
+// @__NO_SIDE_EFFECTS__
 function object(decoders) {
   const knownKeys = new Set(Object.keys(decoders));
   return pojo.chain((plainObj, ok2, err2) => {
@@ -591,6 +615,7 @@ function object(decoders) {
     return ok2(record2);
   });
 }
+// @__NO_SIDE_EFFECTS__
 function exact(decoders) {
   const allowedKeys = new Set(Object.keys(decoders));
   const checked = pojo.reject((plainObj) => {
@@ -598,12 +623,13 @@ function exact(decoders) {
     const extraKeys = difference(actualKeys, allowedKeys);
     return extraKeys.size > 0 ? `Unexpected extra keys: ${Array.from(extraKeys).map(quote).join(", ")}` : null;
   });
-  return checked.pipe(object(decoders));
+  return checked.pipe(/* @__PURE__ */ object(decoders));
 }
+// @__NO_SIDE_EFFECTS__
 function inexact(decoders) {
   return pojo.pipe((plainObj) => {
     const allkeys = new Set(Object.keys(plainObj));
-    return object(decoders).transform((safepart) => {
+    return (/* @__PURE__ */ object(decoders)).transform((safepart) => {
       const safekeys = new Set(Object.keys(decoders));
       for (const k of safekeys) allkeys.add(k);
       const rv = {};
@@ -630,6 +656,7 @@ function itemize(s) {
 function nest(errText) {
   return errText.startsWith(EITHER_PREFIX) ? errText.substring(EITHER_PREFIX.length) : itemize(errText);
 }
+// @__NO_SIDE_EFFECTS__
 function either(...decoders) {
   if (decoders.length === 0) {
     throw new Error("Pass at least one decoder to either()");
@@ -648,6 +675,7 @@ function either(...decoders) {
     return err2(text);
   });
 }
+// @__NO_SIDE_EFFECTS__
 function oneOf(constants) {
   return define((blob, ok2, err2) => {
     const index = constants.indexOf(blob);
@@ -657,28 +685,31 @@ function oneOf(constants) {
     return err2(`Must be one of ${constants.map((value) => quote(value)).join(", ")}`);
   });
 }
+// @__NO_SIDE_EFFECTS__
 function enum_(enumObj) {
   const values = Object.values(enumObj);
   if (!values.some(isNumber)) {
-    return oneOf(values);
+    return /* @__PURE__ */ oneOf(values);
   } else {
     const nums = values.filter(isNumber);
     const ignore = new Set(nums.map((val) => enumObj[val]));
     const strings = values.filter(isString).filter((val) => !ignore.has(val));
-    return oneOf([...nums, ...strings]);
+    return /* @__PURE__ */ oneOf([...nums, ...strings]);
   }
 }
+// @__NO_SIDE_EFFECTS__
 function taggedUnion(field, mapping2) {
   const scout = object({
-    [field]: prep(String, oneOf(Object.keys(mapping2)))
+    [field]: prep(String, /* @__PURE__ */ oneOf(Object.keys(mapping2)))
   }).transform((o) => o[field]);
-  return select(
+  return /* @__PURE__ */ select(
     scout,
     // peek...
     (key) => mapping2[key]
     // ...then select
   );
 }
+// @__NO_SIDE_EFFECTS__
 function select(scout, selectFn) {
   return define((blob) => {
     const result = scout.decode(blob);
@@ -690,36 +721,42 @@ function select(scout, selectFn) {
 function lazyval(value) {
   return typeof value === "function" ? value() : value;
 }
-var null_ = constant(null);
-var undefined_ = constant(void 0);
+var null_ = /* @__PURE__ */ constant(null);
+var undefined_ = /* @__PURE__ */ constant(void 0);
 var nullish_ = define(
   (blob, ok2, err2) => (
     // Equiv to either(undefined_, null_), but combined for better error message
     blob == null ? ok2(blob) : err2("Must be undefined or null")
   )
 );
+// @__NO_SIDE_EFFECTS__
 function optional(decoder, defaultValue) {
   const rv = either(undefined_, decoder);
   return arguments.length >= 2 ? rv.transform((value) => _nullishCoalesce(value, () => ( lazyval(defaultValue)))) : rv;
 }
+// @__NO_SIDE_EFFECTS__
 function nullable(decoder, defaultValue) {
   const rv = either(null_, decoder);
   return arguments.length >= 2 ? rv.transform((value) => _nullishCoalesce(value, () => ( lazyval(defaultValue)))) : rv;
 }
+// @__NO_SIDE_EFFECTS__
 function nullish(decoder, defaultValue) {
   const rv = either(nullish_, decoder);
   return arguments.length >= 2 ? rv.transform((value) => _nullishCoalesce(value, () => ( lazyval(defaultValue)))) : rv;
 }
+// @__NO_SIDE_EFFECTS__
 function constant(value) {
   return define(
     (blob, ok2, err2) => blob === value ? ok2(value) : err2(`Must be ${typeof value === "symbol" ? String(value) : quote(value)}`)
   );
 }
+// @__NO_SIDE_EFFECTS__
 function always(value) {
   return define(
     typeof value === "function" ? (_, ok2) => ok2(value()) : (_, ok2) => ok2(value)
   );
 }
+// @__NO_SIDE_EFFECTS__
 function never(msg) {
   return define((_, __, err2) => err2(msg));
 }
@@ -734,6 +771,7 @@ var boolean = define((blob, ok2, err2) => {
 var truthy = define((blob, ok2, _) => ok2(!!blob));
 
 // src/collections.ts
+// @__NO_SIDE_EFFECTS__
 function record(fst, snd) {
   const keyDecoder = snd !== void 0 ? fst : void 0;
   const valueDecoder = _nullishCoalesce(snd, () => ( fst));
@@ -766,11 +804,13 @@ function record(fst, snd) {
     }
   });
 }
+// @__NO_SIDE_EFFECTS__
 function setFromArray(decoder) {
   return array(decoder).transform((items) => new Set(items));
 }
+// @__NO_SIDE_EFFECTS__
 function mapping(decoder) {
-  return record(decoder).transform((obj) => new Map(Object.entries(obj)));
+  return (/* @__PURE__ */ record(decoder)).transform((obj) => new Map(Object.entries(obj)));
 }
 
 // src/strings.ts
@@ -778,78 +818,81 @@ var url_re = /^([A-Za-z]{2,12}(?:[+][A-Za-z]{2,12})?):\/\/(?:([^@:]*:?(?:[^@]+)?
 var string = define(
   (blob, ok2, err2) => isString(blob) ? ok2(blob) : err2("Must be string")
 );
-var nonEmptyString = regex(/\S/, "Must be non-empty string");
+var nonEmptyString = /* @__PURE__ */ regex(/\S/, "Must be non-empty string");
+// @__NO_SIDE_EFFECTS__
 function regex(regex2, msg) {
   return string.refine((s) => regex2.test(s), msg);
 }
+// @__NO_SIDE_EFFECTS__
 function startsWith(prefix) {
   return string.refine(
     (s) => s.startsWith(prefix),
     `Must start with '${prefix}'`
   );
 }
+// @__NO_SIDE_EFFECTS__
 function endsWith(suffix) {
   return string.refine(
     (s) => s.endsWith(suffix),
     `Must end with '${suffix}'`
   );
 }
-var email = regex(
+var email = /* @__PURE__ */ regex(
   // The almost perfect email regex, taken from https://emailregex.com/
   /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/,
   "Must be email"
 );
-var urlString = string.refine(
-  (s) => URL.canParse(s),
-  "Must be URL"
-);
-var url = either(
-  regex(url_re, "Must be URL").transform((value) => new URL(value)),
-  instanceOf(URL)
+var urlString = /* @__PURE__ */ regex(url_re, "Must be URL");
+var url = select(
+  unknown,
+  (blob) => typeof blob === "string" ? /* @__PURE__ */ urlString.transform((s) => new URL(s)) : /* @__PURE__ */ instanceOf(URL).describe("Must be URL")
 );
-var httpsUrl = url.refine(
+var httpsUrl = /* @__PURE__ */ url.refine(
   (value) => value.protocol === "https:",
-  "Must be an HTTPS URL"
+  "Must be HTTPS URL"
 );
-var identifier = regex(
+var identifier = /* @__PURE__ */ regex(
   /^[a-z_][a-z0-9_]*$/i,
   "Must be valid identifier"
 );
+// @__NO_SIDE_EFFECTS__
 function nanoid(options) {
-  return sized(regex(/^[a-z0-9_-]+$/i, "Must be nano ID"), _nullishCoalesce(options, () => ( { size: 21 })));
+  return sized(/* @__PURE__ */ regex(/^[a-z0-9_-]+$/i, "Must be nano ID"), _nullishCoalesce(options, () => ( { size: 21 })));
 }
-var uuid = regex(
+var uuid = /* @__PURE__ */ regex(
   /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
   "Must be uuid"
 );
 var uuidv1 = (
   // https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_1_(date-time_and_MAC_address)
-  uuid.refine((value) => value[14] === "1", "Must be uuidv1")
+  /* @__PURE__ */ uuid.refine((value) => value[14] === "1", "Must be uuidv1")
 );
 var uuidv4 = (
   // https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random)
-  uuid.refine((value) => value[14] === "4", "Must be uuidv4")
+  /* @__PURE__ */ uuid.refine((value) => value[14] === "4", "Must be uuidv4")
 );
-var decimal = regex(/^[0-9]+$/, "Must only contain digits");
-var hexadecimal = regex(
+var decimal = /* @__PURE__ */ regex(/^[0-9]+$/, "Must only contain digits");
+var hexadecimal = /* @__PURE__ */ regex(
   /^[0-9a-f]+$/i,
   "Must only contain hexadecimal digits"
 );
-var numeric = decimal.transform(Number);
+var numeric = /* @__PURE__ */ decimal.transform(Number);
 
 // src/dates.ts
 var iso8601_re = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:[.]\d+)?(?:Z|[+-]\d{2}:?\d{2})$/;
 var date = define((blob, ok2, err2) => {
   return isDate(blob) ? ok2(blob) : err2("Must be a Date");
 });
-var isoDateString = regex(
+var isoDateString = /* @__PURE__ */ regex(
   iso8601_re,
   "Must be ISO8601 format"
 ).refine(
   (value) => !Number.isNaN(new Date(value).getTime()),
   "Must be valid date/time value"
 );
-var isoDate = isoDateString.transform((value) => new Date(value));
+var isoDate = /* @__PURE__ */ isoDateString.transform(
+  (value) => new Date(value)
+);
 var flexDate = select(
   unknown,
   (blob) => typeof blob === "string" ? isoDate : isDate(blob) ? date : never("Must be a Date or date string")
@@ -862,32 +905,35 @@ var datelike = flexDate;
 var anyNumber = define(
   (blob, ok2, err2) => isNumber(blob) ? ok2(blob) : err2("Must be number")
 );
-var number = anyNumber.refine(
+var number = /* @__PURE__ */ anyNumber.refine(
   (n) => Number.isFinite(n),
   "Number must be finite"
 );
-var integer = number.refine(
+var integer = /* @__PURE__ */ number.refine(
   (n) => Number.isInteger(n),
   "Number must be an integer"
 );
-var positiveNumber = number.refine(
+var positiveNumber = /* @__PURE__ */ number.refine(
   (n) => n >= 0 && !Object.is(n, -0),
   "Number must be positive"
 );
-var positiveInteger = integer.refine(
+var positiveInteger = /* @__PURE__ */ integer.refine(
   (n) => n >= 0 && !Object.is(n, -0),
   "Number must be positive"
 );
+// @__NO_SIDE_EFFECTS__
 function min(min2, decoder = number) {
   return decoder.reject(
     (value) => value < min2 ? `Too low, must be at least ${min2}` : null
   );
 }
+// @__NO_SIDE_EFFECTS__
 function max(max2, decoder = number) {
   return decoder.reject(
     (value) => value > max2 ? `Too high, must be at most ${max2}` : null
   );
 }
+// @__NO_SIDE_EFFECTS__
 function between(min2, max2, decoder = number) {
   return decoder.reject(
     (value) => value < min2 ? `Too low, must be between ${min2} and ${max2}` : value > max2 ? `Too high, must be between ${min2} and ${max2}` : null
@@ -900,7 +946,7 @@ var bigint = define(
 // src/json.ts
 var jsonObject = lazy(() => record(json));
 var jsonArray = lazy(() => array(json));
-var json = either(
+var json = /* @__PURE__ */ either(
   null_,
   string,
   number,

package/dist/index.d.cts

@@ -423,11 +423,15 @@ type DistributiveRelax<T, Ks extends string | number | symbol> = T extends any ?
     [K in Exclude<Ks, keyof T>]?: never;
 }> : never;
 
-type SizeOptions = {
-    min?: number;
+type SizeOptions = Relax<{
+    size: number;
+} | {
+    min: number;
     max?: number;
-    size?: number;
-};
+} | {
+    min?: number;
+    max: number;
+}>;
 /**
  * Anything with a .length or .size property, like strings, arrays, or sets.
  */
@@ -609,9 +613,10 @@ declare const httpsUrl: Decoder<URL>;
  */
 declare const identifier: Decoder<string>;
 /**
- * Accepts and returns [nanoid](https://zelark.github.io/nano-id-cc) string
- * values. It assumes the default nanoid alphabet. If you're using a custom
- * alphabet, use `regex()` instead.
+ * Accepts and returns [Nano ID](https://zelark.github.io/nano-id-cc) string
+ * values. By default, expects a standard 21-char nanoid, but you can
+ * optionally specify different size constraints. It assumes the default nanoid
+ * alphabet.
  */
 declare function nanoid(options?: SizeOptions): Decoder<string>;
 /**

package/dist/index.d.ts

@@ -423,11 +423,15 @@ type DistributiveRelax<T, Ks extends string | number | symbol> = T extends any ?
     [K in Exclude<Ks, keyof T>]?: never;
 }> : never;
 
-type SizeOptions = {
-    min?: number;
+type SizeOptions = Relax<{
+    size: number;
+} | {
+    min: number;
     max?: number;
-    size?: number;
-};
+} | {
+    min?: number;
+    max: number;
+}>;
 /**
  * Anything with a .length or .size property, like strings, arrays, or sets.
  */
@@ -609,9 +613,10 @@ declare const httpsUrl: Decoder<URL>;
  */
 declare const identifier: Decoder<string>;
 /**
- * Accepts and returns [nanoid](https://zelark.github.io/nano-id-cc) string
- * values. It assumes the default nanoid alphabet. If you're using a custom
- * alphabet, use `regex()` instead.
+ * Accepts and returns [Nano ID](https://zelark.github.io/nano-id-cc) string
+ * values. By default, expects a standard 21-char nanoid, but you can
+ * optionally specify different size constraints. It assumes the default nanoid
+ * alphabet.
  */
 declare function nanoid(options?: SizeOptions): Decoder<string>;
 /**

package/dist/index.js

@@ -1,19 +1,25 @@
 // src/lib/utils.ts
+// @__NO_SIDE_EFFECTS__
 function isNumber(value) {
   return typeof value === "number";
 }
+// @__NO_SIDE_EFFECTS__
 function isString(value) {
   return typeof value === "string";
 }
+// @__NO_SIDE_EFFECTS__
 function isBigInt(value) {
   return typeof value === "bigint";
 }
+// @__NO_SIDE_EFFECTS__
 function isDate(value) {
   return !!value && Object.prototype.toString.call(value) === "[object Date]" && !isNaN(value);
 }
+// @__NO_SIDE_EFFECTS__
 function isPromiseLike(value) {
   return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
 }
+// @__NO_SIDE_EFFECTS__
 function isPlainObject(value) {
   return value !== null && typeof value === "object" && // This still seems to be the only reliable way to determine whether
   // something is a pojo... ¯\_(ツ)_/¯
@@ -112,36 +118,40 @@ function public_annotateObject(obj, text) {
 
 // src/lib/text.ts
 var INDENT = "  ";
+// @__NO_SIDE_EFFECTS__
 function isMultiline(s) {
   return s.includes("\n");
 }
+// @__NO_SIDE_EFFECTS__
 function indent(s, prefix = INDENT) {
-  if (isMultiline(s)) {
+  if (/* @__PURE__ */ isMultiline(s)) {
     return s.split("\n").map((line) => `${prefix}${line}`).join("\n");
   } else {
     return `${prefix}${s}`;
   }
 }
 var quotePattern = /'/g;
+// @__NO_SIDE_EFFECTS__
 function quote(value) {
   return typeof value === "string" ? "'" + value.replace(quotePattern, "\\'") + "'" : value === void 0 ? "undefined" : JSON.stringify(value);
 }
 
 // src/core/format.ts
+// @__NO_SIDE_EFFECTS__
 function summarize(ann, keypath = []) {
   const result = [];
   if (ann.type === "array") {
     const items = ann.items;
     let index = 0;
     for (const ann2 of items) {
-      for (const item of summarize(ann2, [...keypath, index++])) {
+      for (const item of /* @__PURE__ */ summarize(ann2, [...keypath, index++])) {
         result.push(item);
       }
     }
   } else if (ann.type === "object") {
     const fields = ann.fields;
     for (const [key, value] of fields) {
-      for (const item of summarize(value, [...keypath, key])) {
+      for (const item of /* @__PURE__ */ summarize(value, [...keypath, key])) {
         result.push(item);
       }
     }
@@ -253,7 +263,7 @@ ${annotation}`;
   }
 }
 function formatShort(ann) {
-  return summarize(ann, []).join("\n");
+  return (/* @__PURE__ */ summarize(ann, [])).join("\n");
 }
 function* iterAnnotation(ann, stack) {
   if (ann.text) {
@@ -292,9 +302,11 @@ function formatAsIssues(ann) {
 }
 
 // src/core/Result.ts
+// @__NO_SIDE_EFFECTS__
 function ok(value) {
   return { ok: true, value, error: void 0 };
 }
+// @__NO_SIDE_EFFECTS__
 function err(error) {
   return { ok: false, value: void 0, error };
 }
@@ -321,6 +333,7 @@ ${formatted}`);
     return formatted;
   }
 }
+// @__NO_SIDE_EFFECTS__
 function define(fn) {
   function decode(blob) {
     const makeFlexErr = (msg) => err(isAnnotation(msg) ? msg : public_annotate(blob, msg));
@@ -355,11 +368,11 @@ function define(fn) {
     return self;
   }
   function chain(next) {
-    return define((blob, ok2, err2) => {
+    return /* @__PURE__ */ define((blob, ok2, err2) => {
       const r1 = decode(blob);
       if (!r1.ok) return r1;
-      const r2 = isDecoder(next) ? next : next(r1.value, ok2, err2);
-      return isDecoder(r2) ? r2.decode(r1.value) : r2;
+      const r2 = /* @__PURE__ */ isDecoder(next) ? next : next(r1.value, ok2, err2);
+      return /* @__PURE__ */ isDecoder(r2) ? r2.decode(r1.value) : r2;
     });
   }
   function pipe(next) {
@@ -372,7 +385,7 @@ function define(fn) {
     });
   }
   function describe(message) {
-    return define((blob, _, err2) => {
+    return /* @__PURE__ */ define((blob, _, err2) => {
       const result = decode(blob);
       if (result.ok) {
         return result;
@@ -415,6 +428,7 @@ function brand2(decoder) {
   _register2.add(decoder);
   return decoder;
 }
+// @__NO_SIDE_EFFECTS__
 function isDecoder(value) {
   return _register2.has(value);
 }
@@ -426,6 +440,7 @@ var poja = define((blob, ok2, err2) => {
   }
   return ok2(blob);
 });
+// @__NO_SIDE_EFFECTS__
 function array(decoder) {
   const decodeFn = decoder.decode;
   return poja.chain((inputs, ok2, err2) => {
@@ -453,12 +468,14 @@ function array(decoder) {
 function isNonEmpty(arr) {
   return arr.length > 0;
 }
+// @__NO_SIDE_EFFECTS__
 function nonEmptyArray(decoder) {
-  return array(decoder).refine(isNonEmpty, "Must be non-empty array");
+  return (/* @__PURE__ */ array(decoder)).refine(isNonEmpty, "Must be non-empty array");
 }
-var ntuple = (n) => poja.refine((arr) => arr.length === n, `Must be a ${n}-tuple`);
+var ntuple = /* @__NO_SIDE_EFFECTS__ */ (n) => poja.refine((arr) => arr.length === n, `Must be a ${n}-tuple`);
+// @__NO_SIDE_EFFECTS__
 function tuple(...decoders) {
-  return ntuple(decoders.length).chain((blobs, ok2, err2) => {
+  return (/* @__PURE__ */ ntuple(decoders.length)).chain((blobs, ok2, err2) => {
     let allOk = true;
     const rvs = decoders.map((decoder, i) => {
       const blob = blobs[i];
@@ -479,6 +496,7 @@ function tuple(...decoders) {
 }
 
 // src/lib/size-options.ts
+// @__NO_SIDE_EFFECTS__
 function bySizeOptions(options) {
   const size = options.size;
   const min2 = size ?? options.min;
@@ -501,6 +519,7 @@ function bySizeOptions(options) {
 }
 
 // src/misc.ts
+// @__NO_SIDE_EFFECTS__
 function instanceOf(klass) {
   return define(
     (blob, ok2, err2) => (
@@ -509,12 +528,15 @@ function instanceOf(klass) {
     )
   );
 }
+// @__NO_SIDE_EFFECTS__
 function lazy(decoderFn) {
   return define((blob) => decoderFn().decode(blob));
 }
+// @__NO_SIDE_EFFECTS__
 function sized(decoder, options) {
   return decoder.reject(bySizeOptions(options));
 }
+// @__NO_SIDE_EFFECTS__
 function prep(mapperFn, decoder) {
   return define((originalInput, _, err2) => {
     let blob;
@@ -535,6 +557,7 @@ function prep(mapperFn, decoder) {
 }
 
 // src/lib/set-methods.ts
+// @__NO_SIDE_EFFECTS__
 function difference(xs, ys) {
   const result = /* @__PURE__ */ new Set();
   for (const x of xs) {
@@ -549,6 +572,7 @@ function difference(xs, ys) {
 var pojo = define(
   (blob, ok2, err2) => isPlainObject(blob) ? ok2(blob) : err2("Must be an object")
 );
+// @__NO_SIDE_EFFECTS__
 function object(decoders) {
   const knownKeys = new Set(Object.keys(decoders));
   return pojo.chain((plainObj, ok2, err2) => {
@@ -591,6 +615,7 @@ function object(decoders) {
     return ok2(record2);
   });
 }
+// @__NO_SIDE_EFFECTS__
 function exact(decoders) {
   const allowedKeys = new Set(Object.keys(decoders));
   const checked = pojo.reject((plainObj) => {
@@ -598,12 +623,13 @@ function exact(decoders) {
     const extraKeys = difference(actualKeys, allowedKeys);
     return extraKeys.size > 0 ? `Unexpected extra keys: ${Array.from(extraKeys).map(quote).join(", ")}` : null;
   });
-  return checked.pipe(object(decoders));
+  return checked.pipe(/* @__PURE__ */ object(decoders));
 }
+// @__NO_SIDE_EFFECTS__
 function inexact(decoders) {
   return pojo.pipe((plainObj) => {
     const allkeys = new Set(Object.keys(plainObj));
-    return object(decoders).transform((safepart) => {
+    return (/* @__PURE__ */ object(decoders)).transform((safepart) => {
       const safekeys = new Set(Object.keys(decoders));
       for (const k of safekeys) allkeys.add(k);
       const rv = {};
@@ -630,6 +656,7 @@ function itemize(s) {
 function nest(errText) {
   return errText.startsWith(EITHER_PREFIX) ? errText.substring(EITHER_PREFIX.length) : itemize(errText);
 }
+// @__NO_SIDE_EFFECTS__
 function either(...decoders) {
   if (decoders.length === 0) {
     throw new Error("Pass at least one decoder to either()");
@@ -648,6 +675,7 @@ function either(...decoders) {
     return err2(text);
   });
 }
+// @__NO_SIDE_EFFECTS__
 function oneOf(constants) {
   return define((blob, ok2, err2) => {
     const index = constants.indexOf(blob);
@@ -657,28 +685,31 @@ function oneOf(constants) {
     return err2(`Must be one of ${constants.map((value) => quote(value)).join(", ")}`);
   });
 }
+// @__NO_SIDE_EFFECTS__
 function enum_(enumObj) {
   const values = Object.values(enumObj);
   if (!values.some(isNumber)) {
-    return oneOf(values);
+    return /* @__PURE__ */ oneOf(values);
   } else {
     const nums = values.filter(isNumber);
     const ignore = new Set(nums.map((val) => enumObj[val]));
     const strings = values.filter(isString).filter((val) => !ignore.has(val));
-    return oneOf([...nums, ...strings]);
+    return /* @__PURE__ */ oneOf([...nums, ...strings]);
   }
 }
+// @__NO_SIDE_EFFECTS__
 function taggedUnion(field, mapping2) {
   const scout = object({
-    [field]: prep(String, oneOf(Object.keys(mapping2)))
+    [field]: prep(String, /* @__PURE__ */ oneOf(Object.keys(mapping2)))
   }).transform((o) => o[field]);
-  return select(
+  return /* @__PURE__ */ select(
     scout,
     // peek...
     (key) => mapping2[key]
     // ...then select
   );
 }
+// @__NO_SIDE_EFFECTS__
 function select(scout, selectFn) {
   return define((blob) => {
     const result = scout.decode(blob);
@@ -690,36 +721,42 @@ function select(scout, selectFn) {
 function lazyval(value) {
   return typeof value === "function" ? value() : value;
 }
-var null_ = constant(null);
-var undefined_ = constant(void 0);
+var null_ = /* @__PURE__ */ constant(null);
+var undefined_ = /* @__PURE__ */ constant(void 0);
 var nullish_ = define(
   (blob, ok2, err2) => (
     // Equiv to either(undefined_, null_), but combined for better error message
     blob == null ? ok2(blob) : err2("Must be undefined or null")
   )
 );
+// @__NO_SIDE_EFFECTS__
 function optional(decoder, defaultValue) {
   const rv = either(undefined_, decoder);
   return arguments.length >= 2 ? rv.transform((value) => value ?? lazyval(defaultValue)) : rv;
 }
+// @__NO_SIDE_EFFECTS__
 function nullable(decoder, defaultValue) {
   const rv = either(null_, decoder);
   return arguments.length >= 2 ? rv.transform((value) => value ?? lazyval(defaultValue)) : rv;
 }
+// @__NO_SIDE_EFFECTS__
 function nullish(decoder, defaultValue) {
   const rv = either(nullish_, decoder);
   return arguments.length >= 2 ? rv.transform((value) => value ?? lazyval(defaultValue)) : rv;
 }
+// @__NO_SIDE_EFFECTS__
 function constant(value) {
   return define(
     (blob, ok2, err2) => blob === value ? ok2(value) : err2(`Must be ${typeof value === "symbol" ? String(value) : quote(value)}`)
   );
 }
+// @__NO_SIDE_EFFECTS__
 function always(value) {
   return define(
     typeof value === "function" ? (_, ok2) => ok2(value()) : (_, ok2) => ok2(value)
   );
 }
+// @__NO_SIDE_EFFECTS__
 function never(msg) {
   return define((_, __, err2) => err2(msg));
 }
@@ -734,6 +771,7 @@ var boolean = define((blob, ok2, err2) => {
 var truthy = define((blob, ok2, _) => ok2(!!blob));
 
 // src/collections.ts
+// @__NO_SIDE_EFFECTS__
 function record(fst, snd) {
   const keyDecoder = snd !== void 0 ? fst : void 0;
   const valueDecoder = snd ?? fst;
@@ -766,11 +804,13 @@ function record(fst, snd) {
     }
   });
 }
+// @__NO_SIDE_EFFECTS__
 function setFromArray(decoder) {
   return array(decoder).transform((items) => new Set(items));
 }
+// @__NO_SIDE_EFFECTS__
 function mapping(decoder) {
-  return record(decoder).transform((obj) => new Map(Object.entries(obj)));
+  return (/* @__PURE__ */ record(decoder)).transform((obj) => new Map(Object.entries(obj)));
 }
 
 // src/strings.ts
@@ -778,78 +818,81 @@ var url_re = /^([A-Za-z]{2,12}(?:[+][A-Za-z]{2,12})?):\/\/(?:([^@:]*:?(?:[^@]+)?
 var string = define(
   (blob, ok2, err2) => isString(blob) ? ok2(blob) : err2("Must be string")
 );
-var nonEmptyString = regex(/\S/, "Must be non-empty string");
+var nonEmptyString = /* @__PURE__ */ regex(/\S/, "Must be non-empty string");
+// @__NO_SIDE_EFFECTS__
 function regex(regex2, msg) {
   return string.refine((s) => regex2.test(s), msg);
 }
+// @__NO_SIDE_EFFECTS__
 function startsWith(prefix) {
   return string.refine(
     (s) => s.startsWith(prefix),
     `Must start with '${prefix}'`
   );
 }
+// @__NO_SIDE_EFFECTS__
 function endsWith(suffix) {
   return string.refine(
     (s) => s.endsWith(suffix),
     `Must end with '${suffix}'`
   );
 }
-var email = regex(
+var email = /* @__PURE__ */ regex(
   // The almost perfect email regex, taken from https://emailregex.com/
   /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/,
   "Must be email"
 );
-var urlString = string.refine(
-  (s) => URL.canParse(s),
-  "Must be URL"
-);
-var url = either(
-  regex(url_re, "Must be URL").transform((value) => new URL(value)),
-  instanceOf(URL)
+var urlString = /* @__PURE__ */ regex(url_re, "Must be URL");
+var url = select(
+  unknown,
+  (blob) => typeof blob === "string" ? /* @__PURE__ */ urlString.transform((s) => new URL(s)) : /* @__PURE__ */ instanceOf(URL).describe("Must be URL")
 );
-var httpsUrl = url.refine(
+var httpsUrl = /* @__PURE__ */ url.refine(
   (value) => value.protocol === "https:",
-  "Must be an HTTPS URL"
+  "Must be HTTPS URL"
 );
-var identifier = regex(
+var identifier = /* @__PURE__ */ regex(
   /^[a-z_][a-z0-9_]*$/i,
   "Must be valid identifier"
 );
+// @__NO_SIDE_EFFECTS__
 function nanoid(options) {
-  return sized(regex(/^[a-z0-9_-]+$/i, "Must be nano ID"), options ?? { size: 21 });
+  return sized(/* @__PURE__ */ regex(/^[a-z0-9_-]+$/i, "Must be nano ID"), options ?? { size: 21 });
 }
-var uuid = regex(
+var uuid = /* @__PURE__ */ regex(
   /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
   "Must be uuid"
 );
 var uuidv1 = (
   // https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_1_(date-time_and_MAC_address)
-  uuid.refine((value) => value[14] === "1", "Must be uuidv1")
+  /* @__PURE__ */ uuid.refine((value) => value[14] === "1", "Must be uuidv1")
 );
 var uuidv4 = (
   // https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random)
-  uuid.refine((value) => value[14] === "4", "Must be uuidv4")
+  /* @__PURE__ */ uuid.refine((value) => value[14] === "4", "Must be uuidv4")
 );
-var decimal = regex(/^[0-9]+$/, "Must only contain digits");
-var hexadecimal = regex(
+var decimal = /* @__PURE__ */ regex(/^[0-9]+$/, "Must only contain digits");
+var hexadecimal = /* @__PURE__ */ regex(
   /^[0-9a-f]+$/i,
   "Must only contain hexadecimal digits"
 );
-var numeric = decimal.transform(Number);
+var numeric = /* @__PURE__ */ decimal.transform(Number);
 
 // src/dates.ts
 var iso8601_re = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:[.]\d+)?(?:Z|[+-]\d{2}:?\d{2})$/;
 var date = define((blob, ok2, err2) => {
   return isDate(blob) ? ok2(blob) : err2("Must be a Date");
 });
-var isoDateString = regex(
+var isoDateString = /* @__PURE__ */ regex(
   iso8601_re,
   "Must be ISO8601 format"
 ).refine(
   (value) => !Number.isNaN(new Date(value).getTime()),
   "Must be valid date/time value"
 );
-var isoDate = isoDateString.transform((value) => new Date(value));
+var isoDate = /* @__PURE__ */ isoDateString.transform(
+  (value) => new Date(value)
+);
 var flexDate = select(
   unknown,
   (blob) => typeof blob === "string" ? isoDate : isDate(blob) ? date : never("Must be a Date or date string")
@@ -862,32 +905,35 @@ var datelike = flexDate;
 var anyNumber = define(
   (blob, ok2, err2) => isNumber(blob) ? ok2(blob) : err2("Must be number")
 );
-var number = anyNumber.refine(
+var number = /* @__PURE__ */ anyNumber.refine(
   (n) => Number.isFinite(n),
   "Number must be finite"
 );
-var integer = number.refine(
+var integer = /* @__PURE__ */ number.refine(
   (n) => Number.isInteger(n),
   "Number must be an integer"
 );
-var positiveNumber = number.refine(
+var positiveNumber = /* @__PURE__ */ number.refine(
   (n) => n >= 0 && !Object.is(n, -0),
   "Number must be positive"
 );
-var positiveInteger = integer.refine(
+var positiveInteger = /* @__PURE__ */ integer.refine(
   (n) => n >= 0 && !Object.is(n, -0),
   "Number must be positive"
 );
+// @__NO_SIDE_EFFECTS__
 function min(min2, decoder = number) {
   return decoder.reject(
     (value) => value < min2 ? `Too low, must be at least ${min2}` : null
   );
 }
+// @__NO_SIDE_EFFECTS__
 function max(max2, decoder = number) {
   return decoder.reject(
     (value) => value > max2 ? `Too high, must be at most ${max2}` : null
   );
 }
+// @__NO_SIDE_EFFECTS__
 function between(min2, max2, decoder = number) {
   return decoder.reject(
     (value) => value < min2 ? `Too low, must be between ${min2} and ${max2}` : value > max2 ? `Too high, must be between ${min2} and ${max2}` : null
@@ -900,7 +946,7 @@ var bigint = define(
 // src/json.ts
 var jsonObject = lazy(() => record(json));
 var jsonArray = lazy(() => array(json));
-var json = either(
+var json = /* @__PURE__ */ either(
   null_,
   string,
   number,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "decoders",
-  "version": "2.9.0-pre.4",
+  "version": "2.9.0",
   "description": "Elegant and battle-tested validation library for type-safe input data for TypeScript",
   "license": "MIT",
   "repository": {
@@ -37,10 +37,12 @@
     "build": "tsup",
     "docs": "npm run build && cp -r dist/ docs/decoders-latest-snapshot/ && cd docs && rm -rf .next && npm run dev",
     "docs:update-sources": "node bin/update-source-lines.js",
-    "lint": "oxlint src/ test/ && prettier --list-different src/ test/ test-d/",
+    "docs:update-redirects": "node bin/update-decoder-redirects.js",
+    "lint": "oxlint src/ test/ && prettier --list-different src/ test/ test-d/ && node bin/lint-side-effects.js",
     "lint:package": "publint --strict && attw --pack",
-    "format": "oxlint --fix src/ test/ ; prettier --write src/ test/ test-d/ docs/content/ ; npm run docs:update-sources",
+    "format": "oxlint --fix src/ test/ ; prettier --write src/ test/ test-d/ docs/content/ ; npm run docs:update-sources ; npm run docs:update-redirects",
     "test": "vitest run --coverage",
+    "test:treeshake": "npm run build && node bin/test-treeshake.js",
     "test:completeness": "./bin/check.sh",
     "test:typescript": "tsc --noEmit",
     "test:types": "npm run build && tsd --typings ./dist/index.d.ts",