specli 0.0.1 → 0.0.2

package/src/cli/params.test.ts

@@ -1,70 +0,0 @@
-import { describe, expect, test } from "bun:test";
-
-import { deriveParamSpecs } from "./params.ts";
-import type { NormalizedOperation } from "./types.ts";
-
-describe("deriveParamSpecs", () => {
-	test("derives basic types + flags", () => {
-		const op: NormalizedOperation = {
-			key: "GET /contacts",
-			method: "GET",
-			path: "/contacts",
-			tags: [],
-			parameters: [
-				{
-					in: "query",
-					name: "limit",
-					required: false,
-					schema: {
-						type: "integer",
-						format: "int32",
-						enum: ["1", "2"],
-					},
-				},
-				{
-					in: "header",
-					name: "X-Request-Id",
-					required: false,
-					schema: { type: "string" },
-				},
-			],
-		};
-
-		const specs = deriveParamSpecs(op);
-		expect(specs).toHaveLength(2);
-
-		const limit = specs.find((p) => p.name === "limit");
-		expect(limit?.kind).toBe("flag");
-		expect(limit?.flag).toBe("--limit");
-		expect(limit?.type).toBe("integer");
-		expect(limit?.format).toBe("int32");
-		expect(limit?.enum).toEqual(["1", "2"]);
-
-		const reqId = specs.find((p) => p.name === "X-Request-Id");
-		expect(reqId?.kind).toBe("flag");
-		expect(reqId?.flag).toBe("--x-request-id");
-		expect(reqId?.type).toBe("string");
-	});
-
-	test("derives array item types", () => {
-		const op: NormalizedOperation = {
-			key: "GET /things",
-			method: "GET",
-			path: "/things",
-			tags: [],
-			parameters: [
-				{
-					in: "query",
-					name: "ids",
-					required: false,
-					schema: { type: "array", items: { type: "integer" } },
-				},
-			],
-		};
-
-		const specs = deriveParamSpecs(op);
-		expect(specs).toHaveLength(1);
-		expect(specs[0]?.type).toBe("array");
-		expect(specs[0]?.itemType).toBe("integer");
-	});
-});

package/src/cli/positional.test.ts

@@ -1,65 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import type { ActionShapeForCli } from "./positional.ts";
-import { deriveFlags, derivePositionals } from "./positional.ts";
-
-describe("derivePositionals", () => {
-	test("returns ordered positionals from pathArgs", () => {
-		const action: ActionShapeForCli = {
-			pathArgs: ["id"],
-			params: [
-				{
-					kind: "positional",
-					in: "path",
-					name: "id",
-					flag: "--id",
-					required: true,
-					type: "string",
-				},
-			],
-		};
-
-		const pos = derivePositionals(action);
-		expect(pos).toEqual([
-			{
-				name: "id",
-				required: true,
-				type: "string",
-				format: undefined,
-				enum: undefined,
-				description: undefined,
-			},
-		]);
-	});
-});
-
-describe("deriveFlags", () => {
-	test("returns only flag params", () => {
-		const action: ActionShapeForCli = {
-			pathArgs: [],
-			params: [
-				{
-					kind: "flag",
-					in: "query",
-					name: "limit",
-					flag: "--limit",
-					required: false,
-					type: "integer",
-				},
-			],
-		};
-
-		const flags = deriveFlags(action);
-		expect(flags.flags).toEqual([
-			{
-				in: "query",
-				name: "limit",
-				flag: "--limit",
-				required: false,
-				description: undefined,
-				type: "integer",
-				format: undefined,
-				enum: undefined,
-			},
-		]);
-	});
-});

package/src/cli/request-body.test.ts

@@ -1,35 +0,0 @@
-import { describe, expect, test } from "bun:test";
-
-import { deriveRequestBodyInfo } from "./request-body.ts";
-import type { NormalizedOperation } from "./types.ts";
-
-describe("deriveRequestBodyInfo", () => {
-	test("summarizes content types and convenience flags", () => {
-		const op: NormalizedOperation = {
-			key: "POST /contacts",
-			method: "POST",
-			path: "/contacts",
-			tags: [],
-			parameters: [],
-			requestBody: {
-				required: true,
-				contentTypes: ["application/x-www-form-urlencoded", "application/json"],
-				schemasByContentType: {
-					"application/json": { type: "object" },
-					"application/x-www-form-urlencoded": { type: "object" },
-				},
-			},
-		};
-
-		const info = deriveRequestBodyInfo(op);
-		expect(info?.required).toBe(true);
-		expect(info?.hasJson).toBe(true);
-		expect(info?.hasFormUrlEncoded).toBe(true);
-		expect(info?.hasMultipart).toBe(false);
-		expect(info?.content.map((c) => c.contentType)).toEqual([
-			"application/json",
-			"application/x-www-form-urlencoded",
-		]);
-		expect(info?.preferredSchema).toEqual({ type: "object" });
-	});
-});

package/src/cli/runtime/request.test.ts

