@flowscripter/dynamic-cli-framework 6.0.1 → 7.0.0

package/dist/src/service/configuration/KeyValueServiceProvider.js

@@ -0,0 +1,201 @@
+import { KEY_VALUE_SERVICE_ID, SHUTDOWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import DefaultKeyValueService from "./DefaultKeyValueService.js";
+import DefaultSecretService from "./DefaultSecretService.js";
+/**
+ * Registered under {@link KEY_VALUE_SERVICE_ID} in the plain, undecorated {@link Context} purely
+ * so {@link Context.doesServiceExist} reports correctly - every real access goes through a
+ * per-scope instance from {@link KeyValueServiceProvider.getScopedKeyValueService}, applied
+ * via a per-call decorated {@link Context} (see `runner.ts`). Reaching any of these methods
+ * directly means that decoration was somehow bypassed.
+ */
+class UnreachableKeyValueService {
+    get() {
+        return Promise.reject(new Error(UnreachableKeyValueService.#message));
+    }
+    has() {
+        return Promise.reject(new Error(UnreachableKeyValueService.#message));
+    }
+    set() {
+        return Promise.reject(new Error(UnreachableKeyValueService.#message));
+    }
+    delete() {
+        return Promise.reject(new Error(UnreachableKeyValueService.#message));
+    }
+    static #message = "KeyValueService accessed without a resolved scope - this should be unreachable";
+}
+/**
+ * Provides a generic, per-scope key-value store for commands and services ({@link KeyValueService}).
+ *
+ * The underlying data is read from/written to the same configuration file managed by
+ * {@link ConfigurationServiceProvider} - see {@link ConfigurationServiceProvider.getKeyValueData} and
+ * {@link ConfigurationServiceProvider.flushIfDirty}, reached via a direct constructor reference wired
+ * up by `BaseCLI` (never via {@link Context}, since that would expose config-file read/write access
+ * more broadly than intended).
+ *
+ * Its `serviceId` is {@link KEY_VALUE_SERVICE_ID} and its {@link ServiceInfo.service} is a
+ * placeholder ({@link UnreachableKeyValueService}) - real access always goes through a per-consumer
+ * decorated {@link Context} from {@link getContextForScope}, applied by `runner.ts`.
+ *
+ * Any node within a value passed to {@link KeyValueService.set} can be wrapped in {@link Secret} -
+ * at any depth - to have that node, and only that node, stored as an OS-native secret. When a node
+ * is wrapped in {@link Secret}, its value (of any shape) is JSON-serialized and stored as a single
+ * OS-native secret via Bun.secrets, with a sentinel value of the format `__SECRET__:<bun_secret_name>`
+ * substituted in its place in the structure that gets stored in the config file. Everything else in
+ * the value is stored as plain (unencrypted) config data. The sentinel prefix `__SECRET__:` is
+ * reserved and must not be used for regular key-value data.
+ *
+ * Independently of how a value was written, {@link KeyValueService.get} recursively resolves any
+ * string leaf - at any depth within the retrieved value - which starts with the sentinel prefix,
+ * via the OS secret store. This means a secret reference may also be hand-embedded (nested
+ * arbitrarily deep) directly within a plain, non-secret value in the config file.
+ *
+ * Secret support requires `secretServiceEnabled=true` in the constructor (which also requires
+ * `keyValueServiceEnabled=true` on the {@link ConfigurationServiceProvider} to have config enabled).
+ *
+ * As an example of the underlying config file structure:
+ * ```
+ * {
+ *    "defaults": {
+ *        ...
+ *    },
+ *    "key-values": {
+ *        "commands": {
+ *            "command1": {
+ *               "foo1": "bar1",
+ *               "foo2": "__SECRET__:command_command1_foo2",
+ *               "foo3": {
+ *                   "nested": ["a", "__SECRET__:command_command1_foo3_nested"]
+ *               }
+ *            },
+ *            "command2": {
+ *                "foo1": "bar3"
+ *            }
+ *        },
+ *        "services": {
+ *            "service-id-1": {
+ *                "foo1": "bar"
+ *            }
+ *        }
+ *    }
+ * }
+ * ```
+ */
+export default class KeyValueServiceProvider {
+    serviceId = KEY_VALUE_SERVICE_ID;
+    servicePriority;
+    #configurationServiceProvider;
+    keyValueServiceEnabled;
+    secretServiceEnabled;
+    // per-scope KeyValueService instances, created on first request and cached thereafter - each is
+    // bound permanently to one scope's Map (and one scope-prefixed DefaultSecretService), never
+    // re-pointed. See getScopedKeyValueService().
+    #commandScopedKeyValueServices = new Map();
+    #serviceScopedKeyValueServices = new Map();
+    // used to construct scoped DefaultSecretService instances on demand.
+    #cliConfigName;
+    /**
+     * Create an instance of the service provider with the specified details.
+     *
+     * @param servicePriority the priority of the service.
+     * @param configurationServiceProvider the {@link ConfigurationServiceProvider} whose config file
+     * backs this provider's data - an internal wiring reference, never exposed further.
+     * @param keyValueServiceEnabled optionally provide a {@link KeyValueService} implementation: `configurationServiceProvider.configEnabled` must be true in this case
+     * @param secretServiceEnabled optionally enable OS-native secret storage via Bun.secrets: `configurationServiceProvider.configEnabled` must be true in this case
+     */
+    constructor(servicePriority, configurationServiceProvider, keyValueServiceEnabled = false, secretServiceEnabled = false) {
+        if (!configurationServiceProvider.configEnabled && keyValueServiceEnabled) {
+            throw new Error("configEnabled must be true if keyValueServiceEnabled is true");
+        }
+        if (!configurationServiceProvider.configEnabled && secretServiceEnabled) {
+            throw new Error("configEnabled must be true if secretServiceEnabled is true");
+        }
+        this.servicePriority = servicePriority;
+        this.#configurationServiceProvider = configurationServiceProvider;
+        this.keyValueServiceEnabled = keyValueServiceEnabled;
+        this.secretServiceEnabled = secretServiceEnabled;
+    }
+    getServiceInfo(cliConfig) {
+        this.#cliConfigName = cliConfig.name;
+        return Promise.resolve({
+            // this is a placeholder - see UnreachableKeyValueService - unless neither is enabled
+            service: this.keyValueServiceEnabled || this.secretServiceEnabled
+                ? new UnreachableKeyValueService()
+                : undefined,
+            commands: [],
+        });
+    }
+    /**
+     * Return the {@link KeyValueService} bound to the given scope, creating (and caching) it on
+     * first request. The returned instance is permanently bound to that scope's data and secret
+     * prefix - it is never re-pointed, so it may be held and used for as long as its owning
+     * command/service/task is alive without racing any other scope's window.
+     *
+     * @param scopeType whether `scopeKey` is a command name or a service/task ID.
+     * @param scopeKey the command name or service/task ID to scope the key-value data to.
+     *
+     * @throws {Error} if neither `keyValueServiceEnabled` nor `secretServiceEnabled` is set.
+     */
+    getScopedKeyValueService(scopeType, scopeKey) {
+        if (!this.keyValueServiceEnabled && !this.secretServiceEnabled) {
+            throw new Error(`Attempt to use KeyValueService/SecretService which is not enabled`);
+        }
+        const scopedServices = scopeType === "command"
+            ? this.#commandScopedKeyValueServices
+            : this.#serviceScopedKeyValueServices;
+        const cached = scopedServices.get(scopeKey);
+        if (cached) {
+            return cached;
+        }
+        const keyValueData = this.#configurationServiceProvider.getKeyValueData(scopeType, scopeKey);
+        const secretService = this.secretServiceEnabled
+            ? new DefaultSecretService(this.#cliConfigName, `${scopeType}_${scopeKey}`)
+            : undefined;
+        const scopedService = new DefaultKeyValueService(keyValueData, secretService);
+        scopedServices.set(scopeKey, scopedService);
+        return scopedService;
+    }
+    /**
+     * Return a {@link Context} which delegates every lookup to `context` unchanged, except
+     * `getServiceById(KEY_VALUE_SERVICE_ID)`, which resolves to the scope-bound instance from
+     * {@link getScopedKeyValueService} for the given scope. Used by `runner.ts` to give each
+     * command/service/task a KeyValueService isolated to its own scope, invisibly at the call site.
+     *
+     * Returns `context` itself, unchanged, if neither `keyValueServiceEnabled` nor
+     * `secretServiceEnabled` is set.
+     */
+    getContextForScope(context, scopeType, scopeKey) {
+        if (!this.keyValueServiceEnabled && !this.secretServiceEnabled) {
+            return context;
+        }
+        const scopedKeyValueService = this.getScopedKeyValueService(scopeType, scopeKey);
+        return {
+            cliConfig: context.cliConfig,
+            getServiceById: (id) => id === KEY_VALUE_SERVICE_ID ? scopedKeyValueService : context.getServiceById(id),
+            doesServiceExist: (id) => context.doesServiceExist(id),
+        };
+    }
+    /**
+     * Flush every scoped KeyValueService's data to the configuration file, if any of them report
+     * themselves dirty. Registered as a low-priority ShutdownTask (see {@link initService}) so it
+     * runs once, after other shutdown cleanup, regardless of how long any scope was written to.
+     */
+    async #flushDirtyScopes() {
+        const anyDirty = [
+            ...this.#commandScopedKeyValueServices.values(),
+            ...this.#serviceScopedKeyValueServices.values(),
+        ].some((service) => service.isDirty());
+        await this.#configurationServiceProvider.flushIfDirty(anyDirty);
+    }
+    async initService(context) {
+        if (this.keyValueServiceEnabled || this.secretServiceEnabled) {
+            const shutdownService = context.getServiceById(SHUTDOWN_SERVICE_ID);
+            shutdownService.registerTask({
+                id: `${KEY_VALUE_SERVICE_ID}-flush`,
+                // low priority - shutdown tasks run in descending priority order, so this runs after
+                // other shutdown cleanup (which defaults to priority 0).
+                priority: -100,
+                run: () => this.#flushDirtyScopes(),
+            });
+        }
+    }
+}

package/dist/src/service/configuration/command/ConfigCommand.d.ts

@@ -2,18 +2,17 @@ import type { GlobalModifierCommand } from "@flowscripter/dynamic-cli-framework-
 import type { GlobalCommandArgument } from "@flowscripter/dynamic-cli-framework-api";
 import { type SingleValueType } from "@flowscripter/dynamic-cli-framework-api";
 import type { Context } from "@flowscripter/dynamic-cli-framework-api";
-import type ConfigurationServiceProvider from "../ConfigurationServiceProvider.ts";
 /**
- * Command allowing the specification of the configuration file location used by the {@link ConfigurationServiceProvider}.
+ * Command allowing the specification of the configuration file location used by
+ * {@link ConfigurationServiceProvider}.
  */
 export default class ConfigCommand implements GlobalModifierCommand {
-    #private;
     readonly name = "config";
     readonly description = "Set the configuration file location";
     readonly enableConfiguration = true;
     readonly argument: GlobalCommandArgument;
     readonly executePriority: number;
-    constructor(configurationServiceProvider: ConfigurationServiceProvider, executePriority: number);
-    execute(_context: Context, argumentValue: SingleValueType): Promise<void>;
+    constructor(executePriority: number);
+    execute(context: Context, argumentValue: SingleValueType): Promise<void>;
 }
 //# sourceMappingURL=ConfigCommand.d.ts.map

package/dist/src/service/configuration/command/ConfigCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigCommand.d.ts","sourceRoot":"","sources":["../../../../../src/service/configuration/command/ConfigCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,yCAAyC,CAAC;AAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,4BAA4B,MAAM,oCAAoC,CAAC;AAEnF;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAc,YAAW,qBAAqB;;IACjE,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,yCAAyC;IAC7D,QAAQ,CAAC,mBAAmB,QAAQ;IACpC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAGtC;IACF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAIjC,YACE,4BAA4B,EAAE,4BAA4B,EAC1D,eAAe,EAAE,MAAM,EAIxB;IAEM,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/E;CACF"}
+{"version":3,"file":"ConfigCommand.d.ts","sourceRoot":"","sources":["../../../../../src/service/configuration/command/ConfigCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,yCAAyC,CAAC;AAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAMvE;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,aAAc,YAAW,qBAAqB;IACjE,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,yCAAyC;IAC7D,QAAQ,CAAC,mBAAmB,QAAQ;IACpC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAGtC;IACF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,YAAmB,eAAe,EAAE,MAAM,EAEzC;IAEM,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9E;CACF"}

package/dist/src/service/configuration/command/ConfigCommand.js

@@ -1,6 +1,8 @@
 import { ValueTypeName } from "@flowscripter/dynamic-cli-framework-api";
+import { CONFIGURATION_SERVICE_ID, } from "@flowscripter/dynamic-cli-framework-api";
 /**
- * Command allowing the specification of the configuration file location used by the {@link ConfigurationServiceProvider}.
+ * Command allowing the specification of the configuration file location used by
+ * {@link ConfigurationServiceProvider}.
  */
 export default class ConfigCommand {
     name = "config";
@@ -11,14 +13,13 @@ export default class ConfigCommand {
         configurationKey: "CONFIG",
     };
     executePriority;
-    #configurationServiceProvider;
-    constructor(configurationServiceProvider, executePriority) {
-        this.#configurationServiceProvider = configurationServiceProvider;
+    constructor(executePriority) {
         this.executePriority = executePriority;
     }
-    execute(_context, argumentValue) {
+    execute(context, argumentValue) {
         const configLocation = argumentValue;
-        this.#configurationServiceProvider.setConfigLocation(configLocation);
+        const configurationService = context.getServiceById(CONFIGURATION_SERVICE_ID);
+        configurationService.setConfigLocation(configLocation);
         return Promise.resolve();
     }
 }

package/dist/src/service/configuration/command/DumpConfigCommand.d.ts

@@ -1,14 +1,18 @@
 import type { Context } from "@flowscripter/dynamic-cli-framework-api";
 import type { GlobalCommand } from "@flowscripter/dynamic-cli-framework-api";
-import type ConfigurationServiceProvider from "../ConfigurationServiceProvider.ts";
 /**
- * Command which dumps the configuration loaded by the {@link ConfigurationServiceProvider}.
+ * Command which dumps the configuration loaded by {@link ConfigurationServiceProvider}.
+ *
+ * Takes a direct reference to {@link ConfigurationServiceProvider.getConfigString}, wired by the
+ * provider that constructs this command, rather than looking it up via {@link Context} -
+ * deliberately, since a full config dump is not something every command/task should be able to
+ * reach through a general lookup (see {@link ConfigurationService}'s doc comment).
  */
 export default class DumpConfigCommand implements GlobalCommand {
     #private;
     readonly name = "dump-config";
     readonly description = "Dump configuration values";
-    constructor(configurationServiceProvider: ConfigurationServiceProvider);
+    constructor(getConfigString: () => string);
     execute(context: Context): Promise<void>;
 }
 //# sourceMappingURL=DumpConfigCommand.d.ts.map

package/dist/src/service/configuration/command/DumpConfigCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DumpConfigCommand.d.ts","sourceRoot":"","sources":["../../../../../src/service/configuration/command/DumpConfigCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,4BAA4B,MAAM,oCAAoC,CAAC;AAMnF;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAkB,YAAW,aAAa;;IAC7D,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,+BAA+B;IAInD,YAAmB,4BAA4B,EAAE,4BAA4B,EAE5E;IAEY,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAYpD;CACF"}
+{"version":3,"file":"DumpConfigCommand.d.ts","sourceRoot":"","sources":["../../../../../src/service/configuration/command/DumpConfigCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAM7E;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAkB,YAAW,aAAa;;IAC7D,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,+BAA+B;IAInD,YAAmB,eAAe,EAAE,MAAM,MAAM,EAE/C;IAEY,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CASpD;CACF"}

package/dist/src/service/configuration/command/DumpConfigCommand.js

@@ -1,18 +1,23 @@
 import { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 import { SYNTAX_HIGHLIGHTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 /**
- * Command which dumps the configuration loaded by the {@link ConfigurationServiceProvider}.
+ * Command which dumps the configuration loaded by {@link ConfigurationServiceProvider}.
+ *
+ * Takes a direct reference to {@link ConfigurationServiceProvider.getConfigString}, wired by the
+ * provider that constructs this command, rather than looking it up via {@link Context} -
+ * deliberately, since a full config dump is not something every command/task should be able to
+ * reach through a general lookup (see {@link ConfigurationService}'s doc comment).
  */
 export default class DumpConfigCommand {
     name = "dump-config";
     description = "Dump configuration values";
-    #configurationServiceProvider;
-    constructor(configurationServiceProvider) {
-        this.#configurationServiceProvider = configurationServiceProvider;
+    #getConfigString;
+    constructor(getConfigString) {
+        this.#getConfigString = getConfigString;
     }
     async execute(context) {
         const printerService = context.getServiceById(PRINTER_SERVICE_ID);
         const syntaxHighlighterService = context.getServiceById(SYNTAX_HIGHLIGHTER_SERVICE_ID);
-        await printerService.print(`${syntaxHighlighterService.highlight(this.#configurationServiceProvider.getConfigString(), "json")}\n`);
+        await printerService.print(`${syntaxHighlighterService.highlight(this.#getConfigString(), "json")}\n`);
     }
 }

package/dist/src/service/fetch/DefaultFetchService.d.ts

@@ -1,7 +1,7 @@
-import type { FetchOptions, FetchService, ShutdownService } from "@flowscripter/dynamic-cli-framework-api";
+import type { Context, FetchOptions, FetchService } from "@flowscripter/dynamic-cli-framework-api";
 export default class DefaultFetchService implements FetchService {
     #private;
-    setDependencies(shutdownService: ShutdownService): void;
+    setContext(context: Context): void;
     fetch(input: string | URL, options?: FetchOptions): Promise<Response>;
 }
 //# sourceMappingURL=DefaultFetchService.d.ts.map

package/dist/src/service/fetch/DefaultFetchService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultFetchService.d.ts","sourceRoot":"","sources":["../../../../src/service/fetch/DefaultFetchService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EAChB,MAAM,yCAAyC,CAAC;AAKjD,MAAM,CAAC,OAAO,OAAO,mBAAoB,YAAW,YAAY;;IAGvD,eAAe,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI,CAE7D;IAEY,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqCrF;CACF"}
+{"version":3,"file":"DefaultFetchService.d.ts","sourceRoot":"","sources":["../../../../src/service/fetch/DefaultFetchService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,YAAY,EAEb,MAAM,yCAAyC,CAAC;AAMjD,MAAM,CAAC,OAAO,OAAO,mBAAoB,YAAW,YAAY;;IAGvD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExC;IAEY,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyCrF;CACF"}

package/dist/src/service/fetch/DefaultFetchService.js

@@ -1,15 +1,16 @@
+import { SHUTDOWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 import getLogger from "../../util/logger.js";
 const logger = getLogger("DefaultFetchService");
 export default class DefaultFetchService {
-    #shutdownService;
-    setDependencies(shutdownService) {
-        this.#shutdownService = shutdownService;
+    #context;
+    setContext(context) {
+        this.#context = context;
     }
     async fetch(input, options = {}) {
-        if (this.#shutdownService === undefined) {
-            throw new Error("DefaultFetchService.fetch() called before setDependencies()");
+        if (this.#context === undefined) {
+            throw new Error("DefaultFetchService.fetch() called before setContext()");
         }
-        const shutdownService = this.#shutdownService;
+        const shutdownService = this.#context.getServiceById(SHUTDOWN_SERVICE_ID);
         const { timeoutMs, longRunning = false, signal: callerSignal, ...requestInit } = options;
         const controller = new AbortController();
         const signals = [controller.signal];
@@ -23,12 +24,16 @@ export default class DefaultFetchService {
         let settled = false;
         if (longRunning) {
             shutdownService.enterLongRunningMode();
-            shutdownService.addShutdownListener(async () => {
-                if (settled) {
-                    return;
-                }
-                logger.debug(() => `Aborting fetch of '${input.toString()}' due to shutdown`);
-                controller.abort();
+            shutdownService.registerTask({
+                id: `fetch:${input.toString()}`,
+                priority: 0,
+                run: async () => {
+                    if (settled) {
+                        return;
+                    }
+                    logger.debug(() => `Aborting fetch of '${input.toString()}' due to shutdown`);
+                    controller.abort();
+                },
             });
         }
         try {

package/dist/src/service/fetch/FetchServiceProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FetchServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/fetch/FetchServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EACP,WAAW,EACX,eAAe,EAEhB,MAAM,yCAAyC,CAAC;AAIjD,MAAM,CAAC,OAAO,OAAO,oBAAqB,YAAW,eAAe;;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAoB;IAC9C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAGjC,YAAmB,eAAe,EAAE,MAAM,EAEzC;IAEM,cAAc,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAMjE;IAEM,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlD;CACF"}
+{"version":3,"file":"FetchServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/fetch/FetchServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EACP,WAAW,EACX,eAAe,EAChB,MAAM,yCAAyC,CAAC;AAIjD,MAAM,CAAC,OAAO,OAAO,oBAAqB,YAAW,eAAe;;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAoB;IAC9C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAGjC,YAAmB,eAAe,EAAE,MAAM,EAEzC;IAEM,cAAc,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAMjE;IAEM,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlD;CACF"}

package/dist/src/service/fetch/FetchServiceProvider.js

@@ -1,4 +1,4 @@
-import { FETCH_SERVICE_ID, SHUTDOWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import { FETCH_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 import DefaultFetchService from "./DefaultFetchService.js";
 export default class FetchServiceProvider {
     serviceId = FETCH_SERVICE_ID;
@@ -15,8 +15,7 @@ export default class FetchServiceProvider {
         });
     }
     initService(context) {
-        const shutdownService = context.getServiceById(SHUTDOWN_SERVICE_ID);
-        this.#fetchService.setDependencies(shutdownService);
+        this.#fetchService.setContext(context);
         return Promise.resolve();
     }
 }

package/dist/src/service/printer/PrinterServiceProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PrinterServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/printer/PrinterServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAEvE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAK9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,sBAAuB,YAAW,eAAe;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAsB;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;;;;OAKG;IACH,YAAmB,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAGzE;IAEM,cAAc,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAUjE;IAED,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ3C;CACF"}
+{"version":3,"file":"PrinterServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/printer/PrinterServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAEvE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAK9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,sBAAuB,YAAW,eAAe;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAsB;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;;;;OAKG;IACH,YAAmB,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAGzE;IAEM,cAAc,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAUjE;IAED,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3C;CACF"}

package/dist/src/service/printer/PrinterServiceProvider.js

@@ -25,18 +25,22 @@ export default class PrinterServiceProvider {
         return Promise.resolve({
             service: this.printerService,
             commands: [
-                new NoHyperlinksCommand(this, this.servicePriority + 3),
-                new DarkModeCommand(this, this.servicePriority + 2),
-                new NoColorCommand(this, this.servicePriority + 1),
-                new LogLevelCommand(this, this.servicePriority),
+                new NoHyperlinksCommand(this.servicePriority + 3),
+                new DarkModeCommand(this.servicePriority + 2),
+                new NoColorCommand(this.servicePriority + 1),
+                new LogLevelCommand(this.servicePriority),
             ],
         });
     }
     initService(context) {
         const shutdownService = context.getServiceById(SHUTDOWN_SERVICE_ID);
-        shutdownService.addShutdownListener(async () => {
-            await this.printerService.hideSpinner();
-            await this.printerService.hideAllProgressBars();
+        shutdownService.registerTask({
+            id: PRINTER_SERVICE_ID,
+            priority: 0,
+            run: async () => {
+                await this.printerService.hideSpinner();
+                await this.printerService.hideAllProgressBars();
+            },
         });
         return Promise.resolve();
     }

package/dist/src/service/printer/command/DarkModeCommand.d.ts

@@ -2,18 +2,16 @@ import type { GlobalModifierCommand } from "@flowscripter/dynamic-cli-framework-
 import type { GlobalCommandArgument } from "@flowscripter/dynamic-cli-framework-api";
 import { type SingleValueType } from "@flowscripter/dynamic-cli-framework-api";
 import type { Context } from "@flowscripter/dynamic-cli-framework-api";
-import type PrinterServiceProvider from "../PrinterServiceProvider.ts";
 /**
- * Command allowing the specification of dark/light mode for {@link PrinterServiceProvider}.
+ * Command allowing the specification of dark/light mode for the {@link PrinterService}.
  */
 export default class DarkModeCommand implements GlobalModifierCommand {
-    #private;
     readonly name = "dark-mode";
     readonly description = "Enable dark mode for output";
     readonly enableConfiguration = true;
     readonly argument: GlobalCommandArgument;
     readonly executePriority: number;
-    constructor(printerServiceProvider: PrinterServiceProvider, executePriority: number);
-    execute(_context: Context, argumentValue: SingleValueType): Promise<void>;
+    constructor(executePriority: number);
+    execute(context: Context, argumentValue: SingleValueType): Promise<void>;
 }
 //# sourceMappingURL=DarkModeCommand.d.ts.map

package/dist/src/service/printer/command/DarkModeCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DarkModeCommand.d.ts","sourceRoot":"","sources":["../../../../../src/service/printer/command/DarkModeCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,yCAAyC,CAAC;AAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,sBAAsB,MAAM,8BAA8B,CAAC;AAEvE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,YAAW,qBAAqB;;IACnE,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,iCAAiC;IACrD,QAAQ,CAAC,mBAAmB,QAAQ;IACpC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAItC;IACF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAIjC,YAAmB,sBAAsB,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,EAGzF;IAEM,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/E;CACF"}
+{"version":3,"file":"DarkModeCommand.d.ts","sourceRoot":"","sources":["../../../../../src/service/printer/command/DarkModeCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,yCAAyC,CAAC;AAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAIvE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,YAAW,qBAAqB;IACnE,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,iCAAiC;IACrD,QAAQ,CAAC,mBAAmB,QAAQ;IACpC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAItC;IACF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,YAAmB,eAAe,EAAE,MAAM,EAEzC;IAEM,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9E;CACF"}

package/dist/src/service/printer/command/DarkModeCommand.js

@@ -1,6 +1,7 @@
 import { ValueTypeName } from "@flowscripter/dynamic-cli-framework-api";
+import { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 /**
- * Command allowing the specification of dark/light mode for {@link PrinterServiceProvider}.
+ * Command allowing the specification of dark/light mode for the {@link PrinterService}.
  */
 export default class DarkModeCommand {
     name = "dark-mode";
@@ -12,13 +13,12 @@ export default class DarkModeCommand {
         configurationKey: "DARK_MODE",
     };
     executePriority;
-    #printerServiceProvider;
-    constructor(printerServiceProvider, executePriority) {
-        this.#printerServiceProvider = printerServiceProvider;
+    constructor(executePriority) {
         this.executePriority = executePriority;
     }
-    execute(_context, argumentValue) {
-        this.#printerServiceProvider.printerService.darkMode = argumentValue;
+    execute(context, argumentValue) {
+        const printerService = context.getServiceById(PRINTER_SERVICE_ID);
+        printerService.darkMode = argumentValue;
         return Promise.resolve();
     }
 }

package/dist/src/service/printer/command/LogLevelCommand.d.ts

@@ -2,18 +2,16 @@ import type { GlobalCommandArgument } from "@flowscripter/dynamic-cli-framework-
 import { type SingleValueType } from "@flowscripter/dynamic-cli-framework-api";
 import type { GlobalModifierCommand } from "@flowscripter/dynamic-cli-framework-api";
 import type { Context } from "@flowscripter/dynamic-cli-framework-api";
-import type PrinterServiceProvider from "../PrinterServiceProvider.ts";
 /**
- * Command allowing the setting of the log level for {@link PrinterServiceProvider}.
+ * Command allowing the setting of the log level for the {@link PrinterService}.
  */
 export default class LogLevelCommand implements GlobalModifierCommand {
-    #private;
     readonly name = "log-level";
     readonly description = "Set the logging threshold";
     readonly enableConfiguration = true;
     readonly argument: GlobalCommandArgument;
     readonly executePriority: number;
-    constructor(printerServiceProvider: PrinterServiceProvider, executePriority: number);
-    execute(_context: Context, argumentValue: SingleValueType): Promise<void>;
+    constructor(executePriority: number);
+    execute(context: Context, argumentValue: SingleValueType): Promise<void>;
 }
 //# sourceMappingURL=LogLevelCommand.d.ts.map

package/dist/src/service/printer/command/LogLevelCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LogLevelCommand.d.ts","sourceRoot":"","sources":["../../../../../src/service/printer/command/LogLevelCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,yCAAyC,CAAC;AAC9F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,sBAAsB,MAAM,8BAA8B,CAAC;AAGvE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,YAAW,qBAAqB;;IACnE,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,+BAA+B;IACnD,QAAQ,CAAC,mBAAmB,QAAQ;IACpC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAMtC;IACF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAIjC,YAAmB,sBAAsB,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,EAGzF;IAEM,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB/E;CACF"}
+{"version":3,"file":"LogLevelCommand.d.ts","sourceRoot":"","sources":["../../../../../src/service/printer/command/LogLevelCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,yCAAyC,CAAC;AAC9F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAKvE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,YAAW,qBAAqB;IACnE,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,+BAA+B;IACnD,QAAQ,CAAC,mBAAmB,QAAQ;IACpC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAMtC;IACF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,YAAmB,eAAe,EAAE,MAAM,EAEzC;IAEM,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9E;CACF"}

package/dist/src/service/printer/command/LogLevelCommand.js

@@ -1,7 +1,8 @@
 import { ValueTypeName } from "@flowscripter/dynamic-cli-framework-api";
+import { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 import { Level } from "@flowscripter/dynamic-cli-framework-api";
 /**
- * Command allowing the setting of the log level for {@link PrinterServiceProvider}.
+ * Command allowing the setting of the log level for the {@link PrinterService}.
  */
 export default class LogLevelCommand {
     name = "log-level";
@@ -15,25 +16,24 @@ export default class LogLevelCommand {
         configurationKey: "LOG_LEVEL",
     };
     executePriority;
-    #printerServiceProvider;
-    constructor(printerServiceProvider, executePriority) {
-        this.#printerServiceProvider = printerServiceProvider;
+    constructor(executePriority) {
         this.executePriority = executePriority;
     }
-    execute(_context, argumentValue) {
+    execute(context, argumentValue) {
+        const printerService = context.getServiceById(PRINTER_SERVICE_ID);
         const logLevel = argumentValue;
         switch (logLevel.toUpperCase()) {
             case "DEBUG":
-                this.#printerServiceProvider.printerService.setLevel(Level.DEBUG);
+                printerService.setLevel(Level.DEBUG);
                 break;
             case "INFO":
-                this.#printerServiceProvider.printerService.setLevel(Level.INFO);
+                printerService.setLevel(Level.INFO);
                 break;
             case "WARN":
-                this.#printerServiceProvider.printerService.setLevel(Level.WARN);
+                printerService.setLevel(Level.WARN);
                 break;
             case "ERROR":
-                this.#printerServiceProvider.printerService.setLevel(Level.ERROR);
+                printerService.setLevel(Level.ERROR);
                 break;
         }
         return Promise.resolve();

package/dist/src/service/printer/command/NoColorCommand.d.ts

@@ -2,18 +2,16 @@ import type { GlobalModifierCommand } from "@flowscripter/dynamic-cli-framework-
 import type { GlobalCommandArgument } from "@flowscripter/dynamic-cli-framework-api";
 import { type SingleValueType } from "@flowscripter/dynamic-cli-framework-api";
 import type { Context } from "@flowscripter/dynamic-cli-framework-api";
-import type PrinterServiceProvider from "../PrinterServiceProvider.ts";
 /**
- * Command allowing the disabling of color for {@link PrinterServiceProvider}.
+ * Command allowing the disabling of color for the {@link PrinterService}.
  */
 export default class NoColorCommand implements GlobalModifierCommand {
-    #private;
     readonly name = "no-color";
     readonly description = "Disable color for output";
     readonly enableConfiguration = true;
     readonly argument: GlobalCommandArgument;
     readonly executePriority: number;
-    constructor(printerServiceProvider: PrinterServiceProvider, executePriority: number);
-    execute(_context: Context, argumentValue: SingleValueType): Promise<void>;
+    constructor(executePriority: number);
+    execute(context: Context, argumentValue: SingleValueType): Promise<void>;
 }
 //# sourceMappingURL=NoColorCommand.d.ts.map

package/dist/src/service/printer/command/NoColorCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NoColorCommand.d.ts","sourceRoot":"","sources":["../../../../../src/service/printer/command/NoColorCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,yCAAyC,CAAC;AAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,sBAAsB,MAAM,8BAA8B,CAAC;AAEvE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,YAAW,qBAAqB;;IAClE,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,8BAA8B;IAClD,QAAQ,CAAC,mBAAmB,QAAQ;IACpC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAItC;IACF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAIjC,YAAmB,sBAAsB,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,EAGzF;IAEM,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/E;CACF"}
+{"version":3,"file":"NoColorCommand.d.ts","sourceRoot":"","sources":["../../../../../src/service/printer/command/NoColorCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,yCAAyC,CAAC;AAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAIvE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,YAAW,qBAAqB;IAClE,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,8BAA8B;IAClD,QAAQ,CAAC,mBAAmB,QAAQ;IACpC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAItC;IACF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,YAAmB,eAAe,EAAE,MAAM,EAEzC;IAEM,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9E;CACF"}

package/dist/src/service/printer/command/NoColorCommand.js

@@ -1,6 +1,7 @@
 import { ValueTypeName } from "@flowscripter/dynamic-cli-framework-api";
+import { PRINTER_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 /**
- * Command allowing the disabling of color for {@link PrinterServiceProvider}.
+ * Command allowing the disabling of color for the {@link PrinterService}.
  */
 export default class NoColorCommand {
     name = "no-color";
@@ -12,13 +13,12 @@ export default class NoColorCommand {
         configurationKey: "NO_COLOR",
     };
     executePriority;
-    #printerServiceProvider;
-    constructor(printerServiceProvider, executePriority) {
-        this.#printerServiceProvider = printerServiceProvider;
+    constructor(executePriority) {
         this.executePriority = executePriority;
     }
-    execute(_context, argumentValue) {
-        this.#printerServiceProvider.printerService.colorEnabled = !argumentValue;
+    execute(context, argumentValue) {
+        const printerService = context.getServiceById(PRINTER_SERVICE_ID);
+        printerService.colorEnabled = !argumentValue;
         return Promise.resolve();
     }
 }