specli 0.0.11 → 0.0.13

package/src/cli/runtime/generated.ts

@@ -1,242 +0,0 @@
-import { Command } from "commander";
-
-import type { AuthScheme } from "../auth-schemes.ts";
-import type { CommandAction, CommandModel } from "../command-model.ts";
-import type { ServerInfo } from "../server.ts";
-
-import { type BodyFlagDef, generateBodyFlags } from "./body-flags.ts";
-import { executeAction } from "./execute.ts";
-import type { EmbeddedDefaults } from "./request.ts";
-import { coerceArrayInput, coerceValue } from "./validate/index.ts";
-
-// Flag type from CommandAction
-type CommandFlag = CommandAction["flags"][number];
-
-/**
- * Format help output that is clear for both humans and AI agents.
- * Groups options into Required, Optional, and Global sections.
- */
-function formatCustomHelp(
-	cmd: Command,
-	action: CommandAction,
-	operationFlags: CommandFlag[],
-	bodyFlagDefs: BodyFlagDef[],
-): string {
-	const lines: string[] = [];
-	const cmdName = cmd.name();
-	const parentName = cmd.parent?.name() ?? "";
-	const fullCmd = parentName ? `${parentName} ${cmdName}` : cmdName;
-
-	// Usage line
-	const positionals = action.positionals.map((p) => `<${p.name}>`).join(" ");
-	const usageSuffix = positionals ? ` ${positionals}` : "";
-	lines.push(`Usage: ${fullCmd}${usageSuffix} [options]`);
-	lines.push("");
-
-	// Description
-	const desc =
-		action.summary ?? action.description ?? `${action.method} ${action.path}`;
-	lines.push(desc);
-	lines.push("");
-
-	// Collect all options into categories
-	const requiredOpts: string[] = [];
-	const optionalOpts: string[] = [];
-
-	// Format a single option line
-	const formatOpt = (
-		flag: string,
-		type: string,
-		desc: string,
-		required: boolean,
-	): string => {
-		const typeStr = type === "boolean" ? "" : ` <${type}>`;
-		const reqMarker = required ? " (required)" : "";
-		return `  ${flag}${typeStr}${reqMarker}\n      ${desc}`;
-	};
-
-	// Operation flags (query/header/path params)
-	for (const f of operationFlags) {
-		const type = f.type === "array" ? `${f.itemType ?? "string"}[]` : f.type;
-		const line = formatOpt(
-			f.flag,
-			type,
-			f.description ?? `${f.in} parameter`,
-			f.required,
-		);
-		if (f.required) {
-			requiredOpts.push(line);
-		} else {
-			optionalOpts.push(line);
-		}
-	}
-
-	// Body flags
-	for (const def of bodyFlagDefs) {
-		const line = formatOpt(def.flag, def.type, def.description, def.required);
-		if (def.required) {
-			requiredOpts.push(line);
-		} else {
-			optionalOpts.push(line);
-		}
-	}
-
-	// Required options section
-	if (requiredOpts.length > 0) {
-		lines.push("Required:");
-		lines.push(...requiredOpts);
-		lines.push("");
-	}
-
-	// Optional options section
-	if (optionalOpts.length > 0) {
-		lines.push("Options:");
-		lines.push(...optionalOpts);
-		lines.push("");
-	}
-
-	// Global options (always available)
-	lines.push("Global:");
-	lines.push("  --curl\n      Print curl command instead of executing");
-	lines.push("  --json\n      Output response as JSON");
-	lines.push("  --server <url>\n      Override the API server URL");
-	lines.push(
-		"  --bearer-token <token>\n      Provide auth token (or use 'login' command)",
-	);
-	lines.push("  -h, --help\n      Show this help message");
-	lines.push("");
-
-	return lines.join("\n");
-}
-
-export type GeneratedCliContext = {
-	servers: ServerInfo[];
-	authSchemes: AuthScheme[];
-	commands: CommandModel;
-	specId: string;
-	embeddedDefaults?: EmbeddedDefaults;
-};
-
-export function addGeneratedCommands(
-	program: Command,
-	context: GeneratedCliContext,
-): void {
-	for (const resource of context.commands.resources) {
-		const resourceCmd = program
-			.command(resource.resource)
-			.description(`Operations for ${resource.resource}`);
-
-		for (const action of resource.actions) {
-			const cmd = resourceCmd.command(action.action);
-			cmd.description(
-				action.summary ??
-					action.description ??
-					`${action.method} ${action.path}`,
-			);
-
-			for (const pos of action.positionals) {
-				cmd.argument(`<${pos.name}>`, pos.description);
-			}
-
-			for (const flag of action.flags) {
-				const opt = flag.flag;
-				const desc = flag.description ?? `${flag.in} parameter`;
-
-				if (flag.type === "boolean") {
-					cmd.option(opt, desc);
-					continue;
-				}
-
-				const isArray = flag.type === "array";
-				const itemType = flag.itemType ?? "string";
-				const flagType = isArray ? itemType : flag.type;
-				const parser = (raw: string) => coerceValue(raw, flagType);
-
-				if (isArray) {
-					const key = `${opt} <value>`;
-					cmd.option(
-						key,
-						desc,
-						(value: string, prev: unknown[] | undefined) => {
-							const next: unknown[] = [...(prev ?? [])];
-
-							// Allow `--tags a,b` and `--tags '["a","b"]'` to expand.
-							const items = coerceArrayInput(value, itemType);
-							for (const item of items) {
-								next.push(item);
-							}
-
-							return next;
-						},
-					);
-					continue;
-				}
-
-				const key = `${opt} <value>`;
-				if (flag.required) cmd.requiredOption(key, desc, parser);
-				else cmd.option(key, desc, parser);
-			}
-
-			// Collect reserved flags: operation params + --curl
-			const operationFlagSet = new Set(action.flags.map((f) => f.flag));
-			const reservedFlags = new Set([...operationFlagSet, "--curl"]);
-
-			// Only --curl is a built-in flag (for debugging)
-			if (!operationFlagSet.has("--curl")) {
-				cmd.option("--curl", "Print curl command without sending");
-			}
-
-			// Track body flag definitions for this action
-			let bodyFlagDefs: BodyFlagDef[] = [];
-
-			if (action.requestBody) {
-				// Generate body flags from schema (recursive with dot notation)
-				// Pass reserved flags to avoid conflicts with operation params and --curl
-				bodyFlagDefs = generateBodyFlags(
-					action.requestBodySchema,
-					reservedFlags,
-				);
-
-				for (const def of bodyFlagDefs) {
-					if (def.type === "boolean") {
-						cmd.option(def.flag, def.description);
-					} else {
-						cmd.option(`${def.flag} <value>`, def.description);
-					}
-				}
-			}
-
-			// Custom help output for better agent/human readability
-			cmd.configureHelp({
-				formatHelp: () =>
-					formatCustomHelp(cmd, action, action.flags, bodyFlagDefs),
-			});
-
-			// Commander passes positional args and then the Command instance as last arg.
-			cmd.action(async (...args) => {
-				const command = args[args.length - 1];
-				const positionalValues = args.slice(0, -1).map((v) => String(v));
-
-				if (!(command instanceof Command)) {
-					throw new Error("Unexpected commander action signature");
-				}
-
-				const globals = command.optsWithGlobals();
-				const local = command.opts();
-
-				await executeAction({
-					action,
-					positionalValues,
-					flagValues: local,
-					globals,
-					servers: context.servers,
-					authSchemes: context.authSchemes,
-					specId: context.specId,
-					embeddedDefaults: context.embeddedDefaults,
-					bodyFlagDefs,
-					resourceName: resource.resource,
-				});
-			});
-		}
-	}
-}

