@soda-gql/plugin-common 0.7.0 → 0.9.0

package/dist/index.cjs

@@ -121,20 +121,47 @@ const setSharedBuilderService = (key, service) => {
 /**
 * Create plugin session by loading config and creating cached builder service.
 * Returns null if disabled or config load fails.
+*
+* @param options - Plugin options
+* @param pluginName - Name of the plugin for error messages
+* @throws Error if failOnError is true and config load fails
 */
 const createPluginSession = (options, pluginName) => {
-	if (!(options.enabled ?? true)) return null;
+	const enabled = options.enabled ?? true;
+	const failOnError = options.failOnError ?? true;
+	if (!enabled) return null;
 	const configResult = (0, __soda_gql_config.loadConfig)(options.configPath);
 	if (configResult.isErr()) {
-		console.error(`[${pluginName}] Failed to load config:`, {
+		const errorMsg = `[${pluginName}] Failed to load config: ${configResult.error.message}`;
+		console.error(errorMsg, {
 			code: configResult.error.code,
-			message: configResult.error.message,
 			filePath: configResult.error.filePath,
 			cause: configResult.error.cause
 		});
+		if (failOnError) throw new Error(errorMsg);
 		return null;
 	}
 	const config = configResult.value;
+	if (config.artifact?.path) {
+		const artifactResult = (0, __soda_gql_builder.loadArtifactSync)(config.artifact.path);
+		if (artifactResult.isErr()) {
+			const errorMsg = `[${pluginName}] Failed to load pre-built artifact: ${artifactResult.error.message}`;
+			console.error(errorMsg, {
+				code: artifactResult.error.code,
+				filePath: artifactResult.error.filePath
+			});
+			if (failOnError) throw new Error(errorMsg);
+			return null;
+		}
+		const prebuiltArtifact = artifactResult.value;
+		console.log(`[${pluginName}] Using pre-built artifact: ${config.artifact.path}`);
+		return {
+			config,
+			getArtifact: () => prebuiltArtifact,
+			getArtifactAsync: async () => prebuiltArtifact,
+			isPrebuiltMode: true
+		};
+	}
 	const stateKey = getStateKey(options.configPath);
 	const ensureBuilderService = () => {
 		const existing = getSharedBuilderService(stateKey);
@@ -145,13 +172,16 @@ const createPluginSession = (options, pluginName) => {
 	};
 	/**
 	* Build artifact on every invocation (like tsc-plugin).
-	* If artifact.useBuilder is false and artifact.path is provided, load from file instead.
 	* This ensures the artifact is always up-to-date with the latest source files.
+	*
+	* @throws Error if failOnError is true and build fails
 	*/
 	const getArtifact = () => {
 		const buildResult = ensureBuilderService().build();
 		if (buildResult.isErr()) {
-			console.error(`[${pluginName}] Failed to build artifact: ${buildResult.error.message}`);
+			const formattedError = (0, __soda_gql_builder.formatBuilderErrorForCLI)(buildResult.error);
+			console.error(`[${pluginName}] Build failed:\n${formattedError}`);
+			if (failOnError) throw new Error(`[${pluginName}] ${buildResult.error.message}`);
 			return null;
 		}
 		return buildResult.value;
@@ -159,11 +189,15 @@ const createPluginSession = (options, pluginName) => {
 	/**
 	* Async version of getArtifact.
 	* Supports async metadata factories and parallel element evaluation.
+	*
+	* @throws Error if failOnError is true and build fails
 	*/
 	const getArtifactAsync = async () => {
 		const buildResult = await ensureBuilderService().buildAsync();
 		if (buildResult.isErr()) {
-			console.error(`[${pluginName}] Failed to build artifact: ${buildResult.error.message}`);
+			const formattedError = (0, __soda_gql_builder.formatBuilderErrorForCLI)(buildResult.error);
+			console.error(`[${pluginName}] Build failed:\n${formattedError}`);
+			if (failOnError) throw new Error(`[${pluginName}] ${buildResult.error.message}`);
 			return null;
 		}
 		return buildResult.value;
@@ -171,7 +205,8 @@ const createPluginSession = (options, pluginName) => {
 	return {
 		config,
 		getArtifact,
-		getArtifactAsync
+		getArtifactAsync,
+		isPrebuiltMode: false
 	};
 };
 

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/errors.ts","../src/shared-state.ts","../src/plugin-session.ts","../src/utils/canonical-id.ts"],"sourcesContent":["/**\n * Error types and formatters for plugin-babel.\n * Simplified from plugin-shared to include only types actually used by the Babel transformer.\n */\n\nimport type { BuilderError } from \"@soda-gql/builder\";\nimport type { CanonicalId } from \"@soda-gql/common\";\n\ntype OptionsInvalidBuilderConfig = { readonly code: \"INVALID_BUILDER_CONFIG\"; readonly message: string };\ntype OptionsMissingBuilderConfig = { readonly code: \"MISSING_BUILDER_CONFIG\"; readonly message: string };\ntype OptionsConfigLoadFailed = { readonly code: \"CONFIG_LOAD_FAILED\"; readonly message: string };\n\ntype BuilderEntryNotFound = Extract<BuilderError, { code: \"ENTRY_NOT_FOUND\" }>;\ntype BuilderDocDuplicate = Extract<BuilderError, { code: \"DOC_DUPLICATE\" }>;\ntype BuilderCircularDependency = Extract<BuilderError, { code: \"GRAPH_CIRCULAR_DEPENDENCY\" }>;\ntype BuilderModuleEvaluationFailed = Extract<BuilderError, { code: \"RUNTIME_MODULE_LOAD_FAILED\" }>;\ntype BuilderWriteFailed = Extract<BuilderError, { code: \"WRITE_FAILED\" }>;\n\ntype AnalysisMetadataMissingCause = { readonly filename: string };\ntype AnalysisArtifactMissingCause = { readonly filename: string; readonly canonicalId: CanonicalId };\ntype AnalysisUnsupportedArtifactTypeCause = {\n  readonly filename: string;\n  readonly canonicalId: CanonicalId;\n  readonly artifactType: string;\n};\n\ntype PluginErrorBase<Code extends string, Cause> = {\n  readonly type: \"PluginError\";\n  readonly code: Code;\n  readonly message: string;\n  readonly cause: Cause;\n};\n\nexport type PluginOptionsInvalidBuilderConfigError = PluginErrorBase<\n  \"OPTIONS_INVALID_BUILDER_CONFIG\",\n  OptionsInvalidBuilderConfig | OptionsMissingBuilderConfig | OptionsConfigLoadFailed\n> & { readonly stage: \"normalize-options\" };\n\nexport type PluginBuilderEntryNotFoundError = PluginErrorBase<\"SODA_GQL_BUILDER_ENTRY_NOT_FOUND\", BuilderEntryNotFound> & {\n  readonly stage: \"builder\";\n  readonly entry: string;\n};\n\nexport type PluginBuilderDocDuplicateError = PluginErrorBase<\"SODA_GQL_BUILDER_DOC_DUPLICATE\", BuilderDocDuplicate> & {\n  readonly stage: \"builder\";\n  readonly name: string;\n  readonly sources: readonly string[];\n};\n\nexport type PluginBuilderCircularDependencyError = PluginErrorBase<\n  \"SODA_GQL_BUILDER_CIRCULAR_DEPENDENCY\",\n  BuilderCircularDependency\n> & { readonly stage: \"builder\"; readonly chain: readonly string[] };\n\nexport type PluginBuilderModuleEvaluationFailedError = PluginErrorBase<\n  \"SODA_GQL_BUILDER_MODULE_EVALUATION_FAILED\",\n  BuilderModuleEvaluationFailed\n> & { readonly stage: \"builder\"; readonly filePath: string; readonly astPath: string };\n\nexport type PluginBuilderWriteFailedError = PluginErrorBase<\"SODA_GQL_BUILDER_WRITE_FAILED\", BuilderWriteFailed> & {\n  readonly stage: \"builder\";\n  readonly outPath: string;\n};\n\nexport type PluginBuilderUnexpectedError = PluginErrorBase<\"SODA_GQL_BUILDER_UNEXPECTED\", unknown> & {\n  readonly stage: \"builder\";\n};\n\nexport type PluginAnalysisMetadataMissingError = PluginErrorBase<\"SODA_GQL_METADATA_NOT_FOUND\", AnalysisMetadataMissingCause> & {\n  readonly stage: \"analysis\";\n  readonly filename: string;\n};\n\nexport type PluginAnalysisArtifactMissingError = PluginErrorBase<\n  \"SODA_GQL_ANALYSIS_ARTIFACT_NOT_FOUND\",\n  AnalysisArtifactMissingCause\n> & { readonly stage: \"analysis\"; readonly filename: string; readonly canonicalId: CanonicalId };\n\nexport type PluginAnalysisUnsupportedArtifactTypeError = PluginErrorBase<\n  \"SODA_GQL_UNSUPPORTED_ARTIFACT_TYPE\",\n  AnalysisUnsupportedArtifactTypeCause\n> & {\n  readonly stage: \"analysis\";\n  readonly filename: string;\n  readonly canonicalId: CanonicalId;\n  readonly artifactType: string;\n};\n\ntype TransformMissingBuilderArgCause = { readonly filename: string; readonly builderType: string; readonly argName: string };\ntype TransformUnsupportedValueTypeCause = { readonly valueType: string };\ntype TransformAstVisitorFailedCause = { readonly filename: string; readonly reason: string };\n\nexport type PluginTransformMissingBuilderArgError = PluginErrorBase<\n  \"SODA_GQL_TRANSFORM_MISSING_BUILDER_ARG\",\n  TransformMissingBuilderArgCause\n> & {\n  readonly stage: \"transform\";\n  readonly filename: string;\n  readonly builderType: string;\n  readonly argName: string;\n};\n\nexport type PluginTransformUnsupportedValueTypeError = PluginErrorBase<\n  \"SODA_GQL_TRANSFORM_UNSUPPORTED_VALUE_TYPE\",\n  TransformUnsupportedValueTypeCause\n> & { readonly stage: \"transform\"; readonly valueType: string };\n\nexport type PluginTransformAstVisitorFailedError = PluginErrorBase<\n  \"SODA_GQL_TRANSFORM_AST_VISITOR_FAILED\",\n  TransformAstVisitorFailedCause\n> & { readonly stage: \"transform\"; readonly filename: string; readonly reason: string };\n\n/**\n * Union of all plugin error types.\n */\nexport type PluginError =\n  | PluginOptionsInvalidBuilderConfigError\n  | PluginBuilderEntryNotFoundError\n  | PluginBuilderDocDuplicateError\n  | PluginBuilderCircularDependencyError\n  | PluginBuilderModuleEvaluationFailedError\n  | PluginBuilderWriteFailedError\n  | PluginBuilderUnexpectedError\n  | PluginAnalysisMetadataMissingError\n  | PluginAnalysisArtifactMissingError\n  | PluginAnalysisUnsupportedArtifactTypeError\n  | PluginTransformMissingBuilderArgError\n  | PluginTransformUnsupportedValueTypeError\n  | PluginTransformAstVisitorFailedError;\n\n/**\n * Format a PluginError into a human-readable message.\n */\nexport const formatPluginError = (error: PluginError): string => {\n  const codePrefix = `[${error.code}]`;\n  const stageInfo = \"stage\" in error ? ` (${error.stage})` : \"\";\n  return `${codePrefix}${stageInfo} ${error.message}`;\n};\n\n/**\n * Type guard for PluginError.\n */\nexport const isPluginError = (value: unknown): value is PluginError => {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === \"PluginError\" &&\n    \"code\" in value &&\n    \"message\" in value\n  );\n};\n\n/**\n * Assertion helper for unreachable code paths.\n * This is the ONLY acceptable throw in plugin code.\n */\nexport const assertUnreachable = (value: never, context?: string): never => {\n  throw new Error(`[INTERNAL] Unreachable code path${context ? ` in ${context}` : \"\"}: received ${JSON.stringify(value)}`);\n};\n","import type { BuilderArtifact, BuilderService } from \"@soda-gql/builder\";\nimport type { PluginSession } from \"./plugin-session\";\n\n/**\n * Transformer type for code transformation.\n * - 'babel': Use Babel plugin (default, wider compatibility)\n * - 'swc': Use SWC transformer (faster, requires @soda-gql/swc-transformer)\n */\nexport type TransformerType = \"babel\" | \"swc\";\n\n/**\n * Minimal interface for SWC transformer.\n * Matches the Transformer interface from @soda-gql/swc-transformer.\n */\nexport interface SwcTransformerInterface {\n  transform(input: { sourceCode: string; sourcePath: string; inputSourceMap?: string }): {\n    transformed: boolean;\n    sourceCode: string;\n    sourceMap?: string;\n  };\n}\n\n/**\n * Shared state between bundler plugins and loaders.\n * Enables efficient artifact sharing across build pipeline stages.\n */\nexport type SharedState = {\n  pluginSession: PluginSession | null;\n  currentArtifact: BuilderArtifact | null;\n  moduleAdjacency: Map<string, Set<string>>;\n  generation: number;\n  swcTransformer: SwcTransformerInterface | null;\n  transformerType: TransformerType | null;\n  builderService: BuilderService | null;\n};\n\n// Global state for sharing between plugin and loader\nconst sharedStates = new Map<string, SharedState>();\n\n/**\n * Get shared state for a given project (identified by config path or cwd).\n */\nexport const getSharedState = (key: string): SharedState => {\n  let state = sharedStates.get(key);\n  if (!state) {\n    state = {\n      pluginSession: null,\n      currentArtifact: null,\n      moduleAdjacency: new Map(),\n      generation: 0,\n      swcTransformer: null,\n      transformerType: null,\n      builderService: null,\n    };\n    sharedStates.set(key, state);\n  }\n  return state;\n};\n\n/**\n * Update shared artifact.\n */\nexport const setSharedArtifact = (\n  key: string,\n  artifact: BuilderArtifact | null,\n  moduleAdjacency?: Map<string, Set<string>>,\n): void => {\n  const state = getSharedState(key);\n  state.currentArtifact = artifact;\n  if (moduleAdjacency) {\n    state.moduleAdjacency = moduleAdjacency;\n  }\n  state.generation++;\n};\n\n/**\n * Get shared artifact.\n */\nexport const getSharedArtifact = (key: string): BuilderArtifact | null => {\n  return getSharedState(key).currentArtifact;\n};\n\n/**\n * Get shared plugin session.\n */\nexport const getSharedPluginSession = (key: string): PluginSession | null => {\n  return getSharedState(key).pluginSession;\n};\n\n/**\n * Set shared plugin session.\n */\nexport const setSharedPluginSession = (key: string, session: PluginSession | null): void => {\n  getSharedState(key).pluginSession = session;\n};\n\n/**\n * Get the state key from config path or cwd.\n */\nexport const getStateKey = (configPath?: string): string => {\n  return configPath ?? process.cwd();\n};\n\n/**\n * Set shared SWC transformer.\n */\nexport const setSharedSwcTransformer = (key: string, transformer: SwcTransformerInterface | null): void => {\n  getSharedState(key).swcTransformer = transformer;\n};\n\n/**\n * Get shared SWC transformer.\n */\nexport const getSharedSwcTransformer = (key: string): SwcTransformerInterface | null => {\n  return getSharedState(key).swcTransformer;\n};\n\n/**\n * Set shared transformer type.\n */\nexport const setSharedTransformerType = (key: string, transformerType: TransformerType | null): void => {\n  getSharedState(key).transformerType = transformerType;\n};\n\n/**\n * Get shared transformer type.\n */\nexport const getSharedTransformerType = (key: string): TransformerType | null => {\n  return getSharedState(key).transformerType;\n};\n\n/**\n * Get shared BuilderService.\n */\nexport const getSharedBuilderService = (key: string): BuilderService | null => {\n  return getSharedState(key).builderService;\n};\n\n/**\n * Set shared BuilderService.\n */\nexport const setSharedBuilderService = (key: string, service: BuilderService | null): void => {\n  getSharedState(key).builderService = service;\n};\n","/**\n * Plugin session management for all plugins.\n * Unified from plugin-babel and plugin-swc implementations.\n */\n\nimport type { BuilderArtifact, BuilderService } from \"@soda-gql/builder\";\nimport { createBuilderService } from \"@soda-gql/builder\";\nimport { loadConfig, type ResolvedSodaGqlConfig } from \"@soda-gql/config\";\nimport { getSharedBuilderService, getStateKey, setSharedBuilderService } from \"./shared-state\";\n\n/**\n * Plugin options shared across all plugins.\n */\nexport type PluginOptions = {\n  readonly configPath?: string;\n  readonly enabled?: boolean;\n};\n\n/**\n * Plugin session containing builder service and configuration.\n */\nexport type PluginSession = {\n  readonly config: ResolvedSodaGqlConfig;\n  readonly getArtifact: () => BuilderArtifact | null;\n  readonly getArtifactAsync: () => Promise<BuilderArtifact | null>;\n};\n\n/**\n * Create plugin session by loading config and creating cached builder service.\n * Returns null if disabled or config load fails.\n */\nexport const createPluginSession = (options: PluginOptions, pluginName: string): PluginSession | null => {\n  const enabled = options.enabled ?? true;\n  if (!enabled) {\n    return null;\n  }\n\n  const configResult = loadConfig(options.configPath);\n  if (configResult.isErr()) {\n    console.error(`[${pluginName}] Failed to load config:`, {\n      code: configResult.error.code,\n      message: configResult.error.message,\n      filePath: configResult.error.filePath,\n      cause: configResult.error.cause,\n    });\n    return null;\n  }\n\n  const config = configResult.value;\n  const stateKey = getStateKey(options.configPath);\n\n  // Use global BuilderService cache to share FileTracker state across plugin instances\n  const ensureBuilderService = (): BuilderService => {\n    const existing = getSharedBuilderService(stateKey);\n    if (existing) {\n      return existing;\n    }\n\n    const service = createBuilderService({ config });\n    setSharedBuilderService(stateKey, service);\n    return service;\n  };\n\n  /**\n   * Build artifact on every invocation (like tsc-plugin).\n   * If artifact.useBuilder is false and artifact.path is provided, load from file instead.\n   * This ensures the artifact is always up-to-date with the latest source files.\n   */\n  const getArtifact = (): BuilderArtifact | null => {\n    const builderService = ensureBuilderService();\n    const buildResult = builderService.build();\n    if (buildResult.isErr()) {\n      console.error(`[${pluginName}] Failed to build artifact: ${buildResult.error.message}`);\n      return null;\n    }\n    return buildResult.value;\n  };\n\n  /**\n   * Async version of getArtifact.\n   * Supports async metadata factories and parallel element evaluation.\n   */\n  const getArtifactAsync = async (): Promise<BuilderArtifact | null> => {\n    const builderService = ensureBuilderService();\n    const buildResult = await builderService.buildAsync();\n    if (buildResult.isErr()) {\n      console.error(`[${pluginName}] Failed to build artifact: ${buildResult.error.message}`);\n      return null;\n    }\n    return buildResult.value;\n  };\n\n  return {\n    config,\n    getArtifact,\n    getArtifactAsync,\n  };\n};\n","/**\n * Utility for working with canonical IDs.\n */\n\nimport { resolve } from \"node:path\";\nimport { type CanonicalId, createCanonicalId } from \"@soda-gql/common\";\n\n/**\n * Resolve a canonical ID from a filename and AST path.\n */\nexport const resolveCanonicalId = (filename: string, astPath: string): CanonicalId =>\n  createCanonicalId(resolve(filename), astPath);\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/errors.ts","../src/shared-state.ts","../src/plugin-session.ts","../src/utils/canonical-id.ts"],"sourcesContent":["/**\n * Error types and formatters for plugin-babel.\n * Simplified from plugin-shared to include only types actually used by the Babel transformer.\n */\n\nimport type { BuilderError } from \"@soda-gql/builder\";\nimport type { CanonicalId } from \"@soda-gql/common\";\n\ntype OptionsInvalidBuilderConfig = { readonly code: \"INVALID_BUILDER_CONFIG\"; readonly message: string };\ntype OptionsMissingBuilderConfig = { readonly code: \"MISSING_BUILDER_CONFIG\"; readonly message: string };\ntype OptionsConfigLoadFailed = { readonly code: \"CONFIG_LOAD_FAILED\"; readonly message: string };\n\ntype BuilderEntryNotFound = Extract<BuilderError, { code: \"ENTRY_NOT_FOUND\" }>;\ntype BuilderDocDuplicate = Extract<BuilderError, { code: \"DOC_DUPLICATE\" }>;\ntype BuilderCircularDependency = Extract<BuilderError, { code: \"GRAPH_CIRCULAR_DEPENDENCY\" }>;\ntype BuilderModuleEvaluationFailed = Extract<BuilderError, { code: \"RUNTIME_MODULE_LOAD_FAILED\" }>;\ntype BuilderWriteFailed = Extract<BuilderError, { code: \"WRITE_FAILED\" }>;\n\ntype AnalysisMetadataMissingCause = { readonly filename: string };\ntype AnalysisArtifactMissingCause = { readonly filename: string; readonly canonicalId: CanonicalId };\ntype AnalysisUnsupportedArtifactTypeCause = {\n  readonly filename: string;\n  readonly canonicalId: CanonicalId;\n  readonly artifactType: string;\n};\n\ntype PluginErrorBase<Code extends string, Cause> = {\n  readonly type: \"PluginError\";\n  readonly code: Code;\n  readonly message: string;\n  readonly cause: Cause;\n};\n\nexport type PluginOptionsInvalidBuilderConfigError = PluginErrorBase<\n  \"OPTIONS_INVALID_BUILDER_CONFIG\",\n  OptionsInvalidBuilderConfig | OptionsMissingBuilderConfig | OptionsConfigLoadFailed\n> & { readonly stage: \"normalize-options\" };\n\nexport type PluginBuilderEntryNotFoundError = PluginErrorBase<\"SODA_GQL_BUILDER_ENTRY_NOT_FOUND\", BuilderEntryNotFound> & {\n  readonly stage: \"builder\";\n  readonly entry: string;\n};\n\nexport type PluginBuilderDocDuplicateError = PluginErrorBase<\"SODA_GQL_BUILDER_DOC_DUPLICATE\", BuilderDocDuplicate> & {\n  readonly stage: \"builder\";\n  readonly name: string;\n  readonly sources: readonly string[];\n};\n\nexport type PluginBuilderCircularDependencyError = PluginErrorBase<\n  \"SODA_GQL_BUILDER_CIRCULAR_DEPENDENCY\",\n  BuilderCircularDependency\n> & { readonly stage: \"builder\"; readonly chain: readonly string[] };\n\nexport type PluginBuilderModuleEvaluationFailedError = PluginErrorBase<\n  \"SODA_GQL_BUILDER_MODULE_EVALUATION_FAILED\",\n  BuilderModuleEvaluationFailed\n> & { readonly stage: \"builder\"; readonly filePath: string; readonly astPath: string };\n\nexport type PluginBuilderWriteFailedError = PluginErrorBase<\"SODA_GQL_BUILDER_WRITE_FAILED\", BuilderWriteFailed> & {\n  readonly stage: \"builder\";\n  readonly outPath: string;\n};\n\nexport type PluginBuilderUnexpectedError = PluginErrorBase<\"SODA_GQL_BUILDER_UNEXPECTED\", unknown> & {\n  readonly stage: \"builder\";\n};\n\nexport type PluginAnalysisMetadataMissingError = PluginErrorBase<\"SODA_GQL_METADATA_NOT_FOUND\", AnalysisMetadataMissingCause> & {\n  readonly stage: \"analysis\";\n  readonly filename: string;\n};\n\nexport type PluginAnalysisArtifactMissingError = PluginErrorBase<\n  \"SODA_GQL_ANALYSIS_ARTIFACT_NOT_FOUND\",\n  AnalysisArtifactMissingCause\n> & { readonly stage: \"analysis\"; readonly filename: string; readonly canonicalId: CanonicalId };\n\nexport type PluginAnalysisUnsupportedArtifactTypeError = PluginErrorBase<\n  \"SODA_GQL_UNSUPPORTED_ARTIFACT_TYPE\",\n  AnalysisUnsupportedArtifactTypeCause\n> & {\n  readonly stage: \"analysis\";\n  readonly filename: string;\n  readonly canonicalId: CanonicalId;\n  readonly artifactType: string;\n};\n\ntype TransformMissingBuilderArgCause = { readonly filename: string; readonly builderType: string; readonly argName: string };\ntype TransformUnsupportedValueTypeCause = { readonly valueType: string };\ntype TransformAstVisitorFailedCause = { readonly filename: string; readonly reason: string };\n\nexport type PluginTransformMissingBuilderArgError = PluginErrorBase<\n  \"SODA_GQL_TRANSFORM_MISSING_BUILDER_ARG\",\n  TransformMissingBuilderArgCause\n> & {\n  readonly stage: \"transform\";\n  readonly filename: string;\n  readonly builderType: string;\n  readonly argName: string;\n};\n\nexport type PluginTransformUnsupportedValueTypeError = PluginErrorBase<\n  \"SODA_GQL_TRANSFORM_UNSUPPORTED_VALUE_TYPE\",\n  TransformUnsupportedValueTypeCause\n> & { readonly stage: \"transform\"; readonly valueType: string };\n\nexport type PluginTransformAstVisitorFailedError = PluginErrorBase<\n  \"SODA_GQL_TRANSFORM_AST_VISITOR_FAILED\",\n  TransformAstVisitorFailedCause\n> & { readonly stage: \"transform\"; readonly filename: string; readonly reason: string };\n\n/**\n * Union of all plugin error types.\n */\nexport type PluginError =\n  | PluginOptionsInvalidBuilderConfigError\n  | PluginBuilderEntryNotFoundError\n  | PluginBuilderDocDuplicateError\n  | PluginBuilderCircularDependencyError\n  | PluginBuilderModuleEvaluationFailedError\n  | PluginBuilderWriteFailedError\n  | PluginBuilderUnexpectedError\n  | PluginAnalysisMetadataMissingError\n  | PluginAnalysisArtifactMissingError\n  | PluginAnalysisUnsupportedArtifactTypeError\n  | PluginTransformMissingBuilderArgError\n  | PluginTransformUnsupportedValueTypeError\n  | PluginTransformAstVisitorFailedError;\n\n/**\n * Format a PluginError into a human-readable message.\n */\nexport const formatPluginError = (error: PluginError): string => {\n  const codePrefix = `[${error.code}]`;\n  const stageInfo = \"stage\" in error ? ` (${error.stage})` : \"\";\n  return `${codePrefix}${stageInfo} ${error.message}`;\n};\n\n/**\n * Type guard for PluginError.\n */\nexport const isPluginError = (value: unknown): value is PluginError => {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === \"PluginError\" &&\n    \"code\" in value &&\n    \"message\" in value\n  );\n};\n\n/**\n * Assertion helper for unreachable code paths.\n * This is the ONLY acceptable throw in plugin code.\n */\nexport const assertUnreachable = (value: never, context?: string): never => {\n  throw new Error(`[INTERNAL] Unreachable code path${context ? ` in ${context}` : \"\"}: received ${JSON.stringify(value)}`);\n};\n","import type { BuilderArtifact, BuilderService } from \"@soda-gql/builder\";\nimport type { PluginSession } from \"./plugin-session\";\n\n/**\n * Transformer type for code transformation.\n * - 'babel': Use Babel plugin (default, wider compatibility)\n * - 'swc': Use SWC transformer (faster, requires @soda-gql/swc-transformer)\n */\nexport type TransformerType = \"babel\" | \"swc\";\n\n/**\n * Minimal interface for SWC transformer.\n * Matches the Transformer interface from @soda-gql/swc-transformer.\n */\nexport interface SwcTransformerInterface {\n  transform(input: { sourceCode: string; sourcePath: string; inputSourceMap?: string }): {\n    transformed: boolean;\n    sourceCode: string;\n    sourceMap?: string;\n  };\n}\n\n/**\n * Shared state between bundler plugins and loaders.\n * Enables efficient artifact sharing across build pipeline stages.\n */\nexport type SharedState = {\n  pluginSession: PluginSession | null;\n  currentArtifact: BuilderArtifact | null;\n  moduleAdjacency: Map<string, Set<string>>;\n  generation: number;\n  swcTransformer: SwcTransformerInterface | null;\n  transformerType: TransformerType | null;\n  builderService: BuilderService | null;\n};\n\n// Global state for sharing between plugin and loader\nconst sharedStates = new Map<string, SharedState>();\n\n/**\n * Get shared state for a given project (identified by config path or cwd).\n */\nexport const getSharedState = (key: string): SharedState => {\n  let state = sharedStates.get(key);\n  if (!state) {\n    state = {\n      pluginSession: null,\n      currentArtifact: null,\n      moduleAdjacency: new Map(),\n      generation: 0,\n      swcTransformer: null,\n      transformerType: null,\n      builderService: null,\n    };\n    sharedStates.set(key, state);\n  }\n  return state;\n};\n\n/**\n * Update shared artifact.\n */\nexport const setSharedArtifact = (\n  key: string,\n  artifact: BuilderArtifact | null,\n  moduleAdjacency?: Map<string, Set<string>>,\n): void => {\n  const state = getSharedState(key);\n  state.currentArtifact = artifact;\n  if (moduleAdjacency) {\n    state.moduleAdjacency = moduleAdjacency;\n  }\n  state.generation++;\n};\n\n/**\n * Get shared artifact.\n */\nexport const getSharedArtifact = (key: string): BuilderArtifact | null => {\n  return getSharedState(key).currentArtifact;\n};\n\n/**\n * Get shared plugin session.\n */\nexport const getSharedPluginSession = (key: string): PluginSession | null => {\n  return getSharedState(key).pluginSession;\n};\n\n/**\n * Set shared plugin session.\n */\nexport const setSharedPluginSession = (key: string, session: PluginSession | null): void => {\n  getSharedState(key).pluginSession = session;\n};\n\n/**\n * Get the state key from config path or cwd.\n */\nexport const getStateKey = (configPath?: string): string => {\n  return configPath ?? process.cwd();\n};\n\n/**\n * Set shared SWC transformer.\n */\nexport const setSharedSwcTransformer = (key: string, transformer: SwcTransformerInterface | null): void => {\n  getSharedState(key).swcTransformer = transformer;\n};\n\n/**\n * Get shared SWC transformer.\n */\nexport const getSharedSwcTransformer = (key: string): SwcTransformerInterface | null => {\n  return getSharedState(key).swcTransformer;\n};\n\n/**\n * Set shared transformer type.\n */\nexport const setSharedTransformerType = (key: string, transformerType: TransformerType | null): void => {\n  getSharedState(key).transformerType = transformerType;\n};\n\n/**\n * Get shared transformer type.\n */\nexport const getSharedTransformerType = (key: string): TransformerType | null => {\n  return getSharedState(key).transformerType;\n};\n\n/**\n * Get shared BuilderService.\n */\nexport const getSharedBuilderService = (key: string): BuilderService | null => {\n  return getSharedState(key).builderService;\n};\n\n/**\n * Set shared BuilderService.\n */\nexport const setSharedBuilderService = (key: string, service: BuilderService | null): void => {\n  getSharedState(key).builderService = service;\n};\n","/**\n * Plugin session management for all plugins.\n * Unified from plugin-babel and plugin-swc implementations.\n */\n\nimport type { BuilderArtifact, BuilderService } from \"@soda-gql/builder\";\nimport { createBuilderService, formatBuilderErrorForCLI, loadArtifactSync } from \"@soda-gql/builder\";\nimport { loadConfig, type ResolvedSodaGqlConfig } from \"@soda-gql/config\";\nimport { getSharedBuilderService, getStateKey, setSharedBuilderService } from \"./shared-state\";\n\n/**\n * Plugin options shared across all plugins.\n */\nexport type PluginOptions = {\n  readonly configPath?: string;\n  readonly enabled?: boolean;\n  /**\n   * Whether to fail the build on error.\n   * When true (default), throws an error that fails the bundler build.\n   * When false, logs the error and continues (graceful degradation).\n   */\n  readonly failOnError?: boolean;\n};\n\n/**\n * Plugin session containing builder service and configuration.\n */\nexport type PluginSession = {\n  readonly config: ResolvedSodaGqlConfig;\n  readonly getArtifact: () => BuilderArtifact | null;\n  readonly getArtifactAsync: () => Promise<BuilderArtifact | null>;\n  /**\n   * Whether the session is using a pre-built artifact.\n   * When true, artifacts are loaded from a file instead of built dynamically.\n   */\n  readonly isPrebuiltMode: boolean;\n};\n\n/**\n * Create plugin session by loading config and creating cached builder service.\n * Returns null if disabled or config load fails.\n *\n * @param options - Plugin options\n * @param pluginName - Name of the plugin for error messages\n * @throws Error if failOnError is true and config load fails\n */\nexport const createPluginSession = (options: PluginOptions, pluginName: string): PluginSession | null => {\n  const enabled = options.enabled ?? true;\n  const failOnError = options.failOnError ?? true;\n\n  if (!enabled) {\n    return null;\n  }\n\n  const configResult = loadConfig(options.configPath);\n  if (configResult.isErr()) {\n    const errorMsg = `[${pluginName}] Failed to load config: ${configResult.error.message}`;\n    console.error(errorMsg, {\n      code: configResult.error.code,\n      filePath: configResult.error.filePath,\n      cause: configResult.error.cause,\n    });\n    if (failOnError) {\n      throw new Error(errorMsg);\n    }\n    return null;\n  }\n\n  const config = configResult.value;\n\n  // Check if pre-built artifact mode is enabled\n  if (config.artifact?.path) {\n    const artifactResult = loadArtifactSync(config.artifact.path);\n\n    if (artifactResult.isErr()) {\n      const errorMsg = `[${pluginName}] Failed to load pre-built artifact: ${artifactResult.error.message}`;\n      console.error(errorMsg, {\n        code: artifactResult.error.code,\n        filePath: artifactResult.error.filePath,\n      });\n      if (failOnError) {\n        throw new Error(errorMsg);\n      }\n      return null;\n    }\n\n    const prebuiltArtifact = artifactResult.value;\n    console.log(`[${pluginName}] Using pre-built artifact: ${config.artifact.path}`);\n\n    return {\n      config,\n      getArtifact: () => prebuiltArtifact,\n      getArtifactAsync: async () => prebuiltArtifact,\n      isPrebuiltMode: true,\n    };\n  }\n\n  // Dynamic build mode\n  const stateKey = getStateKey(options.configPath);\n\n  // Use global BuilderService cache to share FileTracker state across plugin instances\n  const ensureBuilderService = (): BuilderService => {\n    const existing = getSharedBuilderService(stateKey);\n    if (existing) {\n      return existing;\n    }\n\n    const service = createBuilderService({ config });\n    setSharedBuilderService(stateKey, service);\n    return service;\n  };\n\n  /**\n   * Build artifact on every invocation (like tsc-plugin).\n   * This ensures the artifact is always up-to-date with the latest source files.\n   *\n   * @throws Error if failOnError is true and build fails\n   */\n  const getArtifact = (): BuilderArtifact | null => {\n    const builderService = ensureBuilderService();\n    const buildResult = builderService.build();\n    if (buildResult.isErr()) {\n      const formattedError = formatBuilderErrorForCLI(buildResult.error);\n      console.error(`[${pluginName}] Build failed:\\n${formattedError}`);\n      if (failOnError) {\n        throw new Error(`[${pluginName}] ${buildResult.error.message}`);\n      }\n      return null;\n    }\n    return buildResult.value;\n  };\n\n  /**\n   * Async version of getArtifact.\n   * Supports async metadata factories and parallel element evaluation.\n   *\n   * @throws Error if failOnError is true and build fails\n   */\n  const getArtifactAsync = async (): Promise<BuilderArtifact | null> => {\n    const builderService = ensureBuilderService();\n    const buildResult = await builderService.buildAsync();\n    if (buildResult.isErr()) {\n      const formattedError = formatBuilderErrorForCLI(buildResult.error);\n      console.error(`[${pluginName}] Build failed:\\n${formattedError}`);\n      if (failOnError) {\n        throw new Error(`[${pluginName}] ${buildResult.error.message}`);\n      }\n      return null;\n    }\n    return buildResult.value;\n  };\n\n  return {\n    config,\n    getArtifact,\n    getArtifactAsync,\n    isPrebuiltMode: false,\n  };\n};\n","/**\n * Utility for working with canonical IDs.\n */\n\nimport { resolve } from \"node:path\";\nimport { type CanonicalId, createCanonicalId } from \"@soda-gql/common\";\n\n/**\n * Resolve a canonical ID from a filename and AST path.\n */\nexport const resolveCanonicalId = (filename: string, astPath: string): CanonicalId =>\n  createCanonicalId(resolve(filename), astPath);\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -144,6 +144,12 @@ declare const assertUnreachable: (value: never, context?: string) => never;
 type PluginOptions = {
   readonly configPath?: string;
   readonly enabled?: boolean;
+  /**
+   * Whether to fail the build on error.
+   * When true (default), throws an error that fails the bundler build.
+   * When false, logs the error and continues (graceful degradation).
+   */
+  readonly failOnError?: boolean;
 };
 /**
  * Plugin session containing builder service and configuration.
@@ -152,10 +158,19 @@ type PluginSession = {
   readonly config: ResolvedSodaGqlConfig;
   readonly getArtifact: () => BuilderArtifact | null;
   readonly getArtifactAsync: () => Promise<BuilderArtifact | null>;
+  /**
+   * Whether the session is using a pre-built artifact.
+   * When true, artifacts are loaded from a file instead of built dynamically.
+   */
+  readonly isPrebuiltMode: boolean;
 };
 /**
  * Create plugin session by loading config and creating cached builder service.
  * Returns null if disabled or config load fails.
+ *
+ * @param options - Plugin options
+ * @param pluginName - Name of the plugin for error messages
+ * @throws Error if failOnError is true and config load fails
  */
 declare const createPluginSession: (options: PluginOptions, pluginName: string) => PluginSession | null;
 //#endregion

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors.ts","../src/plugin-session.ts","../src/shared-state.ts","../src/types/gql-call.ts","../src/types/metadata.ts","../src/utils/canonical-id.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors.ts","../src/plugin-session.ts","../src/shared-state.ts","../src/types/gql-call.ts","../src/types/metadata.ts","../src/utils/canonical-id.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.mts

@@ -144,6 +144,12 @@ declare const assertUnreachable: (value: never, context?: string) => never;
 type PluginOptions = {
   readonly configPath?: string;
   readonly enabled?: boolean;
+  /**
+   * Whether to fail the build on error.
+   * When true (default), throws an error that fails the bundler build.
+   * When false, logs the error and continues (graceful degradation).
+   */
+  readonly failOnError?: boolean;
 };
 /**
  * Plugin session containing builder service and configuration.
@@ -152,10 +158,19 @@ type PluginSession = {
   readonly config: ResolvedSodaGqlConfig;
   readonly getArtifact: () => BuilderArtifact | null;
   readonly getArtifactAsync: () => Promise<BuilderArtifact | null>;
+  /**
+   * Whether the session is using a pre-built artifact.
+   * When true, artifacts are loaded from a file instead of built dynamically.
+   */
+  readonly isPrebuiltMode: boolean;
 };
 /**
  * Create plugin session by loading config and creating cached builder service.
  * Returns null if disabled or config load fails.
+ *
+ * @param options - Plugin options
+ * @param pluginName - Name of the plugin for error messages
+ * @throws Error if failOnError is true and config load fails
  */
 declare const createPluginSession: (options: PluginOptions, pluginName: string) => PluginSession | null;
 //#endregion

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/errors.ts","../src/plugin-session.ts","../src/shared-state.ts","../src/types/gql-call.ts","../src/types/metadata.ts","../src/utils/canonical-id.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/errors.ts","../src/plugin-session.ts","../src/shared-state.ts","../src/types/gql-call.ts","../src/types/metadata.ts","../src/utils/canonical-id.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { createBuilderService } from "@soda-gql/builder";
+import { createBuilderService, formatBuilderErrorForCLI, loadArtifactSync } from "@soda-gql/builder";
 import { loadConfig } from "@soda-gql/config";
 import { resolve } from "node:path";
 import { createCanonicalId } from "@soda-gql/common";
@@ -121,20 +121,47 @@ const setSharedBuilderService = (key, service) => {
 /**
 * Create plugin session by loading config and creating cached builder service.
 * Returns null if disabled or config load fails.
+*
+* @param options - Plugin options
+* @param pluginName - Name of the plugin for error messages
+* @throws Error if failOnError is true and config load fails
 */
 const createPluginSession = (options, pluginName) => {
-	if (!(options.enabled ?? true)) return null;
+	const enabled = options.enabled ?? true;
+	const failOnError = options.failOnError ?? true;
+	if (!enabled) return null;
 	const configResult = loadConfig(options.configPath);
 	if (configResult.isErr()) {
-		console.error(`[${pluginName}] Failed to load config:`, {
+		const errorMsg = `[${pluginName}] Failed to load config: ${configResult.error.message}`;
+		console.error(errorMsg, {
 			code: configResult.error.code,
-			message: configResult.error.message,
 			filePath: configResult.error.filePath,
 			cause: configResult.error.cause
 		});
+		if (failOnError) throw new Error(errorMsg);
 		return null;
 	}
 	const config = configResult.value;
+	if (config.artifact?.path) {
+		const artifactResult = loadArtifactSync(config.artifact.path);
+		if (artifactResult.isErr()) {
+			const errorMsg = `[${pluginName}] Failed to load pre-built artifact: ${artifactResult.error.message}`;
+			console.error(errorMsg, {
+				code: artifactResult.error.code,
+				filePath: artifactResult.error.filePath
+			});
+			if (failOnError) throw new Error(errorMsg);
+			return null;
+		}
+		const prebuiltArtifact = artifactResult.value;
+		console.log(`[${pluginName}] Using pre-built artifact: ${config.artifact.path}`);
+		return {
+			config,
+			getArtifact: () => prebuiltArtifact,
+			getArtifactAsync: async () => prebuiltArtifact,
+			isPrebuiltMode: true
+		};
+	}
 	const stateKey = getStateKey(options.configPath);
 	const ensureBuilderService = () => {
 		const existing = getSharedBuilderService(stateKey);
@@ -145,13 +172,16 @@ const createPluginSession = (options, pluginName) => {
 	};
 	/**
 	* Build artifact on every invocation (like tsc-plugin).
-	* If artifact.useBuilder is false and artifact.path is provided, load from file instead.
 	* This ensures the artifact is always up-to-date with the latest source files.
+	*
+	* @throws Error if failOnError is true and build fails
 	*/
 	const getArtifact = () => {
 		const buildResult = ensureBuilderService().build();
 		if (buildResult.isErr()) {
-			console.error(`[${pluginName}] Failed to build artifact: ${buildResult.error.message}`);
+			const formattedError = formatBuilderErrorForCLI(buildResult.error);
+			console.error(`[${pluginName}] Build failed:\n${formattedError}`);
+			if (failOnError) throw new Error(`[${pluginName}] ${buildResult.error.message}`);
 			return null;
 		}
 		return buildResult.value;
@@ -159,11 +189,15 @@ const createPluginSession = (options, pluginName) => {
 	/**
 	* Async version of getArtifact.
 	* Supports async metadata factories and parallel element evaluation.
+	*
+	* @throws Error if failOnError is true and build fails
 	*/
 	const getArtifactAsync = async () => {
 		const buildResult = await ensureBuilderService().buildAsync();
 		if (buildResult.isErr()) {
-			console.error(`[${pluginName}] Failed to build artifact: ${buildResult.error.message}`);
+			const formattedError = formatBuilderErrorForCLI(buildResult.error);
+			console.error(`[${pluginName}] Build failed:\n${formattedError}`);
+			if (failOnError) throw new Error(`[${pluginName}] ${buildResult.error.message}`);
 			return null;
 		}
 		return buildResult.value;
@@ -171,7 +205,8 @@ const createPluginSession = (options, pluginName) => {
 	return {
 		config,
 		getArtifact,
-		getArtifactAsync
+		getArtifactAsync,
+		isPrebuiltMode: false
 	};
 };
 

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/errors.ts","../src/shared-state.ts","../src/plugin-session.ts","../src/utils/canonical-id.ts"],"sourcesContent":["/**\n * Error types and formatters for plugin-babel.\n * Simplified from plugin-shared to include only types actually used by the Babel transformer.\n */\n\nimport type { BuilderError } from \"@soda-gql/builder\";\nimport type { CanonicalId } from \"@soda-gql/common\";\n\ntype OptionsInvalidBuilderConfig = { readonly code: \"INVALID_BUILDER_CONFIG\"; readonly message: string };\ntype OptionsMissingBuilderConfig = { readonly code: \"MISSING_BUILDER_CONFIG\"; readonly message: string };\ntype OptionsConfigLoadFailed = { readonly code: \"CONFIG_LOAD_FAILED\"; readonly message: string };\n\ntype BuilderEntryNotFound = Extract<BuilderError, { code: \"ENTRY_NOT_FOUND\" }>;\ntype BuilderDocDuplicate = Extract<BuilderError, { code: \"DOC_DUPLICATE\" }>;\ntype BuilderCircularDependency = Extract<BuilderError, { code: \"GRAPH_CIRCULAR_DEPENDENCY\" }>;\ntype BuilderModuleEvaluationFailed = Extract<BuilderError, { code: \"RUNTIME_MODULE_LOAD_FAILED\" }>;\ntype BuilderWriteFailed = Extract<BuilderError, { code: \"WRITE_FAILED\" }>;\n\ntype AnalysisMetadataMissingCause = { readonly filename: string };\ntype AnalysisArtifactMissingCause = { readonly filename: string; readonly canonicalId: CanonicalId };\ntype AnalysisUnsupportedArtifactTypeCause = {\n  readonly filename: string;\n  readonly canonicalId: CanonicalId;\n  readonly artifactType: string;\n};\n\ntype PluginErrorBase<Code extends string, Cause> = {\n  readonly type: \"PluginError\";\n  readonly code: Code;\n  readonly message: string;\n  readonly cause: Cause;\n};\n\nexport type PluginOptionsInvalidBuilderConfigError = PluginErrorBase<\n  \"OPTIONS_INVALID_BUILDER_CONFIG\",\n  OptionsInvalidBuilderConfig | OptionsMissingBuilderConfig | OptionsConfigLoadFailed\n> & { readonly stage: \"normalize-options\" };\n\nexport type PluginBuilderEntryNotFoundError = PluginErrorBase<\"SODA_GQL_BUILDER_ENTRY_NOT_FOUND\", BuilderEntryNotFound> & {\n  readonly stage: \"builder\";\n  readonly entry: string;\n};\n\nexport type PluginBuilderDocDuplicateError = PluginErrorBase<\"SODA_GQL_BUILDER_DOC_DUPLICATE\", BuilderDocDuplicate> & {\n  readonly stage: \"builder\";\n  readonly name: string;\n  readonly sources: readonly string[];\n};\n\nexport type PluginBuilderCircularDependencyError = PluginErrorBase<\n  \"SODA_GQL_BUILDER_CIRCULAR_DEPENDENCY\",\n  BuilderCircularDependency\n> & { readonly stage: \"builder\"; readonly chain: readonly string[] };\n\nexport type PluginBuilderModuleEvaluationFailedError = PluginErrorBase<\n  \"SODA_GQL_BUILDER_MODULE_EVALUATION_FAILED\",\n  BuilderModuleEvaluationFailed\n> & { readonly stage: \"builder\"; readonly filePath: string; readonly astPath: string };\n\nexport type PluginBuilderWriteFailedError = PluginErrorBase<\"SODA_GQL_BUILDER_WRITE_FAILED\", BuilderWriteFailed> & {\n  readonly stage: \"builder\";\n  readonly outPath: string;\n};\n\nexport type PluginBuilderUnexpectedError = PluginErrorBase<\"SODA_GQL_BUILDER_UNEXPECTED\", unknown> & {\n  readonly stage: \"builder\";\n};\n\nexport type PluginAnalysisMetadataMissingError = PluginErrorBase<\"SODA_GQL_METADATA_NOT_FOUND\", AnalysisMetadataMissingCause> & {\n  readonly stage: \"analysis\";\n  readonly filename: string;\n};\n\nexport type PluginAnalysisArtifactMissingError = PluginErrorBase<\n  \"SODA_GQL_ANALYSIS_ARTIFACT_NOT_FOUND\",\n  AnalysisArtifactMissingCause\n> & { readonly stage: \"analysis\"; readonly filename: string; readonly canonicalId: CanonicalId };\n\nexport type PluginAnalysisUnsupportedArtifactTypeError = PluginErrorBase<\n  \"SODA_GQL_UNSUPPORTED_ARTIFACT_TYPE\",\n  AnalysisUnsupportedArtifactTypeCause\n> & {\n  readonly stage: \"analysis\";\n  readonly filename: string;\n  readonly canonicalId: CanonicalId;\n  readonly artifactType: string;\n};\n\ntype TransformMissingBuilderArgCause = { readonly filename: string; readonly builderType: string; readonly argName: string };\ntype TransformUnsupportedValueTypeCause = { readonly valueType: string };\ntype TransformAstVisitorFailedCause = { readonly filename: string; readonly reason: string };\n\nexport type PluginTransformMissingBuilderArgError = PluginErrorBase<\n  \"SODA_GQL_TRANSFORM_MISSING_BUILDER_ARG\",\n  TransformMissingBuilderArgCause\n> & {\n  readonly stage: \"transform\";\n  readonly filename: string;\n  readonly builderType: string;\n  readonly argName: string;\n};\n\nexport type PluginTransformUnsupportedValueTypeError = PluginErrorBase<\n  \"SODA_GQL_TRANSFORM_UNSUPPORTED_VALUE_TYPE\",\n  TransformUnsupportedValueTypeCause\n> & { readonly stage: \"transform\"; readonly valueType: string };\n\nexport type PluginTransformAstVisitorFailedError = PluginErrorBase<\n  \"SODA_GQL_TRANSFORM_AST_VISITOR_FAILED\",\n  TransformAstVisitorFailedCause\n> & { readonly stage: \"transform\"; readonly filename: string; readonly reason: string };\n\n/**\n * Union of all plugin error types.\n */\nexport type PluginError =\n  | PluginOptionsInvalidBuilderConfigError\n  | PluginBuilderEntryNotFoundError\n  | PluginBuilderDocDuplicateError\n  | PluginBuilderCircularDependencyError\n  | PluginBuilderModuleEvaluationFailedError\n  | PluginBuilderWriteFailedError\n  | PluginBuilderUnexpectedError\n  | PluginAnalysisMetadataMissingError\n  | PluginAnalysisArtifactMissingError\n  | PluginAnalysisUnsupportedArtifactTypeError\n  | PluginTransformMissingBuilderArgError\n  | PluginTransformUnsupportedValueTypeError\n  | PluginTransformAstVisitorFailedError;\n\n/**\n * Format a PluginError into a human-readable message.\n */\nexport const formatPluginError = (error: PluginError): string => {\n  const codePrefix = `[${error.code}]`;\n  const stageInfo = \"stage\" in error ? ` (${error.stage})` : \"\";\n  return `${codePrefix}${stageInfo} ${error.message}`;\n};\n\n/**\n * Type guard for PluginError.\n */\nexport const isPluginError = (value: unknown): value is PluginError => {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === \"PluginError\" &&\n    \"code\" in value &&\n    \"message\" in value\n  );\n};\n\n/**\n * Assertion helper for unreachable code paths.\n * This is the ONLY acceptable throw in plugin code.\n */\nexport const assertUnreachable = (value: never, context?: string): never => {\n  throw new Error(`[INTERNAL] Unreachable code path${context ? ` in ${context}` : \"\"}: received ${JSON.stringify(value)}`);\n};\n","import type { BuilderArtifact, BuilderService } from \"@soda-gql/builder\";\nimport type { PluginSession } from \"./plugin-session\";\n\n/**\n * Transformer type for code transformation.\n * - 'babel': Use Babel plugin (default, wider compatibility)\n * - 'swc': Use SWC transformer (faster, requires @soda-gql/swc-transformer)\n */\nexport type TransformerType = \"babel\" | \"swc\";\n\n/**\n * Minimal interface for SWC transformer.\n * Matches the Transformer interface from @soda-gql/swc-transformer.\n */\nexport interface SwcTransformerInterface {\n  transform(input: { sourceCode: string; sourcePath: string; inputSourceMap?: string }): {\n    transformed: boolean;\n    sourceCode: string;\n    sourceMap?: string;\n  };\n}\n\n/**\n * Shared state between bundler plugins and loaders.\n * Enables efficient artifact sharing across build pipeline stages.\n */\nexport type SharedState = {\n  pluginSession: PluginSession | null;\n  currentArtifact: BuilderArtifact | null;\n  moduleAdjacency: Map<string, Set<string>>;\n  generation: number;\n  swcTransformer: SwcTransformerInterface | null;\n  transformerType: TransformerType | null;\n  builderService: BuilderService | null;\n};\n\n// Global state for sharing between plugin and loader\nconst sharedStates = new Map<string, SharedState>();\n\n/**\n * Get shared state for a given project (identified by config path or cwd).\n */\nexport const getSharedState = (key: string): SharedState => {\n  let state = sharedStates.get(key);\n  if (!state) {\n    state = {\n      pluginSession: null,\n      currentArtifact: null,\n      moduleAdjacency: new Map(),\n      generation: 0,\n      swcTransformer: null,\n      transformerType: null,\n      builderService: null,\n    };\n    sharedStates.set(key, state);\n  }\n  return state;\n};\n\n/**\n * Update shared artifact.\n */\nexport const setSharedArtifact = (\n  key: string,\n  artifact: BuilderArtifact | null,\n  moduleAdjacency?: Map<string, Set<string>>,\n): void => {\n  const state = getSharedState(key);\n  state.currentArtifact = artifact;\n  if (moduleAdjacency) {\n    state.moduleAdjacency = moduleAdjacency;\n  }\n  state.generation++;\n};\n\n/**\n * Get shared artifact.\n */\nexport const getSharedArtifact = (key: string): BuilderArtifact | null => {\n  return getSharedState(key).currentArtifact;\n};\n\n/**\n * Get shared plugin session.\n */\nexport const getSharedPluginSession = (key: string): PluginSession | null => {\n  return getSharedState(key).pluginSession;\n};\n\n/**\n * Set shared plugin session.\n */\nexport const setSharedPluginSession = (key: string, session: PluginSession | null): void => {\n  getSharedState(key).pluginSession = session;\n};\n\n/**\n * Get the state key from config path or cwd.\n */\nexport const getStateKey = (configPath?: string): string => {\n  return configPath ?? process.cwd();\n};\n\n/**\n * Set shared SWC transformer.\n */\nexport const setSharedSwcTransformer = (key: string, transformer: SwcTransformerInterface | null): void => {\n  getSharedState(key).swcTransformer = transformer;\n};\n\n/**\n * Get shared SWC transformer.\n */\nexport const getSharedSwcTransformer = (key: string): SwcTransformerInterface | null => {\n  return getSharedState(key).swcTransformer;\n};\n\n/**\n * Set shared transformer type.\n */\nexport const setSharedTransformerType = (key: string, transformerType: TransformerType | null): void => {\n  getSharedState(key).transformerType = transformerType;\n};\n\n/**\n * Get shared transformer type.\n */\nexport const getSharedTransformerType = (key: string): TransformerType | null => {\n  return getSharedState(key).transformerType;\n};\n\n/**\n * Get shared BuilderService.\n */\nexport const getSharedBuilderService = (key: string): BuilderService | null => {\n  return getSharedState(key).builderService;\n};\n\n/**\n * Set shared BuilderService.\n */\nexport const setSharedBuilderService = (key: string, service: BuilderService | null): void => {\n  getSharedState(key).builderService = service;\n};\n","/**\n * Plugin session management for all plugins.\n * Unified from plugin-babel and plugin-swc implementations.\n */\n\nimport type { BuilderArtifact, BuilderService } from \"@soda-gql/builder\";\nimport { createBuilderService } from \"@soda-gql/builder\";\nimport { loadConfig, type ResolvedSodaGqlConfig } from \"@soda-gql/config\";\nimport { getSharedBuilderService, getStateKey, setSharedBuilderService } from \"./shared-state\";\n\n/**\n * Plugin options shared across all plugins.\n */\nexport type PluginOptions = {\n  readonly configPath?: string;\n  readonly enabled?: boolean;\n};\n\n/**\n * Plugin session containing builder service and configuration.\n */\nexport type PluginSession = {\n  readonly config: ResolvedSodaGqlConfig;\n  readonly getArtifact: () => BuilderArtifact | null;\n  readonly getArtifactAsync: () => Promise<BuilderArtifact | null>;\n};\n\n/**\n * Create plugin session by loading config and creating cached builder service.\n * Returns null if disabled or config load fails.\n */\nexport const createPluginSession = (options: PluginOptions, pluginName: string): PluginSession | null => {\n  const enabled = options.enabled ?? true;\n  if (!enabled) {\n    return null;\n  }\n\n  const configResult = loadConfig(options.configPath);\n  if (configResult.isErr()) {\n    console.error(`[${pluginName}] Failed to load config:`, {\n      code: configResult.error.code,\n      message: configResult.error.message,\n      filePath: configResult.error.filePath,\n      cause: configResult.error.cause,\n    });\n    return null;\n  }\n\n  const config = configResult.value;\n  const stateKey = getStateKey(options.configPath);\n\n  // Use global BuilderService cache to share FileTracker state across plugin instances\n  const ensureBuilderService = (): BuilderService => {\n    const existing = getSharedBuilderService(stateKey);\n    if (existing) {\n      return existing;\n    }\n\n    const service = createBuilderService({ config });\n    setSharedBuilderService(stateKey, service);\n    return service;\n  };\n\n  /**\n   * Build artifact on every invocation (like tsc-plugin).\n   * If artifact.useBuilder is false and artifact.path is provided, load from file instead.\n   * This ensures the artifact is always up-to-date with the latest source files.\n   */\n  const getArtifact = (): BuilderArtifact | null => {\n    const builderService = ensureBuilderService();\n    const buildResult = builderService.build();\n    if (buildResult.isErr()) {\n      console.error(`[${pluginName}] Failed to build artifact: ${buildResult.error.message}`);\n      return null;\n    }\n    return buildResult.value;\n  };\n\n  /**\n   * Async version of getArtifact.\n   * Supports async metadata factories and parallel element evaluation.\n   */\n  const getArtifactAsync = async (): Promise<BuilderArtifact | null> => {\n    const builderService = ensureBuilderService();\n    const buildResult = await builderService.buildAsync();\n    if (buildResult.isErr()) {\n      console.error(`[${pluginName}] Failed to build artifact: ${buildResult.error.message}`);\n      return null;\n    }\n    return buildResult.value;\n  };\n\n  return {\n    config,\n    getArtifact,\n    getArtifactAsync,\n  };\n};\n","/**\n * Utility for working with canonical IDs.\n */\n\nimport { resolve } from \"node:path\";\nimport { type CanonicalId, createCanonicalId } from \"@soda-gql/common\";\n\n/**\n * Resolve a canonical ID from a filename and AST path.\n */\nexport const resolveCanonicalId = (filename: string, astPath: string): CanonicalId =>\n  createCanonicalId(resolve(filename), astPath);\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/errors.ts","../src/shared-state.ts","../src/plugin-session.ts","../src/utils/canonical-id.ts"],"sourcesContent":["/**\n * Error types and formatters for plugin-babel.\n * Simplified from plugin-shared to include only types actually used by the Babel transformer.\n */\n\nimport type { BuilderError } from \"@soda-gql/builder\";\nimport type { CanonicalId } from \"@soda-gql/common\";\n\ntype OptionsInvalidBuilderConfig = { readonly code: \"INVALID_BUILDER_CONFIG\"; readonly message: string };\ntype OptionsMissingBuilderConfig = { readonly code: \"MISSING_BUILDER_CONFIG\"; readonly message: string };\ntype OptionsConfigLoadFailed = { readonly code: \"CONFIG_LOAD_FAILED\"; readonly message: string };\n\ntype BuilderEntryNotFound = Extract<BuilderError, { code: \"ENTRY_NOT_FOUND\" }>;\ntype BuilderDocDuplicate = Extract<BuilderError, { code: \"DOC_DUPLICATE\" }>;\ntype BuilderCircularDependency = Extract<BuilderError, { code: \"GRAPH_CIRCULAR_DEPENDENCY\" }>;\ntype BuilderModuleEvaluationFailed = Extract<BuilderError, { code: \"RUNTIME_MODULE_LOAD_FAILED\" }>;\ntype BuilderWriteFailed = Extract<BuilderError, { code: \"WRITE_FAILED\" }>;\n\ntype AnalysisMetadataMissingCause = { readonly filename: string };\ntype AnalysisArtifactMissingCause = { readonly filename: string; readonly canonicalId: CanonicalId };\ntype AnalysisUnsupportedArtifactTypeCause = {\n  readonly filename: string;\n  readonly canonicalId: CanonicalId;\n  readonly artifactType: string;\n};\n\ntype PluginErrorBase<Code extends string, Cause> = {\n  readonly type: \"PluginError\";\n  readonly code: Code;\n  readonly message: string;\n  readonly cause: Cause;\n};\n\nexport type PluginOptionsInvalidBuilderConfigError = PluginErrorBase<\n  \"OPTIONS_INVALID_BUILDER_CONFIG\",\n  OptionsInvalidBuilderConfig | OptionsMissingBuilderConfig | OptionsConfigLoadFailed\n> & { readonly stage: \"normalize-options\" };\n\nexport type PluginBuilderEntryNotFoundError = PluginErrorBase<\"SODA_GQL_BUILDER_ENTRY_NOT_FOUND\", BuilderEntryNotFound> & {\n  readonly stage: \"builder\";\n  readonly entry: string;\n};\n\nexport type PluginBuilderDocDuplicateError = PluginErrorBase<\"SODA_GQL_BUILDER_DOC_DUPLICATE\", BuilderDocDuplicate> & {\n  readonly stage: \"builder\";\n  readonly name: string;\n  readonly sources: readonly string[];\n};\n\nexport type PluginBuilderCircularDependencyError = PluginErrorBase<\n  \"SODA_GQL_BUILDER_CIRCULAR_DEPENDENCY\",\n  BuilderCircularDependency\n> & { readonly stage: \"builder\"; readonly chain: readonly string[] };\n\nexport type PluginBuilderModuleEvaluationFailedError = PluginErrorBase<\n  \"SODA_GQL_BUILDER_MODULE_EVALUATION_FAILED\",\n  BuilderModuleEvaluationFailed\n> & { readonly stage: \"builder\"; readonly filePath: string; readonly astPath: string };\n\nexport type PluginBuilderWriteFailedError = PluginErrorBase<\"SODA_GQL_BUILDER_WRITE_FAILED\", BuilderWriteFailed> & {\n  readonly stage: \"builder\";\n  readonly outPath: string;\n};\n\nexport type PluginBuilderUnexpectedError = PluginErrorBase<\"SODA_GQL_BUILDER_UNEXPECTED\", unknown> & {\n  readonly stage: \"builder\";\n};\n\nexport type PluginAnalysisMetadataMissingError = PluginErrorBase<\"SODA_GQL_METADATA_NOT_FOUND\", AnalysisMetadataMissingCause> & {\n  readonly stage: \"analysis\";\n  readonly filename: string;\n};\n\nexport type PluginAnalysisArtifactMissingError = PluginErrorBase<\n  \"SODA_GQL_ANALYSIS_ARTIFACT_NOT_FOUND\",\n  AnalysisArtifactMissingCause\n> & { readonly stage: \"analysis\"; readonly filename: string; readonly canonicalId: CanonicalId };\n\nexport type PluginAnalysisUnsupportedArtifactTypeError = PluginErrorBase<\n  \"SODA_GQL_UNSUPPORTED_ARTIFACT_TYPE\",\n  AnalysisUnsupportedArtifactTypeCause\n> & {\n  readonly stage: \"analysis\";\n  readonly filename: string;\n  readonly canonicalId: CanonicalId;\n  readonly artifactType: string;\n};\n\ntype TransformMissingBuilderArgCause = { readonly filename: string; readonly builderType: string; readonly argName: string };\ntype TransformUnsupportedValueTypeCause = { readonly valueType: string };\ntype TransformAstVisitorFailedCause = { readonly filename: string; readonly reason: string };\n\nexport type PluginTransformMissingBuilderArgError = PluginErrorBase<\n  \"SODA_GQL_TRANSFORM_MISSING_BUILDER_ARG\",\n  TransformMissingBuilderArgCause\n> & {\n  readonly stage: \"transform\";\n  readonly filename: string;\n  readonly builderType: string;\n  readonly argName: string;\n};\n\nexport type PluginTransformUnsupportedValueTypeError = PluginErrorBase<\n  \"SODA_GQL_TRANSFORM_UNSUPPORTED_VALUE_TYPE\",\n  TransformUnsupportedValueTypeCause\n> & { readonly stage: \"transform\"; readonly valueType: string };\n\nexport type PluginTransformAstVisitorFailedError = PluginErrorBase<\n  \"SODA_GQL_TRANSFORM_AST_VISITOR_FAILED\",\n  TransformAstVisitorFailedCause\n> & { readonly stage: \"transform\"; readonly filename: string; readonly reason: string };\n\n/**\n * Union of all plugin error types.\n */\nexport type PluginError =\n  | PluginOptionsInvalidBuilderConfigError\n  | PluginBuilderEntryNotFoundError\n  | PluginBuilderDocDuplicateError\n  | PluginBuilderCircularDependencyError\n  | PluginBuilderModuleEvaluationFailedError\n  | PluginBuilderWriteFailedError\n  | PluginBuilderUnexpectedError\n  | PluginAnalysisMetadataMissingError\n  | PluginAnalysisArtifactMissingError\n  | PluginAnalysisUnsupportedArtifactTypeError\n  | PluginTransformMissingBuilderArgError\n  | PluginTransformUnsupportedValueTypeError\n  | PluginTransformAstVisitorFailedError;\n\n/**\n * Format a PluginError into a human-readable message.\n */\nexport const formatPluginError = (error: PluginError): string => {\n  const codePrefix = `[${error.code}]`;\n  const stageInfo = \"stage\" in error ? ` (${error.stage})` : \"\";\n  return `${codePrefix}${stageInfo} ${error.message}`;\n};\n\n/**\n * Type guard for PluginError.\n */\nexport const isPluginError = (value: unknown): value is PluginError => {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    value.type === \"PluginError\" &&\n    \"code\" in value &&\n    \"message\" in value\n  );\n};\n\n/**\n * Assertion helper for unreachable code paths.\n * This is the ONLY acceptable throw in plugin code.\n */\nexport const assertUnreachable = (value: never, context?: string): never => {\n  throw new Error(`[INTERNAL] Unreachable code path${context ? ` in ${context}` : \"\"}: received ${JSON.stringify(value)}`);\n};\n","import type { BuilderArtifact, BuilderService } from \"@soda-gql/builder\";\nimport type { PluginSession } from \"./plugin-session\";\n\n/**\n * Transformer type for code transformation.\n * - 'babel': Use Babel plugin (default, wider compatibility)\n * - 'swc': Use SWC transformer (faster, requires @soda-gql/swc-transformer)\n */\nexport type TransformerType = \"babel\" | \"swc\";\n\n/**\n * Minimal interface for SWC transformer.\n * Matches the Transformer interface from @soda-gql/swc-transformer.\n */\nexport interface SwcTransformerInterface {\n  transform(input: { sourceCode: string; sourcePath: string; inputSourceMap?: string }): {\n    transformed: boolean;\n    sourceCode: string;\n    sourceMap?: string;\n  };\n}\n\n/**\n * Shared state between bundler plugins and loaders.\n * Enables efficient artifact sharing across build pipeline stages.\n */\nexport type SharedState = {\n  pluginSession: PluginSession | null;\n  currentArtifact: BuilderArtifact | null;\n  moduleAdjacency: Map<string, Set<string>>;\n  generation: number;\n  swcTransformer: SwcTransformerInterface | null;\n  transformerType: TransformerType | null;\n  builderService: BuilderService | null;\n};\n\n// Global state for sharing between plugin and loader\nconst sharedStates = new Map<string, SharedState>();\n\n/**\n * Get shared state for a given project (identified by config path or cwd).\n */\nexport const getSharedState = (key: string): SharedState => {\n  let state = sharedStates.get(key);\n  if (!state) {\n    state = {\n      pluginSession: null,\n      currentArtifact: null,\n      moduleAdjacency: new Map(),\n      generation: 0,\n      swcTransformer: null,\n      transformerType: null,\n      builderService: null,\n    };\n    sharedStates.set(key, state);\n  }\n  return state;\n};\n\n/**\n * Update shared artifact.\n */\nexport const setSharedArtifact = (\n  key: string,\n  artifact: BuilderArtifact | null,\n  moduleAdjacency?: Map<string, Set<string>>,\n): void => {\n  const state = getSharedState(key);\n  state.currentArtifact = artifact;\n  if (moduleAdjacency) {\n    state.moduleAdjacency = moduleAdjacency;\n  }\n  state.generation++;\n};\n\n/**\n * Get shared artifact.\n */\nexport const getSharedArtifact = (key: string): BuilderArtifact | null => {\n  return getSharedState(key).currentArtifact;\n};\n\n/**\n * Get shared plugin session.\n */\nexport const getSharedPluginSession = (key: string): PluginSession | null => {\n  return getSharedState(key).pluginSession;\n};\n\n/**\n * Set shared plugin session.\n */\nexport const setSharedPluginSession = (key: string, session: PluginSession | null): void => {\n  getSharedState(key).pluginSession = session;\n};\n\n/**\n * Get the state key from config path or cwd.\n */\nexport const getStateKey = (configPath?: string): string => {\n  return configPath ?? process.cwd();\n};\n\n/**\n * Set shared SWC transformer.\n */\nexport const setSharedSwcTransformer = (key: string, transformer: SwcTransformerInterface | null): void => {\n  getSharedState(key).swcTransformer = transformer;\n};\n\n/**\n * Get shared SWC transformer.\n */\nexport const getSharedSwcTransformer = (key: string): SwcTransformerInterface | null => {\n  return getSharedState(key).swcTransformer;\n};\n\n/**\n * Set shared transformer type.\n */\nexport const setSharedTransformerType = (key: string, transformerType: TransformerType | null): void => {\n  getSharedState(key).transformerType = transformerType;\n};\n\n/**\n * Get shared transformer type.\n */\nexport const getSharedTransformerType = (key: string): TransformerType | null => {\n  return getSharedState(key).transformerType;\n};\n\n/**\n * Get shared BuilderService.\n */\nexport const getSharedBuilderService = (key: string): BuilderService | null => {\n  return getSharedState(key).builderService;\n};\n\n/**\n * Set shared BuilderService.\n */\nexport const setSharedBuilderService = (key: string, service: BuilderService | null): void => {\n  getSharedState(key).builderService = service;\n};\n","/**\n * Plugin session management for all plugins.\n * Unified from plugin-babel and plugin-swc implementations.\n */\n\nimport type { BuilderArtifact, BuilderService } from \"@soda-gql/builder\";\nimport { createBuilderService, formatBuilderErrorForCLI, loadArtifactSync } from \"@soda-gql/builder\";\nimport { loadConfig, type ResolvedSodaGqlConfig } from \"@soda-gql/config\";\nimport { getSharedBuilderService, getStateKey, setSharedBuilderService } from \"./shared-state\";\n\n/**\n * Plugin options shared across all plugins.\n */\nexport type PluginOptions = {\n  readonly configPath?: string;\n  readonly enabled?: boolean;\n  /**\n   * Whether to fail the build on error.\n   * When true (default), throws an error that fails the bundler build.\n   * When false, logs the error and continues (graceful degradation).\n   */\n  readonly failOnError?: boolean;\n};\n\n/**\n * Plugin session containing builder service and configuration.\n */\nexport type PluginSession = {\n  readonly config: ResolvedSodaGqlConfig;\n  readonly getArtifact: () => BuilderArtifact | null;\n  readonly getArtifactAsync: () => Promise<BuilderArtifact | null>;\n  /**\n   * Whether the session is using a pre-built artifact.\n   * When true, artifacts are loaded from a file instead of built dynamically.\n   */\n  readonly isPrebuiltMode: boolean;\n};\n\n/**\n * Create plugin session by loading config and creating cached builder service.\n * Returns null if disabled or config load fails.\n *\n * @param options - Plugin options\n * @param pluginName - Name of the plugin for error messages\n * @throws Error if failOnError is true and config load fails\n */\nexport const createPluginSession = (options: PluginOptions, pluginName: string): PluginSession | null => {\n  const enabled = options.enabled ?? true;\n  const failOnError = options.failOnError ?? true;\n\n  if (!enabled) {\n    return null;\n  }\n\n  const configResult = loadConfig(options.configPath);\n  if (configResult.isErr()) {\n    const errorMsg = `[${pluginName}] Failed to load config: ${configResult.error.message}`;\n    console.error(errorMsg, {\n      code: configResult.error.code,\n      filePath: configResult.error.filePath,\n      cause: configResult.error.cause,\n    });\n    if (failOnError) {\n      throw new Error(errorMsg);\n    }\n    return null;\n  }\n\n  const config = configResult.value;\n\n  // Check if pre-built artifact mode is enabled\n  if (config.artifact?.path) {\n    const artifactResult = loadArtifactSync(config.artifact.path);\n\n    if (artifactResult.isErr()) {\n      const errorMsg = `[${pluginName}] Failed to load pre-built artifact: ${artifactResult.error.message}`;\n      console.error(errorMsg, {\n        code: artifactResult.error.code,\n        filePath: artifactResult.error.filePath,\n      });\n      if (failOnError) {\n        throw new Error(errorMsg);\n      }\n      return null;\n    }\n\n    const prebuiltArtifact = artifactResult.value;\n    console.log(`[${pluginName}] Using pre-built artifact: ${config.artifact.path}`);\n\n    return {\n      config,\n      getArtifact: () => prebuiltArtifact,\n      getArtifactAsync: async () => prebuiltArtifact,\n      isPrebuiltMode: true,\n    };\n  }\n\n  // Dynamic build mode\n  const stateKey = getStateKey(options.configPath);\n\n  // Use global BuilderService cache to share FileTracker state across plugin instances\n  const ensureBuilderService = (): BuilderService => {\n    const existing = getSharedBuilderService(stateKey);\n    if (existing) {\n      return existing;\n    }\n\n    const service = createBuilderService({ config });\n    setSharedBuilderService(stateKey, service);\n    return service;\n  };\n\n  /**\n   * Build artifact on every invocation (like tsc-plugin).\n   * This ensures the artifact is always up-to-date with the latest source files.\n   *\n   * @throws Error if failOnError is true and build fails\n   */\n  const getArtifact = (): BuilderArtifact | null => {\n    const builderService = ensureBuilderService();\n    const buildResult = builderService.build();\n    if (buildResult.isErr()) {\n      const formattedError = formatBuilderErrorForCLI(buildResult.error);\n      console.error(`[${pluginName}] Build failed:\\n${formattedError}`);\n      if (failOnError) {\n        throw new Error(`[${pluginName}] ${buildResult.error.message}`);\n      }\n      return null;\n    }\n    return buildResult.value;\n  };\n\n  /**\n   * Async version of getArtifact.\n   * Supports async metadata factories and parallel element evaluation.\n   *\n   * @throws Error if failOnError is true and build fails\n   */\n  const getArtifactAsync = async (): Promise<BuilderArtifact | null> => {\n    const builderService = ensureBuilderService();\n    const buildResult = await builderService.buildAsync();\n    if (buildResult.isErr()) {\n      const formattedError = formatBuilderErrorForCLI(buildResult.error);\n      console.error(`[${pluginName}] Build failed:\\n${formattedError}`);\n      if (failOnError) {\n        throw new Error(`[${pluginName}] ${buildResult.error.message}`);\n      }\n      return null;\n    }\n    return buildResult.value;\n  };\n\n  return {\n    config,\n    getArtifact,\n    getArtifactAsync,\n    isPrebuiltMode: false,\n  };\n};\n","/**\n * Utility for working with canonical IDs.\n */\n\nimport { resolve } from \"node:path\";\nimport { type CanonicalId, createCanonicalId } from \"@soda-gql/common\";\n\n/**\n * Resolve a canonical ID from a filename and AST path.\n */\nexport const resolveCanonicalId = (filename: string, astPath: string): CanonicalId =>\n  createCanonicalId(resolve(filename), astPath);\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soda-gql/plugin-common",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Shared utilities for soda-gql build plugins",
   "type": "module",
   "private": false,
@@ -46,9 +46,9 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@soda-gql/builder": "~0.7.0",
-    "@soda-gql/common": "~0.7.0",
-    "@soda-gql/config": "~0.7.0",
+    "@soda-gql/builder": "~0.9.0",
+    "@soda-gql/common": "~0.9.0",
+    "@soda-gql/config": "~0.9.0",
     "neverthrow": "^8.1.1"
   },
   "devDependencies": {},