@soda-gql/typegen 0.10.1 → 0.11.0

package/dist/index.d.mts

@@ -4,6 +4,71 @@ import { DocumentNode } from "graphql";
 import { Result } from "neverthrow";
 import { ResolvedSodaGqlConfig } from "@soda-gql/config";
 
+//#region packages/typegen/src/errors.d.ts
+
+/**
+ * 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";
+/**
+ * Typegen-specific error type.
+ */
+type TypegenSpecificError = {
+  readonly code: "TYPEGEN_CODEGEN_REQUIRED";
+  readonly message: string;
+  readonly outdir: string;
+} | {
+  readonly code: "TYPEGEN_SCHEMA_LOAD_FAILED";
+  readonly message: string;
+  readonly schemaNames: readonly string[];
+  readonly cause?: unknown;
+} | {
+  readonly code: "TYPEGEN_BUILD_FAILED";
+  readonly message: string;
+  readonly cause?: unknown;
+} | {
+  readonly code: "TYPEGEN_EMIT_FAILED";
+  readonly message: string;
+  readonly path: string;
+  readonly cause?: unknown;
+} | {
+  readonly code: "TYPEGEN_BUNDLE_FAILED";
+  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).
+ */
+type TypegenError = TypegenSpecificError | BuilderError;
+/**
+ * Error constructor helpers for concise error creation.
+ */
+declare const typegenErrors: {
+  readonly codegenRequired: (outdir: string) => TypegenSpecificError;
+  readonly schemaLoadFailed: (schemaNames: readonly string[], cause?: unknown) => TypegenSpecificError;
+  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).
+ */
+declare const formatTypegenError: (error: TypegenError) => string;
+//#endregion
 //#region packages/typegen/src/emitter.d.ts
 
 /**
@@ -25,12 +90,10 @@ type PrebuiltTypesEmitterOptions = {
    */
   readonly outdir: string;
   /**
-   * Inject configuration per schema.
-   * Maps schema name to inject file paths (absolute paths).
+   * Relative import path to _internal-injects.ts from types.prebuilt.ts.
+   * Example: "./_internal-injects"
    */
-  readonly injects: Record<string, {
-    readonly scalars: string;
-  }>;
+  readonly injectsModulePath: string;
 };
 /**
  * Result of emitting prebuilt types.
@@ -68,85 +131,38 @@ type PrebuiltTypesEmitResult = {
  * }
  * ```
  */
-declare const emitPrebuiltTypes: (options: PrebuiltTypesEmitterOptions) => Promise<Result<PrebuiltTypesEmitResult, BuilderError>>;
-//#endregion
-//#region packages/typegen/src/errors.d.ts
-/**
- * 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-specific error type.
- */
-type TypegenSpecificError = {
-  readonly code: "TYPEGEN_CODEGEN_REQUIRED";
-  readonly message: string;
-  readonly outdir: string;
-} | {
-  readonly code: "TYPEGEN_SCHEMA_LOAD_FAILED";
-  readonly message: string;
-  readonly schemaNames: readonly string[];
-  readonly cause?: unknown;
-} | {
-  readonly code: "TYPEGEN_BUILD_FAILED";
-  readonly message: string;
-  readonly cause?: unknown;
-} | {
-  readonly code: "TYPEGEN_EMIT_FAILED";
-  readonly message: string;
-  readonly path: string;
-  readonly cause?: unknown;
-} | {
-  readonly code: "TYPEGEN_BUNDLE_FAILED";
-  readonly message: string;
-  readonly path: string;
-  readonly cause?: unknown;
-};
-/**
- * Union of all typegen errors (specific + builder errors).
- */
-type TypegenError = TypegenSpecificError | BuilderError;
-/**
- * Error constructor helpers for concise error creation.
- */
-declare const typegenErrors: {
-  readonly codegenRequired: (outdir: string) => TypegenSpecificError;
-  readonly schemaLoadFailed: (schemaNames: readonly string[], cause?: unknown) => TypegenSpecificError;
-  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;
-};
-/**
- * Format TypegenError for console output (human-readable).
- */
-declare const formatTypegenError: (error: TypegenError) => string;
+declare const emitPrebuiltTypes: (options: PrebuiltTypesEmitterOptions) => Promise<Result<PrebuiltTypesEmitResult, BuilderError | TypegenError>>;
 //#endregion
 //#region packages/typegen/src/prebuilt-generator.d.ts
 type PrebuiltGeneratorOptions = {
   /**
-   * Relative import path to the main gql module.
-   * Example: "../index" (from prebuilt/index.ts to index.ts)
+   * Relative import path to the internal module.
+   * Example: "./_internal" (from index.prebuilt.ts to _internal.ts)
+   */
+  readonly internalModulePath: string;
+  /**
+   * Relative import path to the injects module.
+   * Example: "./_internal-injects" (from index.prebuilt.ts to _internal-injects.ts)
    */
-  readonly mainModulePath: string;
+  readonly injectsModulePath: string;
   /**
-   * Per-schema injection config (adapter import paths).
+   * Per-schema injection config.
+   * Maps schema name to whether it has an adapter.
    */
   readonly injection?: Map<string, {
-    readonly adapterImportPath?: string;
+    readonly hasAdapter?: boolean;
   }>;
 };
 type PrebuiltGeneratedModule = {
-  /** The generated code for prebuilt/index.ts */
+  /** The generated code for index.prebuilt.ts */
   readonly indexCode: string;
-  /** The generated code for prebuilt/types.ts (placeholder) */
-  readonly typesCode: string;
 };
 /**
- * Generate the prebuilt module code.
+ * Generate the prebuilt index module code.
  *
- * This generates:
- * - prebuilt/index.ts: Uses createPrebuiltGqlElementComposer with types from PrebuiltTypes
- * - prebuilt/types.ts: Placeholder types that typegen will populate
+ * 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
@@ -221,10 +237,10 @@ type RunTypegenOptions = {
  *
  * This function:
  * 1. Loads schemas from the generated CJS bundle
- * 2. Generates prebuilt/index.ts using generatePrebuiltModule
+ * 2. Generates index.prebuilt.ts using generatePrebuiltModule
  * 3. Creates a BuilderService and builds the artifact
  * 4. Extracts field selections from the artifact
- * 5. Emits prebuilt/types.ts using emitPrebuiltTypes
+ * 5. Emits types.prebuilt.ts using emitPrebuiltTypes
  * 6. Bundles the prebuilt module
  *
  * @param options - Typegen options including config

package/dist/index.d.mts.map

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