@soda-gql/typegen 0.10.2 → 0.11.1

package/dist/index.d.cts

@@ -9,7 +9,7 @@ import { ResolvedSodaGqlConfig } from "@soda-gql/config";
 /**
  * Error codes specific to typegen operations.
  */
-type TypegenErrorCode = "TYPEGEN_CODEGEN_REQUIRED" | "TYPEGEN_SCHEMA_LOAD_FAILED" | "TYPEGEN_BUILD_FAILED" | "TYPEGEN_EMIT_FAILED" | "TYPEGEN_BUNDLE_FAILED" | "TYPEGEN_FRAGMENT_MISSING_KEY";
+type TypegenErrorCode = "TYPEGEN_CODEGEN_REQUIRED" | "TYPEGEN_SCHEMA_LOAD_FAILED" | "TYPEGEN_BUILD_FAILED" | "TYPEGEN_EMIT_FAILED" | "TYPEGEN_BUNDLE_FAILED";
 /**
  * Typegen-specific error type.
  */
@@ -36,14 +36,6 @@ type TypegenSpecificError = {
   readonly message: string;
   readonly path: string;
   readonly cause?: unknown;
-} | {
-  readonly code: "TYPEGEN_FRAGMENT_MISSING_KEY";
-  readonly message: string;
-  readonly fragments: readonly {
-    readonly canonicalId: string;
-    readonly typename: string;
-    readonly schemaLabel: string;
-  }[];
 };
 /**
  * Union of all typegen errors (specific + builder errors).
@@ -58,11 +50,6 @@ declare const typegenErrors: {
   readonly buildFailed: (message: string, cause?: unknown) => TypegenSpecificError;
   readonly emitFailed: (path: string, message: string, cause?: unknown) => TypegenSpecificError;
   readonly bundleFailed: (path: string, message: string, cause?: unknown) => TypegenSpecificError;
-  readonly fragmentMissingKey: (fragments: readonly {
-    canonicalId: string;
-    typename: string;
-    schemaLabel: string;
-  }[]) => TypegenSpecificError;
 };
 /**
  * Format TypegenError for console output (human-readable).
@@ -160,12 +147,9 @@ type PrebuiltGeneratedModule = {
 /**
  * Generate the prebuilt index module code.
  *
- * Generates index.prebuilt.ts with prebuilt gql composers using
- * createPrebuiltGqlElementComposer. The generated module uses
- * lightweight imports for type serialization compatibility:
- * - Adapters from _internal-injects.ts
- * - Runtime values from _internal.ts
- * - AnyGqlContext instead of heavy Context type inference
+ * Generates index.prebuilt.ts with builder-level type resolution.
+ * Types are resolved at the fragment/operation builder level using TKey/TName,
+ * eliminating the need for ResolvePrebuiltElement at the composer level.
  */
 declare const generatePrebuiltModule: (schemas: Map<string, DocumentNode>, options: PrebuiltGeneratorOptions) => PrebuiltGeneratedModule;
 //#endregion

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors.ts","../src/emitter.ts","../src/prebuilt-generator.ts","../src/types.ts","../src/runner.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors.ts","../src/emitter.ts","../src/prebuilt-generator.ts","../src/types.ts","../src/runner.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.mts

@@ -9,7 +9,7 @@ import { ResolvedSodaGqlConfig } from "@soda-gql/config";
 /**
  * Error codes specific to typegen operations.
  */
-type TypegenErrorCode = "TYPEGEN_CODEGEN_REQUIRED" | "TYPEGEN_SCHEMA_LOAD_FAILED" | "TYPEGEN_BUILD_FAILED" | "TYPEGEN_EMIT_FAILED" | "TYPEGEN_BUNDLE_FAILED" | "TYPEGEN_FRAGMENT_MISSING_KEY";
+type TypegenErrorCode = "TYPEGEN_CODEGEN_REQUIRED" | "TYPEGEN_SCHEMA_LOAD_FAILED" | "TYPEGEN_BUILD_FAILED" | "TYPEGEN_EMIT_FAILED" | "TYPEGEN_BUNDLE_FAILED";
 /**
  * Typegen-specific error type.
  */