package/src/cli/runtime/headers.ts

@@ -1,37 +0,0 @@
-export function parseHeaderInput(input: string): {
-	name: string;
-	value: string;
-} {
-	const trimmed = input.trim();
-	if (!trimmed) throw new Error("Empty header");
-
-	// Support either "Name: Value" or "Name=Value".
-	const colon = trimmed.indexOf(":");
-	if (colon !== -1) {
-		const name = trimmed.slice(0, colon).trim();
-		const value = trimmed.slice(colon + 1).trim();
-		if (!name) throw new Error("Invalid header name");
-		return { name, value };
-	}
-
-	const eq = trimmed.indexOf("=");
-	if (eq !== -1) {
-		const name = trimmed.slice(0, eq).trim();
-		const value = trimmed.slice(eq + 1).trim();
-		if (!name) throw new Error("Invalid header name");
-		return { name, value };
-	}
-
-	throw new Error("Invalid header format. Use 'Name: Value' or 'Name=Value'.");
-}
-
-export function mergeHeaders(
-	base: Headers,
-	entries: Array<{ name: string; value: string }>,
-): Headers {
-	const h = new Headers(base);
-	for (const { name, value } of entries) {
-		h.set(name, value);
-	}
-	return h;
-}

package/src/cli/runtime/index.ts

@@ -1,3 +0,0 @@
-export * from "./argv.ts";
-export * from "./context.ts";
-export * from "./generated.ts";

package/src/cli/runtime/profile/secrets.ts

