add QueryStringMatcher

CHANGES.md

@@ -13,7 +13,10 @@ What's next?
 Some ideas:
 - `RegExpUrlMatcher` and `EndpointMatcher` will probably get an additional parameter to describe the data instead of do it with type arguments and get only string. This parameter probably will looks like `{userId: numberValidator()}`.
 - `ExactQueryMatcher` will probably get validators too. This will improve extensibility and powerfulness a lot. In addition, it will probably handle PHP style arrays such as `users[]=1&users[]=2`.
+- Addition of some sort of `ajv`-based JSON Schema Matcher.
 
 Trying out
 ----------
 While this state is highly experimental, you can try it out with `pnpm add github:Bessonov/node-http-router#next`.
+
+After that, you can update to the latest version with `pnpm update -r @bessonovs/node-http-router`.

dist/Router.d.ts

@@ -1,5 +1,5 @@
 import { type Matched, type Matcher } from './matchers/index.js';
-import { type MatchResult, type MatchResultAny } from './matchers/MatchResult.js';
+import type { MatchResult, MatchResultAny } from './matchers/MatchResult.js';
 interface HandlerParams<MR extends MatchResultAny, D> {
     match: Matched<MR>;
     data: D;

dist/__tests__/validators.test.d.ts

@@ -0,0 +1 @@
+export {};

dist/index.d.ts

@@ -3,3 +3,4 @@ export * from './middlewares/index.js';
 export { type Handler, type Route, type MatchedHandler, Router, } from './Router.js';
 export { type ServerRequest, toServerRequest, } from './node/ServerRequest.js';
 export { NodeHttpRouter, type NodeHttpRouterParams, } from './node/NodeHttpRouter.js';
+export * from './validators.js';

dist/matchers/QueryStringMatcher.d.ts

@@ -0,0 +1,23 @@
+import type { Matcher } from './Matcher.js';
+import type { MatchResult } from './MatchResult.js';
+import type { Validator } from '../validators.js';
+export interface QueryStringMatcherInput {
+    req: {
+        url: string;
+    };
+}
+type AnyValidator = Validator<string[], any>;
+type QueryMatch = Record<string, AnyValidator>;
+type QueryResult<T extends QueryMatch> = {
+    [P in keyof T]: T[P] extends Validator<string[], infer O> ? O : never;
+};
+export type QueryStringMatchResult<U extends QueryMatch> = MatchResult<{
+    query: QueryResult<U>;
+}>;
+declare class QueryStringMatcher<U extends QueryMatch, P extends QueryStringMatcherInput> implements Matcher<QueryStringMatchResult<U>, P> {
+    private readonly listConfig;
+    constructor(config: U);
+    match: ({ req }: P) => QueryStringMatchResult<U>;
+}
+export declare function queryString<U extends QueryMatch, P extends QueryStringMatcherInput>(config: U): QueryStringMatcher<U, P>;
+export {};

dist/matchers/__tests__/QueryStringMatcher.test.d.ts

@@ -0,0 +1 @@
+export {};