@soda-gql/sdk 0.11.4 → 0.11.5

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://badge.fury.io/js/@soda-gql%2Fsdk.svg)](https://badge.fury.io/js/@soda-gql%2Fsdk)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Programmatic API for soda-gql prebuild operations.
+Programmatic API for soda-gql prebuild and codegen operations.
 
 ## Installation
 
@@ -18,7 +18,8 @@ and build plugins to execute artifact generation without invoking the CLI.
 
 **Key Features:**
 
-- Synchronous and asynchronous build APIs
+- Synchronous and asynchronous build APIs (`prebuild`, `prebuildAsync`)
+- Programmatic code generation from GraphQL schemas (`codegenAsync`)
 - Optional context transformation for modifying composer context
 - Configurable build options (force rebuild, evaluator ID, entrypoints override)
 - Comprehensive error handling with typed Result
@@ -77,6 +78,29 @@ const result = await prebuildAsync({
 });
 ```
 
+### Code Generation
+
+Generate GraphQL runtime modules programmatically:
+
+```typescript
+import { codegenAsync } from "@soda-gql/sdk";
+
+// Generate from config file
+const result = await codegenAsync({
+  configPath: "./soda-gql.config.ts",
+});
+
+if (result.isOk()) {
+  console.log("Generated:", result.value.outPath);
+  console.log("Schemas:", Object.keys(result.value.schemas));
+} else {
+  console.error("Codegen failed:", result.error);
+}
+
+// Without explicit config path (will search for config file)
+const autoResult = await codegenAsync();
+```
+
 ## API Reference
 
 ### `prebuild(options: PrebuildOptions): Result<PrebuildResult, PrebuildError>`
@@ -87,6 +111,11 @@ Synchronously builds GraphQL artifacts based on the provided configuration.
 
 Asynchronously builds GraphQL artifacts. Preferred for build plugins and tools.
 
+### `codegenAsync(options?: CodegenSdkOptions): Promise<Result<CodegenSdkResult, CodegenSdkError>>`
+
+Generates GraphQL runtime modules from schemas defined in config. Wraps the CLI's `codegen` command
+for programmatic use.
+
 ### Types
 
 #### `PrebuildOptions`
@@ -119,6 +148,34 @@ type ContextTransformer = (
 ) => Record<string, unknown>;
 ```
 
+#### `CodegenSdkOptions`
+
+| Property     | Type     | Required | Description                                         |
+| ------------ | -------- | -------- | --------------------------------------------------- |
+| `configPath` | `string` | No       | Path to soda-gql config file (searches if omitted)  |
+
+#### `CodegenSdkResult`
+
+```typescript
+interface CodegenSdkResult {
+  schemas: Record<string, {
+    schemaHash: string;
+    objects: number;
+    enums: number;
+    inputs: number;
+    unions: number;
+  }>;
+  outPath: string;
+  internalPath: string;
+  injectsPath: string;
+  cjsPath: string;
+}
+```
+
+#### `CodegenSdkError`
+
+Union type: `ConfigError | CodegenError`
+
 ## Session Lifecycle
 
 `prebuild` and `prebuildAsync` internally create a BuilderSession and always call `dispose()` after
@@ -152,6 +209,7 @@ may result in incorrect context being applied.
 ## Related Packages
 
 - [@soda-gql/builder](../builder) - Core build system
+- [@soda-gql/codegen](../codegen) - Code generation from GraphQL schemas
 - [@soda-gql/config](../config) - Configuration loading
 - [@soda-gql/core](../core) - GraphQL composition primitives
 

package/dist/index.cjs

@@ -1,8 +1,72 @@
-let __soda_gql_builder = require("@soda-gql/builder");
+let node_path = require("node:path");
+let __soda_gql_codegen = require("@soda-gql/codegen");
 let __soda_gql_config = require("@soda-gql/config");
-let __soda_gql_core__internal = require("@soda-gql/core/_internal");
 let neverthrow = require("neverthrow");
+let __soda_gql_builder = require("@soda-gql/builder");
+let __soda_gql_core__internal = require("@soda-gql/core/_internal");
+
+//#region packages/sdk/src/codegen.ts
+/**
+* Codegen API for programmatic code generation from GraphQL schemas.
+* @module
+*/
+/**
+* Generate GraphQL runtime module asynchronously from a config file.
+*
+* @remarks
+* This function loads the soda-gql config, validates the schemas configuration,
+* and generates TypeScript/CommonJS modules from GraphQL schemas.
+*
+* @param options - Codegen options including optional config path
+* @returns Promise resolving to Result containing the generation result or an error
+*
+* @example
+* ```typescript
+* const result = await codegenAsync({ configPath: './soda-gql.config.ts' });
+* if (result.isOk()) {
+*   console.log('Generated:', result.value.outPath);
+* }
+* ```
+*
+* @example
+* ```typescript
+* // Without explicit config path (will search for config file)
+* const result = await codegenAsync();
+* ```
+*/
+const codegenAsync = async (options = {}) => {
+	const { configPath } = options;
+	const configResult = (0, __soda_gql_config.loadConfig)(configPath);
+	if (configResult.isErr()) {
+		return (0, neverthrow.err)(configResult.error);
+	}
+	const config = configResult.value;
+	if (!config.schemas || Object.keys(config.schemas).length === 0) {
+		return (0, neverthrow.err)({
+			code: "CONFIG_VALIDATION_FAILED",
+			message: "schemas configuration is required in soda-gql config"
+		});
+	}
+	const outPath = (0, node_path.join)(config.outdir, "index.ts");
+	const result = await (0, __soda_gql_codegen.runCodegen)({
+		schemas: config.schemas,
+		outPath,
+		format: "human",
+		importExtension: config.styles.importExtension
+	});
+	if (result.isErr()) {
+		return (0, neverthrow.err)(result.error);
+	}
+	return (0, neverthrow.ok)({
+		schemas: result.value.schemas,
+		outPath: result.value.outPath,
+		internalPath: result.value.internalPath,
+		injectsPath: result.value.injectsPath,
+		cjsPath: result.value.cjsPath
+	});
+};
 
