feat(codegen): cli.stashName so generated CLIs can share one signed-in state

graphql/codegen/src/__tests__/codegen/cli-generator.test.ts

@@ -719,3 +719,46 @@ describe('multi-target cli with custom builtinNames', () => {
     expect(fileNames).not.toContain('commands/context.ts');
   });
 });
+
+describe('cli stashName', () => {
+  it('omits stashName from the store call when not configured', () => {
+    const single = generateCli({
+      tables: [carTable],
+      customOperations: { queries: [], mutations: [] },
+      config: { cli: { toolName: 'myapp' } },
+    });
+    const executor = single.files.find((f) => f.fileName === 'executor.ts');
+    expect(executor!.content).toContain('createConfigStore("myapp")');
+  });
+
+  it('passes stashName to the store while keeping toolName', () => {
+    const single = generateCli({
+      tables: [carTable],
+      customOperations: { queries: [], mutations: [] },
+      config: { cli: { toolName: 'myapp', stashName: 'shared' } },
+    });
+    const executor = single.files.find((f) => f.fileName === 'executor.ts');
+    expect(executor!.content).toContain('createConfigStore("myapp", {');
+    expect(executor!.content).toContain('stashName: "shared"');
+  });
+
+  it('passes stashName to multi-target executor and helpers', () => {
+    const multi = generateMultiTargetCli({
+      toolName: 'myapp',
+      stashName: 'shared',
+      targets: [
+        {
+          name: 'app',
+          endpoint: 'http://app.localhost/graphql',
+          ormImportPath: '../../generated/app/orm',
+          tables: [carTable],
+          customOperations: { queries: [], mutations: [] },
+        },
+      ],
+    });
+    for (const fileName of ['executor.ts', 'helpers.ts']) {
+      const file = multi.files.find((f) => f.fileName === fileName);
+      expect(file!.content).toContain('stashName: "shared"');
+    }
+  });
+});

graphql/codegen/src/core/codegen/cli/executor-generator.ts

@@ -30,7 +30,23 @@ function createImportDeclaration(
   return decl;
 }
 
