@neat.is/types 0.7.0 → 0.7.2

package/dist/index.js

@@ -109,141 +109,211 @@ var NodeTypeSchema = z.enum([
 ]);
 
 // src/nodes.ts
+import { z as z3 } from "zod";
+
+// src/edges.ts
 import { z as z2 } from "zod";
-var CompatibleDriverSchema = z2.object({
-  name: z2.string(),
-  minVersion: z2.string()
+var ProvenanceSchema = z2.enum([
+  Provenance.EXTRACTED,
+  Provenance.INFERRED,
+  Provenance.OBSERVED,
+  Provenance.STALE
+]);
+var EdgeTypeSchema = z2.enum([
+  EdgeType.CALLS,
+  EdgeType.DEPENDS_ON,
+  EdgeType.CONNECTS_TO,
+  EdgeType.CONFIGURED_BY,
+  EdgeType.PUBLISHES_TO,
+  EdgeType.CONSUMES_FROM,
+  EdgeType.RUNS_ON,
+  EdgeType.CONTAINS,
+  EdgeType.IMPORTS,
+  EdgeType.INHERITS,
+  EdgeType.IMPLEMENTS
+]);
+var EdgeEvidenceSchema = z2.object({
+  file: z2.string(),
+  line: z2.number().int().nonnegative().optional(),
+  snippet: z2.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: z2.string().optional(),
+  pathTemplate: z2.string().optional()
+});
+var EdgeSignalSchema = z2.object({
+  spanCount: z2.number().int().nonnegative(),
+  errorCount: z2.number().int().nonnegative(),
+  lastObservedAgeMs: z2.number().nonnegative().optional()
 });
-var DiscoveredViaSchema = z2.enum(["static", "otel", "merged"]);
-var ServiceNodeSchema = z2.object({
+var GraphEdgeSchema = z2.object({
   id: z2.string(),
-  type: z2.literal(NodeType.ServiceNode),
-  name: z2.string(),
-  language: z2.string(),
+  source: z2.string(),
+  target: z2.string(),
+  type: EdgeTypeSchema,
+  provenance: ProvenanceSchema,
+  confidence: z2.number().min(0).max(1).optional(),
+  lastObserved: z2.string().datetime().optional(),
+  callCount: z2.number().int().nonnegative().optional(),
+  evidence: EdgeEvidenceSchema.optional(),
+  signal: EdgeSignalSchema.optional(),
+  // OBSERVED grain (ADR-142): `file` when the edge originates from a source
+  // file's call site (a `file:` source + `evidence`), `service` for the coarse
+  // fallback where no call site was captured. Makes "service-grained only as a
+  // labeled fallback" (connector gate #803) a stored, machine-readable fact
+  // instead of a re-derivation from the source prefix. `.optional()` — EXTRACTED
+  // edges and legacy snapshots carry none; an OBSERVED edge is backfilled on its
+  // next observation.
+  grain: z2.enum(["file", "service"]).optional()
+});
+
+// src/nodes.ts
+var CompatibleDriverSchema = z3.object({
+  name: z3.string(),
+  minVersion: z3.string()
+});
+var DiscoveredViaSchema = z3.enum(["static", "otel", "merged"]);
+var ServiceNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.ServiceNode),
+  name: z3.string(),
+  language: z3.string(),
   // Deployment environment from the OTel `deployment.environment.name` attr
   // (with `deployment.environment` and resource-attr fallbacks). The literal
   // `'unknown'` is the honest sentinel when no env signal is present; static
   // extraction never sees env at extract time, so its ServiceNodes carry
   // `undefined` here and the id stays in the env-less wire format
   // `service:<name>`. See ADR-074 §2 and docs/contracts/env-dimension.md.
-  env: z2.string().optional(),
+  env: z3.string().optional(),
   // Framework recorded by the static extractor when the install plan
   // dispatches a framework-specific path (Next.js, Remix, SvelteKit, Nuxt,
   // Astro). Optional enrichment — `undefined` for lib-only packages and
   // ambiguous repos. See ADR-074 §3 / docs/contracts/framework-installers.md.
-  framework: z2.string().optional(),
+  framework: z3.string().optional(),
   // The hosting platform a static extractor recognized this service as
   // deployed to (`'cloudflare'` today) — a free string, same discipline as
   // `framework`, so a future platform needs no schema change. This is the
   // frontend's icon key at the service-rollup level (ADR-133,
   // docs/contracts/static-extraction.md).
-  platform: z2.string().optional(),
+  platform: z3.string().optional(),
   discoveredVia: DiscoveredViaSchema.optional(),
-  version: z2.string().optional(),
-  dbConnectionTarget: z2.string().optional(),
-  repoPath: z2.string().optional(),
-  owner: z2.string().optional(),
-  dependencies: z2.record(z2.string(), z2.string()).optional(),
+  version: z3.string().optional(),
+  dbConnectionTarget: z3.string().optional(),
+  repoPath: z3.string().optional(),
+  owner: z3.string().optional(),
+  dependencies: z3.record(z3.string(), z3.string()).optional(),
   // Hostnames OTel spans might mention for this service: compose service
   // names, k8s metadata.name (and the cluster-DNS variants), Dockerfile
   // labels, etc. resolveServiceId in ingest.ts checks these before falling
   // back to a FRONTIER placeholder.
-  aliases: z2.array(z2.string()).optional(),
+  aliases: z3.array(z3.string()).optional(),
   // Optional. If set, services declare their `engines.node` here so γ #74's
   // node-engine compat check has something to test against.
-  nodeEngine: z2.string().optional(),
-  incompatibilities: z2.array(
+  nodeEngine: z3.string().optional(),
+  incompatibilities: z3.array(
     // Discriminated by `kind`. `driver-engine` is the original shape and
     // stays default for backward compatibility — older snapshots without a
     // `kind` field still parse via the union's `.optional()` discriminator
     // fallback. New kinds came in with γ #74.
-    z2.union([
-      z2.object({
-        kind: z2.literal("driver-engine").optional(),
-        driver: z2.string(),
-        driverVersion: z2.string(),
-        engine: z2.string(),
-        engineVersion: z2.string(),
-        reason: z2.string()
+    z3.union([
+      z3.object({
+        kind: z3.literal("driver-engine").optional(),
+        driver: z3.string(),
+        driverVersion: z3.string(),
+        engine: z3.string(),
+        engineVersion: z3.string(),
+        reason: z3.string()
       }),
-      z2.object({
-        kind: z2.literal("node-engine"),
-        package: z2.string(),
-        packageVersion: z2.string().optional(),
-        requiredNodeVersion: z2.string(),
-        declaredNodeEngine: z2.string().optional(),
-        reason: z2.string()
+      z3.object({
+        kind: z3.literal("node-engine"),
+        package: z3.string(),
+        packageVersion: z3.string().optional(),
+        requiredNodeVersion: z3.string(),
+        declaredNodeEngine: z3.string().optional(),
+        reason: z3.string()
       }),
-      z2.object({
-        kind: z2.literal("package-conflict"),
-        package: z2.string(),
-        packageVersion: z2.string().optional(),
-        requires: z2.object({
-          name: z2.string(),
-          minVersion: z2.string()
+      z3.object({
+        kind: z3.literal("package-conflict"),
+        package: z3.string(),
+        packageVersion: z3.string().optional(),
+        requires: z3.object({
+          name: z3.string(),
+          minVersion: z3.string()
         }),
-        foundVersion: z2.string().optional(),
-        reason: z2.string()
+        foundVersion: z3.string().optional(),
+        reason: z3.string()
       }),
-      z2.object({
-        kind: z2.literal("deprecated-api"),
-        package: z2.string(),
-        packageVersion: z2.string().optional(),
-        reason: z2.string()
+      z3.object({
+        kind: z3.literal("deprecated-api"),
+        package: z3.string(),
+        packageVersion: z3.string().optional(),
+        reason: z3.string()
       })
     ])
   ).optional()
 });
-var DatabaseNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.DatabaseNode),
-  name: z2.string(),
-  engine: z2.string(),
-  engineVersion: z2.string(),
-  compatibleDrivers: z2.array(CompatibleDriverSchema),
-  host: z2.string().optional(),
-  port: z2.number().optional(),
+var DatabaseNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.DatabaseNode),
+  name: z3.string(),
+  engine: z3.string(),
+  engineVersion: z3.string(),
+  compatibleDrivers: z3.array(CompatibleDriverSchema),
+  host: z3.string().optional(),
+  port: z3.number().optional(),
   discoveredVia: DiscoveredViaSchema.optional()
 });
-var ConfigNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.ConfigNode),
-  name: z2.string(),
-  path: z2.string(),
-  fileType: z2.string()
+var ConfigNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.ConfigNode),
+  name: z3.string(),
+  path: z3.string(),
+  fileType: z3.string()
 });
-var InfraNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.InfraNode),
-  name: z2.string(),
-  provider: z2.string(),
-  region: z2.string().optional(),
-  kind: z2.string().optional()
+var ColumnAttrSchema = z3.object({
+  name: z3.string(),
+  provenances: z3.array(ProvenanceSchema),
+  confidence: z3.number().min(0).max(1)
 });
-var FrontierNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.FrontierNode),
-  name: z2.string(),
-  host: z2.string(),
-  firstObserved: z2.string().datetime().optional(),
-  lastObserved: z2.string().datetime().optional()
+var InfraNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.InfraNode),
+  name: z3.string(),
+  provider: z3.string(),
+  region: z3.string().optional(),
+  kind: z3.string().optional(),
+  // Column-grain attributes on a table InfraNode (`sql-table`, `supabase-table`).
+  // Absent on a non-table InfraNode (a project node, a queue, a route). Optional
+  // schema growth (ADR-031); ADR-157 stamps the snapshot version because the field
+  // records a new grain the graph can now carry. See docs/contracts/schema.md.
+  columns: z3.array(ColumnAttrSchema).optional()
 });
-var FileNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.FileNode),
-  service: z2.string(),
-  path: z2.string(),
-  language: z2.string().optional(),
+var FrontierNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.FrontierNode),
+  name: z3.string(),
+  host: z3.string(),
+  firstObserved: z3.string().datetime().optional(),
+  lastObserved: z3.string().datetime().optional()
+});
+var FileNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.FileNode),
+  service: z3.string(),
+  path: z3.string(),
+  language: z3.string().optional(),
   discoveredVia: DiscoveredViaSchema.optional(),
   // The raw compiled `dist/...js` frame an OBSERVED call site was captured on,
   // preserved for diagnostic when ingest resolved it through a source map to
   // this original `src/...ts` (file-awareness.md §4 / `code.original_filepath`).
   // Absent when the call site was already source-grained.
