jxp 4.1.1 → 5.0.0

package/dist/libs/mcp/read_service.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpFind = mcpFind;
+exports.mcpCount = mcpCount;
+exports.mcpExportCsv = mcpExportCsv;
+const read_handlers_1 = require("../read_handlers");
+const config_1 = require("./config");
+const model_visibility_1 = require("./model_visibility");
+const errors = require("restify-errors");
+function truncateValue(value, maxLen) {
+    if (typeof value === "string" && value.length > maxLen) {
+        return value.slice(0, maxLen);
+    }
+    if (Array.isArray(value)) {
+        return value.map((v) => truncateValue(v, maxLen));
+    }
+    if (value && typeof value === "object" && !(value instanceof Date)) {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = truncateValue(v, maxLen);
+        }
+        return out;
+    }
+    return value;
+}
+function truncateResultPayload(payload, maxLen) {
+    if (!payload || typeof payload !== "object")
+        return payload;
+    const clone = JSON.parse(JSON.stringify(payload));
+    if (clone.data && Array.isArray(clone.data)) {
+        clone.data = clone.data.map((row) => {
+            const next = truncateValue(row, maxLen);
+            if (JSON.stringify(row).length > JSON.stringify(next).length) {
+                next._truncated = true;
+            }
+            return next;
+        });
+    }
+    else if (clone.data && typeof clone.data === "object") {
+        const row = truncateValue(clone.data, maxLen);
+        if (JSON.stringify(clone.data).length > JSON.stringify(row).length) {
+            row._truncated = true;
+        }
+        clone.data = row;
+    }
+    return clone;
+}
+function buildQueryFromFindParams(params, mcp) {
+    const query = {};
+    if (params.filter)
+        query.filter = params.filter;
+    if (params.search !== undefined)
+        query.search = params.search;
+    if (params.populate !== undefined)
+        query.populate = params.populate;
+    if (params.fields)
+        query.fields = params.fields;
+    if (params.sort)
+        query.sort = params.sort;
+    if (params.page)
+        query.page = params.page;
+    if (params.skip)
+        query.skip = params.skip;
+    if (params.limit !== undefined) {
+        query.limit = Math.min(params.limit, mcp.maxLimit);
+    }
+    return query;
+}
+function mcpConfigForRequest(baseConfig, forCsv = false) {
+    const mcp = (0, config_1.getMcpConfig)();
+    const query_limits_overlay = forCsv
+        ? (0, config_1.overlayMcpCsvLimits)(baseConfig.query_limits, mcp)
+        : (0, config_1.overlayMcpQueryLimits)(baseConfig.query_limits, mcp);
+    return { ...baseConfig, query_limits: query_limits_overlay };
+}
+async function mcpFind(models, baseConfig, auth, params) {
+    const mcp = (0, config_1.getMcpConfig)();
+    const slug = params.model;
+    const Model = models[slug];
+    if (!Model) {
+        throw new errors.NotFoundError(`Model "${slug}" not found`);
+    }
+    await (0, model_visibility_1.assertModelVisibleMcp)(slug, Model, auth, mcp, params.id);
+    const config = mcpConfigForRequest(baseConfig);
+    const query = buildQueryFromFindParams(params, mcp);
+    if (mcp.disableAutopopulate && query.autopopulate) {
+        delete query.autopopulate;
+    }
+    const res = (0, read_handlers_1.buildSyntheticResponse)(auth.user, auth.groups);
+    if (params.id) {
+        const req = (0, read_handlers_1.buildSyntheticRequest)(config, slug, Model, query, { item_id: params.id });
+        await (0, read_handlers_1.executeGetOne)(req, res);
+        return truncateResultPayload(res.result, mcp.truncateStringsAt);
+    }
+    const req = (0, read_handlers_1.buildSyntheticRequest)(config, slug, Model, query);
+    await (0, read_handlers_1.executeList)(req, res);
+    return truncateResultPayload(res.result, mcp.truncateStringsAt);
+}
+async function mcpCount(models, baseConfig, auth, params) {
+    const mcp = (0, config_1.getMcpConfig)();
+    const slug = params.model;
+    const Model = models[slug];
+    if (!Model) {
+        throw new errors.NotFoundError(`Model "${slug}" not found`);
+    }
+    await (0, model_visibility_1.assertModelVisibleMcp)(slug, Model, auth, mcp);
+    const config = mcpConfigForRequest(baseConfig);
+    const query = {};
+    if (params.filter)
+        query.filter = params.filter;
+    if (params.search !== undefined)
+        query.search = params.search;
+    const req = (0, read_handlers_1.buildSyntheticRequest)(config, slug, Model, query);
+    const res = (0, read_handlers_1.buildSyntheticResponse)(auth.user, auth.groups);
+    await (0, read_handlers_1.executeCount)(req, res);
+    return res.result;
+}
+async function mcpExportCsv(models, baseConfig, auth, params) {
+    const mcp = (0, config_1.getMcpConfig)();
+    const slug = params.model;
+    const Model = models[slug];
+    if (!Model) {
+        throw new errors.NotFoundError(`Model "${slug}" not found`);
+    }
+    await (0, model_visibility_1.assertModelVisibleMcp)(slug, Model, auth, mcp);
+    const config = mcpConfigForRequest(baseConfig, true);
+    const query = buildQueryFromFindParams(params, mcp);
+    const req = (0, read_handlers_1.buildSyntheticRequest)(config, slug, Model, query);
+    const res = (0, read_handlers_1.buildSyntheticResponse)(auth.user, auth.groups);
+    await (0, read_handlers_1.executeList)(req, res);
+    const csv = (0, read_handlers_1.resultToCsv)(res.result);
+    const maxBytes = mcp.maxCsvBytes;
+    if (maxBytes > 0) {
+        const size = Buffer.byteLength(csv, "utf8");
+        if (size > maxBytes) {
+            throw new errors.PayloadTooLargeError(`CSV export size ${size} bytes exceeds MCP maximum ${maxBytes} bytes. Use fields and a lower limit.`);
+        }
+    }
+    return csv;
+}
+//# sourceMappingURL=read_service.js.map

