chowbea-axios 1.0.0

package/dist/lib/fetcher.d.ts

@@ -0,0 +1,115 @@
+/**
+ * OpenAPI spec fetcher with retry logic and caching.
+ * Supports graceful fallback to cached spec on network failures.
+ */
+import type { Logger } from "./logger.js";
+/**
+ * Cache metadata stored in .api-cache.json
+ */
+export interface CacheMetadata {
+    /** SHA256 hash of the OpenAPI spec content */
+    hash: string;
+    /** Timestamp when the spec was last fetched */
+    timestamp: number;
+    /** The endpoint URL used to fetch the spec */
+    endpoint: string;
+}
+/**
+ * Result of fetching the OpenAPI spec.
+ */
+export interface FetchResult {
+    /** The raw spec content as a Buffer */
+    buffer: Buffer;
+    /** SHA256 hash of the content */
+    hash: string;
+    /** Whether the spec has changed since last fetch */
+    hasChanged: boolean;
+    /** Whether this was loaded from cache due to network failure */
+    fromCache: boolean;
+}
+/**
+ * Retry configuration for network operations.
+ */
+export interface RetryConfig {
+    /** Maximum number of retry attempts (default: 3) */
+    maxAttempts: number;
+    /** Base delay between retries in ms (default: 1000) */
+    baseDelay: number;
+    /** Multiplier for exponential backoff (default: 2) */
+    backoffMultiplier: number;
+}
+/**
+ * Interpolates environment variables in a string.
+ * Replaces $VAR_NAME or ${VAR_NAME} with the environment variable value.
+ * Throws if a referenced env var is not set.
+ */
+export declare function interpolateEnvVars(value: string): string;
+/**
+ * Interpolates environment variables in all header values.
+ */
+export declare function interpolateHeaders(headers: Record<string, string>): Record<string, string>;
+/**
+ * Computes SHA256 hash of a buffer.
+ */
+export declare function computeHash(buffer: Buffer): string;
+/**
+ * Loads cache metadata from the cache file.
+ * Returns null if cache doesn't exist or is corrupted.
+ */
+export declare function loadCacheMetadata(cachePath: string): Promise<CacheMetadata | null>;
+/**
+ * Saves cache metadata to the cache file.
+ */
+export declare function saveCacheMetadata(cachePath: string, metadata: CacheMetadata): Promise<void>;
+/**
+ * Loads the cached OpenAPI spec from disk.
+ * Returns null if spec doesn't exist.
+ */
+export declare function loadCachedSpec(specPath: string): Promise<Buffer | null>;
+/**
+ * Fetches the OpenAPI spec from a remote endpoint with retry logic.
+ * Falls back to cached spec on network failure.
+ */
+export declare function fetchOpenApiSpec(options: {
+    endpoint: string;
+    specPath: string;
+    cachePath: string;
+    logger: Logger;
+    force?: boolean;
+    retryConfig?: RetryConfig;
+    headers?: Record<string, string>;
+}): Promise<FetchResult>;
+/**
+ * Saves the fetched spec and updates cache metadata.
+ */
+export declare function saveSpec(options: {
+    buffer: Buffer;
+    hash: string;
+    endpoint: string;
+    specPath: string;
+    cachePath: string;
+}): Promise<void>;
+/**
+ * Checks if the local spec exists and is valid.
+ */
+export declare function hasLocalSpec(specPath: string): Promise<boolean>;
+/**
+ * Loads and parses the local OpenAPI spec.
+ * Throws SpecNotFoundError if not found.
+ */
+export declare function loadLocalSpec(specPath: string): Promise<{
+    spec: unknown;
+    buffer: Buffer;
+}>;
+/**
+ * Loads a spec from a local file and copies it to the cache location.
+ * Returns a FetchResult-like object for consistency with remote fetching.
+ */
+export declare function loadLocalSpecFile(options: {
+    localPath: string;
+    specPath: string;
+    cachePath: string;
+    logger: Logger;
+    force?: boolean;
+}): Promise<FetchResult>;
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/lib/fetcher.d.ts.map

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

package/dist/lib/fetcher.js

