@seamapi/cli 0.18.1 → 0.19.0

package/README.md

@@ -22,7 +22,9 @@ $ npm install --global @seamapi/cli
 ```
 
 Alternatively, download a standalone binary for your platform from the
-[latest GitHub release].
+[latest GitHub release]. The macOS binaries are signed with the Seam Labs, Inc.
+Apple Developer ID and notarized by Apple, so macOS runs them without
+a Gatekeeper prompt.
 
 On Arch Linux, install the [`seam-bin`][aur] package from the AUR with
 
@@ -396,6 +398,58 @@ The following repository secrets must be set on [GitHub Actions]:
 [GitHub Actions]: https://github.com/features/actions
 [GPG private key]: https://github.com/marketplace/actions/import-gpg#prerequisites
 
+### Signing the macOS binaries
+
+The standalone macOS binaries are code signed and notarized while they are
+built, so that Gatekeeper lets them run on machines other than the one that
+built them. Both need an [Apple Developer Program] membership.
+
+Anything that releases signs, and fails rather than publish a binary that
+macOS refuses to run. A check builds the macOS binaries with `sign: false`
+instead: a pull request from a fork cannot read the credentials, and nothing a
+check builds is ever released. There is no ad-hoc signature fallback, since
+Gatekeeper rejects one anywhere but the machine that made it.
+
+Set these repository secrets to code sign:
+
+- `APPLE_CERTIFICATE`: A base64 encoded PKCS#12 (`.p12`) bundle holding a
+  [Developer ID Application] certificate, its private key, and its certificate
+  chain. Export it from Keychain Access, then encode it with
+  `base64 --input certificate.p12 | pbcopy`.
+- `APPLE_CERTIFICATE_PASSWORD`: The password set while exporting the bundle.
+- `APPLE_SIGNING_IDENTITY`: Normally left unset. The build signs with the one
+  Developer ID Application identity in the bundle, so this is only needed to
+  choose between several, e.g.,
+  `Developer ID Application: Seam Labs, Inc. (XXXXXXXXXX)`.
+
+And these to notarize, from an [App Store Connect API key]:
+
+- `APPLE_API_KEY`: The base64 encoded API private key (`.p8`).
+- `APPLE_API_KEY_ID`: The API key id.
+- `APPLE_API_ISSUER_ID`: The API key issuer id.
+
+Notarization tickets cannot be stapled to a bare executable, so Gatekeeper
+looks them up online the first time a downloaded binary runs.
+
+Check the credentials without cutting a release by triggering
+[a build workflow_dispatch on GitHub Actions], on the web or with
+
+```
+$ gh workflow run build.yml --ref <branch>
+```
+
+GitHub only offers a workflow_dispatch for a workflow already on the default
+branch, so the build workflow must be merged first. It then runs against any
+branch.
+
+Then confirm the run's macOS binaries job signed and notarized: it verifies the
+signature, assesses the binary the way Gatekeeper does, and runs it.
+
+[App Store Connect API key]: https://developer.apple.com/documentation/appstoreconnectapi/creating-api-keys-for-app-store-connect-api
+[Apple Developer Program]: https://developer.apple.com/programs/
+[Developer ID Application]: https://developer.apple.com/help/account/reference/certificate-types/
+[a build workflow_dispatch on GitHub Actions]: https://github.com/seamapi/cli/actions?query=workflow%3A_build
+
 ## Contributing
 
 > If using squash merge, edit and ensure the commit message follows the [Angular Commit Message Conventions] specification.

package/bin/cli.js

@@ -1,34 +1,27 @@
 #!/usr/bin/env node
-import { randomBytes } from 'node:crypto';
 import { isDeepStrictEqual as isEqual } from 'node:util';
 import chalk from 'chalk';
-import { findLocalCommand, getCommandSpec } from '../lib/command-spec.js';
-import { completionShells, isCompletionShell, renderCompletion, } from '../lib/completion/index.js';
+import { cliFlags, getInteractivity, parseCliArgs, toParameterName, } from '../lib/args/parse.js';
+import { assertKnownArgs } from '../lib/args/validate.js';
+import { getApiBlueprint } from '../lib/blueprint/index.js';
+import { printCompletion } from '../lib/commands/local/completion.js';
+import { runWizard } from '../lib/commands/local/wizard.js';
+import { acceptedParamsOf, buildRegistry, findLocalCommand, } from '../lib/commands/registry.js';
 import { getConfigStore } from '../lib/config/index.js';
-import { assertEnvVarUnset, endpointEnvVar, EnvVarOverrideError, getEndpointFromEnv, getTokenFromEnv, getWorkspaceIdFromEnv, tokenEnvVar, workspaceIdEnvVar, } from '../lib/env.js';
-import { getApiBlueprint } from '../lib/get-api-blueprint.js';
-import { getCommandBlueprintDef } from '../lib/get-command-blueprint-def.js';
-import { getToken } from '../lib/get-credentials.js';
-import { getResponseKey } from '../lib/get-response-key.js';
-import { getServer } from '../lib/get-server.js';
-import { interactForActionAttemptPoll } from '../lib/interact-for-action-attempt-poll.js';
-import { interactForCommandParams } from '../lib/interact-for-command-params.js';
-import { interactForCommandSelection } from '../lib/interact-for-command-selection.js';
-import { interactForLogin } from '../lib/interact-for-login.js';
-import { interactForServerSelection } from '../lib/interact-for-server-selection.js';
-import { interactForUseRemoteApiDefs } from '../lib/interact-for-use-remote-api-defs.js';
-import { interactForWorkspaceId } from '../lib/interact-for-workspace-id.js';
-import { createOutput } from '../lib/output/create-output.js';
+import { resolveAuth } from '../lib/context.js';
+import { tokenEnvVar } from '../lib/env.js';
+import { reportErrorAndExit } from '../lib/errors.js';
+import { createSeamApi } from '../lib/http/api.js';
+import { interactForCommandSelection } from '../lib/interactions/index.js';
 import { getOutput, setOutput } from '../lib/output/get-output.js';
+import { createOutput } from '../lib/output/output.js';
+import { readStdinJson } from '../lib/output/read-stdin-json.js';
 import { resolveOutputFormat } from '../lib/output/resolve-output-format.js';
-import { renderHelp } from '../lib/render-help.js';
-import { cliFlags, getInteractivity, NonInteractiveError, parseCliArgs, toGivenArgName, toParameterName, UsageError, } from '../lib/util/cli-args.js';
-import { canPrompt, PromptCancelledError, promptConfirm, } from '../lib/util/prompt.js';
-import { readStdinJson } from '../lib/util/read-stdin-json.js';
-import { RequestSeamApi } from '../lib/util/request-seam-api.js';
-import { validateToken } from '../lib/validate-token.js';
+import { canPrompt } from '../lib/prompt.js';
+import { completionShells, isCompletionShell, } from '../lib/render/completion/index.js';
+import { renderHelp } from '../lib/render/help.js';
 import seamapiCliVersion from '../lib/version.js';
-async function cli(args) {
+async function cli(args, argv) {
     const config = getConfigStore();
     const output = getOutput();
     const update = args['update'] === true;
@@ -36,7 +29,8 @@ async function cli(args) {
     if (helpFlag != null) {
         // Help comes from the cached API definitions so that it works without
         // logging in, and offline once the cache is warm.
-        const spec = getCommandSpec(await getApiBlueprint(false, { update }));
+        const cachedBlueprint = await getApiBlueprint({ update });
+        const { spec } = buildRegistry(cachedBlueprint);
         // minimist reads the word after --help as its value, so 'seam --help
         // devices' asks about devices just as 'seam devices --help' does.
         const commandPath = [
@@ -88,231 +82,80 @@ async function cli(args) {
             process.exitCode = 1;
             return;
         }
-        assertKnownArgs(argParams, ['completion', shell]);
-        // Completions always come from the cached API definitions so that they
-        // can be generated without logging in. They may lag the definitions
-        // served by Seam when config use-remote-api-defs is enabled.
-        output.text(renderCompletion(shell, await getApiBlueprint(false, { update })));
-        return;
-    }
-    if (args._[0] === 'config' &&
-        args._[1] === 'set' &&
-        args._[2] === 'fake-server') {
-        assertEnvVarUnset(endpointEnvVar, getEndpointFromEnv(), 'select a server');
-        assertEnvVarUnset(tokenEnvVar, getTokenFromEnv(), 'log in');
-        const randomstring = randomBytes(5).toString('hex');
-        const fakeApiUrl = `https://${randomstring}.fakeseamconnect.seam.vc`;
-        config.set('server', fakeApiUrl);
-        output.info(`Server URL set to ${fakeApiUrl}`);
-        config.set(`${getServer()}.pat`, `seam_apikey1_token`);
-        output.info(`PAT set to use fakeseamconnect with "seam_apikey1_token"`);
-        return;
-    }
-    if (getToken() == null &&
-        args._[0] !== 'login' &&
-        !isEqual(args._, ['select', 'server'])) {
+        const command = findLocalCommand(['completion', shell]);
+        assertKnownArgs(argParams, ['completion', shell], {
+            accepted: command == null ? new Set() : acceptedParamsOf(command.definition),
+            isLocal: true,
+        });
+        const cachedBlueprint = await getApiBlueprint({ update });
+        printCompletion(shell, buildRegistry(cachedBlueprint).spec);
+        return;
+    }
+    const localCommand = findLocalCommand(args._);
+    // Commands declared not to need a token bypass the login gate. A partial
+    // path keeps the historical rule: only login and select server may be
+    // reached logged out.
+    const requiresAuth = localCommand != null
+        ? localCommand.requiresAuth
+        : !(args._[0] === 'login' || isEqual(args._, ['select', 'server']));
+    if (requiresAuth && resolveAuth(config).token == null) {
         output.error(`Not logged in. Please run "seam login" or set ${tokenEnvVar}`);
         process.exitCode = 1;
         return;
     }
     const useRemoteApiDefs = args['remote_api_defs'] ?? config.get('use_remote_api_defs');
