@camunda8/cli 2.6.1 → 2.7.0-alpha.1

package/dist/command-registry.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Declarative command registry — single source of truth for all
+ * verb×resource combinations, their flags, constraints, and metadata.
+ *
+ * Consumers (help, completion, validation, dispatch) derive their
+ * data from this registry instead of maintaining separate copies.
+ */
+export interface FlagDef {
+    type: "string" | "boolean";
+    description: string;
+    short?: string;
+    required?: boolean;
+    /** SDK enum object for automatic validation (keys are valid values). */
+    enum?: Record<string, string>;
+    /** When true, flag value is comma-separated and each item is validated against enum. */
+    csv?: boolean;
+}
+export interface CommandDef {
+    description: string;
+    mutating: boolean;
+    /** When true, a positional resource argument is required after the verb. */
+    requiresResource: boolean;
+    /** Valid resource names (canonical short forms used in help). */
+    resources: string[];
+    /** Flags specific to this verb (beyond global flags). */
+    flags: Record<string, FlagDef>;
+    /** Verb aliases that dispatch to this command (e.g. "rm" → remove, "w" → watch). */
+    aliases?: string[];
+}
+/**
+ * Maps short/plural resource names to their canonical singular form.
+ * Used by the dispatch layer to normalize user input before lookup.
+ */
+export declare const RESOURCE_ALIASES: Record<string, string>;
+/**
+ * Flags accepted by every command (infrastructure/agent flags).
+ */
+export declare const GLOBAL_FLAGS: Record<string, FlagDef>;
+/**
+ * Flags shared across all search/list commands.
+ */
+export declare const SEARCH_FLAGS: Record<string, FlagDef>;
+export declare const COMMAND_REGISTRY: Record<string, CommandDef>;
+/**
+ * Maps each searchable resource (canonical name) to the set of flag names
+ * that are valid for that resource's search command. Used for unknown-flag
+ * detection in search commands.
+ */
+export declare const SEARCH_RESOURCE_FLAGS: Record<string, Set<string>>;
+/**
+ * Maps verb aliases to their canonical verb names.
+ * Built from COMMAND_REGISTRY aliases fields.
+ * e.g. { "rm": ["remove", "unload"], "w": ["watch"] }
+ */
+export declare const VERB_ALIASES: Record<string, string[]>;
+/**
+ * Resolve a resource alias to its canonical form.
+ * Returns the input unchanged if no alias exists.
+ */
+export declare function resolveAlias(resource: string): string;
+/**
+ * Look up a command definition by verb (resolves verb aliases).
+ * For alias verbs that map to multiple commands (e.g. "rm" → remove + unload),
+ * returns the first match. Use VERB_ALIASES directly for multi-target aliases.
+ */
+export declare function getCommandDef(verb: string): CommandDef | undefined;
+/**
+ * Get all flags accepted for a given verb, including global flags.
+ */
+export declare function getAcceptedFlags(verb: string): Record<string, FlagDef> | undefined;
+/**
+ * Get the set of resource-specific search flags for a given canonical resource.
+ */
+export declare function getSearchFlagsForResource(resource: string): Set<string> | undefined;
+/**
+ * Check whether a verb×resource combination is valid.
+ * Accepts both raw aliases and canonical resource names.
+ */
+export declare function isValidCommand(verb: string, resource: string): boolean;
+/**
+ * Derive parseArgs options from the registry. This produces the flat
+ * options object that node:util parseArgs expects, covering all flags
+ * from all commands plus global flags.
+ */
+export declare function deriveParseArgsOptions(): Record<string, {
+    type: "string" | "boolean";
+    short?: string;
+}>;
+//# sourceMappingURL=command-registry.d.ts.map

package/dist/command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,wFAAwF;IACxF,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iEAAiE;IACjE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAID;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBnD,CAAC;AAIF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAkBhD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAahD,CAAC;AA2NF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAoiBvD,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAa7D,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAW9C,CAAC;AAEL;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAKlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAIrC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,MAAM,GACd,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAEzB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWtE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAC/C,MAAM,EACN;IAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAC9C,CA6BA"}