-  originalPath: z2.string().optional(),
+  originalPath: z3.string().optional(),
   // The hosting platform this file is the entry point for (`'cloudflare'`
   // today) — set on a Worker/Pages-Function's entry file only, mirroring
   // ServiceNode's own `platform` field. See `platformName` below.
-  platform: z2.string().optional(),
+  platform: z3.string().optional(),
   // The platform's own name for this file's service, when the platform names
   // things differently than NEAT's manifest-derived serviceId (a Cloudflare
   // Worker's wrangler.toml/jsonc `name`, not `package.json#name`). This is the
@@ -251,67 +321,67 @@ var FileNodeSchema = z2.object({
   // connector's resolveTarget looks up against to fuse an OBSERVED signal onto
   // this exact FileNode (ADR-133, docs/contracts/static-extraction.md /
   // docs/contracts/connectors.md).
-  platformName: z2.string().optional()
+  platformName: z3.string().optional()
 });
-var RouteNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.RouteNode),
-  name: z2.string(),
-  service: z2.string(),
-  method: z2.string(),
-  pathTemplate: z2.string(),
-  path: z2.string(),
-  line: z2.number().int().nonnegative().optional(),
-  framework: z2.string().optional(),
+var RouteNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.RouteNode),
+  name: z3.string(),
+  service: z3.string(),
+  method: z3.string(),
+  pathTemplate: z3.string(),
+  path: z3.string(),
+  line: z3.number().int().nonnegative().optional(),
+  framework: z3.string().optional(),
   discoveredVia: DiscoveredViaSchema.optional()
 });
