payload 4.0.0-internal.cd69eef → 4.0.0-internal.ce66a41

package/dist/cli/program/createHelp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHelp.d.ts","sourceRoot":"","sources":["../../../src/cli/program/createHelp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,eAAO,MAAM,aAAa,uBAGvB;IACD,GAAG,EAAE,OAAO,CAAA;IACZ,QAAQ,EAAE,kBAAkB,EAAE,CAAA;CAC/B,KAAG,OA2BF,CAAA"}

package/dist/cli/program/createHelp.js

@@ -0,0 +1,26 @@
+export const createCLIHelp = ({ cli, commands })=>({
+        commands: commands.map(({ name, definition })=>({
+                name,
+                ...definition.aliases?.length ? {
+                    aliases: definition.aliases
+                } : {},
+                description: definition.description,
+                ...definition.examples?.length ? {
+                    examples: definition.examples
+                } : {},
+                inputSchema: definition.schema
+            })),
+        globalOptions: cli.options.filter((option)=>!option.hidden).map((option)=>({
+                description: option.description,
+                flags: option.flags
+            })),
+        output: ({ command: commandName } = {})=>{
+            const selectedCommand = commandName ? cli.commands.find((command)=>command.name() === commandName || command.aliases().includes(commandName)) : cli;
+            if (!selectedCommand) {
+                throw new Error(`Unknown command '${commandName}'.`);
+            }
+            selectedCommand.outputHelp();
+        }
+    });
+
+//# sourceMappingURL=createHelp.js.map

package/dist/cli/program/createHelp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/program/createHelp.ts"],"sourcesContent":["import type { Command } from 'commander'\n\nimport type { CLIHelp } from '../../config/types.js'\nimport type { ResolvedCLICommand } from './loadCommands.js'\n\nexport const createCLIHelp = ({\n  cli,\n  commands,\n}: {\n  cli: Command\n  commands: ResolvedCLICommand[]\n}): CLIHelp => ({\n  commands: commands.map(({ name, definition }) => ({\n    name,\n    ...(definition.aliases?.length ? { aliases: definition.aliases } : {}),\n    description: definition.description,\n    ...(definition.examples?.length ? { examples: definition.examples } : {}),\n    inputSchema: definition.schema,\n  })),\n  globalOptions: cli.options\n    .filter((option) => !option.hidden)\n    .map((option) => ({\n      description: option.description,\n      flags: option.flags,\n    })),\n  output: ({ command: commandName } = {}) => {\n    const selectedCommand = commandName\n      ? cli.commands.find(\n          (command) => command.name() === commandName || command.aliases().includes(commandName),\n        )\n      : cli\n\n    if (!selectedCommand) {\n      throw new Error(`Unknown command '${commandName}'.`)\n    }\n\n    selectedCommand.outputHelp()\n  },\n})\n"],"names":["createCLIHelp","cli","commands","map","name","definition","aliases","length","description","examples","inputSchema","schema","globalOptions","options","filter","option","hidden","flags","output","command","commandName","selectedCommand","find","includes","Error","outputHelp"],"mappings":"AAKA,OAAO,MAAMA,gBAAgB,CAAC,EAC5BC,GAAG,EACHC,QAAQ,EAIT,GAAe,CAAA;QACdA,UAAUA,SAASC,GAAG,CAAC,CAAC,EAAEC,IAAI,EAAEC,UAAU,EAAE,GAAM,CAAA;gBAChDD;gBACA,GAAIC,WAAWC,OAAO,EAAEC,SAAS;oBAAED,SAASD,WAAWC,OAAO;gBAAC,IAAI,CAAC,CAAC;gBACrEE,aAAaH,WAAWG,WAAW;gBACnC,GAAIH,WAAWI,QAAQ,EAAEF,SAAS;oBAAEE,UAAUJ,WAAWI,QAAQ;gBAAC,IAAI,CAAC,CAAC;gBACxEC,aAAaL,WAAWM,MAAM;YAChC,CAAA;QACAC,eAAeX,IAAIY,OAAO,CACvBC,MAAM,CAAC,CAACC,SAAW,CAACA,OAAOC,MAAM,EACjCb,GAAG,CAAC,CAACY,SAAY,CAAA;gBAChBP,aAAaO,OAAOP,WAAW;gBAC/BS,OAAOF,OAAOE,KAAK;YACrB,CAAA;QACFC,QAAQ,CAAC,EAAEC,SAASC,WAAW,EAAE,GAAG,CAAC,CAAC;YACpC,MAAMC,kBAAkBD,cACpBnB,IAAIC,QAAQ,CAACoB,IAAI,CACf,CAACH,UAAYA,QAAQf,IAAI,OAAOgB,eAAeD,QAAQb,OAAO,GAAGiB,QAAQ,CAACH,gBAE5EnB;YAEJ,IAAI,CAACoB,iBAAiB;gBACpB,MAAM,IAAIG,MAAM,CAAC,iBAAiB,EAAEJ,YAAY,EAAE,CAAC;YACrD;YAEAC,gBAAgBI,UAAU;QAC5B;IACF,CAAA,EAAE"}

package/dist/cli/program/loadCommands.d.ts

@@ -0,0 +1,12 @@
+import type { CLICommand, CLIRuntime } from '../../config/types.js';
+export type ResolvedCLICommand = {
+    definition: CLICommand;
+    name: string;
+};
+export declare const loadCLICommands: ({ runtime, }: {
+    runtime: CLIRuntime;
+}) => Promise<ResolvedCLICommand[]>;
+export declare const validateCLICommandNames: ({ commands }: {
+    commands: ResolvedCLICommand[];
+}) => void;
+//# sourceMappingURL=loadCommands.d.ts.map

package/dist/cli/program/loadCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/program/loadCommands.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAmB,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAKpF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,UAAU,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,eAAO,MAAM,eAAe,iBAEzB;IACD,OAAO,EAAE,UAAU,CAAA;CACpB,KAAG,OAAO,CAAC,kBAAkB,EAAE,CAkB/B,CAAA;AAED,eAAO,MAAM,uBAAuB,iBAAkB;IAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAA;CAAE,KAAG,IAgB1F,CAAA"}

package/dist/cli/program/loadCommands.js

