@eyeauras/cli-factory 0.1.0

package/dist/src/cli.js

@@ -0,0 +1,364 @@
+import { Command, CommanderError, Option } from "commander";
+import { AppArguments } from "./app-arguments.js";
+import { canPrompt } from "./auth.js";
+import { runJsonRpc } from "./json-rpc.js";
+import { writeResult } from "./output.js";
+import { resolvePermissionCategories, validateCommandPermissions, validatePermissionsDisabled, createPermissionCommand, } from "./permissions.js";
+import { ProfileStore } from "./profile-store.js";
+import { createProfileCommands } from "./profile-commands.js";
+import { CommandGate } from "./command-gate.js";
+import { validateArgv } from "./input-limits.js";
+import { visitResources } from "./resources.js";
+import { KeyringSecretStore, ProfileSecrets } from "./secret-store.js";
+function declaredOption(specification) {
+    const requiredHint = specification.required && specification.defaultValue === undefined
+        ? " (required)"
+        : "";
+    const option = new Option(specification.flags, specification.description + requiredHint);
+    if (specification.required)
+        option.makeOptionMandatory();
+    if (specification.defaultValue !== undefined)
+        option.default(specification.defaultValue);
+    if (specification.parse)
+        option.argParser(specification.parse);
+    return option;
+}
+function commandParts(syntax) {
+    const [name, ...arguments_] = syntax.trim().split(/\s+/);
+    if (!name) {
+        throw new Error("A command name cannot be empty.");
+    }
+    return { name, arguments: arguments_ };
+}
+export function createCli(definition) {
+    const rpcModeError = new Error("The --json-rpc transport must be started without a CLI command.");
+    const defaultIo = {
+        input: definition.runtime?.input ?? process.stdin,
+        output: definition.runtime?.output ?? process.stdout,
+        error: definition.runtime?.error ?? process.stderr,
+    };
+    const gate = new CommandGate(definition.concurrency);
+    const resources = [...new Set(definition.resources ?? [])];
+    const lifetime = new AbortController();
+    const active = new Set();
+    let disposal;
+    const track = (operation) => {
+        if (disposal || lifetime.signal.aborted)
+            return Promise.reject(new Error("CLI application is disposed."));
+        const work = Promise.resolve().then(operation);
+        active.add(work);
+        void work.then(() => active.delete(work), () => active.delete(work));
+        return work;
+    };
+    const fetchImplementation = definition.runtime?.fetch ?? globalThis.fetch;
+    const applicationId = definition.applicationId ?? definition.name;
+    const profileDefinition = definition.profile ?? {};
+    const appArguments = definition.runtime?.appArguments ??
+        new AppArguments({
+            AppName: applicationId,
+            ...(definition.version === undefined
+                ? {}
+                : { Version: definition.version }),
+            Profile: profileDefinition.defaultName ?? "default",
+        });
+    if (appArguments.AppName !== applicationId) {
+        throw new Error(`Cli applicationId '${applicationId}' does not match AppArguments.AppName '${appArguments.AppName}'.`);
+    }
+    const permissionCategories = definition.permissions === undefined
+        ? undefined
+        : resolvePermissionCategories(definition.permissions);
+    if (permissionCategories) {
+        validateCommandPermissions(definition.commands, permissionCategories);
+    }
+    else {
+        validatePermissionsDisabled(definition.commands);
+    }
+    const defaultPermissions = permissionCategories
+        ?.filter((category) => category.enabledByDefault === true)
+        .map((category) => category.name) ?? [];
+    const profileStore = definition.runtime?.profileStore ??
+        new ProfileStore({
+            applicationId,
+            appArguments,
+            ...(profileDefinition.defaultName === undefined
+                ? {}
+                : { defaultName: profileDefinition.defaultName }),
+            ...(profileDefinition.defaults === undefined
+                ? {}
+                : { defaults: profileDefinition.defaults }),
+            ...(profileDefinition.validate === undefined
+                ? {}
+                : { validate: profileDefinition.validate }),
+        });
+    const secretStore = definition.runtime?.secretStore ?? new KeyringSecretStore();
+    const resolveProfile = async (requestedName) => profileStore.get(requestedName);
+    const invalidateProfile = (profile) => visitResources(resources, (resource) => resource.invalidateProfile?.(appArguments.WithProfile(profile.name)));
+    const enabledPermissions = async (profileName) => new Set((await profileStore.getPermissions(profileName)) ?? defaultPermissions);
+    const contextFor = (profile, execution) => ({
+        appArguments: appArguments.WithProfile(profile.name),
+        profile,
+        secrets: new ProfileSecrets(secretStore, applicationId, profile.name),
+        fetch: fetchImplementation,
+        signal: execution.signal,
+        io: execution.io,
+        cwd: execution.cwd,
+        environment: execution.environment,
+    });
+    const execute = async (argv, execution) => {
+        validateArgv(argv);
+        execution.signal.throwIfAborted();
+        const { input, output, error } = execution.io;
+        let result;
+        let capturedOutput = "";
+        let capturedError = "";
+        const needsConfiguration = Symbol("needs exclusive onboarding");
+        const program = new Command()
+            .name(definition.name)
+            .description(definition.description)
+            .showHelpAfterError()
+            .showSuggestionAfterError()
+            .helpCommand(true)
+            .option("--json", "Emit machine-readable JSON")
+            .option("--json-rpc", "Start a persistent newline-delimited JSON-RPC session")
+            .on("option:json-rpc", () => {
+            // The sole transport invocation is handled by run; parsed occurrences here are misuse.
+            throw rpcModeError;
+        })
+            .option("-p, --profile <name>", "Use a profile for this command without switching the default");
+        if (definition.version) {
+            program.version(definition.version);
+        }
+        program.configureOutput({
+            writeOut: (text) => {
+                if (execution.render)
+                    output.write(text);
+                else
+                    capturedOutput += text;
+            },
+            writeErr: (text) => {
+                if (execution.render)
+                    error.write(text);
+                else
+                    capturedError += text;
+            },
+        });
+        program.exitOverride();
+        const { commands: profileCommands, configureProfile, configurationState, configurationError, } = createProfileCommands(definition, profileStore, {
+            contextFor: (profile) => contextFor(profile, execution),
+            stdinAvailable: execution.render,
+            interactive: () => execution.render &&
+                program.opts().json !== true &&
+                canPrompt(input, output) &&
+                canPrompt(input, error),
+        }, invalidateProfile);
+        const ensureConfigured = async (profile, globals, exclusive) => {
+            const state = await configurationState(profile);
+            if (state.missingFields.length === 0 && !state.authenticationMissing) {
+                return profile;
+            }
+            const interactive = execution.render &&
+                globals.json !== true &&
+                canPrompt(input, output) &&
+                canPrompt(input, error);
+            if (!interactive) {
+                throw configurationError(profile, state);
+            }
+            if (!exclusive)
+                throw needsConfiguration;
+            await configureProfile(profile.name, {
+                values: {},
+                authOptions: {},
+                interactive: true,
+            });
+            return resolveProfile(profile.name);
+        };
+        const runHandler = async (handler, command, commandInput, requiredPermission, requiresConfiguredProfile = false, exclusive = false) => {
+            if (!handler) {
+                const help = command.helpInformation().trimEnd();
+                result = { help };
+                if (execution.render) {
+                    output.write(`${help}\n`);
+                }
+                return;
+            }
+            const invoke = async (ownsExclusive) => {
+                const globals = command.optsWithGlobals();
+                let profile = await resolveProfile(globals.profile);
+                if (requiredPermission) {
+                    const enabled = await enabledPermissions(profile.name);
+                    if (!enabled.has(requiredPermission)) {
+                        throw new Error(`Permission '${requiredPermission}' is disabled for profile '${profile.name}'. ` +
+                            `Enable it explicitly with '${definition.name} permissions grant ${requiredPermission} --profile ${profile.name}'.`);
+                    }
+                }
+                if (requiresConfiguredProfile)
+                    profile = await ensureConfigured(profile, globals, ownsExclusive);
+                const context = contextFor(profile, execution);
+                context.signal.throwIfAborted();
+                result = await handler(commandInput, context);
+                if (execution.render) {
+                    writeResult(output, result, globals.json === true);
+                }
+            };
+            try {
+                await gate.run(() => invoke(exclusive), execution.signal, exclusive);
+            }
+            catch (error) {
+                if (error !== needsConfiguration)
+                    throw error;
+                // Release the shared slot before rechecking/onboarding; the handler has not run yet.
+                await gate.run(() => invoke(true), execution.signal, true);
+            }
+        };
+        const addDefinition = (parent, item, configured = true, exclusive = false) => {
+            const parts = commandParts(item.name);
+            const current = new Command(parts.name)
+                .copyInheritedSettings(parent)
+                .description(item.description)
+                .configureOutput(parent.configureOutput());
+            if (item.permission) {
+                current.addHelpText("after", `\nRequired permission: ${item.permission}\n`);
+            }
+            for (const argument of parts.arguments) {
+                current.argument(argument);
+            }
+            for (const specification of item.options ?? []) {
+                current.addOption(declaredOption(specification));
+            }
+            for (const child of item.children ?? []) {
+                addDefinition(current, child, configured, exclusive);
+            }
+            current.action(async (...parameters) => {
+                const actionCommand = parameters.at(-1);
+                const options = (parameters.at(-2) ?? {});
+                const positional = parameters.slice(0, -2);
+                const args = Object.fromEntries(actionCommand.registeredArguments.map((argument, index) => [
+                    argument.name(),
+                    positional[index],
+                ]));
+                await runHandler(item.run, actionCommand, { args, options }, item.permission, configured, exclusive);
+            });
+            parent.addCommand(current);
+        };
+        for (const item of profileCommands)
+            addDefinition(program, item, false, true);
+        if (permissionCategories)
+            addDefinition(program, createPermissionCommand(permissionCategories, profileStore, enabledPermissions), false, true);
+        for (const item of definition.commands) {
+            addDefinition(program, item);
+        }
+        for (const item of definition.builtins ?? [])
+            addDefinition(program, item, false);
+        program.action(async () => gate.run(async () => {
+            const globals = program.opts();
+            if (execution.render &&
+                globals.json !== true &&
+                canPrompt(input, output) &&
+                canPrompt(input, error)) {
+                const profile = await resolveProfile(globals.profile);
+                const state = await configurationState(profile);
+                if (state.missingFields.length > 0 || state.authenticationMissing) {
+                    result = await configureProfile(profile.name, {
+                        values: {},
+                        authOptions: {},
+                        interactive: true,
+                    });
+                    writeResult(output, result, false);
+                    return;
+                }
+            }
+            const help = program.helpInformation().trimEnd();
+            result = { help };
+            if (execution.render) {
+                output.write(`${help}\n`);
+            }
+        }, execution.signal, true));
+        try {
+            await program.parseAsync(["node", definition.name, ...argv]);
+        }
+        catch (error_) {
+            if (error_ instanceof CommanderError) {
+                if (error_.exitCode === 0) {
+                    return execution.render
+                        ? undefined
+                        : { help: capturedOutput.trimEnd() };
+                }
+                const message = capturedError.trim() || error_.message;
+                throw new Error(message, { cause: error_ });
+            }
+            throw error_;
+        }
+        return result;
+    };
+    const executionFor = (render, invocation = {}) => ({
+        render,
+        io: {
+            input: invocation.input ?? defaultIo.input,
+            output: invocation.output ?? defaultIo.output,
+            error: invocation.error ?? defaultIo.error,
+        },
+        signal: invocation.signal
+            ? AbortSignal.any([lifetime.signal, invocation.signal])
+            : lifetime.signal,
+        cwd: invocation.cwd ?? process.cwd(),
+        environment: Object.freeze({ ...(invocation.environment ?? process.env) }),
+    });
+    return {
+        async run(argv = process.argv.slice(2), invocation = {}) {
+            const execution = executionFor(true, invocation);
+            try {
+                return await track(async () => {
+                    validateArgv(argv);
+                    if (argv.length === 1 && argv[0] === "--json-rpc") {
+                        await runJsonRpc({
+                            input: execution.io.input,
+                            output: execution.io.output,
+                            signal: execution.signal,
+                            execute: (rpcArguments) => execute(rpcArguments, {
+                                ...execution,
+                                render: false,
+                                signal: AbortSignal.any([
+                                    execution.signal,
+                                    AbortSignal.timeout(5 * 60_000),
+                                ]),
+                            }),
+                        });
+                        return 0;
+                    }
+                    await execute(argv, execution);
+                    return 0;
+                });
+            }
+            catch (error) {
+                execution.io.error.write(`${error instanceof Error ? error.message : String(error)}\n`);
+                return error === rpcModeError ? 2 : 1;
+            }
+        },
+        execute(argv, signal) {
+            const execution = executionFor(false, signal ? { signal } : {});
+            return track(() => execute(argv, execution));
+        },
+        dispose() {
+            if (!disposal) {
+                disposal = Promise.resolve().then(async () => {
+                    lifetime.abort(new Error("CLI application is closing."));
+                    let timer;
+                    try {
+                        await Promise.race([
+                            Promise.allSettled([...active]),
+                            new Promise((_, reject) => {
+                                timer = setTimeout(() => reject(new Error("CLI shutdown timed out waiting for commands.")), 5000);
+                            }),
+                        ]);
+                    }
+                    finally {
+                        clearTimeout(timer);
+                        await visitResources(resources, (resource) => resource.dispose());
+                    }
+                });
+            }
+            return disposal;
+        },
+    };
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/command-gate.d.ts

@@ -0,0 +1,9 @@
+/** Bounded FIFO; built-ins coordinate application-wide profile/auth changes. */
+export declare class CommandGate {
+    #private;
+    private readonly limit;
+    private readonly maxPending;
+    constructor(limit?: number, maxPending?: number);
+    run<T>(work: () => Promise<T>, signal: AbortSignal, exclusive?: boolean): Promise<T>;
+}
+//# sourceMappingURL=command-gate.d.ts.map

package/dist/src/command-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-gate.d.ts","sourceRoot":"","sources":["../../src/command-gate.ts"],"names":[],"mappings":"AAMA,gFAAgF;AAChF,qBAAa,WAAW;;IAKpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAF7B,YACmB,KAAK,SAAW,EAChB,UAAU,SAAM,EAKlC;IACD,GAAG,CAAC,CAAC,EACH,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,MAAM,EAAE,WAAW,EACnB,SAAS,UAAQ,GAChB,OAAO,CAAC,CAAC,CAAC,CAgCZ;CAaF"}

package/dist/src/command-gate.js

@@ -0,0 +1,64 @@
+/** Bounded FIFO; built-ins coordinate application-wide profile/auth changes. */
+export class CommandGate {
+    limit;
+    maxPending;
+    #running = 0;
+    #exclusive = false;
+    #pending = [];
+    constructor(limit = Infinity, maxPending = 128) {
+        this.limit = limit;
+        this.maxPending = maxPending;
+        if (limit !== Infinity && (!Number.isSafeInteger(limit) || limit < 1)) {
+            throw new Error("concurrency must be a positive integer or omitted.");
+        }
+    }
+    run(work, signal, exclusive = false) {
+        if (signal.aborted)
+            return Promise.reject(new Error("Command cancelled."));
+        if (this.#pending.length >= this.maxPending)
+            return Promise.reject(new Error("CLI command queue is full."));
+        return new Promise((resolve, reject) => {
+            const pending = {
+                exclusive,
+                abort: () => {
+                    const index = this.#pending.indexOf(pending);
+                    if (index >= 0)
+                        this.#pending.splice(index, 1);
+                    signal.removeEventListener("abort", pending.abort);
+                    reject(new Error("Command cancelled while queued."));
+                    this.#pump();
+                },
+                start: () => {
+                    signal.removeEventListener("abort", pending.abort);
+                    this.#running++;
+                    if (exclusive)
+                        this.#exclusive = true;
+                    void Promise.resolve()
+                        .then(work)
+                        .then(resolve, reject)
+                        .finally(() => {
+                        this.#running--;
+                        if (exclusive)
+                            this.#exclusive = false;
+                        this.#pump();
+                    });
+                },
+            };
+            this.#pending.push(pending);
+            signal.addEventListener("abort", pending.abort, { once: true });
+            this.#pump();
+        });
+    }
+    #pump() {
+        while (this.#pending.length &&
+            !this.#exclusive &&
+            this.#running < this.limit) {
+            const next = this.#pending[0];
+            if (next.exclusive && this.#running)
+                break;
+            this.#pending.shift();
+            next.start();
+        }
+    }
+}
+//# sourceMappingURL=command-gate.js.map

package/dist/src/command-gate.js.map

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

package/dist/src/command-input.d.ts

@@ -0,0 +1,14 @@
+import type { CommandContext, CommandHandler, CommandInput } from "./types.js";
+type LowerLetter = "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z";
+type NameCharacter = LowerLetter | Uppercase<LowerLetter> | "_" | "-" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9";
+type LiteralName<Text extends string> = Text extends `${infer First}${infer Rest}` ? First extends NameCharacter ? Rest extends "" ? true : LiteralName<Rest> : false : false;
+type IsUnion<Value, Whole = Value> = Value extends Whole ? [Whole] extends [Value] ? false : true : never;
+type AddArgument<Token extends string, Args> = Token extends `<${infer Name}>` ? LiteralName<Name> extends true ? Name extends keyof Args ? never : Args & Record<Name, string> : never : never;
+type ParseArguments<Text extends string, Args = {}> = Text extends `${infer Token} ${infer Rest}` ? [AddArgument<Token, Args>] extends [never] ? never : ParseArguments<Rest, AddArgument<Token, Args>> : AddArgument<Text, Args>;
+type ParseCommand<Syntax extends string> = Syntax extends `${infer Name} ${infer Rest}` ? LiteralName<Name> extends true ? ParseArguments<Rest> : never : LiteralName<Syntax> extends true ? {} : never;
+type CommandArguments<Syntax extends string> = string extends Syntax ? Record<string, unknown> : IsUnion<Syntax> extends true ? Record<string, unknown> : [ParseCommand<Syntax>] extends [never] ? Record<string, unknown> : ParseCommand<Syntax>;
+export type InferredCommandHandler<Syntax extends string> = (input: Omit<CommandInput, "args"> & {
+    args: CommandArguments<Syntax>;
+}, context: CommandContext) => ReturnType<CommandHandler>;
+export {};
+//# sourceMappingURL=command-input.d.ts.map

package/dist/src/command-input.d.ts.map

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

package/dist/src/command-input.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-input.js.map

package/dist/src/command-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-input.js","sourceRoot":"","sources":["../../src/command-input.ts"],"names":[],"mappings":""}

package/dist/src/command.d.ts

@@ -0,0 +1,5 @@
+import type { CommandDefinition, CommandSettings } from "./types.js";
+import type { InferredCommandHandler } from "./command-input.js";
+export declare function command(name: string, description: string, children: readonly CommandDefinition[]): CommandDefinition;
+export declare function command<const Syntax extends string>(name: Syntax, description: string, run: InferredCommandHandler<Syntax>, settings?: CommandSettings): CommandDefinition;
+//# sourceMappingURL=command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EAEjB,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GACrC,iBAAiB,CAAC;AACrB,wBAAgB,OAAO,CAAC,KAAK,CAAC,MAAM,SAAS,MAAM,EACjD,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,sBAAsB,CAAC,MAAM,CAAC,EACnC,QAAQ,CAAC,EAAE,eAAe,GACzB,iBAAiB,CAAC"}

package/dist/src/command.js

@@ -0,0 +1,14 @@
+export function command(name, description, childrenOrRun, settings = {}) {
+    if (typeof childrenOrRun === "function") {
+        return {
+            name,
+            description,
+            // The unchanged Core parser supplies arguments from this name; stored definitions stay broad.
+            run: childrenOrRun,
+            ...(settings.options === undefined ? {} : { options: settings.options }),
+            ...(settings.permission === undefined ? {} : { permission: settings.permission }),
+        };
+    }
+    return { name, description, children: childrenOrRun };
+}
+//# sourceMappingURL=command.js.map

package/dist/src/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/command.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,OAAO,CACrB,IAAY,EACZ,WAAmB,EACnB,aAAkG,EAClG,QAAQ,GAAoB,EAAE;IAE9B,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;QACxC,OAAO;YACL,IAAI;YACJ,WAAW;YACX,8FAA8F;YAC9F,GAAG,EAAE,aAA+B;YACpC,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;YACxE,GAAG,CAAC,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;SAClF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;AACxD,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,21 @@
+export { readBoundedResponseBody } from "./response-body.js";
+export { tokenAuth } from "./auth.js";
+export { inputLimits, validateArgv } from "./input-limits.js";
+export { visitResources } from "./resources.js";
+export { privateDirectory, privateEndpoint } from "./private-storage.js";
+export { ProfileFileError, publishProfileFile } from "./profile-file.js";
+export type { ProfileFileOptions, PublishedProfileFile, StagedProfileFile, } from "./profile-file.js";
+export { AppArguments } from "./app-arguments.js";
+export { createCli } from "./cli.js";
+export { command } from "./command.js";
+export type { InferredCommandHandler } from "./command-input.js";
+export { targetCommands } from "./target-commands.js";
+export type { GatedTargetCommand, TargetCommand, TargetCommandHandler, TargetCommands, } from "./target-commands.js";
+export { integerParser, jsonParser } from "./option-parsers.js";
+export { formatHuman, writeResult } from "./output.js";
+export { Permission } from "./permissions.js";
+export { ProfileStore } from "./profile-store.js";
+export { KeyringSecretStore, MemorySecretStore, ProfileSecrets, } from "./secret-store.js";
+export type { AppArgumentsEnvironment, AppArgumentsOptions, IAppArguments, IAppConfig, } from "./app-arguments.js";
+export type { CliApplication, CliDefinition, CliRuntime, CliResource, CommandContext, CommandDefinition, CommandHandler, CommandInput, CommandSettings, OptionDefinition, PermissionCategory, PermissionGateDefinition, Profile, ProfileDefinition, ProfileField, ProfileStoreContract, ProfileValues, ScopedSecrets, SecretStore, AuthDefinition, AuthContext, AuthReadinessContext, AuthStatus, CliIo, CliInvocation, TokenValidationContext, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,cAAc,EACd,aAAa,EACb,UAAU,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,OAAO,EACP,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,WAAW,EACX,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,KAAK,EACL,aAAa,EACb,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,16 @@
+export { readBoundedResponseBody } from "./response-body.js";
+export { tokenAuth } from "./auth.js";
+export { inputLimits, validateArgv } from "./input-limits.js";
+export { visitResources } from "./resources.js";
+export { privateDirectory, privateEndpoint } from "./private-storage.js";
+export { ProfileFileError, publishProfileFile } from "./profile-file.js";
+export { AppArguments } from "./app-arguments.js";
+export { createCli } from "./cli.js";
+export { command } from "./command.js";
+export { targetCommands } from "./target-commands.js";
+export { integerParser, jsonParser } from "./option-parsers.js";
+export { formatHuman, writeResult } from "./output.js";
+export { Permission } from "./permissions.js";
+export { ProfileStore } from "./profile-store.js";
+export { KeyringSecretStore, MemorySecretStore, ProfileSecrets, } from "./secret-store.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAMzE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAOtD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,mBAAmB,CAAC"}

package/dist/src/input-limits.d.ts

@@ -0,0 +1,9 @@
+/** Shared logical command limits. Protocols may additionally bound their own envelopes. */
+export declare const inputLimits: Readonly<{
+    arguments: 256;
+    argumentBytes: 8192;
+    argvBytes: 32768;
+    rpcLineBytes: 262144;
+}>;
+export declare function validateArgv(value: unknown): asserts value is readonly string[];
+//# sourceMappingURL=input-limits.d.ts.map

package/dist/src/input-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-limits.d.ts","sourceRoot":"","sources":["../../src/input-limits.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,eAAO,MAAM,WAAW;;;;;EAKtB,CAAC;AAEH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,SAAS,MAAM,EAAE,CAgBpC"}

package/dist/src/input-limits.js

@@ -0,0 +1,21 @@
+/** Shared logical command limits. Protocols may additionally bound their own envelopes. */
+export const inputLimits = Object.freeze({
+    arguments: 256,
+    argumentBytes: 8192,
+    argvBytes: 32768,
+    rpcLineBytes: 262144,
+});
+export function validateArgv(value) {
+    if (!Array.isArray(value) || value.length > inputLimits.arguments)
+        throw new Error("Command argument count exceeds its limit or argv is invalid.");
+    let total = 0;
+    for (const arg of value) {
+        if (typeof arg !== "string")
+            throw new Error("Command arguments must be strings.");
+        const bytes = Buffer.byteLength(arg);
+        if (bytes > inputLimits.argumentBytes ||
+            (total += bytes) > inputLimits.argvBytes)
+            throw new Error("Command arguments exceed their byte size limit.");
+    }
+}
+//# sourceMappingURL=input-limits.js.map

package/dist/src/input-limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-limits.js","sourceRoot":"","sources":["../../src/input-limits.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,GAAG;IACd,aAAa,EAAE,IAAI;IACnB,SAAS,EAAE,KAAK;IAChB,YAAY,EAAE,MAAM;CACrB,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAC1B,KAAc;IAEd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,SAAS;QAC/D,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;IACJ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,OAAO,GAAG,KAAK,QAAQ;YACzB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,IACE,KAAK,GAAG,WAAW,CAAC,aAAa;YACjC,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,WAAW,CAAC,SAAS;YAExC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}