package/dist/libs/mcp/read_service.js.map

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

package/dist/libs/mcp/server.d.ts

@@ -0,0 +1,23 @@
+import type { JXPConfig } from "../../types/jxp-config";
+import type { ModelRegistry } from "../builtin_models";
+type McpToolResult = {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: boolean;
+};
+type McpServerInstance = {
+    registerTool: (name: string, config: Record<string, unknown>, handler: (args: Record<string, unknown>) => Promise<McpToolResult>) => void;
+    registerResource: (name: string, uri: string, config: Record<string, unknown>, handler: () => Promise<{
+        contents: {
+            uri: string;
+            mimeType: string;
+            text: string;
+        }[];
+    }>) => void;
+    connect: (transport: unknown) => Promise<void>;
+};
+export declare function createMcpServer(config: JXPConfig, models: ModelRegistry): Promise<McpServerInstance>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/libs/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/libs/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAgBvD,KAAK,aAAa,GAAG;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtF,KAAK,iBAAiB,GAAG;IACxB,YAAY,EAAE,CACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,aAAa,CAAC,KAC9D,IAAI,CAAC;IACV,gBAAgB,EAAE,CACjB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,OAAO,CAAC;QAAE,QAAQ,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC,KACnF,IAAI,CAAC;IACV,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C,CAAC;AAaF,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,8BA+J7E"}

