vovk 3.4.0 → 3.4.1

package/dist/utils/parseQuery.js

@@ -1,156 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = parseQuery;
-/**
- * Parse a bracket-based key (e.g. "z[d][0][x]" or "arr[]")
- * into an array of path segments (strings or special push-markers).
- *
- * Example: "z[d][0][x]" => ["z", "d", "0", "x"]
- * Example: "arr[]"      => ["arr", "" ]  // "" indicates "push" onto array
- */
-function parseKey(key) {
-    // The first segment is everything up to the first '[' (or the entire key if no '[')
-    const segments = [];
-    const topKeyMatch = key.match(/^([^[\]]+)/);
-    if (topKeyMatch) {
-        segments.push(topKeyMatch[1]);
-    }
-    else {
-        // If it starts with brackets, treat it as empty? (edge case)
-        segments.push('');
-    }
-    // Now capture all bracket parts: [something], [0], []
-    const bracketRegex = /\[([^[\]]*)\]/g;
-    let match;
-    while ((match = bracketRegex.exec(key)) !== null) {
-        // match[1] is the content inside the brackets
-        segments.push(match[1]);
-    }
-    return segments;
-}
-/**
- * Recursively set a value in a nested object/array, given a path of segments.
- * - If segment is numeric => treat as array index
- * - If segment is empty "" => push to array
- * - Else => object property
- */
-function setValue(obj, path, value) {
-    let current = obj;
-    for (let i = 0; i < path.length; i++) {
-        const segment = path[i];
-        // If we're at the last segment, set the value
-        if (i === path.length - 1) {
-            if (segment === '') {
-                // Empty bracket => push
-                if (!Array.isArray(current)) {
-                    current = [];
-                }
-                current.push(value);
-            }
-            else if (!isNaN(Number(segment))) {
-                // Numeric segment => array index
-                const idx = Number(segment);
-                if (!Array.isArray(current)) {
-                    current = [];
-                }
-                current[idx] = value;
-            }
-            else {
-                // Object property
-                current[segment] = value;
-            }
-        }
-        else {
-            // Not the last segment: descend into existing structure or create it
-            const nextSegment = path[i + 1];
-            if (segment === '') {
-                // Empty bracket => push
-                if (!Array.isArray(current)) {
-                    // Convert the current node into an array, if not one
-                    current = [];
-                }
-                // If we are not at the last path, we need a placeholder object or array
-                // for the next segment. We'll push something and move current to that.
-                if (current.length === 0) {
-                    // nothing in array yet
-                    current.push(typeof nextSegment === 'string' && !isNaN(Number(nextSegment)) ? [] : {});
-                }
-                else if (typeof nextSegment === 'string' && !isNaN(Number(nextSegment))) {
-                    // next is numeric => we want an array
-                    if (!Array.isArray(current[current.length - 1])) {
-                        current[current.length - 1] = [];
-                    }
-                }
-                else {
-                    // next is not numeric => we want an object
-                    if (typeof current[current.length - 1] !== 'object') {
-                        current[current.length - 1] = {};
-                    }
-                }
-                current = current[current.length - 1];
-            }
-            else if (!isNaN(Number(segment))) {
-                // segment is numeric => array index
-                const idx = Number(segment);
-                if (!Array.isArray(current)) {
-                    current = [];
-                }
-                if (current[idx] === undefined) {
-                    // Create placeholder for next segment
-                    current[idx] = typeof nextSegment === 'string' && !isNaN(Number(nextSegment)) ? [] : {};
-                }
-                current = current[idx];
-            }
-            else {
-                // segment is an object key
-                if (current[segment] === undefined) {
-                    // Create placeholder
-                    current[segment] = typeof nextSegment === 'string' && !isNaN(Number(nextSegment)) ? [] : {};
-                }
-                current = current[segment];
-            }
-        }
-    }
-}
-/**
- * Deserialize a bracket-based query string into an object.
- *
- * Supports:
- *   - Key/value pairs with nested brackets (e.g. "a[b][0]=value")
- *   - Arrays with empty bracket (e.g. "arr[]=1&arr[]=2")
- *   - Mixed arrays of objects, etc.
- *
- * @example
- *   parseQuery("x=xx&y[0]=yy&y[1]=uu&z[f]=x&z[u][0]=uu&z[u][1]=xx&z[d][x]=ee")
- *   => {
- *        x: "xx",
- *        y: ["yy", "uu"],
- *        z: {
- *          f: "x",
- *          u: ["uu", "xx"],
- *          d: { x: "ee" }
- *        }
- *      }
- *
- * @param queryString - The raw query string (e.g. location.search.slice(1))
- * @returns           - A nested object representing the query params
- */
-function parseQuery(queryString) {
-    const result = {};
-    if (!queryString)
-        return result;
-    // Split into key=value pairs
-    const pairs = queryString
-        .replace(/^\?/, '') // Remove leading "?" if present
-        .split('&');
-    for (const pair of pairs) {
-        const [rawKey, rawVal = ''] = pair.split('=');
-        const decodedKey = decodeURIComponent(rawKey || '');
-        const decodedVal = decodeURIComponent(rawVal);
-        // Parse bracket notation
-        const pathSegments = parseKey(decodedKey);
-        // Insert into the result object
-        setValue(result, pathSegments, decodedVal);
-    }
-    return result;
-}

