@flowscripter/dynamic-cli-framework-api 1.4.0 → 1.5.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export type { default as Argument } from "./src/argument/Argument.ts";
-export type { ArgumentSingleValueType, ArgumentValues, ArgumentValueType, PopulatedArgumentSingleValueType, PopulatedArgumentValues, PopulatedArgumentValueType, } from "./src/argument/ArgumentValueTypes.ts";
-export { ArgumentValueTypeName, ComplexValueTypeName } from "./src/argument/ArgumentValueTypes.ts";
+export type { SingleValueType, Values, ValueType, ValueNode, PopulatedSingleValueType, PopulatedValues, PopulatedValueType, } from "./src/Value.ts";
+export { ValueTypeName, ComplexValueTypeName } from "./src/Value.ts";
 export type { default as ComplexOption } from "./src/argument/ComplexOption.ts";
 export { MAXIMUM_COMPLEX_OPTION_NESTING_DEPTH } from "./src/argument/ComplexOption.ts";
 export type { default as SubCommandArgument } from "./src/argument/SubCommandArgument.ts";
@@ -22,7 +22,8 @@ export type { default as AsciiBannerGeneratorService } from "./src/service/core/
 export type { BannerColorEffects, BannerGenerateOptions, ColorEffect, ColorEffectDirection, FixedColorEffect, GradientColorEffect, RainbowColorEffect, } from "./src/service/core/AsciiBannerGeneratorService.ts";
 export { KEY_VALUE_SERVICE_ID } from "./src/service/core/KeyValueService.ts";
 export { SECRET_SENTINEL_PREFIX } from "./src/service/core/KeyValueService.ts";
-export type { default as KeyValueService } from "./src/service/core/KeyValueService.ts";
+export { Secret } from "./src/service/core/KeyValueService.ts";
+export type { default as KeyValueService, SettableValueNode, } from "./src/service/core/KeyValueService.ts";
 export type { default as SecretService } from "./src/service/core/SecretService.ts";
 export { FETCH_SERVICE_ID } from "./src/service/core/FetchService.ts";
 export type { default as FetchService } from "./src/service/core/FetchService.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,10 +1,11 @@
-export { ArgumentValueTypeName, ComplexValueTypeName } from "./src/argument/ArgumentValueTypes.js";
+export { ValueTypeName, ComplexValueTypeName } from "./src/Value.js";
 export { MAXIMUM_COMPLEX_OPTION_NESTING_DEPTH } from "./src/argument/ComplexOption.js";
 export { MAXIMUM_ARGUMENT_ARRAY_SIZE } from "./src/argument/SubCommandArgument.js";
 // Core Service IDs and types
 export { ASCII_BANNER_GENERATOR_SERVICE_ID } from "./src/service/core/AsciiBannerGeneratorService.js";
 export { KEY_VALUE_SERVICE_ID } from "./src/service/core/KeyValueService.js";
 export { SECRET_SENTINEL_PREFIX } from "./src/service/core/KeyValueService.js";
+export { Secret } from "./src/service/core/KeyValueService.js";
 export { FETCH_SERVICE_ID } from "./src/service/core/FetchService.js";
 export { PRINTER_SERVICE_ID } from "./src/service/core/PrinterService.js";
 export { Icon, Level, ProgressStyle, SpinnerStyle } from "./src/service/core/PrinterService.js";

package/dist/src/ParseResult.d.ts

@@ -1,6 +1,6 @@
 import type Command from "./command/Command.ts";
 import type GroupCommand from "./command/GroupCommand.ts";
-import type { PopulatedArgumentSingleValueType, PopulatedArgumentValues } from "./argument/ArgumentValueTypes.ts";
+import type { PopulatedSingleValueType, PopulatedValues } from "./Value.ts";
 import type { InvalidArgument } from "./RunResult.ts";
 /**
  * A container holding the result of a command clause parsing operation.
@@ -17,10 +17,10 @@ export interface ParseResult {
     /**
      * The argument values populated from the command line args. If the parse result is valid
      * (i.e. {@link invalidArguments} is empty), this can be used to execute the specified {@link command}.
-     * {@link PopulatedArgumentSingleValueType} is for {@link GlobalCommand} values, {@link PopulatedArgumentValues} is for
+     * {@link PopulatedSingleValueType} is for {@link GlobalCommand} values, {@link PopulatedValues} is for
      * {@link SubCommand} values.
      */
-    readonly populatedArgumentValues: PopulatedArgumentValues | PopulatedArgumentSingleValueType;
+    readonly populatedArgumentValues: PopulatedValues | PopulatedSingleValueType;
     /**
      * Any arguments which were invalid.
      */