package/dist/libs/mcp/server.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMcpServer = createMcpServer;
+const config_1 = require("./config");
+const context_1 = require("./context");
+const guides_1 = require("./guides");
+const execute_tool_1 = require("./execute_tool");
+const dynamic_import_1 = require("./dynamic_import");
+const path = require("path");
+const { z } = require("zod");
+const pkg = require(path.join(__dirname, "../../../package.json"));
+function toolText(payload) {
+    return {
+        content: [{ type: "text", text: typeof payload === "string" ? payload : JSON.stringify(payload, null, 2) }],
+    };
+}
+function toolError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+async function createMcpServer(config, models) {
+    const { McpServer } = await (0, dynamic_import_1.dynamicImport)("@modelcontextprotocol/server");
+    const mcpConfig = (0, config_1.getMcpConfig)();
+    const guideCtx = { config, mcpConfig };
+    const server = new McpServer({ name: "jxp", version: pkg.version }, { instructions: (0, guides_1.buildMcpInstructions)(guideCtx) });
+    server.registerResource(guides_1.MCP_GUIDE_RESOURCE_NAME, guides_1.MCP_GUIDE_URI, {
+        title: "JXP MCP usage guide",
+        description: "Full markdown guide for querying JXP via MCP tools.",
+        mimeType: "text/markdown",
+    }, async () => ({
+        contents: [
+            {
+                uri: guides_1.MCP_GUIDE_URI,
+                mimeType: "text/markdown",
+                text: (0, guides_1.buildMcpGuideMarkdown)(guideCtx),
+            },
+        ],
+    }));
+    const modelSlug = z.string().min(1).describe("Model slug (from jxp_list_models)");
+    server.registerTool("jxp_list_models", {
+        title: "List JXP models",
+        description: "Always call this first to discover model slugs. Read resource jxp-guide if unsure about workflow.",
+        inputSchema: z.object({}),
+    }, async () => {
+        const auth = (0, context_1.getMcpAuth)();
+        const result = await (0, execute_tool_1.executeMcpTool)("jxp_list_models", {}, config, models, auth);
+        return result.isError ? toolError(result.text) : toolText(JSON.parse(result.text));
+    });
+    server.registerTool("jxp_describe_model", {
+        title: "Describe JXP model",
+        description: "JSON schema for a model: fields, links, populate hints. Call after jxp_list_models before jxp_find.",
+        inputSchema: z.object({ model: modelSlug }),
+    }, async ({ model }) => {
+        const auth = (0, context_1.getMcpAuth)();
+        const result = await (0, execute_tool_1.executeMcpTool)("jxp_describe_model", { model: String(model) }, config, models, auth);
+        return result.isError ? toolError(result.text) : toolText(JSON.parse(result.text));
+    });
+    const findSchema = z.object({
+        model: modelSlug,
+        id: z.string().optional().describe("MongoDB _id for a single document"),
+        filter: z.record(z.string(), z.unknown()).optional(),
+        search: z.union([z.string(), z.record(z.string(), z.unknown())]).optional(),
+        populate: z.union([z.string(), z.record(z.string(), z.string())]).optional(),
+        fields: z.string().optional().describe("Comma-separated field projection"),
+        sort: z.string().optional(),
+        limit: z.number().int().positive().optional(),
+        page: z.number().int().positive().optional(),
+        skip: z.number().int().nonnegative().optional(),
+    });
+    server.registerTool("jxp_find", {
+        title: "Find JXP documents",
+        description: "List or get documents. Use jxp_count first on large collections. Always set fields and a low limit. " +
+            `Default limit ${mcpConfig.defaultLimit}, max ${mcpConfig.maxLimit}.`,
+        inputSchema: findSchema,
+    }, async (args) => {
+        const auth = (0, context_1.getMcpAuth)();
+        const result = await (0, execute_tool_1.executeMcpTool)("jxp_find", args, config, models, auth);
+        if (result.isError)
+            return toolError(result.text);
+        try {
+            return toolText(JSON.parse(result.text));
+        }
+        catch {
+            return toolText(result.text);
+        }
+    });
+    server.registerTool("jxp_count", {
+        title: "Count JXP documents",
+        description: "Count matching documents. Use before jxp_find on large collections to avoid huge result sets.",
+        inputSchema: z.object({
+            model: modelSlug,
+            filter: z.record(z.string(), z.unknown()).optional(),
+            search: z.union([z.string(), z.record(z.string(), z.unknown())]).optional(),
+        }),
+    }, async (args) => {
+        const auth = (0, context_1.getMcpAuth)();
+        const result = await (0, execute_tool_1.executeMcpTool)("jxp_count", args, config, models, auth);
+        return result.isError ? toolError(result.text) : toolText(JSON.parse(result.text));
+    });
+    server.registerTool("jxp_export_csv", {
+        title: "Export JXP documents as CSV",
+        description: "Export matching documents as CSV text. Prefer fields and a low limit. No populate support.",
+        inputSchema: findSchema.omit({ id: true }),
+    }, async (args) => {
+        const auth = (0, context_1.getMcpAuth)();
+        const result = await (0, execute_tool_1.executeMcpTool)("jxp_export_csv", args, config, models, auth);
+        return result.isError ? toolError(result.text) : toolText(result.text);
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/libs/mcp/server.js.map

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

package/dist/libs/parse_byte_size.d.ts

@@ -0,0 +1,10 @@
+/** Normalize human sizes (e.g. `10M`, `10kb`) for the `bytes` parser. */
+export declare function normalizeByteSizeString(value: string): string;
+/**
+ * Parse a byte size from a number (bytes) or string (`10mb`, `10M`, `512kb`).
+ * Returns 0 for disabled (`0`, `0b`, `false`). Throws on invalid values.
+ */
+export declare function parseByteSize(value: string | number | null | undefined, label?: string): number;
+/** Safe parse for config/env; returns fallback when value is missing. */
+export declare function parseByteSizeOr(value: string | number | null | undefined, fallback: string | number, label?: string): number;
+//# sourceMappingURL=parse_byte_size.d.ts.map

package/dist/libs/parse_byte_size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse_byte_size.d.ts","sourceRoot":"","sources":["../../src/libs/parse_byte_size.ts"],"names":[],"mappings":"AAkBA,yEAAyE;AACzE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkB7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,SAAc,GAAG,MAAM,CAuBpG;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAC9B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,KAAK,SAAc,GACjB,MAAM,CAKR"}

package/dist/libs/parse_byte_size.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeByteSizeString = normalizeByteSizeString;
+exports.parseByteSize = parseByteSize;
+exports.parseByteSizeOr = parseByteSizeOr;
+const bytes_1 = __importDefault(require("bytes"));
+const UNIT_ALIASES = {
+    b: "b",
+    k: "kb",
+    kb: "kb",
+    kib: "kb",
+    m: "mb",
+    mb: "mb",
+    mib: "mb",
+    g: "gb",
+    gb: "gb",
+    gib: "gb",
+    t: "tb",
+    tb: "tb",
+    tib: "tb",
+};
+/** Normalize human sizes (e.g. `10M`, `10kb`) for the `bytes` parser. */
+function normalizeByteSizeString(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return trimmed;
+    }
+    const match = trimmed.match(/^(\d+(?:\.\d+)?)\s*([a-zA-Z]+)?$/);
+    if (!match) {
+        return trimmed.toLowerCase();
+    }
+    const [, num, unit] = match;
+    if (!unit) {
+        return num;
+    }
+    const mapped = UNIT_ALIASES[unit.toLowerCase()];
+    if (!mapped) {
+        return trimmed.toLowerCase();
+    }
+    return `${num}${mapped}`;
+}
+/**
+ * Parse a byte size from a number (bytes) or string (`10mb`, `10M`, `512kb`).
+ * Returns 0 for disabled (`0`, `0b`, `false`). Throws on invalid values.
+ */
+function parseByteSize(value, label = "byte size") {
+    if (value === null || value === undefined) {
+        throw new Error(`${label} is required`);
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value) || value < 0) {
+            throw new Error(`${label} must be a non-negative number`);
+        }
+        return Math.floor(value);
+    }
+    const raw = String(value).trim();
+    if (!raw) {
+        throw new Error(`${label} must not be empty`);
+    }
+    if (raw === "0" || raw.toLowerCase() === "0b" || raw.toLowerCase() === "false") {
+        return 0;
+    }
+    const normalized = normalizeByteSizeString(raw);
+    const parsed = bytes_1.default.parse(normalized);
+    if (parsed === null || !Number.isFinite(parsed) || parsed < 0) {
+        throw new Error(`${label} "${value}" is not a valid byte size (e.g. 10mb, 512kb, 10M)`);
+    }
+    return parsed;
+}
+/** Safe parse for config/env; returns fallback when value is missing. */
+function parseByteSizeOr(value, fallback, label = "byte size") {
+    if (value === null || value === undefined || value === "") {
+        return parseByteSize(fallback, label);
+    }
+    return parseByteSize(value, label);
+}
+//# sourceMappingURL=parse_byte_size.js.map

