specli 0.0.11 → 0.0.13

package/src/cli/schema.ts

@@ -1,76 +0,0 @@
-import type { AuthScheme } from "./auth-schemes.ts";
-import type { Capabilities } from "./capabilities.ts";
-import type { CommandModel } from "./command-model.ts";
-import type { PlannedOperation } from "./naming.ts";
-import type { ServerInfo } from "./server.ts";
-import type { LoadedSpec, NormalizedOperation } from "./types.ts";
-
-export type SchemaOutput = {
-	schemaVersion: 1;
-	openapi: {
-		version: string;
-		title?: string;
-		infoVersion?: string;
-	};
-	spec: {
-		id: string;
-		fingerprint: string;
-		source: LoadedSpec["source"];
-	};
-	capabilities: Capabilities;
-	servers: ServerInfo[];
-	authSchemes: AuthScheme[];
-	operations: NormalizedOperation[];
-	planned?: PlannedOperation[];
-	commands?: CommandModel;
-	commandsIndex?: import("./command-index.ts").CommandsIndex;
-};
-
-export type MinimalSchemaOutput = Pick<
-	SchemaOutput,
-	"schemaVersion" | "openapi" | "spec" | "capabilities" | "commands"
->;
-
-export function buildSchemaOutput(
-	loaded: LoadedSpec,
-	operations: NormalizedOperation[],
-	planned: PlannedOperation[] | undefined,
-	servers: ServerInfo[],
-	authSchemes: AuthScheme[],
-	commands: CommandModel | undefined,
-	commandsIndex: import("./command-index.ts").CommandsIndex | undefined,
-	capabilities: Capabilities,
-): SchemaOutput {
-	return {
-		schemaVersion: 1,
-		openapi: {
-			version: loaded.doc.openapi,
-			title: loaded.doc.info?.title,
-			infoVersion: loaded.doc.info?.version,
-		},
-		spec: {
-			id: loaded.id,
-			fingerprint: loaded.fingerprint,
-			source: loaded.source,
-		},
-		capabilities,
-		servers,
-		authSchemes,
-		operations,
-		planned,
-		commands,
-		commandsIndex,
-	};
-}
-
-export function toMinimalSchemaOutput(
-	output: SchemaOutput,
-): MinimalSchemaOutput {
-	return {
-		schemaVersion: output.schemaVersion,
-		openapi: output.openapi,
-		spec: output.spec,
-		capabilities: output.capabilities,
-		commands: output.commands,
-	};
-}

package/src/cli/server.ts

@@ -1,88 +0,0 @@
-import { getSchemaEnumStrings } from "./schema-shape.ts";
-import type { OpenApiDoc } from "./types.ts";
-
-export type ServerVariable = {
-	name: string;
-	default?: string;
-	enum?: string[];
-	description?: string;
-};
-
-export type ServerInfo = {
-	url: string;
-	description?: string;
-	variables: ServerVariable[];
-	variableNames: string[];
-};
-
-type RawServerVariable = {
-	default?: unknown;
-	enum?: unknown;
-	description?: unknown;
-};
-
-type RawServer = {
-	url?: unknown;
-	description?: unknown;
-	variables?: unknown;
-};
-
-function extractVariableNames(url: string): string[] {
-	const names: string[] = [];
-	const re = /\{([^}]+)\}/g;
-
-	while (true) {
-		const match = re.exec(url);
-		if (!match) break;
-		names.push(match[1] ?? "");
-	}
-
-	return names.map((n) => n.trim()).filter(Boolean);
-}
-
-export function listServers(doc: OpenApiDoc): ServerInfo[] {
-	const servers = doc.servers ?? [];
-	const out: ServerInfo[] = [];
-
-	for (const raw of servers) {
-		const s = raw as RawServer;
-		if (!s || typeof s !== "object") continue;
-		if (typeof s.url !== "string") continue;
-
-		const variableNames = extractVariableNames(s.url);
-		const variables: ServerVariable[] = [];
-
-		const rawVars =
-			s.variables &&
-			typeof s.variables === "object" &&
-			!Array.isArray(s.variables)
-				? (s.variables as Record<string, RawServerVariable>)
-				: {};
-
-		for (const name of variableNames) {
-			const v = rawVars[name];
-			const def = v?.default;
-			const desc = v?.description;
-			variables.push({
-				name,
-				default: typeof def === "string" ? def : undefined,
-				enum: getSchemaEnumStrings(v),
-				description: typeof desc === "string" ? desc : undefined,
-			});
-		}
-
-		out.push({
-			url: s.url,
-			description:
-				typeof s.description === "string" ? s.description : undefined,
-			variables,
-			variableNames,
-		});
-	}
-
-	return out;
-}
-
-export function getDefaultServerUrl(doc: OpenApiDoc): string | undefined {
-	return listServers(doc)[0]?.url;
-}

