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

package/dist/index.cjs

@@ -54,6 +54,7 @@ __export(index_exports, {
   GraphNodeResponseSchema: () => GraphNodeResponseSchema,
   GraphNodeSchema: () => GraphNodeSchema,
   GraphQLOperationNodeSchema: () => GraphQLOperationNodeSchema,
+  GrpcMethodNodeSchema: () => GrpcMethodNodeSchema,
   HealthResponseSchema: () => HealthResponseSchema,
   HostMismatchDivergenceSchema: () => HostMismatchDivergenceSchema,
   HypotheticalActionSchema: () => HypotheticalActionSchema,
@@ -95,6 +96,7 @@ __export(index_exports, {
   TransitiveDependenciesResultSchema: () => TransitiveDependenciesResultSchema,
   TransitiveDependencySchema: () => TransitiveDependencySchema,
   VersionMismatchDivergenceSchema: () => VersionMismatchDivergenceSchema,
+  WebSocketChannelNodeSchema: () => WebSocketChannelNodeSchema,
   confidenceForExtracted: () => confidenceForExtracted,
   confidenceForObservedSignal: () => confidenceForObservedSignal,
   configId: () => configId,
@@ -104,6 +106,7 @@ __export(index_exports, {
   fileId: () => fileId,
   frontierId: () => frontierId,
   graphqlOperationId: () => graphqlOperationId,
+  grpcMethodId: () => grpcMethodId,
   inferredEdgeId: () => inferredEdgeId,
   infraId: () => infraId,
   localDatabaseId: () => localDatabaseId,
@@ -114,12 +117,15 @@ __export(index_exports, {
   parseFileId: () => parseFileId,
   parseFrontierId: () => parseFrontierId,
   parseGraphqlOperationId: () => parseGraphqlOperationId,
+  parseGrpcMethodId: () => parseGrpcMethodId,
   parseInfraId: () => parseInfraId,
   parseRouteId: () => parseRouteId,
   parseServiceId: () => parseServiceId,
+  parseWebsocketChannelId: () => parseWebsocketChannelId,
   passesExtractedFloor: () => passesExtractedFloor,
   routeId: () => routeId,
-  serviceId: () => serviceId
+  serviceId: () => serviceId,
+  websocketChannelId: () => websocketChannelId
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -173,7 +179,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 = import_zod.z.enum([
   NodeType.ServiceNode,
@@ -183,7 +213,9 @@ var NodeTypeSchema = import_zod.z.enum([
   NodeType.FrontierNode,
   NodeType.FileNode,
   NodeType.RouteNode,
-  NodeType.GraphQLOperationNode
+  NodeType.GraphQLOperationNode,
+  NodeType.GrpcMethodNode,
+  NodeType.WebSocketChannelNode
 ]);
 
 // src/nodes.ts
@@ -336,6 +368,26 @@ var GraphQLOperationNodeSchema = import_zod2.z.object({
   line: import_zod2.z.number().int().nonnegative().optional(),
   discoveredVia: DiscoveredViaSchema.optional()
 });
+var GrpcMethodNodeSchema = import_zod2.z.object({
+  id: import_zod2.z.string(),
+  type: import_zod2.z.literal(NodeType.GrpcMethodNode),
+  name: import_zod2.z.string(),
+  rpcService: import_zod2.z.string(),
+  rpcMethod: import_zod2.z.string(),
+  path: import_zod2.z.string().optional(),
+  line: import_zod2.z.number().int().nonnegative().optional(),
+  discoveredVia: DiscoveredViaSchema.optional()
+});
+var WebSocketChannelNodeSchema = import_zod2.z.object({
+  id: import_zod2.z.string(),
+  type: import_zod2.z.literal(NodeType.WebSocketChannelNode),
+  name: import_zod2.z.string(),
+  service: import_zod2.z.string(),
+  channel: 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,
@@ -344,7 +396,9 @@ var GraphNodeSchema = import_zod2.z.discriminatedUnion("type", [
   FrontierNodeSchema,
   FileNodeSchema,
   RouteNodeSchema,
-  GraphQLOperationNodeSchema
+  GraphQLOperationNodeSchema,
+  GrpcMethodNodeSchema,
+  WebSocketChannelNodeSchema
 ]);
 
 // src/edges.ts
@@ -518,6 +572,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}`;
@@ -611,6 +667,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}`;
@@ -1080,6 +1162,7 @@ function passesExtractedFloor(confidence) {
   GraphNodeResponseSchema,
   GraphNodeSchema,
   GraphQLOperationNodeSchema,
+  GrpcMethodNodeSchema,
   HealthResponseSchema,
   HostMismatchDivergenceSchema,
   HypotheticalActionSchema,
@@ -1121,6 +1204,7 @@ function passesExtractedFloor(confidence) {
   TransitiveDependenciesResultSchema,
   TransitiveDependencySchema,
   VersionMismatchDivergenceSchema,
+  WebSocketChannelNodeSchema,
   confidenceForExtracted,
   confidenceForObservedSignal,
   configId,
@@ -1130,6 +1214,7 @@ function passesExtractedFloor(confidence) {
   fileId,
   frontierId,
   graphqlOperationId,
+  grpcMethodId,
   inferredEdgeId,
   infraId,
   localDatabaseId,
@@ -1140,11 +1225,14 @@ function passesExtractedFloor(confidence) {
   parseFileId,
   parseFrontierId,
   parseGraphqlOperationId,
+  parseGrpcMethodId,
   parseInfraId,
   parseRouteId,
   parseServiceId,
+  parseWebsocketChannelId,
   passesExtractedFloor,
   routeId,
-  serviceId
+  serviceId,
+  websocketChannelId
 });
 //# sourceMappingURL=index.cjs.map