@@ -1,153 +0,0 @@
-import { describe, expect, test } from "bun:test";
-
-import { tmpdir } from "node:os";
-
-import type { CommandAction } from "../command-model.ts";
-
-import { buildRequest } from "./request.ts";
-import { createAjv, formatAjvErrors } from "./validate/index.ts";
-
-function makeAction(partial?: Partial<CommandAction>): CommandAction {
-	return {
-		id: "test",
-		key: "POST /contacts",
-		action: "create",
-		pathArgs: [],
-		method: "POST",
-		path: "/contacts",
-		tags: [],
-		style: "rest",
-		positionals: [],
-		flags: [],
-		params: [],
-		auth: { alternatives: [] },
-		requestBody: {
-			required: true,
-			content: [
-				{
-					contentType: "application/json",
-					required: true,
-					schemaType: "object",
-				},
-			],
-			hasJson: true,
-			hasFormUrlEncoded: false,
-			hasMultipart: false,
-			bodyFlags: ["--data", "--file"],
-			preferredContentType: "application/json",
-			preferredSchema: undefined,
-		},
-		requestBodySchema: {
-			type: "object",
-			properties: {
-				name: { type: "string" },
-			},
-			required: ["name"],
-		},
-		...partial,
-	};
-}
-
-describe("buildRequest (requestBody)", () => {
-	test("builds body from expanded --body-* flags", async () => {
-		const prevHome = process.env.HOME;
-		const home = `${tmpdir()}/opencli-test-${crypto.randomUUID()}`;
-		process.env.HOME = home;
-
-		try {
-			const { request, curl } = await buildRequest({
-				specId: "spec",
-				action: makeAction(),
-				positionalValues: [],
-				flagValues: { __body: { bodyName: "A" } },
-				globals: {},
-				servers: [
-					{ url: "https://api.example.com", variables: [], variableNames: [] },
-				],
-				authSchemes: [],
-			});
-
-			expect(request.headers.get("Content-Type")).toBe("application/json");
-			expect(await request.clone().text()).toBe('{"name":"A"}');
-			expect(curl).toContain("--data");
-			expect(curl).toContain('{"name":"A"}');
-		} finally {
-			process.env.HOME = prevHome;
-		}
-	});
-
-	test("throws when requestBody is required but missing", async () => {
-		const prevHome = process.env.HOME;
-		const home = `${tmpdir()}/opencli-test-${crypto.randomUUID()}`;
-		process.env.HOME = home;
-
-		try {
-			await expect(() =>
-				buildRequest({
-					specId: "spec",
-					action: makeAction(),
-					positionalValues: [],
-					flagValues: {},
-					globals: {},
-					servers: [
-						{
-							url: "https://api.example.com",
-							variables: [],
-							variableNames: [],
-						},
-					],
-					authSchemes: [],
-				}),
-			).toThrow(
-				"Missing request body. Provide --data, --file, or --body-* flags.",
-			);
-		} finally {
-			process.env.HOME = prevHome;
-		}
-	});
-
-	test("throws friendly error for missing required expanded field", async () => {
-		const prevHome = process.env.HOME;
-		const home = `${tmpdir()}/opencli-test-${crypto.randomUUID()}`;
-		process.env.HOME = home;
-
-		try {
-			await expect(() =>
-				buildRequest({
-					specId: "spec",
-					action: makeAction(),
-					positionalValues: [],
-					flagValues: { __body: { bodyFoo: "bar" } },
-					globals: {},
-					servers: [
-						{
-							url: "https://api.example.com",
-							variables: [],
-							variableNames: [],
-						},
-					],
-					authSchemes: [],
-				}),
-			).toThrow(
-				"Missing required body field 'name'. Provide --body-name or use --data/--file.",
-			);
-		} finally {
-			process.env.HOME = prevHome;
-		}
-	});
-});
-
-describe("formatAjvErrors", () => {
-	test("pretty prints required errors", () => {
-		const ajv = createAjv();
-		const validate = ajv.compile({
-			type: "object",
-			properties: { name: { type: "string" } },
-			required: ["name"],
-		});
-
-		validate({});
-		const msg = formatAjvErrors(validate.errors);
-		expect(msg).toBe("/ missing required property 'name'");
-	});
-});

package/src/cli/server.test.ts

@@ -1,35 +0,0 @@
-import { describe, expect, test } from "bun:test";
-
-import { listServers } from "./server.ts";
-import type { OpenApiDoc } from "./types.ts";
-
-describe("listServers", () => {
-	test("extracts server variables from template", () => {
-		const doc: OpenApiDoc = {
-			openapi: "3.0.3",
-			servers: [
-				{
-					url: "https://{region}.api.example.com/{basePath}",
-					variables: {
-						region: {
-							default: "us",
-							enum: ["us", "eu"],
-						},
-						basePath: {
-							default: "v1",
-						},
-					},
-				} as const,
-			],
-		};
-
-		const servers = listServers(doc);
-		expect(servers).toHaveLength(1);
-		expect(servers[0]?.variableNames).toEqual(["region", "basePath"]);
-		expect(servers[0]?.variables.map((v) => v.name)).toEqual([
-			"region",
-			"basePath",
-		]);
-		expect(servers[0]?.variables[0]?.enum).toEqual(["us", "eu"]);
-	});
-});

package/tsconfig.json

@@ -1,29 +0,0 @@
-{
-	"compilerOptions": {
-		// Environment setup & latest features
-		"lib": ["ESNext"],
-		"target": "ESNext",
-		"module": "Preserve",
-		"moduleDetection": "force",
-		"jsx": "react-jsx",
-		"allowJs": true,
-
-		// Bundler mode
-		"moduleResolution": "bundler",
-		"allowImportingTsExtensions": true,
-		"verbatimModuleSyntax": true,
-		"noEmit": true,
-
-		// Best practices
-		"strict": true,
-		"skipLibCheck": true,
-		"noFallthroughCasesInSwitch": true,
-		"noUncheckedIndexedAccess": true,
-		"noImplicitOverride": true,
-
-		// Some stricter flags (disabled by default)
-		"noUnusedLocals": false,
-		"noUnusedParameters": false,
-		"noPropertyAccessFromIndexSignature": false
-	}
-}