@@ -36,14 +36,6 @@ type TypegenSpecificError = {
   readonly message: string;
   readonly path: string;
   readonly cause?: unknown;
-} | {
-  readonly code: "TYPEGEN_FRAGMENT_MISSING_KEY";
-  readonly message: string;
-  readonly fragments: readonly {
-    readonly canonicalId: string;
-    readonly typename: string;
-    readonly schemaLabel: string;
-  }[];
 };
 /**
  * Union of all typegen errors (specific + builder errors).
@@ -58,11 +50,6 @@ declare const typegenErrors: {
   readonly buildFailed: (message: string, cause?: unknown) => TypegenSpecificError;
   readonly emitFailed: (path: string, message: string, cause?: unknown) => TypegenSpecificError;
   readonly bundleFailed: (path: string, message: string, cause?: unknown) => TypegenSpecificError;
-  readonly fragmentMissingKey: (fragments: readonly {
-    canonicalId: string;
-    typename: string;
-    schemaLabel: string;
-  }[]) => TypegenSpecificError;
 };
 /**
  * Format TypegenError for console output (human-readable).
@@ -160,12 +147,9 @@ type PrebuiltGeneratedModule = {
 /**
  * Generate the prebuilt index module code.
  *
- * Generates index.prebuilt.ts with prebuilt gql composers using
- * createPrebuiltGqlElementComposer. The generated module uses
- * lightweight imports for type serialization compatibility:
- * - Adapters from _internal-injects.ts
- * - Runtime values from _internal.ts
- * - AnyGqlContext instead of heavy Context type inference
+ * Generates index.prebuilt.ts with builder-level type resolution.
+ * Types are resolved at the fragment/operation builder level using TKey/TName,
+ * eliminating the need for ResolvePrebuiltElement at the composer level.
  */
 declare const generatePrebuiltModule: (schemas: Map<string, DocumentNode>, options: PrebuiltGeneratorOptions) => PrebuiltGeneratedModule;
 //#endregion

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/errors.ts","../src/emitter.ts","../src/prebuilt-generator.ts","../src/types.ts","../src/runner.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/errors.ts","../src/emitter.ts","../src/prebuilt-generator.ts","../src/types.ts","../src/runner.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -7,78 +7,6 @@ import { err, ok } from "neverthrow";
 import { existsSync, readFileSync } from "node:fs";
 import { build } from "esbuild";
 
