@valkyrianlabs/payload-markdown-docs 0.1.0-canary.0

package/dist/cli/index.js

@@ -0,0 +1,214 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { runInstallCommand } from './commands/install.js';
+import { runKeygenCommand } from './commands/keygen.js';
+import { runManifestCommand } from './commands/manifest.js';
+import { runPlanCommand } from './commands/plan.js';
+import { runPushCommand } from './commands/push.js';
+import { runValidateCommand } from './commands/validate.js';
+import { getFlagString, parseCliArgs } from './parseArgs.js';
+const helpText = `payload-markdown-docs
+
+Usage:
+  payload-markdown-docs validate <docs-root> [options]
+  payload-markdown-docs manifest <docs-root> [options]
+  payload-markdown-docs plan <docs-root> [options]
+  payload-markdown-docs push <docs-root> [options]
+  payload-markdown-docs keygen [options]
+  payload-markdown-docs install skill --codex [options]
+
+Commands:
+  validate   Validate a local Markdown docs directory.
+  manifest   Print a JSON docs manifest for a local Markdown docs directory.
+  plan       Build a dry sync plan against optional existing docs records.
+  push       Sign and upload a docs manifest to a Payload sync endpoint.
+  keygen     Generate Ed25519 keys for signed sync.
+  install    Install local AI-agent guidance for docs maintenance.
+`;
+const commandHelp = {
+    install: `payload-markdown-docs install skill --codex
+
+Aliases:
+  payload-markdown-docs install ai-skill --codex
+  payload-markdown-docs install skill --agent codex
+
+Options:
+  --codex                         Install the Codex skill pack.
+  --agent <codex>                 Agent target. Currently only codex.
+  --out <path>                    Output directory. Defaults to .agents/skills/payload-markdown-docs.
+  --docs-root <path>              Docs root to mention in installed guidance. Defaults to ./docs.
+  --package-manager <name>        pnpm, npm, yarn, or bun. Auto-detected when omitted.
+  --force                         Overwrite existing skill files.
+  --dry-run                       Print planned files without writing.
+  --help                          Show this help.
+
+Installs local AI-agent guidance only. It does not sync docs, call Payload, or run package manager commands.
+`,
+    keygen: `payload-markdown-docs keygen
+
+Options:
+  --format <pem|base64>  Output key format. Defaults to pem.
+  --out <dir>            Write docs-sync-public.pem and docs-sync-private.pem.
+  --force                Overwrite existing key files when used with --out.
+  --help                 Show this help.
+`,
+    manifest: `payload-markdown-docs manifest <docs-root>
+
+Options:
+  --source <id>              Manifest source id. Defaults to local-docs.
+  --root <path>              Manifest source root label.
+  --route-base <route>       Route base for validation. Defaults to /docs.
+  --repository <repo>        Source repository metadata.
+  --branch <branch>          Source branch metadata.
+  --commit <sha>             Source commit metadata.
+  --pretty                   Pretty-print JSON.
+  --max-files <number>       Maximum file count.
+  --max-file-bytes <number>  Maximum single file size.
+  --max-total-bytes <number> Maximum total Markdown bytes.
+  --help                     Show this help.
+`,
+    plan: `payload-markdown-docs plan <docs-root>
+
+Options:
+  --existing <path>          JSON array of existing docs records.
+  --delete-behavior <value>  archive, delete, draft, or ignore.
+  --json                     Print full plan JSON.
+  --pretty                   Pretty-print JSON output.
+  --source <id>              Manifest source id. Defaults to local-docs.
+  --root <path>              Manifest source root label.
+  --route-base <route>       Route base for validation. Defaults to /docs.
+  --repository <repo>        Source repository metadata.
+  --branch <branch>          Source branch metadata.
+  --commit <sha>             Source commit metadata.
+  --max-files <number>       Maximum file count.
+  --max-file-bytes <number>  Maximum single file size.
+  --max-total-bytes <number> Maximum total Markdown bytes.
+  --help                     Show this help.
+`,
+    push: `payload-markdown-docs push <docs-root>
+
+Options:
+  --endpoint <url>           Full Payload sync endpoint URL.
+  --key-id <id>              Server-configured Ed25519 key id.
+  --private-key-file <path>  PEM private key file from keygen.
+  --private-key-env <name>   Environment variable containing the private key.
+  --github-oidc              Use GitHub Actions OIDC bearer auth instead of Ed25519.
+  --oidc-audience <value>    GitHub OIDC audience. Defaults to payload-markdown-docs.
+  --oidc-token-env <name>    Environment variable containing an already-fetched OIDC token.
+  --dry-run                  Upload as dry-run mode. This is the default.
+  --sync                     Upload as sync mode. Requires server sync.allowWrites.
+  --publish                  Request published output. Server must allow publishing.
+  --delete-behavior <value>  archive, delete, draft, or ignore. Defaults to archive.
+  --json                     Print structured JSON output.
+  --pretty                   Pretty-print JSON output with --json.
+  --source <id>              Manifest source id. Defaults to local-docs.
+  --root <path>              Manifest source root label.
+  --route-base <route>       Route base for local validation. Defaults to /docs.
+  --repository <repo>        Source repository metadata.
+  --branch <branch>          Source branch metadata.
+  --commit <sha>             Source commit metadata.
+  --max-files <number>       Maximum file count.
+  --max-file-bytes <number>  Maximum single file size.
+  --max-total-bytes <number> Maximum total Markdown bytes.
+  --help                     Show this help.
+
+Examples:
+  Ed25519:
+    payload-markdown-docs push ./docs --endpoint "$DOCS_SYNC_ENDPOINT" --source main-docs --key-id github-actions-main --private-key-env DOCS_SYNC_PRIVATE_KEY --sync
+
+  GitHub OIDC:
+    payload-markdown-docs push ./docs --endpoint "$DOCS_SYNC_ENDPOINT" --source main-docs --github-oidc --oidc-audience payload-markdown-docs --sync
+
+GitHub OIDC requires workflow permissions: id-token: write and contents: read.
+Hard delete requires explicit server sync.allowHardDelete. Existing collection and block targets are not supported yet.
+`,
+    validate: `payload-markdown-docs validate <docs-root>
+
+Options:
+  --json                     Print validation JSON.
+  --pretty                   Pretty-print JSON output.
+  --source <id>              Manifest source id. Defaults to local-docs.
+  --root <path>              Manifest source root label.
+  --route-base <route>       Route base for validation. Defaults to /docs.
+  --repository <repo>        Source repository metadata.
+  --branch <branch>          Source branch metadata.
+  --commit <sha>             Source commit metadata.
+  --max-files <number>       Maximum file count.
+  --max-file-bytes <number>  Maximum single file size.
+  --max-total-bytes <number> Maximum total Markdown bytes.
+  --help                     Show this help.
+`
+};
+const getHelpForArgs = (args)=>{
+    if (args.command !== 'help') {
+        return commandHelp[args.command];
+    }
+    const topic = getFlagString(args, 'topic') ?? args.positionals[0];
+    if (topic === 'keygen' || topic === 'install' || topic === 'manifest' || topic === 'plan' || topic === 'push' || topic === 'validate') {
+        return commandHelp[topic];
+    }
+    return helpText;
+};
+export const runCli = async (argv)=>{
+    try {
+        const parsed = parseCliArgs(argv);
+        if (!parsed.ok) {
+            return {
+                exitCode: 1,
+                stderr: `${parsed.error}\n`
+            };
+        }
+        if (parsed.args.command === 'help' || parsed.args.flags.help === true) {
+            return {
+                exitCode: 0,
+                stdout: getHelpForArgs(parsed.args)
+            };
+        }
+        if (parsed.args.command === 'keygen') {
+            return runKeygenCommand(parsed.args);
+        }
+        if (parsed.args.command === 'install') {
+            return runInstallCommand(parsed.args);
+        }
+        if (parsed.args.command === 'manifest') {
+            return runManifestCommand(parsed.args);
+        }
+        if (parsed.args.command === 'plan') {
+            return runPlanCommand(parsed.args);
+        }
+        if (parsed.args.command === 'push') {
+            return runPushCommand(parsed.args);
+        }
+        if (parsed.args.command === 'validate') {
+            return runValidateCommand(parsed.args);
+        }
+        return {
+            exitCode: 1,
+            stderr: 'Unknown command.\n'
+        };
+    } catch (error) {
+        return {
+            exitCode: 2,
+            stderr: error instanceof Error ? `${error.message}\n` : 'Unexpected internal error.\n'
+        };
+    }
+};
+const isCliEntrypoint = ()=>{
+    if (!process.argv[1]) {
+        return false;
+    }
+    return fileURLToPath(import.meta.url) === path.resolve(process.argv[1]);
+};
+if (isCliEntrypoint()) {
+    const result = await runCli(process.argv.slice(2));
+    if (result.stdout) {
+        process.stdout.write(result.stdout);
+    }
+    if (result.stderr) {
+        process.stderr.write(result.stderr);
+    }
+    process.exitCode = result.exitCode;
+}
+
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nimport type { CliCommandName, CliResult, ParsedCliArgs } from './types.js'\n\nimport { runInstallCommand } from './commands/install.js'\nimport { runKeygenCommand } from './commands/keygen.js'\nimport { runManifestCommand } from './commands/manifest.js'\nimport { runPlanCommand } from './commands/plan.js'\nimport { runPushCommand } from './commands/push.js'\nimport { runValidateCommand } from './commands/validate.js'\nimport { getFlagString, parseCliArgs } from './parseArgs.js'\n\nconst helpText = `payload-markdown-docs\n\nUsage:\n  payload-markdown-docs validate <docs-root> [options]\n  payload-markdown-docs manifest <docs-root> [options]\n  payload-markdown-docs plan <docs-root> [options]\n  payload-markdown-docs push <docs-root> [options]\n  payload-markdown-docs keygen [options]\n  payload-markdown-docs install skill --codex [options]\n\nCommands:\n  validate   Validate a local Markdown docs directory.\n  manifest   Print a JSON docs manifest for a local Markdown docs directory.\n  plan       Build a dry sync plan against optional existing docs records.\n  push       Sign and upload a docs manifest to a Payload sync endpoint.\n  keygen     Generate Ed25519 keys for signed sync.\n  install    Install local AI-agent guidance for docs maintenance.\n`\n\nconst commandHelp: Record<Exclude<CliCommandName, 'help'>, string> = {\n  install: `payload-markdown-docs install skill --codex\n\nAliases:\n  payload-markdown-docs install ai-skill --codex\n  payload-markdown-docs install skill --agent codex\n\nOptions:\n  --codex                         Install the Codex skill pack.\n  --agent <codex>                 Agent target. Currently only codex.\n  --out <path>                    Output directory. Defaults to .agents/skills/payload-markdown-docs.\n  --docs-root <path>              Docs root to mention in installed guidance. Defaults to ./docs.\n  --package-manager <name>        pnpm, npm, yarn, or bun. Auto-detected when omitted.\n  --force                         Overwrite existing skill files.\n  --dry-run                       Print planned files without writing.\n  --help                          Show this help.\n\nInstalls local AI-agent guidance only. It does not sync docs, call Payload, or run package manager commands.\n`,\n  keygen: `payload-markdown-docs keygen\n\nOptions:\n  --format <pem|base64>  Output key format. Defaults to pem.\n  --out <dir>            Write docs-sync-public.pem and docs-sync-private.pem.\n  --force                Overwrite existing key files when used with --out.\n  --help                 Show this help.\n`,\n  manifest: `payload-markdown-docs manifest <docs-root>\n\nOptions:\n  --source <id>              Manifest source id. Defaults to local-docs.\n  --root <path>              Manifest source root label.\n  --route-base <route>       Route base for validation. Defaults to /docs.\n  --repository <repo>        Source repository metadata.\n  --branch <branch>          Source branch metadata.\n  --commit <sha>             Source commit metadata.\n  --pretty                   Pretty-print JSON.\n  --max-files <number>       Maximum file count.\n  --max-file-bytes <number>  Maximum single file size.\n  --max-total-bytes <number> Maximum total Markdown bytes.\n  --help                     Show this help.\n`,\n  plan: `payload-markdown-docs plan <docs-root>\n\nOptions:\n  --existing <path>          JSON array of existing docs records.\n  --delete-behavior <value>  archive, delete, draft, or ignore.\n  --json                     Print full plan JSON.\n  --pretty                   Pretty-print JSON output.\n  --source <id>              Manifest source id. Defaults to local-docs.\n  --root <path>              Manifest source root label.\n  --route-base <route>       Route base for validation. Defaults to /docs.\n  --repository <repo>        Source repository metadata.\n  --branch <branch>          Source branch metadata.\n  --commit <sha>             Source commit metadata.\n  --max-files <number>       Maximum file count.\n  --max-file-bytes <number>  Maximum single file size.\n  --max-total-bytes <number> Maximum total Markdown bytes.\n  --help                     Show this help.\n`,\n  push: `payload-markdown-docs push <docs-root>\n\nOptions:\n  --endpoint <url>           Full Payload sync endpoint URL.\n  --key-id <id>              Server-configured Ed25519 key id.\n  --private-key-file <path>  PEM private key file from keygen.\n  --private-key-env <name>   Environment variable containing the private key.\n  --github-oidc              Use GitHub Actions OIDC bearer auth instead of Ed25519.\n  --oidc-audience <value>    GitHub OIDC audience. Defaults to payload-markdown-docs.\n  --oidc-token-env <name>    Environment variable containing an already-fetched OIDC token.\n  --dry-run                  Upload as dry-run mode. This is the default.\n  --sync                     Upload as sync mode. Requires server sync.allowWrites.\n  --publish                  Request published output. Server must allow publishing.\n  --delete-behavior <value>  archive, delete, draft, or ignore. Defaults to archive.\n  --json                     Print structured JSON output.\n  --pretty                   Pretty-print JSON output with --json.\n  --source <id>              Manifest source id. Defaults to local-docs.\n  --root <path>              Manifest source root label.\n  --route-base <route>       Route base for local validation. Defaults to /docs.\n  --repository <repo>        Source repository metadata.\n  --branch <branch>          Source branch metadata.\n  --commit <sha>             Source commit metadata.\n  --max-files <number>       Maximum file count.\n  --max-file-bytes <number>  Maximum single file size.\n  --max-total-bytes <number> Maximum total Markdown bytes.\n  --help                     Show this help.\n\nExamples:\n  Ed25519:\n    payload-markdown-docs push ./docs --endpoint \"$DOCS_SYNC_ENDPOINT\" --source main-docs --key-id github-actions-main --private-key-env DOCS_SYNC_PRIVATE_KEY --sync\n\n  GitHub OIDC:\n    payload-markdown-docs push ./docs --endpoint \"$DOCS_SYNC_ENDPOINT\" --source main-docs --github-oidc --oidc-audience payload-markdown-docs --sync\n\nGitHub OIDC requires workflow permissions: id-token: write and contents: read.\nHard delete requires explicit server sync.allowHardDelete. Existing collection and block targets are not supported yet.\n`,\n  validate: `payload-markdown-docs validate <docs-root>\n\nOptions:\n  --json                     Print validation JSON.\n  --pretty                   Pretty-print JSON output.\n  --source <id>              Manifest source id. Defaults to local-docs.\n  --root <path>              Manifest source root label.\n  --route-base <route>       Route base for validation. Defaults to /docs.\n  --repository <repo>        Source repository metadata.\n  --branch <branch>          Source branch metadata.\n  --commit <sha>             Source commit metadata.\n  --max-files <number>       Maximum file count.\n  --max-file-bytes <number>  Maximum single file size.\n  --max-total-bytes <number> Maximum total Markdown bytes.\n  --help                     Show this help.\n`,\n}\n\nconst getHelpForArgs = (args: ParsedCliArgs): string => {\n  if (args.command !== 'help') {\n    return commandHelp[args.command]\n  }\n\n  const topic = getFlagString(args, 'topic') ?? args.positionals[0]\n\n  if (\n    topic === 'keygen' ||\n    topic === 'install' ||\n    topic === 'manifest' ||\n    topic === 'plan' ||\n    topic === 'push' ||\n    topic === 'validate'\n  ) {\n    return commandHelp[topic]\n  }\n\n  return helpText\n}\n\nexport const runCli = async (argv: string[]): Promise<CliResult> => {\n  try {\n    const parsed = parseCliArgs(argv)\n\n    if (!parsed.ok) {\n      return {\n        exitCode: 1,\n        stderr: `${parsed.error}\\n`,\n      }\n    }\n\n    if (parsed.args.command === 'help' || parsed.args.flags.help === true) {\n      return {\n        exitCode: 0,\n        stdout: getHelpForArgs(parsed.args),\n      }\n    }\n\n    if (parsed.args.command === 'keygen') {\n      return runKeygenCommand(parsed.args)\n    }\n\n    if (parsed.args.command === 'install') {\n      return runInstallCommand(parsed.args)\n    }\n\n    if (parsed.args.command === 'manifest') {\n      return runManifestCommand(parsed.args)\n    }\n\n    if (parsed.args.command === 'plan') {\n      return runPlanCommand(parsed.args)\n    }\n\n    if (parsed.args.command === 'push') {\n      return runPushCommand(parsed.args)\n    }\n\n    if (parsed.args.command === 'validate') {\n      return runValidateCommand(parsed.args)\n    }\n\n    return {\n      exitCode: 1,\n      stderr: 'Unknown command.\\n',\n    }\n  } catch (error) {\n    return {\n      exitCode: 2,\n      stderr: error instanceof Error ? `${error.message}\\n` : 'Unexpected internal error.\\n',\n    }\n  }\n}\n\nconst isCliEntrypoint = (): boolean => {\n  if (!process.argv[1]) {\n    return false\n  }\n\n  return fileURLToPath(import.meta.url) === path.resolve(process.argv[1])\n}\n\nif (isCliEntrypoint()) {\n  const result = await runCli(process.argv.slice(2))\n\n  if (result.stdout) {\n    process.stdout.write(result.stdout)\n  }\n\n  if (result.stderr) {\n    process.stderr.write(result.stderr)\n  }\n\n  process.exitCode = result.exitCode\n}\n"],"names":["path","fileURLToPath","runInstallCommand","runKeygenCommand","runManifestCommand","runPlanCommand","runPushCommand","runValidateCommand","getFlagString","parseCliArgs","helpText","commandHelp","install","keygen","manifest","plan","push","validate","getHelpForArgs","args","command","topic","positionals","runCli","argv","parsed","ok","exitCode","stderr","error","flags","help","stdout","Error","message","isCliEntrypoint","process","url","resolve","result","slice","write"],"mappings":"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"}