-export function generateExecutorFile(toolName: string): GeneratedFile {
+/**
+ * `createConfigStore(toolName)`, or `createConfigStore(toolName, { stashName })`
+ * when the CLI shares its signed-in state with other tools of the same product.
+ */
+function createStoreCall(toolName: string, stashName?: string): t.CallExpression {
+  const args: t.Expression[] = [t.stringLiteral(toolName)];
+  if (stashName) {
+    args.push(
+      t.objectExpression([
+        t.objectProperty(t.identifier('stashName'), t.stringLiteral(stashName)),
+      ]),
+    );
+  }
+  return t.callExpression(t.identifier('createConfigStore'), args);
+}
+
+export function generateExecutorFile(toolName: string, stashName?: string): GeneratedFile {
   const statements: t.Statement[] = [];
 
   statements.push(
@@ -44,9 +60,7 @@ export function generateExecutorFile(toolName: string): GeneratedFile {
     t.variableDeclaration('const', [
       t.variableDeclarator(
         t.identifier('store'),
-        t.callExpression(t.identifier('createConfigStore'), [
-          t.stringLiteral(toolName),
-        ]),
+        createStoreCall(toolName, stashName),
       ),
     ]),
   );
@@ -238,6 +252,7 @@ export function generateExecutorFile(toolName: string): GeneratedFile {
 export function generateMultiTargetExecutorFile(
   toolName: string,
   targets: MultiTargetExecutorInput[],
+  stashName?: string,
 ): GeneratedFile {
   const statements: t.Statement[] = [];
 
@@ -260,9 +275,7 @@ export function generateMultiTargetExecutorFile(
     t.variableDeclaration('const', [
       t.variableDeclarator(
         t.identifier('store'),
-        t.callExpression(t.identifier('createConfigStore'), [
-          t.stringLiteral(toolName),
-        ]),
+        createStoreCall(toolName, stashName),
       ),
     ]),
   );

graphql/codegen/src/core/codegen/cli/helpers-generator.ts

@@ -37,6 +37,7 @@ export interface HelpersGeneratorInput {
 export function generateHelpersFile(
   toolName: string,
   targets: HelpersGeneratorInput[],
+  stashName?: string,
 ): GeneratedFile {
   const statements: t.Statement[] = [];
 
@@ -61,14 +62,20 @@ export function generateHelpersFile(
     );
   }
 
-  // const store = createConfigStore('toolName');
+  // const store = createConfigStore('toolName', { stashName: 'product' });
+  const storeArgs: t.Expression[] = [t.stringLiteral(toolName)];
+  if (stashName) {
+    storeArgs.push(
+      t.objectExpression([
+        t.objectProperty(t.identifier('stashName'), t.stringLiteral(stashName)),
+      ]),
+    );
+  }
   statements.push(
     t.variableDeclaration('const', [
       t.variableDeclarator(
         t.identifier('store'),
-        t.callExpression(t.identifier('createConfigStore'), [
-          t.stringLiteral(toolName),
-        ]),
+        t.callExpression(t.identifier('createConfigStore'), storeArgs),
       ),
     ]),
   );

graphql/codegen/src/core/codegen/cli/index.ts

@@ -48,7 +48,10 @@ export function generateCli(options: GenerateCliOptions): GenerateCliResult {
       ? cliConfig.toolName
       : 'app';
 
-  const executorFile = generateExecutorFile(toolName);
+  const stashName =
+    typeof cliConfig === 'object' ? cliConfig.stashName : undefined;
+
+  const executorFile = generateExecutorFile(toolName, stashName);
   files.push(executorFile);
 
   const utilsFile = generateUtilsFile();
@@ -127,6 +130,8 @@ export interface MultiTargetCliTarget {
 
 export interface GenerateMultiTargetCliOptions {
   toolName: string;
+  /** Directory identity to share signed-in state with sibling tools. */
+  stashName?: string;
   builtinNames?: BuiltinNames;
   targets: MultiTargetCliTarget[];
   /** Generate a runnable index.ts entry point */
@@ -157,7 +162,7 @@ export function resolveBuiltinNames(
 export function generateMultiTargetCli(
   options: GenerateMultiTargetCliOptions,
 ): GenerateCliResult {
-  const { toolName, targets } = options;
+  const { toolName, stashName, targets } = options;
   const files: GeneratedFile[] = [];
 
   const targetNames = targets.map((t) => t.name);
@@ -168,7 +173,7 @@ export function generateMultiTargetCli(
     endpoint: t.endpoint,
     ormImportPath: t.ormImportPath,
   }));
-  const executorFile = generateMultiTargetExecutorFile(toolName, executorInputs);
+  const executorFile = generateMultiTargetExecutorFile(toolName, executorInputs, stashName);
   files.push(executorFile);
 
   const utilsFile = generateUtilsFile();
@@ -201,7 +206,7 @@ export function generateMultiTargetCli(
     name: t.name,
     ormImportPath: t.ormImportPath,
   }));
-  const helpersFile = generateHelpersFile(toolName, helpersInputs);
+  const helpersFile = generateHelpersFile(toolName, helpersInputs, stashName);
   files.push(helpersFile);
 
   let totalTables = 0;

graphql/codegen/src/core/generate.ts

@@ -747,6 +747,7 @@ export async function generateMulti(
       const firstTargetConfig = configs[names[0]];
       const { files } = generateMultiTargetCli({
         toolName,
+        stashName: cliConfig.stashName,
         builtinNames: cliConfig.builtinNames,
         targets: cliTargets,
         entryPoint: cliConfig.entryPoint,

graphql/codegen/src/types/config.ts

@@ -212,6 +212,15 @@ export interface CliConfig {
    */
   toolName?: string;
 
+  /**
+   * Directory identity for the stored contexts and credentials, when several
+   * tools are one product and should share a single signed-in state (e.g. a
+   * generated CLI, an agent CLI and a desktop app all using `constructive`).
+   * `toolName` still drives env-var prefixes and help text.
+   * @default toolName
+   */
+  stashName?: string;
+
   /**
    * Override infra command names (for collision handling)
    * Defaults: auth -> 'auth' (renamed to 'credentials' on collision),

pgpm/cli/package.json

@@ -58,7 +58,7 @@
     "@pgsql/quotes": "^18.2.1",
     "appstash": "^0.7.0",
     "find-and-require-package-json": "^0.9.1",
-    "genomic": "^5.6.2",
+    "genomic": "^5.6.4",
     "inquirerer": "^4.9.3",
     "js-yaml": "^4.1.0",
     "pg-cache": "workspace:^",

pgpm/core/package.json

@@ -58,7 +58,7 @@
     "@pgpmjs/transform": "workspace:^",
     "@pgpmjs/types": "workspace:^",
     "csv-to-pg": "workspace:^",
-    "genomic": "^5.6.2",
+    "genomic": "^5.6.4",
     "git-changed": "^0.3.0",
     "glob": "^13.0.6",
     "parse-package-name": "^1.0.0",