@@ -0,0 +1,62 @@
+import path from 'node:path';
+import { dynamicImport } from '../../utilities/dynamicImport.js';
+import { parsePayloadComponent } from '../commands/generateImportMap/utilities/parsePayloadComponent.js';
+export const loadCLICommands = async ({ runtime })=>{
+    const config = await runtime.getConfig();
+    const commandEntries = config.cli === false ? [] : Object.entries(config.cli.commands);
+    const moduleImports = new Map();
+    return Promise.all(commandEntries.filter(([, entry])=>entry !== false).map(async ([name, entry])=>({
+            name,
+            definition: await resolveCLICommand({
+                name,
+                configDir: runtime.configDir,
+                entry,
+                moduleImports
+            })
+        })));
+};
+export const validateCLICommandNames = ({ commands })=>{
+    const registeredNames = new Map();
+    for (const { name, definition } of commands){
+        for (const registeredName of [
+            name,
+            ...definition.aliases ?? []
+        ]){
+            const existingCommand = registeredNames.get(registeredName);
+            if (existingCommand) {
+                throw new Error(`CLI command '${name}' conflicts with '${existingCommand}' through name or alias '${registeredName}'.`);
+            }
+            registeredNames.set(registeredName, name);
+        }
+    }
+};
+const resolveCLICommand = async ({ name, configDir, entry, moduleImports })=>{
+    if (isCLICommand(entry)) {
+        return entry;
+    }
+    const { exportName, path: commandPath } = parsePayloadComponent(entry);
+    const importPath = commandPath.startsWith('.') ? path.resolve(configDir, commandPath) : commandPath;
+    const reference = `${commandPath}${exportName === 'default' ? '' : `#${exportName}`}`;
+    let commandModule;
+    try {
+        let moduleImport = moduleImports.get(importPath);
+        if (!moduleImport) {
+            moduleImport = dynamicImport(importPath);
+            moduleImports.set(importPath, moduleImport);
+        }
+        commandModule = await moduleImport;
+    } catch (error) {
+        throw new Error(`Could not load CLI command '${name}' from '${reference}': ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+    const command = commandModule[exportName];
+    if (command === undefined) {
+        throw new Error(`Could not load CLI command '${name}' from '${reference}': the module does not export '${exportName}'.`);
+    }
+    if (!isCLICommand(command)) {
+        throw new Error(`Could not load CLI command '${name}' from '${reference}': the export was not created with defineCLICommand.`);
+    }
+    return command;
+};
+const isCLICommand = (value)=>typeof value === 'object' && value !== null && 'description' in value && typeof value.description === 'string' && 'handler' in value && typeof value.handler === 'function' && 'input' in value && typeof value.input === 'object' && value.input !== null && 'schema' in value && typeof value.schema === 'object' && value.schema !== null;
+
+//# sourceMappingURL=loadCommands.js.map

package/dist/cli/program/loadCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/program/loadCommands.ts"],"sourcesContent":["import path from 'node:path'\n\nimport type { CLICommand, CLICommandEntry, CLIRuntime } from '../../config/types.js'\n\nimport { dynamicImport } from '../../utilities/dynamicImport.js'\nimport { parsePayloadComponent } from '../commands/generateImportMap/utilities/parsePayloadComponent.js'\n\nexport type ResolvedCLICommand = {\n  definition: CLICommand\n  name: string\n}\n\nexport const loadCLICommands = async ({\n  runtime,\n}: {\n  runtime: CLIRuntime\n}): Promise<ResolvedCLICommand[]> => {\n  const config = await runtime.getConfig()\n  const commandEntries = config.cli === false ? [] : Object.entries(config.cli.commands)\n  const moduleImports = new Map<string, Promise<Record<string, unknown>>>()\n\n  return Promise.all(\n    commandEntries\n      .filter(([, entry]) => entry !== false)\n      .map(async ([name, entry]) => ({\n        name,\n        definition: await resolveCLICommand({\n          name,\n          configDir: runtime.configDir,\n          entry,\n          moduleImports,\n        }),\n      })),\n  )\n}\n\nexport const validateCLICommandNames = ({ commands }: { commands: ResolvedCLICommand[] }): void => {\n  const registeredNames = new Map<string, string>()\n\n  for (const { name, definition } of commands) {\n    for (const registeredName of [name, ...(definition.aliases ?? [])]) {\n      const existingCommand = registeredNames.get(registeredName)\n\n      if (existingCommand) {\n        throw new Error(\n          `CLI command '${name}' conflicts with '${existingCommand}' through name or alias '${registeredName}'.`,\n        )\n      }\n\n      registeredNames.set(registeredName, name)\n    }\n  }\n}\n\nconst resolveCLICommand = async ({\n  name,\n  configDir,\n  entry,\n  moduleImports,\n}: {\n  configDir: string\n  entry: CLICommandEntry\n  moduleImports: Map<string, Promise<Record<string, unknown>>>\n  name: string\n}): Promise<CLICommand> => {\n  if (isCLICommand(entry)) {\n    return entry\n  }\n\n  const { exportName, path: commandPath } = parsePayloadComponent(entry)\n  const importPath = commandPath.startsWith('.')\n    ? path.resolve(configDir, commandPath)\n    : commandPath\n  const reference = `${commandPath}${exportName === 'default' ? '' : `#${exportName}`}`\n  let commandModule: Record<string, unknown>\n\n  try {\n    let moduleImport = moduleImports.get(importPath)\n\n    if (!moduleImport) {\n      moduleImport = dynamicImport<Record<string, unknown>>(importPath)\n      moduleImports.set(importPath, moduleImport)\n    }\n\n    commandModule = await moduleImport\n  } catch (error) {\n    throw new Error(\n      `Could not load CLI command '${name}' from '${reference}': ${error instanceof Error ? error.message : 'Unknown error'}`,\n    )\n  }\n\n  const command = commandModule[exportName]\n\n  if (command === undefined) {\n    throw new Error(\n      `Could not load CLI command '${name}' from '${reference}': the module does not export '${exportName}'.`,\n    )\n  }\n\n  if (!isCLICommand(command)) {\n    throw new Error(\n      `Could not load CLI command '${name}' from '${reference}': the export was not created with defineCLICommand.`,\n    )\n  }\n\n  return command\n}\n\nconst isCLICommand = (value: unknown): value is CLICommand =>\n  typeof value === 'object' &&\n  value !== null &&\n  'description' in value &&\n  typeof value.description === 'string' &&\n  'handler' in value &&\n  typeof value.handler === 'function' &&\n  'input' in value &&\n  typeof value.input === 'object' &&\n  value.input !== null &&\n  'schema' in value &&\n  typeof value.schema === 'object' &&\n  value.schema !== null\n"],"names":["path","dynamicImport","parsePayloadComponent","loadCLICommands","runtime","config","getConfig","commandEntries","cli","Object","entries","commands","moduleImports","Map","Promise","all","filter","entry","map","name","definition","resolveCLICommand","configDir","validateCLICommandNames","registeredNames","registeredName","aliases","existingCommand","get","Error","set","isCLICommand","exportName","commandPath","importPath","startsWith","resolve","reference","commandModule","moduleImport","error","message","command","undefined","value","description","handler","input","schema"],"mappings":"AAAA,OAAOA,UAAU,YAAW;AAI5B,SAASC,aAAa,QAAQ,mCAAkC;AAChE,SAASC,qBAAqB,QAAQ,mEAAkE;AAOxG,OAAO,MAAMC,kBAAkB,OAAO,EACpCC,OAAO,EAGR;IACC,MAAMC,SAAS,MAAMD,QAAQE,SAAS;IACtC,MAAMC,iBAAiBF,OAAOG,GAAG,KAAK,QAAQ,EAAE,GAAGC,OAAOC,OAAO,CAACL,OAAOG,GAAG,CAACG,QAAQ;IACrF,MAAMC,gBAAgB,IAAIC;IAE1B,OAAOC,QAAQC,GAAG,CAChBR,eACGS,MAAM,CAAC,CAAC,GAAGC,MAAM,GAAKA,UAAU,OAChCC,GAAG,CAAC,OAAO,CAACC,MAAMF,MAAM,GAAM,CAAA;YAC7BE;YACAC,YAAY,MAAMC,kBAAkB;gBAClCF;gBACAG,WAAWlB,QAAQkB,SAAS;gBAC5BL;gBACAL;YACF;QACF,CAAA;AAEN,EAAC;AAED,OAAO,MAAMW,0BAA0B,CAAC,EAAEZ,QAAQ,EAAsC;IACtF,MAAMa,kBAAkB,IAAIX;IAE5B,KAAK,MAAM,EAAEM,IAAI,EAAEC,UAAU,EAAE,IAAIT,SAAU;QAC3C,KAAK,MAAMc,kBAAkB;YAACN;eAAUC,WAAWM,OAAO,IAAI,EAAE;SAAE,CAAE;YAClE,MAAMC,kBAAkBH,gBAAgBI,GAAG,CAACH;YAE5C,IAAIE,iBAAiB;gBACnB,MAAM,IAAIE,MACR,CAAC,aAAa,EAAEV,KAAK,kBAAkB,EAAEQ,gBAAgB,yBAAyB,EAAEF,eAAe,EAAE,CAAC;YAE1G;YAEAD,gBAAgBM,GAAG,CAACL,gBAAgBN;QACtC;IACF;AACF,EAAC;AAED,MAAME,oBAAoB,OAAO,EAC/BF,IAAI,EACJG,SAAS,EACTL,KAAK,EACLL,aAAa,EAMd;IACC,IAAImB,aAAad,QAAQ;QACvB,OAAOA;IACT;IAEA,MAAM,EAAEe,UAAU,EAAEhC,MAAMiC,WAAW,EAAE,GAAG/B,sBAAsBe;IAChE,MAAMiB,aAAaD,YAAYE,UAAU,CAAC,OACtCnC,KAAKoC,OAAO,CAACd,WAAWW,eACxBA;IACJ,MAAMI,YAAY,GAAGJ,cAAcD,eAAe,YAAY,KAAK,CAAC,CAAC,EAAEA,YAAY,EAAE;IACrF,IAAIM;IAEJ,IAAI;QACF,IAAIC,eAAe3B,cAAcgB,GAAG,CAACM;QAErC,IAAI,CAACK,cAAc;YACjBA,eAAetC,cAAuCiC;YACtDtB,cAAckB,GAAG,CAACI,YAAYK;QAChC;QAEAD,gBAAgB,MAAMC;IACxB,EAAE,OAAOC,OAAO;QACd,MAAM,IAAIX,MACR,CAAC,4BAA4B,EAAEV,KAAK,QAAQ,EAAEkB,UAAU,GAAG,EAAEG,iBAAiBX,QAAQW,MAAMC,OAAO,GAAG,iBAAiB;IAE3H;IAEA,MAAMC,UAAUJ,aAAa,CAACN,WAAW;IAEzC,IAAIU,YAAYC,WAAW;QACzB,MAAM,IAAId,MACR,CAAC,4BAA4B,EAAEV,KAAK,QAAQ,EAAEkB,UAAU,+BAA+B,EAAEL,WAAW,EAAE,CAAC;IAE3G;IAEA,IAAI,CAACD,aAAaW,UAAU;QAC1B,MAAM,IAAIb,MACR,CAAC,4BAA4B,EAAEV,KAAK,QAAQ,EAAEkB,UAAU,oDAAoD,CAAC;IAEjH;IAEA,OAAOK;AACT;AAEA,MAAMX,eAAe,CAACa,QACpB,OAAOA,UAAU,YACjBA,UAAU,QACV,iBAAiBA,SACjB,OAAOA,MAAMC,WAAW,KAAK,YAC7B,aAAaD,SACb,OAAOA,MAAME,OAAO,KAAK,cACzB,WAAWF,SACX,OAAOA,MAAMG,KAAK,KAAK,YACvBH,MAAMG,KAAK,KAAK,QAChB,YAAYH,SACZ,OAAOA,MAAMI,MAAM,KAAK,YACxBJ,MAAMI,MAAM,KAAK"}

package/dist/cli/program/normalizeHelpArguments.d.ts

@@ -0,0 +1,12 @@
+import type { Command } from 'commander';
+/**
+ * Sends both help syntaxes through Payload's `help` command.
+ *
+ * For example, `payload info --help --json` becomes
+ * `payload help info --json`, so both forms use the same handler and output.
+ */
+export declare const normalizeHelpArguments: ({ args, cli, }: {
+    args: string[];
+    cli: Command;
+}) => string[];
+//# sourceMappingURL=normalizeHelpArguments.d.ts.map

package/dist/cli/program/normalizeHelpArguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeHelpArguments.d.ts","sourceRoot":"","sources":["../../../src/cli/program/normalizeHelpArguments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,mBAGhC;IACD,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,GAAG,EAAE,OAAO,CAAA;CACb,KAAG,MAAM,EAoCT,CAAA"}

package/dist/cli/program/normalizeHelpArguments.js

@@ -0,0 +1,34 @@
+/**
+ * Sends both help syntaxes through Payload's `help` command.
+ *
+ * For example, `payload info --help --json` becomes
+ * `payload help info --json`, so both forms use the same handler and output.
+ */ export const normalizeHelpArguments = ({ args, cli })=>{
+    // Arguments after `--` belong to the program called by the Payload command.
+    // For example, `payload build -- --help` must show the framework's help,
+    // while `payload build --help` must show Payload's build-command help.
+    const separatorPosition = args.indexOf('--', 2);
+    const payloadArguments = args.slice(2, separatorPosition === -1 ? args.length : separatorPosition);
+    if (!payloadArguments.includes('--help') && !payloadArguments.includes('-h')) {
+        return args;
+    }
+    const selectedCommand = payloadArguments.map((argument)=>cli.commands.find((command)=>command.name() === argument || command.aliases().includes(argument))).find((command)=>command !== undefined);
+    if (selectedCommand?.name() === 'help') {
+        return args;
+    }
+    const [executable, script] = args;
+    if (!executable || !script) {
+        return args;
+    }
+    return [
+        executable,
+        script,
+        'help',
+        ...selectedCommand ? [
+            selectedCommand.name()
+        ] : [],
+        ...payloadArguments.filter((argument)=>argument === '--json' || argument === '--no-json')
+    ];
+};
+
+//# sourceMappingURL=normalizeHelpArguments.js.map

package/dist/cli/program/normalizeHelpArguments.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/program/normalizeHelpArguments.ts"],"sourcesContent":["import type { Command } from 'commander'\n\n/**\n * Sends both help syntaxes through Payload's `help` command.\n *\n * For example, `payload info --help --json` becomes\n * `payload help info --json`, so both forms use the same handler and output.\n */\nexport const normalizeHelpArguments = ({\n  args,\n  cli,\n}: {\n  args: string[]\n  cli: Command\n}): string[] => {\n  // Arguments after `--` belong to the program called by the Payload command.\n  // For example, `payload build -- --help` must show the framework's help,\n  // while `payload build --help` must show Payload's build-command help.\n  const separatorPosition = args.indexOf('--', 2)\n  const payloadArguments = args.slice(2, separatorPosition === -1 ? args.length : separatorPosition)\n\n  if (!payloadArguments.includes('--help') && !payloadArguments.includes('-h')) {\n    return args\n  }\n\n  const selectedCommand = payloadArguments\n    .map((argument) =>\n      cli.commands.find(\n        (command) => command.name() === argument || command.aliases().includes(argument),\n      ),\n    )\n    .find((command) => command !== undefined)\n\n  if (selectedCommand?.name() === 'help') {\n    return args\n  }\n\n  const [executable, script] = args\n\n  if (!executable || !script) {\n    return args\n  }\n\n  return [\n    executable,\n    script,\n    'help',\n    ...(selectedCommand ? [selectedCommand.name()] : []),\n    ...payloadArguments.filter((argument) => argument === '--json' || argument === '--no-json'),\n  ]\n}\n"],"names":["normalizeHelpArguments","args","cli","separatorPosition","indexOf","payloadArguments","slice","length","includes","selectedCommand","map","argument","commands","find","command","name","aliases","undefined","executable","script","filter"],"mappings":"AAEA;;;;;CAKC,GACD,OAAO,MAAMA,yBAAyB,CAAC,EACrCC,IAAI,EACJC,GAAG,EAIJ;IACC,4EAA4E;IAC5E,yEAAyE;IACzE,uEAAuE;IACvE,MAAMC,oBAAoBF,KAAKG,OAAO,CAAC,MAAM;IAC7C,MAAMC,mBAAmBJ,KAAKK,KAAK,CAAC,GAAGH,sBAAsB,CAAC,IAAIF,KAAKM,MAAM,GAAGJ;IAEhF,IAAI,CAACE,iBAAiBG,QAAQ,CAAC,aAAa,CAACH,iBAAiBG,QAAQ,CAAC,OAAO;QAC5E,OAAOP;IACT;IAEA,MAAMQ,kBAAkBJ,iBACrBK,GAAG,CAAC,CAACC,WACJT,IAAIU,QAAQ,CAACC,IAAI,CACf,CAACC,UAAYA,QAAQC,IAAI,OAAOJ,YAAYG,QAAQE,OAAO,GAAGR,QAAQ,CAACG,YAG1EE,IAAI,CAAC,CAACC,UAAYA,YAAYG;IAEjC,IAAIR,iBAAiBM,WAAW,QAAQ;QACtC,OAAOd;IACT;IAEA,MAAM,CAACiB,YAAYC,OAAO,GAAGlB;IAE7B,IAAI,CAACiB,cAAc,CAACC,QAAQ;QAC1B,OAAOlB;IACT;IAEA,OAAO;QACLiB;QACAC;QACA;WACIV,kBAAkB;YAACA,gBAAgBM,IAAI;SAAG,GAAG,EAAE;WAChDV,iBAAiBe,MAAM,CAAC,CAACT,WAAaA,aAAa,YAAYA,aAAa;KAChF;AACH,EAAC"}

package/dist/cli/program/registerCommand.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+import type { CLICommand, CLIHelp, CLIRuntime } from '../../config/types.js';
+export declare const registerCLICommand: ({ name, cli, definition, help, runtime, }: {
+    cli: Command;
+    definition: CLICommand;
+    help: CLIHelp;
+    name: string;
+    runtime: CLIRuntime;
+}) => void;
+//# sourceMappingURL=registerCommand.d.ts.map

package/dist/cli/program/registerCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/program/registerCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,OAAO,EAAU,MAAM,WAAW,CAAA;AAErD,OAAO,KAAK,EAAE,UAAU,EAAoB,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAK9F,eAAO,MAAM,kBAAkB,8CAM5B;IACD,GAAG,EAAE,OAAO,CAAA;IACZ,UAAU,EAAE,UAAU,CAAA;IACtB,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,UAAU,CAAA;CACpB,KAAG,IA0BH,CAAA"}

package/dist/cli/program/registerCommand.js

@@ -0,0 +1,185 @@
+import { Argument, Command, Option } from 'commander';
+import { toKebabCase } from '../../utilities/toKebabCase.js';
+import { invokeCLICommand } from '../runtime/invokeCommand.js';
+export const registerCLICommand = ({ name, cli, definition, help, runtime })=>{
+    const command = new Command(name).description(definition.description).aliases(definition.aliases ?? []).allowUnknownOption(definition.allowUnknownOption);
+    if (definition.helpGroup) {
+        command.helpGroup(definition.helpGroup);
+    }
+    addCommandInput({
+        command,
+        definition
+    });
+    if (definition.examples?.length) {
+        command.addHelpText('after', `\nExamples:\n${definition.examples.map((example)=>`  ${example}`).join('\n')}`);
+    }
+    command.action(()=>invokeCLICommand({
+            command,
+            definition,
+            help,
+            runtime
+        }));
+    // Let our runtime format the error and clean up Payload instead of exiting immediately.
+    command.exitOverride();
+    // Register the completed command with the root CLI.
+    cli.addCommand(command);
+};
+/**
+ * Turns a command definition's schema and CLI overrides into Commander inputs.
+ *
+ * For example:
+ *
+ * ```ts
+ * defineCLICommand({
+ *   description: 'Import a file.',
+ *   input: z.object({
+ *     file: z.string(),
+ *     force: z.optional(z.boolean()),
+ *   }),
+ *   cli: { file: 'argument' },
+ *   handler: ({ args }) => importFile(args),
+ * })
+ * ```
+ *
+ * registers `[file]`, `--force`, and the shared `--input <json|@file|->` option.
+ * This helper also:
+ *
+ * - infers parsers, descriptions, choices, required fields, and defaults from the schema
+ * - applies overrides such as positional arguments and custom flags
+ * - keeps positional arguments optional in Commander because `--input` may supply
+ *   them; the schema still checks whether they are required
+ */ const addCommandInput = ({ command, definition })=>{
+    const properties = definition.schema.properties ?? {};
+    const requiredFields = new Set(Array.isArray(definition.schema.required) ? definition.schema.required : []);
+    const overrides = definition.cli === false ? {} : definition.cli;
+    if (definition.cli !== false) {
+        const argumentOverrides = Object.entries(overrides).filter(([, override])=>isArgumentOverride(override)).sort(([, first], [, second])=>{
+            const firstPosition = getArgumentPosition(first);
+            const secondPosition = getArgumentPosition(second);
+            return (firstPosition ?? Number.MAX_SAFE_INTEGER) - (secondPosition ?? Number.MAX_SAFE_INTEGER);
+        });
+        for (const [field, override] of argumentOverrides){
+            const argumentOverride = typeof override === 'object' && override.type === 'argument' ? override : undefined;
+            const property = properties[field];
+            const isArray = property.type === 'array';
+            const argument = new Argument(argumentOverride?.syntax ?? `[${field}${isArray ? '...' : ''}]`, getInputDescription({
+                isRequired: requiredFields.has(field),
+                property
+            }));
+            const parser = argumentOverride?.parse ?? getInferredParser({
+                property
+            });
+            if (parser) {
+                argument.argParser(parser);
+            }
+            addChoices({
+                argument,
+                property
+            });
+            command.addArgument(argument);
+        }
+        const options = Object.entries(properties).sort(([firstField], [secondField])=>Number(requiredFields.has(secondField)) - Number(requiredFields.has(firstField)));
+        for (const [field, property] of options){
+            const override = overrides[field];
+            if (override === false || isArgumentOverride(override)) {
+                continue;
+            }
+            const optionOverride = typeof override === 'object' ? override : undefined;
+            const flags = optionOverride?.flags ?? getInferredOptionFlags({
+                field,
+                property
+            });
+            const option = new CLIInputOption(flags, getInputDescription({
+                isRequired: requiredFields.has(field),
+                property
+            }), field);
+            const parser = optionOverride?.parse ?? getInferredParser({
+                property
+            });
+            if (parser) {
+                option.argParser(parser);
+            }
+            addChoices({
+                argument: option,
+                property
+            });
+            command.addOption(option);
+        }
+    }
+    const reservedOption = command.options.find((option)=>[
+            'input',
+            'json'
+        ].includes(option.attributeName()));
+    if (reservedOption) {
+        throw new Error(`CLI command '${command.name()}' cannot register the reserved '--${reservedOption.attributeName()}' option.`);
+    }
+    for (const argument of command.registeredArguments){
+        argument.argOptional();
+    }
+    command.addOption(new Option('--input <json|@file|->', 'Pass base command input as JSON, from a file, or from stdin; explicit arguments and options override it.'));
+};
+const getInputDescription = ({ isRequired, property })=>{
+    const description = typeof property.description === 'string' ? property.description : '';
+    const annotations = [
+        isRequired ? '(required)' : '',
+        'default' in property ? `(default: ${JSON.stringify(property.default)})` : ''
+    ].filter(Boolean);
+    return [
+        description,
+        ...annotations
+    ].filter(Boolean).join(' ');
+};
+/** Keeps a custom flag such as `--file` mapped to its schema field, such as `filePath`. */ class CLIInputOption extends Option {
+    inputField;
+    constructor(flags, description, inputField){
+        super(flags, description), this.inputField = inputField;
+    }
+    attributeName() {
+        return this.inputField;
+    }
+}
+/**
+ * Checks whether a CLI override makes a schema field positional.
+ *
+ * For example, both `'argument'` and `{ type: 'argument', position: 1 }` return
+ * `true`, while an option override or `undefined` returns `false`.
+ */ const isArgumentOverride = (override)=>override === 'argument' || typeof override === 'object' && override !== null && override.type === 'argument';
+const getArgumentPosition = (override)=>typeof override === 'object' && override !== null && override.type === 'argument' ? override.position : undefined;
+const addChoices = ({ argument, property })=>{
+    const choices = property.enum;
+    if (Array.isArray(choices) && choices.every((choice)=>typeof choice === 'string')) {
+        argument.choices(choices);
+    }
+};
+const getInferredOptionFlags = ({ field, property })=>{
+    const flag = toKebabCase(field) ?? field;
+    if (property.type === 'boolean') {
+        return property.default === true ? `--no-${flag}` : `--${flag}`;
+    }
+    if (property.type === 'array') {
+        const items = property.items;
+        if (items?.type === 'integer' || items?.type === 'number' || items?.type === 'string') {
+            return `--${flag} <${field}...>`;
+        }
+    }
+    if (property.type === 'integer' || property.type === 'number') {
+        return `--${flag} <number>`;
+    }
+    if (property.type === 'string') {
+        return `--${flag} <${field}>`;
+    }
+    throw new Error(`Cannot infer a CLI option for input '${field}'. Configure its flags and parser, or set it to false.`);
+};
+const getInferredParser = ({ property })=>{
+    if (property.type === 'integer' || property.type === 'number') {
+        return Number;
+    }
+    if (property.type === 'array') {
+        const items = property.items;
+        if (items?.type === 'integer' || items?.type === 'number') {
+            return Number;
+        }
+    }
+};
+
+//# sourceMappingURL=registerCommand.js.map

package/dist/cli/program/registerCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/program/registerCommand.ts"],"sourcesContent":["import { Argument, Command, Option } from 'commander'\n\nimport type { CLICommand, CLIFieldOverride, CLIHelp, CLIRuntime } from '../../config/types.js'\n\nimport { toKebabCase } from '../../utilities/toKebabCase.js'\nimport { invokeCLICommand } from '../runtime/invokeCommand.js'\n\nexport const registerCLICommand = ({\n  name,\n  cli,\n  definition,\n  help,\n  runtime,\n}: {\n  cli: Command\n  definition: CLICommand\n  help: CLIHelp\n  name: string\n  runtime: CLIRuntime\n}): void => {\n  const command = new Command(name)\n    .description(definition.description)\n    .aliases(definition.aliases ?? [])\n    .allowUnknownOption(definition.allowUnknownOption)\n\n  if (definition.helpGroup) {\n    command.helpGroup(definition.helpGroup)\n  }\n\n  addCommandInput({ command, definition })\n\n  if (definition.examples?.length) {\n    command.addHelpText(\n      'after',\n      `\\nExamples:\\n${definition.examples.map((example) => `  ${example}`).join('\\n')}`,\n    )\n  }\n\n  command.action(() => invokeCLICommand({ command, definition, help, runtime }))\n\n  // Let our runtime format the error and clean up Payload instead of exiting immediately.\n  command.exitOverride()\n\n  // Register the completed command with the root CLI.\n  cli.addCommand(command)\n}\n\n/**\n * Turns a command definition's schema and CLI overrides into Commander inputs.\n *\n * For example:\n *\n * ```ts\n * defineCLICommand({\n *   description: 'Import a file.',\n *   input: z.object({\n *     file: z.string(),\n *     force: z.optional(z.boolean()),\n *   }),\n *   cli: { file: 'argument' },\n *   handler: ({ args }) => importFile(args),\n * })\n * ```\n *\n * registers `[file]`, `--force`, and the shared `--input <json|@file|->` option.\n * This helper also:\n *\n * - infers parsers, descriptions, choices, required fields, and defaults from the schema\n * - applies overrides such as positional arguments and custom flags\n * - keeps positional arguments optional in Commander because `--input` may supply\n *   them; the schema still checks whether they are required\n */\nconst addCommandInput = ({\n  command,\n  definition,\n}: {\n  command: Command\n  definition: CLICommand\n}): void => {\n  const properties = (definition.schema.properties ?? {}) as Record<string, Record<string, unknown>>\n  const requiredFields = new Set(\n    Array.isArray(definition.schema.required) ? definition.schema.required : [],\n  )\n  const overrides = definition.cli === false ? {} : definition.cli\n\n  if (definition.cli !== false) {\n    const argumentOverrides = Object.entries(overrides)\n      .filter(([, override]) => isArgumentOverride(override))\n      .sort(([, first], [, second]) => {\n        const firstPosition = getArgumentPosition(first)\n        const secondPosition = getArgumentPosition(second)\n\n        return (\n          (firstPosition ?? Number.MAX_SAFE_INTEGER) - (secondPosition ?? Number.MAX_SAFE_INTEGER)\n        )\n      })\n\n    for (const [field, override] of argumentOverrides) {\n      const argumentOverride =\n        typeof override === 'object' && override.type === 'argument' ? override : undefined\n      const property = properties[field]!\n      const isArray = property.type === 'array'\n      const argument = new Argument(\n        argumentOverride?.syntax ?? `[${field}${isArray ? '...' : ''}]`,\n        getInputDescription({ isRequired: requiredFields.has(field), property }),\n      )\n      const parser = argumentOverride?.parse ?? getInferredParser({ property })\n\n      if (parser) {\n        argument.argParser(parser)\n      }\n\n      addChoices({ argument, property })\n      command.addArgument(argument)\n    }\n\n    const options = Object.entries(properties).sort(\n      ([firstField], [secondField]) =>\n        Number(requiredFields.has(secondField)) - Number(requiredFields.has(firstField)),\n    )\n\n    for (const [field, property] of options) {\n      const override = overrides[field]\n\n      if (override === false || isArgumentOverride(override)) {\n        continue\n      }\n\n      const optionOverride = typeof override === 'object' ? override : undefined\n      const flags = optionOverride?.flags ?? getInferredOptionFlags({ field, property })\n      const option = new CLIInputOption(\n        flags,\n        getInputDescription({ isRequired: requiredFields.has(field), property }),\n        field,\n      )\n      const parser = optionOverride?.parse ?? getInferredParser({ property })\n\n      if (parser) {\n        option.argParser(parser)\n      }\n\n      addChoices({ argument: option, property })\n      command.addOption(option)\n    }\n  }\n\n  const reservedOption = command.options.find((option) =>\n    ['input', 'json'].includes(option.attributeName()),\n  )\n\n  if (reservedOption) {\n    throw new Error(\n      `CLI command '${command.name()}' cannot register the reserved '--${reservedOption.attributeName()}' option.`,\n    )\n  }\n\n  for (const argument of command.registeredArguments) {\n    argument.argOptional()\n  }\n\n  command.addOption(\n    new Option(\n      '--input <json|@file|->',\n      'Pass base command input as JSON, from a file, or from stdin; explicit arguments and options override it.',\n    ),\n  )\n}\n\nconst getInputDescription = ({\n  isRequired,\n  property,\n}: {\n  isRequired: boolean\n  property: Record<string, unknown>\n}): string => {\n  const description = typeof property.description === 'string' ? property.description : ''\n  const annotations = [\n    isRequired ? '(required)' : '',\n    'default' in property ? `(default: ${JSON.stringify(property.default)})` : '',\n  ].filter(Boolean)\n\n  return [description, ...annotations].filter(Boolean).join(' ')\n}\n\n/** Keeps a custom flag such as `--file` mapped to its schema field, such as `filePath`. */\nclass CLIInputOption extends Option {\n  constructor(\n    flags: string,\n    description: string,\n    private readonly inputField: string,\n  ) {\n    super(flags, description)\n  }\n\n  override attributeName(): string {\n    return this.inputField\n  }\n}\n\n/**\n * Checks whether a CLI override makes a schema field positional.\n *\n * For example, both `'argument'` and `{ type: 'argument', position: 1 }` return\n * `true`, while an option override or `undefined` returns `false`.\n */\nconst isArgumentOverride = (\n  override: CLIFieldOverride | undefined,\n): override is\n  | 'argument'\n  | {\n      parse?: (value: string, previous: unknown) => unknown\n      position?: number\n      syntax?: string\n      type: 'argument'\n    } =>\n  override === 'argument' ||\n  (typeof override === 'object' && override !== null && override.type === 'argument')\n\nconst getArgumentPosition = (override: CLIFieldOverride | undefined): number | undefined =>\n  typeof override === 'object' && override !== null && override.type === 'argument'\n    ? override.position\n    : undefined\n\nconst addChoices = ({\n  argument,\n  property,\n}: {\n  argument: Argument | Option\n  property: Record<string, unknown>\n}): void => {\n  const choices = property.enum\n\n  if (\n    Array.isArray(choices) &&\n    choices.every((choice): choice is string => typeof choice === 'string')\n  ) {\n    argument.choices(choices)\n  }\n}\n\nconst getInferredOptionFlags = ({\n  field,\n  property,\n}: {\n  field: string\n  property: Record<string, unknown>\n}): string => {\n  const flag = toKebabCase(field) ?? field\n\n  if (property.type === 'boolean') {\n    return property.default === true ? `--no-${flag}` : `--${flag}`\n  }\n\n  if (property.type === 'array') {\n    const items = property.items as Record<string, unknown> | undefined\n\n    if (items?.type === 'integer' || items?.type === 'number' || items?.type === 'string') {\n      return `--${flag} <${field}...>`\n    }\n  }\n\n  if (property.type === 'integer' || property.type === 'number') {\n    return `--${flag} <number>`\n  }\n\n  if (property.type === 'string') {\n    return `--${flag} <${field}>`\n  }\n\n  throw new Error(\n    `Cannot infer a CLI option for input '${field}'. Configure its flags and parser, or set it to false.`,\n  )\n}\n\nconst getInferredParser = ({\n  property,\n}: {\n  property: Record<string, unknown>\n}): ((value: string) => unknown) | undefined => {\n  if (property.type === 'integer' || property.type === 'number') {\n    return Number\n  }\n\n  if (property.type === 'array') {\n    const items = property.items as Record<string, unknown> | undefined\n\n    if (items?.type === 'integer' || items?.type === 'number') {\n      return Number\n    }\n  }\n}\n"],"names":["Argument","Command","Option","toKebabCase","invokeCLICommand","registerCLICommand","name","cli","definition","help","runtime","command","description","aliases","allowUnknownOption","helpGroup","addCommandInput","examples","length","addHelpText","map","example","join","action","exitOverride","addCommand","properties","schema","requiredFields","Set","Array","isArray","required","overrides","argumentOverrides","Object","entries","filter","override","isArgumentOverride","sort","first","second","firstPosition","getArgumentPosition","secondPosition","Number","MAX_SAFE_INTEGER","field","argumentOverride","type","undefined","property","argument","syntax","getInputDescription","isRequired","has","parser","parse","getInferredParser","argParser","addChoices","addArgument","options","firstField","secondField","optionOverride","flags","getInferredOptionFlags","option","CLIInputOption","addOption","reservedOption","find","includes","attributeName","Error","registeredArguments","argOptional","annotations","JSON","stringify","default","Boolean","inputField","position","choices","enum","every","choice","flag","items"],"mappings":"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"}

package/dist/cli/runtime/createRuntime.d.ts

@@ -0,0 +1,9 @@
+import type { CLIRuntime } from '../../config/types.js';
+/**
+ * Creates the shared resources used by the CLI.
+ *
+ * The config is loaded once, and any Payload instance opened by a command is tracked
+ * so the CLI can close it before exiting.
+ */
+export declare const createCLIRuntime: () => CLIRuntime;
+//# sourceMappingURL=createRuntime.d.ts.map

package/dist/cli/runtime/createRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRuntime.d.ts","sourceRoot":"","sources":["../../../src/cli/runtime/createRuntime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,uBAAuB,CAAA;AAMxE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,QAAO,UA6DnC,CAAA"}

package/dist/cli/runtime/createRuntime.js

@@ -0,0 +1,81 @@
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { findConfig } from '../../config/find.js';
+import { getPayload } from '../../index.js';
+/**
+ * Creates the shared resources used by the CLI.
+ *
+ * The config is loaded once, and any Payload instance opened by a command is tracked
+ * so the CLI can close it before exiting.
+ */ export const createCLIRuntime = ()=>{
+    let activePayload;
+    let configPromise;
+    let isScheduled = false;
+    const configPath = findConfig();
+    const getConfig = ()=>{
+        configPromise ??= (async ()=>{
+            const importedConfig = await import(/* @vite-ignore */ pathToFileURL(configPath).toString());
+            const config = importedConfig.default ? await importedConfig.default : importedConfig;
+            return config;
+        })();
+        return configPromise;
+    };
+    const runtime = {
+        configDir: path.dirname(configPath),
+        async destroy () {
+            if (!activePayload) {
+                return;
+            }
+            const payload = activePayload;
+            activePayload = undefined;
+            await payload.destroy();
+        },
+        getConfig,
+        async getPayload (options = {}) {
+            const config = await getConfig();
+            const configuredLogger = config.logger;
+            const shouldRedirectLogger = process.env.PAYLOAD_CLI_JSON !== undefined;
+            if (shouldRedirectLogger) {
+                config.logger = getJSONLogger(configuredLogger);
+            }
+            try {
+                activePayload = await getPayload({
+                    config,
+                    ...options
+                });
+            } finally{
+                if (shouldRedirectLogger) {
+                    config.logger = configuredLogger;
+                }
+            }
+            return activePayload;
+        },
+        get isScheduled () {
+            return isScheduled;
+        },
+        markScheduled () {
+            isScheduled = true;
+        }
+    };
+    return runtime;
+};
+/** Redirects configurable stdout loggers while preserving opaque logger instances. */ const getJSONLogger = (configuredLogger)=>{
+    if (!configuredLogger || configuredLogger === 'sync') {
+        return {
+            destination: process.stderr,
+            options: {}
+        };
+    }
+    if (!('options' in configuredLogger)) {
+        return configuredLogger;
+    }
+    if (configuredLogger.options.transport || configuredLogger.destination && configuredLogger.destination !== process.stdout) {
+        return configuredLogger;
+    }
+    return {
+        ...configuredLogger,
+        destination: process.stderr
+    };
+};
+
+//# sourceMappingURL=createRuntime.js.map

package/dist/cli/runtime/createRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/runtime/createRuntime.ts"],"sourcesContent":["import path from 'node:path'\nimport { pathToFileURL } from 'node:url'\n\nimport type { CLIRuntime, SanitizedConfig } from '../../config/types.js'\nimport type { Payload } from '../../index.js'\n\nimport { findConfig } from '../../config/find.js'\nimport { getPayload } from '../../index.js'\n\n/**\n * Creates the shared resources used by the CLI.\n *\n * The config is loaded once, and any Payload instance opened by a command is tracked\n * so the CLI can close it before exiting.\n */\nexport const createCLIRuntime = (): CLIRuntime => {\n  let activePayload: Payload | undefined\n  let configPromise: Promise<SanitizedConfig> | undefined\n  let isScheduled = false\n  const configPath = findConfig()\n\n  const getConfig = (): Promise<SanitizedConfig> => {\n    configPromise ??= (async () => {\n      const importedConfig = await import(/* @vite-ignore */ pathToFileURL(configPath).toString())\n      const config = importedConfig.default ? await importedConfig.default : importedConfig\n\n      return config as SanitizedConfig\n    })()\n\n    return configPromise\n  }\n\n  const runtime: CLIRuntime = {\n    configDir: path.dirname(configPath),\n    async destroy() {\n      if (!activePayload) {\n        return\n      }\n\n      const payload = activePayload\n\n      activePayload = undefined\n      await payload.destroy()\n    },\n    getConfig,\n    async getPayload(options = {}) {\n      const config = await getConfig()\n      const configuredLogger = config.logger\n      const shouldRedirectLogger = process.env.PAYLOAD_CLI_JSON !== undefined\n\n      if (shouldRedirectLogger) {\n        config.logger = getJSONLogger(configuredLogger)\n      }\n\n      try {\n        activePayload = await getPayload({\n          config,\n          ...options,\n        })\n      } finally {\n        if (shouldRedirectLogger) {\n          config.logger = configuredLogger\n        }\n      }\n\n      return activePayload\n    },\n    get isScheduled() {\n      return isScheduled\n    },\n    markScheduled() {\n      isScheduled = true\n    },\n  }\n\n  return runtime\n}\n\n/** Redirects configurable stdout loggers while preserving opaque logger instances. */\nconst getJSONLogger = (configuredLogger: SanitizedConfig['logger']): SanitizedConfig['logger'] => {\n  if (!configuredLogger || configuredLogger === 'sync') {\n    return { destination: process.stderr, options: {} }\n  }\n\n  if (!('options' in configuredLogger)) {\n    return configuredLogger\n  }\n\n  if (\n    configuredLogger.options.transport ||\n    (configuredLogger.destination && configuredLogger.destination !== process.stdout)\n  ) {\n    return configuredLogger\n  }\n\n  return { ...configuredLogger, destination: process.stderr }\n}\n"],"names":["path","pathToFileURL","findConfig","getPayload","createCLIRuntime","activePayload","configPromise","isScheduled","configPath","getConfig","importedConfig","toString","config","default","runtime","configDir","dirname","destroy","payload","undefined","options","configuredLogger","logger","shouldRedirectLogger","process","env","PAYLOAD_CLI_JSON","getJSONLogger","markScheduled","destination","stderr","transport","stdout"],"mappings":"AAAA,OAAOA,UAAU,YAAW;AAC5B,SAASC,aAAa,QAAQ,WAAU;AAKxC,SAASC,UAAU,QAAQ,uBAAsB;AACjD,SAASC,UAAU,QAAQ,iBAAgB;AAE3C;;;;;CAKC,GACD,OAAO,MAAMC,mBAAmB;IAC9B,IAAIC;IACJ,IAAIC;IACJ,IAAIC,cAAc;IAClB,MAAMC,aAAaN;IAEnB,MAAMO,YAAY;QAChBH,kBAAkB,AAAC,CAAA;YACjB,MAAMI,iBAAiB,MAAM,MAAM,CAAC,gBAAgB,GAAGT,cAAcO,YAAYG,QAAQ;YACzF,MAAMC,SAASF,eAAeG,OAAO,GAAG,MAAMH,eAAeG,OAAO,GAAGH;YAEvE,OAAOE;QACT,CAAA;QAEA,OAAON;IACT;IAEA,MAAMQ,UAAsB;QAC1BC,WAAWf,KAAKgB,OAAO,CAACR;QACxB,MAAMS;YACJ,IAAI,CAACZ,eAAe;gBAClB;YACF;YAEA,MAAMa,UAAUb;YAEhBA,gBAAgBc;YAChB,MAAMD,QAAQD,OAAO;QACvB;QACAR;QACA,MAAMN,YAAWiB,UAAU,CAAC,CAAC;YAC3B,MAAMR,SAAS,MAAMH;YACrB,MAAMY,mBAAmBT,OAAOU,MAAM;YACtC,MAAMC,uBAAuBC,QAAQC,GAAG,CAACC,gBAAgB,KAAKP;YAE9D,IAAII,sBAAsB;gBACxBX,OAAOU,MAAM,GAAGK,cAAcN;YAChC;YAEA,IAAI;gBACFhB,gBAAgB,MAAMF,WAAW;oBAC/BS;oBACA,GAAGQ,OAAO;gBACZ;YACF,SAAU;gBACR,IAAIG,sBAAsB;oBACxBX,OAAOU,MAAM,GAAGD;gBAClB;YACF;YAEA,OAAOhB;QACT;QACA,IAAIE,eAAc;YAChB,OAAOA;QACT;QACAqB;YACErB,cAAc;QAChB;IACF;IAEA,OAAOO;AACT,EAAC;AAED,oFAAoF,GACpF,MAAMa,gBAAgB,CAACN;IACrB,IAAI,CAACA,oBAAoBA,qBAAqB,QAAQ;QACpD,OAAO;YAAEQ,aAAaL,QAAQM,MAAM;YAAEV,SAAS,CAAC;QAAE;IACpD;IAEA,IAAI,CAAE,CAAA,aAAaC,gBAAe,GAAI;QACpC,OAAOA;IACT;IAEA,IACEA,iBAAiBD,OAAO,CAACW,SAAS,IACjCV,iBAAiBQ,WAAW,IAAIR,iBAAiBQ,WAAW,KAAKL,QAAQQ,MAAM,EAChF;QACA,OAAOX;IACT;IAEA,OAAO;QAAE,GAAGA,gBAAgB;QAAEQ,aAAaL,QAAQM,MAAM;IAAC;AAC5D"}

package/dist/cli/runtime/getCommandInput.d.ts

@@ -0,0 +1,17 @@
+import type { Command } from 'commander';
+/**
+ * Returns the raw value that the command schema will validate.
+ *
+ * For example, both commands return `{ migrationName: 'add-users' }`:
+ *
+ * ```sh
+ * payload migrate:create add-users
+ * payload migrate:create --input '{"migrationName":"add-users"}'
+ * ```
+ *
+ * Explicit shell values override values from `--input`. If `seed.json` contains
+ * `{ "returning": false }`, then `payload createDocuments --input @seed.json --returning`
+ * returns input with `{ returning: true }`.
+ */
+export declare const getCommandInput: (command: Command) => Promise<unknown>;
+//# sourceMappingURL=getCommandInput.d.ts.map

package/dist/cli/runtime/getCommandInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCommandInput.d.ts","sourceRoot":"","sources":["../../../src/cli/runtime/getCommandInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKxC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,YAAmB,OAAO,KAAG,OAAO,CAAC,OAAO,CAevE,CAAA"}