@@ -0,0 +1,237 @@
+/**
+ * OpenAPI spec fetcher with retry logic and caching.
+ * Supports graceful fallback to cached spec on network failures.
+ */
+import { createHash } from "node:crypto";
+import { access, readFile, writeFile } from "node:fs/promises";
+import { NetworkError, SpecNotFoundError } from "./errors.js";
+const DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 3,
+    baseDelay: 1000,
+    backoffMultiplier: 2,
+};
+/**
+ * Interpolates environment variables in a string.
+ * Replaces $VAR_NAME or ${VAR_NAME} with the environment variable value.
+ * Throws if a referenced env var is not set.
+ */
+export function interpolateEnvVars(value) {
+    // Match $VAR_NAME or ${VAR_NAME}
+    return value.replace(/\$\{?([A-Z_][A-Z0-9_]*)\}?/gi, (_match, varName) => {
+        const envValue = process.env[varName];
+        if (envValue === undefined) {
+            throw new Error(`Environment variable ${varName} is not set (referenced in: ${value})`);
+        }
+        return envValue;
+    });
+}
+/**
+ * Interpolates environment variables in all header values.
+ */
+export function interpolateHeaders(headers) {
+    const result = {};
+    for (const [key, value] of Object.entries(headers)) {
+        result[key] = interpolateEnvVars(value);
+    }
+    return result;
+}
+/**
+ * Computes SHA256 hash of a buffer.
+ */
+export function computeHash(buffer) {
+    return createHash("sha256").update(buffer).digest("hex");
+}
+/**
+ * Delays execution for the specified milliseconds.
+ */
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Loads cache metadata from the cache file.
+ * Returns null if cache doesn't exist or is corrupted.
+ */
+export async function loadCacheMetadata(cachePath) {
+    try {
+        await access(cachePath);
+        const content = await readFile(cachePath, "utf8");
+        const parsed = JSON.parse(content);
+        // Validate cache structure
+        if (typeof parsed.hash === "string" &&
+            typeof parsed.timestamp === "number" &&
+            typeof parsed.endpoint === "string") {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Saves cache metadata to the cache file.
+ */
+export async function saveCacheMetadata(cachePath, metadata) {
+    await writeFile(cachePath, JSON.stringify(metadata, null, 2), "utf8");
+}
+/**
+ * Loads the cached OpenAPI spec from disk.
+ * Returns null if spec doesn't exist.
+ */
+export async function loadCachedSpec(specPath) {
+    try {
+        await access(specPath);
+        return await readFile(specPath);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fetches the OpenAPI spec from a remote endpoint with retry logic.
+ * Falls back to cached spec on network failure.
+ */
+export async function fetchOpenApiSpec(options) {
+    const { endpoint, specPath, cachePath, logger, force = false } = options;
+    const retryConfig = options.retryConfig ?? DEFAULT_RETRY_CONFIG;
+    // Interpolate env vars in headers
+    const headers = {
+        Accept: "application/json",
+    };
+    if (options.headers) {
+        try {
+            const interpolated = interpolateHeaders(options.headers);
+            Object.assign(headers, interpolated);
+        }
+        catch (error) {
+            throw new Error(`Failed to interpolate headers: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    // Load existing cache metadata
+    const existingCache = await loadCacheMetadata(cachePath);
+    // Attempt to fetch with retries
+    let lastError = null;
+    for (let attempt = 1; attempt <= retryConfig.maxAttempts; attempt++) {
+        try {
+            logger.debug({ attempt, endpoint }, "Fetching OpenAPI spec...");
+            const response = await fetch(endpoint, {
+                headers,
+            });
+            if (!response.ok) {
+                throw new NetworkError(endpoint, `HTTP ${response.status}: ${response.statusText}`, response.status);
+            }
+            const arrayBuffer = await response.arrayBuffer();
+            const buffer = Buffer.from(arrayBuffer);
+            const hash = computeHash(buffer);
+            // Check if content has changed
+            const hasChanged = force || !existingCache || existingCache.hash !== hash;
+            logger.debug({ hash, hasChanged, bytes: buffer.length }, "Spec fetched successfully");
+            return {
+                buffer,
+                hash,
+                hasChanged,
+                fromCache: false,
+            };
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt < retryConfig.maxAttempts) {
+                const delayMs = retryConfig.baseDelay *
+                    retryConfig.backoffMultiplier ** (attempt - 1);
+                logger.warn({
+                    attempt,
+                    maxAttempts: retryConfig.maxAttempts,
+                    delayMs,
+                    error: lastError.message,
+                }, "Fetch failed, retrying...");
+                await delay(delayMs);
+            }
+        }
+    }
+    // All retries failed - try to fall back to cached spec
+    logger.warn({ attempts: retryConfig.maxAttempts, error: lastError?.message }, "All fetch attempts failed, checking for cached spec...");
+    const cachedSpec = await loadCachedSpec(specPath);
+    if (cachedSpec && existingCache) {
+        logger.info("Using cached OpenAPI spec due to network failure");
+        return {
+            buffer: cachedSpec,
+            hash: existingCache.hash,
+            hasChanged: false, // Don't regenerate if using cached
+            fromCache: true,
+        };
+    }
+    // No cache available - throw the network error
+    throw new NetworkError(endpoint, `Failed to fetch OpenAPI spec after ${retryConfig.maxAttempts} attempts: ${lastError?.message}`);
+}
+/**
+ * Saves the fetched spec and updates cache metadata.
+ */
+export async function saveSpec(options) {
+    const { buffer, hash, endpoint, specPath, cachePath } = options;
+    // Write spec file
+    await writeFile(specPath, buffer);
+    // Update cache metadata
+    await saveCacheMetadata(cachePath, {
+        hash,
+        timestamp: Date.now(),
+        endpoint,
+    });
+}
+/**
+ * Checks if the local spec exists and is valid.
+ */
+export async function hasLocalSpec(specPath) {
+    try {
+        await access(specPath);
+        const content = await readFile(specPath, "utf8");
+        JSON.parse(content); // Verify it's valid JSON
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Loads and parses the local OpenAPI spec.
+ * Throws SpecNotFoundError if not found.
+ */
+export async function loadLocalSpec(specPath) {
+    try {
+        await access(specPath);
+    }
+    catch {
+        throw new SpecNotFoundError(specPath);
+    }
+    const buffer = await readFile(specPath);
+    const content = buffer.toString("utf8");
+    try {
+        const spec = JSON.parse(content);
+        return { spec, buffer };
+    }
+    catch (error) {
+        throw new Error(`Failed to parse OpenAPI spec: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Loads a spec from a local file and copies it to the cache location.
+ * Returns a FetchResult-like object for consistency with remote fetching.
+ */
+export async function loadLocalSpecFile(options) {
+    const { localPath, cachePath, logger, force = false } = options;
+    logger.info({ localPath }, "Loading local spec file...");
+    // Load existing cache metadata
+    const existingCache = await loadCacheMetadata(cachePath);
+    // Load and parse the local file
+    const { buffer } = await loadLocalSpec(localPath);
+    const hash = computeHash(buffer);
+    // Check if content has changed
+    const hasChanged = force || !existingCache || existingCache.hash !== hash;
+    logger.debug({ hash, hasChanged, bytes: buffer.length }, "Local spec loaded");
+    return {
+        buffer,
+        hash,
+        hasChanged,
+        fromCache: false,
+    };
+}
+//# sourceMappingURL=fetcher.js.map

package/dist/lib/fetcher.js.map

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

package/dist/lib/generator.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Core generation logic for TypeScript types and operations.
+ * Migrated from scripts/generate-operations.js with atomic writes and rollback.
+ */
+import type { InstanceConfig, OutputPaths } from "./config.js";
+import type { Logger } from "./logger.js";
+/**
+ * Output paths for generated files.
+ * Re-export OutputPaths from config for backwards compatibility.
+ */
+export type GeneratorPaths = OutputPaths;
+/**
+ * Result of client files generation.
+ */
+export interface ClientFilesResult {
+    /** Whether api.instance.ts was generated */
+    instance: boolean;
+    /** Whether api.error.ts was generated */
+    error: boolean;
+    /** Whether api.client.ts was generated */
+    client: boolean;
+}
+/**
+ * Result of the generation process.
+ */
+export interface GenerationResult {
+    /** Number of operations generated */
+    operationCount: number;
+    /** Duration of generation in milliseconds */
+    durationMs: number;
+    /** Whether types were generated successfully */
+    typesGenerated: boolean;
+    /** Whether operations were generated successfully */
+    operationsGenerated: boolean;
+    /** Client files generated (if any) */
+    clientFiles?: ClientFilesResult;
+}
+/**
+ * Generates the api.helpers.ts file content.
+ * Contains all utility types for extracting request/response types from OpenAPI schema.
+ */
+export declare function generateHelpersFileContent(): string;
+/**
+ * Generates the api.instance.ts file content.
+ */
+export declare function generateInstanceFileContent(config: InstanceConfig): string;
+/**
+ * Generates the api.error.ts file content.
+ */
+export declare function generateErrorFileContent(): string;
+/**
+ * Generates the api.client.ts file content.
+ */
+export declare function generateClientFileContent(): string;
+/**
+ * Generates client files if they don't exist.
+ * Returns which files were generated.
+ */
+export declare function generateClientFiles(options: {
+    paths: GeneratorPaths;
+    instanceConfig: InstanceConfig;
+    logger: Logger;
+    force?: boolean;
+}): Promise<{
+    helpers: boolean;
+    instance: boolean;
+    error: boolean;
+    client: boolean;
+}>;
+/**
+ * Main generation function that produces types and operations.
+ * Includes atomic writes and rollback on failure.
+ */
+/**
+ * Dry run result showing what would be written.
+ */
+export interface DryRunResult {
+    /** Files that would be written */
+    files: Array<{
+        path: string;
+        lines: number;
+        action: "create" | "update";
+    }>;
+    /** Number of operations that would be generated */
+    operationCount: number;
+}
+export declare function generate(options: {
+    paths: GeneratorPaths;
+    logger: Logger;
+    dryRun?: boolean;
+    skipTypes?: boolean;
+    skipOperations?: boolean;
+}): Promise<GenerationResult & {
+    dryRunResult?: DryRunResult;
+}>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/lib/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/lib/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,qDAAqD;IACrD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,sCAAsC;IACtC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAigBD;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAgSnD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAsD1E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CA8QjD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAiXlD;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IAClD,KAAK,EAAE,cAAc,CAAC;IACtB,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CAChB,CAAC,CAoED;AAED;;;GAGG;AACH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,kCAAkC;IAClC,KAAK,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;KAC5B,CAAC,CAAC;IACH,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE;IACvC,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC,gBAAgB,GAAG;IAAE,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC,CA+G9D"}