-//#region packages/typegen/src/errors.ts
-/**
-* Error constructor helpers for concise error creation.
-*/
-const typegenErrors = {
-	codegenRequired: (outdir) => ({
-		code: "TYPEGEN_CODEGEN_REQUIRED",
-		message: `Generated graphql-system module not found at '${outdir}'. Run 'soda-gql codegen' first.`,
-		outdir
-	}),
-	schemaLoadFailed: (schemaNames, cause) => ({
-		code: "TYPEGEN_SCHEMA_LOAD_FAILED",
-		message: `Failed to load schemas: ${schemaNames.join(", ")}`,
-		schemaNames,
-		cause
-	}),
-	buildFailed: (message, cause) => ({
-		code: "TYPEGEN_BUILD_FAILED",
-		message,
-		cause
-	}),
-	emitFailed: (path, message, cause) => ({
-		code: "TYPEGEN_EMIT_FAILED",
-		message,
-		path,
-		cause
-	}),
-	bundleFailed: (path, message, cause) => ({
-		code: "TYPEGEN_BUNDLE_FAILED",
-		message,
-		path,
-		cause
-	}),
-	fragmentMissingKey: (fragments) => ({
-		code: "TYPEGEN_FRAGMENT_MISSING_KEY",
-		message: `${fragments.length} fragment(s) missing required 'key' property for prebuilt types`,
-		fragments
-	})
-};
-/**
-* Format TypegenError for console output (human-readable).
-*/
-const formatTypegenError = (error) => {
-	const lines = [];
-	lines.push(`Error [${error.code}]: ${error.message}`);
-	switch (error.code) {
-		case "TYPEGEN_CODEGEN_REQUIRED":
-			lines.push(`  Output directory: ${error.outdir}`);
-			lines.push("  Hint: Run 'soda-gql codegen' to generate the graphql-system module first.");
-			break;
-		case "TYPEGEN_SCHEMA_LOAD_FAILED":
-			lines.push(`  Schemas: ${error.schemaNames.join(", ")}`);
-			break;
-		case "TYPEGEN_EMIT_FAILED":
-		case "TYPEGEN_BUNDLE_FAILED":
-			lines.push(`  Path: ${error.path}`);
-			break;
-		case "TYPEGEN_FRAGMENT_MISSING_KEY":
-			lines.push("  Fragments missing 'key' property:");
-			for (const fragment of error.fragments) {
-				lines.push(`    - ${fragment.canonicalId} (${fragment.typename} on ${fragment.schemaLabel})`);
-			}
-			lines.push("  Hint: Add a 'key' property to each fragment for prebuilt type resolution.");
-			break;
-	}
-	if ("cause" in error && error.cause) {
-		lines.push(`  Caused by: ${error.cause}`);
-	}
-	return lines.join("\n");
-};
-
-//#endregion
 //#region packages/typegen/src/emitter.ts
 /**
 * Prebuilt types emitter.
@@ -108,16 +36,15 @@ const formatTypegenError = (error) => {
 * Group field selections by schema.
 * Uses the schemaLabel from each selection to group them correctly.
 *
-* In strict mode, all fragments must have a 'key' property. Fragments
-* without keys will cause an error.
+* Fragments without a 'key' property are skipped (not included in PrebuiltTypes)
+* and a warning is added. This allows projects to use fragments without keys
+* while still generating prebuilt types for those that have keys.
 *
 * @returns Result containing grouped selections and warnings, or error if schema not found
-*          or fragments are missing keys
 */
 const groupBySchema = (fieldSelections, schemas) => {
 	const grouped = new Map();
 	const warnings = [];
-	const missingKeyFragments = [];
 	for (const schemaName of Object.keys(schemas)) {
 		grouped.set(schemaName, {
 			fragments: [],
@@ -139,11 +66,7 @@ const groupBySchema = (fieldSelections, schemas) => {
 		};
 		if (selection.type === "fragment") {
 			if (!selection.key) {
-				missingKeyFragments.push({
-					canonicalId,
-					typename: selection.typename,
-					schemaLabel: selection.schemaLabel
-				});
+				warnings.push(`[prebuilt] Fragment "${canonicalId}" skipped: missing 'key' property`);
 				continue;
 			}
 			try {
@@ -156,6 +79,7 @@ const groupBySchema = (fieldSelections, schemas) => {
 				const inputType = hasVariables ? generateInputTypeFromSpecifiers(schema, selection.variableDefinitions, { formatters: inputFormatters }) : "void";
 				group.fragments.push({
 					key: selection.key,
+					typename: selection.typename,
 					inputType,
 					outputType
 				});
@@ -180,9 +104,6 @@ const groupBySchema = (fieldSelections, schemas) => {
 			}
 		}
 	}
-	if (missingKeyFragments.length > 0) {
-		return err(typegenErrors.fragmentMissingKey(missingKeyFragments));
-	}
 	return ok({
 		grouped,
 		warnings
@@ -315,7 +236,7 @@ const generateTypesCode = (grouped, schemas, injectsModulePath) => {
 			lines.push(...inputTypeLines);
 			lines.push("");
 		}
-		const fragmentEntries = fragments.sort((a, b) => a.key.localeCompare(b.key)).map((f) => `    readonly "${f.key}": { readonly input: ${f.inputType}; readonly output: ${f.outputType} };`);
+		const fragmentEntries = fragments.sort((a, b) => a.key.localeCompare(b.key)).map((f) => `    readonly "${f.key}": { readonly typename: "${f.typename}"; readonly input: ${f.inputType}; readonly output: ${f.outputType} };`);
 		const operationEntries = operations.sort((a, b) => a.key.localeCompare(b.key)).map((o) => `    readonly "${o.key}": { readonly input: ${o.inputType}; readonly output: ${o.outputType} };`);
 		lines.push(`export type PrebuiltTypes_${schemaName} = {`);
 		lines.push("  readonly fragments: {");
@@ -328,7 +249,7 @@ const generateTypesCode = (grouped, schemas, injectsModulePath) => {
 			lines.push(...operationEntries);
 		}
 		lines.push("  };");
-		lines.push("} satisfies PrebuiltTypeRegistry;");
+		lines.push("};");
 		lines.push("");
 	}
 	return lines.join("\n");
@@ -382,17 +303,74 @@ const emitPrebuiltTypes = async (options) => {
 	}
 };
 
+//#endregion
+//#region packages/typegen/src/errors.ts
+/**
+* Error constructor helpers for concise error creation.
+*/
+const typegenErrors = {
+	codegenRequired: (outdir) => ({
+		code: "TYPEGEN_CODEGEN_REQUIRED",
+		message: `Generated graphql-system module not found at '${outdir}'. Run 'soda-gql codegen' first.`,
+		outdir
+	}),
+	schemaLoadFailed: (schemaNames, cause) => ({
+		code: "TYPEGEN_SCHEMA_LOAD_FAILED",
+		message: `Failed to load schemas: ${schemaNames.join(", ")}`,
+		schemaNames,
+		cause
+	}),
+	buildFailed: (message, cause) => ({
+		code: "TYPEGEN_BUILD_FAILED",
+		message,
+		cause
+	}),
+	emitFailed: (path, message, cause) => ({
+		code: "TYPEGEN_EMIT_FAILED",
+		message,
+		path,
+		cause
+	}),
+	bundleFailed: (path, message, cause) => ({
+		code: "TYPEGEN_BUNDLE_FAILED",
+		message,
+		path,
+		cause
+	})
+};
+/**
+* Format TypegenError for console output (human-readable).
+*/
+const formatTypegenError = (error) => {
+	const lines = [];
+	lines.push(`Error [${error.code}]: ${error.message}`);
+	switch (error.code) {
+		case "TYPEGEN_CODEGEN_REQUIRED":
+			lines.push(`  Output directory: ${error.outdir}`);
+			lines.push("  Hint: Run 'soda-gql codegen' to generate the graphql-system module first.");
+			break;
+		case "TYPEGEN_SCHEMA_LOAD_FAILED":
+			lines.push(`  Schemas: ${error.schemaNames.join(", ")}`);
+			break;
+		case "TYPEGEN_EMIT_FAILED":
+		case "TYPEGEN_BUNDLE_FAILED":
+			lines.push(`  Path: ${error.path}`);
+			break;
+	}
+	if ("cause" in error && error.cause) {
+		lines.push(`  Caused by: ${error.cause}`);
+	}
+	return lines.join("\n");
+};
+
 //#endregion
 //#region packages/typegen/src/prebuilt-generator.ts
 /**
 * Generate the prebuilt index module code.
 *
-* Generates index.prebuilt.ts with prebuilt gql composers using
-* createPrebuiltGqlElementComposer. The generated module uses
-* lightweight imports for type serialization compatibility:
-* - Adapters from _internal-injects.ts
-* - Runtime values from _internal.ts
-* - AnyGqlContext instead of heavy Context type inference
+* Generates index.prebuilt.ts with builder-level type resolution.
+* Types are resolved at the fragment/operation builder level using TKey/TName,
+* eliminating the need for ResolvePrebuiltElement at the composer level.
 */
 const generatePrebuiltModule = (schemas, options) => {
 	const schemaNames = Array.from(schemas.keys());
@@ -409,60 +387,165 @@ const generatePrebuiltModule = (schemas, options) => {
 		`__inputTypeMethods_${name}`,
 		`__directiveMethods_${name}`
 	]);
+	const genericTypes = `
+/**
+ * Generic field factory for type-erased field access.
+ * Returns a callable for nested field builders. Primitive fields can be spread directly.
+ * Runtime behavior differs but spread works for both: ...f.id() and ...f.user()(...)
+ */
+type GenericFieldFactory = (
+  ...args: unknown[]
+) => (nest: (tools: GenericFieldsBuilderTools) => AnyFields) => AnyFields;
+
+/**
+ * Generic tools for fields builder callbacks.
+ * Uses type-erased factory to allow any field access while maintaining strict mode compatibility.
+ */
+type GenericFieldsBuilderTools = {
+  readonly f: Record<string, GenericFieldFactory>;
+  readonly $: Record<string, unknown>;
+};
+`;
+	const contextTypes = schemaNames.map((name) => `
+/**
+ * Resolve fragment types at builder level using TKey.
+ * If TKey is a known key in PrebuiltTypes, return resolved types.
+ * Otherwise, return PrebuiltEntryNotFound.
+ */
+type ResolveFragmentAtBuilder_${name}<
+  TKey extends string | undefined
+> = TKey extends keyof PrebuiltTypes_${name}["fragments"]
+  ? Fragment<
+      PrebuiltTypes_${name}["fragments"][TKey]["typename"],
+      PrebuiltTypes_${name}["fragments"][TKey]["input"] extends infer TInput
+        ? TInput extends void ? void : Partial<TInput & object>
+        : void,
+      Partial<AnyFields>,
+      PrebuiltTypes_${name}["fragments"][TKey]["output"] & object
+    >
+  : TKey extends undefined
+    ? Fragment<"(unknown)", PrebuiltEntryNotFound<"(undefined)", "fragment">, Partial<AnyFields>, PrebuiltEntryNotFound<"(undefined)", "fragment">>
+    : Fragment<"(unknown)", PrebuiltEntryNotFound<TKey & string, "fragment">, Partial<AnyFields>, PrebuiltEntryNotFound<TKey & string, "fragment">>;
+
+/**
+ * Resolve operation types at builder level using TName.
+ */
+type ResolveOperationAtBuilder_${name}<
+  TOperationType extends OperationType,
+  TName extends string
+> = TName extends keyof PrebuiltTypes_${name}["operations"]
+  ? Operation<
+      TOperationType,
+      TName,
+      string[],
+      PrebuiltTypes_${name}["operations"][TName]["input"] & AnyConstAssignableInput,
+      Partial<AnyFields>,
+      PrebuiltTypes_${name}["operations"][TName]["output"] & object
+    >
+  : Operation<
+      TOperationType,
+      TName,
+      string[],
+      PrebuiltEntryNotFound<TName, "operation">,
+      Partial<AnyFields>,
+      PrebuiltEntryNotFound<TName, "operation">
+    >;
+
+/**
+ * Fragment builder that resolves types at builder level using TKey.
+ */
+type PrebuiltFragmentBuilder_${name} = <TKey extends string | undefined = undefined>(
+  options: {
+    key?: TKey;
+    fields: (tools: GenericFieldsBuilderTools) => AnyFields;
+    variables?: Record<string, unknown>;
+    metadata?: unknown;
+  }
+) => ResolveFragmentAtBuilder_${name}<TKey>;
+
+/**
+ * Operation builder that resolves types at builder level using TName.
+ */
+type PrebuiltOperationBuilder_${name}<TOperationType extends OperationType> = <TName extends string>(
+  options: {
+    name: TName;
+    fields: (tools: GenericFieldsBuilderTools) => AnyFields;
+    variables?: Record<string, unknown>;
+    metadata?: unknown;
+  }
+) => ResolveOperationAtBuilder_${name}<TOperationType, TName>;
+
+/**
+ * Prebuilt context with builder-level type resolution for schema "${name}".
+ */
+type PrebuiltContext_${name} = {
+  readonly fragment: { [K: string]: PrebuiltFragmentBuilder_${name} };
+  readonly query: { readonly operation: PrebuiltOperationBuilder_${name}<"query"> };
+  readonly mutation: { readonly operation: PrebuiltOperationBuilder_${name}<"mutation"> };
+  readonly subscription: { readonly operation: PrebuiltOperationBuilder_${name}<"subscription"> };
+  readonly $var: unknown;
+  readonly $dir: StandardDirectives;
+  readonly $colocate: unknown;
+};`).join("\n");
 	const gqlEntries = schemaNames.map((name) => {
 		const config = injection.get(name);
-		const adapterArg = config?.hasAdapter ? `adapter: adapter_${name},` : "";
-		return `  ${name}: createPrebuiltGqlElementComposer<
-    AnyGraphqlSchema,
-    PrebuiltTypes_${name},
-    Record<string, unknown>,
-    StandardDirectives,
-    AnyGqlContext
-  >(
+		const adapterLine = config?.hasAdapter ? `,\n      adapter: adapter_${name}` : "";
+		return `  ${name}: createGqlElementComposer(
     __schema_${name} as AnyGraphqlSchema,
     {
       inputTypeMethods: __inputTypeMethods_${name},
-      directiveMethods: __directiveMethods_${name},
-      ${adapterArg}
+      directiveMethods: __directiveMethods_${name}${adapterLine}
     }
-  )`;
+  ) as unknown as GqlComposer_${name}`;
 	});
 	const injectsImportSpecifiers = adapterImports.length > 0 ? adapterImports.join(", ") : "";
 	const injectsImportLine = injectsImportSpecifiers ? `import { ${injectsImportSpecifiers} } from "${options.injectsModulePath}";` : "";
 	const indexCode = `\
 /**
- * Prebuilt GQL module for bundler-compatible type resolution.
- *
- * This module creates prebuilt composers using createPrebuiltGqlElementComposer
- * that look up types from PrebuiltTypes instead of complex inference.
+ * Prebuilt GQL module with builder-level type resolution.
  *
- * Uses lightweight imports:
- * - Adapters from _internal-injects.ts
- * - Runtime values from _internal.ts
- * - AnyGqlContext instead of heavy Context type inference
+ * Types are resolved at the fragment/operation builder level using TKey/TName,
+ * not at the composer level. This enables proper typing for builder arguments
+ * and eliminates the need for ResolvePrebuiltElement.
  *
  * @module
  * @generated by @soda-gql/typegen
  */
 
 import {
-  createPrebuiltGqlElementComposer,
-  type AnyGqlContext,
+  createGqlElementComposer,
+  type AnyConstAssignableInput,
+  type AnyFields,
   type AnyGraphqlSchema,
+  type Fragment,
+  type Operation,
+  type OperationType,
+  type PrebuiltEntryNotFound,
   type StandardDirectives,
 } from "@soda-gql/core";
 ${injectsImportLine}
 import { ${internalImports.join(", ")} } from "${options.internalModulePath}";
 import type { ${schemaNames.map((name) => `PrebuiltTypes_${name}`).join(", ")} } from "./types.prebuilt";
+${genericTypes}
+${contextTypes}
+
+// Export context types for explicit annotation
+${schemaNames.map((name) => `export type { PrebuiltContext_${name} };`).join("\n")}
+
+// Composer type - TResult already has resolved types from builders, no ResolvePrebuiltElement needed
+${schemaNames.map((name) => `type GqlComposer_${name} = {
+  <TResult>(composeElement: (context: PrebuiltContext_${name}) => TResult): TResult;
+  readonly $schema: AnyGraphqlSchema;
+};`).join("\n")}
 
 /**
- * Prebuilt GQL composers with strict type resolution from PrebuiltTypeRegistry.
+ * Prebuilt GQL composers with builder-level type resolution.
  *
  * These composers have the same runtime behavior as the base composers,
  * but their return types are resolved from the prebuilt type registry
- * instead of using complex type inference.
+ * at the builder level instead of using ResolvePrebuiltElement.
  */
-export const gql = {
+export const gql: { ${schemaNames.map((name) => `${name}: GqlComposer_${name}`).join("; ")} } = {
 ${gqlEntries.join(",\n")}
 };
 `;