@ereo/router 0.1.6

package/dist/validation.d.ts

@@ -0,0 +1,127 @@
+/**
+ * @ereo/router - Parameter Validation
+ *
+ * Validates route params and search params against schemas.
+ */
+import type { ParamValidationSchema, SearchParamValidationSchema, RouteParams } from '@ereo/core';
+/** Validation error for parameters */
+export declare class ParamValidationError extends Error {
+    field: string;
+    value: unknown;
+    constructor(message: string, field: string, value: unknown);
+}
+/** Validation result */
+export interface ValidationResult<T> {
+    valid: boolean;
+    data?: T;
+    errors?: ParamValidationError[];
+}
+/** Built-in validators */
+export declare const validators: {
+    /** String validator */
+    string: (options?: {
+        min?: number;
+        max?: number;
+        regex?: RegExp;
+    }) => {
+        parse: (value: string | string[] | undefined) => string;
+    };
+    /** Number validator */
+    number: (options?: {
+        min?: number;
+        max?: number;
+        integer?: boolean;
+    }) => {
+        parse: (value: string | string[] | undefined) => number;
+    };
+    /** Integer validator (convenience) */
+    int: (options?: {
+        min?: number;
+        max?: number;
+    }) => {
+        parse: (value: string | string[] | undefined) => number;
+    };
+    /** Boolean validator */
+    boolean: () => {
+        parse: (value: string | string[] | undefined) => boolean;
+    };
+    /** Enum validator */
+    enum: <T extends string>(values: T[]) => {
+        parse: (value: string | string[] | undefined) => T;
+    };
+    /** Array validator */
+    array: <T>(itemValidator: {
+        parse: (value: string) => T;
+    }) => {
+        parse: (value: string | string[] | undefined) => T[];
+    };
+    /** Optional wrapper */
+    optional: <T>(validator: {
+        parse: (value: string | string[] | undefined) => T;
+    }) => {
+        parse: (value: string | string[] | undefined) => T | undefined;
+    };
+    /** Default value wrapper */
+    default: <T>(validator: {
+        parse: (value: string | string[] | undefined) => T;
+    }, defaultValue: T) => {
+        parse: (value: string | string[] | undefined) => T;
+    };
+};
+/**
+ * Validate route parameters against a schema.
+ *
+ * @param params Raw parameters from URL
+ * @param schema Validation schema
+ * @returns Validated parameters
+ * @throws ParamValidationError if validation fails
+ *
+ * @example
+ * const schema = {
+ *   slug: validators.string({ regex: /^[a-z0-9-]+$/ }),
+ *   id: validators.int({ min: 1 }),
+ * };
+ * const validated = validateParams(params, schema);
+ */
+export declare function validateParams<T extends ParamValidationSchema>(params: RouteParams, schema: T): {
+    [K in keyof T]: ReturnType<T[K]['parse']>;
+};
+/**
+ * Safely validate parameters, returning result instead of throwing.
+ */
+export declare function safeValidateParams<T extends ParamValidationSchema>(params: RouteParams, schema: T): ValidationResult<{
+    [K in keyof T]: ReturnType<T[K]['parse']>;
+}>;
+/**
+ * Validate search parameters against a schema.
+ */
+export declare function validateSearchParams<T extends SearchParamValidationSchema>(searchParams: URLSearchParams | string | Record<string, string | string[]>, schema: T): Record<string, unknown>;
+/**
+ * Create a combined validator for params and search params.
+ */
+export declare function createRouteValidator<P extends ParamValidationSchema, S extends SearchParamValidationSchema>(options: {
+    params?: P;
+    searchParams?: S;
+}): {
+    validate: (routeParams: RouteParams, searchParams: URLSearchParams | string) => {
+        params: { [K in keyof P]: ReturnType<P[K]["parse"]>; };
+        searchParams: Record<string, unknown>;
+    };
+    safeValidate: (routeParams: RouteParams, searchParams: URLSearchParams | string) => {
+        valid: true;
+        data: {
+            params: { [K in keyof P]: ReturnType<P[K]["parse"]>; };
+            searchParams: Record<string, unknown>;
+        };
+        error?: undefined;
+    } | {
+        valid: false;
+        error: ParamValidationError;
+        data?: undefined;
+    };
+};
+/** Match a param pattern against a value */
+export declare function matchParamPattern(pattern: string, value: string): boolean;
+/** Extract param names from a route path */
+export declare function extractParamNames(path: string): string[];
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@ereo/router",
+  "version": "0.1.6",
+  "license": "MIT",
+  "author": "Ereo Team",
+  "homepage": "https://ereo.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ereojs/ereo.git",
+    "directory": "packages/router"
+  },
+  "bugs": {
+    "url": "https://github.com/ereojs/ereo/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun --external @ereo/core && bun run build:types",
+    "build:types": "tsc --emitDeclarationOnly --outDir dist",
+    "dev": "bun build ./src/index.ts --outdir ./dist --target bun --watch",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@ereo/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.0",
+    "typescript": "^5.4.0"
+  }
+}