-var GraphQLOperationNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.GraphQLOperationNode),
-  name: z2.string(),
-  service: z2.string(),
-  operationType: z2.string(),
-  operationName: z2.string(),
-  path: z2.string().optional(),
-  line: z2.number().int().nonnegative().optional(),
+var GraphQLOperationNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.GraphQLOperationNode),
+  name: z3.string(),
+  service: z3.string(),
+  operationType: z3.string(),
+  operationName: z3.string(),
+  path: z3.string().optional(),
+  line: z3.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(),
+var GrpcMethodNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.GrpcMethodNode),
+  name: z3.string(),
+  rpcService: z3.string(),
+  rpcMethod: z3.string(),
+  path: z3.string().optional(),
+  line: z3.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(),
+var WebSocketChannelNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.WebSocketChannelNode),
+  name: z3.string(),
+  service: z3.string(),
+  channel: z3.string(),
+  path: z3.string().optional(),
+  line: z3.number().int().nonnegative().optional(),
   discoveredVia: DiscoveredViaSchema.optional()
 });
-var SymbolKindSchema = z2.enum(["function", "method", "constructor", "class"]);
-var SymbolSpanSchema = z2.object({
-  startLine: z2.number().int().nonnegative(),
-  endLine: z2.number().int().nonnegative()
+var SymbolKindSchema = z3.enum(["function", "method", "constructor", "class"]);
+var SymbolSpanSchema = z3.object({
+  startLine: z3.number().int().nonnegative(),
+  endLine: z3.number().int().nonnegative()
 });
-var SymbolNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.SymbolNode),
+var SymbolNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.SymbolNode),
   kind: SymbolKindSchema,
