@lde/search-api-graphql 0.28.0 → 0.29.1

package/dist/build-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-schema.d.ts","sourceRoot":"","sources":["../src/build-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAWL,aAAa,EAQd,MAAM,SAAS,CAAC;AACjB,OAAO,EAKL,KAAK,YAAY,EAIjB,KAAK,WAAW,EAChB,KAAK,YAAY,EAElB,MAAM,aAAa,CAAC;AAsBrB,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAIvB,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B;;sDAEkD;IAClD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACjE;AAED;2EAC2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC;yCACqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;uBACmB;IACnB,QAAQ,CAAC,aAAa,CAAC,EAAE,CACvB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,aAAa,KACnB,WAAW,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC;;kEAE8D;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC7D,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC;;gDAE4C;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AA4GD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,yBAA8B,GACtC,aAAa,CA85Bf;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,yBAA8B,GACtC,MAAM,CAER"}
+{"version":3,"file":"build-schema.d.ts","sourceRoot":"","sources":["../src/build-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAWL,aAAa,EAQd,MAAM,SAAS,CAAC;AACjB,OAAO,EAKL,KAAK,YAAY,EAIjB,KAAK,WAAW,EAChB,KAAK,YAAY,EAElB,MAAM,aAAa,CAAC;AAsBrB,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAIvB,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B;;sDAEkD;IAClD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACjE;AAED;2EAC2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC;yCACqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;uBACmB;IACnB,QAAQ,CAAC,aAAa,CAAC,EAAE,CACvB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,aAAa,KACnB,WAAW,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC;;kEAE8D;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC7D,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC;;gDAE4C;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AA4GD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,yBAA8B,GACtC,aAAa,CAw6Bf;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,yBAA8B,GACtC,MAAM,CAER"}

package/dist/build-schema.js

@@ -342,9 +342,10 @@ export function buildGraphQLSchema(schema, options = {}) {
      * referenced shape. A **surfaced inline** reference is served as the nested
      * object its Reference Type declares – its own `output` fields, configured by
      * exactly the same per-kind rules a root type’s fields are – so the response
-     * shape matches the data’s shape. Its `id` is nullable: a referent needs no
-     * identity, and a blank-node one nests without one. Every other reference
-     * stays the id-plus-label pair its strategy carries.
+     * shape matches the data’s shape. It offers no `id`: a referent needs no
+     * identity, so the projection stores none, and its `output` fields are all a
+     * client can select. Every other reference stays the id-plus-label pair its
+     * strategy carries.
      */
     function registerReferenceType(field, owner) {
         if (field.kind !== 'reference' ||
@@ -383,27 +384,35 @@ export function buildGraphQLSchema(schema, options = {}) {
         const nested = (field.ref.strategy === 'lookup'
             ? rootTypesByName.get(field.ref.target)
             : nestedReferenceType(schema, field));
+        // An inline entry carries no `id`, so its output fields are all a client
+        // can select; GraphQL refuses an object type with none.
+        if (nested.class === undefined && outputFields(nested).length === 0) {
+            throw new Error(`Inline reference “${owner.name}.${field.name}” is \`output\`, but its reference type “${typeName}” declares no \`output\` field, so the API has nothing to serve for an entry; mark a field of “${typeName}” \`output\`, or drop \`output\` from the reference.`);
+        }
         referenceTypes.set(typeName, new GraphQLObjectType({
             name: graphQLName,
             // A thunk, so a Reference Type nesting another one resolves whatever
             // the registration order is (the graph is acyclic by searchSchema).
             fields: () => ({
                 // A lookup resolves a document by IRI, so its `id` is always there.
-                // An inline referent’s is nullable, and load-bearing: a referent
-                // needs no identity, so a blank-node one nests exactly like a named
-                // one, minus this.
+                // An inline referent has none: an entry of a Reference Type is read,
+                // not addressed, so the projection carries no `id` past its own
+                // derives, and a field that is never filled is not offered.
                 //
-                // A `local` lookup is the exception among lookups, for that same
+                // A `local` lookup is the exception among lookups, for a related
                 // reason: it stores what the referring document says about the
                 // endpoint whether or not the endpoint is identified, so an entry
                 // may legitimately arrive without one. Declared non-null, every such
                 // entry would fail the response instead of serving what it has.
-                id: {
-                    type: field.ref?.strategy === 'lookup' &&
-                        !nullableIdTargets.has(typeName)
-                        ? new GraphQLNonNull(iriScalar)
-                        : iriScalar,
-                },
+                ...(nested.class === undefined
+                    ? {}
+                    : {
+                        id: {
+                            type: nullableIdTargets.has(typeName)
+                                ? iriScalar
+                                : new GraphQLNonNull(iriScalar),
+                        },
+                    }),
                 ...Object.fromEntries(outputFields(nested).map((nestedField) => [
                     nestedField.name,
                     // `required` is relaxed for the same reason `id` is above: a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lde/search-api-graphql",
-  "version": "0.28.0",
+  "version": "0.29.1",
   "description": "Engine- and domain-agnostic GraphQL surface for @lde/search: builds an executable GraphQLSchema from a whole SearchSchema at runtime (no codegen) – one root query field per SearchType – served by generic resolvers over any SearchEngine – and serves it as a framework-agnostic fetch handler with a self-contained playground, SDL endpoint, CORS and depth/cost limits. You supply the schema and per-type typeNames; it names neither your domain nor your engine.",
   "repository": {
     "url": "git+https://github.com/ldelements/lde.git",
@@ -36,13 +36,13 @@
   "dependencies": {
     "@escape.tech/graphql-armor-cost-limit": "^2.4.3",
     "@escape.tech/graphql-armor-max-depth": "^2.4.2",
-    "@graphql-yoga/render-graphiql": "^5.21.3",
-    "@lde/search": "^0.26.0",
+    "@graphql-yoga/render-graphiql": "^5.24.2",
+    "@lde/search": "^0.27.1",
     "commander": "^15.0.0",
     "dataloader": "^2.2.3",
     "graphql": "^16.9.0",
-    "graphql-yoga": "^5.21.3",
-    "negotiator": "^1.0.0",
+    "graphql-yoga": "^5.24.1",
+    "negotiator": "^1.1.0",
     "tslib": "^2.3.0"
   },
   "peerDependencies": {