jxp 3.0.0 → 4.1.0

package/dist/libs/docs-auth.js

@@ -0,0 +1,205 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOCS_SESSION_COOKIE = void 0;
+exports.parseDocsAccess = parseDocsAccess;
+exports.getDocsAccess = getDocsAccess;
+exports.isProtectedDocsPath = isProtectedDocsPath;
+exports.isDocsLoginPath = isDocsLoginPath;
+exports.verifyDocsSession = verifyDocsSession;
+exports.init = init;
+exports.docsAccessMiddleware = docsAccessMiddleware;
+exports.loginPage = loginPage;
+exports.establishSession = establishSession;
+exports.getSession = getSession;
+exports.logout = logout;
+exports.logDocsAccessMode = logDocsAccessMode;
+const jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
+const restify_errors_1 = __importDefault(require("restify-errors"));
+exports.DOCS_SESSION_COOKIE = "jxp_docs_session";
+const SESSION_MAX_AGE_SEC = 86400;
+let sharedSecret;
+function parseDocsAccess(raw) {
+    const v = (raw ?? "protected").toLowerCase().trim();
+    if (v === "disabled" || v === "off" || v === "false" || v === "0")
+        return "disabled";
+    if (v === "public" || v === "open")
+        return "public";
+    return "protected";
+}
+function getDocsAccess(config) {
+    return config.docs?.access ?? "protected";
+}
+/** Routes that require a docs session (model browser + interactive API). */
+function isProtectedDocsPath(pathname) {
+    return pathname === "/docs/api" || pathname.startsWith("/docs/model/");
+}
+function isDocsLoginPath(pathname) {
+    return pathname === "/docs/login";
+}
+function parseCookies(header) {
+    if (!header)
+        return {};
+    return header.split(";").reduce((acc, part) => {
+        const idx = part.indexOf("=");
+        if (idx === -1)
+            return acc;
+        const key = part.slice(0, idx).trim();
+        const val = part.slice(idx + 1).trim();
+        if (key)
+            acc[key] = decodeURIComponent(val);
+        return acc;
+    }, {});
+}
+function verifyDocsSession(req) {
+    if (!sharedSecret)
+        return null;
+    const cookies = parseCookies(req.headers.cookie);
+    const token = cookies[exports.DOCS_SESSION_COOKIE];
+    if (!token)
+        return null;
+    try {
+        return jsonwebtoken_1.default.verify(token, sharedSecret);
+    }
+    catch {
+        return null;
+    }
+}
+function signDocsSession(payload) {
+    if (!sharedSecret)
+        throw new Error("SHARED_SECRET is required for docs session");
+    return jsonwebtoken_1.default.sign(payload, sharedSecret, { expiresIn: SESSION_MAX_AGE_SEC });
+}
+function setSessionCookie(res, token) {
+    const secure = process.env.DOCS_COOKIE_SECURE === "1" || process.env.DOCS_COOKIE_SECURE === "true";
+    const parts = [
+        `${exports.DOCS_SESSION_COOKIE}=${encodeURIComponent(token)}`,
+        "Path=/",
+        "HttpOnly",
+        "SameSite=Lax",
+        `Max-Age=${SESSION_MAX_AGE_SEC}`,
+    ];
+    if (secure)
+        parts.push("Secure");
+    res.header("Set-Cookie", parts.join("; "));
+}
+function clearSessionCookie(res) {
+    res.header("Set-Cookie", `${exports.DOCS_SESSION_COOKIE}=; Path=/; HttpOnly; SameSite=Lax; Max-Age=0`);
+}
+/** Restify redirect() always requires next; use this in async route handlers. */
+function sendRedirect(res, url) {
+    res.status(302);
+    res.header("Location", url);
+    res.end();
+}
+function init(config) {
+    sharedSecret = config.shared_secret;
+}
+function docsAccessMiddleware(req, res, next) {
+    const pathname = req.path();
+    if (!isProtectedDocsPath(pathname)) {
+        return next();
+    }
+    const access = getDocsAccess(req.config);
+    if (access === "public") {
+        return next();
+    }
+    if (access === "disabled") {
+        return next(new restify_errors_1.default.NotFoundError("Not found"));
+    }
+    const session = verifyDocsSession(req);
+    if (!session) {
+        if (req.method === "GET") {
+            const nextUrl = encodeURIComponent(pathname);
+            res.redirect(302, `/docs/login?next=${nextUrl}`, next);
+            return;
+        }
+        return next(new restify_errors_1.default.UnauthorizedError("Docs login required"));
+    }
+    req.docsSession = session;
+    return next();
+}
+async function loginPage(req, res, renderLogin) {
+    const access = getDocsAccess(req.config);
+    if (access === "disabled") {
+        throw new restify_errors_1.default.NotFoundError("Not found");
+    }
+    if (access === "public") {
+        sendRedirect(res, "/docs/api");
+        return;
+    }
+    const session = verifyDocsSession(req);
+    if (session) {
+        const nextPath = typeof req.query.next === "string" && req.query.next.startsWith("/")
+            ? req.query.next
+            : "/docs/api";
+        sendRedirect(res, nextPath);
+        return;
+    }
+    const nextDefault = typeof req.query.next === "string" && req.query.next.startsWith("/")
+        ? req.query.next
+        : "/docs/api";
+    renderLogin(res, {
+        docs_user_email: req.config.docs?.user_email ?? "",
+        docs_next: nextDefault,
+    });
+}
+/** Store docs session after a successful POST /login (client sends apikey from login response). */
+async function establishSession(req, res) {
+    const access = getDocsAccess(req.config);
+    if (access !== "protected") {
+        throw new restify_errors_1.default.NotFoundError("Not found");
+    }
+    const apikey = String(req.body?.apikey ?? "").trim();
+    if (!apikey) {
+        throw new restify_errors_1.default.BadRequestError("apikey is required");
+    }
+    const security = require("./security");
+    let user;
+    try {
+        user = await security.apiKeyAuth(apikey);
+    }
+    catch {
+        throw new restify_errors_1.default.UnauthorizedError("Invalid apikey");
+    }
+    const token = signDocsSession({
+        user_id: String(user._id),
+        email: user.email,
+        apikey,
+    });
+    setSessionCookie(res, token);
+    res.send({ ok: true });
+}
+async function getSession(req, res) {
+    const access = getDocsAccess(req.config);
+    if (access !== "protected") {
+        res.send({ apikey: null });
+        return;
+    }
+    const docsSession = verifyDocsSession(req);
+    if (!docsSession) {
+        throw new restify_errors_1.default.UnauthorizedError("Not authenticated");
+    }
+    res.send({ apikey: docsSession.apikey });
+}
+async function logout(req, res) {
+    clearSessionCookie(res);
+    sendRedirect(res, "/");
+}
+function logDocsAccessMode(config) {
+    if (config.quiet_startup)
+        return;
+    const access = getDocsAccess(config);
+    if (access === "disabled") {
+        console.log("API docs browser: disabled (DOCS_ACCESS=disabled)");
+    }
+    else if (access === "public") {
+        console.log("API docs browser: public (no login for model explorer)");
+    }
+    else {
+        console.log("API docs browser: protected (login required for /docs/api and /docs/model/*)");
+    }
+}
+//# sourceMappingURL=docs-auth.js.map

