payload 4.0.0-internal.bc5cf8c → 4.0.0-internal.bf4bcce

package/dist/cli/commands/migrate/run.js

@@ -0,0 +1,28 @@
+import * as z from 'zod/mini';
+import { strictObject } from '../../../utilities/zod.js';
+import { defineCLICommand } from '../../defineCLICommand.js';
+import { initializeMigration } from './initialize.js';
+export const createMigrateCommand = defineCLICommand({
+    description: 'Run pending migrations.',
+    handler: async ({ args, getPayload, isJSON })=>{
+        const { adapter, payload } = await initializeMigration({
+            getPayload
+        });
+        const result = await adapter.migrate({
+            forceAcceptWarning: args.forceAcceptWarning,
+            shouldPrompt: !isJSON
+        });
+        if (!isJSON) {
+            payload.logger.info(result?.cancelled ? 'Cancelled.' : 'Done.');
+        }
+        return result ? {
+            result
+        } : undefined;
+    },
+    helpGroup: 'Migration commands',
+    input: strictObject({
+        forceAcceptWarning: z.optional(z.boolean()).check(z.describe('Skip the migration warning.'))
+    })
+});
+
+//# sourceMappingURL=run.js.map

package/dist/cli/commands/migrate/run.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/cli/commands/migrate/run.ts"],"sourcesContent":["import * as z from 'zod/mini'\n\nimport { strictObject } from '../../../utilities/zod.js'\nimport { defineCLICommand } from '../../defineCLICommand.js'\nimport { initializeMigration } from './initialize.js'\n\nexport const createMigrateCommand = defineCLICommand({\n  description: 'Run pending migrations.',\n  handler: async ({ args, getPayload, isJSON }) => {\n    const { adapter, payload } = await initializeMigration({ getPayload })\n\n    const result = await adapter.migrate({\n      forceAcceptWarning: args.forceAcceptWarning,\n      shouldPrompt: !isJSON,\n    })\n\n    if (!isJSON) {\n      payload.logger.info(result?.cancelled ? 'Cancelled.' : 'Done.')\n    }\n\n    return result ? { result } : undefined\n  },\n  helpGroup: 'Migration commands',\n  input: strictObject({\n    forceAcceptWarning: z.optional(z.boolean()).check(z.describe('Skip the migration warning.')),\n  }),\n})\n"],"names":["z","strictObject","defineCLICommand","initializeMigration","createMigrateCommand","description","handler","args","getPayload","isJSON","adapter","payload","result","migrate","forceAcceptWarning","shouldPrompt","logger","info","cancelled","undefined","helpGroup","input","optional","boolean","check","describe"],"mappings":"AAAA,YAAYA,OAAO,WAAU;AAE7B,SAASC,YAAY,QAAQ,4BAA2B;AACxD,SAASC,gBAAgB,QAAQ,4BAA2B;AAC5D,SAASC,mBAAmB,QAAQ,kBAAiB;AAErD,OAAO,MAAMC,uBAAuBF,iBAAiB;IACnDG,aAAa;IACbC,SAAS,OAAO,EAAEC,IAAI,EAAEC,UAAU,EAAEC,MAAM,EAAE;QAC1C,MAAM,EAAEC,OAAO,EAAEC,OAAO,EAAE,GAAG,MAAMR,oBAAoB;YAAEK;QAAW;QAEpE,MAAMI,SAAS,MAAMF,QAAQG,OAAO,CAAC;YACnCC,oBAAoBP,KAAKO,kBAAkB;YAC3CC,cAAc,CAACN;QACjB;QAEA,IAAI,CAACA,QAAQ;YACXE,QAAQK,MAAM,CAACC,IAAI,CAACL,QAAQM,YAAY,eAAe;QACzD;QAEA,OAAON,SAAS;YAAEA;QAAO,IAAIO;IAC/B;IACAC,WAAW;IACXC,OAAOpB,aAAa;QAClBa,oBAAoBd,EAAEsB,QAAQ,CAACtB,EAAEuB,OAAO,IAAIC,KAAK,CAACxB,EAAEyB,QAAQ,CAAC;IAC/D;AACF,GAAE"}

package/dist/cli/commands/migrate/status.d.ts

@@ -0,0 +1,2 @@
+export declare const createMigrateStatusCommand: import("../../../index.js").CLICommand;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/commands/migrate/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/migrate/status.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,0BAA0B,wCAerC,CAAA"}

