@typicalday/firegraph 0.1.0

package/dist/chunk-KFA7G37W.js

@@ -0,0 +1,443 @@
+// src/query-client/client.ts
+import http from "http";
+
+// src/query-client/shaping.ts
+function summarizeRecord(r) {
+  if (!r) return null;
+  const out = { type: r.aType, uid: r.aUid };
+  const data = r.data;
+  if (data && typeof data === "object" && Object.keys(data).length > 0) {
+    out.data = data;
+  }
+  return out;
+}
+function summarizeEdge(r) {
+  if (!r) return null;
+  const out = {
+    fromType: r.aType,
+    fromUid: r.aUid,
+    relation: r.axbType,
+    toType: r.bType,
+    toUid: r.bUid
+  };
+  const data = r.data;
+  if (data && typeof data === "object" && Object.keys(data).length > 0) {
+    out.data = data;
+  }
+  return out;
+}
+
+// src/query-client/config.ts
+import { readFileSync } from "fs";
+import { join } from "path";
+var CONFIG_FILES = ["firegraph.config.ts", "firegraph.config.js", "firegraph.config.mjs"];
+var DEFAULT_PORT = 3884;
+function readEditorPort(cwd) {
+  const dir = cwd ?? process.cwd();
+  for (const name of CONFIG_FILES) {
+    try {
+      const content = readFileSync(join(dir, name), "utf8");
+      const editorBlock = content.match(/editor\s*:\s*\{[^}]*\}/s)?.[0] ?? "";
+      const portMatch = editorBlock.match(/port\s*:\s*(\d+)/);
+      if (portMatch) return parseInt(portMatch[1], 10);
+    } catch {
+      continue;
+    }
+  }
+  return DEFAULT_PORT;
+}
+
+// src/query-client/client.ts
+var QueryClientError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    this.name = "QueryClientError";
+  }
+};
+function requireString(value, name) {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new QueryClientError(`${name} must be a non-empty string`, "VALIDATION_ERROR");
+  }
+}
+function clampInt(value, min, max, fallback) {
+  if (value == null) return fallback;
+  if (!Number.isInteger(value)) {
+    throw new QueryClientError(`limit must be an integer`, "VALIDATION_ERROR");
+  }
+  return Math.max(min, Math.min(max, value));
+}
+function validateSortDir(dir) {
+  if (dir != null && dir !== "asc" && dir !== "desc") {
+    throw new QueryClientError(`sortDir must be 'asc' or 'desc'`, "VALIDATION_ERROR");
+  }
+}
+function httpGet(url) {
+  return new Promise((resolve, reject) => {
+    http.get(url, (res) => {
+      let body = "";
+      res.on("data", (c) => body += c);
+      res.on("end", () => resolve(body));
+    }).on("error", (err) => {
+      reject(new QueryClientError(`Connection failed: ${err.message}`, "CONNECTION_FAILED"));
+    });
+  });
+}
+function httpPost(url, payload) {
+  const parsed = new URL(url);
+  return new Promise((resolve, reject) => {
+    const req = http.request(
+      {
+        hostname: parsed.hostname,
+        port: parsed.port,
+        path: parsed.pathname,
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Content-Length": Buffer.byteLength(payload)
+        }
+      },
+      (res) => {
+        let body = "";
+        res.on("data", (c) => body += c);
+        res.on("end", () => resolve(body));
+      }
+    );
+    req.on("error", (err) => {
+      reject(new QueryClientError(`Connection failed: ${err.message}`, "CONNECTION_FAILED"));
+    });
+    req.write(payload);
+    req.end();
+  });
+}
+function parseTrpcResponse(raw, procedure) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new QueryClientError(
+      `Invalid JSON from ${procedure}: ${raw.slice(0, 200)}`,
+      "SERVER_ERROR"
+    );
+  }
+  if (parsed.error) {
+    const msg = typeof parsed.error === "object" && parsed.error !== null ? parsed.error.message ?? JSON.stringify(parsed.error) : String(parsed.error);
+    throw new QueryClientError(`Server error from ${procedure}: ${msg}`, "SERVER_ERROR");
+  }
+  return parsed.result?.data ?? parsed;
+}
+var QueryClient = class {
+  baseUrl;
+  constructor(options) {
+    const host = options?.host ?? "localhost";
+    const port = options?.port ?? readEditorPort();
+    this.baseUrl = `http://${host}:${port}/api/trpc`;
+  }
+  async query(procedure, input) {
+    const qs = input != null ? `?input=${encodeURIComponent(JSON.stringify(input))}` : "";
+    const url = `${this.baseUrl}/${procedure}${qs}`;
+    const raw = await httpGet(url);
+    return parseTrpcResponse(raw, procedure);
+  }
+  async mutate(procedure, input) {
+    const url = `${this.baseUrl}/${procedure}`;
+    const raw = await httpPost(url, JSON.stringify(input));
+    return parseTrpcResponse(raw, procedure);
+  }
+  // --- Public API ---
+  async getSchema() {
+    const data = await this.query("getSchema");
+    return {
+      nodeTypes: (data.nodeTypes ?? []).map(
+        (t) => typeof t === "object" && t !== null ? t.type : t
+      ),
+      edgeTypes: (data.edgeTypes ?? []).map((t) => {
+        const e = t;
+        return {
+          relation: e.axbType,
+          from: e.aType,
+          to: e.bType,
+          inverseLabel: e.inverseLabel ?? null
+        };
+      })
+    };
+  }
+  async getNodeDetail(input) {
+    requireString(input.uid, "uid");
+    const data = await this.query("getNodeDetail", { uid: input.uid });
+    return {
+      node: summarizeRecord(data.node),
+      outEdges: (data.outEdges ?? []).map(summarizeEdge).filter(Boolean),
+      inEdges: (data.inEdges ?? []).map(summarizeEdge).filter(Boolean)
+    };
+  }
+  async getNodes(input) {
+    const limit = clampInt(input.limit, 1, 200, 25);
+    validateSortDir(input.sortDir);
+    const data = await this.query("getNodes", {
+      type: input.type,
+      limit,
+      startAfter: input.startAfter,
+      sortBy: input.sortBy,
+      sortDir: input.sortDir,
+      where: input.where
+    });
+    return {
+      nodes: (data.nodes ?? []).map(summarizeRecord).filter(Boolean),
+      hasMore: data.hasMore ?? false,
+      nextCursor: data.nextCursor
+    };
+  }
+  async getEdges(input) {
+    const hasFilter = input.aType || input.aUid || input.axbType || input.bType || input.bUid || input.where && input.where.length > 0;
+    if (!hasFilter) {
+      throw new QueryClientError(
+        "getEdges requires at least one filter field (aType, aUid, axbType, bType, bUid, or where)",
+        "VALIDATION_ERROR"
+      );
+    }
+    const limit = clampInt(input.limit, 1, 200, 25);
+    validateSortDir(input.sortDir);
+    const data = await this.query("getEdges", {
+      aType: input.aType,
+      aUid: input.aUid,
+      axbType: input.axbType,
+      bType: input.bType,
+      bUid: input.bUid,
+      limit,
+      startAfter: input.startAfter,
+      sortBy: input.sortBy,
+      sortDir: input.sortDir,
+      where: input.where
+    });
+    return {
+      edges: (data.edges ?? []).map(summarizeEdge).filter(Boolean),
+      hasMore: data.hasMore ?? false,
+      nextCursor: data.nextCursor
+    };
+  }
+  async traverse(input) {
+    requireString(input.startUid, "startUid");
+    if (!input.hops || input.hops.length === 0) {
+      throw new QueryClientError("traverse requires at least one hop", "VALIDATION_ERROR");
+    }
+    for (let i = 0; i < input.hops.length; i++) {
+      const hop = input.hops[i];
+      requireString(hop.axbType, `hops[${i}].axbType`);
+      if (hop.direction != null && hop.direction !== "forward" && hop.direction !== "reverse") {
+        throw new QueryClientError(
+          `hops[${i}].direction must be 'forward' or 'reverse'`,
+          "VALIDATION_ERROR"
+        );
+      }
+      if (hop.limit != null && (!Number.isInteger(hop.limit) || hop.limit < 1)) {
+        throw new QueryClientError(
+          `hops[${i}].limit must be a positive integer`,
+          "VALIDATION_ERROR"
+        );
+      }
+    }
+    if (input.maxReads != null && (!Number.isInteger(input.maxReads) || input.maxReads < 1)) {
+      throw new QueryClientError("maxReads must be a positive integer", "VALIDATION_ERROR");
+    }
+    if (input.concurrency != null && (!Number.isInteger(input.concurrency) || input.concurrency < 1)) {
+      throw new QueryClientError("concurrency must be a positive integer", "VALIDATION_ERROR");
+    }
+    const data = await this.mutate("traverse", input);
+    return {
+      hops: (data.hops ?? []).map((h) => ({
+        relation: h.axbType,
+        direction: h.direction,
+        depth: h.depth,
+        edgeCount: (h.edges ?? []).length,
+        edges: (h.edges ?? []).map(summarizeEdge).filter(Boolean),
+        truncated: h.truncated ?? false
+      })),
+      totalReads: data.totalReads ?? 0,
+      truncated: data.truncated ?? false
+    };
+  }
+  async search(input) {
+    requireString(input.q, "q");
+    const limit = clampInt(input.limit, 1, 50, 20);
+    const data = await this.query("search", { q: input.q, limit });
+    return {
+      results: (data.results ?? []).map((r) => {
+        const base = summarizeRecord(r);
+        if (!base) return null;
+        return {
+          ...base,
+          matchType: r._matchType ?? null
+        };
+      }).filter(Boolean)
+    };
+  }
+};
+
+// src/query-client/cli.ts
+function parseFlags(args) {
+  const flags = {};
+  const positional = [];
+  for (let i = 0; i < args.length; i++) {
+    if (args[i].startsWith("--")) {
+      const key = args[i].slice(2);
+      const next = args[i + 1];
+      if (next && !next.startsWith("--")) {
+        flags[key] = next;
+        i++;
+      } else {
+        flags[key] = "true";
+      }
+    } else {
+      positional.push(args[i]);
+    }
+  }
+  return { flags, positional };
+}
+async function runQueryCli(argv) {
+  const command = argv[0];
+  const rest = argv.slice(1);
+  const { flags, positional } = parseFlags(rest);
+  const port = flags.port ? parseInt(flags.port, 10) : void 0;
+  const host = flags.host ?? void 0;
+  const client = new QueryClient({ port, host });
+  try {
+    let result;
+    switch (command) {
+      case "schema":
+        result = await client.getSchema();
+        break;
+      case "get":
+        if (!positional[0]) {
+          die("Usage: firegraph query get <uid>");
+        }
+        result = await client.getNodeDetail({ uid: positional[0] });
+        break;
+      case "find-nodes": {
+        if (!positional[0]) {
+          die("Usage: firegraph query find-nodes <type> [--limit N]");
+        }
+        result = await client.getNodes({
+          type: positional[0],
+          limit: flags.limit ? parseInt(flags.limit, 10) : void 0
+        });
+        break;
+      }
+      case "find-edges": {
+        result = await client.getEdges({
+          aType: flags.aType,
+          aUid: flags.aUid,
+          axbType: flags.axbType,
+          bType: flags.bType,
+          bUid: flags.bUid,
+          limit: flags.limit ? parseInt(flags.limit, 10) : void 0
+        });
+        break;
+      }
+      case "traverse": {
+        const jsonStr = positional.join(" ");
+        if (!jsonStr) {
+          die(
+            `Usage: firegraph query traverse '<JSON>'
+
+JSON shape:
+{
+  "startUid": "nodeUid",
+  "hops": [
+    {
+      "axbType": "relationName",
+      "direction": "forward" | "reverse",
+      "limit": 10,
+      "aType": "filterSourceType",
+      "bType": "filterTargetType",
+      "orderBy": { "field": "data.name", "direction": "asc" },
+      "where": [{ "field": "data.status", "op": "==", "value": "active" }]
+    }
+  ],
+  "maxReads": 100,
+  "concurrency": 5
+}`
+          );
+        }
+        let input;
+        try {
+          input = JSON.parse(jsonStr);
+        } catch {
+          die(`Invalid JSON: ${jsonStr.slice(0, 200)}`);
+        }
+        result = await client.traverse(input);
+        break;
+      }
+      case "search":
+        if (!positional[0]) {
+          die("Usage: firegraph query search <query>");
+        }
+        result = await client.search({ q: positional.join(" ") });
+        break;
+      case "--help":
+      case "-h":
+      case void 0:
+        printHelp();
+        return;
+      default:
+        die(
+          `Unknown query command: ${command}
+Commands: schema, get, find-nodes, find-edges, traverse, search`
+        );
+    }
+    console.log(JSON.stringify(result, null, 2));
+  } catch (err) {
+    if (err instanceof QueryClientError) {
+      console.error(JSON.stringify({ error: err.message, code: err.code }));
+    } else {
+      console.error(JSON.stringify({ error: err.message }));
+    }
+    process.exit(1);
+  }
+}
+function printHelp() {
+  console.log("");
+  console.log("  Usage: firegraph query <command> [options]");
+  console.log("");
+  console.log("  Commands:");
+  console.log("    schema                          Get graph schema (node types + edge types)");
+  console.log("    get <uid>                       Get node detail with edges");
+  console.log("    find-nodes <type> [--limit N]   List nodes of a type");
+  console.log("    find-edges [filters]            List edges matching filters");
+  console.log("    traverse '<JSON>'               Multi-hop graph traversal");
+  console.log("    search <query>                  Search nodes by text");
+  console.log("");
+  console.log("  Global options:");
+  console.log("    --port <number>   Editor server port (default: auto-detect from config)");
+  console.log("    --host <string>   Editor server host (default: localhost)");
+  console.log("");
+  console.log("  find-edges filters:");
+  console.log("    --aType <type>    Filter by source type");
+  console.log("    --aUid <uid>      Filter by source UID");
+  console.log("    --axbType <rel>   Filter by relation type");
+  console.log("    --bType <type>    Filter by target type");
+  console.log("    --bUid <uid>      Filter by target UID");
+  console.log("    --limit <N>       Max results (1-200, default 25)");
+  console.log("");
+  console.log("  Examples:");
+  console.log("    npx firegraph query schema");
+  console.log("    npx firegraph query get Kj7vNq2mP9xR4wL1tY8s3");
+  console.log("    npx firegraph query find-nodes task --limit 10");
+  console.log("    npx firegraph query find-edges --aUid Kj7vNq2mP9xR4wL1tY8s3 --axbType hasTask");
+  console.log('    npx firegraph query search "John Doe"');
+  console.log("");
+}
+function die(msg) {
+  console.error(msg);
+  process.exit(1);
+}
+
+export {
+  summarizeRecord,
+  summarizeEdge,
+  readEditorPort,
+  QueryClientError,
+  QueryClient,
+  runQueryCli
+};
+//# sourceMappingURL=chunk-KFA7G37W.js.map