+//#endregion
 //#region packages/sdk/src/prebuild.ts
 /**
 * Prebuild API for programmatic artifact generation.
@@ -108,6 +172,7 @@ const prebuildAsync = async (options) => {
 };
 
 //#endregion
+exports.codegenAsync = codegenAsync;
 exports.prebuild = prebuild;
 exports.prebuildAsync = prebuildAsync;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/prebuild.ts"],"sourcesContent":["/**\n * Prebuild API for programmatic artifact generation.\n * @module\n */\n\nimport { type BuilderArtifact, type BuilderError, createBuilderSession } from \"@soda-gql/builder\";\nimport { type ConfigError, loadConfig } from \"@soda-gql/config\";\nimport { type ContextTransformer, clearContextTransformer, setContextTransformer } from \"@soda-gql/core/_internal\";\nimport { err, type Result } from \"neverthrow\";\n\nexport type { ContextTransformer };\n\n/**\n * Error type for prebuild operations.\n * Can be either a config loading error or a builder error.\n */\nexport type PrebuildError = ConfigError | BuilderError;\n\n/**\n * Options for prebuild functions.\n */\nexport interface PrebuildOptions {\n  /** Path to soda-gql config file */\n  configPath: string;\n  /** Optional context transformer to modify composer context */\n  contextTransformer?: ContextTransformer;\n  /** Unique identifier for this evaluator instance (default: \"default\") */\n  evaluatorId?: string;\n  /** Override entrypoints from config.include */\n  entrypointsOverride?: readonly string[] | ReadonlySet<string>;\n  /** Force rebuild even if no changes detected */\n  force?: boolean;\n}\n\n/**\n * Result of prebuild operations.\n */\nexport interface PrebuildResult {\n  artifact: BuilderArtifact;\n}\n\n/**\n * Build artifact synchronously from a config file.\n *\n * @remarks\n * **Concurrent Execution Warning**: This function uses global state for context transformation.\n * Do not run multiple `prebuild` or `prebuildAsync` calls concurrently with different\n * `contextTransformer` options. Sequential execution is safe.\n *\n * **Session Lifecycle**: This function automatically handles session lifecycle:\n * - Creates a BuilderSession with the resolved config\n * - Calls `session.dispose()` in a finally block to:\n *   - Save incremental build cache to disk\n *   - Unregister from process exit handler\n * - Clears context transformer state after build\n *\n * @param options - Prebuild options including config path and optional transformer\n * @returns Result containing the built artifact or an error\n *\n * @example\n * ```typescript\n * const result = prebuild({ configPath: './soda-gql.config.ts' });\n * if (result.isOk()) {\n *   console.log(result.value.artifact.elements);\n * }\n * ```\n */\nexport const prebuild = (options: PrebuildOptions): Result<PrebuildResult, PrebuildError> => {\n  const { configPath, contextTransformer, evaluatorId, entrypointsOverride, force } = options;\n\n  // Load config from file path\n  const configResult = loadConfig(configPath);\n  if (configResult.isErr()) {\n    return err(configResult.error);\n  }\n  const config = configResult.value;\n\n  const session = createBuilderSession({ config, evaluatorId, entrypointsOverride });\n\n  try {\n    if (contextTransformer) {\n      setContextTransformer(contextTransformer);\n    }\n    const result = session.build({ force });\n    return result.map((artifact) => ({ artifact }));\n  } finally {\n    clearContextTransformer();\n    session.dispose();\n  }\n};\n\n/**\n * Build artifact asynchronously from a config file.\n *\n * @remarks\n * **Concurrent Execution Warning**: This function uses global state for context transformation.\n * Do not run multiple `prebuild` or `prebuildAsync` calls concurrently with different\n * `contextTransformer` options. Sequential execution is safe.\n *\n * **Session Lifecycle**: This function automatically handles session lifecycle:\n * - Creates a BuilderSession with the resolved config\n * - Calls `session.dispose()` in a finally block to:\n *   - Save incremental build cache to disk\n *   - Unregister from process exit handler\n * - Clears context transformer state after build\n *\n * @param options - Prebuild options including config path and optional transformer\n * @returns Promise resolving to Result containing the built artifact or an error\n *\n * @example\n * ```typescript\n * const result = await prebuildAsync({ configPath: './soda-gql.config.ts' });\n * if (result.isOk()) {\n *   console.log(result.value.artifact.elements);\n * }\n * ```\n */\nexport const prebuildAsync = async (options: PrebuildOptions): Promise<Result<PrebuildResult, PrebuildError>> => {\n  const { configPath, contextTransformer, evaluatorId, entrypointsOverride, force } = options;\n\n  // Load config from file path (sync - no async version available)\n  const configResult = loadConfig(configPath);\n  if (configResult.isErr()) {\n    return err(configResult.error);\n  }\n  const config = configResult.value;\n\n  const session = createBuilderSession({ config, evaluatorId, entrypointsOverride });\n\n  try {\n    if (contextTransformer) {\n      setContextTransformer(contextTransformer);\n    }\n    const result = await session.buildAsync({ force });\n    return result.map((artifact) => ({ artifact }));\n  } finally {\n    clearContextTransformer();\n    session.dispose();\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmEA,MAAa,YAAY,YAAoE;CAC3F,MAAM,EAAE,YAAY,oBAAoB,aAAa,qBAAqB,UAAU;CAGpF,MAAM,iDAA0B,WAAW;AAC3C,KAAI,aAAa,OAAO,EAAE;AACxB,6BAAW,aAAa,MAAM;;CAEhC,MAAM,SAAS,aAAa;CAE5B,MAAM,uDAA+B;EAAE;EAAQ;EAAa;EAAqB,CAAC;AAElF,KAAI;AACF,MAAI,oBAAoB;AACtB,wDAAsB,mBAAmB;;EAE3C,MAAM,SAAS,QAAQ,MAAM,EAAE,OAAO,CAAC;AACvC,SAAO,OAAO,KAAK,cAAc,EAAE,UAAU,EAAE;WACvC;AACR,0DAAyB;AACzB,UAAQ,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BrB,MAAa,gBAAgB,OAAO,YAA6E;CAC/G,MAAM,EAAE,YAAY,oBAAoB,aAAa,qBAAqB,UAAU;CAGpF,MAAM,iDAA0B,WAAW;AAC3C,KAAI,aAAa,OAAO,EAAE;AACxB,6BAAW,aAAa,MAAM;;CAEhC,MAAM,SAAS,aAAa;CAE5B,MAAM,uDAA+B;EAAE;EAAQ;EAAa;EAAqB,CAAC;AAElF,KAAI;AACF,MAAI,oBAAoB;AACtB,wDAAsB,mBAAmB;;EAE3C,MAAM,SAAS,MAAM,QAAQ,WAAW,EAAE,OAAO,CAAC;AAClD,SAAO,OAAO,KAAK,cAAc,EAAE,UAAU,EAAE;WACvC;AACR,0DAAyB;AACzB,UAAQ,SAAS"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/codegen.ts","../src/prebuild.ts"],"sourcesContent":["/**\n * Codegen API for programmatic code generation from GraphQL schemas.\n * @module\n */\n\nimport { join } from \"node:path\";\nimport type { CodegenError, CodegenSuccess } from \"@soda-gql/codegen\";\nimport { runCodegen } from \"@soda-gql/codegen\";\nimport type { ConfigError } from \"@soda-gql/config\";\nimport { loadConfig } from \"@soda-gql/config\";\nimport { err, ok, type Result } from \"neverthrow\";\n\n/**\n * Error type for codegen operations.\n * Can be either a config loading error or a codegen error.\n */\nexport type CodegenSdkError = ConfigError | CodegenError;\n\n/**\n * Options for codegenAsync function.\n */\nexport interface CodegenSdkOptions {\n  /** Path to soda-gql config file (optional, will search if not provided) */\n  configPath?: string;\n}\n\n/**\n * Result of codegen operations.\n */\nexport interface CodegenSdkResult {\n  /** Generated schema information */\n  schemas: CodegenSuccess[\"schemas\"];\n  /** Path to generated TypeScript module */\n  outPath: string;\n  /** Path to internal module */\n  internalPath: string;\n  /** Path to injects module */\n  injectsPath: string;\n  /** Path to CommonJS bundle */\n  cjsPath: string;\n}\n\n/**\n * Generate GraphQL runtime module asynchronously from a config file.\n *\n * @remarks\n * This function loads the soda-gql config, validates the schemas configuration,\n * and generates TypeScript/CommonJS modules from GraphQL schemas.\n *\n * @param options - Codegen options including optional config path\n * @returns Promise resolving to Result containing the generation result or an error\n *\n * @example\n * ```typescript\n * const result = await codegenAsync({ configPath: './soda-gql.config.ts' });\n * if (result.isOk()) {\n *   console.log('Generated:', result.value.outPath);\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Without explicit config path (will search for config file)\n * const result = await codegenAsync();\n * ```\n */\nexport const codegenAsync = async (options: CodegenSdkOptions = {}): Promise<Result<CodegenSdkResult, CodegenSdkError>> => {\n  const { configPath } = options;\n\n  // Load config from file path\n  const configResult = loadConfig(configPath);\n  if (configResult.isErr()) {\n    return err(configResult.error);\n  }\n  const config = configResult.value;\n\n  // Validate schemas config exists\n  if (!config.schemas || Object.keys(config.schemas).length === 0) {\n    return err({\n      code: \"CONFIG_VALIDATION_FAILED\",\n      message: \"schemas configuration is required in soda-gql config\",\n    });\n  }\n\n  // Derive output path from outdir (already absolute)\n  const outPath = join(config.outdir, \"index.ts\");\n\n  // Run codegen (config.schemas is already resolved by loadConfig)\n  const result = await runCodegen({\n    schemas: config.schemas,\n    outPath,\n    format: \"human\",\n    importExtension: config.styles.importExtension,\n  });\n\n  if (result.isErr()) {\n    return err(result.error);\n  }\n\n  return ok({\n    schemas: result.value.schemas,\n    outPath: result.value.outPath,\n    internalPath: result.value.internalPath,\n    injectsPath: result.value.injectsPath,\n    cjsPath: result.value.cjsPath,\n  });\n};\n","/**\n * Prebuild API for programmatic artifact generation.\n * @module\n */\n\nimport { type BuilderArtifact, type BuilderError, createBuilderSession } from \"@soda-gql/builder\";\nimport { type ConfigError, loadConfig } from \"@soda-gql/config\";\nimport { type ContextTransformer, clearContextTransformer, setContextTransformer } from \"@soda-gql/core/_internal\";\nimport { err, type Result } from \"neverthrow\";\n\nexport type { ContextTransformer };\n\n/**\n * Error type for prebuild operations.\n * Can be either a config loading error or a builder error.\n */\nexport type PrebuildError = ConfigError | BuilderError;\n\n/**\n * Options for prebuild functions.\n */\nexport interface PrebuildOptions {\n  /** Path to soda-gql config file */\n  configPath: string;\n  /** Optional context transformer to modify composer context */\n  contextTransformer?: ContextTransformer;\n  /** Unique identifier for this evaluator instance (default: \"default\") */\n  evaluatorId?: string;\n  /** Override entrypoints from config.include */\n  entrypointsOverride?: readonly string[] | ReadonlySet<string>;\n  /** Force rebuild even if no changes detected */\n  force?: boolean;\n}\n\n/**\n * Result of prebuild operations.\n */\nexport interface PrebuildResult {\n  artifact: BuilderArtifact;\n}\n\n/**\n * Build artifact synchronously from a config file.\n *\n * @remarks\n * **Concurrent Execution Warning**: This function uses global state for context transformation.\n * Do not run multiple `prebuild` or `prebuildAsync` calls concurrently with different\n * `contextTransformer` options. Sequential execution is safe.\n *\n * **Session Lifecycle**: This function automatically handles session lifecycle:\n * - Creates a BuilderSession with the resolved config\n * - Calls `session.dispose()` in a finally block to:\n *   - Save incremental build cache to disk\n *   - Unregister from process exit handler\n * - Clears context transformer state after build\n *\n * @param options - Prebuild options including config path and optional transformer\n * @returns Result containing the built artifact or an error\n *\n * @example\n * ```typescript\n * const result = prebuild({ configPath: './soda-gql.config.ts' });\n * if (result.isOk()) {\n *   console.log(result.value.artifact.elements);\n * }\n * ```\n */\nexport const prebuild = (options: PrebuildOptions): Result<PrebuildResult, PrebuildError> => {\n  const { configPath, contextTransformer, evaluatorId, entrypointsOverride, force } = options;\n\n  // Load config from file path\n  const configResult = loadConfig(configPath);\n  if (configResult.isErr()) {\n    return err(configResult.error);\n  }\n  const config = configResult.value;\n\n  const session = createBuilderSession({ config, evaluatorId, entrypointsOverride });\n\n  try {\n    if (contextTransformer) {\n      setContextTransformer(contextTransformer);\n    }\n    const result = session.build({ force });\n    return result.map((artifact) => ({ artifact }));\n  } finally {\n    clearContextTransformer();\n    session.dispose();\n  }\n};\n\n/**\n * Build artifact asynchronously from a config file.\n *\n * @remarks\n * **Concurrent Execution Warning**: This function uses global state for context transformation.\n * Do not run multiple `prebuild` or `prebuildAsync` calls concurrently with different\n * `contextTransformer` options. Sequential execution is safe.\n *\n * **Session Lifecycle**: This function automatically handles session lifecycle:\n * - Creates a BuilderSession with the resolved config\n * - Calls `session.dispose()` in a finally block to:\n *   - Save incremental build cache to disk\n *   - Unregister from process exit handler\n * - Clears context transformer state after build\n *\n * @param options - Prebuild options including config path and optional transformer\n * @returns Promise resolving to Result containing the built artifact or an error\n *\n * @example\n * ```typescript\n * const result = await prebuildAsync({ configPath: './soda-gql.config.ts' });\n * if (result.isOk()) {\n *   console.log(result.value.artifact.elements);\n * }\n * ```\n */\nexport const prebuildAsync = async (options: PrebuildOptions): Promise<Result<PrebuildResult, PrebuildError>> => {\n  const { configPath, contextTransformer, evaluatorId, entrypointsOverride, force } = options;\n\n  // Load config from file path (sync - no async version available)\n  const configResult = loadConfig(configPath);\n  if (configResult.isErr()) {\n    return err(configResult.error);\n  }\n  const config = configResult.value;\n\n  const session = createBuilderSession({ config, evaluatorId, entrypointsOverride });\n\n  try {\n    if (contextTransformer) {\n      setContextTransformer(contextTransformer);\n    }\n    const result = await session.buildAsync({ force });\n    return result.map((artifact) => ({ artifact }));\n  } finally {\n    clearContextTransformer();\n    session.dispose();\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,MAAa,eAAe,OAAO,UAA6B,EAAE,KAAyD;CACzH,MAAM,EAAE,eAAe;CAGvB,MAAM,iDAA0B,WAAW;AAC3C,KAAI,aAAa,OAAO,EAAE;AACxB,6BAAW,aAAa,MAAM;;CAEhC,MAAM,SAAS,aAAa;AAG5B,KAAI,CAAC,OAAO,WAAW,OAAO,KAAK,OAAO,QAAQ,CAAC,WAAW,GAAG;AAC/D,6BAAW;GACT,MAAM;GACN,SAAS;GACV,CAAC;;CAIJ,MAAM,8BAAe,OAAO,QAAQ,WAAW;CAG/C,MAAM,SAAS,yCAAiB;EAC9B,SAAS,OAAO;EAChB;EACA,QAAQ;EACR,iBAAiB,OAAO,OAAO;EAChC,CAAC;AAEF,KAAI,OAAO,OAAO,EAAE;AAClB,6BAAW,OAAO,MAAM;;AAG1B,2BAAU;EACR,SAAS,OAAO,MAAM;EACtB,SAAS,OAAO,MAAM;EACtB,cAAc,OAAO,MAAM;EAC3B,aAAa,OAAO,MAAM;EAC1B,SAAS,OAAO,MAAM;EACvB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACtCJ,MAAa,YAAY,YAAoE;CAC3F,MAAM,EAAE,YAAY,oBAAoB,aAAa,qBAAqB,UAAU;CAGpF,MAAM,iDAA0B,WAAW;AAC3C,KAAI,aAAa,OAAO,EAAE;AACxB,6BAAW,aAAa,MAAM;;CAEhC,MAAM,SAAS,aAAa;CAE5B,MAAM,uDAA+B;EAAE;EAAQ;EAAa;EAAqB,CAAC;AAElF,KAAI;AACF,MAAI,oBAAoB;AACtB,wDAAsB,mBAAmB;;EAE3C,MAAM,SAAS,QAAQ,MAAM,EAAE,OAAO,CAAC;AACvC,SAAO,OAAO,KAAK,cAAc,EAAE,UAAU,EAAE;WACvC;AACR,0DAAyB;AACzB,UAAQ,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BrB,MAAa,gBAAgB,OAAO,YAA6E;CAC/G,MAAM,EAAE,YAAY,oBAAoB,aAAa,qBAAqB,UAAU;CAGpF,MAAM,iDAA0B,WAAW;AAC3C,KAAI,aAAa,OAAO,EAAE;AACxB,6BAAW,aAAa,MAAM;;CAEhC,MAAM,SAAS,aAAa;CAE5B,MAAM,uDAA+B;EAAE;EAAQ;EAAa;EAAqB,CAAC;AAElF,KAAI;AACF,MAAI,oBAAoB;AACtB,wDAAsB,mBAAmB;;EAE3C,MAAM,SAAS,MAAM,QAAQ,WAAW,EAAE,OAAO,CAAC;AAClD,SAAO,OAAO,KAAK,cAAc,EAAE,UAAU,EAAE;WACvC;AACR,0DAAyB;AACzB,UAAQ,SAAS"}