package/dist/cli/parseArgs.d.ts

@@ -0,0 +1,5 @@
+import type { CliParseResult, CliResult, ParsedCliArgs } from './types.js';
+export declare const parseCliArgs: (argv: string[]) => CliParseResult;
+export declare const getFlagString: (args: ParsedCliArgs, name: string) => string | undefined;
+export declare const getFlagBoolean: (args: ParsedCliArgs, name: string) => boolean;
+export declare const parseIntegerFlag: (args: ParsedCliArgs, name: string) => CliResult | number | undefined;

package/dist/cli/parseArgs.js

@@ -0,0 +1,219 @@
+const commands = new Set([
+    'help',
+    'install',
+    'keygen',
+    'manifest',
+    'plan',
+    'push',
+    'validate'
+]);
+const docsValueFlags = new Set([
+    'branch',
+    'commit',
+    'max-file-bytes',
+    'max-files',
+    'max-total-bytes',
+    'repository',
+    'root',
+    'route-base',
+    'source'
+]);
+const docsBooleanFlags = new Set([
+    'help',
+    'json',
+    'pretty'
+]);
+const planValueFlags = new Set([
+    'delete-behavior',
+    'existing',
+    ...docsValueFlags
+]);
+const pushValueFlags = new Set([
+    'delete-behavior',
+    'endpoint',
+    'key-id',
+    'oidc-audience',
+    'oidc-token-env',
+    'private-key-env',
+    'private-key-file',
+    ...docsValueFlags
+]);
+const pushBooleanFlags = new Set([
+    'dry-run',
+    'github-oidc',
+    'help',
+    'json',
+    'pretty',
+    'publish',
+    'sync'
+]);
+const installValueFlags = new Set([
+    'agent',
+    'docs-root',
+    'out',
+    'package-manager'
+]);
+const installBooleanFlags = new Set([
+    'codex',
+    'dry-run',
+    'force',
+    'help'
+]);
+const keygenValueFlags = new Set([
+    'format',
+    'out'
+]);
+const keygenBooleanFlags = new Set([
+    'force',
+    'help'
+]);
+const knownCommand = (command)=>commands.has(command);
+const normalizeFlagName = (input)=>input.slice(2);
+const allowedFlagsForCommand = (command)=>{
+    if (command === 'keygen') {
+        return {
+            boolean: keygenBooleanFlags,
+            value: keygenValueFlags
+        };
+    }
+    if (command === 'install') {
+        return {
+            boolean: installBooleanFlags,
+            value: installValueFlags
+        };
+    }
+    if (command === 'plan') {
+        return {
+            boolean: docsBooleanFlags,
+            value: planValueFlags
+        };
+    }
+    if (command === 'push') {
+        return {
+            boolean: pushBooleanFlags,
+            value: pushValueFlags
+        };
+    }
+    if (command === 'manifest' || command === 'validate') {
+        return {
+            boolean: docsBooleanFlags,
+            value: docsValueFlags
+        };
+    }
+    return {
+        boolean: new Set([
+            'help'
+        ]),
+        value: new Set()
+    };
+};
+export const parseCliArgs = (argv)=>{
+    if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {
+        return {
+            args: {
+                command: 'help',
+                flags: {
+                    help: true
+                },
+                positionals: []
+            },
+            ok: true
+        };
+    }
+    const [rawCommand, ...rest] = argv;
+    if (!rawCommand || rawCommand.startsWith('-')) {
+        return {
+            error: 'Missing command. Run payload-markdown-docs --help.',
+            ok: false
+        };
+    }
+    if (!knownCommand(rawCommand)) {
+        return {
+            error: `Unknown command "${rawCommand}". Run payload-markdown-docs --help.`,
+            ok: false
+        };
+    }
+    if (rawCommand === 'help') {
+        const [topic] = rest;
+        if (topic && !knownCommand(topic)) {
+            return {
+                error: `Unknown help topic "${topic}".`,
+                ok: false
+            };
+        }
+        return {
+            args: {
+                command: 'help',
+                flags: topic ? {
+                    topic
+                } : {},
+                positionals: topic ? [
+                    topic
+                ] : []
+            },
+            ok: true
+        };
+    }
+    const allowedFlags = allowedFlagsForCommand(rawCommand);
+    const flags = {};
+    const positionals = [];
+    for(let index = 0; index < rest.length; index += 1){
+        const token = rest[index];
+        if (!token) {
+            continue;
+        }
+        if (!token.startsWith('--')) {
+            positionals.push(token);
+            continue;
+        }
+        const flagName = normalizeFlagName(token);
+        if (allowedFlags.boolean.has(flagName)) {
+            flags[flagName] = true;
+            continue;
+        }
+        if (!allowedFlags.value.has(flagName)) {
+            return {
+                error: `Unknown flag "--${flagName}" for ${rawCommand}.`,
+                ok: false
+            };
+        }
+        const value = rest[index + 1];
+        if (!value || value.startsWith('--')) {
+            return {
+                error: `Flag "--${flagName}" requires a value.`,
+                ok: false
+            };
+        }
+        flags[flagName] = value;
+        index += 1;
+    }
+    return {
+        args: {
+            command: rawCommand,
+            flags,
+            positionals
+        },
+        ok: true
+    };
+};
+export const getFlagString = (args, name)=>{
+    const value = args.flags[name];
+    return typeof value === 'string' ? value : undefined;
+};
+export const getFlagBoolean = (args, name)=>args.flags[name] === true;
+export const parseIntegerFlag = (args, name)=>{
+    const value = getFlagString(args, name);
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 0) {
+        return {
+            exitCode: 1,
+            stderr: `Flag "--${name}" must be a non-negative integer.\n`
+        };
+    }
+    return parsed;
+};
+
+//# sourceMappingURL=parseArgs.js.map