package/dist/chunk-KFA7G37W.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/query-client/client.ts","../src/query-client/shaping.ts","../src/query-client/config.ts","../src/query-client/cli.ts"],"sourcesContent":["import http from 'node:http';\nimport type {\n  QueryClientOptions,\n  SchemaResult,\n  GetNodeDetailInput,\n  NodeDetailResult,\n  GetNodesInput,\n  GetNodesResult,\n  GetEdgesInput,\n  GetEdgesResult,\n  TraverseInput,\n  TraverseResult,\n  TraverseHopResult,\n  SearchInput,\n  SearchResult,\n  SummarizedRecord,\n  SummarizedEdge,\n} from './types.js';\nimport { summarizeRecord, summarizeEdge } from './shaping.js';\nimport { readEditorPort } from './config.js';\n\n// --- Error ---\n\nexport type QueryClientErrorCode = 'VALIDATION_ERROR' | 'CONNECTION_FAILED' | 'SERVER_ERROR';\n\nexport class QueryClientError extends Error {\n  constructor(\n    message: string,\n    public readonly code: QueryClientErrorCode,\n  ) {\n    super(message);\n    this.name = 'QueryClientError';\n  }\n}\n\n// --- Validation helpers ---\n\nfunction requireString(value: unknown, name: string): asserts value is string {\n  if (typeof value !== 'string' || value.length === 0) {\n    throw new QueryClientError(`${name} must be a non-empty string`, 'VALIDATION_ERROR');\n  }\n}\n\nfunction clampInt(value: number | undefined, min: number, max: number, fallback: number): number {\n  if (value == null) return fallback;\n  if (!Number.isInteger(value)) {\n    throw new QueryClientError(`limit must be an integer`, 'VALIDATION_ERROR');\n  }\n  return Math.max(min, Math.min(max, value));\n}\n\nfunction validateSortDir(dir: string | undefined): void {\n  if (dir != null && dir !== 'asc' && dir !== 'desc') {\n    throw new QueryClientError(`sortDir must be 'asc' or 'desc'`, 'VALIDATION_ERROR');\n  }\n}\n\n// --- HTTP helpers ---\n\nfunction httpGet(url: string): Promise<string> {\n  return new Promise((resolve, reject) => {\n    http\n      .get(url, (res) => {\n        let body = '';\n        res.on('data', (c: string) => (body += c));\n        res.on('end', () => resolve(body));\n      })\n      .on('error', (err) => {\n        reject(new QueryClientError(`Connection failed: ${err.message}`, 'CONNECTION_FAILED'));\n      });\n  });\n}\n\nfunction httpPost(url: string, payload: string): Promise<string> {\n  const parsed = new URL(url);\n  return new Promise((resolve, reject) => {\n    const req = http.request(\n      {\n        hostname: parsed.hostname,\n        port: parsed.port,\n        path: parsed.pathname,\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'Content-Length': Buffer.byteLength(payload),\n        },\n      },\n      (res) => {\n        let body = '';\n        res.on('data', (c: string) => (body += c));\n        res.on('end', () => resolve(body));\n      },\n    );\n    req.on('error', (err) => {\n      reject(new QueryClientError(`Connection failed: ${err.message}`, 'CONNECTION_FAILED'));\n    });\n    req.write(payload);\n    req.end();\n  });\n}\n\nfunction parseTrpcResponse(raw: string, procedure: string): unknown {\n  let parsed: Record<string, unknown>;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    throw new QueryClientError(\n      `Invalid JSON from ${procedure}: ${raw.slice(0, 200)}`,\n      'SERVER_ERROR',\n    );\n  }\n  if (parsed.error) {\n    const msg =\n      typeof parsed.error === 'object' && parsed.error !== null\n        ? (parsed.error as Record<string, unknown>).message ?? JSON.stringify(parsed.error)\n        : String(parsed.error);\n    throw new QueryClientError(`Server error from ${procedure}: ${msg}`, 'SERVER_ERROR');\n  }\n  return (parsed.result as Record<string, unknown>)?.data ?? parsed;\n}\n\n// --- Client ---\n\nexport class QueryClient {\n  private readonly baseUrl: string;\n\n  constructor(options?: QueryClientOptions) {\n    const host = options?.host ?? 'localhost';\n    const port = options?.port ?? readEditorPort();\n    this.baseUrl = `http://${host}:${port}/api/trpc`;\n  }\n\n  private async query(procedure: string, input?: unknown): Promise<unknown> {\n    const qs =\n      input != null ? `?input=${encodeURIComponent(JSON.stringify(input))}` : '';\n    const url = `${this.baseUrl}/${procedure}${qs}`;\n    const raw = await httpGet(url);\n    return parseTrpcResponse(raw, procedure);\n  }\n\n  private async mutate(procedure: string, input: unknown): Promise<unknown> {\n    const url = `${this.baseUrl}/${procedure}`;\n    const raw = await httpPost(url, JSON.stringify(input));\n    return parseTrpcResponse(raw, procedure);\n  }\n\n  // --- Public API ---\n\n  async getSchema(): Promise<SchemaResult> {\n    const data = (await this.query('getSchema')) as Record<string, unknown>;\n    return {\n      nodeTypes: ((data.nodeTypes as unknown[]) ?? []).map(\n        (t) => (typeof t === 'object' && t !== null ? (t as Record<string, unknown>).type : t) as string,\n      ),\n      edgeTypes: ((data.edgeTypes as unknown[]) ?? []).map((t) => {\n        const e = t as Record<string, unknown>;\n        return {\n          relation: e.axbType as string,\n          from: e.aType as string,\n          to: e.bType as string,\n          inverseLabel: (e.inverseLabel as string) ?? null,\n        };\n      }),\n    };\n  }\n\n  async getNodeDetail(input: GetNodeDetailInput): Promise<NodeDetailResult> {\n    requireString(input.uid, 'uid');\n    const data = (await this.query('getNodeDetail', { uid: input.uid })) as Record<string, unknown>;\n    return {\n      node: summarizeRecord(data.node as Record<string, unknown> | null),\n      outEdges: ((data.outEdges as Record<string, unknown>[]) ?? []).map(summarizeEdge).filter(Boolean) as SummarizedEdge[],\n      inEdges: ((data.inEdges as Record<string, unknown>[]) ?? []).map(summarizeEdge).filter(Boolean) as SummarizedEdge[],\n    };\n  }\n\n  async getNodes(input: GetNodesInput): Promise<GetNodesResult> {\n    const limit = clampInt(input.limit, 1, 200, 25);\n    validateSortDir(input.sortDir);\n    const data = (await this.query('getNodes', {\n      type: input.type,\n      limit,\n      startAfter: input.startAfter,\n      sortBy: input.sortBy,\n      sortDir: input.sortDir,\n      where: input.where,\n    })) as Record<string, unknown>;\n    return {\n      nodes: ((data.nodes as Record<string, unknown>[]) ?? []).map(summarizeRecord).filter(Boolean) as SummarizedRecord[],\n      hasMore: (data.hasMore as boolean) ?? false,\n      nextCursor: data.nextCursor as string | null | undefined,\n    };\n  }\n\n  async getEdges(input: GetEdgesInput): Promise<GetEdgesResult> {\n    const hasFilter = input.aType || input.aUid || input.axbType || input.bType || input.bUid || (input.where && input.where.length > 0);\n    if (!hasFilter) {\n      throw new QueryClientError(\n        'getEdges requires at least one filter field (aType, aUid, axbType, bType, bUid, or where)',\n        'VALIDATION_ERROR',\n      );\n    }\n    const limit = clampInt(input.limit, 1, 200, 25);\n    validateSortDir(input.sortDir);\n    const data = (await this.query('getEdges', {\n      aType: input.aType,\n      aUid: input.aUid,\n      axbType: input.axbType,\n      bType: input.bType,\n      bUid: input.bUid,\n      limit,\n      startAfter: input.startAfter,\n      sortBy: input.sortBy,\n      sortDir: input.sortDir,\n      where: input.where,\n    })) as Record<string, unknown>;\n    return {\n      edges: ((data.edges as Record<string, unknown>[]) ?? []).map(summarizeEdge).filter(Boolean) as SummarizedEdge[],\n      hasMore: (data.hasMore as boolean) ?? false,\n      nextCursor: data.nextCursor as string | null | undefined,\n    };\n  }\n\n  async traverse(input: TraverseInput): Promise<TraverseResult> {\n    requireString(input.startUid, 'startUid');\n    if (!input.hops || input.hops.length === 0) {\n      throw new QueryClientError('traverse requires at least one hop', 'VALIDATION_ERROR');\n    }\n    for (let i = 0; i < input.hops.length; i++) {\n      const hop = input.hops[i];\n      requireString(hop.axbType, `hops[${i}].axbType`);\n      if (hop.direction != null && hop.direction !== 'forward' && hop.direction !== 'reverse') {\n        throw new QueryClientError(\n          `hops[${i}].direction must be 'forward' or 'reverse'`,\n          'VALIDATION_ERROR',\n        );\n      }\n      if (hop.limit != null && (!Number.isInteger(hop.limit) || hop.limit < 1)) {\n        throw new QueryClientError(\n          `hops[${i}].limit must be a positive integer`,\n          'VALIDATION_ERROR',\n        );\n      }\n    }\n    if (input.maxReads != null && (!Number.isInteger(input.maxReads) || input.maxReads < 1)) {\n      throw new QueryClientError('maxReads must be a positive integer', 'VALIDATION_ERROR');\n    }\n    if (input.concurrency != null && (!Number.isInteger(input.concurrency) || input.concurrency < 1)) {\n      throw new QueryClientError('concurrency must be a positive integer', 'VALIDATION_ERROR');\n    }\n\n    const data = (await this.mutate('traverse', input)) as Record<string, unknown>;\n    return {\n      hops: ((data.hops as Record<string, unknown>[]) ?? []).map((h): TraverseHopResult => ({\n        relation: h.axbType as string,\n        direction: h.direction as string,\n        depth: h.depth as number,\n        edgeCount: ((h.edges as unknown[]) ?? []).length,\n        edges: ((h.edges as Record<string, unknown>[]) ?? []).map(summarizeEdge).filter(Boolean) as SummarizedEdge[],\n        truncated: (h.truncated as boolean) ?? false,\n      })),\n      totalReads: (data.totalReads as number) ?? 0,\n      truncated: (data.truncated as boolean) ?? false,\n    };\n  }\n\n  async search(input: SearchInput): Promise<SearchResult> {\n    requireString(input.q, 'q');\n    const limit = clampInt(input.limit, 1, 50, 20);\n    const data = (await this.query('search', { q: input.q, limit })) as Record<string, unknown>;\n    return {\n      results: ((data.results as Record<string, unknown>[]) ?? []).map((r) => {\n        const base = summarizeRecord(r);\n        if (!base) return null;\n        return {\n          ...base,\n          matchType: (r._matchType as string) ?? null,\n        };\n      }).filter(Boolean) as (SummarizedRecord & { matchType: string | null })[],\n    };\n  }\n}\n","import type { SummarizedRecord, SummarizedEdge } from './types.js';\n\nexport function summarizeRecord(r: Record<string, unknown> | null): SummarizedRecord | null {\n  if (!r) return null;\n  const out: SummarizedRecord = { type: r.aType as string, uid: r.aUid as string };\n  const data = r.data as Record<string, unknown> | undefined;\n  if (data && typeof data === 'object' && Object.keys(data).length > 0) {\n    out.data = data;\n  }\n  return out;\n}\n\nexport function summarizeEdge(r: Record<string, unknown> | null): SummarizedEdge | null {\n  if (!r) return null;\n  const out: SummarizedEdge = {\n    fromType: r.aType as string,\n    fromUid: r.aUid as string,\n    relation: r.axbType as string,\n    toType: r.bType as string,\n    toUid: r.bUid as string,\n  };\n  const data = r.data as Record<string, unknown> | undefined;\n  if (data && typeof data === 'object' && Object.keys(data).length > 0) {\n    out.data = data;\n  }\n  return out;\n}\n","import { readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nconst CONFIG_FILES = ['firegraph.config.ts', 'firegraph.config.js', 'firegraph.config.mjs'];\nconst DEFAULT_PORT = 3884;\n\n/**\n * Read the editor port from firegraph config files using regex.\n * Zero-dependency — no jiti needed.\n */\nexport function readEditorPort(cwd?: string): number {\n  const dir = cwd ?? process.cwd();\n  for (const name of CONFIG_FILES) {\n    try {\n      const content = readFileSync(join(dir, name), 'utf8');\n      const editorBlock = content.match(/editor\\s*:\\s*\\{[^}]*\\}/s)?.[0] ?? '';\n      const portMatch = editorBlock.match(/port\\s*:\\s*(\\d+)/);\n      if (portMatch) return parseInt(portMatch[1], 10);\n    } catch {\n      continue;\n    }\n  }\n  return DEFAULT_PORT;\n}\n","import { QueryClient, QueryClientError } from './client.js';\nimport type { TraverseInput } from './types.js';\n\n// --- Argument parsing ---\n\ninterface ParsedArgs {\n  flags: Record<string, string>;\n  positional: string[];\n}\n\nfunction parseFlags(args: string[]): ParsedArgs {\n  const flags: Record<string, string> = {};\n  const positional: string[] = [];\n  for (let i = 0; i < args.length; i++) {\n    if (args[i].startsWith('--')) {\n      const key = args[i].slice(2);\n      const next = args[i + 1];\n      if (next && !next.startsWith('--')) {\n        flags[key] = next;\n        i++;\n      } else {\n        flags[key] = 'true';\n      }\n    } else {\n      positional.push(args[i]);\n    }\n  }\n  return { flags, positional };\n}\n\n// --- CLI runner ---\n\nexport async function runQueryCli(argv: string[]): Promise<void> {\n  const command = argv[0];\n  const rest = argv.slice(1);\n  const { flags, positional } = parseFlags(rest);\n\n  const port = flags.port ? parseInt(flags.port, 10) : undefined;\n  const host = flags.host ?? undefined;\n  const client = new QueryClient({ port, host });\n\n  try {\n    let result: unknown;\n\n    switch (command) {\n      case 'schema':\n        result = await client.getSchema();\n        break;\n\n      case 'get':\n        if (!positional[0]) {\n          die('Usage: firegraph query get <uid>');\n        }\n        result = await client.getNodeDetail({ uid: positional[0] });\n        break;\n\n      case 'find-nodes': {\n        if (!positional[0]) {\n          die('Usage: firegraph query find-nodes <type> [--limit N]');\n        }\n        result = await client.getNodes({\n          type: positional[0],\n          limit: flags.limit ? parseInt(flags.limit, 10) : undefined,\n        });\n        break;\n      }\n\n      case 'find-edges': {\n        result = await client.getEdges({\n          aType: flags.aType,\n          aUid: flags.aUid,\n          axbType: flags.axbType,\n          bType: flags.bType,\n          bUid: flags.bUid,\n          limit: flags.limit ? parseInt(flags.limit, 10) : undefined,\n        });\n        break;\n      }\n\n      case 'traverse': {\n        const jsonStr = positional.join(' ');\n        if (!jsonStr) {\n          die(\n            'Usage: firegraph query traverse \\'<JSON>\\'\\n\\n' +\n            'JSON shape:\\n' +\n            '{\\n' +\n            '  \"startUid\": \"nodeUid\",\\n' +\n            '  \"hops\": [\\n' +\n            '    {\\n' +\n            '      \"axbType\": \"relationName\",\\n' +\n            '      \"direction\": \"forward\" | \"reverse\",\\n' +\n            '      \"limit\": 10,\\n' +\n            '      \"aType\": \"filterSourceType\",\\n' +\n            '      \"bType\": \"filterTargetType\",\\n' +\n            '      \"orderBy\": { \"field\": \"data.name\", \"direction\": \"asc\" },\\n' +\n            '      \"where\": [{ \"field\": \"data.status\", \"op\": \"==\", \"value\": \"active\" }]\\n' +\n            '    }\\n' +\n            '  ],\\n' +\n            '  \"maxReads\": 100,\\n' +\n            '  \"concurrency\": 5\\n' +\n            '}',\n          );\n        }\n        let input: TraverseInput;\n        try {\n          input = JSON.parse(jsonStr) as TraverseInput;\n        } catch {\n          die(`Invalid JSON: ${jsonStr.slice(0, 200)}`);\n        }\n        result = await client.traverse(input!);\n        break;\n      }\n\n      case 'search':\n        if (!positional[0]) {\n          die('Usage: firegraph query search <query>');\n        }\n        result = await client.search({ q: positional.join(' ') });\n        break;\n\n      case '--help':\n      case '-h':\n      case undefined:\n        printHelp();\n        return;\n\n      default:\n        die(\n          `Unknown query command: ${command}\\n` +\n          'Commands: schema, get, find-nodes, find-edges, traverse, search',\n        );\n    }\n\n    console.log(JSON.stringify(result, null, 2));\n  } catch (err) {\n    if (err instanceof QueryClientError) {\n      console.error(JSON.stringify({ error: err.message, code: err.code }));\n    } else {\n      console.error(JSON.stringify({ error: (err as Error).message }));\n    }\n    process.exit(1);\n  }\n}\n\nfunction printHelp(): void {\n  console.log('');\n  console.log('  Usage: firegraph query <command> [options]');\n  console.log('');\n  console.log('  Commands:');\n  console.log('    schema                          Get graph schema (node types + edge types)');\n  console.log('    get <uid>                       Get node detail with edges');\n  console.log('    find-nodes <type> [--limit N]   List nodes of a type');\n  console.log('    find-edges [filters]            List edges matching filters');\n  console.log('    traverse \\'<JSON>\\'               Multi-hop graph traversal');\n  console.log('    search <query>                  Search nodes by text');\n  console.log('');\n  console.log('  Global options:');\n  console.log('    --port <number>   Editor server port (default: auto-detect from config)');\n  console.log('    --host <string>   Editor server host (default: localhost)');\n  console.log('');\n  console.log('  find-edges filters:');\n  console.log('    --aType <type>    Filter by source type');\n  console.log('    --aUid <uid>      Filter by source UID');\n  console.log('    --axbType <rel>   Filter by relation type');\n  console.log('    --bType <type>    Filter by target type');\n  console.log('    --bUid <uid>      Filter by target UID');\n  console.log('    --limit <N>       Max results (1-200, default 25)');\n  console.log('');\n  console.log('  Examples:');\n  console.log('    npx firegraph query schema');\n  console.log('    npx firegraph query get Kj7vNq2mP9xR4wL1tY8s3');\n  console.log('    npx firegraph query find-nodes task --limit 10');\n  console.log('    npx firegraph query find-edges --aUid Kj7vNq2mP9xR4wL1tY8s3 --axbType hasTask');\n  console.log('    npx firegraph query search \"John Doe\"');\n  console.log('');\n}\n\nfunction die(msg: string): never {\n  console.error(msg);\n  process.exit(1);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-YLGXLEUE.js

