mates-fullstack 1.0.0-beta.1

package/dist/docs-generator.js

@@ -0,0 +1,557 @@
+/**
+ * mates-fullstack — docs-generator.ts
+ *
+ * Generates interactive API documentation for all RPC functions in server/api/
+ * by statically analysing TypeScript source files with ts-morph.
+ *
+ * ts-morph is an optional peer dependency. If it is not installed this module
+ * returns [] gracefully — the server never crashes.
+ *
+ * Usage:
+ *   import { generateDocs } from "./docs-generator.js";
+ *   const docs = await generateDocs("/abs/path/to/server/api", "/abs/path/to/shared/types");
+ */
+import { createRequire } from "node:module";
+import path from "node:path";
+// ─── Reserved export names (mirrors rpc-registry.ts) ─────────────────────────
+const RESERVED_NAMES = new Set([
+    "default",
+    "loader",
+    "meta",
+    "layout",
+    "staticPaths",
+    "onConnect",
+    "onDisconnect",
+    "then",
+    "catch",
+    "finally",
+]);
+// ─── Cache ────────────────────────────────────────────────────────────────────
+let _cachedDocs = null;
+let _cachedDocsKey = null;
+let _lastScanTime = 0;
+const CACHE_TTL_MS = 5000;
+export function clearDocsCache() {
+    _cachedDocs = null;
+    _cachedDocsKey = null;
+    _lastScanTime = 0;
+}
+// ─── ts-morph availability ────────────────────────────────────────────────────
+let _tsMorphWarned = false;
+export async function isTsMorphAvailable(projectRoot) {
+    return (await _loadTsMorph(projectRoot, false)) !== null;
+}
+async function _loadTsMorph(projectRoot, warn = true) {
+    if (projectRoot) {
+        try {
+            const requireFromProject = createRequire(path.resolve(projectRoot, "package.json"));
+            return requireFromProject("ts-morph");
+        }
+        catch {
+            // Fall back to resolving from mates-fullstack itself.
+        }
+    }
+    try {
+        // @ts-ignore — ts-morph is an optional peer dep; may not be resolvable
+        return await import("ts-morph");
+    }
+    catch {
+        if (warn && !_tsMorphWarned) {
+            _tsMorphWarned = true;
+            console.warn("[mates-fullstack] docs-generator: ts-morph is not installed. " +
+                "API documentation generation is disabled. " +
+                "Install it with: npm install --save-dev ts-morph");
+        }
+        return null;
+    }
+}
+// ─── Main entry point ─────────────────────────────────────────────────────────
+/**
+ * Parse server/api/ with ts-morph and return a RouteDoc for every registered
+ * RPC function. Results are cached for 5 seconds (TTL covers dev hot-reload).
+ *
+ * Returns [] immediately if ts-morph is not installed.
+ */
+export async function generateDocs(apiDir, sharedTypesDir, projectRoot) {
+    const cacheKey = JSON.stringify({
+        apiDir: path.resolve(apiDir),
+        sharedTypesDir: sharedTypesDir ? path.resolve(sharedTypesDir) : null,
+        projectRoot: projectRoot ? path.resolve(projectRoot) : null,
+    });
+    // Return cached result if still fresh
+    if (_cachedDocs !== null &&
+        _cachedDocsKey === cacheKey &&
+        Date.now() - _lastScanTime < CACHE_TTL_MS) {
+        return _cachedDocs;
+    }
+    // ts-morph is an optional peer dep — types are accessed via `any` at runtime.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const TsMorph = await _loadTsMorph(projectRoot);
+    if (!TsMorph)
+        return [];
+    const { Project } = TsMorph;
+    // Build a ts-morph project from the api sources (+ optional shared types)
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const project = new Project({
+        compilerOptions: {
+            allowJs: true,
+            checkJs: true,
+            strict: false,
+            skipLibCheck: true,
+        },
+        skipAddingFilesFromTsConfig: true,
+    });
+    project.addSourceFilesAtPaths([
+        `${apiDir}/**/*.ts`,
+        `${apiDir}/**/*.tsx`,
+        `${apiDir}/**/*.js`,
+        `${apiDir}/**/*.jsx`,
+    ]);
+    if (sharedTypesDir) {
+        project.addSourceFilesAtPaths([
+            `${sharedTypesDir}/**/*.ts`,
+            `${sharedTypesDir}/**/*.tsx`,
+            `${sharedTypesDir}/**/*.js`,
+            `${sharedTypesDir}/**/*.jsx`,
+        ]);
+    }
+    const docs = [];
+    for (const sourceFile of project.getSourceFiles()) {
+        const filePath = sourceFile.getFilePath();
+        // Only process files that live inside apiDir
+        const absApiDir = path.resolve(apiDir);
+        const absFilePath = path.resolve(filePath);
+        if (!absFilePath.startsWith(absApiDir + path.sep))
+            continue;
+        // Skip test / spec / private files
+        const basename = path.basename(filePath);
+        if (basename.startsWith("_") || basename.startsWith("."))
+            continue;
+        if (basename.includes(".test.") || basename.includes(".spec."))
+            continue;
+        try {
+            const fileDocs = _processSourceFile(sourceFile, apiDir, filePath, project);
+            docs.push(...fileDocs);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`[mates-fullstack] docs-generator: skipping ${path.relative(apiDir, filePath)} — ${msg}`);
+        }
+    }
+    _cachedDocs = docs;
+    _cachedDocsKey = cacheKey;
+    _lastScanTime = Date.now();
+    return docs;
+}
+// ─── Source-file processing ───────────────────────────────────────────────────
+// All ts-morph node types are `any` here — ts-morph is an optional dep and
+// may not be present in the project consuming this package.
+function _processSourceFile(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+sourceFile, apiDir, filePath, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+project) {
+    const results = [];
+    const fileRelPath = path.relative(apiDir, filePath);
+    const isTypeScriptFile = /\.(ts|tsx)$/i.test(filePath);
+    // ── Regular function declarations ──────────────────────────────────────────
+    for (const fn of sourceFile.getFunctions()) {
+        if (!fn.isExported())
+            continue;
+        const fnName = fn.getName();
+        if (!fnName)
+            continue;
+        if (RESERVED_NAMES.has(fnName))
+            continue;
+        if (!fn.isAsync())
+            continue;
+        const url = _deriveRpcUrl(apiDir, filePath, fnName);
+        const description = _extractDescription(fn);
+        const tags = _extractTags(fn, "tags");
+        const paramDescriptions = _extractParamDescriptions(fn);
+        const firstArg = isTypeScriptFile
+            ? _resolvePayloadFromParams(fn.getParameters(), paramDescriptions, project)
+            : null;
+        const payload = firstArg?.type ?? null;
+        const response = isTypeScriptFile
+            ? _resolveResponseType(fn.getReturnType(), project, Boolean(fn.getReturnTypeNode?.()))
+            : null;
+        const signature = isTypeScriptFile
+            ? _buildSignature(fnName, firstArg?.name ?? null, payload, response)
+            : `${fnName}(...)`;
+        results.push({
+            url,
+            fnName,
+            filePath,
+            fileRelPath,
+            description,
+            typed: isTypeScriptFile,
+            firstArgName: firstArg?.name ?? null,
+            payload,
+            response,
+            signature,
+            tags,
+        });
+    }
+    // ── Arrow / function-expression variable declarations ──────────────────────
+    for (const varDecl of sourceFile.getVariableDeclarations()) {
+        const varStatement = varDecl.getVariableStatement();
+        if (!varStatement)
+            continue;
+        if (!varStatement.isExported())
+            continue;
+        const fnName = varDecl.getName();
+        if (!fnName)
+            continue;
+        if (RESERVED_NAMES.has(fnName))
+            continue;
+        const initializer = varDecl.getInitializer();
+        if (!initializer)
+            continue;
+        const kind = initializer.getKindName();
+        if (kind !== "ArrowFunction" && kind !== "FunctionExpression")
+            continue;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const arrowFn = initializer;
+        if (!arrowFn.isAsync())
+            continue;
+        const url = _deriveRpcUrl(apiDir, filePath, fnName);
+        // JSDoc lives on the variable statement for `const foo = async () => ...`
+        const jsDocs = varStatement.getJsDocs();
+        const description = jsDocs
+            .map((d) => d.getDescription().trim())
+            .join("\n")
+            .trim();
+        const tags = _extractTagsFromJsDocs(jsDocs, "tags");
+        const paramDescriptions = _extractParamDescriptionsFromJsDocs(jsDocs);
+        const firstArg = isTypeScriptFile
+            ? _resolvePayloadFromParams(arrowFn.getParameters(), paramDescriptions, project)
+            : null;
+        const payload = firstArg?.type ?? null;
+        const response = isTypeScriptFile
+            ? _resolveResponseType(arrowFn.getReturnType(), project, Boolean(arrowFn.getReturnTypeNode?.()))
+            : null;
+        const signature = isTypeScriptFile
+            ? _buildSignature(fnName, firstArg?.name ?? null, payload, response)
+            : `${fnName}(...)`;
+        results.push({
+            url,
+            fnName,
+            filePath,
+            fileRelPath,
+            description,
+            typed: isTypeScriptFile,
+            firstArgName: firstArg?.name ?? null,
+            payload,
+            response,
+            signature,
+            tags,
+        });
+    }
+    return results;
+}
+// ─── URL derivation (mirrors rpc-registry.ts::deriveRpcUrl) ──────────────────
+function _deriveRpcUrl(apiDir, filePath, fnName) {
+    const rel = path.relative(apiDir, filePath);
+    const withoutExt = rel.replace(/\.(ts|js|tsx|jsx)$/, "");
+    let modulePath = withoutExt.split(path.sep).join("/");
+    if (modulePath.endsWith("/index")) {
+        modulePath = modulePath.slice(0, -6);
+    }
+    else if (modulePath === "index") {
+        modulePath = "";
+    }
+    const parts = ["api"];
+    if (modulePath)
+        parts.push(modulePath);
+    parts.push(fnName);
+    return "/" + parts.join("/");
+}
+// ─── JSDoc helpers ────────────────────────────────────────────────────────────
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function _extractDescription(fn) {
+    const docs = fn.getJsDocs();
+    return docs
+        .map((d) => d.getDescription().trim())
+        .join("\n")
+        .trim();
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function _extractTags(fn, tagName) {
+    return _extractTagsFromJsDocs(fn.getJsDocs(), tagName);
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function _extractTagsFromJsDocs(jsDocs, tagName) {
+    const tags = [];
+    for (const doc of jsDocs) {
+        for (const tag of doc.getTags()) {
+            if (tag.getTagName() === tagName) {
+                const text = tag.getCommentText()?.trim();
+                if (text) {
+                    // Allow comma-separated tags on one line: @tags users, auth
+                    tags.push(...text
+                        .split(",")
+                        .map((t) => t.trim())
+                        .filter(Boolean));
+                }
+            }
+        }
+    }
+    return tags;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function _extractParamDescriptions(fn) {
+    return _extractParamDescriptionsFromJsDocs(fn.getJsDocs());
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function _extractParamDescriptionsFromJsDocs(jsDocs) {
+    const map = new Map();
+    for (const doc of jsDocs) {
+        for (const tag of doc.getTags()) {
+            if (tag.getTagName() === "param") {
+                // JSDocParameterTag exposes getName()
+                if (typeof tag.getName === "function") {
+                    const name = tag.getName();
+                    const comment = tag.getCommentText()?.trim() ?? "";
+                    if (name)
+                        map.set(name, comment);
+                }
+            }
+        }
+    }
+    return map;
+}
+// ─── Payload extraction ───────────────────────────────────────────────────────
+function _resolvePayloadFromParams(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+params, paramDescriptions, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+project) {
+    // Find the first parameter that is not ctx / Context
+    for (const param of params) {
+        const name = param.getName();
+        if (name === "ctx")
+            continue;
+        const typeNode = param.getTypeNode();
+        const inferredType = param.getType();
+        const typeText = typeNode
+            ? typeNode.getText()
+            : inferredType.getText();
+        if (typeText === "Context")
+            continue;
+        const confidence = _confidenceFromType(typeText, Boolean(typeNode));
+        const shape = _buildTypeShape(typeText, inferredType, project, new Set(), 0, confidence);
+        if (shape?.fields) {
+            for (const field of shape.fields) {
+                const description = paramDescriptions.get(field.name);
+                if (description)
+                    field.description = description;
+            }
+        }
+        return shape ? { name, type: shape } : null;
+    }
+    return null;
+}
+// ─── Response extraction ──────────────────────────────────────────────────────
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function _resolveResponseType(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+returnType, project, hasExplicitReturnType) {
+    // Unwrap Promise<T>
+    let inner = returnType;
+    const typeText = returnType.getText();
+    if (typeText.startsWith("Promise<")) {
+        const typeArgs = returnType.getTypeArguments();
+        if (typeArgs.length > 0) {
+            inner = typeArgs[0];
+        }
+    }
+    const innerText = inner.getText();
+    // void / undefined → no data returned
+    if (innerText === "void" || innerText === "undefined")
+        return null;
+    const confidence = _confidenceFromType(innerText, hasExplicitReturnType);
+    return _buildTypeShape(innerText, inner, project, new Set(), 0, confidence);
+}
+// ─── Signature / confidence helpers ──────────────────────────────────────────
+function _buildSignature(fnName, firstArgName, payload, response) {
+    const arg = firstArgName
+        ? `${firstArgName}: ${payload ? _shapeSignature(payload) : "unknown"}`
+        : "";
+    const returnType = response ? _shapeSignature(response) : "void";
+    return `${fnName}(${arg}): Promise<${returnType}>`;
+}
+function _confidenceFromType(typeText, hasExplicitAnnotation) {
+    const clean = typeText.trim();
+    if (clean === "" ||
+        clean === "any" ||
+        clean === "unknown" ||
+        clean === "object") {
+        return "unknown";
+    }
+    return hasExplicitAnnotation ? "explicit" : "inferred";
+}
+function _displayTypeName(typeName) {
+    return typeName
+        .replace(/import\(["'][^)]+["']\)\./g, "")
+        .replace(/import\(["'][^)]+["']\)/g, "")
+        .replace(/Promise<(.+)>/g, "$1");
+}
+function _shapeSignature(shape) {
+    if (shape.kind === "array" && shape.fields && shape.fields.length > 0) {
+        return `${_fieldsToInlineType(shape.fields)}[]`;
+    }
+    if (shape.kind === "object" && shape.fields && shape.fields.length > 0) {
+        return _fieldsToInlineType(shape.fields);
+    }
+    return _displayTypeName(shape.typeName);
+}
+function _fieldsToInlineType(fields) {
+    return `{ ${fields
+        .map((field) => {
+        const name = field.required ? field.name : `${field.name}?`;
+        return `${name}: ${_displayTypeName(field.type)}`;
+    })
+        .join("; ")} }`;
+}
+// ─── Type shape builder ───────────────────────────────────────────────────────
+const MAX_DEPTH = 3;
+const TRIVIAL_PAYLOAD_TYPES = new Set([
+    "{}",
+    "unknown",
+    "any",
+    "Record<string, unknown>",
+    "Record<string, any>",
+    "object",
+]);
+const PRIMITIVE_TYPES = new Set([
+    "string",
+    "number",
+    "boolean",
+    "bigint",
+    "symbol",
+    "null",
+    "void",
+    "undefined",
+    "never",
+]);
+function _buildTypeShape(typeText, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+project, visiting, depth, confidence) {
+    // Empty object payloads are meaningful in RPC docs: `payload: {}` means the
+    // function accepts no fields, not that the argument type is unknown.
+    if (typeText.trim() === "{}") {
+        return { kind: "object", typeName: "{}", fields: [], confidence };
+    }
+    // Trivial / uninteresting shapes
+    if (TRIVIAL_PAYLOAD_TYPES.has(typeText.trim())) {
+        return { kind: "unknown", typeName: "unknown", confidence };
+    }
+    // Hard depth limit to prevent runaway recursion
+    if (depth >= MAX_DEPTH) {
+        return { kind: "unknown", typeName: typeText, confidence };
+    }
+    // Primitive
+    if (PRIMITIVE_TYPES.has(typeText.trim())) {
+        return { kind: "primitive", typeName: typeText.trim(), confidence };
+    }
+    // Literal types (string, number, boolean literals)
+    if (type.isStringLiteral() ||
+        type.isNumberLiteral() ||
+        type.isBooleanLiteral()) {
+        return { kind: "primitive", typeName: typeText, confidence };
+    }
+    // Array — T[] or Array<T>
+    if (type.isArray()) {
+        const elementType = type.getArrayElementType();
+        const elementShape = elementType
+            ? _buildTypeShape(elementType.getText(), elementType, project, visiting, depth + 1, confidence)
+            : null;
+        const itemType = elementShape
+            ? _shapeSignature(elementShape)
+            : elementType
+                ? _displayTypeName(elementType.getText())
+                : "unknown";
+        return {
+            kind: "array",
+            typeName: `${itemType}[]`,
+            itemType,
+            fields: elementShape?.fields,
+            confidence,
+        };
+    }
+    // Tuple — treat as an array of the first element's type
+    if (type.isTuple()) {
+        const tupleElements = type.getTupleElements();
+        const firstElement = tupleElements[0];
+        const elementShape = firstElement
+            ? _buildTypeShape(firstElement.getText(), firstElement, project, visiting, depth + 1, confidence)
+            : null;
+        const itemType = elementShape
+            ? _shapeSignature(elementShape)
+            : firstElement
+                ? _displayTypeName(firstElement.getText())
+                : "unknown";
+        return {
+            kind: "array",
+            typeName: `${itemType}[]`,
+            itemType,
+            fields: elementShape?.fields,
+            confidence,
+        };
+    }
+    // Union — string | null, etc.
+    if (type.isUnion()) {
+        return { kind: "union", typeName: typeText, confidence };
+    }
+    // Intersection — show as object but don't try to expand members
+    if (type.isIntersection()) {
+        return { kind: "object", typeName: typeText, confidence };
+    }
+    // Object / interface — expand properties one level at a time
+    if (type.isObject() || type.isInterface()) {
+        const symbolName = type.getSymbol()?.getName() ?? typeText;
+        // Cycle detection
+        if (visiting.has(symbolName)) {
+            return {
+                kind: "unknown",
+                typeName: `${symbolName} (circular)`,
+                confidence,
+            };
+        }
+        // Skip well-known built-in complex types that shouldn't be expanded
+        const skipBuiltins = /^(Promise|Map|Set|WeakMap|WeakSet|Date|RegExp|Error|Function|Symbol)\b/;
+        if (skipBuiltins.test(typeText)) {
+            return { kind: "primitive", typeName: typeText, confidence };
+        }
+        const nextVisiting = new Set(visiting);
+        nextVisiting.add(symbolName);
+        const props = type.getProperties();
+        if (props.length === 0) {
+            return { kind: "object", typeName: typeText, confidence };
+        }
+        const fields = [];
+        for (const prop of props) {
+            const propName = prop.getName();
+            // Skip symbol properties and TS internal members
+            if (propName.startsWith("[") || propName.startsWith("__"))
+                continue;
+            const declarations = prop.getDeclarations();
+            const locationNode = declarations.length > 0 ? declarations[0] : project.getSourceFiles()[0];
+            const propType = prop.getTypeAtLocation(locationNode);
+            const propTypeText = _displayTypeName(propType.getText());
+            const required = !prop.isOptional();
+            fields.push({ name: propName, type: propTypeText, required });
+        }
+        return { kind: "object", typeName: typeText, fields, confidence };
+    }
+    // any / unknown
+    if (type.isAny() || type.isUnknown()) {
+        return { kind: "unknown", typeName: "unknown", confidence: "unknown" };
+    }
+    // Fallback
+    return { kind: "primitive", typeName: typeText, confidence };
+}
+//# sourceMappingURL=docs-generator.js.map

package/dist/docs-generator.js.map

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

package/dist/docs-page.d.ts

@@ -0,0 +1,20 @@
+/**
+ * mates-fullstack — docs-page.ts
+ *
+ * Builds and serves a self-contained HTML API documentation page at /api/docs.
+ * Takes RouteDoc objects from docs-generator.ts and renders a dark-themed,
+ * developer-focused interactive docs UI with a Try-it panel.
+ */
+/// <reference types="node" />
+import type { ServerResponse } from "node:http";
+import type { RouteDoc } from "./docs-generator.js";
+/**
+ * Build a complete self-contained HTML string for the /api/docs page.
+ * No external dependencies — all CSS and JS are inlined.
+ */
+export declare function buildDocsHtml(docs: RouteDoc[], dev: boolean): string;
+/**
+ * Write the docs HTML page to an HTTP ServerResponse.
+ */
+export declare function serveDocsPage(res: ServerResponse, docs: RouteDoc[], dev: boolean): void;
+//# sourceMappingURL=docs-page.d.ts.map

package/dist/docs-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-page.d.ts","sourceRoot":"","sources":["../src/docs-page.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAuB,MAAM,qBAAqB,CAAC;AAKzE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CA0DpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,QAAQ,EAAE,EAChB,GAAG,EAAE,OAAO,GACX,IAAI,CAON"}