sanity-advanced-validators 0.3.1 → 0.4.1

package/README.md

@@ -1,10 +1,8 @@
-*🚓 Never trust a user! 👮*
+_🚓 Never trust a user! 👮_
 
 # Sanity Advanced Validators
 
-This package includes a set of Sanity validators for aggressive and weird edge cases. *Maintain sanity with micro-managed validation.*
-
-Note: Every validator can accept an optional custom error message as its last parameter. See [minDimensions](#minDimensions) for an example.
+This package includes a set of Sanity validators for aggressive and weird edge cases. _Maintain sanity with micro-managed validation._
 
 ## Tools
 
@@ -15,12 +13,14 @@ Note: Every validator can accept an optional custom error message as its last pa
 - [requiredIfSiblingNeq](#requiredIfSiblingNeq)
 - [requiredIfSlugEq](#requiredIfSlugEq)
 - [requiredIfSlugNeq](#requiredIfSlugNeq)
+- [regex](#regex) 🆕
 - [referencedDocumentRequires](#referencedDocumentRequires)
 - [maxDepth](#maxDepth)
 
 ## Mega-example
 
 Imagine that you’ve got a document that has an optional video file, but…
+
 - it’s required on the `/about` page
 - if the video exists, it must be either **MP4** or **MOV**
 - and there must be a poster image that's between **1250x800** and **2500x1600** pixels in size
@@ -38,7 +38,7 @@ const Page = defineType({
       name: "someVideoFile",
       type: "file",
       validation: (rule) =>
-        rule.custom(requiredIfSlugEq('about'))
+        rule.custom(requiredIfSlugEq('about', 'A video is required if {slugKey} is {operand}.'))
           .custom(fileExtension(['mp4', 'mov']))
     })
     defineField({
@@ -60,6 +60,11 @@ const Page = defineType({
 
 Enforces that an uploaded file asset is of a certain format.
 
+```typescript
+fileType: string | Array<string>,
+message?: string // optional custom error message; replaces {validFileExtension} with fileType (flattened)
+```
+
 ```typescript
 import { fileExtension } from "sanity-advanced-validation"
 
@@ -81,17 +86,16 @@ const Page = defineType({
 })
 ```
 
-#### parameters
-```typescript
-fileType: string | Array<string>, 
-message?: string // optional custom error message; replaces {validFileExtension} with fileType (flattened)
-```
-
 ---
 
 ### minDimensions
 
-Enforces that an uploaded image asset is at minimum certain dimensions.
+Enforces that an uploaded image asset is at minimum certain dimensions. You can test on both, just x, or just y.
+
+```typescript
+dimensions: {x?: number, y?: number},
+message?: string // optional custom error message; replaces {x} and {y} with your dimension requirements, and {width} and {height} with submitted image dimensions
+```
 
 ```typescript
 import { minDimensions } from "sanity-advanced-validation"
@@ -110,35 +114,17 @@ const ImageWithCaption = defineType({
 })
 ```
 
-You can also enforce on only one dimension, or feed a custom error message:
+---
 
-```typescript
-defineField({
-  name: "heroImage",
-  type: "image",
-  description: "At least 1200px wide; as tall as you like.",
-  validation: (rule) => rule.custom(
-    minDimensions(
-      { x: 1200 }, 
-      "Uh oh, your image is {width} pixels wide. That’s less than {x}!"
-    )
-  ),
-})
-```
+### maxDimensions
+
+Enforces that an uploaded image asset is at most certain dimensions. You can test on both, just x, or just y.
 
-#### parameters
 ```typescript
-dimensions: {x?: number, y?: number}, 
+dimensions: {x?: number, y?: number},
 message?: string // optional custom error message; replaces {x} and {y} with your dimension requirements, and {width} and {height} with submitted image dimensions
 ```
 
----
-
-
-### maxDimensions
-
-Enforces that an uploaded image asset is at most certain dimensions.
-
 ```typescript
 defineField({
   name: "heroImage",
@@ -162,23 +148,22 @@ defineField({
 })
 ```
 
-#### parameters
-```typescript
-dimensions: {x?: number, y?: number}, 
-message?: string // optional custom error message; replaces {x} and {y} with your dimension requirements, and {width} and {height} with submitted image dimensions
-```
-
 ---
 
-
 ### requiredIfSiblingEq
 
-Mark a field as `required` if a sibling field has a particular value. This is the validator we use most. *It’s super effective!*
+Mark a field as `required` if a sibling field has a particular value. This is the validator we use most. _It’s super effective!_
 
-This is handy if you have a field that is hidden under some circumstances, but is `required()` when it’s visible. 
+This is handy if you have a field that is hidden under some circumstances, but is `required()` when it’s visible.
 
 _note:_ This does not work for slugs, because they have to match a nested `.current` value. Use the [requiredIfSlugEq validator](#requiredIfSlugEq) instead.
 
+```typescript
+key: string, // name of sibling
+operand: string | number | boolean | null | Array<string, number> // value that you’re testing for (i.e. if 'name' === operand)
+message?: string // optional custom error message; replaces {key} and {operand} with your input, and {siblingValue} with the value of the sibling you’re testing against.
+```
+
 ```typescript
 import {requiredIfSiblingEq} from 'sanity-advanced-validation'
 
@@ -202,7 +187,7 @@ defineType({
       type: 'string',
       options: {
         list: [
-          'javascript', 'rust', 'python', 'swift'
+          'typescript', 'rust', 'python', 'swift'
         ]
       },
       validation: rule => rule.custom(requiredIfSiblingEq('occupation', 'software engineer')),
@@ -212,35 +197,35 @@ defineType({
 })
 ```
 
-“If not that, then this.” This also works for null.
+And it also works for arrays.
 
 ```typescript
 defineType({
-  name: 'person',
-  type: 'object',
+  name: "person",
+  type: "object",
   fields: [
+    // ...
     defineField({
-      name: 'name',
-      type: 'string'
+      name: "occupation",
+      type: "string",
+      options: {
+        list: ["doctor", "lawyer", "software engineer", "linguist"],
+      },
     }),
     defineField({
-      name: 'email',
-      type: 'string',
-    })
-    defineField({
-      name: 'phone',
-      type: 'string',
-      validation: rule => rule.custom(requiredIfSiblingEq(
-        'email', 
-        null, 
-        "If you don’t have an email address, a phone number is required."
-      ))
-    })
+      name: "favoriteLanguage",
+      type: "string",
+      options: {
+        list: ["typescript", "rust", "python", "swift", "latin", "urdu", "klingon"],
+      },
+      validation: (rule) => rule.custom(requiredIfSiblingEq("occupation", ["software engineer", "linguist"])),
+      hidden: ({ parent }) => !["software engineer", "linguist"].includes(parent.occupation),
+    }),
   ],
 })
 ```
 
-And it even works for arrays.
+“If not that, then this.” It even works for null.
 
 ```typescript
 defineType({
@@ -252,43 +237,36 @@ defineType({
       type: 'string'
     }),
     defineField({
-      name: 'name',
-      type: 'string'
-    }),
-    defineField({
-      name: 'occupation',
+      name: 'email',
       type: 'string',
-      options: {
-        list: ['doctor', 'lawyer', 'software engineer']
-      }
-    }),
+    })
     defineField({
-      name: 'explanation',
-      description: 'Why are you wasting your life this way?',
-      type: 'text',
-      validation: rule => rule.custom(requiredIfSiblingEq('occupation', ['doctor', 'lawyer'])),
-      hidden: ({parent}) => parent.occuption === 'software engineer',
+      name: 'phone',
+      type: 'string',
+      validation: rule => rule.custom(requiredIfSiblingEq(
+        'email',
+        null,
+        "If you don’t have an email address, a phone number is required."
+      ))
     })
   ],
 })
 ```
 
-#### parameters
-```typescript
-key: string, // name of sibling
-operand: string | number | null | Array<string, number, null> // value that you’re testing for (i.e. if 'name' === operand)
-message?: string // optional custom error message; replaces {key} and {operand} with your input, and {siblingValue} with the value of the sibling you’re testing against.
-```
-
 ---
 
-
 ### requiredIfSiblingNeq
 
-For a given object that has multiple fields, mark a field as `required` if a sibling does _not_ have a particular value.
+For a given object that has multiple fields, mark a field as `required` if a sibling does _not_ have a particular value (or member of an array of values).
 
 _note:_ This does not work for slugs, because they have to match a nested `.current` value. Use the [requiredIfSlugNeq validator](#requiredIfSlugNeq) instead.
 
+```typescript
+key: string, // name of sibling
+operand: string | number | boolean | null | Array<string, number> // value that you’re testing for (i.e. if 'name' === operand)
+message?: string // optional custom error message; replaces {key} and {operand} with your input, and {siblingValue} with the value of the sibling you’re testing against.
+```
+
 ```typescript
 import {requiredIfSiblingNeq} from 'sanity-advanced-validation'
 
@@ -308,50 +286,46 @@ defineType({
       }
     })
     defineField({
-      name: 'why',
-      description: 'How many years will you spend paying off your degree?',
-      type: 'number',
-      validation: rule => rule.custom(requiredIfSiblingNeq('occupation', 'software engineer'))
-    }),
-  ],
+      name: "explanation",
+      description: "Why are you wasting your life this way?",
+      type: "text",
+      validation: (rule) => rule.custom(requiredIfSiblingNeq("occupation", "software engineer")),
+      hidden: ({ parent }) => parent.occuption === "software engineer",
+    }),  ],
 })
 ```
 
-#### parameters
-```typescript
-key: string, // name of sibling
-operand: string | number | null | Array<string, number, null> // value that you’re testing for (i.e. if 'name' === operand)
-message?: string // optional custom error message; replaces {key} and {operand} with your input, and {siblingValue} with the value of the sibling you’re testing against.
-```
-
 ---
 
-
 ### requiredIfSlugEq
 
-Require for matching slugs.
+Mark a field as `required` for documents with matching slugs.
 
 ```typescript
-import {requiredIfSlugEq} from 'sanity-advanced-validation'
+operand: string | number | null | Array<string, number> // possible slug or slugs you’re testing
+key?: string, // name of sibling if not "slug"
+message?: string // optional custom error message; replaces {slugKey} and {operand} with your input, and {siblingSlugValue} with the value of the sibling you’re testing against.
+```
+
+```typescript
+import { requiredIfSlugEq } from "sanity-advanced-validation"
 
 defineType({
-  name: 'page',
-  type: 'document',
+  name: "page",
+  type: "document",
   fields: [
     defineField({
-      name: 'slug',
-      type: 'slug'
+      name: "slug",
+      type: "slug",
     }),
     defineField({
-      name: 'questionsAndAnswers',
-      type: 'array',
-      of: [
-        {type: 'qaItem'}
-      ],
-      validation: rule => rule.custom(requiredIfSlugEq('faq')),
-      hidden: ({parent}) => parent.slug.current !== 'faq'
-    })
-  ]
+      name: "questionsAndAnswers",
+      type: "array",
+      of: [{ type: "qaItem" }],
+      validation: (rule) => rule.custom(requiredIfSlugEq("faq")),
+      hidden: ({ parent }) => parent.slug.current !== "faq",
+    }),
+  ],
 })
 ```
 
@@ -364,59 +338,85 @@ defineField({
 }),
 ```
 
-#### parameters
-```typescript
-operand: string | number | null | Array<string, number, null> // possible slug or slugs you’re testing
-key?: string, // name of sibling if not "slug"
-message?: string // optional custom error message; replaces {slugKey} and {operand} with your input, and {siblingSlugValue} with the value of the sibling you’re testing against.
-```
-
 ---
 
-
 ### requiredIfSlugNeq
 
 Require fields on pages that don't match one or more slugs.
 
 ```typescript
-import {requiredIfSlugNeq} from 'sanity-advanced-validation'
+operand: string | number | null | Array<string, number> // possible slug or slugs you’re testing
+key?: string, // name of sibling if not "slug"
+message?: string // optional custom error message; replaces {slugKey} and {operand} with your input, and {siblingSlugValue} with the value of the sibling you’re testing against.
+```
+
+```typescript
+import { requiredIfSlugNeq } from "sanity-advanced-validation"
 
 defineType({
-  name: 'page',
-  type: 'document',
+  name: "page",
+  type: "document",
   fields: [
     defineField({
-      name: 'slug',
-      type: 'slug'
+      name: "slug",
+      type: "slug",
     }),
     defineField({
-      name: 'subnav',
+      name: "subnav",
       description: `Subnav is required on documents that aren’t '/home'`,
-      type: 'array',
-      of: [
-        {type: 'navLink'}
-      ],
-      validation: rule => rule.custom(requiredIfSlugNeq('home')),
-      hidden: ({parent}) => parent.slug.current !== 'home'
-    })
-  ]
+      type: "array",
+      of: [{ type: "navLink" }],
+      validation: (rule) => rule.custom(requiredIfSlugNeq("home")),
+      hidden: ({ parent }) => parent.slug.current !== "home",
+    }),
+  ],
 })
 ```
 
-#### parameters
+---
+
+### regex
+
+Easily test any value against a regular expression.
+
+Values can be of type string, number, boolean… even objects!
+
+```typescript
+pattern: RegExp // regular expression
+message?: string // optional custom error message; replaces {pattern} with your input and {value} as submitted field value
+```
+
 ```typescript
-operand: string | number | null | Array<string, number, null> // possible slug or slugs you’re testing
-key?: string, // name of sibling if not "slug"
-message?: string // optional custom error message; replaces {slugKey} and {operand} with your input, and {siblingSlugValue} with the value of the sibling you’re testing against.
+defineField({
+  name: 'email',
+  type: 'string',
+  validation: (rule) => rule.custom(
+    regex(
+      /^([a-zA-Z0-9._%-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,6})*$/,
+      "“{value}” is not a valid email address."
+    )
+  ),
+}),
 ```
 
----
+**Custom error messages are highly recommended here.** Without the custom message above, the default response would be:
+
+```
+“me@googlecom” does not match the pattern /^([a-zA-Z0-9._%-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,6})*$/.
+```
 
+---
 
 ### referencedDocumentRequires
 
 You might want to enforce some validation on a referenced document. This validator enforces that a given value is not null in the referenced document.
 
+```typescript
+documentType: string // type of document you’re referring to
+field: string, // name of document field that is required
+message?: string // optional custom error message; replaces {documentType} and {field} with your input
+```
+
 ```typescript
 defineField({
   name: 'referredArticle',
@@ -427,16 +427,8 @@ defineField({
 }),
 ```
 
-#### parameters
-```typescript
-documentType: string // type of document you’re referring to
-field: string, // name of document field that is required
-message?: string // optional custom error message; replaces {documentType} and {field} with your input
-```
-
 ---
 
-
 ### maxDepth
 
 It can be useful to have a nested type. This often comes up when making some kind of navigation tree, like…
@@ -490,6 +482,12 @@ const navLink = defineType({
 
 … but your users might get a little stupid with this, and you may want to enforce navigations only going _n_ layers deep.
 
+```typescript
+maxDepth: number // maximum "depth" of embedding (including parent)
+key: string, // name of the field that includes the cursive value (i.e. the field’s own name)
+message?: string // optional custom error message; replaces {maxDepth} and {key} with your input
+```
+
 ```typescript
 import { maxDepth } from "sanity-advanced-validation"
 
@@ -509,17 +507,8 @@ const navLink = defineType({
 
 This will enforce that a subnav list can embed in a subnav, which can also be embedded in a subnav — but no further.
 
-
-#### parameters
-```typescript
-maxDepth: number // maximum "depth" of embedding (including parent)
-key: string, // name of the field that includes the cursive value (i.e. the field’s own name)
-message?: string // optional custom error message; replaces {maxDepth} and {key} with your input
-```
-
 ---
 
-
 #### Note to any Sanity dev who looks at this
 
 I’d love to include similar logic on my `hidden:` attribute, but I don’t think that’t possible without a `path` array in `hidden`’s `ConditionalPropertyCallbackContext` that’s similar to the one fed to the `ValidationContext` (todo: type this correctly). Wouldn’t this be cool?
@@ -543,7 +532,7 @@ defineField({
 
 Most of these validators rely on a function called `getSibling()`. If you’re thinking about picking this apart and writing your own custom validator, take a close look at how these validators use it.
 
-## Upcoming
+## Roadmap
 
 ### Nested pathfinders
 

package/dist/index.cjs

@@ -25,6 +25,7 @@ __export(index_exports, {
   maxDepth: () => maxDepth,
   minDimensions: () => minDimensions,
   referencedDocumentRequires: () => referencedDocumentRequires,
+  regex: () => regex,
   requiredIfSiblingEq: () => requiredIfSiblingEq,
   requiredIfSlugEq: () => requiredIfSlugEq
 });
@@ -69,20 +70,20 @@ var minDimensions = ({ x, y }, message) => (value) => {
   }
   const { width, height } = (0, import_asset_utils2.getImageDimensions)(value.asset._ref);
   if (!!x && width < x) {
-    return message ? message.replace("{x}", x.toString()).replace("{y}", !y ? "(any)" : y.toString()) : `Image must be at least ${x} pixels wide.`;
+    return message ? message.replace("{width}", width.toString()).replace("{height}", height.toString()).replace("{x}", x.toString()).replace("{y}", !y ? "(any)" : y.toString()) : `Image must be at least ${x} pixels wide.`;
   }
   if (!!y && height < y) {
-    return message ? message.replace("{x}", !x ? "(any)" : x.toString()).replace("{y}", y.toString()) : `Image must be at least ${y} pixels tall.`;
+    return message ? message.replace("{width}", width.toString()).replace("{height}", height.toString()).replace("{x}", !x ? "(any)" : x.toString()).replace("{y}", y.toString()) : `Image must be at least ${y} pixels tall.`;
   }
   return true;
 };
 
 // src/maxDepth.ts
-var maxDepth = (maxDepth2, nestedValueName, message = `Error: You can only nest {nestedValueName} {maxDepth} levels deep.`) => (_, context) => {
-  let regex = new RegExp(String.raw`topLevelItems|${nestedValueName}`);
-  const paths = context.path.filter((e) => typeof e === "string" && e.match(regex));
+var maxDepth = (maxDepth2, key, message = `Error: You can only nest {key} {maxDepth} levels deep.`) => (_, context) => {
+  let regex2 = new RegExp(String.raw`topLevelItems|${key}`);
+  const paths = context.path.filter((e) => typeof e === "string" && e.match(regex2));
   if (paths.length > maxDepth2) {
-    return message.replace("{nestedValueName}", nestedValueName).replace("{maxDepth}", maxDepth2.toString());
+    return message.replace("{key}", key).replace("{nestedValueName}", key).replace("{maxDepth}", maxDepth2.toString());
   }
   return true;
 };
@@ -91,20 +92,20 @@ var maxDepth = (maxDepth2, nestedValueName, message = `Error: You can only nest
 var requiredIfSlugEq = (slug, slugKey = "slug", message = `This is a required field.`) => (value, context) => {
   var _a, _b;
   const slugs = typeof slug === "string" ? [slug] : slug;
-  const currentSlugValue = (_b = (_a = context.parent) == null ? void 0 : _a[slugKey]) == null ? void 0 : _b.current;
-  if (!value && !!currentSlugValue && slugs.includes(currentSlugValue)) {
-    return message.replace("{slugKey}", slugKey).replace("{slug}", slugs.join(", or "));
+  const slugValue = (_b = (_a = context.parent) == null ? void 0 : _a[slugKey]) == null ? void 0 : _b.current;
+  if (!value && !!slugValue && slugs.includes(slugValue)) {
+    return message.replace("{slugKey}", slugKey).replace("{operand}", slugs.join(", or ")).replace("{siblingSlugValue}", slugValue);
   }
   return true;
 };
 
 // src/requiredIfSiblingEq.ts
-var requiredIfSiblingEq = (key, comparison, message = "Required if {key} equals {value}.") => (value, context) => {
-  var _a;
-  const sibling = getSibling(key, context);
-  const comparisons = Array.isArray(comparison) ? comparison : [comparison];
-  if (!value && comparisons.includes(sibling)) {
-    return message.replace("{key}", key).replace("{value}", (_a = comparisons.join(", or ")) != null ? _a : "null");
+var requiredIfSiblingEq = (key, operand, message = "Required if {key} equals {operand}.") => (value, context) => {
+  var _a, _b;
+  const siblingValue = getSibling(key, context);
+  const operands = Array.isArray(operand) ? operand : [operand];
+  if (!value && operands.includes(siblingValue)) {
+    return message.replace("{key}", key).replace("{operand}", (_a = operands.join(", or ")) != null ? _a : "null").replace("{value}", (_b = operands.join(", or ")) != null ? _b : "null").replace("{siblingValue}", siblingValue);
   }
   return true;
 };
@@ -116,6 +117,15 @@ var getSibling = (key, context) => {
   const sibling = (0, import_lodash_es.get)(context.document, [...pathToParentObject, key]);
   return sibling;
 };
+
+// src/regex.ts
+var regex = (pattern, message = `\u201C{value}\u201D does not match the pattern {pattern}.`) => (value) => {
+  if (!value) {
+    return true;
+  }
+  const valueAsString = typeof value !== "string" ? value.toString() : value;
+  return pattern.test(valueAsString) ? true : message.replace("{value}", valueAsString).replace("{pattern}", pattern.toString());
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   fileExtension,
@@ -123,6 +133,7 @@ var getSibling = (key, context) => {
   maxDepth,
   minDimensions,
   referencedDocumentRequires,
+  regex,
   requiredIfSiblingEq,
   requiredIfSlugEq
 });

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/referencedDocumentRequires.ts","../src/fileExtension.ts","../src/minDimensions.ts","../src/maxDepth.ts","../src/requiredIfSlugEq.ts","../src/requiredIfSiblingEq.ts","../src/lib/getSibling.ts"],"sourcesContent":["export * from \"./referencedDocumentRequires\"\nexport * from \"./fileExtension\"\nexport * from \"./minDimensions\"\nexport * from \"./maxDepth\"\nexport * from \"./requiredIfSlugEq\"\nexport * from \"./requiredIfSiblingEq\"\nexport * from \"./lib\"\n","import { ValidationContext } from \"sanity\"\n\nexport const referencedDocumentRequires = (\n  documentType: string, \n  field: string, \n  message: string = `{documentType}’s {field} must be filled.`\n) => async (value: any | undefined, context: ValidationContext) => {\n  if (!value?._ref) {\n    return true\n  }\n  const client = context.getClient({ apiVersion: \"2022-08-12\" })\n  // todo: use current API version, or test with no version at all\n\n  // todo: if there's a value._type or value.referenced._type or something, we get rid of document.type from inputs\n  const data = await client.fetch(`\n    *[_type == \"${documentType}\" && _id == \"${value._ref}\"]{\n      ${field}\n    }[0]\n  `) // TODO: why is typescript screaming about this? Fetch takes two parameters.\n  if (!data[field]) {\n    return message.replace(\"{documentType}\", documentType).replace(\"{field}\", field)\n  }\n  return true\n}\n","import { getExtension } from \"@sanity/asset-utils\"\nimport { FileValue } from \"sanity\"\n\nexport const fileExtension = (\n  validFileExtension: string | Array<string>, \n  message: string = `Image must be of type {validFileExtension}`\n) => (value: FileValue | undefined) => {\n  if (!value || !value.asset) {\n    return true\n  }\n  const validExtensions = typeof validFileExtension === \"string\" ? [validFileExtension] : validFileExtension\n  const filetype = getExtension(value.asset._ref)\n  if (!validExtensions.includes(filetype)) {\n    return message.replace(\"{validFileExtension}\", validExtensions.join(\", or \"))\n  }\n  return true\n}\n","import { getImageDimensions } from \"@sanity/asset-utils\"\nimport { FileValue } from \"sanity\"\n\nexport const minDimensions =\n  ({ x, y }: { x: number; y: number }, message?: string) =>\n  (value: FileValue | undefined) => {\n    if (!value || !value.asset) {\n      return true\n    }\n    const { width, height } = getImageDimensions(value.asset._ref)\n    if (!!x && width < x) {\n      return message ? message.replace(\"{x}\", x.toString()).replace(\"{y}\", !y ? \"(any)\" : y.toString()) : `Image must be at least ${x} pixels wide.`\n    }\n    if (!!y && height < y) {\n      return message ? message.replace(\"{x}\", !x ? \"(any)\" : x.toString()).replace(\"{y}\", y.toString()) : `Image must be at least ${y} pixels tall.`\n    }\n    return true\n  }\n","import { ValidationContext } from \"sanity\"\n\nexport const maxDepth = (\n  maxDepth: number, \n  nestedValueName: string,\n  message: string = `Error: You can only nest {nestedValueName} {maxDepth} levels deep.`\n) => (_: any, context: ValidationContext) => {\n  let regex = new RegExp(String.raw`topLevelItems|${nestedValueName}`)\n  const paths = (context.path as Array<any>).filter((e) => typeof e === \"string\" && e.match(regex))\n  if (paths.length > maxDepth) {\n    return message.replace(\"{nestedValueName}\", nestedValueName).replace(\"{maxDepth}\", maxDepth.toString())\n  }\n  return true\n}\n","import { ValidationContext } from \"sanity\"\n\n/*\nSanity has a funny idea of conditional fields. Every field is _always_ present, but it might be hidden.\nex. hidden: (node) => node.parent.slug === 'hideMe'\nThis works really well — unless a field marked as required gets hidden. \n\nThis validator conditionally marks a field as required only for specific slugs. It accepts a string or array of strings.\n```\nvalidation: (rule) => rule.custom(requiredIfSlugEq('alpha'))\nvalidation: (rule) => rule.custom(requiredIfSlugEq(['alpha', 'beta']))\nvalidation: (rule) => rule.custom(requiredIfSlugNotEq(['beta']))\n```\n\nIf the key of your slug is not simply \"slug\", fill that in the optional second parameter.\n```\nvalidation: (rule) => rule.custom(requiredIfSlugEq('alpha', 'id'))\n```\n\n\"Could this method be simpler if it just checked for the self.hidden state?\"\nNot possible, since the hidden state is not exposed to the context.\n\nBut even if it were, you wouldn't want to. There are valid reasons to make a component required but hidden.\nex. an admin- or developer-level identifier that you don't want civilians to see or edit.\n*/\n\nexport const requiredIfSlugEq = (\n  slug: Array<string> | string, \n  slugKey: string = \"slug\", \n  message: string = `This is a required field.`\n) =>\n  (value: unknown | undefined, context: ValidationContext) => {\n    const slugs = typeof slug === \"string\" ? [slug] : slug\n    const currentSlugValue = (context.parent as any)?.[slugKey]?.current\n    \n    // todo: does slugKey exist? If not, fail.\n    // todo: deal with nested slugKey (ex. metadata.slug)\n    \n    if (!value && !!currentSlugValue && slugs.includes(currentSlugValue)) {\n      return message.replace(\"{slugKey}\", slugKey).replace(\"{slug}\", slugs.join(', or '))\n    }\n    return true\n  }","import {getSibling} from './'\nimport {ValidationContext} from 'sanity'\n\n/*\nFor a given object that has multiple fields, mark a field as `required` if a sibling has a particular value.\n\n```\ndefineType({\n  name: 'ifAlphaAlsoBeta',\n  type: 'object',\n  fields: [\n    defineField({\n      name: 'alpha',\n      type: 'string',\n      options: {\n        list: ['left', 'right'],\n        layout: 'radio',\n        direction: 'horizontal',\n      },\n    }),\n    defineField({\n      name: 'beta',\n      type: 'string',\n      placeholder: 'If alpha is “left”, I’m also required',\n      validation: (rule) => rule.custom(requiredIfSiblingEq('alpha', 'left')),\n    })\n  ],\n})\n```\n\nIncidentally, context.path is technically Array<sanity.PathSegment>.\n\nThat shouldn't matter, but dealing with that and remapping siblingKey as a PathSegment could be a possible future enhancement.\n*/\n\nexport const requiredIfSiblingEq = (\n  key: string, \n  comparison: string | number | null | Array<string | number | null>, \n  message: string = 'Required if {key} equals {value}.'\n) =>\n  (value: unknown | undefined, context: ValidationContext) => {\n    const sibling = getSibling(key, context)\n    const comparisons = Array.isArray(comparison) ? comparison : [comparison]\n    if (!value && comparisons.includes(sibling)) {\n      return message.replace('{key}', key).replace('{value}', comparisons.join(', or ') ?? 'null')\n    }\n    return true\n  }\n","import { get } from \"lodash-es\"\nimport { ValidationContext } from \"sanity\"\n\nexport const getSibling = (key: string | number, context: ValidationContext) => {\n  const pathToParentObject = context.path!.slice(0, -1) as Array<string | number>\n  const sibling = get(context.document, [...pathToParentObject, key])\n  return sibling\n}\n\n/*\nTODO:\n  There is an issue with finding a sibling when in an array element.\n  If the context document looks something like this…\n    {\n      someArray: [\n        {\n          _key: 'abc123',\n          targetSibling: 'herpderp'\n        }\n      ]\n    }\n  … we wind up with a path of…\n    [ 'someArray', { _key: 'ab123' }, 'targetSibling' ]\n  lodash.get() is trying to do an exact match, it doesn't know how to get object by _key.\n  \n  Will probably have to replace get() with a gnarly recursive lookup function.\n*/\n"],"mappings":"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","names":["import_asset_utils","maxDepth"]}
+{"version":3,"sources":["../src/index.ts","../src/referencedDocumentRequires.ts","../src/fileExtension.ts","../src/minDimensions.ts","../src/maxDepth.ts","../src/requiredIfSlugEq.ts","../src/requiredIfSiblingEq.ts","../src/lib/getSibling.ts","../src/regex.ts"],"sourcesContent":["export * from \"./referencedDocumentRequires\"\nexport * from \"./fileExtension\"\nexport * from \"./minDimensions\"\nexport * from \"./maxDepth\"\nexport * from \"./requiredIfSlugEq\"\nexport * from \"./requiredIfSiblingEq\"\nexport * from \"./lib\"\nexport * from \"./regex\"\n","import { ValidationContext } from \"sanity\"\n\nexport const referencedDocumentRequires = (\n  documentType: string, \n  field: string, \n  message: string = `{documentType}’s {field} must be filled.`\n) => async (value: any | undefined, context: ValidationContext) => {\n  if (!value?._ref) {\n    return true\n  }\n  const client = context.getClient({ apiVersion: \"2022-08-12\" })\n  // todo: use current API version, or test with no version at all\n\n  // todo: if there's a value._type or value.referenced._type or something, we get rid of document.type from inputs\n  const data = await client.fetch(`\n    *[_type == \"${documentType}\" && _id == \"${value._ref}\"]{\n      ${field}\n    }[0]\n  `) // TODO: why is typescript screaming about this? Fetch takes two parameters.\n  if (!data[field]) {\n    return message.replace(\"{documentType}\", documentType).replace(\"{field}\", field)\n  }\n  return true\n}\n","import { getExtension } from \"@sanity/asset-utils\"\nimport { FileValue } from \"sanity\"\n\nexport const fileExtension = (\n  validFileExtension: string | Array<string>, \n  message: string = `Image must be of type {validFileExtension}`\n) => (value: FileValue | undefined) => {\n  if (!value || !value.asset) {\n    return true\n  }\n  const validExtensions = typeof validFileExtension === \"string\" ? [validFileExtension] : validFileExtension\n  const filetype = getExtension(value.asset._ref)\n  if (!validExtensions.includes(filetype)) {\n    return message.replace(\"{validFileExtension}\", validExtensions.join(\", or \"))\n  }\n  return true\n}\n\n// todo: this should fail if its attached to a field that is not of type \"file\"","import { getImageDimensions } from \"@sanity/asset-utils\"\nimport { FileValue } from \"sanity\"\n\nexport const minDimensions =\n  ({ x, y }: { x: number; y: number }, message?: string) =>\n  (value: FileValue | undefined) => {\n    if (!value || !value.asset) {\n      return true\n    }\n    const { width, height } = getImageDimensions(value.asset._ref)\n    if (!!x && width < x) {\n      return message \n        ? message.replace(\"{width}\", width.toString())\n          .replace(\"{height}\", height.toString())\n          .replace(\"{x}\", x.toString())\n          .replace(\"{y}\", !y ? \"(any)\" : y.toString()) \n        : `Image must be at least ${x} pixels wide.`\n    }\n    if (!!y && height < y) {\n      return message \n        ? message.replace(\"{width}\", width.toString())\n          .replace(\"{height}\", height.toString())\n          .replace(\"{x}\", !x ? \"(any)\" : x.toString())\n          .replace(\"{y}\", y.toString())\n        : `Image must be at least ${y} pixels tall.`\n    }\n    return true\n  }\n\n// todo: this should fail if its attached to a field that is not of type \"image\"","import { ValidationContext } from \"sanity\"\n\nexport const maxDepth = (\n  maxDepth: number, \n  key: string,\n  message: string = `Error: You can only nest {key} {maxDepth} levels deep.`\n) => (_: any, context: ValidationContext) => {\n  let regex = new RegExp(String.raw`topLevelItems|${key}`)\n  const paths = (context.path as Array<any>).filter((e) => typeof e === \"string\" && e.match(regex))\n  if (paths.length > maxDepth) {\n    return message\n      .replace(\"{key}\", key)\n      .replace(\"{nestedValueName}\", key)  // backward compatibility\n      .replace(\"{maxDepth}\", maxDepth.toString())\n  }\n  return true\n}\n","import { ValidationContext } from \"sanity\"\n\n/*\nSanity has a funny idea of conditional fields. Every field is _always_ present, but it might be hidden.\nex. hidden: (node) => node.parent.slug === 'hideMe'\nThis works really well — unless a field marked as required gets hidden. \n\nThis validator conditionally marks a field as required only for specific slugs. It accepts a string or array of strings.\n```\nvalidation: (rule) => rule.custom(requiredIfSlugEq('alpha'))\nvalidation: (rule) => rule.custom(requiredIfSlugEq(['alpha', 'beta']))\nvalidation: (rule) => rule.custom(requiredIfSlugNotEq(['beta']))\n```\n\nIf the key of your slug is not simply \"slug\", fill that in the optional second parameter.\n```\nvalidation: (rule) => rule.custom(requiredIfSlugEq('alpha', 'id'))\n```\n\n\"Could this method be simpler if it just checked for the self.hidden state?\"\nNot possible, since the hidden state is not exposed to the context.\n\nBut even if it were, you wouldn't want to. There are valid reasons to make a component required but hidden.\nex. an admin- or developer-level identifier that you don't want civilians to see or edit.\n*/\n\nexport const requiredIfSlugEq = (\n  slug: Array<string> | string, \n  slugKey: string = \"slug\", \n  message: string = `This is a required field.`\n) =>\n  (value: unknown | undefined, context: ValidationContext) => {\n    const slugs = typeof slug === \"string\" ? [slug] : slug\n    const slugValue = (context.parent as any)?.[slugKey]?.current\n    \n    // todo: does slugKey exist? If not, fail.\n    // todo: deal with nested slugKey (ex. metadata.slug)\n    \n    if (!value && !!slugValue && slugs.includes(slugValue)) {\n      return message\n        .replace(\"{slugKey}\", slugKey)\n        .replace(\"{operand}\", slugs.join(', or '))\n        .replace(\"{siblingSlugValue}\", slugValue)\n    }\n    return true\n  }","import {getSibling} from './'\nimport {ValidationContext} from 'sanity'\n\n/*\nFor a given object that has multiple fields, mark a field as `required` if a sibling has a particular value.\n\n```\ndefineType({\n  name: 'ifAlphaAlsoBeta',\n  type: 'object',\n  fields: [\n    defineField({\n      name: 'alpha',\n      type: 'string',\n      options: {\n        list: ['left', 'right'],\n        layout: 'radio',\n        direction: 'horizontal',\n      },\n    }),\n    defineField({\n      name: 'beta',\n      type: 'string',\n      placeholder: 'If alpha is “left”, I’m also required',\n      validation: (rule) => rule.custom(requiredIfSiblingEq('alpha', 'left')),\n    })\n  ],\n})\n```\n\nIncidentally, context.path is technically Array<sanity.PathSegment>.\n\nThat shouldn't matter, but dealing with that and remapping siblingKey as a PathSegment could be a possible future enhancement.\n*/\n\nexport const requiredIfSiblingEq = (\n  key: string, \n  operand: string | number | null | Array<string | number | null>, \n  message: string = 'Required if {key} equals {operand}.'\n) =>\n  (value: unknown | undefined, context: ValidationContext) => {\n    const siblingValue = getSibling(key, context)\n    const operands = Array.isArray(operand) ? operand : [operand]\n    if (!value && operands.includes(siblingValue)) {\n      return message\n        .replace('{key}', key)\n        .replace('{operand}', operands.join(', or ') ?? 'null')\n        .replace('{value}', operands.join(', or ') ?? 'null') // backward compatibility\n        .replace('{siblingValue}', siblingValue)\n    }\n    return true\n  }\n","import { get } from \"lodash-es\"\nimport { ValidationContext } from \"sanity\"\n\nexport const getSibling = (key: string | number, context: ValidationContext) => {\n  const pathToParentObject = context.path!.slice(0, -1) as Array<string | number>\n  const sibling = get(context.document, [...pathToParentObject, key])\n  return sibling\n}\n\n/*\nTODO:\n  There is an issue with finding a sibling when in an array element.\n  If the context document looks something like this…\n    {\n      someArray: [\n        {\n          _key: 'abc123',\n          targetSibling: 'herpderp'\n        }\n      ]\n    }\n  … we wind up with a path of…\n    [ 'someArray', { _key: 'ab123' }, 'targetSibling' ]\n  lodash.get() is trying to do an exact match, it doesn't know how to get object by _key.\n  \n  Will probably have to replace get() with a gnarly recursive lookup function.\n*/\n","export const regex =\n  (pattern: RegExp, message: string = `“{value}” does not match the pattern {pattern}.`) =>\n  (value: unknown) => {\n    if (!value) {\n      return true\n    }\n    const valueAsString = typeof value !== \"string\" ? value.toString() : value\n    return pattern.test(valueAsString) ? true : message.replace(\"{value}\", valueAsString).replace(\"{pattern}\", pattern.toString())\n  }\n"],"mappings":"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","names":["import_asset_utils","maxDepth","regex"]}

package/dist/index.d.cts

@@ -9,12 +9,14 @@ declare const minDimensions: ({ x, y }: {
     y: number;
 }, message?: string) => (value: FileValue | undefined) => string | true;
 
-declare const maxDepth: (maxDepth: number, nestedValueName: string, message?: string) => (_: any, context: ValidationContext) => string | true;
+declare const maxDepth: (maxDepth: number, key: string, message?: string) => (_: any, context: ValidationContext) => string | true;
 
 declare const requiredIfSlugEq: (slug: Array<string> | string, slugKey?: string, message?: string) => (value: unknown | undefined, context: ValidationContext) => string | true;
 
-declare const requiredIfSiblingEq: (key: string, comparison: string | number | null | Array<string | number | null>, message?: string) => (value: unknown | undefined, context: ValidationContext) => string | true;
+declare const requiredIfSiblingEq: (key: string, operand: string | number | null | Array<string | number | null>, message?: string) => (value: unknown | undefined, context: ValidationContext) => string | true;
 
 declare const getSibling: (key: string | number, context: ValidationContext) => any;
 
-export { fileExtension, getSibling, maxDepth, minDimensions, referencedDocumentRequires, requiredIfSiblingEq, requiredIfSlugEq };
+declare const regex: (pattern: RegExp, message?: string) => (value: unknown) => string | true;
+
+export { fileExtension, getSibling, maxDepth, minDimensions, referencedDocumentRequires, regex, requiredIfSiblingEq, requiredIfSlugEq };

package/dist/index.d.ts

@@ -9,12 +9,14 @@ declare const minDimensions: ({ x, y }: {
     y: number;
 }, message?: string) => (value: FileValue | undefined) => string | true;
 
-declare const maxDepth: (maxDepth: number, nestedValueName: string, message?: string) => (_: any, context: ValidationContext) => string | true;
+declare const maxDepth: (maxDepth: number, key: string, message?: string) => (_: any, context: ValidationContext) => string | true;
 
 declare const requiredIfSlugEq: (slug: Array<string> | string, slugKey?: string, message?: string) => (value: unknown | undefined, context: ValidationContext) => string | true;
 
-declare const requiredIfSiblingEq: (key: string, comparison: string | number | null | Array<string | number | null>, message?: string) => (value: unknown | undefined, context: ValidationContext) => string | true;
+declare const requiredIfSiblingEq: (key: string, operand: string | number | null | Array<string | number | null>, message?: string) => (value: unknown | undefined, context: ValidationContext) => string | true;
 
 declare const getSibling: (key: string | number, context: ValidationContext) => any;
 
-export { fileExtension, getSibling, maxDepth, minDimensions, referencedDocumentRequires, requiredIfSiblingEq, requiredIfSlugEq };
+declare const regex: (pattern: RegExp, message?: string) => (value: unknown) => string | true;
+
+export { fileExtension, getSibling, maxDepth, minDimensions, referencedDocumentRequires, regex, requiredIfSiblingEq, requiredIfSlugEq };

package/dist/index.js

@@ -37,20 +37,20 @@ var minDimensions = ({ x, y }, message) => (value) => {
   }
   const { width, height } = getImageDimensions(value.asset._ref);
   if (!!x && width < x) {
-    return message ? message.replace("{x}", x.toString()).replace("{y}", !y ? "(any)" : y.toString()) : `Image must be at least ${x} pixels wide.`;
+    return message ? message.replace("{width}", width.toString()).replace("{height}", height.toString()).replace("{x}", x.toString()).replace("{y}", !y ? "(any)" : y.toString()) : `Image must be at least ${x} pixels wide.`;
   }
   if (!!y && height < y) {
-    return message ? message.replace("{x}", !x ? "(any)" : x.toString()).replace("{y}", y.toString()) : `Image must be at least ${y} pixels tall.`;
+    return message ? message.replace("{width}", width.toString()).replace("{height}", height.toString()).replace("{x}", !x ? "(any)" : x.toString()).replace("{y}", y.toString()) : `Image must be at least ${y} pixels tall.`;
   }
   return true;
 };
 
 // src/maxDepth.ts
-var maxDepth = (maxDepth2, nestedValueName, message = `Error: You can only nest {nestedValueName} {maxDepth} levels deep.`) => (_, context) => {
-  let regex = new RegExp(String.raw`topLevelItems|${nestedValueName}`);
-  const paths = context.path.filter((e) => typeof e === "string" && e.match(regex));
+var maxDepth = (maxDepth2, key, message = `Error: You can only nest {key} {maxDepth} levels deep.`) => (_, context) => {
+  let regex2 = new RegExp(String.raw`topLevelItems|${key}`);
+  const paths = context.path.filter((e) => typeof e === "string" && e.match(regex2));
   if (paths.length > maxDepth2) {
-    return message.replace("{nestedValueName}", nestedValueName).replace("{maxDepth}", maxDepth2.toString());
+    return message.replace("{key}", key).replace("{nestedValueName}", key).replace("{maxDepth}", maxDepth2.toString());
   }
   return true;
 };
@@ -59,20 +59,20 @@ var maxDepth = (maxDepth2, nestedValueName, message = `Error: You can only nest
 var requiredIfSlugEq = (slug, slugKey = "slug", message = `This is a required field.`) => (value, context) => {
   var _a, _b;
   const slugs = typeof slug === "string" ? [slug] : slug;
-  const currentSlugValue = (_b = (_a = context.parent) == null ? void 0 : _a[slugKey]) == null ? void 0 : _b.current;
-  if (!value && !!currentSlugValue && slugs.includes(currentSlugValue)) {
-    return message.replace("{slugKey}", slugKey).replace("{slug}", slugs.join(", or "));
+  const slugValue = (_b = (_a = context.parent) == null ? void 0 : _a[slugKey]) == null ? void 0 : _b.current;
+  if (!value && !!slugValue && slugs.includes(slugValue)) {
+    return message.replace("{slugKey}", slugKey).replace("{operand}", slugs.join(", or ")).replace("{siblingSlugValue}", slugValue);
   }
   return true;
 };
 
 // src/requiredIfSiblingEq.ts
-var requiredIfSiblingEq = (key, comparison, message = "Required if {key} equals {value}.") => (value, context) => {
-  var _a;
-  const sibling = getSibling(key, context);
-  const comparisons = Array.isArray(comparison) ? comparison : [comparison];
-  if (!value && comparisons.includes(sibling)) {
-    return message.replace("{key}", key).replace("{value}", (_a = comparisons.join(", or ")) != null ? _a : "null");
+var requiredIfSiblingEq = (key, operand, message = "Required if {key} equals {operand}.") => (value, context) => {
+  var _a, _b;
+  const siblingValue = getSibling(key, context);
+  const operands = Array.isArray(operand) ? operand : [operand];
+  if (!value && operands.includes(siblingValue)) {
+    return message.replace("{key}", key).replace("{operand}", (_a = operands.join(", or ")) != null ? _a : "null").replace("{value}", (_b = operands.join(", or ")) != null ? _b : "null").replace("{siblingValue}", siblingValue);
   }
   return true;
 };
@@ -84,12 +84,22 @@ var getSibling = (key, context) => {
   const sibling = get(context.document, [...pathToParentObject, key]);
   return sibling;
 };
+
+// src/regex.ts
+var regex = (pattern, message = `\u201C{value}\u201D does not match the pattern {pattern}.`) => (value) => {
+  if (!value) {
+    return true;
+  }
+  const valueAsString = typeof value !== "string" ? value.toString() : value;
+  return pattern.test(valueAsString) ? true : message.replace("{value}", valueAsString).replace("{pattern}", pattern.toString());
+};
 export {
   fileExtension,
   getSibling,
   maxDepth,
   minDimensions,
   referencedDocumentRequires,
+  regex,
   requiredIfSiblingEq,
   requiredIfSlugEq
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/referencedDocumentRequires.ts","../src/fileExtension.ts","../src/minDimensions.ts","../src/maxDepth.ts","../src/requiredIfSlugEq.ts","../src/requiredIfSiblingEq.ts","../src/lib/getSibling.ts"],"sourcesContent":["import { ValidationContext } from \"sanity\"\n\nexport const referencedDocumentRequires = (\n  documentType: string, \n  field: string, \n  message: string = `{documentType}’s {field} must be filled.`\n) => async (value: any | undefined, context: ValidationContext) => {\n  if (!value?._ref) {\n    return true\n  }\n  const client = context.getClient({ apiVersion: \"2022-08-12\" })\n  // todo: use current API version, or test with no version at all\n\n  // todo: if there's a value._type or value.referenced._type or something, we get rid of document.type from inputs\n  const data = await client.fetch(`\n    *[_type == \"${documentType}\" && _id == \"${value._ref}\"]{\n      ${field}\n    }[0]\n  `) // TODO: why is typescript screaming about this? Fetch takes two parameters.\n  if (!data[field]) {\n    return message.replace(\"{documentType}\", documentType).replace(\"{field}\", field)\n  }\n  return true\n}\n","import { getExtension } from \"@sanity/asset-utils\"\nimport { FileValue } from \"sanity\"\n\nexport const fileExtension = (\n  validFileExtension: string | Array<string>, \n  message: string = `Image must be of type {validFileExtension}`\n) => (value: FileValue | undefined) => {\n  if (!value || !value.asset) {\n    return true\n  }\n  const validExtensions = typeof validFileExtension === \"string\" ? [validFileExtension] : validFileExtension\n  const filetype = getExtension(value.asset._ref)\n  if (!validExtensions.includes(filetype)) {\n    return message.replace(\"{validFileExtension}\", validExtensions.join(\", or \"))\n  }\n  return true\n}\n","import { getImageDimensions } from \"@sanity/asset-utils\"\nimport { FileValue } from \"sanity\"\n\nexport const minDimensions =\n  ({ x, y }: { x: number; y: number }, message?: string) =>\n  (value: FileValue | undefined) => {\n    if (!value || !value.asset) {\n      return true\n    }\n    const { width, height } = getImageDimensions(value.asset._ref)\n    if (!!x && width < x) {\n      return message ? message.replace(\"{x}\", x.toString()).replace(\"{y}\", !y ? \"(any)\" : y.toString()) : `Image must be at least ${x} pixels wide.`\n    }\n    if (!!y && height < y) {\n      return message ? message.replace(\"{x}\", !x ? \"(any)\" : x.toString()).replace(\"{y}\", y.toString()) : `Image must be at least ${y} pixels tall.`\n    }\n    return true\n  }\n","import { ValidationContext } from \"sanity\"\n\nexport const maxDepth = (\n  maxDepth: number, \n  nestedValueName: string,\n  message: string = `Error: You can only nest {nestedValueName} {maxDepth} levels deep.`\n) => (_: any, context: ValidationContext) => {\n  let regex = new RegExp(String.raw`topLevelItems|${nestedValueName}`)\n  const paths = (context.path as Array<any>).filter((e) => typeof e === \"string\" && e.match(regex))\n  if (paths.length > maxDepth) {\n    return message.replace(\"{nestedValueName}\", nestedValueName).replace(\"{maxDepth}\", maxDepth.toString())\n  }\n  return true\n}\n","import { ValidationContext } from \"sanity\"\n\n/*\nSanity has a funny idea of conditional fields. Every field is _always_ present, but it might be hidden.\nex. hidden: (node) => node.parent.slug === 'hideMe'\nThis works really well — unless a field marked as required gets hidden. \n\nThis validator conditionally marks a field as required only for specific slugs. It accepts a string or array of strings.\n```\nvalidation: (rule) => rule.custom(requiredIfSlugEq('alpha'))\nvalidation: (rule) => rule.custom(requiredIfSlugEq(['alpha', 'beta']))\nvalidation: (rule) => rule.custom(requiredIfSlugNotEq(['beta']))\n```\n\nIf the key of your slug is not simply \"slug\", fill that in the optional second parameter.\n```\nvalidation: (rule) => rule.custom(requiredIfSlugEq('alpha', 'id'))\n```\n\n\"Could this method be simpler if it just checked for the self.hidden state?\"\nNot possible, since the hidden state is not exposed to the context.\n\nBut even if it were, you wouldn't want to. There are valid reasons to make a component required but hidden.\nex. an admin- or developer-level identifier that you don't want civilians to see or edit.\n*/\n\nexport const requiredIfSlugEq = (\n  slug: Array<string> | string, \n  slugKey: string = \"slug\", \n  message: string = `This is a required field.`\n) =>\n  (value: unknown | undefined, context: ValidationContext) => {\n    const slugs = typeof slug === \"string\" ? [slug] : slug\n    const currentSlugValue = (context.parent as any)?.[slugKey]?.current\n    \n    // todo: does slugKey exist? If not, fail.\n    // todo: deal with nested slugKey (ex. metadata.slug)\n    \n    if (!value && !!currentSlugValue && slugs.includes(currentSlugValue)) {\n      return message.replace(\"{slugKey}\", slugKey).replace(\"{slug}\", slugs.join(', or '))\n    }\n    return true\n  }","import {getSibling} from './'\nimport {ValidationContext} from 'sanity'\n\n/*\nFor a given object that has multiple fields, mark a field as `required` if a sibling has a particular value.\n\n```\ndefineType({\n  name: 'ifAlphaAlsoBeta',\n  type: 'object',\n  fields: [\n    defineField({\n      name: 'alpha',\n      type: 'string',\n      options: {\n        list: ['left', 'right'],\n        layout: 'radio',\n        direction: 'horizontal',\n      },\n    }),\n    defineField({\n      name: 'beta',\n      type: 'string',\n      placeholder: 'If alpha is “left”, I’m also required',\n      validation: (rule) => rule.custom(requiredIfSiblingEq('alpha', 'left')),\n    })\n  ],\n})\n```\n\nIncidentally, context.path is technically Array<sanity.PathSegment>.\n\nThat shouldn't matter, but dealing with that and remapping siblingKey as a PathSegment could be a possible future enhancement.\n*/\n\nexport const requiredIfSiblingEq = (\n  key: string, \n  comparison: string | number | null | Array<string | number | null>, \n  message: string = 'Required if {key} equals {value}.'\n) =>\n  (value: unknown | undefined, context: ValidationContext) => {\n    const sibling = getSibling(key, context)\n    const comparisons = Array.isArray(comparison) ? comparison : [comparison]\n    if (!value && comparisons.includes(sibling)) {\n      return message.replace('{key}', key).replace('{value}', comparisons.join(', or ') ?? 'null')\n    }\n    return true\n  }\n","import { get } from \"lodash-es\"\nimport { ValidationContext } from \"sanity\"\n\nexport const getSibling = (key: string | number, context: ValidationContext) => {\n  const pathToParentObject = context.path!.slice(0, -1) as Array<string | number>\n  const sibling = get(context.document, [...pathToParentObject, key])\n  return sibling\n}\n\n/*\nTODO:\n  There is an issue with finding a sibling when in an array element.\n  If the context document looks something like this…\n    {\n      someArray: [\n        {\n          _key: 'abc123',\n          targetSibling: 'herpderp'\n        }\n      ]\n    }\n  … we wind up with a path of…\n    [ 'someArray', { _key: 'ab123' }, 'targetSibling' ]\n  lodash.get() is trying to do an exact match, it doesn't know how to get object by _key.\n  \n  Will probably have to replace get() with a gnarly recursive lookup function.\n*/\n"],"mappings":"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","names":["maxDepth"]}
+{"version":3,"sources":["../src/referencedDocumentRequires.ts","../src/fileExtension.ts","../src/minDimensions.ts","../src/maxDepth.ts","../src/requiredIfSlugEq.ts","../src/requiredIfSiblingEq.ts","../src/lib/getSibling.ts","../src/regex.ts"],"sourcesContent":["import { ValidationContext } from \"sanity\"\n\nexport const referencedDocumentRequires = (\n  documentType: string, \n  field: string, \n  message: string = `{documentType}’s {field} must be filled.`\n) => async (value: any | undefined, context: ValidationContext) => {\n  if (!value?._ref) {\n    return true\n  }\n  const client = context.getClient({ apiVersion: \"2022-08-12\" })\n  // todo: use current API version, or test with no version at all\n\n  // todo: if there's a value._type or value.referenced._type or something, we get rid of document.type from inputs\n  const data = await client.fetch(`\n    *[_type == \"${documentType}\" && _id == \"${value._ref}\"]{\n      ${field}\n    }[0]\n  `) // TODO: why is typescript screaming about this? Fetch takes two parameters.\n  if (!data[field]) {\n    return message.replace(\"{documentType}\", documentType).replace(\"{field}\", field)\n  }\n  return true\n}\n","import { getExtension } from \"@sanity/asset-utils\"\nimport { FileValue } from \"sanity\"\n\nexport const fileExtension = (\n  validFileExtension: string | Array<string>, \n  message: string = `Image must be of type {validFileExtension}`\n) => (value: FileValue | undefined) => {\n  if (!value || !value.asset) {\n    return true\n  }\n  const validExtensions = typeof validFileExtension === \"string\" ? [validFileExtension] : validFileExtension\n  const filetype = getExtension(value.asset._ref)\n  if (!validExtensions.includes(filetype)) {\n    return message.replace(\"{validFileExtension}\", validExtensions.join(\", or \"))\n  }\n  return true\n}\n\n// todo: this should fail if its attached to a field that is not of type \"file\"","import { getImageDimensions } from \"@sanity/asset-utils\"\nimport { FileValue } from \"sanity\"\n\nexport const minDimensions =\n  ({ x, y }: { x: number; y: number }, message?: string) =>\n  (value: FileValue | undefined) => {\n    if (!value || !value.asset) {\n      return true\n    }\n    const { width, height } = getImageDimensions(value.asset._ref)\n    if (!!x && width < x) {\n      return message \n        ? message.replace(\"{width}\", width.toString())\n          .replace(\"{height}\", height.toString())\n          .replace(\"{x}\", x.toString())\n          .replace(\"{y}\", !y ? \"(any)\" : y.toString()) \n        : `Image must be at least ${x} pixels wide.`\n    }\n    if (!!y && height < y) {\n      return message \n        ? message.replace(\"{width}\", width.toString())\n          .replace(\"{height}\", height.toString())\n          .replace(\"{x}\", !x ? \"(any)\" : x.toString())\n          .replace(\"{y}\", y.toString())\n        : `Image must be at least ${y} pixels tall.`\n    }\n    return true\n  }\n\n// todo: this should fail if its attached to a field that is not of type \"image\"","import { ValidationContext } from \"sanity\"\n\nexport const maxDepth = (\n  maxDepth: number, \n  key: string,\n  message: string = `Error: You can only nest {key} {maxDepth} levels deep.`\n) => (_: any, context: ValidationContext) => {\n  let regex = new RegExp(String.raw`topLevelItems|${key}`)\n  const paths = (context.path as Array<any>).filter((e) => typeof e === \"string\" && e.match(regex))\n  if (paths.length > maxDepth) {\n    return message\n      .replace(\"{key}\", key)\n      .replace(\"{nestedValueName}\", key)  // backward compatibility\n      .replace(\"{maxDepth}\", maxDepth.toString())\n  }\n  return true\n}\n","import { ValidationContext } from \"sanity\"\n\n/*\nSanity has a funny idea of conditional fields. Every field is _always_ present, but it might be hidden.\nex. hidden: (node) => node.parent.slug === 'hideMe'\nThis works really well — unless a field marked as required gets hidden. \n\nThis validator conditionally marks a field as required only for specific slugs. It accepts a string or array of strings.\n```\nvalidation: (rule) => rule.custom(requiredIfSlugEq('alpha'))\nvalidation: (rule) => rule.custom(requiredIfSlugEq(['alpha', 'beta']))\nvalidation: (rule) => rule.custom(requiredIfSlugNotEq(['beta']))\n```\n\nIf the key of your slug is not simply \"slug\", fill that in the optional second parameter.\n```\nvalidation: (rule) => rule.custom(requiredIfSlugEq('alpha', 'id'))\n```\n\n\"Could this method be simpler if it just checked for the self.hidden state?\"\nNot possible, since the hidden state is not exposed to the context.\n\nBut even if it were, you wouldn't want to. There are valid reasons to make a component required but hidden.\nex. an admin- or developer-level identifier that you don't want civilians to see or edit.\n*/\n\nexport const requiredIfSlugEq = (\n  slug: Array<string> | string, \n  slugKey: string = \"slug\", \n  message: string = `This is a required field.`\n) =>\n  (value: unknown | undefined, context: ValidationContext) => {\n    const slugs = typeof slug === \"string\" ? [slug] : slug\n    const slugValue = (context.parent as any)?.[slugKey]?.current\n    \n    // todo: does slugKey exist? If not, fail.\n    // todo: deal with nested slugKey (ex. metadata.slug)\n    \n    if (!value && !!slugValue && slugs.includes(slugValue)) {\n      return message\n        .replace(\"{slugKey}\", slugKey)\n        .replace(\"{operand}\", slugs.join(', or '))\n        .replace(\"{siblingSlugValue}\", slugValue)\n    }\n    return true\n  }","import {getSibling} from './'\nimport {ValidationContext} from 'sanity'\n\n/*\nFor a given object that has multiple fields, mark a field as `required` if a sibling has a particular value.\n\n```\ndefineType({\n  name: 'ifAlphaAlsoBeta',\n  type: 'object',\n  fields: [\n    defineField({\n      name: 'alpha',\n      type: 'string',\n      options: {\n        list: ['left', 'right'],\n        layout: 'radio',\n        direction: 'horizontal',\n      },\n    }),\n    defineField({\n      name: 'beta',\n      type: 'string',\n      placeholder: 'If alpha is “left”, I’m also required',\n      validation: (rule) => rule.custom(requiredIfSiblingEq('alpha', 'left')),\n    })\n  ],\n})\n```\n\nIncidentally, context.path is technically Array<sanity.PathSegment>.\n\nThat shouldn't matter, but dealing with that and remapping siblingKey as a PathSegment could be a possible future enhancement.\n*/\n\nexport const requiredIfSiblingEq = (\n  key: string, \n  operand: string | number | null | Array<string | number | null>, \n  message: string = 'Required if {key} equals {operand}.'\n) =>\n  (value: unknown | undefined, context: ValidationContext) => {\n    const siblingValue = getSibling(key, context)\n    const operands = Array.isArray(operand) ? operand : [operand]\n    if (!value && operands.includes(siblingValue)) {\n      return message\n        .replace('{key}', key)\n        .replace('{operand}', operands.join(', or ') ?? 'null')\n        .replace('{value}', operands.join(', or ') ?? 'null') // backward compatibility\n        .replace('{siblingValue}', siblingValue)\n    }\n    return true\n  }\n","import { get } from \"lodash-es\"\nimport { ValidationContext } from \"sanity\"\n\nexport const getSibling = (key: string | number, context: ValidationContext) => {\n  const pathToParentObject = context.path!.slice(0, -1) as Array<string | number>\n  const sibling = get(context.document, [...pathToParentObject, key])\n  return sibling\n}\n\n/*\nTODO:\n  There is an issue with finding a sibling when in an array element.\n  If the context document looks something like this…\n    {\n      someArray: [\n        {\n          _key: 'abc123',\n          targetSibling: 'herpderp'\n        }\n      ]\n    }\n  … we wind up with a path of…\n    [ 'someArray', { _key: 'ab123' }, 'targetSibling' ]\n  lodash.get() is trying to do an exact match, it doesn't know how to get object by _key.\n  \n  Will probably have to replace get() with a gnarly recursive lookup function.\n*/\n","export const regex =\n  (pattern: RegExp, message: string = `“{value}” does not match the pattern {pattern}.`) =>\n  (value: unknown) => {\n    if (!value) {\n      return true\n    }\n    const valueAsString = typeof value !== \"string\" ? value.toString() : value\n    return pattern.test(valueAsString) ? true : message.replace(\"{value}\", valueAsString).replace(\"{pattern}\", pattern.toString())\n  }\n"],"mappings":"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","names":["maxDepth","regex"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "package-name": "sanity-advanced-validators",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Advanced input validation tools for Sanity CMS.",
   "author": "Eric_WVGG",
   "license": "MIT",
@@ -18,17 +18,17 @@
   "module": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
   "files": [
-      "dist"
-   ],
+    "dist"
+  ],
   "dependencies": {
     "@sanity/asset-utils": "^2.2.1",
-    "lodash-es": "^4.0.0",
-    "sanity": "^4.0.0"
+    "lodash-es": "^4.17.0",
+    "sanity": "^3.9.0"
   },
   "devDependencies": {
-    "@types/lodash-es": "^4.0.0",
+    "@types/lodash-es": "^4.17.0",
     "tsup": "^8.5.0",
-    "typescript": "^5.9.2",
+    "typescript": "^5.8.0",
     "vitest": "^3.2.4"
   },
   "name": "sanity-advanced-validators",