-  qualname: z2.string(),
+  qualname: z3.string(),
   span: SymbolSpanSchema,
-  service: z2.string(),
-  relPath: z2.string(),
+  service: z3.string(),
+  relPath: z3.string(),
   discoveredVia: DiscoveredViaSchema.optional()
 });
-var GraphNodeSchema = z2.discriminatedUnion("type", [
+var GraphNodeSchema = z3.discriminatedUnion("type", [
   ServiceNodeSchema,
   DatabaseNodeSchema,
   ConfigNodeSchema,
@@ -325,64 +395,6 @@ var GraphNodeSchema = z2.discriminatedUnion("type", [
   SymbolNodeSchema
 ]);
 
-// src/edges.ts
-import { z as z3 } from "zod";
-var ProvenanceSchema = z3.enum([
-  Provenance.EXTRACTED,
-  Provenance.INFERRED,
-  Provenance.OBSERVED,
-  Provenance.STALE
-]);
-var EdgeTypeSchema = z3.enum([
-  EdgeType.CALLS,
-  EdgeType.DEPENDS_ON,
-  EdgeType.CONNECTS_TO,
-  EdgeType.CONFIGURED_BY,
-  EdgeType.PUBLISHES_TO,
-  EdgeType.CONSUMES_FROM,
-  EdgeType.RUNS_ON,
-  EdgeType.CONTAINS,
-  EdgeType.IMPORTS,
-  EdgeType.INHERITS,
-  EdgeType.IMPLEMENTS
-]);
-var EdgeEvidenceSchema = z3.object({
-  file: z3.string(),
-  line: z3.number().int().nonnegative().optional(),
-  snippet: z3.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: z3.string().optional(),
-  pathTemplate: z3.string().optional()
-});
-var EdgeSignalSchema = z3.object({
-  spanCount: z3.number().int().nonnegative(),
-  errorCount: z3.number().int().nonnegative(),
-  lastObservedAgeMs: z3.number().nonnegative().optional()
-});
-var GraphEdgeSchema = z3.object({
-  id: z3.string(),
-  source: z3.string(),
-  target: z3.string(),
-  type: EdgeTypeSchema,
-  provenance: ProvenanceSchema,
-  confidence: z3.number().min(0).max(1).optional(),
-  lastObserved: z3.string().datetime().optional(),
-  callCount: z3.number().int().nonnegative().optional(),
-  evidence: EdgeEvidenceSchema.optional(),
-  signal: EdgeSignalSchema.optional(),
-  // OBSERVED grain (ADR-142): `file` when the edge originates from a source
-  // file's call site (a `file:` source + `evidence`), `service` for the coarse
-  // fallback where no call site was captured. Makes "service-grained only as a
-  // labeled fallback" (connector gate #803) a stored, machine-readable fact
-  // instead of a re-derivation from the source prefix. `.optional()` — EXTRACTED
-  // edges and legacy snapshots carry none; an OBSERVED edge is backfilled on its
-  // next observation.
-  grain: z3.enum(["file", "service"]).optional()
-});
-
 // src/events.ts
 import { z as z4 } from "zod";
 var SpanAttributesSchema = z4.record(
@@ -902,14 +914,20 @@ var commonFields = {
 var MissingObservedDivergenceSchema = z8.object({
   type: z8.literal("missing-observed"),
   ...commonFields,
-  edgeType: EdgeTypeSchema,
-  extracted: GraphEdgeSchema
+  edgeType: EdgeTypeSchema.optional(),
+  extracted: GraphEdgeSchema.optional(),
+  // Column locus (ADR-157 §4): the `sql-table` node id and the declared-only column.
+  table: z8.string().optional(),
+  column: z8.string().optional()
 });
 var MissingExtractedDivergenceSchema = z8.object({
   type: z8.literal("missing-extracted"),
   ...commonFields,
-  edgeType: EdgeTypeSchema,
-  observed: GraphEdgeSchema
+  edgeType: EdgeTypeSchema.optional(),
+  observed: GraphEdgeSchema.optional(),
+  // Column locus (ADR-157 §4): the `sql-table` node id and the observed-only column.
+  table: z8.string().optional(),
+  column: z8.string().optional()
 });
 var CompatibilityVerdictSchema = z8.enum(["incompatible", "deprecated", "unknown"]);
 var VersionMismatchDivergenceSchema = z8.object({
@@ -1162,6 +1180,7 @@ export {
   BlastRadiusResultSchema,
   BlastRadiusRuleSchema,
   CheckPoliciesScopeSchema,
+  ColumnAttrSchema,
   CompatRuleRefSchema,
   CompatViolationDivergenceSchema,
   CompatibilityRuleSchema,