package/dist/src/ParseResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParseResult.d.ts","sourceRoot":"","sources":["../../src/ParseResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,YAAY,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EACV,gCAAgC,EAChC,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IAErC;;;;;OAKG;IACH,QAAQ,CAAC,uBAAuB,EAAE,uBAAuB,GAAG,gCAAgC,CAAC;IAE7F;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAE1D;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC5C"}
+{"version":3,"file":"ParseResult.d.ts","sourceRoot":"","sources":["../../src/ParseResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,YAAY,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IAErC;;;;;OAKG;IACH,QAAQ,CAAC,uBAAuB,EAAE,eAAe,GAAG,wBAAwB,CAAC;IAE7E;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAE1D;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC5C"}

package/dist/src/RunResult.d.ts

@@ -4,7 +4,7 @@
 import type Command from "./command/Command.ts";
 import type Argument from "./argument/Argument.ts";
 import type ComplexOption from "./argument/ComplexOption.ts";
-import type { PopulatedArgumentValues, PopulatedArgumentValueType } from "./argument/ArgumentValueTypes.ts";
+import type { PopulatedValues, PopulatedValueType } from "./Value.ts";
 export declare enum RunState {
     /**
      * Arguments were successfully parsed and the specified command(s) were successfully executed.
@@ -97,7 +97,7 @@ export interface InvalidArgument {
      *
      * NOTE: This value is unlikely to be valid as it is the cause of the invalid argument error.
      */
-    readonly value?: PopulatedArgumentValues | PopulatedArgumentValueType | Array<PopulatedArgumentValues | PopulatedArgumentValueType>;
+    readonly value?: PopulatedValues | PopulatedValueType | Array<PopulatedValues | PopulatedValueType>;
     /**
      * An optional message providing detail about the validation failure.
      * Populated when {@link reason} is {@link InvalidArgumentReason.CUSTOM_VALIDATION}.

package/dist/src/RunResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RunResult.d.ts","sourceRoot":"","sources":["../../src/RunResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,aAAa,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EACV,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,kCAAkC,CAAC;AAE1C,oBAAY,QAAQ;IAClB;;OAEG;IACH,OAAO,IAAI;IAEX;;OAEG;IACH,WAAW,IAAI;IAEf;;OAEG;IACH,UAAU,IAAI;IAEd;;OAEG;IACH,eAAe,IAAI;IAEnB;;OAEG;IACH,aAAa,IAAI;IAEjB;;OAEG;IACH,WAAW,MAAM;CAClB;AAED;;GAEG;AACH,oBAAY,qBAAqB;IAC/B;;OAEG;IACH,aAAa,IAAI;IAEjB;;OAEG;IACH,oBAAoB,IAAI;IAExB;;OAEG;IACH,uBAAuB,IAAI;IAE3B;;OAEG;IACH,aAAa,IAAI;IAEjB;;OAEG;IACH,oBAAoB,IAAI;IAExB;;OAEG;IACH,gBAAgB,IAAI;IAEpB;;OAEG;IACH,sBAAsB,IAAI;IAE1B;;OAEG;IACH,mBAAmB,IAAI;IAEvB;;OAEG;IACH,iBAAiB,IAAI;IAErB;;OAEG;IACH,iBAAiB,IAAI;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EACX,uBAAuB,GACvB,0BAA0B,GAC1B,KAAK,CAAC,uBAAuB,GAAG,0BAA0B,CAAC,CAAC;IAEhE;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,SAAS;IAChC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB"}
+{"version":3,"file":"RunResult.d.ts","sourceRoot":"","sources":["../../src/RunResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,aAAa,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEtE,oBAAY,QAAQ;IAClB;;OAEG;IACH,OAAO,IAAI;IAEX;;OAEG;IACH,WAAW,IAAI;IAEf;;OAEG;IACH,UAAU,IAAI;IAEd;;OAEG;IACH,eAAe,IAAI;IAEnB;;OAEG;IACH,aAAa,IAAI;IAEjB;;OAEG;IACH,WAAW,MAAM;CAClB;AAED;;GAEG;AACH,oBAAY,qBAAqB;IAC/B;;OAEG;IACH,aAAa,IAAI;IAEjB;;OAEG;IACH,oBAAoB,IAAI;IAExB;;OAEG;IACH,uBAAuB,IAAI;IAE3B;;OAEG;IACH,aAAa,IAAI;IAEjB;;OAEG;IACH,oBAAoB,IAAI;IAExB;;OAEG;IACH,gBAAgB,IAAI;IAEpB;;OAEG;IACH,sBAAsB,IAAI;IAE1B;;OAEG;IACH,mBAAmB,IAAI;IAEvB;;OAEG;IACH,iBAAiB,IAAI;IAErB;;OAEG;IACH,iBAAiB,IAAI;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EACX,eAAe,GACf,kBAAkB,GAClB,KAAK,CAAC,eAAe,GAAG,kBAAkB,CAAC,CAAC;IAEhD;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,SAAS;IAChC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB"}

package/dist/src/Value.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Value shapes and type names shared by argument parsing and other framework features (e.g.
+ * `KeyValueService`) that need to represent an arbitrary JSON-ish value.
+ */
+/**
+ * Enum of possible value types.
+ */
+export declare enum ValueTypeName {
+    STRING = 0,
+    NUMBER = 1,
+    INTEGER = 2,
+    BOOLEAN = 3,
+    SECRET = 4
+}
+/**
+ * Only possible value for {@link ComplexOption.type}.
+ */
+export declare enum ComplexValueTypeName {
+    COMPLEX = 5
+}
+/**
+ * The type of a single value which is supported.
+ *
+ * NOTE: JavaScript does not have a special runtime value for INTEGER so this is covered by `number`.
+ * NOTE: `string` is also used for PASSWORD and SECRET values.
+ */
+export type SingleValueType = number | string | boolean;
+/**
+ * The type of a value can be: `boolean`, `number` or `string` or an array of these.
+ */
+export type ValueType = SingleValueType | Array<SingleValueType>;
+/**
+ * Any node that can appear within a {@link Values} tree: a primitive/array-of-primitives
+ * ({@link ValueType}), a nested keyed object ({@link Values}), or an array of such objects.
+ */
+export type ValueNode = ValueType | Values | Array<Values>;
+/**
+ * A container object for populated values.
+ *
+ * The following are all valid examples:
+ *
+ * * `{ }`
+ * * `{ foo: 1 }`
+ * * `{ foo: true }`
+ * * `{ foo: 'bar' }`
+ * * `{ foo: [ 1, 2 ] }`
+ * * `{ foo: [ true, true ] }`
+ * * `{ foo: [ 'bar', 'gar' ] }`
+ * * `{ foo: { a: 1 } }`
+ * * `{ foo: { a: { b: 'c'} } }`
+ * * `{ foo: [ { a: { b: 'c'} }, { a: { b: 'c'} } ] }`
+ *
+ * An array of arrays is not allowed, so the following is an INVALID example:
+ *
+ * * `{ foo: [ [ 1, 2 ], [3, 4 ] ] }`
+ */
+export type Values = {
+    [name: string]: ValueNode;
+};
+/**
+ * Populated single value type is very similar to {@link SingleValueType} but allows for an illegal
+ * undefined value.
+ */
+export type PopulatedSingleValueType = SingleValueType | undefined;
+/**
+ * Populated value types are very similar to {@link ValueType} but allow for illegal
+ * undefined values.
+ */
+export type PopulatedValueType = PopulatedSingleValueType | Array<PopulatedSingleValueType>;
+/**
+ * Populated values are very similar to {@link Values} but allow for illegal
+ * undefined properties and array entries.
+ */
+export interface PopulatedValues {
+    [name: string]: PopulatedValueType | PopulatedValues | Array<PopulatedValues | undefined> | undefined;
+}
+//# sourceMappingURL=Value.d.ts.map

package/dist/src/Value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Value.d.ts","sourceRoot":"","sources":["../../src/Value.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,aAAa;IACvB,MAAM,IAAI;IACV,MAAM,IAAI;IACV,OAAO,IAAI;IACX,OAAO,IAAI;IACX,MAAM,IAAI;CACX;AAED;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,OAAO,IAAI;CACZ;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,eAAe,GAAG,SAAS,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG,KAAK,CAAC,wBAAwB,CAAC,CAAC;AAE5F;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,IAAI,EAAE,MAAM,GACT,kBAAkB,GAClB,eAAe,GACf,KAAK,CAAC,eAAe,GAAG,SAAS,CAAC,GAClC,SAAS,CAAC;CACf"}

package/dist/src/Value.js

@@ -0,0 +1,22 @@
+/**
+ * Value shapes and type names shared by argument parsing and other framework features (e.g.
+ * `KeyValueService`) that need to represent an arbitrary JSON-ish value.
+ */
+/**
+ * Enum of possible value types.
+ */
+export var ValueTypeName;
+(function (ValueTypeName) {
+    ValueTypeName[ValueTypeName["STRING"] = 0] = "STRING";
+    ValueTypeName[ValueTypeName["NUMBER"] = 1] = "NUMBER";
+    ValueTypeName[ValueTypeName["INTEGER"] = 2] = "INTEGER";
+    ValueTypeName[ValueTypeName["BOOLEAN"] = 3] = "BOOLEAN";
+    ValueTypeName[ValueTypeName["SECRET"] = 4] = "SECRET";
+})(ValueTypeName || (ValueTypeName = {}));
+/**
+ * Only possible value for {@link ComplexOption.type}.
+ */
+export var ComplexValueTypeName;
+(function (ComplexValueTypeName) {
+    ComplexValueTypeName[ComplexValueTypeName["COMPLEX"] = 5] = "COMPLEX";
+})(ComplexValueTypeName || (ComplexValueTypeName = {}));

package/dist/src/argument/Argument.d.ts

@@ -1,4 +1,4 @@
-import type { ArgumentSingleValueType, ArgumentValues, ArgumentValueType, ArgumentValueTypeName } from "./ArgumentValueTypes.ts";
+import type { SingleValueType, Values, ValueType, ValueTypeName } from "../Value.ts";
 /**
  * Interface to be implemented by all {@link Command} arguments.
  */
@@ -6,21 +6,21 @@ export default interface Argument {
     /**
      * Type of the argument value.
      */
-    readonly type: ArgumentValueTypeName;
+    readonly type: ValueTypeName;
     /**
-     * Optional list of values that the value must match. This is not supported for {@link ArgumentValueTypeName.BOOLEAN}.
+     * Optional list of values that the value must match. This is not supported for {@link ValueTypeName.BOOLEAN}.
      */
-    readonly allowableValues?: ReadonlyArray<ArgumentSingleValueType>;
+    readonly allowableValues?: ReadonlyArray<SingleValueType>;
     /**
-     * Optional (default is `false`) for {@link ArgumentValueTypeName.STRING} when comparing a value against {@link allowableValues}.
+     * Optional (default is `false`) for {@link ValueTypeName.STRING} when comparing a value against {@link allowableValues}.
      */
     readonly isCaseInsensitive?: boolean;
     /**
-     * Optional for {@link ArgumentValueTypeName.INTEGER} or {@link ArgumentValueTypeName.NUMBER} when validating a value.
+     * Optional for {@link ValueTypeName.INTEGER} or {@link ValueTypeName.NUMBER} when validating a value.
      */
     readonly minValueInclusive?: number;
     /**
-     * Optional for {@link ArgumentValueTypeName.INTEGER} or {@link ArgumentValueTypeName.NUMBER} when validating a value.
+     * Optional for {@link ValueTypeName.INTEGER} or {@link ValueTypeName.NUMBER} when validating a value.
      */
     readonly maxValueInclusive?: number;
     /**
@@ -57,6 +57,6 @@ export default interface Argument {
      * }
      * ```
      */
-    readonly validate?: (value: ArgumentValueType | ArgumentValues | Array<ArgumentValues>) => string | undefined;
+    readonly validate?: (value: ValueType | Values | Array<Values>) => string | undefined;
 }
 //# sourceMappingURL=Argument.d.ts.map

package/dist/src/argument/Argument.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Argument.d.ts","sourceRoot":"","sources":["../../../src/argument/Argument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,QAAQ;IAC/B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAElE;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAClB,KAAK,EAAE,iBAAiB,GAAG,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC,KAC9D,MAAM,GAAG,SAAS,CAAC;CACzB"}
+{"version":3,"file":"Argument.d.ts","sourceRoot":"","sources":["../../../src/argument/Argument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAErF;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,QAAQ;IAC/B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAE1D;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;CACvF"}

package/dist/src/argument/ComplexOption.d.ts

@@ -1,5 +1,5 @@
 import type Option from "./Option.ts";
-import type { ArgumentValues, ComplexValueTypeName } from "./ArgumentValueTypes.ts";
+import type { Values, ComplexValueTypeName } from "../Value.ts";
 export declare const MAXIMUM_COMPLEX_OPTION_NESTING_DEPTH = 10;
 /**
  * A container option argument for defining {@link SubCommand} nested argument hierarchies.
@@ -16,6 +16,6 @@ export default interface ComplexOption extends Omit<Option, "type" | "defaultVal
     /**
      * Default value for the argument if not specified.
      */
-    readonly defaultValue?: ArgumentValues | Array<ArgumentValues>;
+    readonly defaultValue?: Values | Array<Values>;
 }
 //# sourceMappingURL=ComplexOption.d.ts.map

package/dist/src/argument/ComplexOption.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComplexOption.d.ts","sourceRoot":"","sources":["../../../src/argument/ComplexOption.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,aAAc,SAAQ,IAAI,CACjD,MAAM,EACN,MAAM,GAAG,cAAc,GAAG,iBAAiB,CAC5C;IACC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;CAChE"}
+{"version":3,"file":"ComplexOption.d.ts","sourceRoot":"","sources":["../../../src/argument/ComplexOption.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEhE,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,aAAc,SAAQ,IAAI,CACjD,MAAM,EACN,MAAM,GAAG,cAAc,GAAG,iBAAiB,CAC5C;IACC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;CAChD"}

package/dist/src/argument/GlobalCommandArgument.d.ts

@@ -1,5 +1,5 @@
 import type Argument from "./Argument.ts";
-import type { ArgumentSingleValueType } from "./ArgumentValueTypes.ts";
+import type { SingleValueType } from "../Value.ts";
 /**
  * Interface to be implemented by a single {@link Argument} defined by a {@link GlobalCommand}.
  */
@@ -7,7 +7,7 @@ export default interface GlobalCommandArgument extends Argument {
     /**
      * Default value for the argument if not specified.
      */
-    readonly defaultValue?: ArgumentSingleValueType;
+    readonly defaultValue?: SingleValueType;
     /**
      * If this is `true` the argument does not need to be specified nor have a default value. The default is `false`.
      */

package/dist/src/argument/GlobalCommandArgument.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalCommandArgument.d.ts","sourceRoot":"","sources":["../../../src/argument/GlobalCommandArgument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,qBAAsB,SAAQ,QAAQ;IAC7D;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B"}
+{"version":3,"file":"GlobalCommandArgument.d.ts","sourceRoot":"","sources":["../../../src/argument/GlobalCommandArgument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,qBAAsB,SAAQ,QAAQ;IAC7D;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,eAAe,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B"}

package/dist/src/argument/Option.d.ts

@@ -1,4 +1,4 @@
-import type { ArgumentValueType } from "./ArgumentValueTypes.ts";
+import type { ValueType } from "../Value.ts";
 import type SubCommandArgument from "./SubCommandArgument.ts";
 /**
  * Interface for {@link SubCommand} option arguments.
@@ -13,7 +13,7 @@ export default interface Option extends SubCommandArgument {
     /**
      * Default value for the argument if not specified.
      */
-    readonly defaultValue?: ArgumentValueType;
+    readonly defaultValue?: ValueType;
     /**
      * If this is `true` the option does not need to be specified nor have a default value.
      */

package/dist/src/argument/Option.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Option.d.ts","sourceRoot":"","sources":["../../../src/argument/Option.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,MAAO,SAAQ,kBAAkB;IACxD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B"}
+{"version":3,"file":"Option.d.ts","sourceRoot":"","sources":["../../../src/argument/Option.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,MAAO,SAAQ,kBAAkB;IACxD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B"}

package/dist/src/command/GlobalCommand.d.ts

@@ -1,7 +1,7 @@
 import type Command from "./Command.ts";
 import type GlobalCommandArgument from "../argument/GlobalCommandArgument.ts";
 import type Context from "../Context.ts";
-import type { ArgumentSingleValueType } from "../argument/ArgumentValueTypes.ts";
+import type { SingleValueType } from "../Value.ts";
 /**
  * Interface for a global command.
  */
@@ -23,6 +23,6 @@ export default interface GlobalCommand extends Command {
      * @param argumentValue optional argument value for the command. This will be populated unless
      * the command's {@link GlobalCommandArgument} is optional and the argument value was not provided.
      */
-    execute(context: Context, argumentValue?: ArgumentSingleValueType): Promise<void>;
+    execute(context: Context, argumentValue?: SingleValueType): Promise<void>;
 }
 //# sourceMappingURL=GlobalCommand.d.ts.map

package/dist/src/command/GlobalCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalCommand.d.ts","sourceRoot":"","sources":["../../../src/command/GlobalCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,qBAAqB,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAEjF;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,aAAc,SAAQ,OAAO;IACpD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAE1C;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF"}
+{"version":3,"file":"GlobalCommand.d.ts","sourceRoot":"","sources":["../../../src/command/GlobalCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,qBAAqB,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,aAAc,SAAQ,OAAO;IACpD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAE1C;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E"}

package/dist/src/command/SubCommand.d.ts

@@ -3,7 +3,7 @@ import type Option from "../argument/Option.ts";
 import type Positional from "../argument/Positional.ts";
 import type UsageExample from "./UsageExample.ts";
 import type ComplexOption from "../argument/ComplexOption.ts";
-import type { ArgumentValues } from "../argument/ArgumentValueTypes.ts";
+import type { Values } from "../Value.ts";
 import type Context from "../Context.ts";
 /**
  * Interface for a sub-command.
@@ -32,6 +32,6 @@ export default interface SubCommand extends Command {
      * @param argumentValues the argument values for the command. This may be empty if
      * the command's {@link Option} and {@link Positional} instances are all optional and no argument values were provided.
      */
-    execute(context: Context, argumentValues: ArgumentValues): Promise<void>;
+    execute(context: Context, argumentValues: Values): Promise<void>;
 }
 //# sourceMappingURL=SubCommand.d.ts.map

package/dist/src/command/SubCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubCommand.d.ts","sourceRoot":"","sources":["../../../src/command/SubCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAChD,OAAO,KAAK,UAAU,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,aAAa,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,UAAW,SAAQ,OAAO;IACjD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;IAExD;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAErD;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E"}
+{"version":3,"file":"SubCommand.d.ts","sourceRoot":"","sources":["../../../src/command/SubCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAChD,OAAO,KAAK,UAAU,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,aAAa,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,UAAW,SAAQ,OAAO;IACjD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;IAExD;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAErD;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE"}

package/dist/src/service/core/KeyValueService.d.ts

@@ -1,40 +1,74 @@
+import type { ValueNode } from "../../Value.ts";
 export declare const KEY_VALUE_SERVICE_ID = "@flowscripter/dynamic-cli-framework/key-value-service";
 /**
  * The sentinel prefix used to indicate a value is stored as an OS-native secret.
- * Values starting with this prefix are resolved via the {@link SecretService}.
+ * String leaves starting with this prefix are resolved via the {@link SecretService}.
  * This prefix is reserved and must not be used for regular key-value data.
  */
 export declare const SECRET_SENTINEL_PREFIX = "__SECRET__:";
+/**
+ * Wraps a value to mark it for storage as an OS-native secret via {@link SecretService}, when passed to
+ * {@link KeyValueService.set}. Can wrap the entire value passed to `set`, or be nested at any depth
+ * within a larger object/array passed to `set`.
+ */
+export declare class Secret<T extends ValueNode = ValueNode> {
+    readonly value: T;
+    constructor(value: T);
+}
+/**
+ * The shape of a value passed to {@link KeyValueService.set}.
+ *
+ * Like {@link ValueNode} (primitives, arrays of primitives, nested keyed objects, or arrays of
+ * nested objects) but additionally allows a {@link Secret}-wrapped value at any depth - as a top
+ * level value, a property of a nested object, or an entry of a nested array. A {@link Secret}
+ * itself wraps a plain {@link ValueNode}, so secrets do not nest within secrets.
+ */
+export type SettableValueNode = ValueNode | Secret | {
+    [name: string]: SettableValueNode;
+} | Array<SettableValueNode>;
 /**
  * Service providing keystore functionality for the CLI. The keystore data is scoped to the
  * service or {@link Command} instances accessing this service via {@link Context.getServiceById}.
  *
- * Values can optionally be stored as OS-native secrets using the `isSecret` parameter on
- * {@link setKey}. Secret values are stored via {@link SecretService} and only a sentinel
- * reference is kept in the key-value Map. The sentinel prefix `__SECRET__:` is reserved.
+ * Values are arbitrary JSON-serializable data (see {@link ValueNode}) - not limited to
+ * strings - and may be deep objects or arrays.
+ *
+ * Any node within a value passed to {@link set} can be wrapped in {@link Secret} to have that
+ * node - and only that node - stored as an OS-native secret via {@link SecretService}, with a
+ * sentinel reference (prefixed with `__SECRET__:`) kept in its place in the stored structure.
+ * Everything else in the value is stored as plain (unencrypted) config data. This is symmetric
+ * with {@link get}, which resolves sentinel references found at any depth.
  */
 export default interface KeyValueService {
     /**
-     * Get a value for a specified key in the keystore.
-     * If the stored value is a secret sentinel, the actual value is retrieved from the OS secret store.
+     * Get the value for a specified key in the keystore.
+     *
+     * Recursively resolves any string leaf - at any depth within the stored value - which is a
+     * secret sentinel, retrieving its actual value via {@link SecretService}. This covers both
+     * values written via {@link set} using a nested {@link Secret}, and secret references a user
+     * hand-embeds directly (nested arbitrarily deep) in the CLI's JSON config file.
      */
-    getKey(key: string): Promise<string>;
+    get<T extends ValueNode = ValueNode>(key: string): Promise<T>;
     /**
      * Set a value for a specified key in the keystore.
      *
-     * @param isSecret if true, the value is stored in the OS-native secret store and a sentinel
-     *   reference is kept in the key-value Map. Requires that the service was constructed with
-     *   secret support enabled.
+     * Any node within `value` wrapped in {@link Secret} - at any depth - is serialized as JSON and
+     * stored as an OS-native secret via {@link SecretService}, with a sentinel reference kept in
+     * its place in the stored structure. All other data is stored as plain (unencrypted) config
+     * data. Storing a secret requires that the service was constructed with secret support
+     * enabled.
      */
-    setKey(key: string, value: string, isSecret?: boolean): Promise<void>;
+    set(key: string, value: SettableValueNode): Promise<void>;
     /**
      * Check if a value for a specified key exists in the keystore.
      */
-    hasKey(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
     /**
      * Delete the value for a specified key in the keystore.
-     * If the stored value is a secret sentinel, the secret is also deleted from the OS secret store.
+     *
+     * Recursively walks the stored (unresolved) structure for `key` and deletes every OS-native
+     * secret referenced - at any depth - via {@link SecretService}, before removing the key itself.
      */
-    deleteKey(key: string): Promise<void>;
+    delete(key: string): Promise<void>;
 }
 //# sourceMappingURL=KeyValueService.d.ts.map

package/dist/src/service/core/KeyValueService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KeyValueService.d.ts","sourceRoot":"","sources":["../../../../src/service/core/KeyValueService.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,0DAA0D,CAAC;AAE5F;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,WAAW,eAAe;IACtC;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC"}
+{"version":3,"file":"KeyValueService.d.ts","sourceRoot":"","sources":["../../../../src/service/core/KeyValueService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,eAAO,MAAM,oBAAoB,0DAA0D,CAAC;AAE5F;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD;;;;GAIG;AACH,qBAAa,MAAM,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;aACrB,KAAK,EAAE,CAAC;IAApC,YAA4B,KAAK,EAAE,CAAC,EAAI;CACzC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,MAAM,GACN;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAA;CAAE,GACrC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AAE7B;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,WAAW,eAAe;IACtC;;;;;;;OAOG;IACH,GAAG,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE9D;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC"}

package/dist/src/service/core/KeyValueService.js

@@ -1,7 +1,18 @@
 export const KEY_VALUE_SERVICE_ID = "@flowscripter/dynamic-cli-framework/key-value-service";
 /**
  * The sentinel prefix used to indicate a value is stored as an OS-native secret.
- * Values starting with this prefix are resolved via the {@link SecretService}.
+ * String leaves starting with this prefix are resolved via the {@link SecretService}.
  * This prefix is reserved and must not be used for regular key-value data.
  */
 export const SECRET_SENTINEL_PREFIX = "__SECRET__:";
+/**
+ * Wraps a value to mark it for storage as an OS-native secret via {@link SecretService}, when passed to
+ * {@link KeyValueService.set}. Can wrap the entire value passed to `set`, or be nested at any depth
+ * within a larger object/array passed to `set`.
+ */
+export class Secret {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+}

package/dist/src/service/core/PrompterService.d.ts

@@ -1,4 +1,4 @@
-import type { ArgumentSingleValueType } from "../../argument/ArgumentValueTypes.ts";
+import type { SingleValueType } from "../../Value.ts";
 export declare const PROMPTER_SERVICE_ID = "@flowscripter/dynamic-cli-framework/prompter-service";
 export declare enum PromptType {
     SINGLE_SELECT = 0,
@@ -10,10 +10,10 @@ export declare enum PromptType {
 }
 export interface PromptOption {
     readonly displayValue: string;
-    readonly returnedValue: ArgumentSingleValueType;
+    readonly returnedValue: SingleValueType;
     readonly min?: number;
     readonly max?: number;
-    readonly validate?: (value: ArgumentSingleValueType) => string | undefined;
+    readonly validate?: (value: SingleValueType) => string | undefined;
 }
 export interface Prompt {
     readonly name: string;
@@ -25,7 +25,7 @@ export interface Prompt {
 }
 export interface PromptResult {
     readonly name: string;
-    readonly value: ArgumentSingleValueType | ReadonlyArray<ArgumentSingleValueType>;
+    readonly value: SingleValueType | ReadonlyArray<SingleValueType>;
 }
 export default interface PrompterService {
     promptEnabled: boolean;

package/dist/src/service/core/PrompterService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PrompterService.d.ts","sourceRoot":"","sources":["../../../../src/service/core/PrompterService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAEpF,eAAO,MAAM,mBAAmB,yDAAyD,CAAC;AAE1F,oBAAY,UAAU;IACpB,aAAa,IAAI;IACjB,YAAY,IAAI;IAChB,WAAW,IAAI;IACf,MAAM,IAAI;IACV,IAAI,IAAI;IACR,QAAQ,IAAI;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,MAAM,GAAG,SAAS,CAAC;CAC5E;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,uBAAuB,GAAG,aAAa,CAAC,uBAAuB,CAAC,CAAC;CAClF;AAED,MAAM,CAAC,OAAO,WAAW,eAAe;IACtC,aAAa,EAAE,OAAO,CAAC;IAEvB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE9C,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;CACjF"}
+{"version":3,"file":"PrompterService.d.ts","sourceRoot":"","sources":["../../../../src/service/core/PrompterService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,eAAO,MAAM,mBAAmB,yDAAyD,CAAC;AAE1F,oBAAY,UAAU;IACpB,aAAa,IAAI;IACjB,YAAY,IAAI;IAChB,WAAW,IAAI;IACf,MAAM,IAAI;IACV,IAAI,IAAI;IACR,QAAQ,IAAI;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,MAAM,GAAG,SAAS,CAAC;CACpE;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;CAClE;AAED,MAAM,CAAC,OAAO,WAAW,eAAe;IACtC,aAAa,EAAE,OAAO,CAAC;IAEvB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE9C,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;CACjF"}

package/index.ts

@@ -1,14 +1,15 @@
 // Argument API
 export type { default as Argument } from "./src/argument/Argument.ts";
 export type {
-  ArgumentSingleValueType,
-  ArgumentValues,
-  ArgumentValueType,
-  PopulatedArgumentSingleValueType,
-  PopulatedArgumentValues,
-  PopulatedArgumentValueType,
-} from "./src/argument/ArgumentValueTypes.ts";
-export { ArgumentValueTypeName, ComplexValueTypeName } from "./src/argument/ArgumentValueTypes.ts";
+  SingleValueType,
+  Values,
+  ValueType,
+  ValueNode,
+  PopulatedSingleValueType,
+  PopulatedValues,
+  PopulatedValueType,
+} from "./src/Value.ts";
+export { ValueTypeName, ComplexValueTypeName } from "./src/Value.ts";
 export type { default as ComplexOption } from "./src/argument/ComplexOption.ts";
 export { MAXIMUM_COMPLEX_OPTION_NESTING_DEPTH } from "./src/argument/ComplexOption.ts";
 export type { default as SubCommandArgument } from "./src/argument/SubCommandArgument.ts";
@@ -47,7 +48,11 @@ export type {
 
 export { KEY_VALUE_SERVICE_ID } from "./src/service/core/KeyValueService.ts";
 export { SECRET_SENTINEL_PREFIX } from "./src/service/core/KeyValueService.ts";
-export type { default as KeyValueService } from "./src/service/core/KeyValueService.ts";
+export { Secret } from "./src/service/core/KeyValueService.ts";
+export type {
+  default as KeyValueService,
+  SettableValueNode,
+} from "./src/service/core/KeyValueService.ts";
 export type { default as SecretService } from "./src/service/core/SecretService.ts";
 
 export { FETCH_SERVICE_ID } from "./src/service/core/FetchService.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowscripter/dynamic-cli-framework-api",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "API for https://github.com/flowscripter/dynamic-cli-framework",
   "keywords": [
     "bun",

package/src/ParseResult.ts

@@ -1,9 +1,6 @@
 import type Command from "./command/Command.ts";
 import type GroupCommand from "./command/GroupCommand.ts";
-import type {
-  PopulatedArgumentSingleValueType,
-  PopulatedArgumentValues,
-} from "./argument/ArgumentValueTypes.ts";
+import type { PopulatedSingleValueType, PopulatedValues } from "./Value.ts";
 import type { InvalidArgument } from "./RunResult.ts";
 
 /**
@@ -23,10 +20,10 @@ export interface ParseResult {
   /**
    * The argument values populated from the command line args. If the parse result is valid
    * (i.e. {@link invalidArguments} is empty), this can be used to execute the specified {@link command}.
-   * {@link PopulatedArgumentSingleValueType} is for {@link GlobalCommand} values, {@link PopulatedArgumentValues} is for
+   * {@link PopulatedSingleValueType} is for {@link GlobalCommand} values, {@link PopulatedValues} is for
    * {@link SubCommand} values.
    */
-  readonly populatedArgumentValues: PopulatedArgumentValues | PopulatedArgumentSingleValueType;
+  readonly populatedArgumentValues: PopulatedValues | PopulatedSingleValueType;
 
   /**
    * Any arguments which were invalid.

package/src/RunResult.ts

@@ -4,10 +4,7 @@
 import type Command from "./command/Command.ts";
 import type Argument from "./argument/Argument.ts";
 import type ComplexOption from "./argument/ComplexOption.ts";
-import type {
-  PopulatedArgumentValues,
-  PopulatedArgumentValueType,
-} from "./argument/ArgumentValueTypes.ts";
+import type { PopulatedValues, PopulatedValueType } from "./Value.ts";
 
 export enum RunState {
   /**
@@ -121,9 +118,9 @@ export interface InvalidArgument {
    * NOTE: This value is unlikely to be valid as it is the cause of the invalid argument error.
    */
   readonly value?:
-    | PopulatedArgumentValues
-    | PopulatedArgumentValueType
-    | Array<PopulatedArgumentValues | PopulatedArgumentValueType>;
+    | PopulatedValues
+    | PopulatedValueType
+    | Array<PopulatedValues | PopulatedValueType>;
 
   /**
    * An optional message providing detail about the validation failure.

package/src/Value.ts

@@ -0,0 +1,89 @@
+/**
+ * Value shapes and type names shared by argument parsing and other framework features (e.g.
+ * `KeyValueService`) that need to represent an arbitrary JSON-ish value.
+ */
+
+/**
+ * Enum of possible value types.
+ */
+export enum ValueTypeName {
+  STRING = 0,
+  NUMBER = 1,
+  INTEGER = 2,
+  BOOLEAN = 3,
+  SECRET = 4,
+}
+
+/**
+ * Only possible value for {@link ComplexOption.type}.
+ */
+export enum ComplexValueTypeName {
+  COMPLEX = 5,
+}
+
+/**
+ * The type of a single value which is supported.
+ *
+ * NOTE: JavaScript does not have a special runtime value for INTEGER so this is covered by `number`.
+ * NOTE: `string` is also used for PASSWORD and SECRET values.
+ */
+export type SingleValueType = number | string | boolean;
+
+/**
+ * The type of a value can be: `boolean`, `number` or `string` or an array of these.
+ */
+export type ValueType = SingleValueType | Array<SingleValueType>;
+
+/**
+ * Any node that can appear within a {@link Values} tree: a primitive/array-of-primitives
+ * ({@link ValueType}), a nested keyed object ({@link Values}), or an array of such objects.
+ */
+export type ValueNode = ValueType | Values | Array<Values>;
+
+/**
+ * A container object for populated values.
+ *
+ * The following are all valid examples:
+ *
+ * * `{ }`
+ * * `{ foo: 1 }`
+ * * `{ foo: true }`
+ * * `{ foo: 'bar' }`
+ * * `{ foo: [ 1, 2 ] }`
+ * * `{ foo: [ true, true ] }`
+ * * `{ foo: [ 'bar', 'gar' ] }`
+ * * `{ foo: { a: 1 } }`
+ * * `{ foo: { a: { b: 'c'} } }`
+ * * `{ foo: [ { a: { b: 'c'} }, { a: { b: 'c'} } ] }`
+ *
+ * An array of arrays is not allowed, so the following is an INVALID example:
+ *
+ * * `{ foo: [ [ 1, 2 ], [3, 4 ] ] }`
+ */
+export type Values = {
+  [name: string]: ValueNode;
+};
+
+/**
+ * Populated single value type is very similar to {@link SingleValueType} but allows for an illegal
+ * undefined value.
+ */
+export type PopulatedSingleValueType = SingleValueType | undefined;
+
+/**
+ * Populated value types are very similar to {@link ValueType} but allow for illegal
+ * undefined values.
+ */
+export type PopulatedValueType = PopulatedSingleValueType | Array<PopulatedSingleValueType>;
+
+/**
+ * Populated values are very similar to {@link Values} but allow for illegal
+ * undefined properties and array entries.
+ */
+export interface PopulatedValues {
+  [name: string]:
+    | PopulatedValueType
+    | PopulatedValues
+    | Array<PopulatedValues | undefined>
+    | undefined;
+}

package/src/argument/Argument.ts

@@ -1,9 +1,4 @@
-import type {
-  ArgumentSingleValueType,
-  ArgumentValues,
-  ArgumentValueType,
-  ArgumentValueTypeName,
-} from "./ArgumentValueTypes.ts";
+import type { SingleValueType, Values, ValueType, ValueTypeName } from "../Value.ts";
 
 /**
  * Interface to be implemented by all {@link Command} arguments.
@@ -12,25 +7,25 @@ export default interface Argument {
   /**
    * Type of the argument value.
    */
-  readonly type: ArgumentValueTypeName;
+  readonly type: ValueTypeName;
 
   /**
-   * Optional list of values that the value must match. This is not supported for {@link ArgumentValueTypeName.BOOLEAN}.
+   * Optional list of values that the value must match. This is not supported for {@link ValueTypeName.BOOLEAN}.
    */
-  readonly allowableValues?: ReadonlyArray<ArgumentSingleValueType>;
+  readonly allowableValues?: ReadonlyArray<SingleValueType>;
 
   /**
-   * Optional (default is `false`) for {@link ArgumentValueTypeName.STRING} when comparing a value against {@link allowableValues}.
+   * Optional (default is `false`) for {@link ValueTypeName.STRING} when comparing a value against {@link allowableValues}.
    */
   readonly isCaseInsensitive?: boolean;
 
   /**
-   * Optional for {@link ArgumentValueTypeName.INTEGER} or {@link ArgumentValueTypeName.NUMBER} when validating a value.
+   * Optional for {@link ValueTypeName.INTEGER} or {@link ValueTypeName.NUMBER} when validating a value.
    */
   readonly minValueInclusive?: number;
 
   /**
-   * Optional for {@link ArgumentValueTypeName.INTEGER} or {@link ArgumentValueTypeName.NUMBER} when validating a value.
+   * Optional for {@link ValueTypeName.INTEGER} or {@link ValueTypeName.NUMBER} when validating a value.
    */
   readonly maxValueInclusive?: number;
 
@@ -69,7 +64,5 @@ export default interface Argument {
    * }
    * ```
    */
-  readonly validate?: (
-    value: ArgumentValueType | ArgumentValues | Array<ArgumentValues>,
-  ) => string | undefined;
+  readonly validate?: (value: ValueType | Values | Array<Values>) => string | undefined;
 }

package/src/argument/ComplexOption.ts

@@ -1,5 +1,5 @@
 import type Option from "./Option.ts";
-import type { ArgumentValues, ComplexValueTypeName } from "./ArgumentValueTypes.ts";
+import type { Values, ComplexValueTypeName } from "../Value.ts";
 
 export const MAXIMUM_COMPLEX_OPTION_NESTING_DEPTH = 10;
 
@@ -23,5 +23,5 @@ export default interface ComplexOption extends Omit<
   /**
    * Default value for the argument if not specified.
    */
-  readonly defaultValue?: ArgumentValues | Array<ArgumentValues>;
+  readonly defaultValue?: Values | Array<Values>;
 }

package/src/argument/GlobalCommandArgument.ts

@@ -1,5 +1,5 @@
 import type Argument from "./Argument.ts";
-import type { ArgumentSingleValueType } from "./ArgumentValueTypes.ts";
+import type { SingleValueType } from "../Value.ts";
 
 /**
  * Interface to be implemented by a single {@link Argument} defined by a {@link GlobalCommand}.
@@ -8,7 +8,7 @@ export default interface GlobalCommandArgument extends Argument {
   /**
    * Default value for the argument if not specified.
    */
-  readonly defaultValue?: ArgumentSingleValueType;
+  readonly defaultValue?: SingleValueType;
 
   /**
    * If this is `true` the argument does not need to be specified nor have a default value. The default is `false`.

package/src/argument/Option.ts

@@ -1,4 +1,4 @@
-import type { ArgumentValueType } from "./ArgumentValueTypes.ts";
+import type { ValueType } from "../Value.ts";
 import type SubCommandArgument from "./SubCommandArgument.ts";
 
 /**
@@ -15,7 +15,7 @@ export default interface Option extends SubCommandArgument {
   /**
    * Default value for the argument if not specified.
    */
-  readonly defaultValue?: ArgumentValueType;
+  readonly defaultValue?: ValueType;
 
   /**
    * If this is `true` the option does not need to be specified nor have a default value.

package/src/command/GlobalCommand.ts

@@ -1,7 +1,7 @@
 import type Command from "./Command.ts";
 import type GlobalCommandArgument from "../argument/GlobalCommandArgument.ts";
 import type Context from "../Context.ts";
-import type { ArgumentSingleValueType } from "../argument/ArgumentValueTypes.ts";
+import type { SingleValueType } from "../Value.ts";
 
 /**
  * Interface for a global command.
@@ -26,5 +26,5 @@ export default interface GlobalCommand extends Command {
    * @param argumentValue optional argument value for the command. This will be populated unless
    * the command's {@link GlobalCommandArgument} is optional and the argument value was not provided.
    */
-  execute(context: Context, argumentValue?: ArgumentSingleValueType): Promise<void>;
+  execute(context: Context, argumentValue?: SingleValueType): Promise<void>;
 }

package/src/command/SubCommand.ts

@@ -3,7 +3,7 @@ import type Option from "../argument/Option.ts";
 import type Positional from "../argument/Positional.ts";
 import type UsageExample from "./UsageExample.ts";
 import type ComplexOption from "../argument/ComplexOption.ts";
-import type { ArgumentValues } from "../argument/ArgumentValueTypes.ts";
+import type { Values } from "../Value.ts";
 import type Context from "../Context.ts";
 
 /**
@@ -37,5 +37,5 @@ export default interface SubCommand extends Command {
    * @param argumentValues the argument values for the command. This may be empty if
    * the command's {@link Option} and {@link Positional} instances are all optional and no argument values were provided.
    */
-  execute(context: Context, argumentValues: ArgumentValues): Promise<void>;
+  execute(context: Context, argumentValues: Values): Promise<void>;
 }

package/src/service/core/KeyValueService.ts

@@ -1,44 +1,82 @@
+import type { ValueNode } from "../../Value.ts";
+
 export const KEY_VALUE_SERVICE_ID = "@flowscripter/dynamic-cli-framework/key-value-service";
 
 /**
  * The sentinel prefix used to indicate a value is stored as an OS-native secret.
- * Values starting with this prefix are resolved via the {@link SecretService}.
+ * String leaves starting with this prefix are resolved via the {@link SecretService}.
  * This prefix is reserved and must not be used for regular key-value data.
  */
 export const SECRET_SENTINEL_PREFIX = "__SECRET__:";
 
+/**
+ * Wraps a value to mark it for storage as an OS-native secret via {@link SecretService}, when passed to
+ * {@link KeyValueService.set}. Can wrap the entire value passed to `set`, or be nested at any depth
+ * within a larger object/array passed to `set`.
+ */
+export class Secret<T extends ValueNode = ValueNode> {
+  constructor(public readonly value: T) {}
+}
+
+/**
+ * The shape of a value passed to {@link KeyValueService.set}.
+ *
+ * Like {@link ValueNode} (primitives, arrays of primitives, nested keyed objects, or arrays of
+ * nested objects) but additionally allows a {@link Secret}-wrapped value at any depth - as a top
+ * level value, a property of a nested object, or an entry of a nested array. A {@link Secret}
+ * itself wraps a plain {@link ValueNode}, so secrets do not nest within secrets.
+ */
+export type SettableValueNode =
+  | ValueNode
+  | Secret
+  | { [name: string]: SettableValueNode }
+  | Array<SettableValueNode>;
+
 /**
  * Service providing keystore functionality for the CLI. The keystore data is scoped to the
  * service or {@link Command} instances accessing this service via {@link Context.getServiceById}.
  *
- * Values can optionally be stored as OS-native secrets using the `isSecret` parameter on
- * {@link setKey}. Secret values are stored via {@link SecretService} and only a sentinel
- * reference is kept in the key-value Map. The sentinel prefix `__SECRET__:` is reserved.
+ * Values are arbitrary JSON-serializable data (see {@link ValueNode}) - not limited to
+ * strings - and may be deep objects or arrays.
+ *
+ * Any node within a value passed to {@link set} can be wrapped in {@link Secret} to have that
+ * node - and only that node - stored as an OS-native secret via {@link SecretService}, with a
+ * sentinel reference (prefixed with `__SECRET__:`) kept in its place in the stored structure.
+ * Everything else in the value is stored as plain (unencrypted) config data. This is symmetric
+ * with {@link get}, which resolves sentinel references found at any depth.
  */
 export default interface KeyValueService {
   /**
-   * Get a value for a specified key in the keystore.
-   * If the stored value is a secret sentinel, the actual value is retrieved from the OS secret store.
+   * Get the value for a specified key in the keystore.
+   *
+   * Recursively resolves any string leaf - at any depth within the stored value - which is a
+   * secret sentinel, retrieving its actual value via {@link SecretService}. This covers both
+   * values written via {@link set} using a nested {@link Secret}, and secret references a user
+   * hand-embeds directly (nested arbitrarily deep) in the CLI's JSON config file.
    */
-  getKey(key: string): Promise<string>;
+  get<T extends ValueNode = ValueNode>(key: string): Promise<T>;
 
   /**
    * Set a value for a specified key in the keystore.
    *
-   * @param isSecret if true, the value is stored in the OS-native secret store and a sentinel
-   *   reference is kept in the key-value Map. Requires that the service was constructed with
-   *   secret support enabled.
+   * Any node within `value` wrapped in {@link Secret} - at any depth - is serialized as JSON and
+   * stored as an OS-native secret via {@link SecretService}, with a sentinel reference kept in
+   * its place in the stored structure. All other data is stored as plain (unencrypted) config
+   * data. Storing a secret requires that the service was constructed with secret support
+   * enabled.
    */
-  setKey(key: string, value: string, isSecret?: boolean): Promise<void>;
+  set(key: string, value: SettableValueNode): Promise<void>;
 
   /**
    * Check if a value for a specified key exists in the keystore.
    */
-  hasKey(key: string): Promise<boolean>;
+  has(key: string): Promise<boolean>;
 
   /**
    * Delete the value for a specified key in the keystore.
-   * If the stored value is a secret sentinel, the secret is also deleted from the OS secret store.
+   *
+   * Recursively walks the stored (unresolved) structure for `key` and deletes every OS-native
+   * secret referenced - at any depth - via {@link SecretService}, before removing the key itself.
    */
-  deleteKey(key: string): Promise<void>;
+  delete(key: string): Promise<void>;
 }

package/src/service/core/PrompterService.ts

@@ -1,4 +1,4 @@
-import type { ArgumentSingleValueType } from "../../argument/ArgumentValueTypes.ts";
+import type { SingleValueType } from "../../Value.ts";
 
 export const PROMPTER_SERVICE_ID = "@flowscripter/dynamic-cli-framework/prompter-service";
 
@@ -13,10 +13,10 @@ export enum PromptType {
 
 export interface PromptOption {
   readonly displayValue: string;
-  readonly returnedValue: ArgumentSingleValueType;
+  readonly returnedValue: SingleValueType;
   readonly min?: number;
   readonly max?: number;
-  readonly validate?: (value: ArgumentSingleValueType) => string | undefined;
+  readonly validate?: (value: SingleValueType) => string | undefined;
 }
 
 export interface Prompt {
@@ -30,7 +30,7 @@ export interface Prompt {
 
 export interface PromptResult {
   readonly name: string;
-  readonly value: ArgumentSingleValueType | ReadonlyArray<ArgumentSingleValueType>;
+  readonly value: SingleValueType | ReadonlyArray<SingleValueType>;
 }
 
 export default interface PrompterService {

package/dist/src/argument/ArgumentValueTypes.d.ts

@@ -1,68 +0,0 @@
-/**
- * The type of single {@link Argument} values which are supported.
- *
- * NOTE: JavaScript does not have a special runtime value for INTEGER so this is covered by `number`.
- * NOTE: `string` is also used for PASSWORD values.
- */
-export type ArgumentSingleValueType = number | string | boolean;
-/**
- * The type of the value to be parsed as an argument can be: `boolean`, `number` or `string` or an array of these.
- */
-export type ArgumentValueType = ArgumentSingleValueType | Array<ArgumentSingleValueType>;
-/**
- * A container object for populated argument values.
- *
- * The following are all valid examples:
- *
- * * `{ }`
- * * `{ foo: 1 }`
- * * `{ foo: true }`
- * * `{ foo: 'bar' }`
- * * `{ foo: [ 1, 2 ] }`
- * * `{ foo: [ true, true ] }`
- * * `{ foo: [ 'bar', 'gar' ] }`
- * * `{ foo: { a: 1 } }`
- * * `{ foo: { a: { b: 'c'} } }`
- * * `{ foo: [ { a: { b: 'c'} }, { a: { b: 'c'} } ] }`
- *
- * An array of arrays is not allowed, so the following is an INVALID example:
- *
- * * `{ foo: [ [ 1, 2 ], [3, 4 ] ] }`
- */
-export type ArgumentValues = {
-    [argName: string]: ArgumentValueType | ArgumentValues | Array<ArgumentValues>;
-};
-/**
- * Enum of possible {@link Argument} value types.
- */
-export declare enum ArgumentValueTypeName {
-    STRING = 0,
-    NUMBER = 1,
-    INTEGER = 2,
-    BOOLEAN = 3,
-    SECRET = 4
-}
-/**
- * Only possible value for {@link ComplexOption.type}.
- */
-export declare enum ComplexValueTypeName {
-    COMPLEX = 5
-}
-/**
- * Populated single value type is very similar to {@link ArgumentSingleValueType} but allows for an illegal
- * undefined value.
- */
-export type PopulatedArgumentSingleValueType = ArgumentSingleValueType | undefined;
-/**
- * Populated argument value types are very similar to {@link ArgumentValueType} but allow for illegal
- * undefined values.
- */
-export type PopulatedArgumentValueType = PopulatedArgumentSingleValueType | Array<PopulatedArgumentSingleValueType>;
-/**
- * Populated values are very similar to {@link ArgumentValues} but allow for illegal
- * undefined properties and array entries.
- */
-export interface PopulatedArgumentValues {
-    [argName: string]: PopulatedArgumentValueType | PopulatedArgumentValues | Array<PopulatedArgumentValues | undefined> | undefined;
-}
-//# sourceMappingURL=ArgumentValueTypes.d.ts.map

package/dist/src/argument/ArgumentValueTypes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ArgumentValueTypes.d.ts","sourceRoot":"","sources":["../../../src/argument/ArgumentValueTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GAAG,KAAK,CAAC,uBAAuB,CAAC,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;CAC/E,CAAC;AAEF;;GAEG;AACH,oBAAY,qBAAqB;IAC/B,MAAM,IAAI;IACV,MAAM,IAAI;IACV,OAAO,IAAI;IACX,OAAO,IAAI;IACX,MAAM,IAAI;CACX;AAED;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,OAAO,IAAI;CACZ;AAED;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAAG,uBAAuB,GAAG,SAAS,CAAC;AAEnF;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAClC,gCAAgC,GAChC,KAAK,CAAC,gCAAgC,CAAC,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,CAAC,OAAO,EAAE,MAAM,GACZ,0BAA0B,GAC1B,uBAAuB,GACvB,KAAK,CAAC,uBAAuB,GAAG,SAAS,CAAC,GAC1C,SAAS,CAAC;CACf"}

package/dist/src/argument/ArgumentValueTypes.js

@@ -1,18 +0,0 @@
-/**
- * Enum of possible {@link Argument} value types.
- */
-export var ArgumentValueTypeName;
-(function (ArgumentValueTypeName) {
-    ArgumentValueTypeName[ArgumentValueTypeName["STRING"] = 0] = "STRING";
-    ArgumentValueTypeName[ArgumentValueTypeName["NUMBER"] = 1] = "NUMBER";
-    ArgumentValueTypeName[ArgumentValueTypeName["INTEGER"] = 2] = "INTEGER";
-    ArgumentValueTypeName[ArgumentValueTypeName["BOOLEAN"] = 3] = "BOOLEAN";
-    ArgumentValueTypeName[ArgumentValueTypeName["SECRET"] = 4] = "SECRET";
-})(ArgumentValueTypeName || (ArgumentValueTypeName = {}));
-/**
- * Only possible value for {@link ComplexOption.type}.
- */
-export var ComplexValueTypeName;
-(function (ComplexValueTypeName) {
-    ComplexValueTypeName[ComplexValueTypeName["COMPLEX"] = 5] = "COMPLEX";
-})(ComplexValueTypeName || (ComplexValueTypeName = {}));

package/src/argument/ArgumentValueTypes.ts

@@ -1,80 +0,0 @@
-/**
- * The type of single {@link Argument} values which are supported.
- *
- * NOTE: JavaScript does not have a special runtime value for INTEGER so this is covered by `number`.
- * NOTE: `string` is also used for PASSWORD values.
- */
-export type ArgumentSingleValueType = number | string | boolean;
-
-/**
- * The type of the value to be parsed as an argument can be: `boolean`, `number` or `string` or an array of these.
- */
-export type ArgumentValueType = ArgumentSingleValueType | Array<ArgumentSingleValueType>;
-
-/**
- * A container object for populated argument values.
- *
- * The following are all valid examples:
- *
- * * `{ }`
- * * `{ foo: 1 }`
- * * `{ foo: true }`
- * * `{ foo: 'bar' }`
- * * `{ foo: [ 1, 2 ] }`
- * * `{ foo: [ true, true ] }`
- * * `{ foo: [ 'bar', 'gar' ] }`
- * * `{ foo: { a: 1 } }`
- * * `{ foo: { a: { b: 'c'} } }`
- * * `{ foo: [ { a: { b: 'c'} }, { a: { b: 'c'} } ] }`
- *
- * An array of arrays is not allowed, so the following is an INVALID example:
- *
- * * `{ foo: [ [ 1, 2 ], [3, 4 ] ] }`
- */
-export type ArgumentValues = {
-  [argName: string]: ArgumentValueType | ArgumentValues | Array<ArgumentValues>;
-};
-
-/**
- * Enum of possible {@link Argument} value types.
- */
-export enum ArgumentValueTypeName {
-  STRING = 0,
-  NUMBER = 1,
-  INTEGER = 2,
-  BOOLEAN = 3,
-  SECRET = 4,
-}
-
-/**
- * Only possible value for {@link ComplexOption.type}.
- */
-export enum ComplexValueTypeName {
-  COMPLEX = 5,
-}
-
-/**
- * Populated single value type is very similar to {@link ArgumentSingleValueType} but allows for an illegal
- * undefined value.
- */
-export type PopulatedArgumentSingleValueType = ArgumentSingleValueType | undefined;
-
-/**
- * Populated argument value types are very similar to {@link ArgumentValueType} but allow for illegal
- * undefined values.
- */
-export type PopulatedArgumentValueType =
-  | PopulatedArgumentSingleValueType
-  | Array<PopulatedArgumentSingleValueType>;
-
-/**
- * Populated values are very similar to {@link ArgumentValues} but allow for illegal
- * undefined properties and array entries.
- */
-export interface PopulatedArgumentValues {
-  [argName: string]:
-    | PopulatedArgumentValueType
-    | PopulatedArgumentValues
-    | Array<PopulatedArgumentValues | undefined>
-    | undefined;
-}