package/dist/index.d.cts

@@ -1,10 +1,65 @@
-import { BuilderArtifact, BuilderError } from "@soda-gql/builder";
+import { CodegenError, CodegenSuccess } from "@soda-gql/codegen";
 import { ConfigError } from "@soda-gql/config";
-import { ContextTransformer } from "@soda-gql/core/_internal";
 import { Result } from "neverthrow";
+import { BuilderArtifact, BuilderError } from "@soda-gql/builder";
+import { ContextTransformer } from "@soda-gql/core/_internal";
 
-//#region packages/sdk/src/prebuild.d.ts
+//#region packages/sdk/src/codegen.d.ts
 
+/**
+ * Error type for codegen operations.
+ * Can be either a config loading error or a codegen error.
+ */
+type CodegenSdkError = ConfigError | CodegenError;
+/**
+ * Options for codegenAsync function.
+ */
+interface CodegenSdkOptions {
+  /** Path to soda-gql config file (optional, will search if not provided) */
+  configPath?: string;
+}
+/**
+ * Result of codegen operations.
+ */
+interface CodegenSdkResult {
+  /** Generated schema information */
+  schemas: CodegenSuccess["schemas"];
+  /** Path to generated TypeScript module */
+  outPath: string;
+  /** Path to internal module */
+  internalPath: string;
+  /** Path to injects module */
+  injectsPath: string;
+  /** Path to CommonJS bundle */
+  cjsPath: string;
+}
+/**
+ * Generate GraphQL runtime module asynchronously from a config file.
+ *
+ * @remarks
+ * This function loads the soda-gql config, validates the schemas configuration,
+ * and generates TypeScript/CommonJS modules from GraphQL schemas.
+ *
+ * @param options - Codegen options including optional config path
+ * @returns Promise resolving to Result containing the generation result or an error
+ *
+ * @example
+ * ```typescript
+ * const result = await codegenAsync({ configPath: './soda-gql.config.ts' });
+ * if (result.isOk()) {
+ *   console.log('Generated:', result.value.outPath);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Without explicit config path (will search for config file)
+ * const result = await codegenAsync();
+ * ```
+ */
+declare const codegenAsync: (options?: CodegenSdkOptions) => Promise<Result<CodegenSdkResult, CodegenSdkError>>;
+//#endregion
+//#region packages/sdk/src/prebuild.d.ts
 /**
  * Error type for prebuild operations.
  * Can be either a config loading error or a builder error.
@@ -86,5 +141,5 @@ declare const prebuild: (options: PrebuildOptions) => Result<PrebuildResult, Pre
  */
 declare const prebuildAsync: (options: PrebuildOptions) => Promise<Result<PrebuildResult, PrebuildError>>;
 //#endregion