package/src/cli/spec-id.ts

@@ -1,12 +0,0 @@
-import { kebabCase } from "./strings.ts";
-import type { LoadedSpec } from "./types.ts";
-
-export function getSpecId(
-	loaded: Pick<LoadedSpec, "doc" | "fingerprint">,
-): string {
-	const title = loaded.doc.info?.title;
-	const fromTitle = title ? kebabCase(title) : "";
-	if (fromTitle) return fromTitle;
-
-	return loaded.fingerprint.slice(0, 12);
-}

package/src/cli/spec-loader.ts

@@ -1,58 +0,0 @@
-import SwaggerParser from "@apidevtools/swagger-parser";
-
-import { sha256Hex } from "./crypto.ts";
-import { parseYamlContent } from "./runtime/compat.ts";
-import { getSpecId } from "./spec-id.ts";
-import { stableStringify } from "./stable-json.ts";
-import type { LoadedSpec, OpenApiDoc, SpecSource } from "./types.ts";
-
-export type LoadSpecOptions = {
-	spec?: string;
-	embeddedSpecText?: string;
-};
-
-function isProbablyUrl(input: string): boolean {
-	return /^https?:\/\//i.test(input);
-}
-
-function parseSpecText(text: string): unknown {
-	const trimmed = text.trimStart();
-	if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
-		return JSON.parse(text);
-	}
-
-	return parseYamlContent(text);
-}
-
-export async function loadSpec(options: LoadSpecOptions): Promise<LoadedSpec> {
-	const { spec, embeddedSpecText } = options;
-
-	let source: SpecSource;
-	let inputForParser: unknown;
-
-	if (typeof embeddedSpecText === "string") {
-		source = "embedded";
-		inputForParser = parseSpecText(embeddedSpecText);
-	} else if (spec) {
-		source = isProbablyUrl(spec) ? "url" : "file";
-		inputForParser = spec;
-	} else {
-		throw new Error(
-			"Missing spec. Provide --spec <url|path> or build with an embedded spec.",
-		);
-	}
-
-	const doc = (await SwaggerParser.dereference(
-		// biome-ignore lint/suspicious/noExplicitAny: unknown
-		inputForParser as any,
-	)) as OpenApiDoc;
-
-	if (!doc || typeof doc !== "object" || typeof doc.openapi !== "string") {
-		throw new Error("Loaded spec is not a valid OpenAPI document");
-	}
-
-	const fingerprint = await sha256Hex(stableStringify(doc));
-	const id = getSpecId({ doc, fingerprint });
-
-	return { source, id, fingerprint, doc };
-}

package/src/cli/stable-json.ts

@@ -1,35 +0,0 @@
-export function stableStringify(
-	value: unknown,
-	options?: { space?: number },
-): string {
-	const visiting = new WeakSet<object>();
-	return JSON.stringify(sort(value, visiting), null, options?.space);
-}
-
-function sort(value: unknown, visiting: WeakSet<object>): unknown {
-	if (value === null) return null;
-
-	if (Array.isArray(value)) {
-		if (visiting.has(value)) return { __specli_circular: true };
-		visiting.add(value);
-		const out = value.map((v) => sort(v, visiting));
-		visiting.delete(value);
-		return out;
-	}
-
-	if (typeof value === "object") {
-		if (visiting.has(value)) return { __specli_circular: true };
-		visiting.add(value);
-
-		const obj = value as Record<string, unknown>;
-		const out: Record<string, unknown> = {};
-		for (const key of Object.keys(obj).sort()) {
-			out[key] = sort(obj[key], visiting);
-		}
-
-		visiting.delete(value);
-		return out;
-	}
-
-	return value;
-}