@@ -0,0 +1,47 @@
+// src/codegen/index.ts
+function pascalCase(s) {
+  return s.replace(
+    /(^|[^a-zA-Z0-9])([a-zA-Z])/g,
+    (_, _sep, ch) => ch.toUpperCase()
+  );
+}
+async function generateTypes(discovery, options = {}) {
+  const { compile } = await import("json-schema-to-typescript");
+  const { banner = true } = options;
+  const chunks = [];
+  if (banner) {
+    chunks.push(
+      "// Auto-generated by firegraph codegen \u2014 do not edit manually\n"
+    );
+  }
+  const sortedNodes = [...discovery.nodes.entries()].sort(
+    ([a], [b]) => a.localeCompare(b)
+  );
+  const sortedEdges = [...discovery.edges.entries()].sort(
+    ([a], [b]) => a.localeCompare(b)
+  );
+  for (const [name, entity] of sortedNodes) {
+    const typeName = `${pascalCase(name)}Data`;
+    const ts = await compile(entity.schema, typeName, {
+      bannerComment: "",
+      additionalProperties: false
+    });
+    chunks.push(ts.trim());
+    chunks.push("");
+  }
+  for (const [name, entity] of sortedEdges) {
+    const typeName = `${pascalCase(name)}EdgeData`;
+    const ts = await compile(entity.schema, typeName, {
+      bannerComment: "",
+      additionalProperties: false
+    });
+    chunks.push(ts.trim());
+    chunks.push("");
+  }
+  return chunks.join("\n").trimEnd() + "\n";
+}
+
+export {
+  generateTypes
+};
+//# sourceMappingURL=chunk-YLGXLEUE.js.map

