fix(core): resolve udl-codegen CLI issues when run standalone

- Pass cacheDir to loadPlugins() so cached nodes are found correctly
- Use full plugin names for owner matching instead of basename()
- Only load manual test configs within UDL monorepo development
- Pass GraphQL schema to runCodegen() for extensions
- Make resolver registration idempotent to handle duplicate loading

Author: dawidurbanski

.changeset/fix-codegen-cli.md

@@ -0,0 +1,11 @@
+---
+'universal-data-layer': patch
+---
+
+Fix `udl-codegen` CLI to work correctly when run standalone
+
+- Pass `cacheDir` to `loadPlugins()` so cached nodes are found in the app's `.udl-cache` directory instead of the plugin's node_modules
+- Use full plugin names instead of `basename()` for owner matching, fixing "No nodes found in store" errors
+- Only load manual test configs when running within the UDL monorepo development environment
+- Pass GraphQL schema to `runCodegen()` so extensions like `codegen-typed-queries` work correctly
+- Make reference resolver registration idempotent to prevent errors when plugins are loaded multiple times

packages/core/src/codegen-only.ts

@@ -11,11 +11,11 @@
  */
 
 import { loadAppConfig, loadPlugins } from '@/loader.js';
-import { rebuildHandler } from '@/handlers/graphql.js';
+import { rebuildHandler, getCurrentSchema } from '@/handlers/graphql.js';
 import { runCodegen } from '@/codegen.js';
 import { loadEnv } from '@/env.js';
 import { fileURLToPath } from 'node:url';
-import { basename, dirname, resolve } from 'node:path';
+import { dirname, resolve } from 'node:path';
 import { defaultStore } from '@/nodes/defaultStore.js';
 import { startMockServer, stopMockServer } from '@/mocks/index.js';
 import { loadManualTestConfigs, type FeatureCodegenInfo } from '@/features.js';
@@ -61,19 +61,29 @@ export async function runCodegenOnly(
   const codegenConfigs: FeatureCodegenInfo[] = [];
   const mainAppPluginNames: string[] = [];
 
+  // Determine if caching is enabled
+  const cacheEnabled = userConfig.cache !== false;
+
   // Load main app config plugins
   if (userConfig.plugins && userConfig.plugins.length > 0) {
     console.log('Loading plugins...');
+    // Track plugin names before loading
+    // Note: The actual owner name is determined by the plugin's config.name or basename
+    // For npm packages like '@universal-data-layer/plugin-source-contentful', the plugin's config.name is used
     for (const plugin of userConfig.plugins) {
       if (typeof plugin === 'string') {
-        mainAppPluginNames.push(basename(plugin));
+        // For package names, use the full name (not basename)
+        // The plugin will use its config.name if available, or basename of resolved path
+        mainAppPluginNames.push(plugin);
       } else {
-        mainAppPluginNames.push(basename(plugin.name));
+        mainAppPluginNames.push(plugin.name);
       }
     }
     const pluginResult = await loadPlugins(userConfig.plugins, {
       appConfig: userConfig,
       store: defaultStore,
+      cache: cacheEnabled,
+      cacheDir: configPath,
     });
 
     for (const pluginCodegen of pluginResult.codegenConfigs) {
@@ -94,20 +104,31 @@ export async function runCodegenOnly(
     });
   }
 
-  // Load configs from manual test features
+  // Load configs from manual test features (only when running from within UDL development)
+  // Skip when running from a consumer's app (configPath outside the package)
   if (includeManualTests) {
     const __filename = fileURLToPath(import.meta.url);
     const __dirname = dirname(__filename);
     const packageRoot = resolve(__dirname, '..', '..');
 
-    const featureConfigs = await loadManualTestConfigs(packageRoot);
-    codegenConfigs.push(...featureConfigs);
+    // Only load manual tests if cwd is within the UDL monorepo
+    const isWithinMonorepo =
+      configPath.startsWith(packageRoot) ||
+      configPath.startsWith(resolve(packageRoot, '..', '..'));
+
+    if (isWithinMonorepo) {
+      const featureConfigs = await loadManualTestConfigs(packageRoot);
+      codegenConfigs.push(...featureConfigs);
+    }
   }
 
   // Build the GraphQL schema
   console.log('🔨 Building GraphQL schema from sourced nodes...');
   await rebuildHandler();
 
+  // Get the current schema for query generation
+  const schema = await getCurrentSchema();
+
   // Run codegen for all configs
   let successCount = 0;
   let errorCount = 0;
@@ -123,6 +144,7 @@ export async function runCodegenOnly(
         store: defaultStore,
         basePath,
         owners: pluginNames,
+        schema,
       });
       successCount++;
     } catch (error) {

packages/core/src/references/registry.ts

@@ -62,13 +62,12 @@ export class ReferenceRegistry {
 
   /**
    * Register a reference resolver for a plugin.
-   * @throws if a resolver with the same ID is already registered
+   * If a resolver with the same ID is already registered, it is skipped.
    */
   registerResolver(config: ReferenceResolverConfig): void {
     if (this.resolvers.has(config.id)) {
-      throw new Error(
-        `Reference resolver with ID "${config.id}" is already registered`
-      );
+      // Already registered, skip silently (same plugin loaded multiple times)
+      return;
     }
 
     this.resolvers.set(config.id, config);