package/src/cli/strings.ts

@@ -1,21 +0,0 @@
-export function kebabCase(input: string): string {
-	const trimmed = input.trim();
-	if (!trimmed) return "";
-
-	// Convert spaces/underscores/dots to dashes, split camelCase.
-	return trimmed
-		.replace(/([a-z0-9])([A-Z])/g, "$1-$2")
-		.replace(/[\s_.:/]+/g, "-")
-		.replace(/[^a-zA-Z0-9-]/g, "-")
-		.replace(/-+/g, "-")
-		.replace(/^-|-$/g, "")
-		.toLowerCase();
-}
-
-export function titleCase(input: string): string {
-	return input
-		.split(/\s+/g)
-		.filter(Boolean)
-		.map((w) => w[0]?.toUpperCase() + w.slice(1))
-		.join(" ");
-}

package/src/cli/types.ts

@@ -1,59 +0,0 @@
-export type SpecSource = "embedded" | "file" | "url";
-
-export type SecurityRequirement = Record<string, string[]>;
-
-export type OpenApiDoc = {
-	openapi: string;
-	info?: {
-		title?: string;
-		version?: string;
-	};
-	servers?: Array<{ url: string; description?: string; variables?: unknown }>;
-	security?: SecurityRequirement[];
-	components?: {
-		securitySchemes?: Record<string, unknown>;
-	};
-	paths?: Record<string, unknown>;
-};
-
-export type NormalizedParameter = {
-	in: "path" | "query" | "header" | "cookie";
-	name: string;
-	required: boolean;
-	description?: string;
-	schema?: unknown;
-};
-
-// Minimal JSON Schema-like shape for validation and flag expansion.
-export type JsonSchema = Record<string, unknown>;
-
-export function isJsonSchema(value: unknown): value is JsonSchema {
-	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-
-export type NormalizedRequestBody = {
-	required: boolean;
-	contentTypes: string[];
-	schemasByContentType: Record<string, unknown | undefined>;
-};
-
-export type NormalizedOperation = {
-	key: string;
-	method: string;
-	path: string;
-	operationId?: string;
-	tags: string[];
-	summary?: string;
-	description?: string;
-	deprecated?: boolean;
-	security?: SecurityRequirement[];
-	parameters: NormalizedParameter[];
-	requestBody?: NormalizedRequestBody;
-};
-
-export type LoadedSpec = {
-	source: SpecSource;
-	id: string;
-	fingerprint: string;
-	doc: OpenApiDoc;
-};

package/src/macros/env.ts

@@ -1,21 +0,0 @@
-/**
- * Bun macro: reads an environment variable at bundle-time.
- * Returns undefined if the env var is not set.
- */
-export function env(name: string): string | undefined {
-	if (!name) throw new Error("env macro: missing variable name");
-	return process.env[name];
-}
-
-/**
- * Bun macro: reads a required environment variable at bundle-time.
- * Throws if the env var is not set.
- */
-export function envRequired(name: string): string {
-	if (!name) throw new Error("envRequired macro: missing variable name");
-	const value = process.env[name];
-	if (value === undefined) {
-		throw new Error(`Missing required env var: ${name}`);
-	}
-	return value;
-}

package/src/macros/spec.ts

@@ -1,17 +0,0 @@
-/**
- * Bun macro: loads an OpenAPI spec from a URL or file path at bundle-time.
- * The spec text is inlined into the bundle.
- */
-export async function loadSpec(spec: string): Promise<string> {
-	if (!spec) throw new Error("loadSpec macro: missing spec path/URL");
-
-	if (/^https?:\/\//i.test(spec)) {
-		const res = await fetch(spec);
-		if (!res.ok) {
-			throw new Error(`Failed to fetch spec: ${res.status} ${res.statusText}`);
-		}
-		return await res.text();
-	}
-
-	return await Bun.file(spec).text();
-}