package/dist/libs/parse_byte_size.js.map

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

package/dist/libs/query_limits.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const errors = require("restify-errors");
 const { logRequestError } = require("./request_log");
+const { parseByteSize } = require("./parse_byte_size");
+const DEFAULT_MAX_RESPONSE_SIZE = "10mb";
+const DEFAULT_MAX_RESPONSE_BYTES = parseByteSize(DEFAULT_MAX_RESPONSE_SIZE, "query_limits.max_response_size");
 const DEFAULTS = {
     enabled: true,
     large_collection_threshold: 10000,
@@ -10,53 +13,97 @@ const DEFAULTS = {
     require_limit_always: true,
     skip_count_unless_paginated: true,
 };
+function resolveMaxResponseBytes(limits) {
+    const raw = limits.max_response_size ?? limits.max_response_bytes ?? DEFAULT_MAX_RESPONSE_SIZE;
+    try {
+        return parseByteSize(raw, "query_limits.max_response_size");
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new errors.BadRequestError(message);
+    }
+}
 function getLimits(req) {
     const limits = Object.assign({}, DEFAULTS, req.config?.query_limits);
     const modelLimits = req.Model?.schema?.opts?.query_limits;
     if (modelLimits && typeof modelLimits === "object") {
         Object.assign(limits, modelLimits);
     }
+    limits.max_response_bytes = resolveMaxResponseBytes(limits);
     return limits;
 }
 function parseRequestedLimit(req) {
     const n = parseInt(String(req.query.limit ?? ""), 10);
     return Number.isFinite(n) && n > 0 ? n : null;
 }
-function shouldRunCount(req) {
+function hasMeaningfulFilter(filter) {
+    if (filter == null || filter === "") {
+        return false;
+    }
+    if (typeof filter === "object" && !Array.isArray(filter)) {
+        return Object.keys(filter).length > 0;
+    }
+    return true;
+}
+/** GET ?filter= or non-empty POST /query body query */
+function hasClientFilter(req, bodyQuery) {
+    if (hasMeaningfulFilter(bodyQuery)) {
+        return true;
+    }
+    return hasMeaningfulFilter(req.query?.filter);
+}
+function shouldRunCount(req, opts = {}) {
     const limits = getLimits(req);
     if (limits.skip_count_unless_paginated === false)
         return true;
     if (req.query.count === "true" || req.query.count === true)
         return true;
     const page = parseInt(String(req.query.page ?? ""), 10);
-    return Number.isFinite(page) && page > 0;
+    if (Number.isFinite(page) && page > 0)
+        return true;
+    if (opts.filterExemption || opts.limitCapped)
+        return true;
+    return false;
 }
-function enforceListLimit(req, estimatedCount, res) {
+function enforceListLimit(req, estimatedCount, res, opts = {}) {
     const limits = getLimits(req);
+    const result = opts.result;
+    const hasFilter = hasClientFilter(req, opts.bodyQuery);
     if (limits.enabled === false) {
-        return parseRequestedLimit(req);
+        return { limit: parseRequestedLimit(req), limitCapped: false, filterExemption: false };
     }
     const requested = parseRequestedLimit(req);
     const isLarge = estimatedCount >= limits.large_collection_threshold;
     const sizeHint = `~${estimatedCount} docs threshold=${limits.large_collection_threshold}`;
-    if (isLarge && !requested && limits.require_limit_always !== false) {
+    let limitCapped = false;
+    let filterExemption = false;
+    if (isLarge && !requested && limits.require_limit_always !== false && !hasFilter) {
         const err = new errors.BadRequestError(`Collection "${req.modelname}" has ~${estimatedCount} documents. ` +
             `Use ?limit=1..${limits.max} (required). For totals use GET /count/${req.modelname}.`);
         logRequestError(req, res, err, "query_limit", sizeHint);
         throw err;
     }
+    if (isLarge && !requested && hasFilter) {
+        filterExemption = true;
+    }
+    let effectiveLimit;
     if (requested && requested > limits.max) {
-        const err = new errors.BadRequestError(`?limit=${requested} exceeds maximum ${limits.max} for "${req.modelname}".`);
-        logRequestError(req, res, err, "query_limit", sizeHint);
-        throw err;
+        effectiveLimit = limits.max;
+        limitCapped = true;
+        if (result) {
+            result.limit_capped = true;
+        }
+    }
+    else if (requested) {
+        effectiveLimit = requested;
     }
-    if (requested) {
-        return requested;
+    else if (limits.require_limit_always !== false && limits.default) {
+        effectiveLimit = limits.default;
     }
-    if (limits.require_limit_always !== false && limits.default) {
-        return limits.default;
+    else {
+        effectiveLimit = null;
     }
-    return null;
+    return { limit: effectiveLimit, limitCapped, filterExemption };
 }
 function applyListPagination(q, result, req, limit, count, changeUrlParams) {
     if (!limit) {
@@ -79,12 +126,51 @@ function applyListPagination(q, result, req, limit, count, changeUrlParams) {
         q.skip(limit * (page - 1));
     }
 }
+function finalizeListPagination(result, req, dataLength, limit, count, changeUrlParams) {
+    if (!limit || dataLength !== limit) {
+        return;
+    }
+    const page = typeof result.page === "number" ? result.page : 1;
+    if (count >= 0) {
+        const page_count = Math.ceil(count / limit);
+        if (page < page_count && !result.next) {
+            result.next = changeUrlParams(req, "page", page + 1);
+        }
+        return;
+    }
+    result.has_more = true;
+    if (!result.next) {
+        result.next = changeUrlParams(req, "page", page + 1);
+    }
+}
+function responseByteSize(payload) {
+    return Buffer.byteLength(JSON.stringify(payload), "utf8");
+}
+function enforceResponseSize(result, req, res) {
+    const limits = getLimits(req);
+    const maxBytes = limits.max_response_bytes;
+    if (!maxBytes || maxBytes <= 0) {
+        return;
+    }
+    const size = responseByteSize(result);
+    if (size > maxBytes) {
+        const err = new errors.PayloadTooLargeError(`Response size ${size} bytes exceeds maximum ${maxBytes} bytes for "${req.modelname}". ` +
+            `Reduce ?limit=, use ?fields=, or paginate.`);
+        logRequestError(req, res, err, "response_size", `${size}B max=${maxBytes}B`);
+        throw err;
+    }
+}
 module.exports = {
     getLimits,
     parseRequestedLimit,
+    hasClientFilter,
+    hasMeaningfulFilter,
     shouldRunCount,
     enforceListLimit,
     applyListPagination,
+    finalizeListPagination,
+    enforceResponseSize,
+    responseByteSize,
     DEFAULTS,
 };
 //# sourceMappingURL=query_limits.js.map

package/dist/libs/query_limits.js.map

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

package/dist/libs/read_handlers.d.ts

@@ -0,0 +1,13 @@
+import type { JXPConfig, JXPRequest, JXPResponse } from "../types/jxp-config";
+import type { Model } from "mongoose";
+export declare function parseFilter(filter: unknown, depth?: number): Record<string, unknown>;
+export declare function getOneDocument(Model: Model<unknown>, item_id: string, params: Record<string, unknown>, options: {
+    user?: JXPResponse["user"];
+}): Promise<any>;
+export declare function executeList(req: JXPRequest, res: JXPResponse): Promise<void>;
+export declare function executeGetOne(req: JXPRequest, res: JXPResponse): Promise<void>;
+export declare function executeCount(req: JXPRequest, res: JXPResponse): Promise<void>;
+export declare function resultToCsv(result: Record<string, unknown>): string;
+export declare function buildSyntheticRequest(config: JXPConfig, modelname: string, Model: Model<unknown>, query: Record<string, unknown>, params?: Record<string, string>): JXPRequest;
+export declare function buildSyntheticResponse(user: JXPResponse["user"], groups: string[]): JXPResponse;
+//# sourceMappingURL=read_handlers.d.ts.map

package/dist/libs/read_handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read_handlers.d.ts","sourceRoot":"","sources":["../../src/libs/read_handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAiCtC,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmG/E;AAED,wBAAsB,cAAc,CACnC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,gBAmCvC;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqHlF;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBnF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAOnE;AAED,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACjC,UAAU,CAWZ;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAe/F"}