code-kg 0.1.0

package/dist/query/query-dsl.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_QUERY_DEPTH = void 0;
+exports.isReferencesQuery = isReferencesQuery;
+exports.isDependenciesQuery = isDependenciesQuery;
+exports.normalizeDepth = normalizeDepth;
+exports.canonicalizeQuery = canonicalizeQuery;
+exports.parseGraphQuery = parseGraphQuery;
+exports.MAX_QUERY_DEPTH = 32;
+function isReferencesQuery(query) {
+    return query.type === "references";
+}
+function isDependenciesQuery(query) {
+    return query.type === "dependencies";
+}
+function normalizeDepth(depth, fallback = 1) {
+    if (!Number.isFinite(depth)) {
+        return fallback;
+    }
+    const normalized = Math.floor(Number(depth));
+    if (normalized < 0) {
+        return 0;
+    }
+    if (normalized > exports.MAX_QUERY_DEPTH) {
+        return exports.MAX_QUERY_DEPTH;
+    }
+    return normalized;
+}
+function canonicalizeQuery(query) {
+    if (isReferencesQuery(query)) {
+        return {
+            type: "references",
+            symbol: query.symbol.trim(),
+            depth: normalizeDepth(query.depth, 1),
+        };
+    }
+    const target = query.target?.trim();
+    return {
+        type: "dependencies",
+        target: target ? target : undefined,
+        depth: normalizeDepth(query.depth, 1),
+    };
+}
+function assertObject(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("Query must be an object.");
+    }
+}
+function parseGraphQuery(input) {
+    assertObject(input);
+    const type = input.type;
+    if (type === "references") {
+        const symbol = typeof input.symbol === "string" ? input.symbol.trim() : "";
+        if (!symbol) {
+            throw new Error("References query requires a non-empty symbol.");
+        }
+        const depth = typeof input.depth === "number" ? input.depth : undefined;
+        return canonicalizeQuery({
+            type: "references",
+            symbol,
+            depth,
+        });
+    }
+    if (type === "dependencies") {
+        const target = typeof input.target === "string" ? input.target.trim() : undefined;
+        const depth = typeof input.depth === "number" ? input.depth : undefined;
+        return canonicalizeQuery({
+            type: "dependencies",
+            target,
+            depth,
+        });
+    }
+    throw new Error(`Unsupported query type: ${String(type)}`);
+}
+//# sourceMappingURL=query-dsl.js.map

package/dist/query/query-dsl.js.map

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

package/dist/query/query-engine.d.ts

@@ -0,0 +1,32 @@
+import { type GraphQuery } from "./query-dsl";
+export interface QueryNode {
+    id: string;
+    type: string;
+    name: string | null;
+    path: string | null;
+    props: Record<string, unknown>;
+}
+export interface QueryEdge {
+    id: string;
+    fromId: string;
+    toId: string;
+    type: string;
+    props: Record<string, unknown>;
+}
+export interface QueryGraph {
+    nodes: QueryNode[];
+    edges: QueryEdge[];
+}
+export interface QueryResult {
+    query: GraphQuery;
+    nodes: QueryNode[];
+    edges: QueryEdge[];
+}
+export interface QueryDataSource {
+    findNodesByName(symbol: string): QueryNode[];
+    getNodeById(nodeId: string): QueryNode | null;
+    getIncomingEdges(nodeId: string): QueryEdge[];
+    getOutgoingEdges(nodeId: string): QueryEdge[];
+    getFileDependencyGraph(): QueryGraph;
+}
+export declare function executeDeterministicQuery(rawQuery: GraphQuery, dataSource: QueryDataSource): QueryResult;