package/dist/cli/parseArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/parseArgs.ts"],"sourcesContent":["import type {\n  CliCommandName,\n  CliFlagValue,\n  CliParseResult,\n  CliResult,\n  ParsedCliArgs,\n} from './types.js'\n\nconst commands = new Set<CliCommandName>([\n  'help',\n  'install',\n  'keygen',\n  'manifest',\n  'plan',\n  'push',\n  'validate',\n])\n\nconst docsValueFlags = new Set([\n  'branch',\n  'commit',\n  'max-file-bytes',\n  'max-files',\n  'max-total-bytes',\n  'repository',\n  'root',\n  'route-base',\n  'source',\n])\n\nconst docsBooleanFlags = new Set(['help', 'json', 'pretty'])\nconst planValueFlags = new Set(['delete-behavior', 'existing', ...docsValueFlags])\nconst pushValueFlags = new Set([\n  'delete-behavior',\n  'endpoint',\n  'key-id',\n  'oidc-audience',\n  'oidc-token-env',\n  'private-key-env',\n  'private-key-file',\n  ...docsValueFlags,\n])\nconst pushBooleanFlags = new Set([\n  'dry-run',\n  'github-oidc',\n  'help',\n  'json',\n  'pretty',\n  'publish',\n  'sync',\n])\nconst installValueFlags = new Set([\n  'agent',\n  'docs-root',\n  'out',\n  'package-manager',\n])\nconst installBooleanFlags = new Set(['codex', 'dry-run', 'force', 'help'])\nconst keygenValueFlags = new Set(['format', 'out'])\nconst keygenBooleanFlags = new Set(['force', 'help'])\n\nconst knownCommand = (command: string): command is CliCommandName =>\n  commands.has(command as CliCommandName)\n\nconst normalizeFlagName = (input: string): string => input.slice(2)\n\nconst allowedFlagsForCommand = (\n  command: CliCommandName,\n): {\n  boolean: Set<string>\n  value: Set<string>\n} => {\n  if (command === 'keygen') {\n    return {\n      boolean: keygenBooleanFlags,\n      value: keygenValueFlags,\n    }\n  }\n\n  if (command === 'install') {\n    return {\n      boolean: installBooleanFlags,\n      value: installValueFlags,\n    }\n  }\n\n  if (command === 'plan') {\n    return {\n      boolean: docsBooleanFlags,\n      value: planValueFlags,\n    }\n  }\n\n  if (command === 'push') {\n    return {\n      boolean: pushBooleanFlags,\n      value: pushValueFlags,\n    }\n  }\n\n  if (command === 'manifest' || command === 'validate') {\n    return {\n      boolean: docsBooleanFlags,\n      value: docsValueFlags,\n    }\n  }\n\n  return {\n    boolean: new Set(['help']),\n    value: new Set(),\n  }\n}\n\nexport const parseCliArgs = (argv: string[]): CliParseResult => {\n  if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {\n    return {\n      args: {\n        command: 'help',\n        flags: {\n          help: true,\n        },\n        positionals: [],\n      },\n      ok: true,\n    }\n  }\n\n  const [rawCommand, ...rest] = argv\n\n  if (!rawCommand || rawCommand.startsWith('-')) {\n    return {\n      error: 'Missing command. Run payload-markdown-docs --help.',\n      ok: false,\n    }\n  }\n\n  if (!knownCommand(rawCommand)) {\n    return {\n      error: `Unknown command \"${rawCommand}\". Run payload-markdown-docs --help.`,\n      ok: false,\n    }\n  }\n\n  if (rawCommand === 'help') {\n    const [topic] = rest\n\n    if (topic && !knownCommand(topic)) {\n      return {\n        error: `Unknown help topic \"${topic}\".`,\n        ok: false,\n      }\n    }\n\n    return {\n      args: {\n        command: 'help',\n        flags: topic ? { topic } : {},\n        positionals: topic ? [topic] : [],\n      },\n      ok: true,\n    }\n  }\n\n  const allowedFlags = allowedFlagsForCommand(rawCommand)\n  const flags: Record<string, CliFlagValue> = {}\n  const positionals: string[] = []\n\n  for (let index = 0; index < rest.length; index += 1) {\n    const token = rest[index]\n\n    if (!token) {\n      continue\n    }\n\n    if (!token.startsWith('--')) {\n      positionals.push(token)\n      continue\n    }\n\n    const flagName = normalizeFlagName(token)\n\n    if (allowedFlags.boolean.has(flagName)) {\n      flags[flagName] = true\n      continue\n    }\n\n    if (!allowedFlags.value.has(flagName)) {\n      return {\n        error: `Unknown flag \"--${flagName}\" for ${rawCommand}.`,\n        ok: false,\n      }\n    }\n\n    const value = rest[index + 1]\n\n    if (!value || value.startsWith('--')) {\n      return {\n        error: `Flag \"--${flagName}\" requires a value.`,\n        ok: false,\n      }\n    }\n\n    flags[flagName] = value\n    index += 1\n  }\n\n  return {\n    args: {\n      command: rawCommand,\n      flags,\n      positionals,\n    },\n    ok: true,\n  }\n}\n\nexport const getFlagString = (\n  args: ParsedCliArgs,\n  name: string,\n): string | undefined => {\n  const value = args.flags[name]\n\n  return typeof value === 'string' ? value : undefined\n}\n\nexport const getFlagBoolean = (args: ParsedCliArgs, name: string): boolean =>\n  args.flags[name] === true\n\nexport const parseIntegerFlag = (\n  args: ParsedCliArgs,\n  name: string,\n): CliResult | number | undefined => {\n  const value = getFlagString(args, name)\n\n  if (value === undefined) {\n    return undefined\n  }\n\n  const parsed = Number(value)\n\n  if (!Number.isInteger(parsed) || parsed < 0) {\n    return {\n      exitCode: 1,\n      stderr: `Flag \"--${name}\" must be a non-negative integer.\\n`,\n    }\n  }\n\n  return parsed\n}\n"],"names":["commands","Set","docsValueFlags","docsBooleanFlags","planValueFlags","pushValueFlags","pushBooleanFlags","installValueFlags","installBooleanFlags","keygenValueFlags","keygenBooleanFlags","knownCommand","command","has","normalizeFlagName","input","slice","allowedFlagsForCommand","boolean","value","parseCliArgs","argv","length","args","flags","help","positionals","ok","rawCommand","rest","startsWith","error","topic","allowedFlags","index","token","push","flagName","getFlagString","name","undefined","getFlagBoolean","parseIntegerFlag","parsed","Number","isInteger","exitCode","stderr"],"mappings":"AAQA,MAAMA,WAAW,IAAIC,IAAoB;IACvC;IACA;IACA;IACA;IACA;IACA;IACA;CACD;AAED,MAAMC,iBAAiB,IAAID,IAAI;IAC7B;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD;AAED,MAAME,mBAAmB,IAAIF,IAAI;IAAC;IAAQ;IAAQ;CAAS;AAC3D,MAAMG,iBAAiB,IAAIH,IAAI;IAAC;IAAmB;OAAeC;CAAe;AACjF,MAAMG,iBAAiB,IAAIJ,IAAI;IAC7B;IACA;IACA;IACA;IACA;IACA;IACA;OACGC;CACJ;AACD,MAAMI,mBAAmB,IAAIL,IAAI;IAC/B;IACA;IACA;IACA;IACA;IACA;IACA;CACD;AACD,MAAMM,oBAAoB,IAAIN,IAAI;IAChC;IACA;IACA;IACA;CACD;AACD,MAAMO,sBAAsB,IAAIP,IAAI;IAAC;IAAS;IAAW;IAAS;CAAO;AACzE,MAAMQ,mBAAmB,IAAIR,IAAI;IAAC;IAAU;CAAM;AAClD,MAAMS,qBAAqB,IAAIT,IAAI;IAAC;IAAS;CAAO;AAEpD,MAAMU,eAAe,CAACC,UACpBZ,SAASa,GAAG,CAACD;AAEf,MAAME,oBAAoB,CAACC,QAA0BA,MAAMC,KAAK,CAAC;AAEjE,MAAMC,yBAAyB,CAC7BL;IAKA,IAAIA,YAAY,UAAU;QACxB,OAAO;YACLM,SAASR;YACTS,OAAOV;QACT;IACF;IAEA,IAAIG,YAAY,WAAW;QACzB,OAAO;YACLM,SAASV;YACTW,OAAOZ;QACT;IACF;IAEA,IAAIK,YAAY,QAAQ;QACtB,OAAO;YACLM,SAASf;YACTgB,OAAOf;QACT;IACF;IAEA,IAAIQ,YAAY,QAAQ;QACtB,OAAO;YACLM,SAASZ;YACTa,OAAOd;QACT;IACF;IAEA,IAAIO,YAAY,cAAcA,YAAY,YAAY;QACpD,OAAO;YACLM,SAASf;YACTgB,OAAOjB;QACT;IACF;IAEA,OAAO;QACLgB,SAAS,IAAIjB,IAAI;YAAC;SAAO;QACzBkB,OAAO,IAAIlB;IACb;AACF;AAEA,OAAO,MAAMmB,eAAe,CAACC;IAC3B,IAAIA,KAAKC,MAAM,KAAK,KAAKD,IAAI,CAAC,EAAE,KAAK,YAAYA,IAAI,CAAC,EAAE,KAAK,MAAM;QACjE,OAAO;YACLE,MAAM;gBACJX,SAAS;gBACTY,OAAO;oBACLC,MAAM;gBACR;gBACAC,aAAa,EAAE;YACjB;YACAC,IAAI;QACN;IACF;IAEA,MAAM,CAACC,YAAY,GAAGC,KAAK,GAAGR;IAE9B,IAAI,CAACO,cAAcA,WAAWE,UAAU,CAAC,MAAM;QAC7C,OAAO;YACLC,OAAO;YACPJ,IAAI;QACN;IACF;IAEA,IAAI,CAAChB,aAAaiB,aAAa;QAC7B,OAAO;YACLG,OAAO,CAAC,iBAAiB,EAAEH,WAAW,oCAAoC,CAAC;YAC3ED,IAAI;QACN;IACF;IAEA,IAAIC,eAAe,QAAQ;QACzB,MAAM,CAACI,MAAM,GAAGH;QAEhB,IAAIG,SAAS,CAACrB,aAAaqB,QAAQ;YACjC,OAAO;gBACLD,OAAO,CAAC,oBAAoB,EAAEC,MAAM,EAAE,CAAC;gBACvCL,IAAI;YACN;QACF;QAEA,OAAO;YACLJ,MAAM;gBACJX,SAAS;gBACTY,OAAOQ,QAAQ;oBAAEA;gBAAM,IAAI,CAAC;gBAC5BN,aAAaM,QAAQ;oBAACA;iBAAM,GAAG,EAAE;YACnC;YACAL,IAAI;QACN;IACF;IAEA,MAAMM,eAAehB,uBAAuBW;IAC5C,MAAMJ,QAAsC,CAAC;IAC7C,MAAME,cAAwB,EAAE;IAEhC,IAAK,IAAIQ,QAAQ,GAAGA,QAAQL,KAAKP,MAAM,EAAEY,SAAS,EAAG;QACnD,MAAMC,QAAQN,IAAI,CAACK,MAAM;QAEzB,IAAI,CAACC,OAAO;YACV;QACF;QAEA,IAAI,CAACA,MAAML,UAAU,CAAC,OAAO;YAC3BJ,YAAYU,IAAI,CAACD;YACjB;QACF;QAEA,MAAME,WAAWvB,kBAAkBqB;QAEnC,IAAIF,aAAaf,OAAO,CAACL,GAAG,CAACwB,WAAW;YACtCb,KAAK,CAACa,SAAS,GAAG;YAClB;QACF;QAEA,IAAI,CAACJ,aAAad,KAAK,CAACN,GAAG,CAACwB,WAAW;YACrC,OAAO;gBACLN,OAAO,CAAC,gBAAgB,EAAEM,SAAS,MAAM,EAAET,WAAW,CAAC,CAAC;gBACxDD,IAAI;YACN;QACF;QAEA,MAAMR,QAAQU,IAAI,CAACK,QAAQ,EAAE;QAE7B,IAAI,CAACf,SAASA,MAAMW,UAAU,CAAC,OAAO;YACpC,OAAO;gBACLC,OAAO,CAAC,QAAQ,EAAEM,SAAS,mBAAmB,CAAC;gBAC/CV,IAAI;YACN;QACF;QAEAH,KAAK,CAACa,SAAS,GAAGlB;QAClBe,SAAS;IACX;IAEA,OAAO;QACLX,MAAM;YACJX,SAASgB;YACTJ;YACAE;QACF;QACAC,IAAI;IACN;AACF,EAAC;AAED,OAAO,MAAMW,gBAAgB,CAC3Bf,MACAgB;IAEA,MAAMpB,QAAQI,KAAKC,KAAK,CAACe,KAAK;IAE9B,OAAO,OAAOpB,UAAU,WAAWA,QAAQqB;AAC7C,EAAC;AAED,OAAO,MAAMC,iBAAiB,CAAClB,MAAqBgB,OAClDhB,KAAKC,KAAK,CAACe,KAAK,KAAK,KAAI;AAE3B,OAAO,MAAMG,mBAAmB,CAC9BnB,MACAgB;IAEA,MAAMpB,QAAQmB,cAAcf,MAAMgB;IAElC,IAAIpB,UAAUqB,WAAW;QACvB,OAAOA;IACT;IAEA,MAAMG,SAASC,OAAOzB;IAEtB,IAAI,CAACyB,OAAOC,SAAS,CAACF,WAAWA,SAAS,GAAG;QAC3C,OAAO;YACLG,UAAU;YACVC,QAAQ,CAAC,QAAQ,EAAER,KAAK,mCAAmC,CAAC;QAC9D;IACF;IAEA,OAAOI;AACT,EAAC"}

