@stacksjs/validation 0.75.112 → 0.75.113

package/README.md

@@ -73,3 +73,16 @@ booleans, non-finite values and unsafe integers. Optional text and numbers retur
 null; omitted booleans return undefined. Explicit false and zero are preserved.
 Model validation checks supplied fields against their declared rules; the action
 still selects writable fields and enforces required fields and relationships.
+
+## Reusable boundary and stored-value rules
+
+`parseTextInput(value, field, required?, maxLength?)` rejects overlong text
+rather than truncating it. `parseEnumInput(value, field, choices)` requires
+exact string membership; it never stringifies an object or boolean.
+`storedBoolean(value, fallback)` decodes SQL/form 0/1 and false/true; the
+caller explicitly chooses the fallback for missing or corrupt stored data.
+Partial model validation accepts attribute names and their snake-case column
+spelling, including camel-case definitions.
+
+`positiveIdOrNull(value)` is the nullable adapter for optional identifiers and
+record serializers; it uses the same safe-integer and type rules as parsePositiveId.

package/dist/input.d.ts

@@ -1,11 +1,17 @@
 export declare function readJsonObject(request: { json: () => Promise<unknown> }): Promise<Record<string, unknown>>;
 export declare function parsePositiveId(value: unknown): number;
-export declare function parseTextInput(value: unknown, field: string, required?: boolean): string | null;
+export declare function parseTextInput(value: unknown, field: string, required?: boolean, maxLength?: number): string | null;
 export declare function parseNumberInput(value: unknown, field: string, min: number, max: number, integer?: boolean): number | null;
 /** Supports form booleans without treating arbitrary text or objects as consent. */
 export declare function parseBooleanInput(value: unknown, field: string): boolean | undefined;
 /** Validate supplied fields only, so partial updates use the model's own rules. */
 export declare function validateModelInput(model: InputValidatableModel, values: Record<string, unknown>): void;
+/** Exact enum membership without turning objects or numbers into text. */
+export declare function parseEnumInput<const T extends readonly string[]>(value: unknown, field: string, choices: T): T[number];
+/** Decode SQL/form booleans. The caller explicitly chooses the fallback for absent or corrupt data. */
+export declare function storedBoolean(value: unknown, fallback: boolean): boolean;
+/** The nullable adapter for record serializers and optional identifiers. */
+export declare function positiveIdOrNull(value: unknown): number | null;
 export declare interface InputValidatableModel {
   getDefinition: () => { attributes?: Record<string, { validation?: { rule?: { validate(value: unknown): { valid: boolean } } } }> }
 }

package/dist/input.js

