@fishka/express 0.9.14 → 0.9.15

package/dist/esm/utils/type-validators.d.ts

@@ -0,0 +1,58 @@
+/**
+ * URL parameter validators for Express path/query params.
+ * All params are strings from Express, so validation starts with string.
+ */
+import { TypeValidator } from '../api.types';
+/** Makes validator optional - returns undefined if value missing */
+export declare function optional<T>(validator: TypeValidator<T>): TypeValidator<T | undefined>;
+/** Operator that transforms string to T */
+export type ParamOperator<T> = (value: string) => T;
+/** Operator that transforms T to R */
+export type Operator<T, R = T> = (value: T) => R;
+/**
+ * Creates a URL parameter validator. Input is always string (from Express).
+ * Operators are applied in sequence to validate/transform the value.
+ *
+ * @example
+ * param()                      // string
+ * param(toInt)                 // number
+ * param(toInt, min(1))         // number >= 1
+ * param(minLength(3))          // string with min length
+ * param(trim, lowercase)       // trimmed lowercase string
+ */
+export declare function param(): TypeValidator<string>;
+export declare function param<A>(op1: ParamOperator<A>): TypeValidator<A>;
+export declare function param<A, B>(op1: ParamOperator<A>, op2: Operator<A, B>): TypeValidator<B>;
+export declare function param<A, B, C>(op1: ParamOperator<A>, op2: Operator<A, B>, op3: Operator<B, C>): TypeValidator<C>;
+export declare function param<A, B, C, D>(op1: ParamOperator<A>, op2: Operator<A, B>, op3: Operator<B, C>, op4: Operator<C, D>): TypeValidator<D>;
+export declare function param<A, B, C, D, E>(op1: ParamOperator<A>, op2: Operator<A, B>, op3: Operator<B, C>, op4: Operator<C, D>, op5: Operator<D, E>): TypeValidator<E>;
+/** Parses string to integer */
+export declare const toInt: (message?: string) => ParamOperator<number>;
+/** Parses string to number */
+export declare const toNumber: (message?: string) => ParamOperator<number>;
+/** Parses string to boolean ('true'/'false') */
+export declare const toBool: (message?: string) => ParamOperator<boolean>;
+/** Validates value is one of allowed enum values */
+export declare const oneOf: <T extends string>(...allowedValues: T[]) => ParamOperator<T>;
+/** Requires minimum string length */
+export declare const minLength: (n: number, message?: string) => ParamOperator<string>;
+/** Requires maximum string length */
+export declare const maxLength: (n: number, message?: string) => ParamOperator<string>;
+/** Requires string to match regex */
+export declare const matches: (regex: RegExp, message?: string) => ParamOperator<string>;
+/** Trims whitespace from string */
+export declare const trim: ParamOperator<string>;
+/** Converts string to lowercase */
+export declare const lowercase: ParamOperator<string>;
+/** Converts string to uppercase */
+export declare const uppercase: ParamOperator<string>;
+/** Requires minimum value */
+export declare const min: (n: number, message?: string) => Operator<number>;
+/** Requires maximum value */
+export declare const max: (n: number, message?: string) => Operator<number>;
+/** Requires value to be in range [minVal, maxVal] */
+export declare const range: (minVal: number, maxVal: number, message?: string) => Operator<number>;
+/** Adds custom validation */
+export declare const check: <T>(predicate: (value: T) => boolean, message: string) => Operator<T>;
+/** Transforms the value */
+export declare const map: <T, R>(fn: (value: T) => R) => Operator<T, R>;

package/dist/esm/utils/type-validators.js

@@ -0,0 +1,102 @@
+/**
+ * URL parameter validators for Express path/query params.
+ * All params are strings from Express, so validation starts with string.
+ */
+import { assertTruthy } from '@fishka/assertions';
+/** Makes validator optional - returns undefined if value missing */
+export function optional(validator) {
+    return (value) => {
+        if (value === undefined || value === null || value === '') {
+            return undefined;
+        }
+        return validator(value);
+    };
+}
+export function param(...operators) {
+    return (value) => {
+        assertTruthy(typeof value === 'string', `Expected string, got ${typeof value}`);
+        let result = value;
+        for (const op of operators) {
+            result = op(result);
+        }
+        return result;
+    };
+}
+// ============================================================================
+// String → T operators (first in chain)
+// ============================================================================
+/** Parses string to integer */
+export const toInt = (message) => (value) => {
+    const num = Number(value);
+    assertTruthy(Number.isInteger(num), message ?? `Expected integer, got '${value}'`);
+    return num;
+};
+/** Parses string to number */
+export const toNumber = (message) => (value) => {
+    const num = Number(value);
+    assertTruthy(!isNaN(num), message ?? `Expected number, got '${value}'`);
+    return num;
+};
+/** Parses string to boolean ('true'/'false') */
+export const toBool = (message) => (value) => {
+    assertTruthy(value === 'true' || value === 'false', message ?? `Expected 'true' or 'false', got '${value}'`);
+    return value === 'true';
+};
+/** Validates value is one of allowed enum values */
+export const oneOf = (...allowedValues) => (value) => {
+    assertTruthy(allowedValues.includes(value), `Expected one of [${allowedValues.join(', ')}], got '${value}'`);
+    return value;
+};
+// ============================================================================
+// String operators (string → string)
+// ============================================================================
+/** Requires minimum string length */
+export const minLength = (n, message) => (value) => {
+    assertTruthy(value.length >= n, message ?? `Must be at least ${n} characters`);
+    return value;
+};
+/** Requires maximum string length */
+export const maxLength = (n, message) => (value) => {
+    assertTruthy(value.length <= n, message ?? `Must be at most ${n} characters`);
+    return value;
+};
+/** Requires string to match regex */
+export const matches = (regex, message) => (value) => {
+    assertTruthy(regex.test(value), message ?? `Must match pattern ${regex}`);
+    return value;
+};
+/** Trims whitespace from string */
+export const trim = (value) => value.trim();
+/** Converts string to lowercase */
+export const lowercase = (value) => value.toLowerCase();
+/** Converts string to uppercase */
+export const uppercase = (value) => value.toUpperCase();
+// ============================================================================
+// Number operators (number → number)
+// ============================================================================
+/** Requires minimum value */
+export const min = (n, message) => (value) => {
+    assertTruthy(value >= n, message ?? `Must be at least ${n}`);
+    return value;
+};
+/** Requires maximum value */
+export const max = (n, message) => (value) => {
+    assertTruthy(value <= n, message ?? `Must be at most ${n}`);
+    return value;
+};
+/** Requires value to be in range [minVal, maxVal] */
+export const range = (minVal, maxVal, message) => (value) => {
+    assertTruthy(value >= minVal && value <= maxVal, message ?? `Must be between ${minVal} and ${maxVal}`);
+    return value;
+};
+// ============================================================================
+// Generic operators
+// ============================================================================
+/** Adds custom validation */
+export const check = (predicate, message) => (value) => {
+    assertTruthy(predicate(value), message);
+    return value;
+};
+/** Transforms the value */
+export const map = (fn) => (value) => fn(value);
+//# sourceMappingURL=type-validators.js.map

package/dist/esm/utils/type-validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-validators.js","sourceRoot":"","sources":["../../../src/utils/type-validators.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fishka/express",
-  "version": "0.9.14",
+  "version": "0.9.15",
   "description": "Express.js extension with built-in validation, and type safety",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",