package/dist/cli/types.d.ts

@@ -0,0 +1,51 @@
+import type { DocsDeleteBehavior } from '../sync/index.js';
+export type CliCommandName = 'help' | 'install' | 'keygen' | 'manifest' | 'plan' | 'push' | 'validate';
+export type CliFlagValue = boolean | string;
+export type CliFlags = Record<string, CliFlagValue>;
+export type ParsedCliArgs = {
+    command: CliCommandName;
+    flags: CliFlags;
+    positionals: string[];
+};
+export type CliParseResult = {
+    args: ParsedCliArgs;
+    ok: true;
+} | {
+    error: string;
+    ok: false;
+};
+export type CliResult = {
+    exitCode: 0 | 1 | 2;
+    stderr?: string;
+    stdout?: string;
+};
+export type DocsCommandOptions = {
+    branch?: string;
+    commit?: string;
+    docsRoot: string;
+    maxFileBytes?: number;
+    maxFiles?: number;
+    maxTotalBytes?: number;
+    repository?: string;
+    routeBase?: string;
+    sourceId: string;
+    sourceRoot?: string;
+};
+export type PlanCommandOptions = {
+    deleteBehavior?: DocsDeleteBehavior;
+    existingPath?: string;
+} & DocsCommandOptions;
+export type PushCommandOptions = {
+    deleteBehavior?: DocsDeleteBehavior;
+    endpoint: string;
+    mode: 'dry-run' | 'sync';
+    publish: boolean;
+} & ({
+    authMode: 'ed25519';
+    keyId: string;
+    privateKey: string;
+} | {
+    authMode: 'github-oidc';
+    oidcAudience: string;
+    oidcTokenEnv?: string;
+}) & DocsCommandOptions;