-    const blueprint = await getApiBlueprint(useRemoteApiDefs ?? false, {
+    const blueprint = await getApiBlueprint({
+        useRemoteDefinitions: useRemoteApiDefs ?? false,
         update,
     });
+    const registry = buildRegistry(blueprint);
     // Params piped or redirected in, e.g., `seam devices list < params.json`.
-    // Params given as arguments take precedence over these.
-    const commandParams = { ...(await readStdinJson()) };
+    const pipedParams = await readStdinJson();
+    const stdinParams = { ...pipedParams };
+    const auth = resolveAuth(config);
+    let seamApi = null;
     const ctx = {
+        config,
+        auth,
+        output,
         blueprint,
         interactivity: getInteractivity(args, { canPrompt: canPrompt() }),
+        api: async () => await (seamApi ??= createSeamApi(auth)),
     };
-    const isNonInteractive = ctx.interactivity === 'non-interactive';
-    Object.assign(commandParams, argParams);
-    const selectedCommand = await interactForCommandSelection(args._, ctx);
-    // Hit 'back' on a top-level command path, so we start again
-    if (selectedCommand.slice(-1)[0] === '[Back]') {
-        return await cli({
-            ...args,
-            _: [],
+    const selectableCommands = registry.spec.commands.map(({ path }) => path);
+    let commandPath = args._;
+    while (true) {
+        const selectedCommand = await interactForCommandSelection(commandPath, {
+            commands: selectableCommands,
+            interactivity: ctx.interactivity,
         });
-    }
-    // Check the arguments before the command acts on any of them, so a mistake
-    // is reported rather than half applied.
-    assertKnownArgs(argParams, selectedCommand, ctx);
-    if (isEqual(selectedCommand, ['login'])) {
-        // Nothing is stored while the environment overrides it, so refuse before
-        // storing anything rather than part way through.
-        assertEnvVarUnset(tokenEnvVar, getTokenFromEnv(), 'log in');
-        if (args['server']) {
-            assertEnvVarUnset(endpointEnvVar, getEndpointFromEnv(), 'select a server');
-        }
-        if (args['workspace_id']) {
-            assertEnvVarUnset(workspaceIdEnvVar, getWorkspaceIdFromEnv(), 'select a workspace');
-        }
-        if (args['server']) {
-            config.set('server', args['server']);
-            config.delete('current_workspace_id');
-        }
-        if (args['token']) {
-            const token = String(args['token']).trim();
-            await validateToken(token, args['workspace_id']);
-            config.set(`${getServer()}.pat`, token);
-            config.delete('current_workspace_id');
-        }
-        if (args['workspace_id']) {
-            config.set(`current_workspace_id`, args['workspace_id']);
-        }
-        if (args['token'] || args['workspace_id'] || args['server']) {
-            return;
-        }
-        if (isNonInteractive) {
-            throw new NonInteractiveError('Missing required parameter for login: --token');
-        }
-        await interactForLogin();
-        return;
-    }
-    else if (isEqual(selectedCommand, ['logout'])) {
-        assertEnvVarUnset(tokenEnvVar, getTokenFromEnv(), 'log out');
-        config.delete(`${getServer()}.pat`);
-        config.delete('current_workspace_id');
-        output.info('Logged out!');
-        return;
-    }
-    else if (isEqual(selectedCommand, ['config', 'reveal-location'])) {
-        output.text(config.path);
-        return;
-    }
-    else if (isEqual(selectedCommand, ['config', 'use-remote-api-defs'])) {
-        if (isNonInteractive) {
-            throw new NonInteractiveError('Cannot select whether to use remote API definitions in non-interactive mode');
-        }
-        await interactForUseRemoteApiDefs();
-        return;
-    }
-    else if (isEqual(selectedCommand, ['select', 'workspace'])) {
-        assertEnvVarUnset(workspaceIdEnvVar, getWorkspaceIdFromEnv(), 'select a workspace');
-        if (isNonInteractive) {
-            throw new NonInteractiveError('Cannot select a workspace in non-interactive mode: pass --workspace-id to "seam login"');
-        }
-        await interactForWorkspaceId();
-        return;
-    }
-    else if (isEqual(selectedCommand, ['events', 'list'])) {
-        if (!commandParams['since']) {
-            const date = new Date();
-            date.setMonth(date.getMonth() - 1);
-            commandParams['since'] = date.toISOString();
-        }
-    }
-    else if (isEqual(selectedCommand, ['select', 'server'])) {
-        assertEnvVarUnset(endpointEnvVar, getEndpointFromEnv(), 'select a server');
-        if (args['server']) {
-            config.set('server', args['server']);
-            config.delete('current_workspace_id');
-            return;
+        // Hit 'back' on a top-level command path, so we start again
+        if (selectedCommand.at(-1) === '[Back]') {
+            commandPath = [];
+            continue;
         }
-        if (isNonInteractive) {
-            throw new NonInteractiveError('Missing required parameter for select server: --server');
+        const command = registry.find(selectedCommand);
+        if (command == null) {
+            throw new Error(`No definition for command seam ${selectedCommand.join(' ')}`);
         }
-        await interactForServerSelection();
-        return;
-    }
-    else if (isEqual(selectedCommand, ['health', 'get-health'])) {
-        await RequestSeamApi({
-            path: '/health/get_health',
-            params: {},
+        // Check the arguments before the command acts on any of them, so a
+        // mistake is reported rather than half applied.
+        assertKnownArgs(argParams, selectedCommand, {
+            accepted: acceptedParamsOf(command.definition),
+            isLocal: findLocalCommand(selectedCommand) != null,
         });
+        const result = await command.execute({ path: selectedCommand, argParams, stdinParams, args, argv }, ctx);
+        if (result.kind === 'back') {
+            commandPath = result.toPath;
+            continue;
+        }
         return;
     }
-    // TODO - do this using the OpenAPI spec for the command rather than
-    // explicitly encoding the property names
-    if (commandParams['accepted_providers']) {
-        commandParams['accepted_providers'] =
-            commandParams['accepted_providers'].split(',');
-    }
-    const apiPath = `/${selectedCommand.join('/').replace(/-/g, '_')}`;
-    const params = await interactForCommandParams({ command: selectedCommand, params: commandParams }, ctx);
-    if (params === '[Back]') {
-        const previousCommands = [...selectedCommand];
-        previousCommands.pop();
-        return await cli({
-            ...args,
-            _: previousCommands,
-        });
-    }
-    if (apiPath.includes('/events/list') && params.between) {
-        delete params.since;
-    }
-    const response = await RequestSeamApi({
-        path: apiPath,
-        params,
-        responseKey: getResponseKey(selectedCommand, ctx),
-    });
-    if (response.data?.connect_webview) {
-        await handleConnectWebviewResponse(response.data.connect_webview, ctx.interactivity);
-    }
-    if (response.data?.action_attempt && !isNonInteractive) {
-        await interactForActionAttemptPoll(response.data.action_attempt);
-    }
 }
 const toCommandWord = (arg) => arg.toLowerCase().replace(/_/g, '-');
-/**
- * Report any argument the command does not accept, rather than acting on it.
- * An unrecognized argument is a mistake: forwarded to the API it would fail
- * somewhere less obvious or be quietly ignored, and on a command the CLI
- * handles itself it would go nowhere at all.
- *
- * Only arguments are checked. Params read from stdin are passed through as
- * given, so a caller may send whatever the API itself accepts.
- *
- * `ctx` is only needed to look up an endpoint's parameters, so commands the
- * CLI declares itself can be checked before any blueprint is loaded.
- */
-const assertKnownArgs = (argParams, command, ctx) => {
-    const local = findLocalCommand(command);
-    let accepted;
-    if (local != null) {
-        accepted = new Set(local.flags.flatMap(({ long }) => long == null ? [] : [toParameterName(long)]));
-    }
-    else if (ctx != null) {
-        accepted = new Set(getCommandBlueprintDef(command, ctx).request.parameters.map(({ name }) => name));
-    }
-    else {
-        throw new Error(`No definition for command seam ${command.join(' ')}`);
-    }
-    const unknown = Object.keys(argParams).filter((key) => !accepted.has(key));
-    if (unknown.length === 0)
-        return;
-    // Name an endpoint command by its path, as missing params are named, and a
-    // command the CLI handles itself by the words that run it.
-    const target = local == null
-        ? `/${command.join('/').replace(/-/g, '_')}`
-        : command.join(' ');
-    throw new UsageError(`Unknown ${unknown.length === 1 ? 'parameter' : 'parameters'} for ${target}: ${unknown.map(toGivenArgName).join(' ')}`, {
-        hint: `Run 'seam ${command.join(' ')} --help' to see what it accepts.`,
-    });
-};
-const handleConnectWebviewResponse = async (connectWebview, interactivity) => {
-    const url = connectWebview.url;
-    if (interactivity !== 'non-interactive' &&
-        process.env['INSIDE_WEB_BROWSER'] !== '1') {
-        const action = await promptConfirm({
-            message: 'Would you like to open the webview in your browser?',
-            initialValue: false,
-        });
-        if (action) {
-            const { default: open } = await import('open');
-            await open(url);
-        }
-    }
-};
 const run = async (argv) => {
     if (argv[0] === 'wizard') {
-        const { default: wizard } = await import('@seamapi/wizard');
-        await wizard({
-            argv: argv.slice(1),
-            commandName: 'seam wizard',
-        });
+        await runWizard(argv.slice(1));
         return;
     }
     const args = parseCliArgs(argv);
@@ -321,28 +164,9 @@ const run = async (argv) => {
         format: resolveOutputFormat(argv, { isTty }),
         colors: isTty,
     }));
-    await cli(args);
+    await cli(args, argv);
 };
 run(process.argv.slice(2)).catch((e) => {
-    const output = getOutput();
-    process.exitCode = 1;
-    if (e instanceof UsageError) {
-        output.error(chalk.red(e.message));
-        if (e.hint !== '')
-            output.error(e.hint);
-        return;
-    }
-    if (e instanceof NonInteractiveError || e instanceof EnvVarOverrideError) {
-        output.error(chalk.red(e.message));
-        return;
-    }
-    if (e instanceof PromptCancelledError) {
-        output.error(chalk.gray(e.message));
-        return;
-    }
-    const error = e instanceof Error ? e : new Error(String(e));
-    output.error(chalk.red(`CLI Error: ${error.message}`));
-    if (error.stack != null)
-        output.error(chalk.gray(error.stack));
+    reportErrorAndExit(e, getOutput());
 });
 //# sourceMappingURL=cli.js.map

package/bin/cli.js.map

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

package/lib/args/coerce.d.ts

@@ -0,0 +1,28 @@
+import type { Parameter } from '@seamapi/blueprint';
+/** An argument whose value does not fit the parameter's documented format. */
+export interface CoercionIssue {
+    name: string;
+    given: unknown;
+    /** What the parameter takes, e.g., `a number`. */
+    expected: string;
+}
+type Coerced = {
+    value: unknown;
+} | {
+    issue: string;
+};
+/**
+ * Read each argument as the JSON value its parameter documents: booleans and
+ * numbers become real booleans and numbers, lists split on commas, objects
+ * parse as JSON. The request body is then the same whether a value arrived
+ * as an argument, over stdin, or interactively.
+ *
+ * An argument naming no parameter passes through unchanged: unknown
+ * arguments are reported by `assertKnownArgs`, not silently dropped here.
+ */
+export declare const coerceArgParams: (parameters: Parameter[], argParams: Record<string, unknown>) => {
+    params: Record<string, unknown>;
+    issues: CoercionIssue[];
+};
+export declare const coerceParam: (parameter: Parameter, given: unknown) => Coerced;
+export {};

package/lib/args/coerce.js

@@ -0,0 +1,131 @@
+/**
+ * Read each argument as the JSON value its parameter documents: booleans and
+ * numbers become real booleans and numbers, lists split on commas, objects
+ * parse as JSON. The request body is then the same whether a value arrived
+ * as an argument, over stdin, or interactively.
+ *
+ * An argument naming no parameter passes through unchanged: unknown
+ * arguments are reported by `assertKnownArgs`, not silently dropped here.
+ */
+export const coerceArgParams = (parameters, argParams) => {
+    const byName = new Map(parameters.map((parameter) => [parameter.name, parameter]));
+    const params = {};
+    const issues = [];
+    for (const [name, given] of Object.entries(argParams)) {
+        const parameter = byName.get(name);
+        if (parameter == null) {
+            params[name] = given;
+            continue;
+        }
+        const coerced = coerceParam(parameter, given);
+        if ('issue' in coerced) {
+            issues.push({ name, given, expected: coerced.issue });
+            continue;
+        }
+        params[name] = coerced.value;
+    }
+    return { params, issues };
+};
+export const coerceParam = (parameter, given) => {
+    // `null` is an explicit JSON value for nullable parameters, not the string
+    // "null" (or a one-item list containing it).
+    if (parameter.isNullable && (given === null || given === 'null')) {
+        return { value: null };
+    }
+    if (parameter.format === 'list')
+        return coerceList(parameter, given);
+    // A repeated argument parses as an array, which only a list accepts.
+    if (Array.isArray(given))
+        return { issue: 'a single value' };
+    switch (parameter.format) {
+        case 'boolean':
+            return coerceBoolean(given);
+        case 'number':
+            return coerceNumber(given);
+        case 'enum':
+            return coerceEnum(parameter, given);
+        case 'object':
+            return coerceObject(given);
+        default:
+            return { value: String(given) };
+    }
+};
+const coerceBoolean = (given) => {
+    if (given === true || given === 'true' || given === '1' || given === 1) {
+        return { value: true };
+    }
+    if (given === false || given === 'false' || given === '0' || given === 0) {
+        return { value: false };
+    }
+    return { issue: 'true or false' };
+};
+const coerceNumber = (given) => {
+    if (typeof given === 'number')
+        return { value: given };
+    if (typeof given === 'string' && given.trim() !== '') {
+        const value = Number(given);
+        if (!Number.isNaN(value))
+            return { value };
+    }
+    return { issue: 'a number' };
+};
+const coerceEnum = (parameter, given) => {
+    const value = String(given);
+    const names = parameter.values.map(({ name }) => name);
+    if (!names.includes(value))
+        return { issue: `one of ${names.join(', ')}` };
+    return { value };
+};
+const coerceObject = (given) => {
+    if (typeof given !== 'string')
+        return { issue: 'a JSON object' };
+    try {
+        const value = JSON.parse(given);
+        if (value == null || typeof value !== 'object' || Array.isArray(value)) {
+            return { issue: 'a JSON object' };
+        }
+        return { value };
+    }
+    catch {
+        return { issue: 'a JSON object' };
+    }
+};
+const coerceList = (parameter, given) => {
+    const items = Array.isArray(given)
+        ? given
+        : typeof given === 'string'
+            ? given.split(',')
+            : [given];
+    const values = [];
+    for (const item of items) {
+        const coerced = coerceListItem(parameter, item);
+        if ('issue' in coerced)
+            return coerced;
+        values.push(coerced.value);
+    }
+    return { value: values };
+};
+const coerceListItem = (parameter, item) => {
+    if (parameter.itemFormat === 'number') {
+        const coerced = coerceNumber(item);
+        if ('issue' in coerced)
+            return { issue: 'a list of numbers' };
+        return coerced;
+    }
+    if (parameter.itemFormat === 'boolean') {
+        const coerced = coerceBoolean(item);
+        if ('issue' in coerced)
+            return { issue: 'a list of true or false' };
+        return coerced;
+    }
+    if (parameter.itemFormat === 'enum') {
+        const value = String(item);
+        const names = parameter.itemEnumValues.map(({ name }) => name);
+        if (!names.includes(value)) {
+            return { issue: `a list of ${names.join(', ')}` };
+        }
+        return { value };
+    }
+    return { value: String(item) };
+};
+//# sourceMappingURL=coerce.js.map