@@ -1 +1 @@
-export class InputValidationError extends Error{status=422}export async function readJsonObject(request){let body;try{body=await request.json()}catch{throw new InputValidationError("Send a valid JSON object")}if(!body||typeof body!=="object"||Array.isArray(body))throw new InputValidationError("Send a JSON object");return body}export function parsePositiveId(value){if(typeof value!=="string"&&typeof value!=="number")throw new InputValidationError("Invalid identifier");const id=Number(value);if(!Number.isSafeInteger(id)||id<=0)throw new InputValidationError("Invalid identifier");return id}export function parseTextInput(value,field,required=!1){if(value==null&&!required)return null;if(typeof value!=="string")throw new InputValidationError(`${field} must be text`);const text=value.trim();if(!text&&required)throw new InputValidationError(`${field} is required`);return text||null}export function parseNumberInput(value,field,min,max,integer=!1){if(value==null||value==="")return null;if(typeof value!=="number"&&typeof value!=="string"||typeof value==="string"&&!value.trim())throw new InputValidationError(`${field} must be a number`);const number=Number(value);if(!Number.isFinite(number)||number<min||number>max||integer&&!Number.isSafeInteger(number))throw new InputValidationError(`${field} is out of range`);return number}export function parseBooleanInput(value,field){if(value===void 0)return;if(value===!0||value==="true"||value===1||value==="1")return!0;if(value===!1||value==="false"||value===0||value==="0")return!1;throw new InputValidationError(`${field} must be a boolean`)}export function validateModelInput(model,values){for(const[field,value]of Object.entries(values)){const rule=model.getDefinition().attributes?.[field]?.validation?.rule;if(rule&&!rule.validate(value).valid)throw new InputValidationError(`Invalid ${field.replaceAll("_"," ")}`)}}
+export class InputValidationError extends Error{status=422}export async function readJsonObject(request){let body;try{body=await request.json()}catch{throw new InputValidationError("Send a valid JSON object")}if(!body||typeof body!=="object"||Array.isArray(body))throw new InputValidationError("Send a JSON object");return body}export function parsePositiveId(value){if(typeof value!=="string"&&typeof value!=="number")throw new InputValidationError("Invalid identifier");const id=Number(value);if(!Number.isSafeInteger(id)||id<=0)throw new InputValidationError("Invalid identifier");return id}export function parseTextInput(value,field,required=!1,maxLength){if(value==null&&!required)return null;if(typeof value!=="string")throw new InputValidationError(`${field} must be text`);const text=value.trim();if(maxLength!==void 0&&text.length>maxLength)throw new InputValidationError(`${field} is too long`);if(!text&&required)throw new InputValidationError(`${field} is required`);return text||null}export function parseNumberInput(value,field,min,max,integer=!1){if(value==null||value==="")return null;if(typeof value!=="number"&&typeof value!=="string"||typeof value==="string"&&!value.trim())throw new InputValidationError(`${field} must be a number`);const number=Number(value);if(!Number.isFinite(number)||number<min||number>max||integer&&!Number.isSafeInteger(number))throw new InputValidationError(`${field} is out of range`);return number}export function parseBooleanInput(value,field){if(value===void 0)return;if(value===!0||value==="true"||value===1||value==="1")return!0;if(value===!1||value==="false"||value===0||value==="0")return!1;throw new InputValidationError(`${field} must be a boolean`)}export function validateModelInput(model,values){const attributes=model.getDefinition().attributes??{};for(const[field,value]of Object.entries(values)){const attribute=Object.prototype.hasOwnProperty.call(attributes,field)?field:Object.keys(attributes).find((key)=>key===field||key.replace(/([a-z\d])([A-Z])/g,"$1_$2").replace(/([A-Z])([A-Z][a-z])/g,"$1_$2").toLowerCase()===field),rule=attribute?attributes[attribute]?.validation?.rule:void 0;if(rule&&!rule.validate(value).valid)throw new InputValidationError(`Invalid ${field.replaceAll("_"," ")}`)}}export function parseEnumInput(value,field,choices){if(typeof value!=="string"||!choices.includes(value))throw new InputValidationError(`${field} must be ${choices.join(", ")}`);return value}export function storedBoolean(value,fallback){if(value==null)return fallback;try{return parseBooleanInput(value,"Stored value")??fallback}catch(error){if(error instanceof InputValidationError)return fallback;throw error}}export function positiveIdOrNull(value){try{return parsePositiveId(value)}catch(error){if(error instanceof InputValidationError)return null;throw error}}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/validation",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.112",
+  "version": "0.75.113",
   "description": "The Stacks Validation ways.",
   "author": "Chris Breuer",
   "contributors": [
@@ -64,18 +64,18 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/error-handling": "0.75.112",
-    "@stacksjs/path": "0.75.112",
-    "@stacksjs/strings": "0.75.112",
+    "@stacksjs/error-handling": "0.75.113",
+    "@stacksjs/path": "0.75.113",
+    "@stacksjs/strings": "0.75.113",
     "@stacksjs/ts-validation": "^0.5.6",
-    "@stacksjs/types": "0.75.112",
-    "@stacksjs/utils": "0.75.112"
+    "@stacksjs/types": "0.75.113",
+    "@stacksjs/utils": "0.75.113"
   },
   "devDependencies": {
     "better-dx": "^0.2.24"
   },
   "peerDependencies": {
-    "@stacksjs/database": "0.75.112"
+    "@stacksjs/database": "0.75.113"
   },
   "peerDependenciesMeta": {
     "@stacksjs/database": {