package/dist/utils/reqForm.d.ts

@@ -1,2 +0,0 @@
-import type { KnownAny, VovkRequest } from '../types';
-export default function reqForm<T = KnownAny>(req: VovkRequest<KnownAny, KnownAny>): Promise<T>;

package/dist/utils/reqForm.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = reqForm;
-const formMap = new WeakMap();
-async function reqForm(req) {
-    if (formMap.has(req)) {
-        return formMap.get(req);
-    }
-    const body = await req.formData();
-    const formData = {};
-    for (const [key, value] of body.entries()) {
-        if (value instanceof File) {
-            // If this key already exists, convert to array or append to existing array
-            if (formData[key]) {
-                if (Array.isArray(formData[key])) {
-                    formData[key].push(value);
-                }
-                else {
-                    formData[key] = [formData[key], value];
-                }
-            }
-            else {
-                formData[key] = value;
-            }
-        }
-        else {
-            formData[key] = value.toString();
-        }
-    }
-    formMap.set(req, formData);
-    return formData;
-}

package/dist/utils/reqMeta.d.ts

@@ -1,2 +0,0 @@
-import type { KnownAny, VovkRequest } from '../types';
-export default function reqMeta<T = Record<KnownAny, KnownAny>>(req: VovkRequest<KnownAny, KnownAny>, meta?: T | null): T;

package/dist/utils/reqMeta.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = reqMeta;
-const metaMap = new WeakMap();
-function reqMeta(req, meta) {
-    if (meta) {
-        metaMap.set(req, { ...metaMap.get(req), ...meta });
-    }
-    else if (meta === null) {
-        metaMap.delete(req);
-    }
-    return (metaMap.get(req) ?? {});
-}

package/dist/utils/reqQuery.d.ts

@@ -1,2 +0,0 @@
-import type { KnownAny, VovkRequest } from '../types';
-export default function reqQuery<T extends object | undefined>(req: VovkRequest<KnownAny, T>): T;

package/dist/utils/reqQuery.js

@@ -1,10 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = reqQuery;
-const parseQuery_1 = __importDefault(require("./parseQuery"));
-function reqQuery(req) {
-    return (0, parseQuery_1.default)(req.nextUrl.search);
-}

package/dist/utils/serializeQuery.d.ts

@@ -1,13 +0,0 @@
-import type { KnownAny } from '../types';
-/**
- * Serialize a nested object (including arrays, arrays of objects, etc.)
- * into a bracket-based query string.
- *
- * @example
- *   serializeQuery({ x: 'xx', y: [1, 2], z: { f: 'x' } })
- *   => "x=xx&y[0]=1&y[1]=2&z[f]=x"
- *
- * @param obj - The input object to be serialized
- * @returns   - A bracket-based query string (without leading "?")
- */
-export default function serializeQuery(obj: Record<string, KnownAny>): string;

package/dist/utils/serializeQuery.js