-export { type ContextTransformer, type PrebuildError, type PrebuildOptions, type PrebuildResult, prebuild, prebuildAsync };
+export { type CodegenSdkError, type CodegenSdkOptions, type CodegenSdkResult, type ContextTransformer, type PrebuildError, type PrebuildOptions, type PrebuildResult, codegenAsync, prebuild, prebuildAsync };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/prebuild.ts"],"sourcesContent":[],"mappings":";;;;;;;AAmEA;;;;AAAoD,KAnDxC,aAAA,GAAgB,WAmDwB,GAnDV,YAmDU;;AAkDpD;;AAA8E,UAhG7D,eAAA,CAgG6D;EAAgB;EAAvB,UAAA,EAAA,MAAA;EAAR;EAAO,kBAAA,CAAA,EA5F/C,kBA4F+C;;;;4CAxF1B;;;;;;;UAQ3B,cAAA;YACL;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA6BC,oBAAqB,oBAAkB,OAAO,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkD9D,yBAAgC,oBAAkB,QAAQ,OAAO,gBAAgB"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/codegen.ts","../src/prebuild.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAgBA;AAKA;AAQA;AAqCA;AAA4C,KAlDhC,eAAA,GAAkB,WAkDc,GAlDA,YAkDA;;;;AAAyB,UA7CpD,iBAAA,CA6CoD;EAAO;;;;AClD5E;AAKA;AAgBiB,UDRA,gBAAA,CCSL;EA6BC;EAAqB,OAAA,EDpCvB,cCoCuB,CAAA,SAAA,CAAA;EAAyB;EAAgB,OAAA,EAAA,MAAA;EAAvB;EAAM,YAAA,EAAA,MAAA;EAkD7C;EAAgC,WAAA,EAAA,MAAA;EAAiC;EAAgB,OAAA,EAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;cDnDjF,yBAA+B,sBAAyB,QAAQ,OAAO,kBAAkB;;;AArCtG;AAqCA;;;AAAsG,KClD1F,aAAA,GAAgB,WDkD0E,GClD5D,YDkD4D;;;;UC7CrF,eAAA;;;EALL;EAKK,kBAAe,CAAA,EAIT,kBAAA;EAYN;EA8BJ,WAsBZ,CAAA,EAAA,MAAA;EAtBiC;EAAyB,mBAAA,CAAA,EAAA,SAAA,MAAA,EAAA,GAtCf,WAsCe,CAAA,MAAA,CAAA;EAAgB;EAAvB,KAAA,CAAA,EAAA,OAAA;;AAkDpD;;;AAA8F,UAhF7E,cAAA,CAgF6E;EAAvB,QAAA,EA/E3D,eA+E2D;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAlD1D,oBAAqB,oBAAkB,OAAO,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkD9D,yBAAgC,oBAAkB,QAAQ,OAAO,gBAAgB"}

