@typicalday/firegraph 0.8.0 → 0.10.0

package/dist/query-client/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/query-client/index.ts","../../src/query-client/client.ts","../../src/query-client/shaping.ts","../../src/query-client/config.ts","../../src/query-client/cli.ts"],"sourcesContent":["export { QueryClient, QueryClientError } from './client.js';\nexport type { QueryClientErrorCode } from './client.js';\nexport { readEditorPort } from './config.js';\nexport { summarizeRecord, summarizeEdge } from './shaping.js';\nexport { runQueryCli } from './cli.js';\n\nexport type {\n  WhereClause,\n  SummarizedRecord,\n  SummarizedEdge,\n  SchemaResult,\n  GetNodeDetailInput,\n  NodeDetailResult,\n  GetNodesInput,\n  GetNodesResult,\n  GetEdgesInput,\n  GetEdgesResult,\n  TraverseHop,\n  TraverseInput,\n  TraverseHopResult,\n  TraverseResult,\n  SearchInput,\n  SearchResult,\n  QueryClientOptions,\n} from './types.js';\n","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":["http"]}
+{"version":3,"sources":["../../src/query-client/index.ts","../../src/query-client/client.ts","../../src/query-client/config.ts","../../src/query-client/shaping.ts","../../src/query-client/cli.ts"],"sourcesContent":["export { runQueryCli } from './cli.js';\nexport type { QueryClientErrorCode } from './client.js';\nexport { QueryClient, QueryClientError } from './client.js';\nexport { readEditorPort } from './config.js';\nexport { summarizeEdge, summarizeRecord } from './shaping.js';\nexport type {\n  GetEdgesInput,\n  GetEdgesResult,\n  GetNodeDetailInput,\n  GetNodesInput,\n  GetNodesResult,\n  NodeDetailResult,\n  QueryClientOptions,\n  SchemaResult,\n  SearchInput,\n  SearchResult,\n  SummarizedEdge,\n  SummarizedRecord,\n  TraverseHop,\n  TraverseHopResult,\n  TraverseInput,\n  TraverseResult,\n  WhereClause,\n} from './types.js';\n","import http from 'node:http';\n\nimport { readEditorPort } from './config.js';\nimport { summarizeEdge, summarizeRecord } from './shaping.js';\nimport type {\n  GetEdgesInput,\n  GetEdgesResult,\n  GetNodeDetailInput,\n  GetNodesInput,\n  GetNodesResult,\n  NodeDetailResult,\n  QueryClientOptions,\n  SchemaResult,\n  SearchInput,\n  SearchResult,\n  SummarizedEdge,\n  SummarizedRecord,\n  TraverseHopResult,\n  TraverseInput,\n  TraverseResult,\n} from './types.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 = 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) =>\n          (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>[]) ?? [])\n        .map(summarizeEdge)\n        .filter(Boolean) as SummarizedEdge[],\n      inEdges: ((data.inEdges as Record<string, unknown>[]) ?? [])\n        .map(summarizeEdge)\n        .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>[]) ?? [])\n        .map(summarizeRecord)\n        .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 =\n      input.aType ||\n      input.aUid ||\n      input.axbType ||\n      input.bType ||\n      input.bUid ||\n      (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>[]) ?? [])\n        .map(summarizeEdge)\n        .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 (\n      input.concurrency != null &&\n      (!Number.isInteger(input.concurrency) || input.concurrency < 1)\n    ) {\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(\n        (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>[]) ?? [])\n            .map(summarizeEdge)\n            .filter(Boolean) as SummarizedEdge[],\n          truncated: (h.truncated as boolean) ?? false,\n        }),\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>[]) ?? [])\n        .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        })\n        .filter(Boolean) as (SummarizedRecord & { matchType: string | null })[],\n    };\n  }\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 type { SummarizedEdge, SummarizedRecord } 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 { 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":["http"]}

package/dist/query-client/index.d.cts

@@ -1,6 +1,8 @@
 import { S as SummarizedEdge, d as SummarizedRecord } from '../client-Bk2Cm6xv.cjs';
 export { G as GetEdgesInput, e as GetEdgesResult, f as GetNodeDetailInput, g as GetNodesInput, h as GetNodesResult, N as NodeDetailResult, Q as QueryClient, a as QueryClientError, b as QueryClientErrorCode, c as QueryClientOptions, i as SchemaResult, j as SearchInput, k as SearchResult, T as TraverseHop, l as TraverseHopResult, m as TraverseInput, n as TraverseResult, W as WhereClause } from '../client-Bk2Cm6xv.cjs';
 
+declare function runQueryCli(argv: string[]): Promise<void>;
+
 /**
  * Read the editor port from firegraph config files using regex.
  * Zero-dependency — no jiti needed.
@@ -10,6 +12,4 @@ declare function readEditorPort(cwd?: string): number;
 declare function summarizeRecord(r: Record<string, unknown> | null): SummarizedRecord | null;
 declare function summarizeEdge(r: Record<string, unknown> | null): SummarizedEdge | null;
 
-declare function runQueryCli(argv: string[]): Promise<void>;
-
 export { SummarizedEdge, SummarizedRecord, readEditorPort, runQueryCli, summarizeEdge, summarizeRecord };

package/dist/query-client/index.d.ts

@@ -1,6 +1,8 @@
 import { S as SummarizedEdge, d as SummarizedRecord } from '../client-Bk2Cm6xv.js';
 export { G as GetEdgesInput, e as GetEdgesResult, f as GetNodeDetailInput, g as GetNodesInput, h as GetNodesResult, N as NodeDetailResult, Q as QueryClient, a as QueryClientError, b as QueryClientErrorCode, c as QueryClientOptions, i as SchemaResult, j as SearchInput, k as SearchResult, T as TraverseHop, l as TraverseHopResult, m as TraverseInput, n as TraverseResult, W as WhereClause } from '../client-Bk2Cm6xv.js';
 
+declare function runQueryCli(argv: string[]): Promise<void>;
+
 /**
  * Read the editor port from firegraph config files using regex.
  * Zero-dependency — no jiti needed.
@@ -10,6 +12,4 @@ declare function readEditorPort(cwd?: string): number;
 declare function summarizeRecord(r: Record<string, unknown> | null): SummarizedRecord | null;
 declare function summarizeEdge(r: Record<string, unknown> | null): SummarizedEdge | null;
 
-declare function runQueryCli(argv: string[]): Promise<void>;
-
 export { SummarizedEdge, SummarizedRecord, readEditorPort, runQueryCli, summarizeEdge, summarizeRecord };

package/dist/query-client/index.js

@@ -5,7 +5,7 @@ import {
   runQueryCli,
   summarizeEdge,
   summarizeRecord
-} from "../chunk-KFA7G37W.js";
+} from "../chunk-SU4FNLC3.js";
 export {
   QueryClient,
   QueryClientError,

package/dist/react.cjs

@@ -47,7 +47,6 @@ function wrapReact(Component, meta) {
     static viewName = meta.viewName;
     static description = meta.description;
     _data = {};
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     _root = null;
     _mounted = false;
     set data(v) {

package/dist/react.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react.ts"],"sourcesContent":["/**\n * React adapter for firegraph views.\n *\n * Wraps a React function component into a Web Component (HTMLElement) that\n * satisfies the firegraph `ViewComponentClass` contract. Import from\n * `firegraph/react`:\n *\n * @example\n * ```tsx\n * import { wrapReact } from 'firegraph/react';\n *\n * const TaskCard = wrapReact(({ data }) => (\n *   <div style={{ padding: 12 }}>\n *     <strong>{String(data.title ?? '')}</strong>\n *   </div>\n * ), { viewName: 'card', description: 'Compact task card' });\n *\n * export default [TaskCard];\n * ```\n */\n\nimport type { ViewComponentClass } from './views.js';\n\n/** Metadata required for every firegraph view. */\nexport interface ViewMeta {\n  /** Short identifier (e.g. 'card', 'detail'). */\n  viewName: string;\n  /** Optional human-readable description. */\n  description?: string;\n}\n\n/** A React function component that receives entity data. */\nexport type ReactViewComponent = (props: { data: Record<string, unknown> }) => unknown;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyClass = { new (...args: any[]): any };\n\n/**\n * Get HTMLElement from the runtime environment.\n * Returns a base class for view elements — works in both browser and Node.js\n * (where HTMLElement may be shimmed by the editor server).\n */\nfunction getBaseClass(): AnyClass {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const g = globalThis as any;\n  return g.HTMLElement ?? class {};\n}\n\n/**\n * Wrap a React function component into a firegraph `ViewComponentClass`.\n *\n * The returned class extends `HTMLElement` and lazily imports `react` and\n * `react-dom/client` at render time. React is resolved from the project's\n * own `node_modules` — firegraph does not bundle or depend on React itself.\n */\nexport function wrapReact(\n  Component: ReactViewComponent,\n  meta: ViewMeta,\n): ViewComponentClass {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let React: any = null;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let ReactDOM: any = null;\n  let loaded = false;\n\n  async function ensureReact() {\n    if (loaded) return;\n    // Dynamic imports — resolved from project's node_modules at runtime\n    const [r, rd] = await Promise.all([\n      Function('return import(\"react\")')() as Promise<unknown>,\n      Function('return import(\"react-dom/client\")')() as Promise<unknown>,\n    ]);\n    React = r;\n    ReactDOM = rd;\n    loaded = true;\n  }\n\n  const Base = getBaseClass();\n\n  const Cls = class extends Base {\n    static viewName = meta.viewName;\n    static description = meta.description;\n\n    _data: Record<string, unknown> = {};\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _root: any = null;\n    _mounted = false;\n\n    set data(v: Record<string, unknown>) {\n      this._data = v;\n      this._render();\n    }\n\n    get data() {\n      return this._data;\n    }\n\n    connectedCallback() {\n      this._mounted = true;\n      this._render();\n    }\n\n    disconnectedCallback() {\n      this._mounted = false;\n      this._root?.unmount();\n      this._root = null;\n    }\n\n    async _render() {\n      if (!this._mounted) return;\n      await ensureReact();\n      if (!this._mounted) return; // may have disconnected while awaiting\n\n      if (!this._root) {\n        this._root = ReactDOM.createRoot(this);\n      }\n      this._root.render(React.createElement(Component, { data: this._data }));\n    }\n  };\n\n  return Cls as unknown as ViewComponentClass;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA0CA,SAAS,eAAyB;AAEhC,QAAM,IAAI;AACV,SAAO,EAAE,eAAe,MAAM;AAAA,EAAC;AACjC;AASO,SAAS,UACd,WACA,MACoB;AAEpB,MAAI,QAAa;AAEjB,MAAI,WAAgB;AACpB,MAAI,SAAS;AAEb,iBAAe,cAAc;AAC3B,QAAI,OAAQ;AAEZ,UAAM,CAAC,GAAG,EAAE,IAAI,MAAM,QAAQ,IAAI;AAAA,MAChC,SAAS,wBAAwB,EAAE;AAAA,MACnC,SAAS,mCAAmC,EAAE;AAAA,IAChD,CAAC;AACD,YAAQ;AACR,eAAW;AACX,aAAS;AAAA,EACX;AAEA,QAAM,OAAO,aAAa;AAE1B,QAAM,MAAM,cAAc,KAAK;AAAA,IAC7B,OAAO,WAAW,KAAK;AAAA,IACvB,OAAO,cAAc,KAAK;AAAA,IAE1B,QAAiC,CAAC;AAAA;AAAA,IAElC,QAAa;AAAA,IACb,WAAW;AAAA,IAEX,IAAI,KAAK,GAA4B;AACnC,WAAK,QAAQ;AACb,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,IAAI,OAAO;AACT,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,oBAAoB;AAClB,WAAK,WAAW;AAChB,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,uBAAuB;AACrB,WAAK,WAAW;AAChB,WAAK,OAAO,QAAQ;AACpB,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,MAAM,UAAU;AACd,UAAI,CAAC,KAAK,SAAU;AACpB,YAAM,YAAY;AAClB,UAAI,CAAC,KAAK,SAAU;AAEpB,UAAI,CAAC,KAAK,OAAO;AACf,aAAK,QAAQ,SAAS,WAAW,IAAI;AAAA,MACvC;AACA,WAAK,MAAM,OAAO,MAAM,cAAc,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAAA,IACxE;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/react.ts"],"sourcesContent":["/**\n * React adapter for firegraph views.\n *\n * Wraps a React function component into a Web Component (HTMLElement) that\n * satisfies the firegraph `ViewComponentClass` contract. Import from\n * `firegraph/react`:\n *\n * @example\n * ```tsx\n * import { wrapReact } from 'firegraph/react';\n *\n * const TaskCard = wrapReact(({ data }) => (\n *   <div style={{ padding: 12 }}>\n *     <strong>{String(data.title ?? '')}</strong>\n *   </div>\n * ), { viewName: 'card', description: 'Compact task card' });\n *\n * export default [TaskCard];\n * ```\n */\n\nimport type { ViewComponentClass } from './views.js';\n\n/** Metadata required for every firegraph view. */\nexport interface ViewMeta {\n  /** Short identifier (e.g. 'card', 'detail'). */\n  viewName: string;\n  /** Optional human-readable description. */\n  description?: string;\n}\n\n/** A React function component that receives entity data. */\nexport type ReactViewComponent = (props: { data: Record<string, unknown> }) => unknown;\n\ntype AnyClass = { new (...args: any[]): any };\n\n/**\n * Get HTMLElement from the runtime environment.\n * Returns a base class for view elements — works in both browser and Node.js\n * (where HTMLElement may be shimmed by the editor server).\n */\nfunction getBaseClass(): AnyClass {\n  const g = globalThis as any;\n  return g.HTMLElement ?? class {};\n}\n\n/**\n * Wrap a React function component into a firegraph `ViewComponentClass`.\n *\n * The returned class extends `HTMLElement` and lazily imports `react` and\n * `react-dom/client` at render time. React is resolved from the project's\n * own `node_modules` — firegraph does not bundle or depend on React itself.\n */\nexport function wrapReact(Component: ReactViewComponent, meta: ViewMeta): ViewComponentClass {\n  let React: any = null;\n\n  let ReactDOM: any = null;\n  let loaded = false;\n\n  async function ensureReact() {\n    if (loaded) return;\n    // Dynamic imports — resolved from project's node_modules at runtime\n    const [r, rd] = await Promise.all([\n      Function('return import(\"react\")')() as Promise<unknown>,\n      Function('return import(\"react-dom/client\")')() as Promise<unknown>,\n    ]);\n    React = r;\n    ReactDOM = rd;\n    loaded = true;\n  }\n\n  const Base = getBaseClass();\n\n  const Cls = class extends Base {\n    static viewName = meta.viewName;\n    static description = meta.description;\n\n    _data: Record<string, unknown> = {};\n\n    _root: any = null;\n    _mounted = false;\n\n    set data(v: Record<string, unknown>) {\n      this._data = v;\n      this._render();\n    }\n\n    get data() {\n      return this._data;\n    }\n\n    connectedCallback() {\n      this._mounted = true;\n      this._render();\n    }\n\n    disconnectedCallback() {\n      this._mounted = false;\n      this._root?.unmount();\n      this._root = null;\n    }\n\n    async _render() {\n      if (!this._mounted) return;\n      await ensureReact();\n      if (!this._mounted) return; // may have disconnected while awaiting\n\n      if (!this._root) {\n        this._root = ReactDOM.createRoot(this);\n      }\n      this._root.render(React.createElement(Component, { data: this._data }));\n    }\n  };\n\n  return Cls as unknown as ViewComponentClass;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAyCA,SAAS,eAAyB;AAChC,QAAM,IAAI;AACV,SAAO,EAAE,eAAe,MAAM;AAAA,EAAC;AACjC;AASO,SAAS,UAAU,WAA+B,MAAoC;AAC3F,MAAI,QAAa;AAEjB,MAAI,WAAgB;AACpB,MAAI,SAAS;AAEb,iBAAe,cAAc;AAC3B,QAAI,OAAQ;AAEZ,UAAM,CAAC,GAAG,EAAE,IAAI,MAAM,QAAQ,IAAI;AAAA,MAChC,SAAS,wBAAwB,EAAE;AAAA,MACnC,SAAS,mCAAmC,EAAE;AAAA,IAChD,CAAC;AACD,YAAQ;AACR,eAAW;AACX,aAAS;AAAA,EACX;AAEA,QAAM,OAAO,aAAa;AAE1B,QAAM,MAAM,cAAc,KAAK;AAAA,IAC7B,OAAO,WAAW,KAAK;AAAA,IACvB,OAAO,cAAc,KAAK;AAAA,IAE1B,QAAiC,CAAC;AAAA,IAElC,QAAa;AAAA,IACb,WAAW;AAAA,IAEX,IAAI,KAAK,GAA4B;AACnC,WAAK,QAAQ;AACb,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,IAAI,OAAO;AACT,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,oBAAoB;AAClB,WAAK,WAAW;AAChB,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,uBAAuB;AACrB,WAAK,WAAW;AAChB,WAAK,OAAO,QAAQ;AACpB,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,MAAM,UAAU;AACd,UAAI,CAAC,KAAK,SAAU;AACpB,YAAM,YAAY;AAClB,UAAI,CAAC,KAAK,SAAU;AAEpB,UAAI,CAAC,KAAK,OAAO;AACf,aAAK,QAAQ,SAAS,WAAW,IAAI;AAAA,MACvC;AACA,WAAK,MAAM,OAAO,MAAM,cAAc,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAAA,IACxE;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/react.js

@@ -23,7 +23,6 @@ function wrapReact(Component, meta) {
     static viewName = meta.viewName;
     static description = meta.description;
     _data = {};
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     _root = null;
     _mounted = false;
     set data(v) {

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react.ts"],"sourcesContent":["/**\n * React adapter for firegraph views.\n *\n * Wraps a React function component into a Web Component (HTMLElement) that\n * satisfies the firegraph `ViewComponentClass` contract. Import from\n * `firegraph/react`:\n *\n * @example\n * ```tsx\n * import { wrapReact } from 'firegraph/react';\n *\n * const TaskCard = wrapReact(({ data }) => (\n *   <div style={{ padding: 12 }}>\n *     <strong>{String(data.title ?? '')}</strong>\n *   </div>\n * ), { viewName: 'card', description: 'Compact task card' });\n *\n * export default [TaskCard];\n * ```\n */\n\nimport type { ViewComponentClass } from './views.js';\n\n/** Metadata required for every firegraph view. */\nexport interface ViewMeta {\n  /** Short identifier (e.g. 'card', 'detail'). */\n  viewName: string;\n  /** Optional human-readable description. */\n  description?: string;\n}\n\n/** A React function component that receives entity data. */\nexport type ReactViewComponent = (props: { data: Record<string, unknown> }) => unknown;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyClass = { new (...args: any[]): any };\n\n/**\n * Get HTMLElement from the runtime environment.\n * Returns a base class for view elements — works in both browser and Node.js\n * (where HTMLElement may be shimmed by the editor server).\n */\nfunction getBaseClass(): AnyClass {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const g = globalThis as any;\n  return g.HTMLElement ?? class {};\n}\n\n/**\n * Wrap a React function component into a firegraph `ViewComponentClass`.\n *\n * The returned class extends `HTMLElement` and lazily imports `react` and\n * `react-dom/client` at render time. React is resolved from the project's\n * own `node_modules` — firegraph does not bundle or depend on React itself.\n */\nexport function wrapReact(\n  Component: ReactViewComponent,\n  meta: ViewMeta,\n): ViewComponentClass {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let React: any = null;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let ReactDOM: any = null;\n  let loaded = false;\n\n  async function ensureReact() {\n    if (loaded) return;\n    // Dynamic imports — resolved from project's node_modules at runtime\n    const [r, rd] = await Promise.all([\n      Function('return import(\"react\")')() as Promise<unknown>,\n      Function('return import(\"react-dom/client\")')() as Promise<unknown>,\n    ]);\n    React = r;\n    ReactDOM = rd;\n    loaded = true;\n  }\n\n  const Base = getBaseClass();\n\n  const Cls = class extends Base {\n    static viewName = meta.viewName;\n    static description = meta.description;\n\n    _data: Record<string, unknown> = {};\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _root: any = null;\n    _mounted = false;\n\n    set data(v: Record<string, unknown>) {\n      this._data = v;\n      this._render();\n    }\n\n    get data() {\n      return this._data;\n    }\n\n    connectedCallback() {\n      this._mounted = true;\n      this._render();\n    }\n\n    disconnectedCallback() {\n      this._mounted = false;\n      this._root?.unmount();\n      this._root = null;\n    }\n\n    async _render() {\n      if (!this._mounted) return;\n      await ensureReact();\n      if (!this._mounted) return; // may have disconnected while awaiting\n\n      if (!this._root) {\n        this._root = ReactDOM.createRoot(this);\n      }\n      this._root.render(React.createElement(Component, { data: this._data }));\n    }\n  };\n\n  return Cls as unknown as ViewComponentClass;\n}\n"],"mappings":";AA0CA,SAAS,eAAyB;AAEhC,QAAM,IAAI;AACV,SAAO,EAAE,eAAe,MAAM;AAAA,EAAC;AACjC;AASO,SAAS,UACd,WACA,MACoB;AAEpB,MAAI,QAAa;AAEjB,MAAI,WAAgB;AACpB,MAAI,SAAS;AAEb,iBAAe,cAAc;AAC3B,QAAI,OAAQ;AAEZ,UAAM,CAAC,GAAG,EAAE,IAAI,MAAM,QAAQ,IAAI;AAAA,MAChC,SAAS,wBAAwB,EAAE;AAAA,MACnC,SAAS,mCAAmC,EAAE;AAAA,IAChD,CAAC;AACD,YAAQ;AACR,eAAW;AACX,aAAS;AAAA,EACX;AAEA,QAAM,OAAO,aAAa;AAE1B,QAAM,MAAM,cAAc,KAAK;AAAA,IAC7B,OAAO,WAAW,KAAK;AAAA,IACvB,OAAO,cAAc,KAAK;AAAA,IAE1B,QAAiC,CAAC;AAAA;AAAA,IAElC,QAAa;AAAA,IACb,WAAW;AAAA,IAEX,IAAI,KAAK,GAA4B;AACnC,WAAK,QAAQ;AACb,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,IAAI,OAAO;AACT,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,oBAAoB;AAClB,WAAK,WAAW;AAChB,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,uBAAuB;AACrB,WAAK,WAAW;AAChB,WAAK,OAAO,QAAQ;AACpB,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,MAAM,UAAU;AACd,UAAI,CAAC,KAAK,SAAU;AACpB,YAAM,YAAY;AAClB,UAAI,CAAC,KAAK,SAAU;AAEpB,UAAI,CAAC,KAAK,OAAO;AACf,aAAK,QAAQ,SAAS,WAAW,IAAI;AAAA,MACvC;AACA,WAAK,MAAM,OAAO,MAAM,cAAc,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAAA,IACxE;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/react.ts"],"sourcesContent":["/**\n * React adapter for firegraph views.\n *\n * Wraps a React function component into a Web Component (HTMLElement) that\n * satisfies the firegraph `ViewComponentClass` contract. Import from\n * `firegraph/react`:\n *\n * @example\n * ```tsx\n * import { wrapReact } from 'firegraph/react';\n *\n * const TaskCard = wrapReact(({ data }) => (\n *   <div style={{ padding: 12 }}>\n *     <strong>{String(data.title ?? '')}</strong>\n *   </div>\n * ), { viewName: 'card', description: 'Compact task card' });\n *\n * export default [TaskCard];\n * ```\n */\n\nimport type { ViewComponentClass } from './views.js';\n\n/** Metadata required for every firegraph view. */\nexport interface ViewMeta {\n  /** Short identifier (e.g. 'card', 'detail'). */\n  viewName: string;\n  /** Optional human-readable description. */\n  description?: string;\n}\n\n/** A React function component that receives entity data. */\nexport type ReactViewComponent = (props: { data: Record<string, unknown> }) => unknown;\n\ntype AnyClass = { new (...args: any[]): any };\n\n/**\n * Get HTMLElement from the runtime environment.\n * Returns a base class for view elements — works in both browser and Node.js\n * (where HTMLElement may be shimmed by the editor server).\n */\nfunction getBaseClass(): AnyClass {\n  const g = globalThis as any;\n  return g.HTMLElement ?? class {};\n}\n\n/**\n * Wrap a React function component into a firegraph `ViewComponentClass`.\n *\n * The returned class extends `HTMLElement` and lazily imports `react` and\n * `react-dom/client` at render time. React is resolved from the project's\n * own `node_modules` — firegraph does not bundle or depend on React itself.\n */\nexport function wrapReact(Component: ReactViewComponent, meta: ViewMeta): ViewComponentClass {\n  let React: any = null;\n\n  let ReactDOM: any = null;\n  let loaded = false;\n\n  async function ensureReact() {\n    if (loaded) return;\n    // Dynamic imports — resolved from project's node_modules at runtime\n    const [r, rd] = await Promise.all([\n      Function('return import(\"react\")')() as Promise<unknown>,\n      Function('return import(\"react-dom/client\")')() as Promise<unknown>,\n    ]);\n    React = r;\n    ReactDOM = rd;\n    loaded = true;\n  }\n\n  const Base = getBaseClass();\n\n  const Cls = class extends Base {\n    static viewName = meta.viewName;\n    static description = meta.description;\n\n    _data: Record<string, unknown> = {};\n\n    _root: any = null;\n    _mounted = false;\n\n    set data(v: Record<string, unknown>) {\n      this._data = v;\n      this._render();\n    }\n\n    get data() {\n      return this._data;\n    }\n\n    connectedCallback() {\n      this._mounted = true;\n      this._render();\n    }\n\n    disconnectedCallback() {\n      this._mounted = false;\n      this._root?.unmount();\n      this._root = null;\n    }\n\n    async _render() {\n      if (!this._mounted) return;\n      await ensureReact();\n      if (!this._mounted) return; // may have disconnected while awaiting\n\n      if (!this._root) {\n        this._root = ReactDOM.createRoot(this);\n      }\n      this._root.render(React.createElement(Component, { data: this._data }));\n    }\n  };\n\n  return Cls as unknown as ViewComponentClass;\n}\n"],"mappings":";AAyCA,SAAS,eAAyB;AAChC,QAAM,IAAI;AACV,SAAO,EAAE,eAAe,MAAM;AAAA,EAAC;AACjC;AASO,SAAS,UAAU,WAA+B,MAAoC;AAC3F,MAAI,QAAa;AAEjB,MAAI,WAAgB;AACpB,MAAI,SAAS;AAEb,iBAAe,cAAc;AAC3B,QAAI,OAAQ;AAEZ,UAAM,CAAC,GAAG,EAAE,IAAI,MAAM,QAAQ,IAAI;AAAA,MAChC,SAAS,wBAAwB,EAAE;AAAA,MACnC,SAAS,mCAAmC,EAAE;AAAA,IAChD,CAAC;AACD,YAAQ;AACR,eAAW;AACX,aAAS;AAAA,EACX;AAEA,QAAM,OAAO,aAAa;AAE1B,QAAM,MAAM,cAAc,KAAK;AAAA,IAC7B,OAAO,WAAW,KAAK;AAAA,IACvB,OAAO,cAAc,KAAK;AAAA,IAE1B,QAAiC,CAAC;AAAA,IAElC,QAAa;AAAA,IACb,WAAW;AAAA,IAEX,IAAI,KAAK,GAA4B;AACnC,WAAK,QAAQ;AACb,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,IAAI,OAAO;AACT,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,oBAAoB;AAClB,WAAK,WAAW;AAChB,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,uBAAuB;AACrB,WAAK,WAAW;AAChB,WAAK,OAAO,QAAQ;AACpB,WAAK,QAAQ;AAAA,IACf;AAAA,IAEA,MAAM,UAAU;AACd,UAAI,CAAC,KAAK,SAAU;AACpB,YAAM,YAAY;AAClB,UAAI,CAAC,KAAK,SAAU;AAEpB,UAAI,CAAC,KAAK,OAAO;AACf,aAAK,QAAQ,SAAS,WAAW,IAAI;AAAA,MACvC;AACA,WAAK,MAAM,OAAO,MAAM,cAAc,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAAA,IACxE;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/scope-path-B1G3YiA7.d.cts

@@ -0,0 +1,139 @@
+declare class FiregraphError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+declare class NodeNotFoundError extends FiregraphError {
+    constructor(uid: string);
+}
+declare class EdgeNotFoundError extends FiregraphError {
+    constructor(aUid: string, axbType: string, bUid: string);
+}
+declare class ValidationError extends FiregraphError {
+    readonly details?: unknown | undefined;
+    constructor(message: string, details?: unknown | undefined);
+}
+declare class RegistryViolationError extends FiregraphError {
+    constructor(aType: string, axbType: string, bType: string);
+}
+declare class InvalidQueryError extends FiregraphError {
+    constructor(message: string);
+}
+declare class TraversalError extends FiregraphError {
+    constructor(message: string);
+}
+declare class DynamicRegistryError extends FiregraphError {
+    constructor(message: string);
+}
+declare class QuerySafetyError extends FiregraphError {
+    constructor(message: string);
+}
+declare class RegistryScopeError extends FiregraphError {
+    constructor(aType: string, axbType: string, bType: string, scopePath: string, allowedIn: string[]);
+}
+declare class MigrationError extends FiregraphError {
+    constructor(message: string);
+}
+/**
+ * Thrown when a caller tries to perform an operation that would require
+ * atomicity across two physical storage backends — e.g. opening a routed
+ * subgraph client from inside a transaction callback. Cross-backend
+ * atomicity cannot be honoured by real-world storage engines (Firestore,
+ * SQLite drivers over D1/DO/better-sqlite3, etc.), so firegraph surfaces
+ * this as a typed error instead of silently confining the write to the
+ * base backend.
+ *
+ * Normally `TransactionBackend` and `BatchBackend` don't expose `subgraph()`
+ * at the type level, so this error is unreachable through well-typed code.
+ * It exists as a public catchable type for app code that needs to tolerate
+ * this case deliberately (e.g. dynamic code paths that bypass the type
+ * system) and as future-proofing if the interface ever grows a way to
+ * request a sub-scope inside a transaction.
+ */
+declare class CrossBackendTransactionError extends FiregraphError {
+    constructor(message: string);
+}
+
+/**
+ * Storage-scope path utilities — materialized-path parsing helpers for the
+ * SQLite backend's `storageScope` string and for any custom backend that
+ * adopts the same encoding (e.g. a cross-DO routing layer that uses
+ * `storageScope` as a Durable Object name).
+ *
+ * **Storage-scope** (as produced by `SqliteBackendImpl`) interleaves parent
+ * UIDs with subgraph names:
+ *
+ * ```
+ * ''                                  // root
+ * 'A/memories'                        // g.subgraph(A, 'memories')
+ * 'A/memories/B/context'              // .subgraph(B, 'context') on the above
+ * ```
+ *
+ * The structure is the same as a Firestore collection path with the
+ * collection/doc segments reordered: each pair is `<uid>/<name>`, where
+ * `<uid>` is a node UID in the parent scope and `<name>` is the subgraph
+ * name. Use these helpers to decode that structure when building cross-
+ * backend routers (see `createRoutingBackend`).
+ *
+ * For Firestore paths (which begin with a collection segment), use
+ * `resolveAncestorCollection` / `isAncestorUid` from `./cross-graph.js`.
+ */
+/**
+ * One segment of a materialized-path storage-scope — a `(uid, name)` pair
+ * produced by one `subgraph(uid, name)` call.
+ */
+interface StorageScopeSegment {
+    /** Parent node UID at the enclosing scope. */
+    uid: string;
+    /** Subgraph name chosen by the caller (e.g. `'memories'`). */
+    name: string;
+}
+/**
+ * Parse a materialized-path storage-scope into its `(uid, name)` pairs.
+ *
+ * Returns `[]` for the root (`''`). Throws `Error('INVALID_SCOPE_PATH')`
+ * when the string has an odd number of segments (a corrupt path — every
+ * level contributes exactly two segments) or when any segment is empty.
+ *
+ * @example
+ * ```ts
+ * parseStorageScope('');                         // []
+ * parseStorageScope('A/memories');               // [{ uid: 'A', name: 'memories' }]
+ * parseStorageScope('A/memories/B/context');     // [{ uid: 'A', name: 'memories' }, { uid: 'B', name: 'context' }]
+ * ```
+ */
+declare function parseStorageScope(scope: string): StorageScopeSegment[];
+/**
+ * Resolve the ancestor **storage-scope** at which a given UID's node lives,
+ * by scanning a materialized-path storage-scope for that UID.
+ *
+ * Mirrors `resolveAncestorCollection()` from `./cross-graph.js` for
+ * Firestore paths, but operates on `storageScope` (no leading collection
+ * segment — segments are `<uid>/<name>` pairs).
+ *
+ * @returns The storage-scope at which the UID's node was added via
+ *   `subgraph(uid, _)`, or `null` if the UID does not appear at a UID
+ *   position in the path.
+ *
+ * @example
+ * ```ts
+ * // Scope: 'A/memories/B/context'
+ * resolveAncestorScope('A/memories/B/context', 'A');  // ''    (A was added at root)
+ * resolveAncestorScope('A/memories/B/context', 'B');  // 'A/memories'
+ * resolveAncestorScope('A/memories/B/context', 'X');  // null
+ * ```
+ */
+declare function resolveAncestorScope(storageScope: string, uid: string): string | null;
+/**
+ * Boolean shorthand for `resolveAncestorScope(scope, uid) !== null`.
+ */
+declare function isAncestorScopeUid(storageScope: string, uid: string): boolean;
+/**
+ * Join a parent storage-scope with a new `(uid, name)` pair, producing the
+ * storage-scope that `backend.subgraph(uid, name)` would use internally.
+ *
+ * This is the inverse of `parseStorageScope`'s per-segment semantics and is
+ * useful when computing DO names / shard keys from the router callback.
+ */
+declare function appendStorageScope(parentScope: string, uid: string, name: string): string;
+
+export { CrossBackendTransactionError as C, DynamicRegistryError as D, EdgeNotFoundError as E, FiregraphError as F, InvalidQueryError as I, MigrationError as M, NodeNotFoundError as N, QuerySafetyError as Q, RegistryScopeError as R, type StorageScopeSegment as S, TraversalError as T, ValidationError as V, appendStorageScope as a, RegistryViolationError as b, isAncestorScopeUid as i, parseStorageScope as p, resolveAncestorScope as r };

package/dist/scope-path-B1G3YiA7.d.ts

@@ -0,0 +1,139 @@
+declare class FiregraphError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+declare class NodeNotFoundError extends FiregraphError {
+    constructor(uid: string);
+}
+declare class EdgeNotFoundError extends FiregraphError {
+    constructor(aUid: string, axbType: string, bUid: string);
+}
+declare class ValidationError extends FiregraphError {
+    readonly details?: unknown | undefined;
+    constructor(message: string, details?: unknown | undefined);
+}
+declare class RegistryViolationError extends FiregraphError {
+    constructor(aType: string, axbType: string, bType: string);
+}
+declare class InvalidQueryError extends FiregraphError {
+    constructor(message: string);
+}
+declare class TraversalError extends FiregraphError {
+    constructor(message: string);
+}
+declare class DynamicRegistryError extends FiregraphError {
+    constructor(message: string);
+}
+declare class QuerySafetyError extends FiregraphError {
+    constructor(message: string);
+}
+declare class RegistryScopeError extends FiregraphError {
+    constructor(aType: string, axbType: string, bType: string, scopePath: string, allowedIn: string[]);
+}
+declare class MigrationError extends FiregraphError {
+    constructor(message: string);
+}
+/**
+ * Thrown when a caller tries to perform an operation that would require
+ * atomicity across two physical storage backends — e.g. opening a routed
+ * subgraph client from inside a transaction callback. Cross-backend
+ * atomicity cannot be honoured by real-world storage engines (Firestore,
+ * SQLite drivers over D1/DO/better-sqlite3, etc.), so firegraph surfaces
+ * this as a typed error instead of silently confining the write to the
+ * base backend.
+ *
+ * Normally `TransactionBackend` and `BatchBackend` don't expose `subgraph()`
+ * at the type level, so this error is unreachable through well-typed code.
+ * It exists as a public catchable type for app code that needs to tolerate
+ * this case deliberately (e.g. dynamic code paths that bypass the type
+ * system) and as future-proofing if the interface ever grows a way to
+ * request a sub-scope inside a transaction.
+ */
+declare class CrossBackendTransactionError extends FiregraphError {
+    constructor(message: string);
+}
+
+/**
+ * Storage-scope path utilities — materialized-path parsing helpers for the
+ * SQLite backend's `storageScope` string and for any custom backend that
+ * adopts the same encoding (e.g. a cross-DO routing layer that uses
+ * `storageScope` as a Durable Object name).
+ *
+ * **Storage-scope** (as produced by `SqliteBackendImpl`) interleaves parent
+ * UIDs with subgraph names:
+ *
+ * ```
+ * ''                                  // root
+ * 'A/memories'                        // g.subgraph(A, 'memories')
+ * 'A/memories/B/context'              // .subgraph(B, 'context') on the above
+ * ```
+ *
+ * The structure is the same as a Firestore collection path with the
+ * collection/doc segments reordered: each pair is `<uid>/<name>`, where
+ * `<uid>` is a node UID in the parent scope and `<name>` is the subgraph
+ * name. Use these helpers to decode that structure when building cross-
+ * backend routers (see `createRoutingBackend`).
+ *
+ * For Firestore paths (which begin with a collection segment), use
+ * `resolveAncestorCollection` / `isAncestorUid` from `./cross-graph.js`.
+ */
+/**
+ * One segment of a materialized-path storage-scope — a `(uid, name)` pair
+ * produced by one `subgraph(uid, name)` call.
+ */
+interface StorageScopeSegment {
+    /** Parent node UID at the enclosing scope. */
+    uid: string;
+    /** Subgraph name chosen by the caller (e.g. `'memories'`). */
+    name: string;
+}
+/**
+ * Parse a materialized-path storage-scope into its `(uid, name)` pairs.
+ *
+ * Returns `[]` for the root (`''`). Throws `Error('INVALID_SCOPE_PATH')`
+ * when the string has an odd number of segments (a corrupt path — every
+ * level contributes exactly two segments) or when any segment is empty.
+ *
+ * @example
+ * ```ts
+ * parseStorageScope('');                         // []
+ * parseStorageScope('A/memories');               // [{ uid: 'A', name: 'memories' }]
+ * parseStorageScope('A/memories/B/context');     // [{ uid: 'A', name: 'memories' }, { uid: 'B', name: 'context' }]
+ * ```
+ */
+declare function parseStorageScope(scope: string): StorageScopeSegment[];
+/**
+ * Resolve the ancestor **storage-scope** at which a given UID's node lives,
+ * by scanning a materialized-path storage-scope for that UID.
+ *
+ * Mirrors `resolveAncestorCollection()` from `./cross-graph.js` for
+ * Firestore paths, but operates on `storageScope` (no leading collection
+ * segment — segments are `<uid>/<name>` pairs).
+ *
+ * @returns The storage-scope at which the UID's node was added via
+ *   `subgraph(uid, _)`, or `null` if the UID does not appear at a UID
+ *   position in the path.
+ *
+ * @example
+ * ```ts
+ * // Scope: 'A/memories/B/context'
+ * resolveAncestorScope('A/memories/B/context', 'A');  // ''    (A was added at root)
+ * resolveAncestorScope('A/memories/B/context', 'B');  // 'A/memories'
+ * resolveAncestorScope('A/memories/B/context', 'X');  // null
+ * ```
+ */
+declare function resolveAncestorScope(storageScope: string, uid: string): string | null;
+/**
+ * Boolean shorthand for `resolveAncestorScope(scope, uid) !== null`.
+ */
+declare function isAncestorScopeUid(storageScope: string, uid: string): boolean;
+/**
+ * Join a parent storage-scope with a new `(uid, name)` pair, producing the
+ * storage-scope that `backend.subgraph(uid, name)` would use internally.
+ *
+ * This is the inverse of `parseStorageScope`'s per-segment semantics and is
+ * useful when computing DO names / shard keys from the router callback.
+ */
+declare function appendStorageScope(parentScope: string, uid: string, name: string): string;
+
+export { CrossBackendTransactionError as C, DynamicRegistryError as D, EdgeNotFoundError as E, FiregraphError as F, InvalidQueryError as I, MigrationError as M, NodeNotFoundError as N, QuerySafetyError as Q, RegistryScopeError as R, type StorageScopeSegment as S, TraversalError as T, ValidationError as V, appendStorageScope as a, RegistryViolationError as b, isAncestorScopeUid as i, parseStorageScope as p, resolveAncestorScope as r };

package/dist/{serialization-C6JNNOCS.js → serialization-ZZ7RSDRX.js}

@@ -3,11 +3,11 @@ import {
   deserializeFirestoreTypes,
   isTaggedValue,
   serializeFirestoreTypes
-} from "./chunk-6OQW5OKO.js";
+} from "./chunk-5753Y42M.js";
 export {
   SERIALIZATION_TAG,
   deserializeFirestoreTypes,
   isTaggedValue,
   serializeFirestoreTypes
 };
-//# sourceMappingURL=serialization-C6JNNOCS.js.map
+//# sourceMappingURL=serialization-ZZ7RSDRX.js.map

package/dist/svelte.cjs

@@ -34,9 +34,7 @@ function wrapSvelte(Component, meta) {
     static viewName = meta.viewName;
     static description = meta.description;
     _data = {};
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     _instance = null;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     _props = null;
     _mounted = false;
     set data(v) {

package/dist/svelte.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/svelte.ts"],"sourcesContent":["/**\n * Svelte 5 adapter for firegraph views.\n *\n * Wraps a Svelte component into a Web Component (HTMLElement) that satisfies\n * the firegraph `ViewComponentClass` contract. Import from `firegraph/svelte`:\n *\n * @example\n * ```ts\n * import { wrapSvelte } from 'firegraph/svelte';\n * import TaskCard from './TaskCard.svelte';\n *\n * export default [\n *   wrapSvelte(TaskCard, { viewName: 'card', description: 'Compact task card' }),\n * ];\n * ```\n */\n\nimport type { ViewComponentClass } from './views.js';\n\n/** Metadata required for every firegraph view. */\nexport interface ViewMeta {\n  /** Short identifier (e.g. 'card', 'detail'). */\n  viewName: string;\n  /** Optional human-readable description. */\n  description?: string;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyClass = { new (...args: any[]): any };\n\n/**\n * Get HTMLElement from the runtime environment.\n * Returns a base class for view elements — works in both browser and Node.js\n * (where HTMLElement may be shimmed by the editor server).\n */\nfunction getBaseClass(): AnyClass {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const g = globalThis as any;\n  return g.HTMLElement ?? class {};\n}\n\n/**\n * Wrap a Svelte 5 component into a firegraph `ViewComponentClass`.\n *\n * The returned class extends `HTMLElement` and lazily imports `svelte` at\n * mount time. Svelte is resolved from the project's own `node_modules` —\n * firegraph does not bundle or depend on Svelte itself.\n *\n * The Svelte component should accept a `data` prop:\n * ```svelte\n * <script>\n *   let { data } = $props();\n * </script>\n * ```\n *\n * Props are updated by mutating the props object — Svelte 5's reactivity\n * system picks up the changes automatically.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function wrapSvelte(Component: any, meta: ViewMeta): ViewComponentClass {\n  const Base = getBaseClass();\n\n  const Cls = class extends Base {\n    static viewName = meta.viewName;\n    static description = meta.description;\n\n    _data: Record<string, unknown> = {};\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _instance: any = null;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    _props: any = null;\n    _mounted = false;\n\n    set data(v: Record<string, unknown>) {\n      this._data = v;\n      if (this._props) {\n        // Svelte 5: mutating the props object triggers reactivity\n        this._props.data = v;\n      } else if (this._mounted) {\n        this._mount();\n      }\n    }\n\n    get data() {\n      return this._data;\n    }\n\n    connectedCallback() {\n      this._mounted = true;\n      this._mount();\n    }\n\n    disconnectedCallback() {\n      this._mounted = false;\n      if (this._instance) {\n        // Dynamic import — resolved from project's node_modules at runtime\n        (Function('return import(\"svelte\")')() as Promise<{ unmount: Function }>).then(\n          ({ unmount }) => {\n            if (this._instance) {\n              unmount(this._instance);\n              this._instance = null;\n              this._props = null;\n            }\n          },\n        );\n      }\n    }\n\n    async _mount() {\n      // Dynamic import — resolved from project's node_modules at runtime\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const svelte: any = await (Function('return import(\"svelte\")')() as Promise<unknown>);\n      if (!this._mounted) return; // disconnected while awaiting\n\n      // Clean up previous instance\n      if (this._instance) {\n        svelte.unmount(this._instance);\n      }\n\n      // Svelte 5: pass a props object — mutating it later triggers re-renders\n      this._props = { data: this._data };\n      this._instance = svelte.mount(Component, {\n        target: this,\n        props: this._props,\n      });\n    }\n  };\n\n  return Cls as unknown as ViewComponentClass;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAmCA,SAAS,eAAyB;AAEhC,QAAM,IAAI;AACV,SAAO,EAAE,eAAe,MAAM;AAAA,EAAC;AACjC;AAoBO,SAAS,WAAW,WAAgB,MAAoC;AAC7E,QAAM,OAAO,aAAa;AAE1B,QAAM,MAAM,cAAc,KAAK;AAAA,IAC7B,OAAO,WAAW,KAAK;AAAA,IACvB,OAAO,cAAc,KAAK;AAAA,IAE1B,QAAiC,CAAC;AAAA;AAAA,IAElC,YAAiB;AAAA;AAAA,IAEjB,SAAc;AAAA,IACd,WAAW;AAAA,IAEX,IAAI,KAAK,GAA4B;AACnC,WAAK,QAAQ;AACb,UAAI,KAAK,QAAQ;AAEf,aAAK,OAAO,OAAO;AAAA,MACrB,WAAW,KAAK,UAAU;AACxB,aAAK,OAAO;AAAA,MACd;AAAA,IACF;AAAA,IAEA,IAAI,OAAO;AACT,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,oBAAoB;AAClB,WAAK,WAAW;AAChB,WAAK,OAAO;AAAA,IACd;AAAA,IAEA,uBAAuB;AACrB,WAAK,WAAW;AAChB,UAAI,KAAK,WAAW;AAElB,QAAC,SAAS,yBAAyB,EAAE,EAAqC;AAAA,UACxE,CAAC,EAAE,QAAQ,MAAM;AACf,gBAAI,KAAK,WAAW;AAClB,sBAAQ,KAAK,SAAS;AACtB,mBAAK,YAAY;AACjB,mBAAK,SAAS;AAAA,YAChB;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,SAAS;AAGb,YAAM,SAAc,MAAO,SAAS,yBAAyB,EAAE;AAC/D,UAAI,CAAC,KAAK,SAAU;AAGpB,UAAI,KAAK,WAAW;AAClB,eAAO,QAAQ,KAAK,SAAS;AAAA,MAC/B;AAGA,WAAK,SAAS,EAAE,MAAM,KAAK,MAAM;AACjC,WAAK,YAAY,OAAO,MAAM,WAAW;AAAA,QACvC,QAAQ;AAAA,QACR,OAAO,KAAK;AAAA,MACd,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/svelte.ts"],"sourcesContent":["/**\n * Svelte 5 adapter for firegraph views.\n *\n * Wraps a Svelte component into a Web Component (HTMLElement) that satisfies\n * the firegraph `ViewComponentClass` contract. Import from `firegraph/svelte`:\n *\n * @example\n * ```ts\n * import { wrapSvelte } from 'firegraph/svelte';\n * import TaskCard from './TaskCard.svelte';\n *\n * export default [\n *   wrapSvelte(TaskCard, { viewName: 'card', description: 'Compact task card' }),\n * ];\n * ```\n */\n\nimport type { ViewComponentClass } from './views.js';\n\n/** Metadata required for every firegraph view. */\nexport interface ViewMeta {\n  /** Short identifier (e.g. 'card', 'detail'). */\n  viewName: string;\n  /** Optional human-readable description. */\n  description?: string;\n}\n\ntype AnyClass = { new (...args: any[]): any };\n\n/**\n * Get HTMLElement from the runtime environment.\n * Returns a base class for view elements — works in both browser and Node.js\n * (where HTMLElement may be shimmed by the editor server).\n */\nfunction getBaseClass(): AnyClass {\n  const g = globalThis as any;\n  return g.HTMLElement ?? class {};\n}\n\n/**\n * Wrap a Svelte 5 component into a firegraph `ViewComponentClass`.\n *\n * The returned class extends `HTMLElement` and lazily imports `svelte` at\n * mount time. Svelte is resolved from the project's own `node_modules` —\n * firegraph does not bundle or depend on Svelte itself.\n *\n * The Svelte component should accept a `data` prop:\n * ```svelte\n * <script>\n *   let { data } = $props();\n * </script>\n * ```\n *\n * Props are updated by mutating the props object — Svelte 5's reactivity\n * system picks up the changes automatically.\n */\n\nexport function wrapSvelte(Component: any, meta: ViewMeta): ViewComponentClass {\n  const Base = getBaseClass();\n\n  const Cls = class extends Base {\n    static viewName = meta.viewName;\n    static description = meta.description;\n\n    _data: Record<string, unknown> = {};\n\n    _instance: any = null;\n\n    _props: any = null;\n    _mounted = false;\n\n    set data(v: Record<string, unknown>) {\n      this._data = v;\n      if (this._props) {\n        // Svelte 5: mutating the props object triggers reactivity\n        this._props.data = v;\n      } else if (this._mounted) {\n        this._mount();\n      }\n    }\n\n    get data() {\n      return this._data;\n    }\n\n    connectedCallback() {\n      this._mounted = true;\n      this._mount();\n    }\n\n    disconnectedCallback() {\n      this._mounted = false;\n      if (this._instance) {\n        // Dynamic import — resolved from project's node_modules at runtime\n        (Function('return import(\"svelte\")')() as Promise<{ unmount: Function }>).then(\n          ({ unmount }) => {\n            if (this._instance) {\n              unmount(this._instance);\n              this._instance = null;\n              this._props = null;\n            }\n          },\n        );\n      }\n    }\n\n    async _mount() {\n      // Dynamic import — resolved from project's node_modules at runtime\n\n      const svelte: any = await (Function('return import(\"svelte\")')() as Promise<unknown>);\n      if (!this._mounted) return; // disconnected while awaiting\n\n      // Clean up previous instance\n      if (this._instance) {\n        svelte.unmount(this._instance);\n      }\n\n      // Svelte 5: pass a props object — mutating it later triggers re-renders\n      this._props = { data: this._data };\n      this._instance = svelte.mount(Component, {\n        target: this,\n        props: this._props,\n      });\n    }\n  };\n\n  return Cls as unknown as ViewComponentClass;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAkCA,SAAS,eAAyB;AAChC,QAAM,IAAI;AACV,SAAO,EAAE,eAAe,MAAM;AAAA,EAAC;AACjC;AAoBO,SAAS,WAAW,WAAgB,MAAoC;AAC7E,QAAM,OAAO,aAAa;AAE1B,QAAM,MAAM,cAAc,KAAK;AAAA,IAC7B,OAAO,WAAW,KAAK;AAAA,IACvB,OAAO,cAAc,KAAK;AAAA,IAE1B,QAAiC,CAAC;AAAA,IAElC,YAAiB;AAAA,IAEjB,SAAc;AAAA,IACd,WAAW;AAAA,IAEX,IAAI,KAAK,GAA4B;AACnC,WAAK,QAAQ;AACb,UAAI,KAAK,QAAQ;AAEf,aAAK,OAAO,OAAO;AAAA,MACrB,WAAW,KAAK,UAAU;AACxB,aAAK,OAAO;AAAA,MACd;AAAA,IACF;AAAA,IAEA,IAAI,OAAO;AACT,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,oBAAoB;AAClB,WAAK,WAAW;AAChB,WAAK,OAAO;AAAA,IACd;AAAA,IAEA,uBAAuB;AACrB,WAAK,WAAW;AAChB,UAAI,KAAK,WAAW;AAElB,QAAC,SAAS,yBAAyB,EAAE,EAAqC;AAAA,UACxE,CAAC,EAAE,QAAQ,MAAM;AACf,gBAAI,KAAK,WAAW;AAClB,sBAAQ,KAAK,SAAS;AACtB,mBAAK,YAAY;AACjB,mBAAK,SAAS;AAAA,YAChB;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,SAAS;AAGb,YAAM,SAAc,MAAO,SAAS,yBAAyB,EAAE;AAC/D,UAAI,CAAC,KAAK,SAAU;AAGpB,UAAI,KAAK,WAAW;AAClB,eAAO,QAAQ,KAAK,SAAS;AAAA,MAC/B;AAGA,WAAK,SAAS,EAAE,MAAM,KAAK,MAAM;AACjC,WAAK,YAAY,OAAO,MAAM,WAAW;AAAA,QACvC,QAAQ;AAAA,QACR,OAAO,KAAK;AAAA,MACd,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/svelte.js

@@ -10,9 +10,7 @@ function wrapSvelte(Component, meta) {
     static viewName = meta.viewName;
     static description = meta.description;
     _data = {};
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     _instance = null;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     _props = null;
     _mounted = false;
     set data(v) {