@@ -1,65 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = serializeQuery;
-/**
- * Recursively build query parameters from an object.
- *
- * @param key      - The query key so far (e.g. 'user', 'user[0]', 'user[0][name]')
- * @param value    - The current value to serialize
- * @returns        - An array of `key=value` strings
- */
-function buildParams(key, value) {
-    if (value === null || value === undefined) {
-        return []; // skip null/undefined values entirely
-    }
-    // If value is an object or array, we need to recurse
-    if (typeof value === 'object') {
-        // Array case
-        if (Array.isArray(value)) {
-            /**
-             * We use index-based bracket notation here:
-             *   e.g. for value = ['aa', 'bb'] and key = 'foo'
-             *   => "foo[0]=aa&foo[1]=bb"
-             *
-             * If you prefer "foo[]=aa&foo[]=bb" style, replace:
-             *   `${key}[${i}]`
-             * with:
-             *   `${key}[]`
-             */
-            return value.flatMap((v, i) => {
-                const newKey = `${key}[${i}]`;
-                return buildParams(newKey, v);
-            });
-        }
-        // Plain object case
-        return Object.keys(value).flatMap((k) => {
-            const newKey = `${key}[${k}]`;
-            return buildParams(newKey, value[k]);
-        });
-    }
-    return [`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`];
-}
-/**
- * Serialize a nested object (including arrays, arrays of objects, etc.)
- * into a bracket-based query string.
- *
- * @example
- *   serializeQuery({ x: 'xx', y: [1, 2], z: { f: 'x' } })
- *   => "x=xx&y[0]=1&y[1]=2&z[f]=x"
- *
- * @param obj - The input object to be serialized
- * @returns   - A bracket-based query string (without leading "?")
- */
-function serializeQuery(obj) {
-    if (!obj || typeof obj !== 'object')
-        return '';
-    // Collect query segments
-    const segments = [];
-    for (const key in obj) {
-        if (Object.prototype.hasOwnProperty.call(obj, key)) {
-            const value = obj[key];
-            segments.push(...buildParams(key, value));
-        }
-    }
-    return segments.join('&');
-}

package/dist/utils/setHandlerSchema.d.ts

@@ -1,4 +0,0 @@
-import type { KnownAny, VovkController, VovkHandlerSchema } from '../types';
-export declare function setHandlerSchema(h: ((...args: KnownAny[]) => KnownAny) & {
-    _getSchema?: (controller: VovkController) => Omit<VovkHandlerSchema, 'httpMethod' | 'path'>;
-}, schema: Omit<VovkHandlerSchema, 'httpMethod' | 'path'>): Promise<void>;

package/dist/utils/setHandlerSchema.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setHandlerSchema = setHandlerSchema;
-async function setHandlerSchema(h, schema) {
-    h._getSchema = (controller) => {
-        if (!controller) {
-            throw new Error('Error setting client validators. Controller not found. Did you forget to use an HTTP decorator?');
-        }
-        const handlerName = Object.getOwnPropertyNames(controller).find((key) => controller[key]._sourceMethod === h);
-        if (!handlerName) {
-            throw new Error('Error setting client validators. Handler not found.');
-        }
-        return schema;
-    };
-}

package/dist/utils/withValidation.d.ts

@@ -1,21 +0,0 @@
-import { VovkValidationType, type KnownAny, type VovkRequest } from '../types';
-export declare function withValidation<T extends (req: KnownAny, params: KnownAny) => KnownAny, BODY_MODEL, QUERY_MODEL, PARAMS_MODEL, OUTPUT_MODEL, ITERATION_MODEL>({ disableServerSideValidation, skipSchemaEmission, validateEachIteration, body, query, params, output, iteration, handle, getJSONSchemaFromModel, validate, }: {
-    disableServerSideValidation?: boolean | VovkValidationType[];
-    skipSchemaEmission?: boolean | VovkValidationType[];
-    validateEachIteration?: boolean;
-    body?: BODY_MODEL;
-    query?: QUERY_MODEL;
-    params?: PARAMS_MODEL;
-    output?: OUTPUT_MODEL;
-    iteration?: ITERATION_MODEL;
-    handle: T;
-    getJSONSchemaFromModel?: (model: NonNullable<BODY_MODEL | QUERY_MODEL | PARAMS_MODEL | OUTPUT_MODEL | ITERATION_MODEL>, meta: {
-        type: VovkValidationType;
-    }) => KnownAny;
-    validate: (data: KnownAny, model: NonNullable<BODY_MODEL | QUERY_MODEL | PARAMS_MODEL | OUTPUT_MODEL | ITERATION_MODEL>, meta: {
-        type: VovkValidationType;
-        req: VovkRequest<KnownAny, KnownAny>;
-        status?: number;
-        i?: number;
-    }) => KnownAny;
-}): T;

package/dist/utils/withValidation.js