package/dist/query/query-engine.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeDeterministicQuery = executeDeterministicQuery;
+const query_dsl_1 = require("./query-dsl");
+const REFERENCE_EDGE_TYPES = new Set(["REFERENCES", "CALLS"]);
+function sortNodes(nodes) {
+    return [...nodes].sort((left, right) => left.id.localeCompare(right.id));
+}
+function sortEdges(edges) {
+    return [...edges].sort((left, right) => left.id.localeCompare(right.id));
+}
+function executeReferencesQuery(query, dataSource) {
+    const seeds = sortNodes(dataSource.findNodesByName(query.symbol));
+    const nodeById = new Map(seeds.map((node) => [node.id, node]));
+    const edgeById = new Map();
+    const queue = [];
+    const bestRemaining = new Map();
+    for (const seed of seeds) {
+        const remaining = query.depth ?? 1;
+        queue.push({ nodeId: seed.id, remaining });
+        bestRemaining.set(seed.id, remaining);
+    }
+    while (queue.length > 0) {
+        const next = queue.shift();
+        if (!next || next.remaining <= 0) {
+            continue;
+        }
+        const incoming = sortEdges(dataSource.getIncomingEdges(next.nodeId)).filter((edge) => REFERENCE_EDGE_TYPES.has(edge.type.toUpperCase()));
+        for (const edge of incoming) {
+            edgeById.set(edge.id, edge);
+            const fromNode = dataSource.getNodeById(edge.fromId);
+            if (!fromNode) {
+                continue;
+            }
+            nodeById.set(fromNode.id, fromNode);
+            const remaining = next.remaining - 1;
+            const currentBest = bestRemaining.get(fromNode.id) ?? -1;
+            if (remaining > currentBest) {
+                bestRemaining.set(fromNode.id, remaining);
+                queue.push({ nodeId: fromNode.id, remaining });
+            }
+        }
+    }
+    return {
+        query,
+        nodes: sortNodes(nodeById.values()),
+        edges: sortEdges(edgeById.values()),
+    };
+}
+function executeDependenciesQuery(query, dataSource) {
+    const graph = dataSource.getFileDependencyGraph();
+    const allNodes = sortNodes(graph.nodes);
+    const allEdges = sortEdges(graph.edges);
+    if (!query.target) {
+        return {
+            query,
+            nodes: allNodes,
+            edges: allEdges,
+        };
+    }
+    const startNodes = allNodes.filter((node) => node.id === query.target || node.path === query.target || node.name === query.target);
+    if (startNodes.length === 0) {
+        return {
+            query,
+            nodes: [],
+            edges: [],
+        };
+    }
+    const nodeById = new Map(allNodes.map((node) => [node.id, node]));
+    const outgoingByNode = new Map();
+    for (const edge of allEdges) {
+        const existing = outgoingByNode.get(edge.fromId);
+        if (existing) {
+            existing.push(edge);
+        }
+        else {
+            outgoingByNode.set(edge.fromId, [edge]);
+        }
+    }
+    for (const [nodeId, edges] of outgoingByNode) {
+        outgoingByNode.set(nodeId, sortEdges(edges));
+    }
+    const depth = query.depth ?? 1;
+    const visitedNodes = new Set(startNodes.map((node) => node.id));
+    const visitedEdges = new Set();
+    const queue = startNodes.map((node) => ({
+        nodeId: node.id,
+        remaining: depth,
+    }));
+    const bestRemaining = new Map(startNodes.map((node) => [node.id, depth]));
+    while (queue.length > 0) {
+        const next = queue.shift();
+        if (!next || next.remaining <= 0) {
+            continue;
+        }
+        const outgoing = outgoingByNode.get(next.nodeId) ?? [];
+        for (const edge of outgoing) {
+            visitedEdges.add(edge.id);
+            visitedNodes.add(edge.toId);
+            const remaining = next.remaining - 1;
+            const currentBest = bestRemaining.get(edge.toId) ?? -1;
+            if (remaining > currentBest) {
+                bestRemaining.set(edge.toId, remaining);
+                queue.push({ nodeId: edge.toId, remaining });
+            }
+        }
+    }
+    const edgeById = new Map(allEdges.map((edge) => [edge.id, edge]));
+    return {
+        query,
+        nodes: sortNodes([...visitedNodes]
+            .map((nodeId) => nodeById.get(nodeId))
+            .filter((node) => Boolean(node))),
+        edges: sortEdges([...visitedEdges]
+            .map((edgeId) => edgeById.get(edgeId))
+            .filter((edge) => Boolean(edge))),
+    };
+}
+function executeDeterministicQuery(rawQuery, dataSource) {
+    const query = (0, query_dsl_1.canonicalizeQuery)(rawQuery);
+    if ((0, query_dsl_1.isDependenciesQuery)(query)) {
+        return executeDependenciesQuery(query, dataSource);
+    }
+    return executeReferencesQuery(query, dataSource);
+}
+//# sourceMappingURL=query-engine.js.map

package/dist/query/query-engine.js.map

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

package/dist/server/api.d.ts

@@ -0,0 +1,19 @@
+import type { Response } from 'express';
+export interface ApiErrorObject {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+export interface ApiSuccess<T> {
+    ok: true;
+    data: T;
+}
+export interface ApiFailure {
+    ok: false;
+    error: ApiErrorObject;
+}
+export type ApiEnvelope<T> = ApiSuccess<T> | ApiFailure;
+export declare function sendSuccess<T>(res: Response, data: T, status?: number): Response<ApiSuccess<T>>;
+export declare function sendError(res: Response, code: string, message: string, status?: number, details?: unknown): Response<ApiFailure>;
+export declare function getFirstString(value: unknown): string | undefined;
+export declare function toErrorMessage(error: unknown): string;

package/dist/server/api.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendSuccess = sendSuccess;
+exports.sendError = sendError;
+exports.getFirstString = getFirstString;
+exports.toErrorMessage = toErrorMessage;
+function sendSuccess(res, data, status = 200) {
+    return res.status(status).json({ ok: true, data });
+}
+function sendError(res, code, message, status = 400, details) {
+    const error = details === undefined ? { code, message } : { code, message, details };
+    return res.status(status).json({ ok: false, error });
+}
+function getFirstString(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (Array.isArray(value) && typeof value[0] === 'string') {
+        return value[0];
+    }
+    return undefined;
+}
+function toErrorMessage(error) {
+    if (error instanceof Error && error.message) {
+        return error.message;
+    }
+    return 'Unknown internal error';
+}
+//# sourceMappingURL=api.js.map

package/dist/server/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/server/api.ts"],"names":[],"mappings":";;AAoBA,kCAEC;AAED,8BAWC;AAED,wCAUC;AAED,wCAMC;AAnCD,SAAgB,WAAW,CAAI,GAAa,EAAE,IAAO,EAAE,MAAM,GAAG,GAAG;IACjE,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,SAAS,CACvB,GAAa,EACb,IAAY,EACZ,OAAe,EACf,MAAM,GAAG,GAAG,EACZ,OAAiB;IAEjB,MAAM,KAAK,GACT,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAEzE,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,SAAgB,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAgB,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,wBAAwB,CAAC;AAClC,CAAC"}

package/dist/server/app.d.ts

@@ -0,0 +1,7 @@
+import { type Express } from 'express';
+import { type GraphQueryEngine } from './graph-controller';
+export interface CreateAppOptions {
+    engine?: GraphQueryEngine;
+}
+export declare function createApp(options?: CreateAppOptions): Express;
+export default createApp;