moonflower 1.4.2 → 1.4.4

package/dist/index.d.ts

@@ -16,4 +16,5 @@ export * from './openapi/initOpenApiEngine';
 export * from './router/Router';
 export * from './validators/BuiltInValidators';
 export * from './validators/ParamWrappers';
+export * from './validators/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA;AACzC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wCAAwC,CAAA;AACtD,cAAc,wBAAwB,CAAA;AACtC,cAAc,mCAAmC,CAAA;AACjD,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AACtC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gCAAgC,CAAA;AAC9C,cAAc,4BAA4B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA;AACzC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wCAAwC,CAAA;AACtD,cAAc,wBAAwB,CAAA;AACtC,cAAc,mCAAmC,CAAA;AACjD,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AACtC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gCAAgC,CAAA;AAC9C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA"}

package/dist/validators/validateParam.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("zod"),a=require("../utils/getValueAsNullableString.cjs");function c(e,r){try{const t=o(e,r),n=s(e,r),u=l(e,n);return{validated:t&&u,parsedValue:n,exception:null}}catch(t){return{validated:!1,parsedValue:null,exception:f(t)}}}function o(e,r){return"prevalidate"in e&&typeof e.prevalidate=="function"?e.prevalidate(a.getValueAsNullableString(r)):!0}function s(e,r){if(e instanceof i.ZodType){const t=(()=>{try{return typeof r=="string"?JSON.parse(r):r}catch{return r}})();return e.parse(t)}return e.parse(a.getValueAsNullableString(r))}function l(e,r){return"validate"in e&&typeof e.validate=="function"?e.validate(r):!0}function f(e){return e instanceof i.ZodError?i.treeifyError(e).errors.join("; ").replace("Invalid input: ",""):"Validation failed"}exports.validateParam=c;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("zod"),o=require("../utils/getValueAsNullableString.cjs");function c(r,e){try{const t=s(r,e),i=l(r,e),a=p(r,i);return{validated:t&&a,parsedValue:i,exception:null}}catch(t){return{validated:!1,parsedValue:null,exception:d(t)}}}function s(r,e){return"prevalidate"in r&&typeof r.prevalidate=="function"?r.prevalidate(o.getValueAsNullableString(e)):!0}function f(r){return r instanceof n.ZodArray?!0:r instanceof n.ZodOptional?r.unwrap()instanceof n.ZodArray:!1}function l(r,e){if(r instanceof n.ZodType){const t=f(r),i=(()=>{if(typeof e!="string")return e;try{const a=JSON.parse(e);return t&&!Array.isArray(a)?u(e):a}catch{return t?u(e):e}})();return r.parse(i)}return r.parse(o.getValueAsNullableString(e))}function u(r){return r.split(",").map(e=>{const t=e.trim();try{return JSON.parse(t)}catch{return t}})}function p(r,e){return"validate"in r&&typeof r.validate=="function"?r.validate(e):!0}function d(r){return r instanceof n.ZodError?n.treeifyError(r).errors.join("; ").replace("Invalid input: ",""):"Validation failed"}exports.validateParam=c;
 //# sourceMappingURL=validateParam.cjs.map

