rest_api_faker 0.0.5 → 0.0.6

package/dist/query.js

@@ -0,0 +1,289 @@
+import { logger } from './logger.js';
+export function parseQuery(req) {
+    const query = req.query;
+    const filters = {};
+    const operators = {};
+    const sort = [];
+    const order = [];
+    let page;
+    let limit;
+    let start;
+    let end;
+    let q;
+    for (const [key, value] of Object.entries(query)) {
+        const stringValue = typeof value === 'string'
+            ? value
+            : Array.isArray(value) && value.length > 0 && typeof value[0] === 'string'
+                ? value[0]
+                : null;
+        if (stringValue === null && !Array.isArray(value)) {
+            continue;
+        }
+        if (key === '_sort') {
+            if (typeof value === 'string') {
+                sort.push(...value.split(','));
+            }
+            else if (Array.isArray(value)) {
+                for (const v of value) {
+                    if (typeof v === 'string') {
+                        sort.push(v);
+                    }
+                }
+            }
+            continue;
+        }
+        if (key === '_order') {
+            if (typeof value === 'string') {
+                order.push(...value.split(','));
+            }
+            else if (Array.isArray(value)) {
+                for (const v of value) {
+                    if (typeof v === 'string') {
+                        order.push(v);
+                    }
+                }
+            }
+            continue;
+        }
+        if (key === '_page' && stringValue) {
+            const parsed = parseInt(stringValue, 10);
+            if (!isNaN(parsed) && parsed > 0) {
+                page = parsed;
+            }
+            continue;
+        }
+        if (key === '_limit' && stringValue) {
+            const parsed = parseInt(stringValue, 10);
+            if (!isNaN(parsed) && parsed > 0) {
+                limit = parsed;
+            }
+            continue;
+        }
+        if (key === '_start' && stringValue) {
+            const parsed = parseInt(stringValue, 10);
+            if (!isNaN(parsed) && parsed >= 0) {
+                start = parsed;
+            }
+            continue;
+        }
+        if (key === '_end' && stringValue) {
+            const parsed = parseInt(stringValue, 10);
+            if (!isNaN(parsed) && parsed >= 0) {
+                end = parsed;
+            }
+            continue;
+        }
+        if (key === 'q' && stringValue && stringValue.trim() !== '') {
+            q = stringValue;
+            continue;
+        }
+        const operatorMatch = key.match(/^(.+)_(gte|lte|ne|like)$/);
+        if (operatorMatch && stringValue) {
+            const field = operatorMatch[1];
+            const operator = operatorMatch[2];
+            if (field && operator) {
+                if (!operators[field]) {
+                    operators[field] = {};
+                }
+                operators[field][operator] = stringValue;
+            }
+            continue;
+        }
+        if (typeof value === 'string') {
+            filters[key] = value;
+        }
+        else if (Array.isArray(value)) {
+            const stringValues = value.filter((v) => typeof v === 'string');
+            if (stringValues.length > 0) {
+                filters[key] = stringValues;
+            }
+        }
+    }
+    const result = {
+        filters,
+        operators,
+        sort,
+        order,
+    };
+    if (page !== undefined)
+        result.page = page;
+    if (limit !== undefined)
+        result.limit = limit;
+    if (start !== undefined)
+        result.start = start;
+    if (end !== undefined)
+        result.end = end;
+    if (q !== undefined)
+        result.q = q;
+    logger.debug(`Parsed query options: ${JSON.stringify(result)}`);
+    return result;
+}
+function getNestedValue(obj, path) {
+    if (typeof obj !== 'object' || obj === null) {
+        return undefined;
+    }
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (typeof current !== 'object' || current === null || !(key in current)) {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+function matchesFilters(item, filters) {
+    if (typeof item !== 'object' || item === null) {
+        return false;
+    }
+    for (const [key, filterValue] of Object.entries(filters)) {
+        if (key === 'q')
+            continue;
+        const itemValue = getNestedValue(item, key);
+        if (Array.isArray(filterValue)) {
+            const matched = filterValue.some((val) => String(itemValue) === val);
+            if (!matched) {
+                return false;
+            }
+        }
+        else {
+            if (String(itemValue) !== filterValue) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+function matchesOperators(item, operators) {
+    if (typeof item !== 'object' || item === null) {
+        return false;
+    }
+    for (const [key, ops] of Object.entries(operators)) {
+        const itemValue = getNestedValue(item, key);
+        for (const [operator, filterValue] of Object.entries(ops)) {
+            if (operator === 'gte') {
+                if (Number(itemValue) < Number(filterValue)) {
+                    return false;
+                }
+            }
+            else if (operator === 'lte') {
+                if (Number(itemValue) > Number(filterValue)) {
+                    return false;
+                }
+            }
+            else if (operator === 'ne') {
+                if (String(itemValue) === filterValue) {
+                    return false;
+                }
+            }
+            else if (operator === 'like') {
+                const itemStr = String(itemValue).toLowerCase();
+                const filterStr = filterValue.toLowerCase();
+                if (!itemStr.includes(filterStr)) {
+                    return false;
+                }
+            }
+        }
+    }
+    return true;
+}
+function matchesSearch(item, searchText) {
+    if (typeof item !== 'object' || item === null) {
+        return false;
+    }
+    const lowerSearch = searchText.toLowerCase();
+    function searchObject(obj) {
+        if (typeof obj === 'string') {
+            return obj.toLowerCase().includes(lowerSearch);
+        }
+        if (typeof obj === 'object' && obj !== null) {
+            return Object.values(obj).some(searchObject);
+        }
+        return false;
+    }
+    return searchObject(item);
+}
+export function applyQuery(data, options) {
+    let result = [...data];
+    logger.trace(`Applying query: ${JSON.stringify(options)} on ${data.length.toString()} items`);
+    if (options.q) {
+        logger.trace(`Applying full-text search for: '${options.q}'`);
+        const searchText = options.q;
+        result = result.filter((item) => matchesSearch(item, searchText));
+    }
+    logger.trace(`After full-text search, ${result.length.toString()} items remain`);
+    if (Object.keys(options.filters).length > 0) {
+        result = result.filter((item) => matchesFilters(item, options.filters));
+    }
+    logger.trace(`After filtering, ${result.length.toString()} items remain`);
+    if (Object.keys(options.operators).length > 0) {
+        result = result.filter((item) => matchesOperators(item, options.operators));
+    }
+    logger.trace(`After applying operators, ${result.length.toString()} items remain`);
+    const total = result.length;
+    if (options.sort.length > 0) {
+        const sortFields = options.sort;
+        const sortOrders = options.order;
+        result.sort((a, b) => {
+            for (let i = 0; i < sortFields.length; i++) {
+                const field = sortFields[i];
+                if (!field)
+                    continue;
+                const order = sortOrders[i] === 'desc' ? -1 : 1;
+                const aVal = getNestedValue(a, field);
+                const bVal = getNestedValue(b, field);
+                if (aVal === bVal)
+                    continue;
+                if (aVal === undefined || aVal === null)
+                    return 1 * order;
+                if (bVal === undefined || bVal === null)
+                    return -1 * order;
+                if (aVal < bVal)
+                    return -1 * order;
+                if (aVal > bVal)
+                    return 1 * order;
+            }
+            return 0;
+        });
+    }
+    logger.trace(`After sorting, ${result.length.toString()} items remain`);
+    if (options.start !== undefined || options.end !== undefined) {
+        logger.trace(`Applying slicing from ${options.start?.toString() ?? ''} to ${options.end?.toString() ?? 'end'}`);
+        const start = options.start ?? 0;
+        const end = options.end ?? result.length;
+        result = result.slice(start, end);
+    }
+    else if (options.page !== undefined && options.limit !== undefined) {
+        logger.trace(`Applying pagination: page ${options.page.toString()}, limit ${options.limit.toString()}`);
+        const start = (options.page - 1) * options.limit;
+        result = result.slice(start, start + options.limit);
+    }
+    else if (options.limit !== undefined) {
+        logger.trace(`Applying limit: ${options.limit.toString()}`);
+        result = result.slice(0, options.limit);
+    }
+    logger.trace(`After pagination/slicing, ${result.length.toString()} items remain`);
+    return { data: result, total };
+}
+export function generateLinkHeader(req, page, limit, total) {
+    const host = req.get('host') ?? 'localhost';
+    const baseUrl = `${req.protocol}://${host}${req.path}`;
+    const query = new URLSearchParams(req.query);
+    const lastPage = Math.ceil(total / limit);
+    const links = [];
+    query.set('_page', '1');
+    query.set('_limit', String(limit));
+    links.push(`<${baseUrl}?${query.toString()}>; rel="first"`);
+    if (page > 1) {
+        query.set('_page', String(page - 1));
+        links.push(`<${baseUrl}?${query.toString()}>; rel="prev"`);
+    }
+    if (page < lastPage) {
+        query.set('_page', String(page + 1));
+        links.push(`<${baseUrl}?${query.toString()}>; rel="next"`);
+    }
+    query.set('_page', String(lastPage));
+    links.push(`<${baseUrl}?${query.toString()}>; rel="last"`);
+    return links.join(', ');
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA0BrC,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACxB,MAAM,OAAO,GAAsC,EAAE,CAAC;IACtD,MAAM,SAAS,GAA2C,EAAE,CAAC;IAC7D,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAwB,CAAC;IAC7B,IAAI,KAAyB,CAAC;IAC9B,IAAI,KAAyB,CAAC;IAC9B,IAAI,GAAuB,CAAC;IAC5B,IAAI,CAAqB,CAAC;IAE1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAEjD,MAAM,WAAW,GACf,OAAO,KAAK,KAAK,QAAQ;YACvB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ;gBACxE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;gBACV,CAAC,CAAC,IAAI,CAAC;QAEb,IAAI,WAAW,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,SAAS;QACX,CAAC;QAGD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;oBACtB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;wBAC1B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBACf,CAAC;gBACH,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YAClC,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;oBACtB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;wBAC1B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAChB,CAAC;gBACH,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,OAAO,IAAI,WAAW,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,IAAI,GAAG,MAAM,CAAC;YAChB,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,QAAQ,IAAI,WAAW,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,KAAK,GAAG,MAAM,CAAC;YACjB,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,QAAQ,IAAI,WAAW,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;gBAClC,KAAK,GAAG,MAAM,CAAC;YACjB,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,MAAM,IAAI,WAAW,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;gBAClC,GAAG,GAAG,MAAM,CAAC;YACf,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,GAAG,IAAI,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC5D,CAAC,GAAG,WAAW,CAAC;YAChB,SAAS;QACX,CAAC;QAGD,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC5D,IAAI,aAAa,IAAI,WAAW,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YAElC,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;gBACtB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;oBACtB,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;gBACxB,CAAC;gBACD,SAAS,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC;YAC3C,CAAC;YACD,SAAS;QACX,CAAC;QAGD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;YAC7E,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAiB;QAC3B,OAAO;QACP,SAAS;QACT,IAAI;QACJ,KAAK;KACN,CAAC;IAEF,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAC3C,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAC9C,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAC9C,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;IACxC,IAAI,CAAC,KAAK,SAAS;QAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;IAElC,MAAM,CAAC,KAAK,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAEhE,OAAO,MAAM,CAAC;AAChB,CAAC;AAYD,SAAS,cAAc,CAAC,GAAY,EAAE,IAAY;IAChD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,OAAO,GAAY,GAAG,CAAC;IAE3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,EAAE,CAAC;YACzE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAI,OAAmC,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAYD,SAAS,cAAc,CAAC,IAAa,EAAE,OAA0C;IAC/E,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAEzD,IAAG,GAAG,KAAK,GAAG;YAAE,SAAS;QAEzB,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAE5C,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAE/B,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC;YACrE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;aAAM,CAAC;YAEN,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,WAAW,EAAE,CAAC;gBACtC,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAYD,SAAS,gBAAgB,CACvB,IAAa,EACb,SAAiD;IAEjD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAE5C,KAAK,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1D,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;gBACvB,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC5C,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;iBAAM,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;gBAC9B,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC5C,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;iBAAM,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAC7B,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,WAAW,EAAE,CAAC;oBACtC,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;iBAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;gBAChD,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;gBAC5C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBACjC,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAYD,SAAS,aAAa,CAAC,IAAa,EAAE,UAAkB;IACtD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAE7C,SAAS,YAAY,CAAC,GAAY;QAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5C,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAYD,MAAM,UAAU,UAAU,CAAI,IAAS,EAAE,OAAqB;IAC5D,IAAI,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvB,MAAM,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAG9F,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;QACd,MAAM,CAAC,KAAK,CAAC,mCAAmC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC;QAC7B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,2BAA2B,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAGjF,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAG1E,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,6BAA6B,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAGnF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAG5B,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;QAChC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC;QAEjC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;gBAC5B,IAAI,CAAC,KAAK;oBAAE,SAAS;gBAErB,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAEhD,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBACtC,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBAEtC,IAAI,IAAI,KAAK,IAAI;oBAAE,SAAS;gBAG5B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;oBAAE,OAAO,CAAC,GAAG,KAAK,CAAC;gBAC1D,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;oBAAE,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC;gBAG3D,IAAI,IAAI,GAAG,IAAI;oBAAE,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC;gBACnC,IAAI,IAAI,GAAG,IAAI;oBAAE,OAAO,CAAC,GAAG,KAAK,CAAC;YACpC,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAGxE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC7D,MAAM,CAAC,KAAK,CAAC,yBAAyB,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC;QAEhH,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC;QACzC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;SAEI,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACnE,MAAM,CAAC,KAAK,CAAC,6BAA6B,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAExG,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QACjD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;SAEI,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,mBAAmB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAE5D,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,6BAA6B,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAEnF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC;AAcD,MAAM,UAAU,kBAAkB,CAChC,GAAY,EACZ,IAAY,EACZ,KAAa,EACb,KAAa;IAEb,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC;IAC5C,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,QAAQ,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,KAA+B,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;IAE1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAG3B,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxB,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAG5D,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC7D,CAAC;IAGD,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC7D,CAAC;IAGD,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAE3D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/relationships.d.ts

@@ -0,0 +1,10 @@
+import type { Database } from './database.js';
+export declare function getForeignKey(collectionName: string, foreignKeySuffix: string): string;
+export declare function embedChildren<T extends Record<string, unknown>>(items: T[], parentCollection: string, childCollection: string, db: Database, idField: string, foreignKeySuffix: string): T[];
+export declare function expandParent<T extends Record<string, unknown>>(items: T[], _childCollection: string, parentCollection: string, db: Database, idField: string, foreignKeySuffix: string): T[];
+export declare function applyRelationships<T extends Record<string, unknown>>(data: T[], resource: string, embed: string[], expand: string[], db: Database, idField: string, foreignKeySuffix: string): T[];
+export declare function parseRelationships(query: Record<string, unknown>): {
+    embed: string[];
+    expand: string[];
+};
+//# sourceMappingURL=relationships.d.ts.map

package/dist/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../src/relationships.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAa9C,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAKtF;AAiBD,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,KAAK,EAAE,CAAC,EAAE,EACV,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GACvB,CAAC,EAAE,CAwBL;AAiBD,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,KAAK,EAAE,CAAC,EAAE,EACV,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,EACxB,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GACvB,CAAC,EAAE,CA2CL;AAiBD,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,IAAI,EAAE,CAAC,EAAE,EACT,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,EAAE,EAChB,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GACvB,CAAC,EAAE,CAcL;AAYD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAClE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CA6BA"}

package/dist/relationships.js

@@ -0,0 +1,95 @@
+export function getForeignKey(collectionName, foreignKeySuffix) {
+    const singular = collectionName.endsWith('s') ? collectionName.slice(0, -1) : collectionName;
+    return `${singular}${foreignKeySuffix}`;
+}
+export function embedChildren(items, parentCollection, childCollection, db, idField, foreignKeySuffix) {
+    const children = db.getCollection(childCollection);
+    if (!Array.isArray(children)) {
+        return items;
+    }
+    const foreignKey = getForeignKey(parentCollection, foreignKeySuffix);
+    return items.map((item) => {
+        const matchingChildren = children.filter((child) => {
+            if (typeof child !== 'object' || child === null)
+                return false;
+            const childFk = child[foreignKey];
+            const parentId = item[idField];
+            return childFk === parentId || String(childFk) === String(parentId);
+        });
+        return {
+            ...item,
+            [childCollection]: matchingChildren,
+        };
+    });
+}
+export function expandParent(items, _childCollection, parentCollection, db, idField, foreignKeySuffix) {
+    const parents = db.getCollection(parentCollection);
+    if (!Array.isArray(parents)) {
+        return items;
+    }
+    const foreignKey = getForeignKey(parentCollection, foreignKeySuffix);
+    return items.map((item) => {
+        const foreignKeyValue = item[foreignKey];
+        if (foreignKeyValue === undefined) {
+            return item;
+        }
+        const parent = parents.find((p) => {
+            if (typeof p !== 'object' || p === null)
+                return false;
+            const parentRecord = p;
+            const parentId = parentRecord[idField];
+            if (typeof foreignKeyValue === 'number' || typeof foreignKeyValue === 'string') {
+                return parentId === foreignKeyValue || String(parentId) === String(foreignKeyValue);
+            }
+            return false;
+        });
+        if (!parent || typeof parent !== 'object') {
+            return item;
+        }
+        const parentPropName = parentCollection.endsWith('s')
+            ? parentCollection.slice(0, -1)
+            : parentCollection;
+        return {
+            ...item,
+            [parentPropName]: parent,
+        };
+    });
+}
+export function applyRelationships(data, resource, embed, expand, db, idField, foreignKeySuffix) {
+    let result = data;
+    for (const childCollection of embed) {
+        result = embedChildren(result, resource, childCollection, db, idField, foreignKeySuffix);
+    }
+    for (const parentCollection of expand) {
+        result = expandParent(result, resource, parentCollection, db, idField, foreignKeySuffix);
+    }
+    return result;
+}
+export function parseRelationships(query) {
+    const embed = [];
+    const expand = [];
+    const embedParam = query._embed;
+    if (typeof embedParam === 'string') {
+        embed.push(...embedParam.split(','));
+    }
+    else if (Array.isArray(embedParam)) {
+        for (const e of embedParam) {
+            if (typeof e === 'string') {
+                embed.push(e);
+            }
+        }
+    }
+    const expandParam = query._expand;
+    if (typeof expandParam === 'string') {
+        expand.push(...expandParam.split(','));
+    }
+    else if (Array.isArray(expandParam)) {
+        for (const e of expandParam) {
+            if (typeof e === 'string') {
+                expand.push(e);
+            }
+        }
+    }
+    return { embed, expand };
+}
+//# sourceMappingURL=relationships.js.map

package/dist/relationships.js.map

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

package/dist/rewriter.d.ts

@@ -0,0 +1,5 @@
+import { RequestHandler } from 'express';
+export type RewriteRules = Record<string, string>;
+export declare function loadRewriteRules(filePath: string): Promise<RewriteRules>;
+export declare function createRewriterMiddleware(rules: RewriteRules): RequestHandler;
+//# sourceMappingURL=rewriter.d.ts.map

package/dist/rewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriter.d.ts","sourceRoot":"","sources":["../src/rewriter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAiBzC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAgBlD,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAiC9E;AAoMD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAqB5E"}

package/dist/rewriter.js

@@ -0,0 +1,135 @@
+import { readFile } from 'node:fs/promises';
+import { logger } from './logger.js';
+export async function loadRewriteRules(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const rules = JSON.parse(content);
+        if (typeof rules !== 'object' || rules === null || Array.isArray(rules)) {
+            throw new Error('Routes file must contain a JSON object with route mappings');
+        }
+        for (const [key, value] of Object.entries(rules)) {
+            if (typeof value !== 'string') {
+                throw new Error(`Route mapping for '${key}' must be a string, got ${typeof value}`);
+            }
+        }
+        return rules;
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('Routes file must contain')) {
+            throw error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to load routes from '${filePath}': ${message}\n` +
+            `\nExpected format:\n` +
+            `{\n` +
+            `  "/api/*": "/$1",\n` +
+            `  "/users/:id": "/api/users/:id"\n` +
+            `}\n` +
+            `\nSee examples/routes.json for more examples.`, { cause: error });
+    }
+}
+function patternToRegex(pattern) {
+    const params = [];
+    let wildcardCount = 0;
+    let regexPattern = pattern.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
+    regexPattern = regexPattern.replace(/:([^/]+)/g, (_match, param) => {
+        params.push(param);
+        return '([^/]+)';
+    });
+    regexPattern = regexPattern.replace(/\*/g, () => {
+        wildcardCount++;
+        params.push(`$${String(wildcardCount)}`);
+        return '(.*?)';
+    });
+    return {
+        regex: new RegExp(`^${regexPattern}$`),
+        params,
+    };
+}
+function rewriteUrl(url, fromPattern, toPattern) {
+    const splitResult = url.split('?', 2);
+    const urlPath = splitResult[0] ?? '';
+    const urlQuery = splitResult[1];
+    const patternSplit = fromPattern.split('?', 2);
+    const patternPath = patternSplit[0] ?? '';
+    const patternQuery = patternSplit[1];
+    const { regex, params } = patternToRegex(patternPath);
+    const match = urlPath.match(regex);
+    if (!match) {
+        return null;
+    }
+    const captures = match.slice(1);
+    if (patternQuery) {
+        const patternParams = new URLSearchParams(patternQuery);
+        const urlParams = new URLSearchParams(urlQuery || '');
+        for (const [key, patternValue] of patternParams.entries()) {
+            if (!urlParams.has(key)) {
+                return null;
+            }
+            if (patternValue === '*') {
+                captures.push(urlParams.get(key) || '');
+            }
+            else if (urlParams.get(key) !== patternValue) {
+                return null;
+            }
+        }
+    }
+    let result = toPattern;
+    for (let i = 0; i < captures.length; i++) {
+        const value = captures[i];
+        if (value !== undefined) {
+            result = result.replace(`$${String(i + 1)}`, value);
+        }
+    }
+    for (let i = 0; i < params.length; i++) {
+        const param = params[i];
+        const value = captures[i];
+        if (param && !param.startsWith('$') && value !== undefined) {
+            result = result.replace(`:${param}`, value);
+        }
+    }
+    if (!patternQuery && urlQuery) {
+        result += '?' + urlQuery;
+    }
+    logger.info(`Rewriting URL: '${url}' → '${result}' using pattern '${fromPattern}'`);
+    return result;
+}
+function getPatternSpecificity(pattern) {
+    let score = 0;
+    const [path, query] = pattern.split('?', 2);
+    const segments = path?.split('/').filter(s => s.length > 0) ?? [];
+    for (const segment of segments) {
+        if (segment === '*') {
+            score += 1;
+        }
+        else if (segment.startsWith(':')) {
+            score += 10;
+        }
+        else {
+            score += 100;
+        }
+    }
+    if (query) {
+        score += 1000;
+    }
+    score += segments.length;
+    return score;
+}
+export function createRewriterMiddleware(rules) {
+    const sortedRules = Object.entries(rules).sort((a, b) => {
+        const scoreA = getPatternSpecificity(a[0]);
+        const scoreB = getPatternSpecificity(b[0]);
+        return scoreB - scoreA;
+    });
+    return (req, _res, next) => {
+        for (const [from, to] of sortedRules) {
+            const rewritten = rewriteUrl(req.url, from, to);
+            if (rewritten !== null) {
+                req.url = rewritten;
+                break;
+            }
+        }
+        next();
+    };
+}
+//# sourceMappingURL=rewriter.js.map

package/dist/rewriter.js.map

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

package/dist/router.d.ts

@@ -0,0 +1,9 @@
+import { Router } from 'express';
+import { Database } from './database.js';
+export interface RouterOptions {
+    idField?: string;
+    foreignKeySuffix?: string;
+    readOnly?: boolean;
+}
+export declare function createRouter(db: Database, options?: Partial<RouterOptions>): Router;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAmC,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAmBzC,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAiBD,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,MAAM,CAgZvF"}