@supacloud/compiler 0.13.0 → 0.13.1

package/README.md

@@ -72,6 +72,41 @@ Consumers of that optional file must install `@graphql-typed-document-node/core`
 it provides `ResultOf` and `VariablesOf` for operation-level inference. The default
 fetch client still needs no GraphQL runtime dependency.
 
+Both outputs use the operation plugin as the single owner of referenced enums
+and input objects. Regenerate both files after upgrading the compiler; do not
+deduplicate declarations by editing generated files. Scalar mappings are applied
+directly to operation/input fields, and types unused by queries are not emitted.
+
+Consumer acceptance tests cover both SDK and TypedDocumentNode output:
+
+```gherkin
+Scenario: Shared enum types
+  Given multiple queries share an enum in variables and selected fields
+  When the compiler generates the client artifacts
+  Then each artifact declares the enum once and passes strict TypeScript checks
+
+Scenario: Nested input objects
+  Given recursive input objects contain enum lists, defaults and custom scalars
+  When the compiler generates the client artifacts
+  Then input declarations are unique and valid variables retain their types
+
+Scenario: Invalid consumer code
+  Given generated query contracts
+  When a consumer supplies invalid variables or reads an unselected field
+  Then TypeScript rejects the consumer code
+
+Scenario: Release package acceptance
+  Given an installed compiler package
+  When its CLI runs the same consumer acceptance suite
+  Then both artifact formats pass without editing generated files
+```
+
+Run `bun test src/graphql-package.test.ts` from this package. To test an installed
+tarball or registry release with the same suite, set
+`SUPACLOUD_COMPILER_TEST_CLI` to its absolute `dist/cli.js` path.
+`bun run test:package` checks the built CLI and runs automatically after the build
+in `prepublishOnly`, blocking publication when generated consumer types fail.
+
 ```ts
 import { createGraphqlClient } from "./generated/graphql";
 const queries = createGraphqlClient({

package/dist/cli.js

@@ -1226,7 +1226,7 @@ export function createGraphqlClient(options: GraphqlClientOptions) {
       method: "POST",
       headers,
       body: JSON.stringify({ query, variables }),
-      signal: request?.signal,
+      ...(request?.signal ? { signal: request.signal } : {}),
       redirect: "error",
     });
     if (!response.ok) {
@@ -1350,7 +1350,6 @@ import {
   validateSchema
 } from "graphql";
 import { codegen } from "@graphql-codegen/core";
-import * as typescript from "@graphql-codegen/typescript";
 import * as operations from "@graphql-codegen/typescript-operations";
 async function renderGraphql(options) {
   const result = { diagnostics: [], files: {} };
@@ -1456,9 +1455,8 @@ async function renderGraphql(options) {
   try {
     const config = {
       useTypeImports: true,
-      skipTypename: true,
-      enumsAsTypes: true,
-      onlyOperationTypes: true,
+      nonOptionalTypename: false,
+      enumType: "string-literal",
       namingConvention: "keep",
       dedupeOperationSuffix: false,
       omitOperationSuffix: false,
@@ -1471,8 +1469,8 @@ async function renderGraphql(options) {
       schemaAst: schema,
       documents,
       config,
-      plugins: [{ typescript: {} }, { operations: {} }],
-      pluginMap: { typescript, operations }
+      plugins: [{ operations: {} }],
+      pluginMap: { operations }
     });
     const separated = separateOperations(combined);
     const methods = Object.entries(separated).sort(([a], [b]) => a.localeCompare(b)).map(([name, document]) => {
@@ -1504,8 +1502,8 @@ ${methods.join(`,
         schemaAst: schema,
         documents,
         config,
