@kirrosh/zond 0.7.0

package/src/core/setup-api.ts

@@ -0,0 +1,113 @@
+import { resolve, join } from "path";
+import { mkdirSync, writeFileSync, existsSync, readFileSync } from "fs";
+import { getDb } from "../db/schema.ts";
+import { createCollection, deleteCollection, findCollectionByNameOrId, normalizePath } from "../db/queries.ts";
+import { readOpenApiSpec, extractEndpoints } from "./generator/index.ts";
+
+function toYaml(vars: Record<string, string>): string {
+  const lines: string[] = [];
+  for (const [k, v] of Object.entries(vars)) {
+    const needsQuote = /[:#\[\]{}&*!|>'"@`,%]/.test(v) || v.includes(" ") || v === "";
+    lines.push(`${k}: ${needsQuote ? `"${v.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"` : v}`);
+  }
+  return lines.join("\n");
+}
+
+export interface SetupApiOptions {
+  name: string;
+  spec?: string;
+  dir?: string;
+  envVars?: Record<string, string>;
+  dbPath?: string;
+  force?: boolean;
+}
+
+export interface SetupApiResult {
+  created: true;
+  collectionId: number;
+  baseDir: string;
+  testPath: string;
+  baseUrl: string;
+  specEndpoints: number;
+}
+
+export async function setupApi(options: SetupApiOptions): Promise<SetupApiResult> {
+  const { name, spec, dbPath } = options;
+
+  getDb(dbPath);
+
+  // Validate name uniqueness (or force-replace)
+  const existing = findCollectionByNameOrId(name);
+  if (existing) {
+    if (options.force) {
+      deleteCollection(existing.id, true);
+    } else {
+      throw new Error(`API '${name}' already exists (id=${existing.id})`);
+    }
+  }
+
+  // Sanitize name for directory use
+  const dirName = name.replace(/[^a-zA-Z0-9_\-\.]/g, "-").toLowerCase();
+  const baseDir = resolve(options.dir ?? `./apis/${dirName}/`);
+  const testPath = join(baseDir, "tests");
+
+  // Create directories
+  mkdirSync(testPath, { recursive: true });
+
+  // Try to load and validate spec, extract base_url
+  let openapiSpec: string | null = null;
+  let baseUrl = "";
+  let endpointCount = 0;
+  if (spec) {
+    const doc = await readOpenApiSpec(spec);
+    openapiSpec = spec;
+    if ((doc as any).servers?.[0]?.url) {
+      baseUrl = (doc as any).servers[0].url;
+    }
+    endpointCount = extractEndpoints(doc).length;
+  }
+
+  // Build environment variables
+  const envVars: Record<string, string> = {};
+  if (baseUrl) envVars.base_url = baseUrl;
+  if (options.envVars) {
+    Object.assign(envVars, options.envVars);
+  }
+
+  // Write .env.yaml in base_dir
+  if (Object.keys(envVars).length > 0) {
+    const envFilePath = join(baseDir, ".env.yaml");
+    writeFileSync(envFilePath, toYaml(envVars) + "\n", "utf-8");
+  }
+
+  // Create/update .gitignore to exclude env files
+  const gitignorePath = join(baseDir, ".gitignore");
+  const gitignoreContent = existsSync(gitignorePath) ? readFileSync(gitignorePath, "utf-8") : "";
+  if (!gitignoreContent.includes(".env*.yaml")) {
+    writeFileSync(
+      gitignorePath,
+      gitignoreContent + (gitignoreContent.endsWith("\n") || !gitignoreContent ? "" : "\n") + ".env*.yaml\n",
+      "utf-8",
+    );
+  }
+
+  const normalizedTestPath = normalizePath(testPath);
+  const normalizedBaseDir = normalizePath(baseDir);
+
+  // Create collection in DB
+  const collectionId = createCollection({
+    name,
+    base_dir: normalizedBaseDir,
+    test_path: normalizedTestPath,
+    openapi_spec: openapiSpec ?? undefined,
+  });
+
+  return {
+    created: true,
+    collectionId,
+    baseDir: normalizedBaseDir,
+    testPath: normalizedTestPath,
+    baseUrl,
+    specEndpoints: endpointCount,
+  };
+}

package/src/core/utils.ts

@@ -0,0 +1,9 @@
+export function getByPath(obj: unknown, path: string, defaultVal?: unknown): unknown {
+  const keys = path.split(".");
+  let result: unknown = obj;
+  for (const key of keys) {
+    result = (result as Record<string, unknown>)?.[key];
+    if (result === undefined) return defaultVal;
+  }
+  return result;
+}