package/dist/cli/commands/migrate/status.js

@@ -0,0 +1,22 @@
+import { strictObject } from '../../../utilities/zod.js';
+import { defineCLICommand } from '../../defineCLICommand.js';
+import { initializeMigration } from './initialize.js';
+export const createMigrateStatusCommand = defineCLICommand({
+    description: 'Show migration status.',
+    handler: async ({ getPayload, isJSON })=>{
+        const { adapter, payload } = await initializeMigration({
+            getPayload
+        });
+        const result = await adapter.migrateStatus();
+        if (!isJSON) {
+            payload.logger.info('Done.');
+        }
+        return result ? {
+            result
+        } : undefined;
+    },
+    helpGroup: 'Migration commands',
+    input: strictObject({})
+});
+
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/migrate/status.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/cli/commands/migrate/status.ts"],"sourcesContent":["import { strictObject } from '../../../utilities/zod.js'\nimport { defineCLICommand } from '../../defineCLICommand.js'\nimport { initializeMigration } from './initialize.js'\n\nexport const createMigrateStatusCommand = defineCLICommand({\n  description: 'Show migration status.',\n  handler: async ({ getPayload, isJSON }) => {\n    const { adapter, payload } = await initializeMigration({ getPayload })\n\n    const result = await adapter.migrateStatus()\n\n    if (!isJSON) {\n      payload.logger.info('Done.')\n    }\n\n    return result ? { result } : undefined\n  },\n  helpGroup: 'Migration commands',\n  input: strictObject({}),\n})\n"],"names":["strictObject","defineCLICommand","initializeMigration","createMigrateStatusCommand","description","handler","getPayload","isJSON","adapter","payload","result","migrateStatus","logger","info","undefined","helpGroup","input"],"mappings":"AAAA,SAASA,YAAY,QAAQ,4BAA2B;AACxD,SAASC,gBAAgB,QAAQ,4BAA2B;AAC5D,SAASC,mBAAmB,QAAQ,kBAAiB;AAErD,OAAO,MAAMC,6BAA6BF,iBAAiB;IACzDG,aAAa;IACbC,SAAS,OAAO,EAAEC,UAAU,EAAEC,MAAM,EAAE;QACpC,MAAM,EAAEC,OAAO,EAAEC,OAAO,EAAE,GAAG,MAAMP,oBAAoB;YAAEI;QAAW;QAEpE,MAAMI,SAAS,MAAMF,QAAQG,aAAa;QAE1C,IAAI,CAACJ,QAAQ;YACXE,QAAQG,MAAM,CAACC,IAAI,CAAC;QACtB;QAEA,OAAOH,SAAS;YAAEA;QAAO,IAAII;IAC/B;IACAC,WAAW;IACXC,OAAOhB,aAAa,CAAC;AACvB,GAAE"}

package/dist/cli/commands/run.d.ts

@@ -0,0 +1,2 @@
+export declare const createRunCommand: import("../../index.js").CLICommand;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/run.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,gBAAgB,qCAgC3B,CAAA"}

package/dist/cli/commands/run.js

@@ -0,0 +1,45 @@
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import * as z from 'zod/mini';
+import { strictObject } from '../../utilities/zod.js';
+import { defineCLICommand } from '../defineCLICommand.js';
+export const createRunCommand = defineCLICommand({
+    allowUnknownOption: true,
+    cli: {
+        scriptArgs: {
+            type: 'argument',
+            position: 1
+        },
+        scriptPath: {
+            type: 'argument',
+            position: 0
+        }
+    },
+    description: 'Run a local script in the Payload environment.',
+    handler: async ({ args })=>{
+        const absoluteScriptPath = path.resolve(process.cwd(), args.scriptPath);
+        const originalArgv = process.argv;
+        // Make the imported module receive arguments as if it were run directly with Node.
+        // For example, `[node, payload, run, script.ts, first]` becomes `[node, script.ts, first]`.
+        process.argv = [
+            process.execPath,
+            absoluteScriptPath,
+            ...args.scriptArgs
+        ];
+        try {
+            await import(pathToFileURL(absoluteScriptPath).toString());
+        } catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            throw new Error(`Error running script ${absoluteScriptPath}: ${message}`);
+        } finally{
+            process.argv = originalArgv;
+        }
+    },
+    helpGroup: 'Core commands',
+    input: strictObject({
+        scriptArgs: z._default(z.array(z.string()), []).check(z.describe('Arguments passed to the script.')),
+        scriptPath: z.string().check(z.minLength(1), z.describe('Path to the local script.'))
+    })
+});
+
+//# sourceMappingURL=run.js.map