package/dist/cli/types.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/types.ts"],"sourcesContent":["import type { DocsDeleteBehavior } from '../sync/index.js'\n\nexport type CliCommandName =\n  | 'help'\n  | 'install'\n  | 'keygen'\n  | 'manifest'\n  | 'plan'\n  | 'push'\n  | 'validate'\n\nexport type CliFlagValue = boolean | string\n\nexport type CliFlags = Record<string, CliFlagValue>\n\nexport type ParsedCliArgs = {\n  command: CliCommandName\n  flags: CliFlags\n  positionals: string[]\n}\n\nexport type CliParseResult =\n  | {\n      args: ParsedCliArgs\n      ok: true\n    }\n  | {\n      error: string\n      ok: false\n    }\n\nexport type CliResult = {\n  exitCode: 0 | 1 | 2\n  stderr?: string\n  stdout?: string\n}\n\nexport type DocsCommandOptions = {\n  branch?: string\n  commit?: string\n  docsRoot: string\n  maxFileBytes?: number\n  maxFiles?: number\n  maxTotalBytes?: number\n  repository?: string\n  routeBase?: string\n  sourceId: string\n  sourceRoot?: string\n}\n\nexport type PlanCommandOptions = {\n  deleteBehavior?: DocsDeleteBehavior\n  existingPath?: string\n} & DocsCommandOptions\n\nexport type PushCommandOptions = {\n  deleteBehavior?: DocsDeleteBehavior\n  endpoint: string\n  mode: 'dry-run' | 'sync'\n  publish: boolean\n} & (\n  | {\n      authMode: 'ed25519'\n      keyId: string\n      privateKey: string\n    }\n  | {\n      authMode: 'github-oidc'\n      oidcAudience: string\n      oidcTokenEnv?: string\n    }\n) &\n  DocsCommandOptions\n"],"names":[],"mappings":"AAuDA,WAiBoB"}

package/dist/collections/docs.d.ts

@@ -0,0 +1,9 @@
+import type { CollectionConfig } from 'payload';
+export type CreateDocsCollectionOptions = {
+    docsSetsCollectionSlug?: string;
+    enableDrafts?: boolean;
+    markdownFieldName: string;
+    slug: string;
+    syncRunsCollectionSlug?: string;
+};
+export declare const createDocsCollection: ({ slug, docsSetsCollectionSlug, enableDrafts, markdownFieldName, syncRunsCollectionSlug, }: CreateDocsCollectionOptions) => CollectionConfig;