@@ -1,88 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.withValidation = withValidation;
-const HttpException_1 = require("../HttpException");
-const types_1 = require("../types");
-const setHandlerSchema_1 = require("./setHandlerSchema");
-const validationTypes = ['body', 'query', 'params', 'output', 'iteration'];
-function withValidation({ disableServerSideValidation, skipSchemaEmission, validateEachIteration, body, query, params, output, iteration, handle, getJSONSchemaFromModel, validate, }) {
-    const disableServerSideValidationKeys = disableServerSideValidation === false
-        ? []
-        : disableServerSideValidation === true
-            ? validationTypes
-            : (disableServerSideValidation ?? []);
-    const skipSchemaEmissionKeys = skipSchemaEmission === false ? [] : skipSchemaEmission === true ? validationTypes : (skipSchemaEmission ?? []);
-    const outputHandler = async (req, handlerParams) => {
-        const data = await handle(req, handlerParams);
-        if (output && iteration) {
-            throw new HttpException_1.HttpException(types_1.HttpStatus.INTERNAL_SERVER_ERROR, "Output and iteration are mutually exclusive. You can't use them together.");
-        }
-        if (output && !disableServerSideValidationKeys.includes('output')) {
-            if (!data) {
-                throw new HttpException_1.HttpException(types_1.HttpStatus.INTERNAL_SERVER_ERROR, 'Output is required. You probably forgot to return something from your handler.');
-            }
-            await validate(data, output, { type: 'output', req });
-        }
-        if (iteration && !disableServerSideValidationKeys.includes('iteration')) {
-            // We assume `data` is an async iterable here; you might want to check that:
-            if (!data || typeof data[Symbol.asyncIterator] !== 'function') {
-                throw new HttpException_1.HttpException(types_1.HttpStatus.INTERNAL_SERVER_ERROR, 'Data is not an async iterable but iteration validation is defined.');
-            }
-            // Return a brand-new async generator that yields validated items
-            return (async function* () {
-                let i = 0;
-                for await (const item of data) {
-                    if (validateEachIteration || i === 0) {
-                        await validate(item, iteration, { type: 'iteration', req, status: 200, i });
-                    }
-                    i++;
-                    yield item;
-                }
-            })();
-        }
-        else if (validateEachIteration) {
-            throw new HttpException_1.HttpException(types_1.HttpStatus.INTERNAL_SERVER_ERROR, 'validateEachIteration is set but iteration is not defined.');
-        }
-        return data;
-    };
-    const resultHandler = async (req, handlerParams) => {
-        if (body && !disableServerSideValidationKeys.includes('body')) {
-            const data = await req.json();
-            const instance = (await validate(data, body, { type: 'body', req })) ?? data;
-            // redeclare to add ability to call req.json() again
-            req.json = () => Promise.resolve(data);
-            req.vovk.body = () => Promise.resolve(instance);
-        }
-        if (query && !disableServerSideValidationKeys.includes('query')) {
-            const data = req.vovk.query();
-            const instance = (await validate(data, query, { type: 'query', req })) ?? data;
-            req.vovk.query = () => instance;
-        }
-        if (params && !disableServerSideValidationKeys.includes('params')) {
-            const data = req.vovk.params();
-            const instance = (await validate(data, params, { type: 'params', req })) ?? data;
-            req.vovk.params = () => instance;
-        }
-        return outputHandler(req, handlerParams);
-    };
-    if (getJSONSchemaFromModel) {
-        const validation = {};
-        if (body && !skipSchemaEmissionKeys.includes('body')) {
-            validation.body = getJSONSchemaFromModel(body, { type: 'body' });
-        }
-        if (query && !skipSchemaEmissionKeys.includes('query')) {
-            validation.query = getJSONSchemaFromModel(query, { type: 'query' });
-        }
-        if (params && !skipSchemaEmissionKeys.includes('params')) {
-            validation.params = getJSONSchemaFromModel(params, { type: 'params' });
-        }
-        if (output && !skipSchemaEmissionKeys.includes('output')) {
-            validation.output = getJSONSchemaFromModel(output, { type: 'output' });
-        }
-        if (iteration && !skipSchemaEmissionKeys.includes('iteration')) {
-            validation.iteration = getJSONSchemaFromModel(iteration, { type: 'iteration' });
-        }
-        (0, setHandlerSchema_1.setHandlerSchema)(resultHandler, { validation });
-    }
-    return resultHandler;
-}