package/dist/index.d.mts

@@ -1,10 +1,65 @@
-import { BuilderArtifact, BuilderError } from "@soda-gql/builder";
+import { CodegenError, CodegenSuccess } from "@soda-gql/codegen";
 import { ConfigError } from "@soda-gql/config";
-import { ContextTransformer } from "@soda-gql/core/_internal";
 import { Result } from "neverthrow";
+import { BuilderArtifact, BuilderError } from "@soda-gql/builder";
+import { ContextTransformer } from "@soda-gql/core/_internal";
 
-//#region packages/sdk/src/prebuild.d.ts
+//#region packages/sdk/src/codegen.d.ts
 
+/**
+ * Error type for codegen operations.
+ * Can be either a config loading error or a codegen error.
+ */
+type CodegenSdkError = ConfigError | CodegenError;
+/**
+ * Options for codegenAsync function.
+ */
+interface CodegenSdkOptions {
+  /** Path to soda-gql config file (optional, will search if not provided) */
+  configPath?: string;
+}
+/**
+ * Result of codegen operations.
+ */
+interface CodegenSdkResult {
+  /** Generated schema information */
+  schemas: CodegenSuccess["schemas"];
+  /** Path to generated TypeScript module */
+  outPath: string;
+  /** Path to internal module */
+  internalPath: string;
+  /** Path to injects module */
+  injectsPath: string;
+  /** Path to CommonJS bundle */
+  cjsPath: string;
+}
+/**
+ * Generate GraphQL runtime module asynchronously from a config file.
+ *
+ * @remarks
+ * This function loads the soda-gql config, validates the schemas configuration,
+ * and generates TypeScript/CommonJS modules from GraphQL schemas.
+ *
+ * @param options - Codegen options including optional config path
+ * @returns Promise resolving to Result containing the generation result or an error
+ *
+ * @example
+ * ```typescript
+ * const result = await codegenAsync({ configPath: './soda-gql.config.ts' });
+ * if (result.isOk()) {
+ *   console.log('Generated:', result.value.outPath);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Without explicit config path (will search for config file)
+ * const result = await codegenAsync();
+ * ```
+ */
+declare const codegenAsync: (options?: CodegenSdkOptions) => Promise<Result<CodegenSdkResult, CodegenSdkError>>;
+//#endregion
+//#region packages/sdk/src/prebuild.d.ts
 /**
  * Error type for prebuild operations.
  * Can be either a config loading error or a builder error.
@@ -86,5 +141,5 @@ declare const prebuild: (options: PrebuildOptions) => Result<PrebuildResult, Pre
  */
 declare const prebuildAsync: (options: PrebuildOptions) => Promise<Result<PrebuildResult, PrebuildError>>;
 //#endregion
-export { type ContextTransformer, type PrebuildError, type PrebuildOptions, type PrebuildResult, prebuild, prebuildAsync };
+export { type CodegenSdkError, type CodegenSdkOptions, type CodegenSdkResult, type ContextTransformer, type PrebuildError, type PrebuildOptions, type PrebuildResult, codegenAsync, prebuild, prebuildAsync };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/prebuild.ts"],"sourcesContent":[],"mappings":";;;;;;;AAmEA;;;;AAAoD,KAnDxC,aAAA,GAAgB,WAmDwB,GAnDV,YAmDU;;AAkDpD;;AAA8E,UAhG7D,eAAA,CAgG6D;EAAgB;EAAvB,UAAA,EAAA,MAAA;EAAR;EAAO,kBAAA,CAAA,EA5F/C,kBA4F+C;;;;4CAxF1B;;;;;;;UAQ3B,cAAA;YACL;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA6BC,oBAAqB,oBAAkB,OAAO,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkD9D,yBAAgC,oBAAkB,QAAQ,OAAO,gBAAgB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/codegen.ts","../src/prebuild.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAgBA;AAKA;AAQA;AAqCA;AAA4C,KAlDhC,eAAA,GAAkB,WAkDc,GAlDA,YAkDA;;;;AAAyB,UA7CpD,iBAAA,CA6CoD;EAAO;;;;AClD5E;AAKA;AAgBiB,UDRA,gBAAA,CCSL;EA6BC;EAAqB,OAAA,EDpCvB,cCoCuB,CAAA,SAAA,CAAA;EAAyB;EAAgB,OAAA,EAAA,MAAA;EAAvB;EAAM,YAAA,EAAA,MAAA;EAkD7C;EAAgC,WAAA,EAAA,MAAA;EAAiC;EAAgB,OAAA,EAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;cDnDjF,yBAA+B,sBAAyB,QAAQ,OAAO,kBAAkB;;;AArCtG;AAqCA;;;AAAsG,KClD1F,aAAA,GAAgB,WDkD0E,GClD5D,YDkD4D;;;;UC7CrF,eAAA;;;EALL;EAKK,kBAAe,CAAA,EAIT,kBAAA;EAYN;EA8BJ,WAsBZ,CAAA,EAAA,MAAA;EAtBiC;EAAyB,mBAAA,CAAA,EAAA,SAAA,MAAA,EAAA,GAtCf,WAsCe,CAAA,MAAA,CAAA;EAAgB;EAAvB,KAAA,CAAA,EAAA,OAAA;;AAkDpD;;;AAA8F,UAhF7E,cAAA,CAgF6E;EAAvB,QAAA,EA/E3D,eA+E2D;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAlD1D,oBAAqB,oBAAkB,OAAO,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkD9D,yBAAgC,oBAAkB,QAAQ,OAAO,gBAAgB"}

package/dist/index.mjs