package/dist/validators/validateParam.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validateParam.cjs","sources":["../../src/validators/validateParam.ts"],"sourcesContent":["import z, { ZodError } from 'zod'\n\nimport { getValueAsNullableString } from '../utils/getValueAsNullableString'\nimport { ValidatorUnion } from './types'\n\nexport function validateParam(\n\tvalidator: ValidatorUnion,\n\tvalue: string | number | boolean | object | null,\n): {\n\tvalidated: boolean\n\tparsedValue: unknown\n\texception: string | null\n} {\n\ttry {\n\t\tconst prevalidatorSuccess = runPrevalidator(validator, value)\n\t\tconst parsedValue = runParser(validator, value)\n\t\tconst validatorSuccess = runValidator(validator, parsedValue)\n\n\t\treturn {\n\t\t\tvalidated: prevalidatorSuccess && validatorSuccess,\n\t\t\tparsedValue,\n\t\t\texception: null,\n\t\t}\n\t} catch (error) {\n\t\tconst exception = getErrorMessage(error)\n\t\treturn { validated: false, parsedValue: null, exception }\n\t}\n}\n\nfunction runPrevalidator(validator: ValidatorUnion, value: string | number | boolean | object | null) {\n\t// Legacy validator\n\tif ('prevalidate' in validator && typeof validator.prevalidate === 'function') {\n\t\treturn validator.prevalidate(getValueAsNullableString(value))\n\t}\n\t// Zod (skip)\n\treturn true\n}\n\nfunction runParser(validator: ValidatorUnion, value: string | number | boolean | object | null) {\n\t// Zod validator\n\tif (validator instanceof z.ZodType) {\n\t\tconst coercedValue = (() => {\n\t\t\ttry {\n\t\t\t\treturn typeof value === 'string' ? JSON.parse(value) : value\n\t\t\t} catch {\n\t\t\t\treturn value\n\t\t\t}\n\t\t})()\n\t\treturn validator.parse(coercedValue)\n\t}\n\t// Legacy validator\n\treturn validator.parse(getValueAsNullableString(value))\n}\n\nfunction runValidator(validator: ValidatorUnion, parsedValue: unknown) {\n\t// Legacy validator\n\tif ('validate' in validator && typeof validator.validate === 'function') {\n\t\treturn validator.validate(parsedValue)\n\t}\n\t// Zod (skip)\n\treturn true\n}\n\nfunction getErrorMessage(error: unknown) {\n\tif (error instanceof ZodError) {\n\t\treturn z.treeifyError(error).errors.join('; ').replace('Invalid input: ', '')\n\t}\n\treturn 'Validation failed'\n}\n"],"names":["validateParam","validator","value","prevalidatorSuccess","runPrevalidator","parsedValue","runParser","validatorSuccess","runValidator","error","getErrorMessage","getValueAsNullableString","z","coercedValue","ZodError"],"mappings":"0JAKgB,SAAAA,EACfC,EACAC,EAKC,CACG,GAAA,CACG,MAAAC,EAAsBC,EAAgBH,EAAWC,CAAK,EACtDG,EAAcC,EAAUL,EAAWC,CAAK,EACxCK,EAAmBC,EAAaP,EAAWI,CAAW,EAErD,MAAA,CACN,UAAWF,GAAuBI,EAClC,YAAAF,EACA,UAAW,IACZ,QACQI,EAAO,CAEf,MAAO,CAAE,UAAW,GAAO,YAAa,KAAM,UAD5BC,EAAgBD,CAAK,CACiB,CAAA,CAE1D,CAEA,SAASL,EAAgBH,EAA2BC,EAAkD,CAErG,MAAI,gBAAiBD,GAAa,OAAOA,EAAU,aAAgB,WAC3DA,EAAU,YAAYU,EAAyB,yBAAAT,CAAK,CAAC,EAGtD,EACR,CAEA,SAASI,EAAUL,EAA2BC,EAAkD,CAE3F,GAAAD,aAAqBW,EAAE,QAAS,CACnC,MAAMC,GAAgB,IAAM,CACvB,GAAA,CACH,OAAO,OAAOX,GAAU,SAAW,KAAK,MAAMA,CAAK,EAAIA,CAAA,MAChD,CACA,OAAAA,CAAA,CACR,GACE,EACI,OAAAD,EAAU,MAAMY,CAAY,CAAA,CAGpC,OAAOZ,EAAU,MAAMU,EAAyB,yBAAAT,CAAK,CAAC,CACvD,CAEA,SAASM,EAAaP,EAA2BI,EAAsB,CAEtE,MAAI,aAAcJ,GAAa,OAAOA,EAAU,UAAa,WACrDA,EAAU,SAASI,CAAW,EAG/B,EACR,CAEA,SAASK,EAAgBD,EAAgB,CACxC,OAAIA,aAAiBK,EAAAA,SACbF,EAAE,aAAaH,CAAK,EAAE,OAAO,KAAK,IAAI,EAAE,QAAQ,kBAAmB,EAAE,EAEtE,mBACR"}
+{"version":3,"file":"validateParam.cjs","sources":["../../src/validators/validateParam.ts"],"sourcesContent":["import z, { ZodError } from 'zod'\n\nimport { getValueAsNullableString } from '../utils/getValueAsNullableString'\nimport { ValidatorUnion } from './types'\n\nexport function validateParam(\n\tvalidator: ValidatorUnion,\n\tvalue: string | number | boolean | object | null,\n): {\n\tvalidated: boolean\n\tparsedValue: unknown\n\texception: string | null\n} {\n\ttry {\n\t\tconst prevalidatorSuccess = runPrevalidator(validator, value)\n\t\tconst parsedValue = runParser(validator, value)\n\t\tconst validatorSuccess = runValidator(validator, parsedValue)\n\n\t\treturn {\n\t\t\tvalidated: prevalidatorSuccess && validatorSuccess,\n\t\t\tparsedValue,\n\t\t\texception: null,\n\t\t}\n\t} catch (error) {\n\t\tconst exception = getErrorMessage(error)\n\t\treturn { validated: false, parsedValue: null, exception }\n\t}\n}\n\nfunction runPrevalidator(validator: ValidatorUnion, value: string | number | boolean | object | null) {\n\t// Legacy validator\n\tif ('prevalidate' in validator && typeof validator.prevalidate === 'function') {\n\t\treturn validator.prevalidate(getValueAsNullableString(value))\n\t}\n\t// Zod (skip)\n\treturn true\n}\n\nfunction isZodArrayValidator(validator: z.ZodType): boolean {\n\tif (validator instanceof z.ZodArray) return true\n\tif (validator instanceof z.ZodOptional) return validator.unwrap() instanceof z.ZodArray\n\treturn false\n}\n\nfunction runParser(validator: ValidatorUnion, value: string | number | boolean | object | null) {\n\t// Zod validator\n\tif (validator instanceof z.ZodType) {\n\t\tconst isArrayValidator = isZodArrayValidator(validator)\n\t\tconst coercedValue = (() => {\n\t\t\tif (typeof value !== 'string') return value\n\n\t\t\ttry {\n\t\t\t\tconst parsed = JSON.parse(value)\n\t\t\t\tif (isArrayValidator && !Array.isArray(parsed)) {\n\t\t\t\t\treturn coerceCommaSeparatedToArray(value)\n\t\t\t\t}\n\t\t\t\treturn parsed\n\t\t\t} catch {\n\t\t\t\tif (isArrayValidator) {\n\t\t\t\t\treturn coerceCommaSeparatedToArray(value)\n\t\t\t\t}\n\t\t\t\treturn value\n\t\t\t}\n\t\t})()\n\t\treturn validator.parse(coercedValue)\n\t}\n\t// Legacy validator\n\treturn validator.parse(getValueAsNullableString(value))\n}\n\nfunction coerceCommaSeparatedToArray(value: string): unknown[] {\n\treturn value.split(',').map((element) => {\n\t\tconst trimmed = element.trim()\n\t\ttry {\n\t\t\treturn JSON.parse(trimmed)\n\t\t} catch {\n\t\t\treturn trimmed\n\t\t}\n\t})\n}\n\nfunction runValidator(validator: ValidatorUnion, parsedValue: unknown) {\n\t// Legacy validator\n\tif ('validate' in validator && typeof validator.validate === 'function') {\n\t\treturn validator.validate(parsedValue)\n\t}\n\t// Zod (skip)\n\treturn true\n}\n\nfunction getErrorMessage(error: unknown) {\n\tif (error instanceof ZodError) {\n\t\treturn z.treeifyError(error).errors.join('; ').replace('Invalid input: ', '')\n\t}\n\treturn 'Validation failed'\n}\n"],"names":["validateParam","validator","value","prevalidatorSuccess","runPrevalidator","parsedValue","runParser","validatorSuccess","runValidator","error","getErrorMessage","getValueAsNullableString","isZodArrayValidator","z","isArrayValidator","coercedValue","parsed","coerceCommaSeparatedToArray","element","trimmed","ZodError"],"mappings":"0JAKgB,SAAAA,EACfC,EACAC,EAKC,CACG,GAAA,CACG,MAAAC,EAAsBC,EAAgBH,EAAWC,CAAK,EACtDG,EAAcC,EAAUL,EAAWC,CAAK,EACxCK,EAAmBC,EAAaP,EAAWI,CAAW,EAErD,MAAA,CACN,UAAWF,GAAuBI,EAClC,YAAAF,EACA,UAAW,IACZ,QACQI,EAAO,CAEf,MAAO,CAAE,UAAW,GAAO,YAAa,KAAM,UAD5BC,EAAgBD,CAAK,CACiB,CAAA,CAE1D,CAEA,SAASL,EAAgBH,EAA2BC,EAAkD,CAErG,MAAI,gBAAiBD,GAAa,OAAOA,EAAU,aAAgB,WAC3DA,EAAU,YAAYU,EAAyB,yBAAAT,CAAK,CAAC,EAGtD,EACR,CAEA,SAASU,EAAoBX,EAA+B,CACvD,OAAAA,aAAqBY,EAAE,SAAiB,GACxCZ,aAAqBY,EAAE,YAAoBZ,EAAU,OAAA,YAAoBY,EAAE,SACxE,EACR,CAEA,SAASP,EAAUL,EAA2BC,EAAkD,CAE3F,GAAAD,aAAqBY,EAAE,QAAS,CAC7B,MAAAC,EAAmBF,EAAoBX,CAAS,EAChDc,GAAgB,IAAM,CACvB,GAAA,OAAOb,GAAU,SAAiB,OAAAA,EAElC,GAAA,CACG,MAAAc,EAAS,KAAK,MAAMd,CAAK,EAC/B,OAAIY,GAAoB,CAAC,MAAM,QAAQE,CAAM,EACrCC,EAA4Bf,CAAK,EAElCc,CAAA,MACA,CACP,OAAIF,EACIG,EAA4Bf,CAAK,EAElCA,CAAA,CACR,GACE,EACI,OAAAD,EAAU,MAAMc,CAAY,CAAA,CAGpC,OAAOd,EAAU,MAAMU,EAAyB,yBAAAT,CAAK,CAAC,CACvD,CAEA,SAASe,EAA4Bf,EAA0B,CAC9D,OAAOA,EAAM,MAAM,GAAG,EAAE,IAAKgB,GAAY,CAClC,MAAAC,EAAUD,EAAQ,KAAK,EACzB,GAAA,CACI,OAAA,KAAK,MAAMC,CAAO,CAAA,MAClB,CACA,OAAAA,CAAA,CACR,CACA,CACF,CAEA,SAASX,EAAaP,EAA2BI,EAAsB,CAEtE,MAAI,aAAcJ,GAAa,OAAOA,EAAU,UAAa,WACrDA,EAAU,SAASI,CAAW,EAG/B,EACR,CAEA,SAASK,EAAgBD,EAAgB,CACxC,OAAIA,aAAiBW,EAAAA,SACbP,EAAE,aAAaJ,CAAK,EAAE,OAAO,KAAK,IAAI,EAAE,QAAQ,kBAAmB,EAAE,EAEtE,mBACR"}

package/dist/validators/validateParam.mjs

@@ -1,40 +1,55 @@
 import i, { ZodError as u } from "zod";
-import { getValueAsNullableString as o } from "../utils/getValueAsNullableString.mjs";
-function y(e, r) {
+import { getValueAsNullableString as c } from "../utils/getValueAsNullableString.mjs";
+function A(r, e) {
   try {
-    const t = c(e, r), n = s(e, r), a = f(e, n);
+    const t = s(r, e), n = p(r, e), a = d(r, n);
     return {
       validated: t && a,
       parsedValue: n,
       exception: null
     };
   } catch (t) {
-    return { validated: !1, parsedValue: null, exception: p(t) };
+    return { validated: !1, parsedValue: null, exception: l(t) };
   }
 }
-function c(e, r) {
-  return "prevalidate" in e && typeof e.prevalidate == "function" ? e.prevalidate(o(r)) : !0;
+function s(r, e) {
+  return "prevalidate" in r && typeof r.prevalidate == "function" ? r.prevalidate(c(e)) : !0;
 }
-function s(e, r) {
-  if (e instanceof i.ZodType) {
-    const t = (() => {
+function f(r) {
+  return r instanceof i.ZodArray ? !0 : r instanceof i.ZodOptional ? r.unwrap() instanceof i.ZodArray : !1;
+}
+function p(r, e) {
+  if (r instanceof i.ZodType) {
+    const t = f(r), n = (() => {
+      if (typeof e != "string") return e;
       try {
-        return typeof r == "string" ? JSON.parse(r) : r;
+        const a = JSON.parse(e);
+        return t && !Array.isArray(a) ? o(e) : a;
       } catch {
-        return r;
+        return t ? o(e) : e;
       }
     })();
-    return e.parse(t);
+    return r.parse(n);
   }
-  return e.parse(o(r));
+  return r.parse(c(e));
+}
+function o(r) {
+  return r.split(",").map((e) => {
+    const t = e.trim();
+    try {
+      return JSON.parse(t);
+    } catch {
+      return t;
+    }
+  });
 }
-function f(e, r) {
-  return "validate" in e && typeof e.validate == "function" ? e.validate(r) : !0;
+function d(r, e) {
+  return "validate" in r && typeof r.validate == "function" ? r.validate(e) : !0;
 }
-function p(e) {
-  return e instanceof u ? i.treeifyError(e).errors.join("; ").replace("Invalid input: ", "") : "Validation failed";
+function l(r) {
+  return r instanceof u ? i.treeifyError(r).errors.join("; ").replace("Invalid input: ", "") : "Validation failed";
 }
 export {
-  y as validateParam
+  A as validateParam
 };
 //# sourceMappingURL=validateParam.mjs.map

package/dist/validators/validateParam.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validateParam.mjs","sources":["../../src/validators/validateParam.ts"],"sourcesContent":["import z, { ZodError } from 'zod'\n\nimport { getValueAsNullableString } from '../utils/getValueAsNullableString'\nimport { ValidatorUnion } from './types'\n\nexport function validateParam(\n\tvalidator: ValidatorUnion,\n\tvalue: string | number | boolean | object | null,\n): {\n\tvalidated: boolean\n\tparsedValue: unknown\n\texception: string | null\n} {\n\ttry {\n\t\tconst prevalidatorSuccess = runPrevalidator(validator, value)\n\t\tconst parsedValue = runParser(validator, value)\n\t\tconst validatorSuccess = runValidator(validator, parsedValue)\n\n\t\treturn {\n\t\t\tvalidated: prevalidatorSuccess && validatorSuccess,\n\t\t\tparsedValue,\n\t\t\texception: null,\n\t\t}\n\t} catch (error) {\n\t\tconst exception = getErrorMessage(error)\n\t\treturn { validated: false, parsedValue: null, exception }\n\t}\n}\n\nfunction runPrevalidator(validator: ValidatorUnion, value: string | number | boolean | object | null) {\n\t// Legacy validator\n\tif ('prevalidate' in validator && typeof validator.prevalidate === 'function') {\n\t\treturn validator.prevalidate(getValueAsNullableString(value))\n\t}\n\t// Zod (skip)\n\treturn true\n}\n\nfunction runParser(validator: ValidatorUnion, value: string | number | boolean | object | null) {\n\t// Zod validator\n\tif (validator instanceof z.ZodType) {\n\t\tconst coercedValue = (() => {\n\t\t\ttry {\n\t\t\t\treturn typeof value === 'string' ? JSON.parse(value) : value\n\t\t\t} catch {\n\t\t\t\treturn value\n\t\t\t}\n\t\t})()\n\t\treturn validator.parse(coercedValue)\n\t}\n\t// Legacy validator\n\treturn validator.parse(getValueAsNullableString(value))\n}\n\nfunction runValidator(validator: ValidatorUnion, parsedValue: unknown) {\n\t// Legacy validator\n\tif ('validate' in validator && typeof validator.validate === 'function') {\n\t\treturn validator.validate(parsedValue)\n\t}\n\t// Zod (skip)\n\treturn true\n}\n\nfunction getErrorMessage(error: unknown) {\n\tif (error instanceof ZodError) {\n\t\treturn z.treeifyError(error).errors.join('; ').replace('Invalid input: ', '')\n\t}\n\treturn 'Validation failed'\n}\n"],"names":["validateParam","validator","value","prevalidatorSuccess","runPrevalidator","parsedValue","runParser","validatorSuccess","runValidator","error","getErrorMessage","getValueAsNullableString","z","coercedValue","ZodError"],"mappings":";;AAKgB,SAAAA,EACfC,GACAC,GAKC;AACG,MAAA;AACG,UAAAC,IAAsBC,EAAgBH,GAAWC,CAAK,GACtDG,IAAcC,EAAUL,GAAWC,CAAK,GACxCK,IAAmBC,EAAaP,GAAWI,CAAW;AAErD,WAAA;AAAA,MACN,WAAWF,KAAuBI;AAAA,MAClC,aAAAF;AAAA,MACA,WAAW;AAAA,IACZ;AAAA,WACQI,GAAO;AAEf,WAAO,EAAE,WAAW,IAAO,aAAa,MAAM,WAD5BC,EAAgBD,CAAK,EACiB;AAAA,EAAA;AAE1D;AAEA,SAASL,EAAgBH,GAA2BC,GAAkD;AAErG,SAAI,iBAAiBD,KAAa,OAAOA,EAAU,eAAgB,aAC3DA,EAAU,YAAYU,EAAyBT,CAAK,CAAC,IAGtD;AACR;AAEA,SAASI,EAAUL,GAA2BC,GAAkD;AAE3F,MAAAD,aAAqBW,EAAE,SAAS;AACnC,UAAMC,KAAgB,MAAM;AACvB,UAAA;AACH,eAAO,OAAOX,KAAU,WAAW,KAAK,MAAMA,CAAK,IAAIA;AAAA,MAAA,QAChD;AACA,eAAAA;AAAA,MAAA;AAAA,IACR,GACE;AACI,WAAAD,EAAU,MAAMY,CAAY;AAAA,EAAA;AAGpC,SAAOZ,EAAU,MAAMU,EAAyBT,CAAK,CAAC;AACvD;AAEA,SAASM,EAAaP,GAA2BI,GAAsB;AAEtE,SAAI,cAAcJ,KAAa,OAAOA,EAAU,YAAa,aACrDA,EAAU,SAASI,CAAW,IAG/B;AACR;AAEA,SAASK,EAAgBD,GAAgB;AACxC,SAAIA,aAAiBK,IACbF,EAAE,aAAaH,CAAK,EAAE,OAAO,KAAK,IAAI,EAAE,QAAQ,mBAAmB,EAAE,IAEtE;AACR;"}
+{"version":3,"file":"validateParam.mjs","sources":["../../src/validators/validateParam.ts"],"sourcesContent":["import z, { ZodError } from 'zod'\n\nimport { getValueAsNullableString } from '../utils/getValueAsNullableString'\nimport { ValidatorUnion } from './types'\n\nexport function validateParam(\n\tvalidator: ValidatorUnion,\n\tvalue: string | number | boolean | object | null,\n): {\n\tvalidated: boolean\n\tparsedValue: unknown\n\texception: string | null\n} {\n\ttry {\n\t\tconst prevalidatorSuccess = runPrevalidator(validator, value)\n\t\tconst parsedValue = runParser(validator, value)\n\t\tconst validatorSuccess = runValidator(validator, parsedValue)\n\n\t\treturn {\n\t\t\tvalidated: prevalidatorSuccess && validatorSuccess,\n\t\t\tparsedValue,\n\t\t\texception: null,\n\t\t}\n\t} catch (error) {\n\t\tconst exception = getErrorMessage(error)\n\t\treturn { validated: false, parsedValue: null, exception }\n\t}\n}\n\nfunction runPrevalidator(validator: ValidatorUnion, value: string | number | boolean | object | null) {\n\t// Legacy validator\n\tif ('prevalidate' in validator && typeof validator.prevalidate === 'function') {\n\t\treturn validator.prevalidate(getValueAsNullableString(value))\n\t}\n\t// Zod (skip)\n\treturn true\n}\n\nfunction isZodArrayValidator(validator: z.ZodType): boolean {\n\tif (validator instanceof z.ZodArray) return true\n\tif (validator instanceof z.ZodOptional) return validator.unwrap() instanceof z.ZodArray\n\treturn false\n}\n\nfunction runParser(validator: ValidatorUnion, value: string | number | boolean | object | null) {\n\t// Zod validator\n\tif (validator instanceof z.ZodType) {\n\t\tconst isArrayValidator = isZodArrayValidator(validator)\n\t\tconst coercedValue = (() => {\n\t\t\tif (typeof value !== 'string') return value\n\n\t\t\ttry {\n\t\t\t\tconst parsed = JSON.parse(value)\n\t\t\t\tif (isArrayValidator && !Array.isArray(parsed)) {\n\t\t\t\t\treturn coerceCommaSeparatedToArray(value)\n\t\t\t\t}\n\t\t\t\treturn parsed\n\t\t\t} catch {\n\t\t\t\tif (isArrayValidator) {\n\t\t\t\t\treturn coerceCommaSeparatedToArray(value)\n\t\t\t\t}\n\t\t\t\treturn value\n\t\t\t}\n\t\t})()\n\t\treturn validator.parse(coercedValue)\n\t}\n\t// Legacy validator\n\treturn validator.parse(getValueAsNullableString(value))\n}\n\nfunction coerceCommaSeparatedToArray(value: string): unknown[] {\n\treturn value.split(',').map((element) => {\n\t\tconst trimmed = element.trim()\n\t\ttry {\n\t\t\treturn JSON.parse(trimmed)\n\t\t} catch {\n\t\t\treturn trimmed\n\t\t}\n\t})\n}\n\nfunction runValidator(validator: ValidatorUnion, parsedValue: unknown) {\n\t// Legacy validator\n\tif ('validate' in validator && typeof validator.validate === 'function') {\n\t\treturn validator.validate(parsedValue)\n\t}\n\t// Zod (skip)\n\treturn true\n}\n\nfunction getErrorMessage(error: unknown) {\n\tif (error instanceof ZodError) {\n\t\treturn z.treeifyError(error).errors.join('; ').replace('Invalid input: ', '')\n\t}\n\treturn 'Validation failed'\n}\n"],"names":["validateParam","validator","value","prevalidatorSuccess","runPrevalidator","parsedValue","runParser","validatorSuccess","runValidator","error","getErrorMessage","getValueAsNullableString","isZodArrayValidator","z","isArrayValidator","coercedValue","parsed","coerceCommaSeparatedToArray","element","trimmed","ZodError"],"mappings":";;AAKgB,SAAAA,EACfC,GACAC,GAKC;AACG,MAAA;AACG,UAAAC,IAAsBC,EAAgBH,GAAWC,CAAK,GACtDG,IAAcC,EAAUL,GAAWC,CAAK,GACxCK,IAAmBC,EAAaP,GAAWI,CAAW;AAErD,WAAA;AAAA,MACN,WAAWF,KAAuBI;AAAA,MAClC,aAAAF;AAAA,MACA,WAAW;AAAA,IACZ;AAAA,WACQI,GAAO;AAEf,WAAO,EAAE,WAAW,IAAO,aAAa,MAAM,WAD5BC,EAAgBD,CAAK,EACiB;AAAA,EAAA;AAE1D;AAEA,SAASL,EAAgBH,GAA2BC,GAAkD;AAErG,SAAI,iBAAiBD,KAAa,OAAOA,EAAU,eAAgB,aAC3DA,EAAU,YAAYU,EAAyBT,CAAK,CAAC,IAGtD;AACR;AAEA,SAASU,EAAoBX,GAA+B;AACvD,SAAAA,aAAqBY,EAAE,WAAiB,KACxCZ,aAAqBY,EAAE,cAAoBZ,EAAU,OAAA,aAAoBY,EAAE,WACxE;AACR;AAEA,SAASP,EAAUL,GAA2BC,GAAkD;AAE3F,MAAAD,aAAqBY,EAAE,SAAS;AAC7B,UAAAC,IAAmBF,EAAoBX,CAAS,GAChDc,KAAgB,MAAM;AACvB,UAAA,OAAOb,KAAU,SAAiB,QAAAA;AAElC,UAAA;AACG,cAAAc,IAAS,KAAK,MAAMd,CAAK;AAC/B,eAAIY,KAAoB,CAAC,MAAM,QAAQE,CAAM,IACrCC,EAA4Bf,CAAK,IAElCc;AAAA,MAAA,QACA;AACP,eAAIF,IACIG,EAA4Bf,CAAK,IAElCA;AAAA,MAAA;AAAA,IACR,GACE;AACI,WAAAD,EAAU,MAAMc,CAAY;AAAA,EAAA;AAGpC,SAAOd,EAAU,MAAMU,EAAyBT,CAAK,CAAC;AACvD;AAEA,SAASe,EAA4Bf,GAA0B;AAC9D,SAAOA,EAAM,MAAM,GAAG,EAAE,IAAI,CAACgB,MAAY;AAClC,UAAAC,IAAUD,EAAQ,KAAK;AACzB,QAAA;AACI,aAAA,KAAK,MAAMC,CAAO;AAAA,IAAA,QAClB;AACA,aAAAA;AAAA,IAAA;AAAA,EACR,CACA;AACF;AAEA,SAASX,EAAaP,GAA2BI,GAAsB;AAEtE,SAAI,cAAcJ,KAAa,OAAOA,EAAU,YAAa,aACrDA,EAAU,SAASI,CAAW,IAG/B;AACR;AAEA,SAASK,EAAgBD,GAAgB;AACxC,SAAIA,aAAiBW,IACbP,EAAE,aAAaJ,CAAK,EAAE,OAAO,KAAK,IAAI,EAAE,QAAQ,mBAAmB,EAAE,IAEtE;AACR;"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "moonflower",
-	"version": "1.4.2",
+	"version": "1.4.4",
 	"description": "",
 	"author": "tenebrie",
 	"license": "MIT",
@@ -107,6 +107,11 @@
 			"types": "./dist/validators/ParamWrappers.d.ts",
 			"import": "./dist/validators/ParamWrappers.mjs",
 			"require": "./dist/validators/ParamWrappers.cjs"
+		},
+		"./validators/types": {
+			"types": "./dist/validators/types.d.ts",
+			"import": "./dist/validators/types.mjs",
+			"require": "./dist/validators/types.cjs"
 		}
 	},
 	"bin": {

package/src/hooks/useQueryParams.spec.ts

@@ -321,4 +321,275 @@ describe('useQueryParams', () => {
 			expectTypeOf(params.numberParam).toEqualTypeOf<number | undefined>()
 		})
 	})
+
+	describe('legacy array validators', () => {
+		it('parses JSON string array with legacy validator', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				nodes: JSON.stringify(['node1', 'node2']),
+			})
+
+			const params = useQueryParams(ctx, {
+				nodes: RequiredParam<string[]>({
+					parse: (v) => JSON.parse(String(v)),
+				}),
+			})
+
+			expect(params.nodes).toEqual(['node1', 'node2'])
+		})
+
+		it('parses comma-separated array with legacy validator', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				nodes: 'node1,node2,node3',
+			})
+
+			const params = useQueryParams(ctx, {
+				nodes: RequiredParam<string[]>({
+					parse: (v) => String(v).split(','),
+				}),
+			})
+
+			expect(params.nodes).toEqual(['node1', 'node2', 'node3'])
+		})
+
+		it('fails validation on invalid legacy array param', () => {
+			const test = () => {
+				const ctx = mockContextQuery(mockContext(), {
+					nodes: 'not valid json array',
+				})
+
+				useQueryParams(ctx, {
+					nodes: RequiredParam<string[]>({
+						parse: (v) => JSON.parse(String(v)),
+					}),
+				})
+			}
+
+			expect(test).toThrow(ValidationError)
+			expect(test).toThrow("Failed query param validation: 'nodes'")
+		})
+
+		it('allows missing optional legacy array param', () => {
+			const ctx = mockContextQuery(mockContext(), {})
+
+			const params = useQueryParams(ctx, {
+				nodes: OptionalParam<string[]>({
+					parse: (v) => JSON.parse(String(v)),
+				}),
+			})
+
+			expect(params.nodes).toEqual(undefined)
+		})
+	})
+
+	describe('zod array validators', () => {
+		it('parses JSON string array', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				nodes: JSON.stringify(['node1', 'node2']),
+			})
+
+			const params = useQueryParams(ctx, {
+				nodes: z.array(z.string()),
+			})
+
+			expect(params.nodes).toEqual(['node1', 'node2'])
+		})
+
+		it('parses JSON number array', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				ids: JSON.stringify([1, 2, 3]),
+			})
+
+			const params = useQueryParams(ctx, {
+				ids: z.array(z.number()),
+			})
+
+			expect(params.ids).toEqual([1, 2, 3])
+		})
+
+		it('parses JSON object array', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				items: JSON.stringify([
+					{ name: 'first', value: 1 },
+					{ name: 'second', value: 2 },
+				]),
+			})
+
+			const params = useQueryParams(ctx, {
+				items: z.array(z.object({ name: z.string(), value: z.number() })),
+			})
+
+			expect(params.items).toEqual([
+				{ name: 'first', value: 1 },
+				{ name: 'second', value: 2 },
+			])
+		})
+
+		it('parses comma-separated string array', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				nodes: 'node1,node2,node3',
+			})
+
+			const params = useQueryParams(ctx, {
+				nodes: z.array(z.string()),
+			})
+
+			expect(params.nodes).toEqual(['node1', 'node2', 'node3'])
+		})
+
+		it('parses comma-separated number array', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				ids: '1,2,3',
+			})
+
+			const params = useQueryParams(ctx, {
+				ids: z.array(z.number()),
+			})
+
+			expect(params.ids).toEqual([1, 2, 3])
+		})
+
+		it('parses comma-separated boolean array', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				flags: 'true,false,true',
+			})
+
+			const params = useQueryParams(ctx, {
+				flags: z.array(z.boolean()),
+			})
+
+			expect(params.flags).toEqual([true, false, true])
+		})
+
+		it('parses comma-separated values with whitespace', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				nodes: 'node1, node2 , node3',
+			})
+
+			const params = useQueryParams(ctx, {
+				nodes: z.array(z.string()),
+			})
+
+			expect(params.nodes).toEqual(['node1', 'node2', 'node3'])
+		})
+
+		it('parses single value as string array', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				nodes: 'single',
+			})
+
+			const params = useQueryParams(ctx, {
+				nodes: z.array(z.string()),
+			})
+
+			expect(params.nodes).toEqual(['single'])
+		})
+
+		it('parses single value as number array', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				ids: '42',
+			})
+
+			const params = useQueryParams(ctx, {
+				ids: z.array(z.number()),
+			})
+
+			expect(params.ids).toEqual([42])
+		})
+
+		it('fails validation on invalid array element', () => {
+			const test = () => {
+				const ctx = mockContextQuery(mockContext(), {
+					ids: 'abc,def',
+				})
+
+				useQueryParams(ctx, {
+					ids: z.array(z.number()),
+				})
+			}
+
+			expect(test).toThrow(ValidationError)
+			expect(test).toThrow("Failed query param validation: 'ids'")
+		})
+
+		it('fails when required array is missing', () => {
+			const test = () => {
+				const ctx = mockContextQuery(mockContext(), {})
+
+				useQueryParams(ctx, {
+					nodes: z.array(z.string()),
+				})
+			}
+
+			expect(test).toThrow(ValidationError)
+			expect(test).toThrow("Missing query params: 'nodes'")
+		})
+
+		it('parses optional array when missing', () => {
+			const ctx = mockContextQuery(mockContext(), {})
+
+			const params = useQueryParams(ctx, {
+				nodes: z.array(z.string()).optional(),
+			})
+
+			expect(params.nodes).toEqual(undefined)
+		})
+
+		it('parses optional array when present', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				nodes: 'node1,node2',
+			})
+
+			const params = useQueryParams(ctx, {
+				nodes: z.array(z.string()).optional(),
+			})
+
+			expect(params.nodes).toEqual(['node1', 'node2'])
+		})
+
+		it('infers return type of string array', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				nodes: 'a,b',
+			})
+
+			const params = useQueryParams(ctx, {
+				nodes: z.array(z.string()),
+			})
+
+			expectTypeOf(params.nodes).toEqualTypeOf<string[]>()
+		})
+
+		it('infers return type of number array', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				ids: '1,2',
+			})
+
+			const params = useQueryParams(ctx, {
+				ids: z.array(z.number()),
+			})
+
+			expectTypeOf(params.ids).toEqualTypeOf<number[]>()
+		})
+
+		it('infers return type of object array', () => {
+			const ctx = mockContextQuery(mockContext(), {
+				items: JSON.stringify([{ name: 'a' }]),
+			})
+
+			const params = useQueryParams(ctx, {
+				items: z.array(z.object({ name: z.string() })),
+			})
+
+			expectTypeOf(params.items).toEqualTypeOf<{ name: string }[]>()
+		})
+
+		it('infers return type of optional array', () => {
+			const ctx = mockContextQuery(mockContext(), {})
+
+			const params = useQueryParams(ctx, {
+				nodes: z.array(z.string()).optional(),
+			})
+
+			expectTypeOf(params.nodes).toEqualTypeOf<string[] | undefined>()
+		})
+	})
 })

