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

package/dist/index.js

@@ -48,7 +48,31 @@ var NodeType = {
   // 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"
+  GraphQLOperationNode: "GraphQLOperationNode",
+  // A single gRPC method — one `rpc` in a `.proto` service — at
+  // (rpcService, rpcMethod) granularity (ADR-123). gRPC used to engage only at
+  // service grain: every method collapsed onto one service→service edge, so the
+  // per-method topology was invisible and one-sided. This node recovers the
+  // method-level shape from both sides: the OBSERVED execution span's
+  // `rpc.service` / `rpc.method` semconv and the static `.proto` service/method
+  // definitions. It keys on the fully-qualified `rpc.service` — the wire
+  // contract both sides carry verbatim — so a declared method and an observed
+  // one fuse onto the same node into a two-sided divergence. See
+  // docs/contracts/otel-ingest.md and docs/contracts/static-extraction.md.
+  GrpcMethodNode: "GrpcMethodNode",
+  // A live WebSocket channel — the path/channel a client connects to — at
+  // (service, channel) granularity (ADR-125). A WebSocket app used to produce no
+  // OBSERVED topology at all: only message-handler errors surfaced, as incidents,
+  // and the channels themselves stayed invisible. This node recovers the
+  // channel-level topology from the HTTP upgrade span that opens the connection —
+  // a SERVER `GET` carrying the WebSocket path. It is minted OBSERVED-only: a
+  // WebSocket channel is known from observation, never from static extraction, so
+  // there is no declared twin to fuse with. The edge onto it reuses the existing
+  // `CONNECTS_TO` (`service ──CONNECTS_TO──▶ ws-channel`) as an observed-liveness
+  // edge that carries `lastObserved` and decays OBSERVED → STALE on CONNECTS_TO's
+  // own staleness threshold when the channel goes quiet. See
+  // docs/contracts/otel-ingest.md.
+  WebSocketChannelNode: "WebSocketChannelNode"
 };
 var NodeTypeSchema = z.enum([
   NodeType.ServiceNode,
@@ -58,7 +82,9 @@ var NodeTypeSchema = z.enum([
   NodeType.FrontierNode,
   NodeType.FileNode,
   NodeType.RouteNode,
-  NodeType.GraphQLOperationNode
+  NodeType.GraphQLOperationNode,
+  NodeType.GrpcMethodNode,
+  NodeType.WebSocketChannelNode
 ]);
 
 // src/nodes.ts
@@ -211,6 +237,26 @@ var GraphQLOperationNodeSchema = z2.object({
   line: z2.number().int().nonnegative().optional(),
   discoveredVia: DiscoveredViaSchema.optional()
 });
+var GrpcMethodNodeSchema = z2.object({
+  id: z2.string(),
+  type: z2.literal(NodeType.GrpcMethodNode),
+  name: z2.string(),
+  rpcService: z2.string(),
+  rpcMethod: z2.string(),
+  path: z2.string().optional(),
+  line: z2.number().int().nonnegative().optional(),
+  discoveredVia: DiscoveredViaSchema.optional()
+});
+var WebSocketChannelNodeSchema = z2.object({
+  id: z2.string(),
+  type: z2.literal(NodeType.WebSocketChannelNode),
+  name: z2.string(),
+  service: z2.string(),
+  channel: z2.string(),
+  path: z2.string().optional(),
+  line: z2.number().int().nonnegative().optional(),
+  discoveredVia: DiscoveredViaSchema.optional()
+});
 var GraphNodeSchema = z2.discriminatedUnion("type", [
   ServiceNodeSchema,
   DatabaseNodeSchema,
@@ -219,7 +265,9 @@ var GraphNodeSchema = z2.discriminatedUnion("type", [
   FrontierNodeSchema,
   FileNodeSchema,
   RouteNodeSchema,
-  GraphQLOperationNodeSchema
+  GraphQLOperationNodeSchema,
+  GrpcMethodNodeSchema,
+  WebSocketChannelNodeSchema
 ]);
 
 // src/edges.ts
@@ -393,6 +441,8 @@ var FRONTIER_PREFIX = "frontier:";
 var FILE_PREFIX = "file:";
 var ROUTE_PREFIX = "route:";
 var GRAPHQL_OP_PREFIX = "graphql:";
+var GRPC_METHOD_PREFIX = "grpc:";
+var WEBSOCKET_CHANNEL_PREFIX = "ws:";
 var ENV_UNKNOWN = "unknown";
 function serviceId(name, env) {
   if (env === void 0 || env === ENV_UNKNOWN) return `${SERVICE_PREFIX}${name}`;
@@ -486,6 +536,32 @@ function parseGraphqlOperationId(id) {
   }
   return { service, operationType, operationName };
 }
+function grpcMethodId(rpcService, rpcMethod) {
+  return `${GRPC_METHOD_PREFIX}${rpcService}/${rpcMethod}`;
+}
+function parseGrpcMethodId(id) {
+  if (!id.startsWith(GRPC_METHOD_PREFIX)) return null;
+  const rest = id.slice(GRPC_METHOD_PREFIX.length);
+  const slash = rest.indexOf("/");
+  if (slash === -1) return null;
+  const rpcService = rest.slice(0, slash);
+  const rpcMethod = rest.slice(slash + 1);
+  if (rpcService.length === 0 || rpcMethod.length === 0) return null;
+  return { rpcService, rpcMethod };
+}
+function websocketChannelId(service, channel) {
+  return `${WEBSOCKET_CHANNEL_PREFIX}${service}:${channel}`;
+}
+function parseWebsocketChannelId(id) {
+  if (!id.startsWith(WEBSOCKET_CHANNEL_PREFIX)) return null;
+  const rest = id.slice(WEBSOCKET_CHANNEL_PREFIX.length);
+  const colon = rest.indexOf(":");
+  if (colon === -1) return null;
+  const service = rest.slice(0, colon);
+  const channel = rest.slice(colon + 1);
+  if (service.length === 0 || channel.length === 0) return null;
+  return { service, channel };
+}
 var EDGE_ARROW = "->";
 function extractedEdgeId(source, target, type) {
   return `${type}:${source}${EDGE_ARROW}${target}`;
@@ -954,6 +1030,7 @@ export {
   GraphNodeResponseSchema,
   GraphNodeSchema,
   GraphQLOperationNodeSchema,
+  GrpcMethodNodeSchema,
   HealthResponseSchema,
   HostMismatchDivergenceSchema,
   HypotheticalActionSchema,
@@ -995,6 +1072,7 @@ export {
   TransitiveDependenciesResultSchema,
   TransitiveDependencySchema,
   VersionMismatchDivergenceSchema,
+  WebSocketChannelNodeSchema,
   confidenceForExtracted,
   confidenceForObservedSignal,
   configId,
@@ -1004,6 +1082,7 @@ export {
   fileId,
   frontierId,
   graphqlOperationId,
+  grpcMethodId,
   inferredEdgeId,
   infraId,
   localDatabaseId,
@@ -1014,11 +1093,14 @@ export {
   parseFileId,
   parseFrontierId,
   parseGraphqlOperationId,
+  parseGrpcMethodId,
   parseInfraId,
   parseRouteId,
   parseServiceId,
+  parseWebsocketChannelId,
   passesExtractedFloor,
   routeId,
-  serviceId
+  serviceId,
+  websocketChannelId
 };
 //# sourceMappingURL=index.js.map