package/dist/libs/docs-auth.js.map

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

package/dist/libs/docs.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=docs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/libs/docs.ts"],"names":[],"mappings":""}

package/dist/libs/docs.js

@@ -0,0 +1,328 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const pug_1 = __importDefault(require("pug"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const markdown_it_1 = __importDefault(require("markdown-it"));
+const util_1 = __importDefault(require("util"));
+const md = new markdown_it_1.default();
+// Required for templates/index.pug (`include:markdown-it ../docs/index.md`)
+pug_1.default.filters["markdown-it"] = (text) => md.render(text);
+const getModelFileContents = require("./schema_description");
+const restify_errors_1 = __importDefault(require("restify-errors"));
+const docs_auth_1 = require("./docs-auth");
+const readFile = util_1.default.promisify(fs_1.default.readFile);
+const packageRoot = path_1.default.join(__dirname, "../..");
+const assetsDir = path_1.default.join(packageRoot, "templates", "assets");
+const ASSET_TYPES = {
+    css: "text/css; charset=utf-8",
+    js: "application/javascript; charset=utf-8",
+};
+const LANDING_FEATURES = [
+    { title: "Auth built in", description: "API keys, tokens, and password encryption without extra wiring." },
+    { title: "Smart population", description: "Load linked documents with URL-driven populate parameters." },
+    { title: "Powerful queries", description: "Search, sort, filter, field selection, and limits on GET requests." },
+    { title: "Schema-driven", description: "Add or change models by editing Mongoose schemas — the API updates automatically." },
+    { title: "Permissions", description: "Per-model CRUD rules by user group, owner, and admin." },
+    { title: "Hooks & logic", description: "pre/post hooks and custom handlers for business rules." },
+];
+const buildEndpoints = (modelSlug) => {
+    const base = `/api/${modelSlug}`;
+    return [
+        {
+            method: "GET",
+            path: base,
+            description: "List documents in this collection.",
+            queryHint: "Supports filter, search, populate, fields, sort, limit, skip — see REST reference.",
+        },
+        {
+            method: "GET",
+            path: `${base}/{id}`,
+            description: "Get a single document by MongoDB _id.",
+        },
+        {
+            method: "POST",
+            path: base,
+            description: "Create a new document.",
+            hasBody: true,
+        },
+        {
+            method: "PUT",
+            path: `${base}/{id}`,
+            description: "Update a document (partial updates supported).",
+            hasBody: true,
+        },
+        {
+            method: "DELETE",
+            path: `${base}/{id}`,
+            description: "Delete a document (soft-delete when configured).",
+        },
+    ];
+};
+// Helper function to safely serialize schema fields
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const serializeField = (field) => {
+    const safeField = {
+        path: field.path,
+        instance: field.instance,
+        options: { ...field.options },
+        validators: field.validators?.map(v => ({
+            type: v.type?.name,
+            message: v.message
+        })),
+        isRequired: field.isRequired
+    };
+    if (typeof field.defaultValue === 'function') {
+        safeField.defaultValue = '[Function]';
+    }
+    else if (field.defaultValue === undefined && field.options.default !== undefined) {
+        if (typeof field.options.default === 'function') {
+            safeField.defaultValue = '[Function]';
+        }
+        else {
+            safeField.defaultValue = field.options.default;
+        }
+    }
+    else {
+        safeField.defaultValue = field.defaultValue;
+    }
+    if (field.instance === 'Array' && field.caster) {
+        safeField.arrayType = field.caster.instance;
+        if (Array.isArray(safeField.defaultValue)) {
+            safeField.defaultValue = JSON.stringify(safeField.defaultValue);
+        }
+    }
+    if (field.instance === 'Embedded' || field.instance === 'DocumentArray') {
+        safeField.schema = Object.keys(field.schema.paths).map(p => ({
+            path: p,
+            type: field.schema.paths[p].instance
+        }));
+    }
+    return safeField;
+};
+class Docs {
+    config;
+    models;
+    mkdocs;
+    package;
+    constructor(opts) {
+        this.config = Object.assign({}, opts.config);
+        this.models = opts.models;
+        this.mkdocs = js_yaml_1.default.load(fs_1.default.readFileSync(path_1.default.join(packageRoot, "mkdocs.yml"), "utf8"));
+        this.package = require(path_1.default.join(process.cwd(), "package.json"));
+    }
+    getFirstGuideUrl() {
+        const nav = this.mkdocs.nav;
+        if (!nav || !nav.length)
+            return null;
+        const first = nav[0];
+        const file = Object.values(first)[0];
+        return `/docs/md/${file}`;
+    }
+    getBaseUrl(req) {
+        const host = req.headers?.host || "localhost";
+        const proto = req.connection?.encrypted ? "https" : "http";
+        return `${proto}://${host}`;
+    }
+    templateContext(req, extra = {}) {
+        const access = (0, docs_auth_1.getDocsAccess)(this.config);
+        const session = req ? (0, docs_auth_1.verifyDocsSession)(req) : undefined;
+        return {
+            docs_access: access,
+            docs_authenticated: access === "public" || Boolean(session),
+            docs_user_email: this.config.docs?.user_email ?? "",
+            docs_session_email: session?.email ?? "",
+            ...extra,
+        };
+    }
+    renderTemplate(res, template_file, data = {}, req) {
+        const template = pug_1.default.compileFile(path_1.default.join(packageRoot, `templates/${template_file}.pug`));
+        Object.assign(data, this.templateContext(req, data));
+        data.title = data.title || `${this.package.name} API Documentation`;
+        data.name = this.package.name;
+        data.version = this.package.version;
+        data.model_list = Object.keys(this.models).sort();
+        data.guide_nav = this.mkdocs.nav || [];
+        data.active_section = data.active_section || "";
+        data.active_guide = data.active_guide || "";
+        data.active_model = data.active_model || "";
+        data.first_guide_url = data.first_guide_url ?? this.getFirstGuideUrl();
+        const body = template(data);
+        res.writeHead(200, {
+            'Content-Length': Buffer.byteLength(body),
+            'Content-Type': 'text/html; charset=utf-8'
+        });
+        res.write(body);
+        res.end();
+    }
+    serveAsset(req, res, next) {
+        try {
+            const file = req.params.file;
+            if (!file || file.includes("..") || file.includes("/") || file.includes("\\")) {
+                return next(new restify_errors_1.default.NotFoundError("Asset not found"));
+            }
+            const ext = path_1.default.extname(file).slice(1).toLowerCase();
+            if (!ASSET_TYPES[ext]) {
+                return next(new restify_errors_1.default.NotFoundError("Asset not found"));
+            }
+            const resolved = path_1.default.resolve(assetsDir, file);
+            const relative = path_1.default.relative(assetsDir, resolved);
+            if (relative.startsWith("..") || path_1.default.isAbsolute(relative)) {
+                return next(new restify_errors_1.default.NotFoundError("Asset not found"));
+            }
+            if (!fs_1.default.existsSync(resolved)) {
+                return next(new restify_errors_1.default.NotFoundError("Asset not found"));
+            }
+            const body = fs_1.default.readFileSync(resolved);
+            res.writeHead(200, {
+                'Content-Length': body.length,
+                'Content-Type': ASSET_TYPES[ext],
+                'Cache-Control': 'public, max-age=3600',
+            });
+            res.write(body);
+            res.end();
+        }
+        catch (err) {
+            console.error(err);
+            return next(new restify_errors_1.default.InternalServerError(err.toString()));
+        }
+    }
+    async metaModels(req, res) {
+        try {
+            const models = await getModelFileContents(this.config.model_dir);
+            res.send(models);
+        }
+        catch (err) {
+            console.error(err);
+            return new restify_errors_1.default.InternalServerError(err.toString());
+        }
+    }
+    metaModel(req, res, next) {
+        try {
+            if (!req.Model) {
+                return new restify_errors_1.default.NotFoundError("Model not found");
+            }
+            res.send(req.Model.schema.paths);
+            next();
+        }
+        catch (err) {
+            console.error(err);
+            return new restify_errors_1.default.InternalServerError(err.toString());
+        }
+    }
+    dbDiagram(req, res, next) {
+        try {
+            res.send(this.models);
+            next();
+        }
+        catch (err) {
+            return new restify_errors_1.default.InternalServerError(err.toString());
+        }
+    }
+    renderLogin(res, data = {}) {
+        this.renderTemplate(res, "login", {
+            active_section: "login",
+            hide_sidebar: true,
+            title: `Sign in · ${this.package.name}`,
+            ...data,
+        });
+    }
+    frontPage(req, res, next) {
+        try {
+            this.renderTemplate(res, "index", {
+                active_section: "home",
+                features: LANDING_FEATURES,
+                base_url: this.getBaseUrl(req),
+            }, req);
+        }
+        catch (err) {
+            console.error(err);
+            return next(new restify_errors_1.default.InternalServerError(err.toString()));
+        }
+    }
+    md(req, res, next) {
+        try {
+            const docFile = req.params.md_doc;
+            if (!docFile || docFile.includes("..") || docFile.includes("/") || docFile.includes("\\")) {
+                return next(new restify_errors_1.default.NotFoundError("Document not found"));
+            }
+            const filePath = path_1.default.join(packageRoot, "docs", docFile);
+            const body = fs_1.default.readFileSync(filePath, "utf8");
+            const md_contents = md.render(body);
+            const titleMatch = body.match(/^#\s+(.+)$/m);
+            this.renderTemplate(res, "md", {
+                md_contents,
+                active_section: "guides",
+                active_guide: docFile,
+                title: titleMatch ? `${titleMatch[1]} · ${this.package.name}` : undefined,
+            }, req);
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                return next(new restify_errors_1.default.NotFoundError("Document not found"));
+            }
+            console.error(err);
+            return next(new restify_errors_1.default.InternalServerError(err.toString()));
+        }
+    }
+    apiIndex(req, res, next) {
+        try {
+            const model_summaries = Object.keys(this.models).sort().map(slug => {
+                const model = this.models[slug];
+                const perms = model.schema.opts?.perms;
+                return {
+                    slug,
+                    collection: model.collection.name,
+                    perms: perms || null,
+                };
+            });
+            this.renderTemplate(res, "api", {
+                active_section: "api",
+                model_summaries,
+                title: `API · ${this.package.name}`,
+            }, req);
+        }
+        catch (err) {
+            console.error(err);
+            return next(new restify_errors_1.default.InternalServerError(err.toString()));
+        }
+    }
+    model(req, res, next) {
+        try {
+            const model_slug = req.params.modelname;
+            const model = this.models[model_slug];
+            if (!model) {
+                return next(new restify_errors_1.default.NotFoundError(`Model ${model_slug} not found`));
+            }
+            const fields = Object.keys(model.schema.paths);
+            fields.sort();
+            const perms = model.schema.opts?.perms;
+            const safeFields = {};
+            fields.forEach(fieldName => {
+                safeFields[fieldName] = serializeField(model.schema.paths[fieldName]);
+            });
+            this.renderTemplate(res, "model", {
+                model,
+                model_slug,
+                collection_name: model.collection.name,
+                fields,
+                perms,
+                safeFields,
+                endpoints: buildEndpoints(model_slug),
+                active_section: "api",
+                active_model: model_slug,
+                title: `${model_slug} · API · ${this.package.name}`,
+            }, req);
+        }
+        catch (err) {
+            console.error(err);
+            return next(new restify_errors_1.default.InternalServerError(err.toString()));
+        }
+    }
+}
+module.exports = Docs;
+//# sourceMappingURL=docs.js.map

package/dist/libs/docs.js.map

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

package/dist/libs/groups.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=groups.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../src/libs/groups.ts"],"names":[],"mappings":""}