@gleanql/codegen 0.1.14 → 0.1.16

package/dist/index.mjs

@@ -138,7 +138,7 @@ function generateTypes(schema, options = {}) {
 function renderTypeBlock(type, ctx) {
 	switch (type.kind) {
 		case "OBJECT": return renderObjectLike(type, ctx, JSON.stringify(type.name));
-		case "INTERFACE": return renderObjectLike(type, ctx, typenameUnionOf(type));
+		case "INTERFACE": return renderInterface(type, ctx);
 		case "UNION": return renderUnion(type);
 		case "ENUM": return renderEnum(type);
 		case "INPUT_OBJECT": return renderInputObject(type, ctx);
@@ -159,6 +159,21 @@ function renderUnion(type) {
 	const body = members.length > 0 ? members.join(" | ") : "never";
 	return `export type ${type.name} = ${body};`;
 }
+/**
+* An interface is narrowable: render it as the union of its possible types, so a
+* `x.__typename === "Product"` guard refines the value to the concrete type and
+* its fields (`x.title`) become accessible — the shape GraphQL selections on an
+* interface root (`nodes(ids:) { ... on Product { title } }`) actually return.
+* Each implementer already carries every interface field (introspection includes
+* inherited fields on each object type), so common-field access (`x.id`) is
+* preserved across the union. Falls back to a thin interface when no possible
+* types surface (e.g. a schema exposing an interface no type implements).
+*/
+function renderInterface(type, ctx) {
+	const members = (type.possibleTypes ?? []).map((p) => namedTypeName(p)).filter((name) => !isInternalType(name));
+	if (members.length === 0) return renderObjectLike(type, ctx, typenameUnionOf(type));
+	return `export type ${type.name} = ${members.join(" | ")};`;
+}
 function renderEnum(type) {
 	const values = (type.enumValues ?? []).map((v) => JSON.stringify(v.name));
 	const body = values.length > 0 ? values.join(" | ") : "never";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gleanql/codegen",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Glean's schema codegen: introspection to schema model, branded types and graph accessors",
   "license": "MIT",
   "author": "Alexander Liljengard",
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@gleanql/core": "0.1.14"
+    "@gleanql/core": "0.1.16"
   },
   "homepage": "https://gleanql.com",
   "bugs": "https://github.com/gleanql/gleanql/issues",

package/src/types.ts

@@ -49,7 +49,7 @@ function renderTypeBlock(type: IntrospectionType, ctx: Ctx): string | undefined
     case "OBJECT":
       return renderObjectLike(type, ctx, JSON.stringify(type.name));
     case "INTERFACE":
-      return renderObjectLike(type, ctx, typenameUnionOf(type));
+      return renderInterface(type, ctx);
     case "UNION":
       return renderUnion(type);
     case "ENUM":
@@ -82,6 +82,24 @@ function renderUnion(type: IntrospectionType): string {
   return `export type ${type.name} = ${body};`;
 }
 
+/**
+ * An interface is narrowable: render it as the union of its possible types, so a
+ * `x.__typename === "Product"` guard refines the value to the concrete type and
+ * its fields (`x.title`) become accessible — the shape GraphQL selections on an
+ * interface root (`nodes(ids:) { ... on Product { title } }`) actually return.
+ * Each implementer already carries every interface field (introspection includes
+ * inherited fields on each object type), so common-field access (`x.id`) is
+ * preserved across the union. Falls back to a thin interface when no possible
+ * types surface (e.g. a schema exposing an interface no type implements).
+ */
+function renderInterface(type: IntrospectionType, ctx: Ctx): string {
+  const members = (type.possibleTypes ?? [])
+    .map((p) => namedTypeName(p))
+    .filter((name) => !isInternalType(name));
+  if (members.length === 0) return renderObjectLike(type, ctx, typenameUnionOf(type));
+  return `export type ${type.name} = ${members.join(" | ")};`;
+}
+
 function renderEnum(type: IntrospectionType): string {
   const values = (type.enumValues ?? []).map((v) => JSON.stringify(v.name));
   const body = values.length > 0 ? values.join(" | ") : "never";