chowbea-axios 1.0.0

package/dist/commands/watch.js

@@ -0,0 +1,202 @@
+/**
+ * Watch command - continuously polls for OpenAPI spec changes and regenerates.
+ * Includes graceful shutdown and automatic recovery from transient failures.
+ */
+import { Command, Flags } from "@oclif/core";
+import { ensureOutputFolders, getOutputPaths, loadConfig, } from "../lib/config.js";
+import { formatError } from "../lib/errors.js";
+import { fetchOpenApiSpec, saveSpec } from "../lib/fetcher.js";
+import { generate, generateClientFiles } from "../lib/generator.js";
+import { createLogger, formatDuration, getLogLevel, logSeparator, } from "../lib/logger.js";
+/**
+ * Watch for OpenAPI spec changes and regenerate automatically.
+ */
+export default class Watch extends Command {
+    static description = `Continuously poll for spec changes and regenerate.
+
+Useful during development - automatically regenerates types when
+your API changes. Press Ctrl+C to stop.
+
+Gracefully handles network failures and preserves cache on shutdown.`;
+    static examples = [
+        {
+            command: "<%= config.bin %> watch",
+            description: "Start watching with default 10s interval",
+        },
+        {
+            command: "<%= config.bin %> watch --interval 5000",
+            description: "Poll every 5 seconds",
+        },
+    ];
+    static flags = {
+        config: Flags.string({
+            char: "c",
+            description: "Path to api.config.toml",
+        }),
+        interval: Flags.integer({
+            char: "i",
+            description: "Polling interval in milliseconds",
+        }),
+        quiet: Flags.boolean({
+            char: "q",
+            description: "Suppress non-error output",
+            default: false,
+        }),
+        debug: Flags.boolean({
+            char: "d",
+            description: "Show verbose cycle-by-cycle logs",
+            default: false,
+        }),
+    };
+    // Track shutdown state
+    isShuttingDown = false;
+    cycleCounter = 0;
+    async run() {
+        const { flags } = await this.parse(Watch);
+        // Create initial logger (will be updated after config is loaded)
+        let logger = createLogger({ level: "warn" });
+        try {
+            // Load configuration first (auto-creates if missing)
+            const { config, projectRoot, configPath, wasCreated } = await loadConfig(flags.config);
+            // Update logger with appropriate level (uses config.watch.debug if no flag)
+            logger = createLogger({
+                level: getLogLevel(flags, config.watch.debug),
+            });
+            logSeparator(logger, "chowbea-axios watch");
+            logger.debug("Configuration loaded successfully");
+            if (wasCreated) {
+                logger.warn({ configPath }, "Created default api.config.toml - please review and update settings");
+            }
+            // Get output paths
+            const outputPaths = getOutputPaths(config, projectRoot);
+            logger.debug({ outputPaths }, "Resolved output paths");
+            // Ensure output folders exist (_internal, _generated)
+            await ensureOutputFolders(outputPaths);
+            // Generate client files if they don't exist (once at startup)
+            await generateClientFiles({
+                paths: outputPaths,
+                instanceConfig: config.instance,
+                logger,
+            });
+            // Determine polling interval
+            const intervalMs = flags.interval ?? config.poll_interval_ms;
+            const endpoint = config.api_endpoint;
+            logger.info({ endpoint, intervalMs }, "Starting watch mode - press Ctrl+C to stop");
+            // Set up graceful shutdown handlers
+            const shutdown = (signal) => {
+                if (this.isShuttingDown)
+                    return;
+                this.isShuttingDown = true;
+                logger.warn({ signal }, "Shutting down watch mode...");
+                logger.info("Cache preserved for next run");
+                // Give time for any current operation to complete
+                setTimeout(() => {
+                    process.exit(0);
+                }, 100);
+            };
+            process.on("SIGINT", () => shutdown("SIGINT"));
+            process.on("SIGTERM", () => shutdown("SIGTERM"));
+            // Main watch loop
+            while (!this.isShuttingDown) {
+                this.cycleCounter++;
+                const cycleId = this.cycleCounter;
+                await this.runCycle({
+                    cycleId,
+                    endpoint,
+                    outputPaths,
+                    logger,
+                    headers: config.fetch?.headers,
+                });
+                // Wait before next cycle
+                if (!this.isShuttingDown) {
+                    await this.delay(intervalMs);
+                }
+            }
+        }
+        catch (error) {
+            logger.error(formatError(error));
+            this.exit(1);
+        }
+    }
+    /**
+     * Runs a single watch cycle - fetch, check for changes, regenerate if needed.
+     */
+    async runCycle(options) {
+        const { cycleId, endpoint, outputPaths, logger, headers } = options;
+        const startTime = Date.now();
+        // Only show cycle separator in debug mode
+        if (logger.level === "debug") {
+            logSeparator(logger, `Cycle ${cycleId}`);
+        }
+        try {
+            // Fetch the spec with retry logic (debug level - only shown with --debug)
+            logger.debug({ cycleId, endpoint }, "Checking for API changes...");
+            const fetchResult = await fetchOpenApiSpec({
+                endpoint,
+                specPath: outputPaths.spec,
+                cachePath: outputPaths.cache,
+                logger,
+                force: false,
+                headers,
+            });
+            // Handle network fallback
+            if (fetchResult.fromCache) {
+                logger.warn({ cycleId }, "Using cached spec due to network issues");
+            }
+            // Skip if unchanged (debug level - only shown with --debug)
+            if (!fetchResult.hasChanged) {
+                const durationMs = Date.now() - startTime;
+                logger.debug({ cycleId, durationMs: formatDuration(durationMs) }, "No changes detected, skipping generation");
+                return;
+            }
+            // Save the new spec
+            await saveSpec({
+                buffer: fetchResult.buffer,
+                hash: fetchResult.hash,
+                endpoint,
+                specPath: outputPaths.spec,
+                cachePath: outputPaths.cache,
+            });
+            logger.info({ cycleId, bytes: fetchResult.buffer.length }, "New spec detected, regenerating...");
+            // Run generation
+            const result = await generate({
+                paths: outputPaths,
+                logger,
+            });
+            logger.info({
+                cycleId,
+                operations: result.operationCount,
+                duration: formatDuration(result.durationMs),
+            }, "Generation completed");
+        }
+        catch (error) {
+            // Log error but continue watching
+            logger.error({
+                cycleId,
+                error: error instanceof Error ? error.message : String(error),
+            }, "Cycle failed, will retry next interval");
+        }
+    }
+    /**
+     * Delays execution for the specified milliseconds.
+     * Respects shutdown state for early termination.
+     */
+    delay(ms) {
+        return new Promise((resolve) => {
+            // Interval to check for early shutdown
+            const checkShutdown = setInterval(() => {
+                if (this.isShuttingDown) {
+                    clearTimeout(timer);
+                    clearInterval(checkShutdown);
+                    resolve();
+                }
+            }, 100);
+            // Main timeout - clears interval on normal completion to prevent memory leak
+            const timer = setTimeout(() => {
+                clearInterval(checkShutdown);
+                resolve();
+            }, ms);
+        });
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * chowbea-axios CLI entry point.
+ * Exports the oclif run function for programmatic usage.
+ */
+export { run } from "@oclif/core";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * chowbea-axios CLI entry point.
+ * Exports the oclif run function for programmatic usage.
+ */
+export { run } from "@oclif/core";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC"}

package/dist/lib/config.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Configuration loader with auto-create functionality.
+ * Finds project root, loads api.config.toml, and auto-creates if missing.
+ */
+/**
+ * Fetch configuration for remote spec retrieval.
+ */
+export interface FetchConfig {
+    /** Headers to include when fetching the OpenAPI spec */
+    headers?: Record<string, string>;
+}
+/**
+ * Watch mode configuration for controlling debug output.
+ */
+export interface WatchConfig {
+    /** Enable debug logging in watch mode (shows cycle-by-cycle logs) */
+    debug: boolean;
+}
+/**
+ * Instance configuration for the generated axios client.
+ */
+export interface InstanceConfig {
+    /** Environment variable name for base URL (e.g., "VITE_API_URL") */
+    base_url_env: string;
+    /** localStorage key for auth token */
+    token_key: string;
+    /** Whether to include credentials (cookies) in requests */
+    with_credentials: boolean;
+    /** Request timeout in milliseconds */
+    timeout: number;
+}
+/**
+ * Configuration structure for api.config.toml
+ */
+export interface ApiConfig {
+    /** Remote OpenAPI spec endpoint URL */
+    api_endpoint: string;
+    /** Local spec file path (takes priority over api_endpoint if set) */
+    spec_file?: string;
+    /** Polling interval in milliseconds for watch mode */
+    poll_interval_ms: number;
+    /** Output configuration */
+    output: {
+        /** Folder where all generated files are written */
+        folder: string;
+    };
+    /** Fetch configuration for remote spec retrieval */
+    fetch?: FetchConfig;
+    /** Instance configuration for the generated axios client */
+    instance: InstanceConfig;
+    /** Watch mode configuration */
+    watch: WatchConfig;
+}
+/**
+ * Default watch configuration values.
+ */
+export declare const DEFAULT_WATCH_CONFIG: WatchConfig;
+/**
+ * Default instance configuration values.
+ */
+export declare const DEFAULT_INSTANCE_CONFIG: InstanceConfig;
+/**
+ * Default configuration values used when auto-creating config.
+ */
+export declare const DEFAULT_CONFIG: ApiConfig;
+/**
+ * Finds the project root by walking up to the nearest package.json.
+ * Returns the directory containing package.json.
+ */
+export declare function findProjectRoot(startDir?: string): Promise<string>;
+/**
+ * Gets the path to api.config.toml relative to project root.
+ */
+export declare function getConfigPath(projectRoot: string): string;
+/**
+ * Checks if a config file exists at the given path.
+ */
+export declare function configExists(configPath: string): Promise<boolean>;
+/**
+ * Creates a default config file at the specified path.
+ */
+export declare function createDefaultConfig(configPath: string): Promise<void>;
+/**
+ * Spec source types for determining where to load the spec from.
+ */
+export type SpecSource = {
+    type: "local";
+    path: string;
+} | {
+    type: "remote";
+    endpoint: string;
+};
+/**
+ * Resolves the spec source based on config and flag overrides.
+ * Priority: flag > config spec_file > config api_endpoint
+ */
+export declare function resolveSpecSource(config: ApiConfig, projectRoot: string, flagSpecFile?: string): SpecSource;
+/**
+ * Loads and parses the configuration file.
+ * Auto-creates with defaults if missing.
+ */
+export declare function loadConfig(configPath?: string): Promise<{
+    config: ApiConfig;
+    projectRoot: string;
+    configPath: string;
+    wasCreated: boolean;
+}>;
+/**
+ * Resolves the output folder path to an absolute path.
+ */
+export declare function resolveOutputFolder(config: ApiConfig, projectRoot: string): string;
+/**
+ * Output paths for all generated files.
+ */
+export interface OutputPaths {
+    /** Root output folder */
+    folder: string;
+    /** _internal folder for cache files */
+    internal: string;
+    /** _generated folder for auto-generated code */
+    generated: string;
+    /** Path to api.types.ts (generated types) */
+    types: string;
+    /** Path to api.operations.ts (generated operations) */
+    operations: string;
+    /** Path to api.helpers.ts (utility types - generated once) */
+    helpers: string;
+    /** Path to openapi.json spec file */
+    spec: string;
+    /** Path to .api-cache.json */
+    cache: string;
+    /** Path to api.instance.ts (axios instance - generated once) */
+    instance: string;
+    /** Path to api.error.ts (error handling - generated once) */
+    error: string;
+    /** Path to api.client.ts (typed facade - generated once) */
+    client: string;
+}
+/**
+ * Gets paths for all generated files based on config.
+ */
+export declare function getOutputPaths(config: ApiConfig, projectRoot: string): OutputPaths;
+/**
+ * Ensures the output folder and subfolders exist, creating them if necessary.
+ */
+export declare function ensureOutputFolder(outputFolder: string): Promise<void>;
+/**
+ * Ensures all output folders exist (_internal, _generated, and root).
+ */
+export declare function ensureOutputFolders(paths: OutputPaths): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

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

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