notex-companion 0.1.0

package/dist/context.d.ts

@@ -0,0 +1,6 @@
+import type { Degraded, GraphEdge, GraphNode, GraphStamp, Truncated } from "./types.js";
+export type BuildContextOptions = {
+    truncated?: Truncated;
+    degraded?: Degraded;
+};
+export declare function buildContext(question: string, stamp: GraphStamp, nodes: GraphNode[], edges: GraphEdge[], opts?: BuildContextOptions): string;

package/dist/cors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `--origin` is repeatable, defaulting to the production Notex origin (companion-api.md §5);
+ * `http://localhost:3000` is added on top of that only outside production.
+ */
+export declare function resolveOrigins(configured: string[], nodeEnv: string | undefined, productionOrigin?: string): string[];
+/** Headers for a real (non-preflight) response. `{}` when the origin isn't an exact allowlist match. */
+export declare function corsHeaders(origins: string[], requestOrigin: string | undefined): Record<string, string>;
+/** Full preflight header set (companion-api.md §5). `{}` when the origin isn't an exact allowlist match. */
+export declare function preflightHeaders(origins: string[], requestOrigin: string | undefined): Record<string, string>;

package/dist/footer.d.ts

@@ -0,0 +1,12 @@
+import type { Degraded, GraphStamp, Truncated } from "./types.js";
+export type FooterSource = {
+    file: string;
+    location: string;
+};
+export type BuildFooterOptions = {
+    /** YYYY-MM-DD. Defaults to today. */
+    draftDate?: string;
+    truncated?: Truncated;
+    degraded?: Degraded;
+};
+export declare function buildFooter(stamp: GraphStamp, sources: FooterSource[], opts?: BuildFooterOptions): string;

package/dist/graph.d.ts

@@ -0,0 +1,39 @@
+import { type ScoreIndexEntry } from "./scoring.js";
+import { type GraphEdge, type GraphNode, type GraphStamp } from "./types.js";
+type RawNode = {
+    id: string;
+    label: string;
+    norm_label?: string;
+    source_file: string;
+    source_location: string;
+    file_type: string;
+    community: number | null;
+    community_name?: string;
+};
+type RawEdge = {
+    source: string;
+    target: string;
+    relation: string;
+    weight: number;
+    confidence: string;
+    source_file: string;
+    source_location: string;
+};
+export type AdjacencyEntry = {
+    other: string;
+    edge: RawEdge;
+};
+export type GraphIndex = {
+    stamp: GraphStamp;
+    nodesById: Map<string, RawNode>;
+    edges: RawEdge[];
+    /** Undirected — the graph is `"directed": false` (companion-api.md §2.2). */
+    adjacency: Map<string, AdjacencyEntry[]>;
+    scoreIndex: ScoreIndexEntry[];
+    project: (n: RawNode) => GraphNode;
+    projectEdge: (e: RawEdge) => GraphEdge;
+};
+/** `graphRoot` expressed relative to `checkoutPath`; "" when they are the same or graphRoot is outside it. */
+export declare function rootPrefixFor(checkoutPath: string, graphRoot: string): string;
+export declare function loadGraph(checkoutPath: string): GraphIndex;
+export {};

package/dist/http.d.ts

@@ -0,0 +1,21 @@
+import type { GraphIndex } from "./graph.js";
+import { OpError } from "./types.js";
+/**
+ * The graph is loaded once into memory (companion-api.md §3); `loading` covers the window
+ * before that finishes, `error` covers a permanently unreadable graph.json (never a crash).
+ */
+export type GraphState = {
+    kind: "loading";
+} | {
+    kind: "ready";
+    index: GraphIndex;
+} | {
+    kind: "error";
+    error: OpError;
+};
+export type HandlerOptions = {
+    token: string;
+    origins: string[];
+    getGraphState: () => GraphState;
+};
+export declare function createHandler(opts: HandlerOptions): (req: Request) => Promise<Response>;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types.js";
+export * from "./ops.js";
+export { loadGraph, type GraphIndex } from "./graph.js";
+export { serve, type ServeHandle, type ServeOptions } from "./serve.js";
+export { createHandler, type GraphState, type HandlerOptions } from "./http.js";