package/src/index.ts

@@ -16,3 +16,4 @@ export * from './openapi/initOpenApiEngine'
 export * from './router/Router'
 export * from './validators/BuiltInValidators'
 export * from './validators/ParamWrappers'
+export * from './validators/types'

package/src/validators/validateParam.ts

@@ -36,13 +36,29 @@ function runPrevalidator(validator: ValidatorUnion, value: string | number | boo
 	return true
 }
 
+function isZodArrayValidator(validator: z.ZodType): boolean {
+	if (validator instanceof z.ZodArray) return true
+	if (validator instanceof z.ZodOptional) return validator.unwrap() instanceof z.ZodArray
+	return false
+}
+
 function runParser(validator: ValidatorUnion, value: string | number | boolean | object | null) {
 	// Zod validator
 	if (validator instanceof z.ZodType) {
+		const isArrayValidator = isZodArrayValidator(validator)
 		const coercedValue = (() => {
+			if (typeof value !== 'string') return value
+
 			try {
-				return typeof value === 'string' ? JSON.parse(value) : value
+				const parsed = JSON.parse(value)
+				if (isArrayValidator && !Array.isArray(parsed)) {
+					return coerceCommaSeparatedToArray(value)
+				}
+				return parsed
 			} catch {
+				if (isArrayValidator) {
+					return coerceCommaSeparatedToArray(value)
+				}
 				return value
 			}
 		})()
@@ -52,6 +68,17 @@ function runParser(validator: ValidatorUnion, value: string | number | boolean |
 	return validator.parse(getValueAsNullableString(value))
 }
 
+function coerceCommaSeparatedToArray(value: string): unknown[] {
+	return value.split(',').map((element) => {
+		const trimmed = element.trim()
+		try {
+			return JSON.parse(trimmed)
+		} catch {
+			return trimmed
+		}
+	})
+}
+
 function runValidator(validator: ValidatorUnion, parsedValue: unknown) {
 	// Legacy validator
 	if ('validate' in validator && typeof validator.validate === 'function') {