package/dist/chunk-YLGXLEUE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/codegen/index.ts"],"sourcesContent":["/**\n * Code generation — produces TypeScript type definitions from JSON Schema\n * files discovered via the entity folder convention.\n *\n * Uses `json-schema-to-typescript` to compile each entity's `schema.json`\n * into a TypeScript interface.\n *\n * Naming convention:\n * - Nodes:  `{PascalName}Data`       (e.g. `TaskData`)\n * - Edges:  `{PascalName}EdgeData`   (e.g. `HasStepEdgeData`)\n */\n\nimport type { DiscoveryResult } from '../types.js';\n\nfunction pascalCase(s: string): string {\n  return s.replace(/(^|[^a-zA-Z0-9])([a-zA-Z])/g, (_, _sep, ch) =>\n    ch.toUpperCase(),\n  );\n}\n\nexport interface CodegenOptions {\n  /** Add banner comment at top of output. Defaults to true. */\n  banner?: boolean;\n}\n\n/**\n * Generate TypeScript type definitions from a DiscoveryResult.\n * Returns the full file content as a string.\n */\nexport async function generateTypes(\n  discovery: DiscoveryResult,\n  options: CodegenOptions = {},\n): Promise<string> {\n  // Lazy-load to avoid requiring this dep at runtime for non-codegen usage\n  const { compile } = await import('json-schema-to-typescript');\n\n  const { banner = true } = options;\n  const chunks: string[] = [];\n\n  if (banner) {\n    chunks.push(\n      '// Auto-generated by firegraph codegen — do not edit manually\\n',\n    );\n  }\n\n  // Sort for deterministic output\n  const sortedNodes = [...discovery.nodes.entries()].sort(([a], [b]) =>\n    a.localeCompare(b),\n  );\n  const sortedEdges = [...discovery.edges.entries()].sort(([a], [b]) =>\n    a.localeCompare(b),\n  );\n\n  for (const [name, entity] of sortedNodes) {\n    const typeName = `${pascalCase(name)}Data`;\n    const ts = await compile(entity.schema as any, typeName, {\n      bannerComment: '',\n      additionalProperties: false,\n    });\n    chunks.push(ts.trim());\n    chunks.push('');\n  }\n\n  for (const [name, entity] of sortedEdges) {\n    const typeName = `${pascalCase(name)}EdgeData`;\n    const ts = await compile(entity.schema as any, typeName, {\n      bannerComment: '',\n      additionalProperties: false,\n    });\n    chunks.push(ts.trim());\n    chunks.push('');\n  }\n\n  return chunks.join('\\n').trimEnd() + '\\n';\n}\n"],"mappings":";AAcA,SAAS,WAAW,GAAmB;AACrC,SAAO,EAAE;AAAA,IAAQ;AAAA,IAA+B,CAAC,GAAG,MAAM,OACxD,GAAG,YAAY;AAAA,EACjB;AACF;AAWA,eAAsB,cACpB,WACA,UAA0B,CAAC,GACV;AAEjB,QAAM,EAAE,QAAQ,IAAI,MAAM,OAAO,2BAA2B;AAE5D,QAAM,EAAE,SAAS,KAAK,IAAI;AAC1B,QAAM,SAAmB,CAAC;AAE1B,MAAI,QAAQ;AACV,WAAO;AAAA,MACL;AAAA,IACF;AAAA,EACF;AAGA,QAAM,cAAc,CAAC,GAAG,UAAU,MAAM,QAAQ,CAAC,EAAE;AAAA,IAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAC9D,EAAE,cAAc,CAAC;AAAA,EACnB;AACA,QAAM,cAAc,CAAC,GAAG,UAAU,MAAM,QAAQ,CAAC,EAAE;AAAA,IAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAC9D,EAAE,cAAc,CAAC;AAAA,EACnB;AAEA,aAAW,CAAC,MAAM,MAAM,KAAK,aAAa;AACxC,UAAM,WAAW,GAAG,WAAW,IAAI,CAAC;AACpC,UAAM,KAAK,MAAM,QAAQ,OAAO,QAAe,UAAU;AAAA,MACvD,eAAe;AAAA,MACf,sBAAsB;AAAA,IACxB,CAAC;AACD,WAAO,KAAK,GAAG,KAAK,CAAC;AACrB,WAAO,KAAK,EAAE;AAAA,EAChB;AAEA,aAAW,CAAC,MAAM,MAAM,KAAK,aAAa;AACxC,UAAM,WAAW,GAAG,WAAW,IAAI,CAAC;AACpC,UAAM,KAAK,MAAM,QAAQ,OAAO,QAAe,UAAU;AAAA,MACvD,eAAe;AAAA,MACf,sBAAsB;AAAA,IACxB,CAAC;AACD,WAAO,KAAK,GAAG,KAAK,CAAC;AACrB,WAAO,KAAK,EAAE;AAAA,EAChB;AAEA,SAAO,OAAO,KAAK,IAAI,EAAE,QAAQ,IAAI;AACvC;","names":[]}