-        plugins: [{ typescript: {} }, { operations: {} }, { typedDocuments: {} }],
-        pluginMap: { typescript, operations, typedDocuments }
+        plugins: [{ operations: {} }, { typedDocuments: {} }],
+        pluginMap: { operations, typedDocuments }
       });
     }
     result.files["graphql.manifest.json"] = JSON.stringify({
@@ -1576,6 +1574,7 @@ async function pullGraphqlSchema(options) {
   const content = path.endsWith(".json") ? JSON.stringify(introspectionFromSchema(schema), null, 2) + `
 ` : `# GENERATED BY supacloud-compiler graphql-schema. DO NOT EDIT.
 # Database First: change database declarations, apply migrations, then re-export for the intended role.
+# Database First: change database declarations, apply migrations, then re-export for the intended role.
 ` + printSchema2(schema) + `
 `;
   let previous;

package/dist/graphql-client.d.ts

@@ -1,2 +1,2 @@
 /** Appended to the generated SDK; browser consumers need only the platform fetch API. */
-export declare const GRAPHQL_CLIENT_SOURCE = "\nexport interface GraphqlClientOptions {\n  /** Project base URL, not the management API URL. HTTPS is required outside loopback. */\n  url: string;\n  /** Public project key only. Never put a service-role or management key in a browser. */\n  publishableKey?: string;\n  /** Resolved on every request so session refresh and logout are observed. */\n  getAccessToken?: () => string | null | undefined | Promise<string | null | undefined>;\n  fetch?: (url: string, init: RequestInit) => Promise<Response>;\n}\n\nexport interface GraphqlRequestOptions {\n  signal?: AbortSignal;\n}\n\nexport class GraphqlRequestError extends Error {\n  constructor(\n    public readonly code: \"http\" | \"graphql\" | \"invalid-response\",\n    message: string,\n    public readonly status?: number,\n    public readonly errors?: readonly unknown[],\n  ) {\n    super(message);\n    this.name = \"GraphqlRequestError\";\n  }\n}\n\nexport function createGraphqlClient(options: GraphqlClientOptions) {\n  const endpoint = new URL(options.url);\n  const loopback = [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(endpoint.hostname);\n  if (endpoint.protocol !== \"https:\" && !(endpoint.protocol === \"http:\" && loopback)) {\n    throw new Error(\"GraphQL requires HTTPS outside loopback development.\");\n  }\n  if (endpoint.username || endpoint.password || endpoint.search || endpoint.hash) {\n    throw new Error(\"GraphQL project URLs must not contain credentials, query parameters or fragments.\");\n  }\n  endpoint.pathname = endpoint.pathname.replace(/\\/$/, \"\") + \"/graphql/v1\";\n  const fetcher = options.fetch ?? globalThis.fetch.bind(globalThis);\n  return getSdk<GraphqlRequestOptions>(async <R, V>(\n    query: string,\n    variables?: V,\n    request?: GraphqlRequestOptions,\n  ): Promise<R> => {\n    const headers = new Headers({ \"Content-Type\": \"application/json\", Accept: \"application/json\" });\n    if (options.publishableKey) headers.set(\"apikey\", options.publishableKey);\n    const token = await options.getAccessToken?.();\n    if (token) headers.set(\"Authorization\", \"Bearer \" + token);\n    const response = await fetcher(endpoint.toString(), {\n      method: \"POST\",\n      headers,\n      body: JSON.stringify({ query, variables }),\n      signal: request?.signal,\n      redirect: \"error\",\n    });\n    if (!response.ok) {\n      throw new GraphqlRequestError(\"http\", \"GraphQL HTTP request failed (\" + response.status + \").\", response.status);\n    }\n    let envelope: unknown;\n    try {\n      envelope = await response.json();\n    } catch {\n      throw new GraphqlRequestError(\"invalid-response\", \"GraphQL returned invalid JSON.\", response.status);\n    }\n    if (!envelope || typeof envelope !== \"object\" || Array.isArray(envelope)) {\n      throw new GraphqlRequestError(\"invalid-response\", \"GraphQL returned an invalid envelope.\", response.status);\n    }\n    if (\"errors\" in envelope) {\n      if (!Array.isArray(envelope.errors)) {\n        throw new GraphqlRequestError(\"invalid-response\", \"GraphQL returned invalid errors.\", response.status);\n      }\n      if (envelope.errors.length > 0) {\n        throw new GraphqlRequestError(\"graphql\", \"GraphQL query failed.\", response.status, envelope.errors);\n      }\n    }\n    if (!(\"data\" in envelope) || !envelope.data || typeof envelope.data !== \"object\" || Array.isArray(envelope.data)) {\n      throw new GraphqlRequestError(\"invalid-response\", \"GraphQL returned no result object.\", response.status);\n    }\n    // Operation types describe the schema snapshot, not runtime response validation.\n    return envelope.data as R;\n  });\n}\n";
+export declare const GRAPHQL_CLIENT_SOURCE = "\nexport interface GraphqlClientOptions {\n  /** Project base URL, not the management API URL. HTTPS is required outside loopback. */\n  url: string;\n  /** Public project key only. Never put a service-role or management key in a browser. */\n  publishableKey?: string;\n  /** Resolved on every request so session refresh and logout are observed. */\n  getAccessToken?: () => string | null | undefined | Promise<string | null | undefined>;\n  fetch?: (url: string, init: RequestInit) => Promise<Response>;\n}\n\nexport interface GraphqlRequestOptions {\n  signal?: AbortSignal;\n}\n\nexport class GraphqlRequestError extends Error {\n  constructor(\n    public readonly code: \"http\" | \"graphql\" | \"invalid-response\",\n    message: string,\n    public readonly status?: number,\n    public readonly errors?: readonly unknown[],\n  ) {\n    super(message);\n    this.name = \"GraphqlRequestError\";\n  }\n}\n\nexport function createGraphqlClient(options: GraphqlClientOptions) {\n  const endpoint = new URL(options.url);\n  const loopback = [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(endpoint.hostname);\n  if (endpoint.protocol !== \"https:\" && !(endpoint.protocol === \"http:\" && loopback)) {\n    throw new Error(\"GraphQL requires HTTPS outside loopback development.\");\n  }\n  if (endpoint.username || endpoint.password || endpoint.search || endpoint.hash) {\n    throw new Error(\"GraphQL project URLs must not contain credentials, query parameters or fragments.\");\n  }\n  endpoint.pathname = endpoint.pathname.replace(/\\/$/, \"\") + \"/graphql/v1\";\n  const fetcher = options.fetch ?? globalThis.fetch.bind(globalThis);\n  return getSdk<GraphqlRequestOptions>(async <R, V>(\n    query: string,\n    variables?: V,\n    request?: GraphqlRequestOptions,\n  ): Promise<R> => {\n    const headers = new Headers({ \"Content-Type\": \"application/json\", Accept: \"application/json\" });\n    if (options.publishableKey) headers.set(\"apikey\", options.publishableKey);\n    const token = await options.getAccessToken?.();\n    if (token) headers.set(\"Authorization\", \"Bearer \" + token);\n    const response = await fetcher(endpoint.toString(), {\n      method: \"POST\",\n      headers,\n      body: JSON.stringify({ query, variables }),\n      ...(request?.signal ? { signal: request.signal } : {}),\n      redirect: \"error\",\n    });\n    if (!response.ok) {\n      throw new GraphqlRequestError(\"http\", \"GraphQL HTTP request failed (\" + response.status + \").\", response.status);\n    }\n    let envelope: unknown;\n    try {\n      envelope = await response.json();\n    } catch {\n      throw new GraphqlRequestError(\"invalid-response\", \"GraphQL returned invalid JSON.\", response.status);\n    }\n    if (!envelope || typeof envelope !== \"object\" || Array.isArray(envelope)) {\n      throw new GraphqlRequestError(\"invalid-response\", \"GraphQL returned an invalid envelope.\", response.status);\n    }\n    if (\"errors\" in envelope) {\n      if (!Array.isArray(envelope.errors)) {\n        throw new GraphqlRequestError(\"invalid-response\", \"GraphQL returned invalid errors.\", response.status);\n      }\n      if (envelope.errors.length > 0) {\n        throw new GraphqlRequestError(\"graphql\", \"GraphQL query failed.\", response.status, envelope.errors);\n      }\n    }\n    if (!(\"data\" in envelope) || !envelope.data || typeof envelope.data !== \"object\" || Array.isArray(envelope.data)) {\n      throw new GraphqlRequestError(\"invalid-response\", \"GraphQL returned no result object.\", response.status);\n    }\n    // Operation types describe the schema snapshot, not runtime response validation.\n    return envelope.data as R;\n  });\n}\n";

package/dist/index.js

@@ -1225,7 +1225,7 @@ export function createGraphqlClient(options: GraphqlClientOptions) {
       method: "POST",
       headers,
       body: JSON.stringify({ query, variables }),
-      signal: request?.signal,
+      ...(request?.signal ? { signal: request.signal } : {}),
       redirect: "error",
     });
     if (!response.ok) {
@@ -1349,7 +1349,6 @@ import {
   validateSchema
 } from "graphql";
 import { codegen } from "@graphql-codegen/core";
-import * as typescript from "@graphql-codegen/typescript";
 import * as operations from "@graphql-codegen/typescript-operations";
 async function renderGraphql(options) {
   const result = { diagnostics: [], files: {} };
@@ -1455,9 +1454,8 @@ async function renderGraphql(options) {
   try {
     const config = {
       useTypeImports: true,
-      skipTypename: true,
-      enumsAsTypes: true,
-      onlyOperationTypes: true,
+      nonOptionalTypename: false,
+      enumType: "string-literal",
       namingConvention: "keep",
       dedupeOperationSuffix: false,
       omitOperationSuffix: false,
@@ -1470,8 +1468,8 @@ async function renderGraphql(options) {
       schemaAst: schema,
       documents,
       config,
-      plugins: [{ typescript: {} }, { operations: {} }],
-      pluginMap: { typescript, operations }
+      plugins: [{ operations: {} }],
+      pluginMap: { operations }
     });
     const separated = separateOperations(combined);
     const methods = Object.entries(separated).sort(([a], [b]) => a.localeCompare(b)).map(([name, document]) => {
@@ -1503,8 +1501,8 @@ ${methods.join(`,
         schemaAst: schema,
         documents,
         config,
-        plugins: [{ typescript: {} }, { operations: {} }, { typedDocuments: {} }],
-        pluginMap: { typescript, operations, typedDocuments }
+        plugins: [{ operations: {} }, { typedDocuments: {} }],
+        pluginMap: { operations, typedDocuments }
       });
     }
     result.files["graphql.manifest.json"] = JSON.stringify({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/compiler",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "description": "Static compiler for @supacloud/app metadata: builds the application graph from AST, validates it, and generates reflection-free factory code",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,8 +25,9 @@
     "build:js": "bun build src/index.ts src/cli.ts --outdir dist --target node --external @typescript/typescript6 --external graphql --external '@graphql-codegen/*'",
     "build:types": "tsc -p tsconfig.json --emitDeclarationOnly",
     "clean": "rm -rf dist",
-    "prepublishOnly": "bun run build",
+    "prepublishOnly": "bun run build && bun run test:package",
     "test": "bun test",
+    "test:package": "SUPACLOUD_COMPILER_TEST_CLI=\"$PWD/dist/cli.js\" bun test src/graphql-package.test.ts",
     "benchmark": "bun run src/benchmark.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "typecheck:test": "tsc -p tsconfig.test.json --noEmit"
@@ -47,7 +48,6 @@
   "dependencies": {
     "@graphql-codegen/core": "^6.2.0",
     "@graphql-codegen/typed-document-node": "^7.1.0",
-    "@graphql-codegen/typescript": "^6.1.0",
     "@graphql-codegen/typescript-operations": "^6.1.6",
     "@graphql-typed-document-node/core": "^3.2.0",
     "@typescript/typescript6": "^6.0.2",