@@ -1,8 +1,72 @@
-import { createBuilderSession } from "@soda-gql/builder";
+import { join } from "node:path";
+import { runCodegen } from "@soda-gql/codegen";
 import { loadConfig } from "@soda-gql/config";
+import { err, ok } from "neverthrow";
+import { createBuilderSession } from "@soda-gql/builder";
 import { clearContextTransformer, setContextTransformer } from "@soda-gql/core/_internal";
-import { err } from "neverthrow";
 
+//#region packages/sdk/src/codegen.ts
+/**
+* Codegen API for programmatic code generation from GraphQL schemas.
+* @module
+*/
+/**
+* Generate GraphQL runtime module asynchronously from a config file.
+*
+* @remarks
+* This function loads the soda-gql config, validates the schemas configuration,
+* and generates TypeScript/CommonJS modules from GraphQL schemas.
+*
+* @param options - Codegen options including optional config path
+* @returns Promise resolving to Result containing the generation result or an error
+*
+* @example
+* ```typescript
+* const result = await codegenAsync({ configPath: './soda-gql.config.ts' });
+* if (result.isOk()) {
+*   console.log('Generated:', result.value.outPath);
+* }
+* ```
+*
+* @example
+* ```typescript
+* // Without explicit config path (will search for config file)
+* const result = await codegenAsync();
+* ```
+*/
+const codegenAsync = async (options = {}) => {
+	const { configPath } = options;
+	const configResult = loadConfig(configPath);
+	if (configResult.isErr()) {
+		return err(configResult.error);
+	}
+	const config = configResult.value;
+	if (!config.schemas || Object.keys(config.schemas).length === 0) {
+		return err({
+			code: "CONFIG_VALIDATION_FAILED",
+			message: "schemas configuration is required in soda-gql config"
+		});
+	}
+	const outPath = join(config.outdir, "index.ts");
+	const result = await runCodegen({
+		schemas: config.schemas,
+		outPath,
+		format: "human",
+		importExtension: config.styles.importExtension
+	});
+	if (result.isErr()) {
+		return err(result.error);
+	}
+	return ok({
+		schemas: result.value.schemas,
+		outPath: result.value.outPath,
+		internalPath: result.value.internalPath,
+		injectsPath: result.value.injectsPath,
+		cjsPath: result.value.cjsPath
+	});
+};
+
+//#endregion
 //#region packages/sdk/src/prebuild.ts
 /**
 * Prebuild API for programmatic artifact generation.
@@ -108,5 +172,5 @@ const prebuildAsync = async (options) => {
 };
 
 //#endregion
-export { prebuild, prebuildAsync };
+export { codegenAsync, prebuild, prebuildAsync };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/prebuild.ts"],"sourcesContent":["/**\n * Prebuild API for programmatic artifact generation.\n * @module\n */\n\nimport { type BuilderArtifact, type BuilderError, createBuilderSession } from \"@soda-gql/builder\";\nimport { type ConfigError, loadConfig } from \"@soda-gql/config\";\nimport { type ContextTransformer, clearContextTransformer, setContextTransformer } from \"@soda-gql/core/_internal\";\nimport { err, type Result } from \"neverthrow\";\n\nexport type { ContextTransformer };\n\n/**\n * Error type for prebuild operations.\n * Can be either a config loading error or a builder error.\n */\nexport type PrebuildError = ConfigError | BuilderError;\n\n/**\n * Options for prebuild functions.\n */\nexport interface PrebuildOptions {\n  /** Path to soda-gql config file */\n  configPath: string;\n  /** Optional context transformer to modify composer context */\n  contextTransformer?: ContextTransformer;\n  /** Unique identifier for this evaluator instance (default: \"default\") */\n  evaluatorId?: string;\n  /** Override entrypoints from config.include */\n  entrypointsOverride?: readonly string[] | ReadonlySet<string>;\n  /** Force rebuild even if no changes detected */\n  force?: boolean;\n}\n\n/**\n * Result of prebuild operations.\n */\nexport interface PrebuildResult {\n  artifact: BuilderArtifact;\n}\n\n/**\n * Build artifact synchronously from a config file.\n *\n * @remarks\n * **Concurrent Execution Warning**: This function uses global state for context transformation.\n * Do not run multiple `prebuild` or `prebuildAsync` calls concurrently with different\n * `contextTransformer` options. Sequential execution is safe.\n *\n * **Session Lifecycle**: This function automatically handles session lifecycle:\n * - Creates a BuilderSession with the resolved config\n * - Calls `session.dispose()` in a finally block to:\n *   - Save incremental build cache to disk\n *   - Unregister from process exit handler\n * - Clears context transformer state after build\n *\n * @param options - Prebuild options including config path and optional transformer\n * @returns Result containing the built artifact or an error\n *\n * @example\n * ```typescript\n * const result = prebuild({ configPath: './soda-gql.config.ts' });\n * if (result.isOk()) {\n *   console.log(result.value.artifact.elements);\n * }\n * ```\n */\nexport const prebuild = (options: PrebuildOptions): Result<PrebuildResult, PrebuildError> => {\n  const { configPath, contextTransformer, evaluatorId, entrypointsOverride, force } = options;\n\n  // Load config from file path\n  const configResult = loadConfig(configPath);\n  if (configResult.isErr()) {\n    return err(configResult.error);\n  }\n  const config = configResult.value;\n\n  const session = createBuilderSession({ config, evaluatorId, entrypointsOverride });\n\n  try {\n    if (contextTransformer) {\n      setContextTransformer(contextTransformer);\n    }\n    const result = session.build({ force });\n    return result.map((artifact) => ({ artifact }));\n  } finally {\n    clearContextTransformer();\n    session.dispose();\n  }\n};\n\n/**\n * Build artifact asynchronously from a config file.\n *\n * @remarks\n * **Concurrent Execution Warning**: This function uses global state for context transformation.\n * Do not run multiple `prebuild` or `prebuildAsync` calls concurrently with different\n * `contextTransformer` options. Sequential execution is safe.\n *\n * **Session Lifecycle**: This function automatically handles session lifecycle:\n * - Creates a BuilderSession with the resolved config\n * - Calls `session.dispose()` in a finally block to:\n *   - Save incremental build cache to disk\n *   - Unregister from process exit handler\n * - Clears context transformer state after build\n *\n * @param options - Prebuild options including config path and optional transformer\n * @returns Promise resolving to Result containing the built artifact or an error\n *\n * @example\n * ```typescript\n * const result = await prebuildAsync({ configPath: './soda-gql.config.ts' });\n * if (result.isOk()) {\n *   console.log(result.value.artifact.elements);\n * }\n * ```\n */\nexport const prebuildAsync = async (options: PrebuildOptions): Promise<Result<PrebuildResult, PrebuildError>> => {\n  const { configPath, contextTransformer, evaluatorId, entrypointsOverride, force } = options;\n\n  // Load config from file path (sync - no async version available)\n  const configResult = loadConfig(configPath);\n  if (configResult.isErr()) {\n    return err(configResult.error);\n  }\n  const config = configResult.value;\n\n  const session = createBuilderSession({ config, evaluatorId, entrypointsOverride });\n\n  try {\n    if (contextTransformer) {\n      setContextTransformer(contextTransformer);\n    }\n    const result = await session.buildAsync({ force });\n    return result.map((artifact) => ({ artifact }));\n  } finally {\n    clearContextTransformer();\n    session.dispose();\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmEA,MAAa,YAAY,YAAoE;CAC3F,MAAM,EAAE,YAAY,oBAAoB,aAAa,qBAAqB,UAAU;CAGpF,MAAM,eAAe,WAAW,WAAW;AAC3C,KAAI,aAAa,OAAO,EAAE;AACxB,SAAO,IAAI,aAAa,MAAM;;CAEhC,MAAM,SAAS,aAAa;CAE5B,MAAM,UAAU,qBAAqB;EAAE;EAAQ;EAAa;EAAqB,CAAC;AAElF,KAAI;AACF,MAAI,oBAAoB;AACtB,yBAAsB,mBAAmB;;EAE3C,MAAM,SAAS,QAAQ,MAAM,EAAE,OAAO,CAAC;AACvC,SAAO,OAAO,KAAK,cAAc,EAAE,UAAU,EAAE;WACvC;AACR,2BAAyB;AACzB,UAAQ,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BrB,MAAa,gBAAgB,OAAO,YAA6E;CAC/G,MAAM,EAAE,YAAY,oBAAoB,aAAa,qBAAqB,UAAU;CAGpF,MAAM,eAAe,WAAW,WAAW;AAC3C,KAAI,aAAa,OAAO,EAAE;AACxB,SAAO,IAAI,aAAa,MAAM;;CAEhC,MAAM,SAAS,aAAa;CAE5B,MAAM,UAAU,qBAAqB;EAAE;EAAQ;EAAa;EAAqB,CAAC;AAElF,KAAI;AACF,MAAI,oBAAoB;AACtB,yBAAsB,mBAAmB;;EAE3C,MAAM,SAAS,MAAM,QAAQ,WAAW,EAAE,OAAO,CAAC;AAClD,SAAO,OAAO,KAAK,cAAc,EAAE,UAAU,EAAE;WACvC;AACR,2BAAyB;AACzB,UAAQ,SAAS"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/codegen.ts","../src/prebuild.ts"],"sourcesContent":["/**\n * Codegen API for programmatic code generation from GraphQL schemas.\n * @module\n */\n\nimport { join } from \"node:path\";\nimport type { CodegenError, CodegenSuccess } from \"@soda-gql/codegen\";\nimport { runCodegen } from \"@soda-gql/codegen\";\nimport type { ConfigError } from \"@soda-gql/config\";\nimport { loadConfig } from \"@soda-gql/config\";\nimport { err, ok, type Result } from \"neverthrow\";\n\n/**\n * Error type for codegen operations.\n * Can be either a config loading error or a codegen error.\n */\nexport type CodegenSdkError = ConfigError | CodegenError;\n\n/**\n * Options for codegenAsync function.\n */\nexport interface CodegenSdkOptions {\n  /** Path to soda-gql config file (optional, will search if not provided) */\n  configPath?: string;\n}\n\n/**\n * Result of codegen operations.\n */\nexport interface CodegenSdkResult {\n  /** Generated schema information */\n  schemas: CodegenSuccess[\"schemas\"];\n  /** Path to generated TypeScript module */\n  outPath: string;\n  /** Path to internal module */\n  internalPath: string;\n  /** Path to injects module */\n  injectsPath: string;\n  /** Path to CommonJS bundle */\n  cjsPath: string;\n}\n\n/**\n * Generate GraphQL runtime module asynchronously from a config file.\n *\n * @remarks\n * This function loads the soda-gql config, validates the schemas configuration,\n * and generates TypeScript/CommonJS modules from GraphQL schemas.\n *\n * @param options - Codegen options including optional config path\n * @returns Promise resolving to Result containing the generation result or an error\n *\n * @example\n * ```typescript\n * const result = await codegenAsync({ configPath: './soda-gql.config.ts' });\n * if (result.isOk()) {\n *   console.log('Generated:', result.value.outPath);\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Without explicit config path (will search for config file)\n * const result = await codegenAsync();\n * ```\n */\nexport const codegenAsync = async (options: CodegenSdkOptions = {}): Promise<Result<CodegenSdkResult, CodegenSdkError>> => {\n  const { configPath } = options;\n\n  // Load config from file path\n  const configResult = loadConfig(configPath);\n  if (configResult.isErr()) {\n    return err(configResult.error);\n  }\n  const config = configResult.value;\n\n  // Validate schemas config exists\n  if (!config.schemas || Object.keys(config.schemas).length === 0) {\n    return err({\n      code: \"CONFIG_VALIDATION_FAILED\",\n      message: \"schemas configuration is required in soda-gql config\",\n    });\n  }\n\n  // Derive output path from outdir (already absolute)\n  const outPath = join(config.outdir, \"index.ts\");\n\n  // Run codegen (config.schemas is already resolved by loadConfig)\n  const result = await runCodegen({\n    schemas: config.schemas,\n    outPath,\n    format: \"human\",\n    importExtension: config.styles.importExtension,\n  });\n\n  if (result.isErr()) {\n    return err(result.error);\n  }\n\n  return ok({\n    schemas: result.value.schemas,\n    outPath: result.value.outPath,\n    internalPath: result.value.internalPath,\n    injectsPath: result.value.injectsPath,\n    cjsPath: result.value.cjsPath,\n  });\n};\n","/**\n * Prebuild API for programmatic artifact generation.\n * @module\n */\n\nimport { type BuilderArtifact, type BuilderError, createBuilderSession } from \"@soda-gql/builder\";\nimport { type ConfigError, loadConfig } from \"@soda-gql/config\";\nimport { type ContextTransformer, clearContextTransformer, setContextTransformer } from \"@soda-gql/core/_internal\";\nimport { err, type Result } from \"neverthrow\";\n\nexport type { ContextTransformer };\n\n/**\n * Error type for prebuild operations.\n * Can be either a config loading error or a builder error.\n */\nexport type PrebuildError = ConfigError | BuilderError;\n\n/**\n * Options for prebuild functions.\n */\nexport interface PrebuildOptions {\n  /** Path to soda-gql config file */\n  configPath: string;\n  /** Optional context transformer to modify composer context */\n  contextTransformer?: ContextTransformer;\n  /** Unique identifier for this evaluator instance (default: \"default\") */\n  evaluatorId?: string;\n  /** Override entrypoints from config.include */\n  entrypointsOverride?: readonly string[] | ReadonlySet<string>;\n  /** Force rebuild even if no changes detected */\n  force?: boolean;\n}\n\n/**\n * Result of prebuild operations.\n */\nexport interface PrebuildResult {\n  artifact: BuilderArtifact;\n}\n\n/**\n * Build artifact synchronously from a config file.\n *\n * @remarks\n * **Concurrent Execution Warning**: This function uses global state for context transformation.\n * Do not run multiple `prebuild` or `prebuildAsync` calls concurrently with different\n * `contextTransformer` options. Sequential execution is safe.\n *\n * **Session Lifecycle**: This function automatically handles session lifecycle:\n * - Creates a BuilderSession with the resolved config\n * - Calls `session.dispose()` in a finally block to:\n *   - Save incremental build cache to disk\n *   - Unregister from process exit handler\n * - Clears context transformer state after build\n *\n * @param options - Prebuild options including config path and optional transformer\n * @returns Result containing the built artifact or an error\n *\n * @example\n * ```typescript\n * const result = prebuild({ configPath: './soda-gql.config.ts' });\n * if (result.isOk()) {\n *   console.log(result.value.artifact.elements);\n * }\n * ```\n */\nexport const prebuild = (options: PrebuildOptions): Result<PrebuildResult, PrebuildError> => {\n  const { configPath, contextTransformer, evaluatorId, entrypointsOverride, force } = options;\n\n  // Load config from file path\n  const configResult = loadConfig(configPath);\n  if (configResult.isErr()) {\n    return err(configResult.error);\n  }\n  const config = configResult.value;\n\n  const session = createBuilderSession({ config, evaluatorId, entrypointsOverride });\n\n  try {\n    if (contextTransformer) {\n      setContextTransformer(contextTransformer);\n    }\n    const result = session.build({ force });\n    return result.map((artifact) => ({ artifact }));\n  } finally {\n    clearContextTransformer();\n    session.dispose();\n  }\n};\n\n/**\n * Build artifact asynchronously from a config file.\n *\n * @remarks\n * **Concurrent Execution Warning**: This function uses global state for context transformation.\n * Do not run multiple `prebuild` or `prebuildAsync` calls concurrently with different\n * `contextTransformer` options. Sequential execution is safe.\n *\n * **Session Lifecycle**: This function automatically handles session lifecycle:\n * - Creates a BuilderSession with the resolved config\n * - Calls `session.dispose()` in a finally block to:\n *   - Save incremental build cache to disk\n *   - Unregister from process exit handler\n * - Clears context transformer state after build\n *\n * @param options - Prebuild options including config path and optional transformer\n * @returns Promise resolving to Result containing the built artifact or an error\n *\n * @example\n * ```typescript\n * const result = await prebuildAsync({ configPath: './soda-gql.config.ts' });\n * if (result.isOk()) {\n *   console.log(result.value.artifact.elements);\n * }\n * ```\n */\nexport const prebuildAsync = async (options: PrebuildOptions): Promise<Result<PrebuildResult, PrebuildError>> => {\n  const { configPath, contextTransformer, evaluatorId, entrypointsOverride, force } = options;\n\n  // Load config from file path (sync - no async version available)\n  const configResult = loadConfig(configPath);\n  if (configResult.isErr()) {\n    return err(configResult.error);\n  }\n  const config = configResult.value;\n\n  const session = createBuilderSession({ config, evaluatorId, entrypointsOverride });\n\n  try {\n    if (contextTransformer) {\n      setContextTransformer(contextTransformer);\n    }\n    const result = await session.buildAsync({ force });\n    return result.map((artifact) => ({ artifact }));\n  } finally {\n    clearContextTransformer();\n    session.dispose();\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkEA,MAAa,eAAe,OAAO,UAA6B,EAAE,KAAyD;CACzH,MAAM,EAAE,eAAe;CAGvB,MAAM,eAAe,WAAW,WAAW;AAC3C,KAAI,aAAa,OAAO,EAAE;AACxB,SAAO,IAAI,aAAa,MAAM;;CAEhC,MAAM,SAAS,aAAa;AAG5B,KAAI,CAAC,OAAO,WAAW,OAAO,KAAK,OAAO,QAAQ,CAAC,WAAW,GAAG;AAC/D,SAAO,IAAI;GACT,MAAM;GACN,SAAS;GACV,CAAC;;CAIJ,MAAM,UAAU,KAAK,OAAO,QAAQ,WAAW;CAG/C,MAAM,SAAS,MAAM,WAAW;EAC9B,SAAS,OAAO;EAChB;EACA,QAAQ;EACR,iBAAiB,OAAO,OAAO;EAChC,CAAC;AAEF,KAAI,OAAO,OAAO,EAAE;AAClB,SAAO,IAAI,OAAO,MAAM;;AAG1B,QAAO,GAAG;EACR,SAAS,OAAO,MAAM;EACtB,SAAS,OAAO,MAAM;EACtB,cAAc,OAAO,MAAM;EAC3B,aAAa,OAAO,MAAM;EAC1B,SAAS,OAAO,MAAM;EACvB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACtCJ,MAAa,YAAY,YAAoE;CAC3F,MAAM,EAAE,YAAY,oBAAoB,aAAa,qBAAqB,UAAU;CAGpF,MAAM,eAAe,WAAW,WAAW;AAC3C,KAAI,aAAa,OAAO,EAAE;AACxB,SAAO,IAAI,aAAa,MAAM;;CAEhC,MAAM,SAAS,aAAa;CAE5B,MAAM,UAAU,qBAAqB;EAAE;EAAQ;EAAa;EAAqB,CAAC;AAElF,KAAI;AACF,MAAI,oBAAoB;AACtB,yBAAsB,mBAAmB;;EAE3C,MAAM,SAAS,QAAQ,MAAM,EAAE,OAAO,CAAC;AACvC,SAAO,OAAO,KAAK,cAAc,EAAE,UAAU,EAAE;WACvC;AACR,2BAAyB;AACzB,UAAQ,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BrB,MAAa,gBAAgB,OAAO,YAA6E;CAC/G,MAAM,EAAE,YAAY,oBAAoB,aAAa,qBAAqB,UAAU;CAGpF,MAAM,eAAe,WAAW,WAAW;AAC3C,KAAI,aAAa,OAAO,EAAE;AACxB,SAAO,IAAI,aAAa,MAAM;;CAEhC,MAAM,SAAS,aAAa;CAE5B,MAAM,UAAU,qBAAqB;EAAE;EAAQ;EAAa;EAAqB,CAAC;AAElF,KAAI;AACF,MAAI,oBAAoB;AACtB,yBAAsB,mBAAmB;;EAE3C,MAAM,SAAS,MAAM,QAAQ,WAAW,EAAE,OAAO,CAAC;AAClD,SAAO,OAAO,KAAK,cAAc,EAAE,UAAU,EAAE;WACvC;AACR,2BAAyB;AACzB,UAAQ,SAAS"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soda-gql/sdk",
-  "version": "0.11.4",
+  "version": "0.11.5",
   "description": "Programmatic SDK for soda-gql CLI features",
   "type": "module",
   "private": false,
@@ -47,9 +47,10 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@soda-gql/builder": "0.11.4",
-    "@soda-gql/config": "0.11.4",
-    "@soda-gql/core": "0.11.4",
+    "@soda-gql/builder": "0.11.5",
+    "@soda-gql/codegen": "0.11.5",
+    "@soda-gql/config": "0.11.5",
+    "@soda-gql/core": "0.11.5",
     "neverthrow": "^8.1.1"
   },
   "devDependencies": {},