package/dist/cli/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/run.ts"],"sourcesContent":["import path from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport * as z from 'zod/mini'\n\nimport { strictObject } from '../../utilities/zod.js'\nimport { defineCLICommand } from '../defineCLICommand.js'\n\nexport const createRunCommand = defineCLICommand({\n  allowUnknownOption: true,\n  cli: {\n    scriptArgs: { type: 'argument', position: 1 },\n    scriptPath: { type: 'argument', position: 0 },\n  },\n  description: 'Run a local script in the Payload environment.',\n  handler: async ({ args }) => {\n    const absoluteScriptPath = path.resolve(process.cwd(), args.scriptPath)\n    const originalArgv = process.argv\n\n    // Make the imported module receive arguments as if it were run directly with Node.\n    // For example, `[node, payload, run, script.ts, first]` becomes `[node, script.ts, first]`.\n    process.argv = [process.execPath, absoluteScriptPath, ...args.scriptArgs]\n\n    try {\n      await import(pathToFileURL(absoluteScriptPath).toString())\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error'\n\n      throw new Error(`Error running script ${absoluteScriptPath}: ${message}`)\n    } finally {\n      process.argv = originalArgv\n    }\n  },\n  helpGroup: 'Core commands',\n  input: strictObject({\n    scriptArgs: z\n      ._default(z.array(z.string()), [])\n      .check(z.describe('Arguments passed to the script.')),\n    scriptPath: z.string().check(z.minLength(1), z.describe('Path to the local script.')),\n  }),\n})\n"],"names":["path","pathToFileURL","z","strictObject","defineCLICommand","createRunCommand","allowUnknownOption","cli","scriptArgs","type","position","scriptPath","description","handler","args","absoluteScriptPath","resolve","process","cwd","originalArgv","argv","execPath","toString","error","message","Error","helpGroup","input","_default","array","string","check","describe","minLength"],"mappings":"AAAA,OAAOA,UAAU,YAAW;AAC5B,SAASC,aAAa,QAAQ,WAAU;AACxC,YAAYC,OAAO,WAAU;AAE7B,SAASC,YAAY,QAAQ,yBAAwB;AACrD,SAASC,gBAAgB,QAAQ,yBAAwB;AAEzD,OAAO,MAAMC,mBAAmBD,iBAAiB;IAC/CE,oBAAoB;IACpBC,KAAK;QACHC,YAAY;YAAEC,MAAM;YAAYC,UAAU;QAAE;QAC5CC,YAAY;YAAEF,MAAM;YAAYC,UAAU;QAAE;IAC9C;IACAE,aAAa;IACbC,SAAS,OAAO,EAAEC,IAAI,EAAE;QACtB,MAAMC,qBAAqBf,KAAKgB,OAAO,CAACC,QAAQC,GAAG,IAAIJ,KAAKH,UAAU;QACtE,MAAMQ,eAAeF,QAAQG,IAAI;QAEjC,mFAAmF;QACnF,4FAA4F;QAC5FH,QAAQG,IAAI,GAAG;YAACH,QAAQI,QAAQ;YAAEN;eAAuBD,KAAKN,UAAU;SAAC;QAEzE,IAAI;YACF,MAAM,MAAM,CAACP,cAAcc,oBAAoBO,QAAQ;QACzD,EAAE,OAAOC,OAAO;YACd,MAAMC,UAAUD,iBAAiBE,QAAQF,MAAMC,OAAO,GAAG;YAEzD,MAAM,IAAIC,MAAM,CAAC,qBAAqB,EAAEV,mBAAmB,EAAE,EAAES,SAAS;QAC1E,SAAU;YACRP,QAAQG,IAAI,GAAGD;QACjB;IACF;IACAO,WAAW;IACXC,OAAOxB,aAAa;QAClBK,YAAYN,EACT0B,QAAQ,CAAC1B,EAAE2B,KAAK,CAAC3B,EAAE4B,MAAM,KAAK,EAAE,EAChCC,KAAK,CAAC7B,EAAE8B,QAAQ,CAAC;QACpBrB,YAAYT,EAAE4B,MAAM,GAAGC,KAAK,CAAC7B,EAAE+B,SAAS,CAAC,IAAI/B,EAAE8B,QAAQ,CAAC;IAC1D;AACF,GAAE"}

package/dist/cli/defineCLICommand.d.ts

@@ -0,0 +1,32 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import type { CLICommand, CLICommandResult, CLIFieldOverride, CLIHelp, CLIInputSchema, CLIRuntime } from '../config/types.js';
+import type { MaybePromise } from '../types/index.js';
+type CLICommandDefinition<TInput extends CLIInputSchema> = {
+    aliases?: string[];
+    allowUnknownOption?: boolean;
+    cli?: false | Partial<Record<Extract<keyof StandardSchemaV1.InferInput<TInput>, string>, CLIFieldOverride>>;
+    description: string;
+    examples?: string[];
+    /**
+     * Runs after Payload validates the command input. `args` contains the validated values.
+     *
+     * - Return nothing when the command succeeds without a result.
+     * - Return a number to set the process exit code.
+     * - Return `{ result }` to include data in JSON output.
+     * - Return `{ exitCode, result }` when the command needs both.
+     *
+     * Console and Payload logger output is sent to stderr in JSON mode. Use `isJSON` when the
+     * command's behavior itself needs to change for machine-readable output.
+     */
+    handler: (context: {
+        args: StandardSchemaV1.InferOutput<TInput>;
+        help: CLIHelp;
+        isJSON: boolean;
+    } & Pick<CLIRuntime, 'getConfig' | 'getPayload'>) => MaybePromise<CLICommandResult | number | void>;
+    helpGroup?: string;
+    input: TInput;
+};
+/** Defines a CLI command from its input schema, shell input, and handler. */
+export declare const defineCLICommand: <TInput extends CLIInputSchema>(definition: CLICommandDefinition<TInput>) => CLICommand;
+export {};
+//# sourceMappingURL=defineCLICommand.d.ts.map

package/dist/cli/defineCLICommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineCLICommand.d.ts","sourceRoot":"","sources":["../../src/cli/defineCLICommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,cAAc,EACd,UAAU,EACX,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,KAAK,oBAAoB,CAAC,MAAM,SAAS,cAAc,IAAI;IACzD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,GAAG,CAAC,EACA,KAAK,GACL,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAA;IACjG,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB;;;;;;;;;;OAUG;IACH,OAAO,EAAE,CACP,OAAO,EAAE;QACP,IAAI,EAAE,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;QAC1C,IAAI,EAAE,OAAO,CAAA;QACb,MAAM,EAAE,OAAO,CAAA;KAChB,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,GAAG,YAAY,CAAC,KAC7C,YAAY,CAAC,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAAC,CAAA;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,GAAI,MAAM,SAAS,cAAc,cAChD,oBAAoB,CAAC,MAAM,CAAC,KACvC,UAyBF,CAAA"}

package/dist/cli/defineCLICommand.js

@@ -0,0 +1,26 @@
+/** Defines a CLI command from its input schema, shell input, and handler. */ export const defineCLICommand = (definition)=>{
+    const { cli, input } = definition;
+    const schema = input['~standard'].jsonSchema.input({
+        target: 'draft-2020-12'
+    });
+    if (schema.type !== 'object') {
+        throw new Error('CLI command input schema must describe an object.');
+    }
+    const properties = schema.properties ?? {};
+    const overrides = cli === false ? {} : cli ?? {};
+    for (const field of Object.keys(overrides)){
+        if (!(field in properties)) {
+            throw new Error(`CLI command configures unknown input '${field}'.`);
+        }
+    }
+    return {
+        ...definition,
+        allowUnknownOption: definition.allowUnknownOption ?? false,
+        cli: cli === false ? false : overrides,
+        handler: definition.handler,
+        input: input,
+        schema
+    };
+};
+
+//# sourceMappingURL=defineCLICommand.js.map

package/dist/cli/defineCLICommand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/defineCLICommand.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec'\n\nimport type {\n  CLICommand,\n  CLICommandResult,\n  CLIFieldOverride,\n  CLIHelp,\n  CLIInputSchema,\n  CLIRuntime,\n} from '../config/types.js'\nimport type { MaybePromise } from '../types/index.js'\n\ntype CLICommandDefinition<TInput extends CLIInputSchema> = {\n  aliases?: string[]\n  allowUnknownOption?: boolean\n  cli?:\n    | false\n    | Partial<Record<Extract<keyof StandardSchemaV1.InferInput<TInput>, string>, CLIFieldOverride>>\n  description: string\n  examples?: string[]\n  /**\n   * Runs after Payload validates the command input. `args` contains the validated values.\n   *\n   * - Return nothing when the command succeeds without a result.\n   * - Return a number to set the process exit code.\n   * - Return `{ result }` to include data in JSON output.\n   * - Return `{ exitCode, result }` when the command needs both.\n   *\n   * Console and Payload logger output is sent to stderr in JSON mode. Use `isJSON` when the\n   * command's behavior itself needs to change for machine-readable output.\n   */\n  handler: (\n    context: {\n      args: StandardSchemaV1.InferOutput<TInput>\n      help: CLIHelp\n      isJSON: boolean\n    } & Pick<CLIRuntime, 'getConfig' | 'getPayload'>,\n  ) => MaybePromise<CLICommandResult | number | void>\n  helpGroup?: string\n  input: TInput\n}\n\n/** Defines a CLI command from its input schema, shell input, and handler. */\nexport const defineCLICommand = <TInput extends CLIInputSchema>(\n  definition: CLICommandDefinition<TInput>,\n): CLICommand => {\n  const { cli, input } = definition\n  const schema = input['~standard'].jsonSchema.input({ target: 'draft-2020-12' })\n\n  if (schema.type !== 'object') {\n    throw new Error('CLI command input schema must describe an object.')\n  }\n\n  const properties = (schema.properties ?? {}) as Record<string, unknown>\n  const overrides = cli === false ? {} : (cli ?? {})\n\n  for (const field of Object.keys(overrides)) {\n    if (!(field in properties)) {\n      throw new Error(`CLI command configures unknown input '${field}'.`)\n    }\n  }\n\n  return {\n    ...definition,\n    allowUnknownOption: definition.allowUnknownOption ?? false,\n    cli: cli === false ? false : overrides,\n    handler: definition.handler as CLICommand['handler'],\n    input: input as CLIInputSchema,\n    schema,\n  }\n}\n"],"names":["defineCLICommand","definition","cli","input","schema","jsonSchema","target","type","Error","properties","overrides","field","Object","keys","allowUnknownOption","handler"],"mappings":"AA0CA,2EAA2E,GAC3E,OAAO,MAAMA,mBAAmB,CAC9BC;IAEA,MAAM,EAAEC,GAAG,EAAEC,KAAK,EAAE,GAAGF;IACvB,MAAMG,SAASD,KAAK,CAAC,YAAY,CAACE,UAAU,CAACF,KAAK,CAAC;QAAEG,QAAQ;IAAgB;IAE7E,IAAIF,OAAOG,IAAI,KAAK,UAAU;QAC5B,MAAM,IAAIC,MAAM;IAClB;IAEA,MAAMC,aAAcL,OAAOK,UAAU,IAAI,CAAC;IAC1C,MAAMC,YAAYR,QAAQ,QAAQ,CAAC,IAAKA,OAAO,CAAC;IAEhD,KAAK,MAAMS,SAASC,OAAOC,IAAI,CAACH,WAAY;QAC1C,IAAI,CAAEC,CAAAA,SAASF,UAAS,GAAI;YAC1B,MAAM,IAAID,MAAM,CAAC,sCAAsC,EAAEG,MAAM,EAAE,CAAC;QACpE;IACF;IAEA,OAAO;QACL,GAAGV,UAAU;QACba,oBAAoBb,WAAWa,kBAAkB,IAAI;QACrDZ,KAAKA,QAAQ,QAAQ,QAAQQ;QAC7BK,SAASd,WAAWc,OAAO;QAC3BZ,OAAOA;QACPC;IACF;AACF,EAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+import type { CLIRuntime } from '../config/types.js';
+export declare const bin: () => Promise<void>;
+export declare const createCLI: (runtime: CLIRuntime, { isJSON }?: {
+    isJSON?: boolean;
+}) => Promise<Command>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAI3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAWpD,eAAO,MAAM,GAAG,qBAgBd,CAAA;AA+BF,eAAO,MAAM,SAAS,YACX,UAAU,eACU;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,KAChD,OAAO,CAAC,OAAO,CAiDjB,CAAA"}

package/dist/cli/index.js

@@ -0,0 +1,95 @@
+import { Command, Option } from 'commander';
+import { config as configureZod } from 'zod/mini';
+import en from 'zod/v4/locales/en.js';
+import { createCLIHelp } from './program/createHelp.js';
+import { loadCLICommands, validateCLICommandNames } from './program/loadCommands.js';
+import { normalizeHelpArguments } from './program/normalizeHelpArguments.js';
+import { registerCLICommand } from './program/registerCommand.js';
+import { createCLIRuntime } from './runtime/createRuntime.js';
+import { loadEnv } from './runtime/loadEnv.js';
+import { isJSONOutput, withCLIOutputMode, withErrorHandling } from './runtime/output.js';
+import { writeToCLIStdout } from './runtime/redirectOutputToStderr.js';
+export const bin = withErrorHandling(async ()=>{
+    // /////////////////////////////////////
+    // Setup environment
+    // /////////////////////////////////////
+    loadEnv();
+    process.env.DISABLE_PAYLOAD_HMR = 'true';
+    const isJSON = isJSONOutput();
+    const shouldExit = await withCLIOutputMode({
+        isJSON,
+        run: ()=>runCLI({
+                isJSON
+            })
+    });
+    if (shouldExit) {
+        process.exit(process.exitCode ?? 0);
+    }
+});
+const runCLI = async ({ isJSON })=>{
+    const runtime = createCLIRuntime();
+    // /////////////////////////////////////
+    // Create and register commands
+    // /////////////////////////////////////
+    const cli = await createCLI(runtime, {
+        isJSON
+    });
+    // /////////////////////////////////////
+    // Output help if no command was provided
+    // /////////////////////////////////////
+    if (process.argv.length === 2) {
+        writeToCLIStdout({
+            output: cli.helpInformation()
+        });
+        return false;
+    }
+    // /////////////////////////////////////
+    // Run the CLI with the provided arguments
+    // /////////////////////////////////////
+    await cli.parseAsync(normalizeHelpArguments({
+        args: process.argv,
+        cli
+    })).finally(async ()=>{
+        // Cleanup runtime
+        if (!runtime.isScheduled) {
+            await runtime.destroy();
+        }
+    });
+    return !runtime.isScheduled;
+};
+export const createCLI = async (runtime, { isJSON = isJSONOutput() } = {})=>{
+    configureZod(en());
+    const jsonOption = new Option('--json', 'Write one JSON response to stdout; send logs to stderr (do not use 2>&1).');
+    const noJSONOption = new Option('--no-json', 'Use human-readable output even when PAYLOAD_CLI_JSON is set.');
+    if (isJSON) {
+        jsonOption.hideHelp();
+    } else {
+        noJSONOption.hideHelp();
+    }
+    const cli = new Command().name('payload').description('Manage and operate a local Payload project.').exitOverride().showHelpAfterError().showSuggestionAfterError().option('--cron <expression>', 'Run the command on a cron schedule.').addOption(jsonOption).addOption(noJSONOption);
+    // /////////////////////////////////////
+    // Load, validate and register commands
+    // /////////////////////////////////////
+    const commands = await loadCLICommands({
+        runtime
+    });
+    validateCLICommandNames({
+        commands
+    });
+    const help = createCLIHelp({
+        cli,
+        commands
+    });
+    for (const { name, definition } of commands){
+        registerCLICommand({
+            name,
+            cli,
+            definition,
+            help,
+            runtime
+        });
+    }
+    return cli;
+};
+
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["import { Command, Option } from 'commander'\nimport { config as configureZod } from 'zod/mini'\nimport en from 'zod/v4/locales/en.js'\n\nimport type { CLIRuntime } from '../config/types.js'\n\nimport { createCLIHelp } from './program/createHelp.js'\nimport { loadCLICommands, validateCLICommandNames } from './program/loadCommands.js'\nimport { normalizeHelpArguments } from './program/normalizeHelpArguments.js'\nimport { registerCLICommand } from './program/registerCommand.js'\nimport { createCLIRuntime } from './runtime/createRuntime.js'\nimport { loadEnv } from './runtime/loadEnv.js'\nimport { isJSONOutput, withCLIOutputMode, withErrorHandling } from './runtime/output.js'\nimport { writeToCLIStdout } from './runtime/redirectOutputToStderr.js'\n\nexport const bin = withErrorHandling(async (): Promise<void> => {\n  // /////////////////////////////////////\n  // Setup environment\n  // /////////////////////////////////////\n  loadEnv()\n  process.env.DISABLE_PAYLOAD_HMR = 'true'\n\n  const isJSON = isJSONOutput()\n  const shouldExit = await withCLIOutputMode({\n    isJSON,\n    run: () => runCLI({ isJSON }),\n  })\n\n  if (shouldExit) {\n    process.exit(process.exitCode ?? 0)\n  }\n})\n\nconst runCLI = async ({ isJSON }: { isJSON: boolean }): Promise<boolean> => {\n  const runtime = createCLIRuntime()\n\n  // /////////////////////////////////////\n  // Create and register commands\n  // /////////////////////////////////////\n  const cli = await createCLI(runtime, { isJSON })\n\n  // /////////////////////////////////////\n  // Output help if no command was provided\n  // /////////////////////////////////////\n  if (process.argv.length === 2) {\n    writeToCLIStdout({ output: cli.helpInformation() })\n    return false\n  }\n\n  // /////////////////////////////////////\n  // Run the CLI with the provided arguments\n  // /////////////////////////////////////\n  await cli.parseAsync(normalizeHelpArguments({ args: process.argv, cli })).finally(async () => {\n    // Cleanup runtime\n    if (!runtime.isScheduled) {\n      await runtime.destroy()\n    }\n  })\n\n  return !runtime.isScheduled\n}\n\nexport const createCLI = async (\n  runtime: CLIRuntime,\n  { isJSON = isJSONOutput() }: { isJSON?: boolean } = {},\n): Promise<Command> => {\n  configureZod(en())\n\n  const jsonOption = new Option(\n    '--json',\n    'Write one JSON response to stdout; send logs to stderr (do not use 2>&1).',\n  )\n  const noJSONOption = new Option(\n    '--no-json',\n    'Use human-readable output even when PAYLOAD_CLI_JSON is set.',\n  )\n\n  if (isJSON) {\n    jsonOption.hideHelp()\n  } else {\n    noJSONOption.hideHelp()\n  }\n\n  const cli = new Command()\n    .name('payload')\n    .description('Manage and operate a local Payload project.')\n    .exitOverride()\n    .showHelpAfterError()\n    .showSuggestionAfterError()\n    .option('--cron <expression>', 'Run the command on a cron schedule.')\n    .addOption(jsonOption)\n    .addOption(noJSONOption)\n\n  // /////////////////////////////////////\n  // Load, validate and register commands\n  // /////////////////////////////////////\n\n  const commands = await loadCLICommands({ runtime })\n\n  validateCLICommandNames({ commands })\n\n  const help = createCLIHelp({ cli, commands })\n\n  for (const { name, definition } of commands) {\n    registerCLICommand({\n      name,\n      cli,\n      definition,\n      help,\n      runtime,\n    })\n  }\n\n  return cli\n}\n"],"names":["Command","Option","config","configureZod","en","createCLIHelp","loadCLICommands","validateCLICommandNames","normalizeHelpArguments","registerCLICommand","createCLIRuntime","loadEnv","isJSONOutput","withCLIOutputMode","withErrorHandling","writeToCLIStdout","bin","process","env","DISABLE_PAYLOAD_HMR","isJSON","shouldExit","run","runCLI","exit","exitCode","runtime","cli","createCLI","argv","length","output","helpInformation","parseAsync","args","finally","isScheduled","destroy","jsonOption","noJSONOption","hideHelp","name","description","exitOverride","showHelpAfterError","showSuggestionAfterError","option","addOption","commands","help","definition"],"mappings":"AAAA,SAASA,OAAO,EAAEC,MAAM,QAAQ,YAAW;AAC3C,SAASC,UAAUC,YAAY,QAAQ,WAAU;AACjD,OAAOC,QAAQ,uBAAsB;AAIrC,SAASC,aAAa,QAAQ,0BAAyB;AACvD,SAASC,eAAe,EAAEC,uBAAuB,QAAQ,4BAA2B;AACpF,SAASC,sBAAsB,QAAQ,sCAAqC;AAC5E,SAASC,kBAAkB,QAAQ,+BAA8B;AACjE,SAASC,gBAAgB,QAAQ,6BAA4B;AAC7D,SAASC,OAAO,QAAQ,uBAAsB;AAC9C,SAASC,YAAY,EAAEC,iBAAiB,EAAEC,iBAAiB,QAAQ,sBAAqB;AACxF,SAASC,gBAAgB,QAAQ,sCAAqC;AAEtE,OAAO,MAAMC,MAAMF,kBAAkB;IACnC,wCAAwC;IACxC,oBAAoB;IACpB,wCAAwC;IACxCH;IACAM,QAAQC,GAAG,CAACC,mBAAmB,GAAG;IAElC,MAAMC,SAASR;IACf,MAAMS,aAAa,MAAMR,kBAAkB;QACzCO;QACAE,KAAK,IAAMC,OAAO;gBAAEH;YAAO;IAC7B;IAEA,IAAIC,YAAY;QACdJ,QAAQO,IAAI,CAACP,QAAQQ,QAAQ,IAAI;IACnC;AACF,GAAE;AAEF,MAAMF,SAAS,OAAO,EAAEH,MAAM,EAAuB;IACnD,MAAMM,UAAUhB;IAEhB,wCAAwC;IACxC,+BAA+B;IAC/B,wCAAwC;IACxC,MAAMiB,MAAM,MAAMC,UAAUF,SAAS;QAAEN;IAAO;IAE9C,wCAAwC;IACxC,yCAAyC;IACzC,wCAAwC;IACxC,IAAIH,QAAQY,IAAI,CAACC,MAAM,KAAK,GAAG;QAC7Bf,iBAAiB;YAAEgB,QAAQJ,IAAIK,eAAe;QAAG;QACjD,OAAO;IACT;IAEA,wCAAwC;IACxC,0CAA0C;IAC1C,wCAAwC;IACxC,MAAML,IAAIM,UAAU,CAACzB,uBAAuB;QAAE0B,MAAMjB,QAAQY,IAAI;QAAEF;IAAI,IAAIQ,OAAO,CAAC;QAChF,kBAAkB;QAClB,IAAI,CAACT,QAAQU,WAAW,EAAE;YACxB,MAAMV,QAAQW,OAAO;QACvB;IACF;IAEA,OAAO,CAACX,QAAQU,WAAW;AAC7B;AAEA,OAAO,MAAMR,YAAY,OACvBF,SACA,EAAEN,SAASR,cAAc,EAAwB,GAAG,CAAC,CAAC;IAEtDT,aAAaC;IAEb,MAAMkC,aAAa,IAAIrC,OACrB,UACA;IAEF,MAAMsC,eAAe,IAAItC,OACvB,aACA;IAGF,IAAImB,QAAQ;QACVkB,WAAWE,QAAQ;IACrB,OAAO;QACLD,aAAaC,QAAQ;IACvB;IAEA,MAAMb,MAAM,IAAI3B,UACbyC,IAAI,CAAC,WACLC,WAAW,CAAC,+CACZC,YAAY,GACZC,kBAAkB,GAClBC,wBAAwB,GACxBC,MAAM,CAAC,uBAAuB,uCAC9BC,SAAS,CAACT,YACVS,SAAS,CAACR;IAEb,wCAAwC;IACxC,uCAAuC;IACvC,wCAAwC;IAExC,MAAMS,WAAW,MAAM1C,gBAAgB;QAAEoB;IAAQ;IAEjDnB,wBAAwB;QAAEyC;IAAS;IAEnC,MAAMC,OAAO5C,cAAc;QAAEsB;QAAKqB;IAAS;IAE3C,KAAK,MAAM,EAAEP,IAAI,EAAES,UAAU,EAAE,IAAIF,SAAU;QAC3CvC,mBAAmB;YACjBgC;YACAd;YACAuB;YACAD;YACAvB;QACF;IACF;IAEA,OAAOC;AACT,EAAC"}

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

@@ -0,0 +1,8 @@
+import type { Command } from 'commander';
+import type { CLIHelp } from '../../config/types.js';
+import type { ResolvedCLICommand } from './loadCommands.js';
+export declare const createCLIHelp: ({ cli, commands, }: {
+    cli: Command;
+    commands: ResolvedCLICommand[];
+}) => CLIHelp;
+//# sourceMappingURL=createHelp.d.ts.map

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":"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"}

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"}