@neat.is/types 0.4.25 → 0.4.26-dev.20260703

package/dist/index.cjs

@@ -53,6 +53,7 @@ __export(index_exports, {
   GraphEdgesResponseSchema: () => GraphEdgesResponseSchema,
   GraphNodeResponseSchema: () => GraphNodeResponseSchema,
   GraphNodeSchema: () => GraphNodeSchema,
+  GraphQLOperationNodeSchema: () => GraphQLOperationNodeSchema,
   HealthResponseSchema: () => HealthResponseSchema,
   HostMismatchDivergenceSchema: () => HostMismatchDivergenceSchema,
   HypotheticalActionSchema: () => HypotheticalActionSchema,
@@ -81,6 +82,7 @@ __export(index_exports, {
   RegistryFileSchema: () => RegistryFileSchema,
   RegistryStatusSchema: () => RegistryStatusSchema,
   RootCauseResultSchema: () => RootCauseResultSchema,
+  RouteNodeSchema: () => RouteNodeSchema,
   SearchMatchSchema: () => SearchMatchSchema,
   SearchResponseSchema: () => SearchResponseSchema,
   SerializedGraphSchema: () => SerializedGraphSchema,
@@ -101,17 +103,22 @@ __export(index_exports, {
   extractedPrecisionFloor: () => extractedPrecisionFloor,
   fileId: () => fileId,
   frontierId: () => frontierId,
+  graphqlOperationId: () => graphqlOperationId,
   inferredEdgeId: () => inferredEdgeId,
   infraId: () => infraId,
+  localDatabaseId: () => localDatabaseId,
   observedEdgeId: () => observedEdgeId,
   parseConfigId: () => parseConfigId,
   parseDatabaseId: () => parseDatabaseId,
   parseEdgeId: () => parseEdgeId,
   parseFileId: () => parseFileId,
   parseFrontierId: () => parseFrontierId,
+  parseGraphqlOperationId: () => parseGraphqlOperationId,
   parseInfraId: () => parseInfraId,
+  parseRouteId: () => parseRouteId,
   parseServiceId: () => parseServiceId,
   passesExtractedFloor: () => passesExtractedFloor,
+  routeId: () => routeId,
   serviceId: () => serviceId
 });
 module.exports = __toCommonJS(index_exports);
@@ -151,7 +158,22 @@ var NodeType = {
   // The primary node of the file-first graph (ADR-089). A source file owned
   // by a service; relationships originate from it. See
   // docs/contracts/file-awareness.md §1.
-  FileNode: "FileNode"
+  FileNode: "FileNode",
+  // A server route at (method, path-template) granularity (ADR-119). Extracted
+  // from a mainstream router (Express / Fastify / Next.js) so a client call
+  // site can be matched to the exact route it names, rather than only to the
+  // owning service. The node an OBSERVED server span lands on too, which is
+  // what makes a two-sided divergence possible at route grain. See
+  // docs/contracts/static-extraction.md.
+  RouteNode: "RouteNode",
+  // A named GraphQL operation — one query, mutation, or subscription — at
+  // (service, operationType, operationName) granularity (ADR-122). Every
+  // GraphQL request rides one HTTP endpoint (POST /graphql), so at HTTP grain
+  // the whole API collapses to a single edge; this node recovers the
+  // operation-level topology from the execution span's `graphql.operation.*`
+  // semconv. Minted observed-first from OTel; a future static GraphQL extractor
+  // fuses onto the same id. See docs/contracts/otel-ingest.md.
+  GraphQLOperationNode: "GraphQLOperationNode"
 };
 var NodeTypeSchema = import_zod.z.enum([
   NodeType.ServiceNode,
@@ -159,7 +181,9 @@ var NodeTypeSchema = import_zod.z.enum([
   NodeType.ConfigNode,
   NodeType.InfraNode,
   NodeType.FrontierNode,
-  NodeType.FileNode
+  NodeType.FileNode,
+  NodeType.RouteNode,
+  NodeType.GraphQLOperationNode
 ]);
 
 // src/nodes.ts
@@ -289,13 +313,38 @@ var FileNodeSchema = import_zod2.z.object({
   // Absent when the call site was already source-grained.
   originalPath: import_zod2.z.string().optional()
 });
+var RouteNodeSchema = import_zod2.z.object({
+  id: import_zod2.z.string(),
+  type: import_zod2.z.literal(NodeType.RouteNode),
+  name: import_zod2.z.string(),
+  service: import_zod2.z.string(),
+  method: import_zod2.z.string(),
+  pathTemplate: import_zod2.z.string(),
+  path: import_zod2.z.string(),
+  line: import_zod2.z.number().int().nonnegative().optional(),
+  framework: import_zod2.z.string().optional(),
+  discoveredVia: DiscoveredViaSchema.optional()
+});
+var GraphQLOperationNodeSchema = import_zod2.z.object({
+  id: import_zod2.z.string(),
+  type: import_zod2.z.literal(NodeType.GraphQLOperationNode),
+  name: import_zod2.z.string(),
+  service: import_zod2.z.string(),
+  operationType: import_zod2.z.string(),
+  operationName: import_zod2.z.string(),
+  path: import_zod2.z.string().optional(),
+  line: import_zod2.z.number().int().nonnegative().optional(),
+  discoveredVia: DiscoveredViaSchema.optional()
+});
 var GraphNodeSchema = import_zod2.z.discriminatedUnion("type", [
   ServiceNodeSchema,
   DatabaseNodeSchema,
   ConfigNodeSchema,
   InfraNodeSchema,
   FrontierNodeSchema,
-  FileNodeSchema
+  FileNodeSchema,
+  RouteNodeSchema,
+  GraphQLOperationNodeSchema
 ]);
 
 // src/edges.ts
@@ -320,7 +369,13 @@ var EdgeTypeSchema = import_zod3.z.enum([
 var EdgeEvidenceSchema = import_zod3.z.object({
   file: import_zod3.z.string(),
   line: import_zod3.z.number().int().nonnegative().optional(),
-  snippet: import_zod3.z.string().optional()
+  snippet: import_zod3.z.string().optional(),
+  // HTTP shape of a recognised client call site (ADR-119). Present on a
+  // client↔route CALLS edge so the edge records the method + path-template the
+  // client named, alongside the file:line it named them at. Absent on every
+  // other edge — a config or infra edge has no HTTP method.
+  method: import_zod3.z.string().optional(),
+  pathTemplate: import_zod3.z.string().optional()
 });
 var EdgeSignalSchema = import_zod3.z.object({
   spanCount: import_zod3.z.number().int().nonnegative(),
@@ -461,6 +516,8 @@ var CONFIG_PREFIX = "config:";
 var INFRA_PREFIX = "infra:";
 var FRONTIER_PREFIX = "frontier:";
 var FILE_PREFIX = "file:";
+var ROUTE_PREFIX = "route:";
+var GRAPHQL_OP_PREFIX = "graphql:";
 var ENV_UNKNOWN = "unknown";
 function serviceId(name, env) {
   if (env === void 0 || env === ENV_UNKNOWN) return `${SERVICE_PREFIX}${name}`;
@@ -480,6 +537,9 @@ function databaseId(host) {
 function parseDatabaseId(id) {
   return id.startsWith(DATABASE_PREFIX) ? id.slice(DATABASE_PREFIX.length) : null;
 }
+function localDatabaseId(service, name) {
+  return `${DATABASE_PREFIX}${service}/${name}`;
+}
 function configId(relPath) {
   return `${CONFIG_PREFIX}${relPath}`;
 }
@@ -515,6 +575,42 @@ function parseFileId(id) {
   if (service.length === 0 || relPath.length === 0) return null;
   return { service, relPath };
 }
+function routeId(service, method, pathTemplate) {
+  return `${ROUTE_PREFIX}${service}:${method.toUpperCase()} ${pathTemplate}`;
+}
+function parseRouteId(id) {
+  if (!id.startsWith(ROUTE_PREFIX)) return null;
+  const rest = id.slice(ROUTE_PREFIX.length);
+  const colon = rest.indexOf(":");
+  if (colon === -1) return null;
+  const service = rest.slice(0, colon);
+  const tail = rest.slice(colon + 1);
+  const space = tail.indexOf(" ");
+  if (space === -1) return null;
+  const method = tail.slice(0, space);
+  const pathTemplate = tail.slice(space + 1);
+  if (service.length === 0 || method.length === 0 || pathTemplate.length === 0) return null;
+  return { service, method, pathTemplate };
+}
+function graphqlOperationId(service, operationType, operationName) {
+  return `${GRAPHQL_OP_PREFIX}${service}:${operationType.toLowerCase()} ${operationName}`;
+}
+function parseGraphqlOperationId(id) {
+  if (!id.startsWith(GRAPHQL_OP_PREFIX)) return null;
+  const rest = id.slice(GRAPHQL_OP_PREFIX.length);
+  const colon = rest.indexOf(":");
+  if (colon === -1) return null;
+  const service = rest.slice(0, colon);
+  const tail = rest.slice(colon + 1);
+  const space = tail.indexOf(" ");
+  if (space === -1) return null;
+  const operationType = tail.slice(0, space);
+  const operationName = tail.slice(space + 1);
+  if (service.length === 0 || operationType.length === 0 || operationName.length === 0) {
+    return null;
+  }
+  return { service, operationType, operationName };
+}
 var EDGE_ARROW = "->";
 function extractedEdgeId(source, target, type) {
   return `${type}:${source}${EDGE_ARROW}${target}`;
@@ -983,6 +1079,7 @@ function passesExtractedFloor(confidence) {
   GraphEdgesResponseSchema,
   GraphNodeResponseSchema,
   GraphNodeSchema,
+  GraphQLOperationNodeSchema,
   HealthResponseSchema,
   HostMismatchDivergenceSchema,
   HypotheticalActionSchema,
@@ -1011,6 +1108,7 @@ function passesExtractedFloor(confidence) {
   RegistryFileSchema,
   RegistryStatusSchema,
   RootCauseResultSchema,
+  RouteNodeSchema,
   SearchMatchSchema,
   SearchResponseSchema,
   SerializedGraphSchema,
@@ -1031,17 +1129,22 @@ function passesExtractedFloor(confidence) {
   extractedPrecisionFloor,
   fileId,
   frontierId,
+  graphqlOperationId,
   inferredEdgeId,
   infraId,
+  localDatabaseId,
   observedEdgeId,
   parseConfigId,
   parseDatabaseId,
   parseEdgeId,
   parseFileId,
   parseFrontierId,
+  parseGraphqlOperationId,
   parseInfraId,
+  parseRouteId,
   parseServiceId,
   passesExtractedFloor,
+  routeId,
   serviceId
 });
 //# sourceMappingURL=index.cjs.map