@suss/contract-graphql 0.9.0 → 0.10.0

package/dist/index.cjs

@@ -446,15 +446,19 @@ function graphqlSdlToSummaries(sdl, options = {}) {
   } catch (_err) {
     return [];
   }
-  const source = options.source ?? "graphql";
-  const recognition = options.recognition ?? "graphql";
-  const transport = options.transport ?? "http-graphql";
-  const out = [];
+  const settings = {
+    sdl,
+    source: options.source ?? "graphql",
+    recognition: options.recognition ?? "graphql",
+    transport: options.transport ?? "http-graphql"
+  };
   const rootFields = collectRootFields(doc);
+  if (rootFields.length === 0) {
+    return [];
+  }
+  const out = [buildSchemaDocumentSummary(settings)];
   for (const { rootType, field } of rootFields) {
-    out.push(
-      buildResolverSummary(rootType, field, source, recognition, transport)
-    );
+    out.push(buildResolverSummary(rootType, field, settings));
   }
   return out;
 }
@@ -504,7 +508,8 @@ function collectRootFields(doc) {
 function isRootType(name) {
   return ROOT_TYPES.includes(name);
 }
-function buildResolverSummary(rootType, field, source, recognition, transport) {
+function buildResolverSummary(rootType, field, settings) {
+  const { source, recognition, transport } = settings;
   const fieldName = field.name.value;
   const ownerKey = `${rootType}.${fieldName}`;
   return {
@@ -533,11 +538,30 @@ function buildResolverSummary(rootType, field, source, recognition, transport) {
     // is "derived" because both this metadata and the summary's
     // transitions come from the same SDL field declaration;
     // self-comparison would be tautological.
-    metadata: (0, import_behavioral_ir2.withGraphqlMetadata)(void 0, {
-      rootType,
-      fieldName,
-      declaredContract: buildDeclaredContract(field, recognition)
-    })
+    metadata: (0, import_behavioral_ir2.withGraphqlMetadata)(
+      (0, import_behavioral_ir2.withSourceDocumentMetadata)(void 0, { label: source }),
+      {
+        rootType,
+        fieldName,
+        declaredContract: buildDeclaredContract(field, recognition)
+      }
+    )
+  };
+}
+function buildSchemaDocumentSummary(settings) {
+  const { source, sdl } = settings;
+  return {
+    kind: "library",
+    location: { file: source, range: { start: 0, end: 0 }, exportName: null },
+    identity: { name: source, exportPath: null, boundaryBinding: null },
+    inputs: [],
+    transitions: [],
+    gaps: [],
+    confidence: { source: "derived", level: "high" },
+    metadata: (0, import_behavioral_ir2.withGraphqlMetadata)(
+      (0, import_behavioral_ir2.withSourceDocumentMetadata)(void 0, { label: source }),
+      { schemaSdl: sdl }
+    )
   };
 }
 function buildDeclaredContract(field, recognition) {

package/dist/index.js

@@ -6,7 +6,8 @@ import {
 } from "graphql";
 import {
   graphqlResolverBinding,
-  withGraphqlMetadata as withGraphqlMetadata2
+  withGraphqlMetadata as withGraphqlMetadata2,
+  withSourceDocumentMetadata
 } from "@suss/behavioral-ir";
 
 // src/typeShape.ts
@@ -419,15 +420,19 @@ function graphqlSdlToSummaries(sdl, options = {}) {
   } catch (_err) {
     return [];
   }
-  const source = options.source ?? "graphql";
-  const recognition = options.recognition ?? "graphql";
-  const transport = options.transport ?? "http-graphql";
-  const out = [];
+  const settings = {
+    sdl,
+    source: options.source ?? "graphql",
+    recognition: options.recognition ?? "graphql",
+    transport: options.transport ?? "http-graphql"
+  };
   const rootFields = collectRootFields(doc);
+  if (rootFields.length === 0) {
+    return [];
+  }
+  const out = [buildSchemaDocumentSummary(settings)];
   for (const { rootType, field } of rootFields) {
-    out.push(
-      buildResolverSummary(rootType, field, source, recognition, transport)
-    );
+    out.push(buildResolverSummary(rootType, field, settings));
   }
   return out;
 }
@@ -477,7 +482,8 @@ function collectRootFields(doc) {
 function isRootType(name) {
   return ROOT_TYPES.includes(name);
 }
-function buildResolverSummary(rootType, field, source, recognition, transport) {
+function buildResolverSummary(rootType, field, settings) {
+  const { source, recognition, transport } = settings;
   const fieldName = field.name.value;
   const ownerKey = `${rootType}.${fieldName}`;
   return {
@@ -506,11 +512,30 @@ function buildResolverSummary(rootType, field, source, recognition, transport) {
     // is "derived" because both this metadata and the summary's
     // transitions come from the same SDL field declaration;
     // self-comparison would be tautological.
-    metadata: withGraphqlMetadata2(void 0, {
-      rootType,
-      fieldName,
-      declaredContract: buildDeclaredContract(field, recognition)
-    })
+    metadata: withGraphqlMetadata2(
+      withSourceDocumentMetadata(void 0, { label: source }),
+      {
+        rootType,
+        fieldName,
+        declaredContract: buildDeclaredContract(field, recognition)
+      }
+    )
+  };
+}
+function buildSchemaDocumentSummary(settings) {
+  const { source, sdl } = settings;
+  return {
+    kind: "library",
+    location: { file: source, range: { start: 0, end: 0 }, exportName: null },
+    identity: { name: source, exportPath: null, boundaryBinding: null },
+    inputs: [],
+    transitions: [],
+    gaps: [],
+    confidence: { source: "derived", level: "high" },
+    metadata: withGraphqlMetadata2(
+      withSourceDocumentMetadata(void 0, { label: source }),
+      { schemaSdl: sdl }
+    )
   };
 }
 function buildDeclaredContract(field, recognition) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suss/contract-graphql",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "type": "module",
   "description": "Generate behavioral summaries from GraphQL sources: a plain SDL file (root fields become resolver-kind summaries) or committed .graphql operation documents (each operation becomes a client-kind summary).",
   "keywords": [
@@ -45,7 +45,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@suss/behavioral-ir": "0.9.0",
+    "@suss/behavioral-ir": "0.10.0",
     "graphql": "^16.8.0"
   },
   "devDependencies": {