@@ -1,83 +0,0 @@
-import { isBun } from "../compat.ts";
-
-const bunLiteral = "bun" as const;
-
-export type SecretKey = {
-	service: string;
-	name: string;
-};
-
-export function secretServiceForSpec(specId: string): string {
-	return `specli:${specId}`;
-}
-
-export function tokenSecretKey(specId: string, profile: string): SecretKey {
-	return {
-		service: secretServiceForSpec(specId),
-		name: `profile:${profile}:token`,
-	};
-}
-
-/**
- * Store a token securely.
- * In Bun: uses the native secrets store (system keychain)
- * In Node.js: secrets are not supported, warns user
- */
-export async function setToken(
-	specId: string,
-	profile: string,
-	token: string,
-): Promise<void> {
-	if (!isBun) {
-		console.warn(
-			"Warning: Secure token storage requires Bun. Token will not be persisted.",
-		);
-		console.warn(
-			"Use --bearer-token <token> flag instead when running with Node.js.",
-		);
-		return;
-	}
-
-	const { secrets } = await import(bunLiteral);
-	const key = tokenSecretKey(specId, profile);
-	await secrets.set({ service: key.service, name: key.name, value: token });
-}
-
-/**
- * Retrieve a stored token.
- * In Bun: retrieves from the native secrets store
- * In Node.js: returns null (secrets not supported)
- */
-export async function getToken(
-	specId: string,
-	profile: string,
-): Promise<string | null> {
-	if (!isBun) {
-		return null;
-	}
-
-	const { secrets } = await import(bunLiteral);
-	const key = tokenSecretKey(specId, profile);
-	return await secrets.get({ service: key.service, name: key.name });
-}
-
-/**
- * Delete a stored token.
- * In Bun: removes from the native secrets store
- * In Node.js: returns false (secrets not supported)
- */
-export async function deleteToken(
-	specId: string,
-	profile: string,
-): Promise<boolean> {
-	if (!isBun) {
-		console.warn(
-			"Warning: Secure token storage requires Bun. No token to delete.",
-		);
-		return false;
-	}
-
-	const { secrets } = await import(bunLiteral);
-	const key = tokenSecretKey(specId, profile);
-	return await secrets.delete({ service: key.service, name: key.name });
-}

package/src/cli/runtime/profile/store.ts

@@ -1,100 +0,0 @@
-import {
-	fileExists,
-	mkdirp,
-	parseYamlContent,
-	readFileText,
-	writeFileText,
-} from "../compat.ts";
-
-export type Profile = {
-	name: string;
-	server?: string;
-	authScheme?: string;
-	// For apiKey schemes we also need the apiKey name/in from spec to inject,
-	// but that is discoverable from the spec at runtime.
-};
-
-export type ProfilesFile = {
-	profiles: Profile[];
-	defaultProfile?: string;
-};
-
-function configDir(): string {
-	// Keep it simple (v1). We can move to env-paths later.
-	const home = process.env.HOME;
-	if (!home) throw new Error("Missing HOME env var");
-	return `${home}/.config/specli`;
-}
-
-function configPathJson(): string {
-	return `${configDir()}/profiles.json`;
-}
-
-function configPathYaml(): string {
-	return `${configDir()}/profiles.yaml`;
-}
-
-export async function readProfiles(): Promise<ProfilesFile> {
-	const jsonPath = configPathJson();
-	const yamlPath = configPathYaml();
-
-	const jsonExists = await fileExists(jsonPath);
-	const yamlExists = await fileExists(yamlPath);
-
-	const filePath = jsonExists ? jsonPath : yamlExists ? yamlPath : null;
-
-	if (!filePath) return { profiles: [] };
-
-	const text = await readFileText(filePath);
-	let parsed: unknown;
-	try {
-		parsed = parseYamlContent(text) as unknown;
-	} catch {
-		parsed = JSON.parse(text) as unknown;
-	}
-
-	const obj =
-		parsed && typeof parsed === "object"
-			? (parsed as Record<string, unknown>)
-			: {};
-	const profiles = Array.isArray(obj.profiles)
-		? (obj.profiles as Profile[])
-		: [];
-
-	return {
-		profiles: profiles.filter(Boolean),
-		defaultProfile:
-			typeof obj.defaultProfile === "string"
-				? (obj.defaultProfile as string)
-				: undefined,
-	};
-}
-
-export async function writeProfiles(data: ProfilesFile): Promise<void> {
-	const dir = configDir();
-	await mkdirp(dir);
-	await writeFileText(configPathJson(), JSON.stringify(data, null, 2));
-}
-
-export function getProfile(
-	data: ProfilesFile,
-	name: string | undefined,
-): Profile | undefined {
-	const wanted = name ?? data.defaultProfile;
-	if (!wanted) return undefined;
-	return data.profiles.find((p) => p?.name === wanted);
-}
-
-export function upsertProfile(
-	data: ProfilesFile,
-	profile: Profile,
-): ProfilesFile {
-	const profiles = data.profiles.filter((p) => p.name !== profile.name);
-	profiles.push(profile);
-	profiles.sort((a, b) => a.name.localeCompare(b.name));
-	return { ...data, profiles };
-}
-
-export function removeProfile(data: ProfilesFile, name: string): ProfilesFile {
-	return { ...data, profiles: data.profiles.filter((p) => p.name !== name) };
-}