@vue-skuilder/common 0.1.6 → 0.1.7

package/dist/docker/CouchDBManager.d.ts

@@ -0,0 +1,84 @@
+import { EventEmitter } from 'events';
+export interface CouchDBConfig {
+    mode: 'blank' | 'test-data' | 'custom';
+    port: number;
+    containerName?: string;
+    image?: string;
+    username?: string;
+    password?: string;
+    dataVolume?: string;
+    configFile?: string;
+    maxStartupWaitMs?: number;
+}
+export interface CouchDBManagerOptions {
+    onLog?: (message: string) => void;
+    onError?: (error: string) => void;
+}
+export declare class CouchDBManager extends EventEmitter {
+    private config;
+    private options;
+    private isStarting;
+    constructor(config: CouchDBConfig, options?: CouchDBManagerOptions);
+    private log;
+    private error;
+    /**
+     * Check if Docker is available
+     */
+    checkDockerAvailable(): Promise<boolean>;
+    /**
+     * Check if container exists
+     */
+    private containerExists;
+    /**
+     * Check if container is running
+     */
+    private isContainerRunning;
+    /**
+     * Stop and remove existing container
+     */
+    private cleanupExistingContainer;
+    /**
+     * Build Docker run command based on configuration
+     */
+    private buildDockerCommand;
+    /**
+     * Wait for CouchDB to be ready
+     */
+    private waitForReady;
+    /**
+     * Start CouchDB container
+     */
+    start(): Promise<void>;
+    /**
+     * Stop CouchDB container
+     */
+    stop(): Promise<void>;
+    /**
+     * Remove CouchDB container and volumes
+     */
+    remove(): Promise<void>;
+    /**
+     * Get container status
+     */
+    getStatus(): Promise<'running' | 'stopped' | 'missing'>;
+    /**
+     * Get connection URL for this CouchDB instance
+     */
+    getConnectionUrl(): string;
+    /**
+     * Get connection details for applications
+     */
+    getConnectionDetails(): {
+        protocol: string;
+        host: string;
+        port: number;
+        username: string;
+        password: string;
+        url: string;
+    };
+    /**
+     * Configure CORS settings for browser access
+     */
+    private configureCORS;
+}
+//# sourceMappingURL=CouchDBManager.d.ts.map

package/dist/docker/CouchDBManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CouchDBManager.d.ts","sourceRoot":"","sources":["../../src/docker/CouchDBManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,qBAA0B;IAsBtE,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,KAAK;IAIb;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC;IAS9C;;OAEG;YACW,eAAe;IAY7B;;OAEG;YACW,kBAAkB;IAYhC;;OAEG;YACW,wBAAwB;IAqBtC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoC1B;;OAEG;YACW,YAAY;IAsB1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB7B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAY7D;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,oBAAoB;;;;;;;;IAWpB;;OAEG;YACW,aAAa;CA8C5B"}

package/dist/docker/CouchDBManager.js

@@ -0,0 +1,307 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CouchDBManager = void 0;
+const child_process_1 = require("child_process");
+const events_1 = require("events");
+class CouchDBManager extends events_1.EventEmitter {
+    config;
+    options;
+    isStarting = false;
+    constructor(config, options = {}) {
+        super();
+        // Set defaults
+        this.config = {
+            mode: config.mode,
+            port: config.port,
+            containerName: config.containerName || `skuilder-couch-${config.port}`,
+            image: config.image || 'couchdb:3.4.3',
+            username: config.username || 'admin',
+            password: config.password || 'password',
+            dataVolume: config.dataVolume || '',
+            configFile: config.configFile || '',
+            maxStartupWaitMs: config.maxStartupWaitMs || 30000,
+        };
+        this.options = {
+            onLog: options.onLog || (() => { }),
+            onError: options.onError || (() => { }),
+        };
+    }
+    log(message) {
+        this.options.onLog(message);
+    }
+    error(message) {
+        this.options.onError(message);
+    }
+    /**
+     * Check if Docker is available
+     */
+    async checkDockerAvailable() {
+        try {
+            (0, child_process_1.execSync)('docker --version', { stdio: 'pipe' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if container exists
+     */
+    async containerExists() {
+        try {
+            const result = (0, child_process_1.execSync)(`docker ps -a -q -f name=^${this.config.containerName}$`, { stdio: 'pipe' }).toString().trim();
+            return result.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if container is running
+     */
+    async isContainerRunning() {
+        try {
+            const result = (0, child_process_1.execSync)(`docker ps -q -f name=^${this.config.containerName}$`, { stdio: 'pipe' }).toString().trim();
+            return result.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Stop and remove existing container
+     */
+    async cleanupExistingContainer() {
+        if (await this.containerExists()) {
+            this.log(`Found existing container '${this.config.containerName}'. Cleaning up...`);
+            try {
+                if (await this.isContainerRunning()) {
+                    this.log('Stopping container...');
+                    (0, child_process_1.execSync)(`docker stop ${this.config.containerName}`, { stdio: 'pipe' });
+                    this.log('Container stopped.');
+                }
+                this.log('Removing container...');
+                (0, child_process_1.execSync)(`docker rm ${this.config.containerName}`, { stdio: 'pipe' });
+                this.log('Container removed.');
+            }
+            catch (error) {
+                this.error(`Error during cleanup: ${error instanceof Error ? error.message : String(error)}`);
+                throw error;
+            }
+        }
+    }
+    /**
+     * Build Docker run command based on configuration
+     */
+    buildDockerCommand() {
+        const cmd = [
+            'run', '-d',
+            '--name', this.config.containerName,
+            '-p', `${this.config.port}:5984`,
+            '-e', `COUCHDB_USER=${this.config.username}`,
+            '-e', `COUCHDB_PASSWORD=${this.config.password}`,
+        ];
+        // Add volume mounts based on mode
+        switch (this.config.mode) {
+            case 'test-data':
+                if (this.config.dataVolume) {
+                    cmd.push('-v', `${this.config.dataVolume}:/opt/couchdb/data`);
+                }
+                if (this.config.configFile) {
+                    cmd.push('-v', `${this.config.configFile}:/opt/couchdb/etc/local.ini`);
+                }
+                break;
+            case 'custom':
+                if (this.config.dataVolume) {
+                    cmd.push('-v', `${this.config.dataVolume}:/opt/couchdb/data`);
+                }
+                if (this.config.configFile) {
+                    cmd.push('-v', `${this.config.configFile}:/opt/couchdb/etc/local.ini`);
+                }
+                break;
+            case 'blank':
+                // No volume mounts for blank mode - clean slate
+                break;
+        }
+        cmd.push(this.config.image);
+        return cmd;
+    }
+    /**
+     * Wait for CouchDB to be ready
+     */
+    async waitForReady() {
+        const maxAttempts = Math.floor(this.config.maxStartupWaitMs / 1000);
+        let attempts = 0;
+        return new Promise((resolve, reject) => {
+            const checkInterval = setInterval(() => {
+                attempts++;
+                try {
+                    (0, child_process_1.execSync)(`curl -s http://localhost:${this.config.port}/`, { stdio: 'pipe' });
+                    clearInterval(checkInterval);
+                    this.log('CouchDB is ready!');
+                    resolve();
+                }
+                catch {
+                    if (attempts >= maxAttempts) {
+                        clearInterval(checkInterval);
+                        reject(new Error('CouchDB failed to start within timeout period'));
+                    }
+                }
+            }, 1000);
+        });
+    }
+    /**
+     * Start CouchDB container
+     */
+    async start() {
+        if (this.isStarting) {
+            throw new Error('CouchDB is already starting');
+        }
+        this.isStarting = true;
+        try {
+            // Check Docker availability
+            if (!(await this.checkDockerAvailable())) {
+                throw new Error('Docker is not available or not running');
+            }
+            // Clean up any existing container
+            await this.cleanupExistingContainer();
+            // Build and execute Docker command
+            const dockerCmd = this.buildDockerCommand();
+            this.log(`Starting CouchDB container: docker ${dockerCmd.join(' ')}`);
+            (0, child_process_1.execSync)(`docker ${dockerCmd.join(' ')}`, { stdio: 'pipe' });
+            this.log('Container started successfully');
+            // Wait for CouchDB to be ready
+            this.log('Waiting for CouchDB to be ready...');
+            await this.waitForReady();
+            // Configure CORS for browser access
+            await this.configureCORS();
+            this.emit('ready');
+        }
+        catch (error) {
+            this.error(`Failed to start CouchDB: ${error instanceof Error ? error.message : String(error)}`);
+            this.emit('error', error);
+            throw error;
+        }
+        finally {
+            this.isStarting = false;
+        }
+    }
+    /**
+     * Stop CouchDB container
+     */
+    async stop() {
+        try {
+            if (await this.isContainerRunning()) {
+                this.log('Stopping CouchDB container...');
+                (0, child_process_1.execSync)(`docker stop ${this.config.containerName}`, { stdio: 'pipe' });
+                this.log('CouchDB stopped');
+                this.emit('stopped');
+            }
+            else {
+                this.log('CouchDB container is not running');
+            }
+        }
+        catch (error) {
+            this.error(`Failed to stop CouchDB: ${error instanceof Error ? error.message : String(error)}`);
+            throw error;
+        }
+    }
+    /**
+     * Remove CouchDB container and volumes
+     */
+    async remove() {
+        try {
+            await this.stop();
+            if (await this.containerExists()) {
+                this.log('Removing CouchDB container...');
+                (0, child_process_1.execSync)(`docker rm ${this.config.containerName}`, { stdio: 'pipe' });
+                this.log('CouchDB container removed');
+                this.emit('removed');
+            }
+        }
+        catch (error) {
+            this.error(`Failed to remove CouchDB: ${error instanceof Error ? error.message : String(error)}`);
+            throw error;
+        }
+    }
+    /**
+     * Get container status
+     */
+    async getStatus() {
+        if (!(await this.containerExists())) {
+            return 'missing';
+        }
+        if (await this.isContainerRunning()) {
+            return 'running';
+        }
+        return 'stopped';
+    }
+    /**
+     * Get connection URL for this CouchDB instance
+     */
+    getConnectionUrl() {
+        return `http://localhost:${this.config.port}`;
+    }
+    /**
+     * Get connection details for applications
+     */
+    getConnectionDetails() {
+        return {
+            protocol: 'http',
+            host: 'localhost',
+            port: this.config.port,
+            username: this.config.username,
+            password: this.config.password,
+            url: this.getConnectionUrl(),
+        };
+    }
+    /**
+     * Configure CORS settings for browser access
+     */
+    async configureCORS() {
+        try {
+            this.log('Configuring CORS for browser access...');
+            const baseUrl = `http://localhost:${this.config.port}`;
+            const auth = `${this.config.username}:${this.config.password}`;
+            // Enable CORS with comprehensive PouchDB-compatible headers
+            // Note: CouchDB requires BOTH chttpd/enable_cors AND cors section settings
+            const corsCommands = [
+                // First: Enable CORS globally in chttpd section (CRITICAL!)
+                `curl -X PUT "${baseUrl}/_node/_local/_config/chttpd/enable_cors" -d '"true"' -H "Content-Type: application/json" -u "${auth}"`,
+                // Then: Configure CORS settings in cors section
+                `curl -X PUT "${baseUrl}/_node/_local/_config/cors/enable" -d '"true"' -H "Content-Type: application/json" -u "${auth}"`,
+                `curl -X PUT "${baseUrl}/_node/_local/_config/cors/origins" -d '"*"' -H "Content-Type: application/json" -u "${auth}"`,
+                `curl -X PUT "${baseUrl}/_node/_local/_config/cors/methods" -d '"GET,POST,PUT,DELETE,OPTIONS,HEAD"' -H "Content-Type: application/json" -u "${auth}"`,
+                `curl -X PUT "${baseUrl}/_node/_local/_config/cors/headers" -d '"accept,authorization,content-type,origin,referer,x-csrf-token,cache-control,if-none-match,x-requested-with,pragma,expires,x-couch-request-id,x-couch-update-newrev"' -H "Content-Type: application/json" -u "${auth}"`,
+                `curl -X PUT "${baseUrl}/_node/_local/_config/cors/credentials" -d '"true"' -H "Content-Type: application/json" -u "${auth}"`,
+            ];
+            for (const cmd of corsCommands) {
+                try {
+                    const result = (0, child_process_1.execSync)(cmd, { stdio: 'pipe' }).toString();
+                    this.log(`CORS command success: ${result.trim()}`);
+                }
+                catch (error) {
+                    this.error(`CORS command failed: ${cmd} - ${error instanceof Error ? error.message : String(error)}`);
+                    throw error;
+                }
+            }
+            // Verify CORS configuration took effect
+            try {
+                this.log('Verifying CORS configuration...');
+                const verifyCmd = `curl -s "${baseUrl}/_node/_local/_config/cors" -u "${auth}"`;
+                const corsSettings = (0, child_process_1.execSync)(verifyCmd, { stdio: 'pipe' }).toString();
+                this.log(`CORS verification result: ${corsSettings.trim()}`);
+            }
+            catch (error) {
+                this.log(`Warning: CORS verification failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            this.log('CORS configuration completed');
+        }
+        catch (error) {
+            this.log(`Warning: CORS configuration failed: ${error instanceof Error ? error.message : String(error)}`);
+            // Don't throw - CORS failure shouldn't prevent container startup
+        }
+    }
+}
+exports.CouchDBManager = CouchDBManager;
+//# sourceMappingURL=CouchDBManager.js.map

package/dist/docker/CouchDBManager.js.map

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

package/dist/docker/CouchDBManager.mjs

@@ -0,0 +1,303 @@
+import { execSync } from 'child_process';
+import { EventEmitter } from 'events';
+export class CouchDBManager extends EventEmitter {
+    config;
+    options;
+    isStarting = false;
+    constructor(config, options = {}) {
+        super();
+        // Set defaults
+        this.config = {
+            mode: config.mode,
+            port: config.port,
+            containerName: config.containerName || `skuilder-couch-${config.port}`,
+            image: config.image || 'couchdb:3.4.3',
+            username: config.username || 'admin',
+            password: config.password || 'password',
+            dataVolume: config.dataVolume || '',
+            configFile: config.configFile || '',
+            maxStartupWaitMs: config.maxStartupWaitMs || 30000,
+        };
+        this.options = {
+            onLog: options.onLog || (() => { }),
+            onError: options.onError || (() => { }),
+        };
+    }
+    log(message) {
+        this.options.onLog(message);
+    }
+    error(message) {
+        this.options.onError(message);
+    }
+    /**
+     * Check if Docker is available
+     */
+    async checkDockerAvailable() {
+        try {
+            execSync('docker --version', { stdio: 'pipe' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if container exists
+     */
+    async containerExists() {
+        try {
+            const result = execSync(`docker ps -a -q -f name=^${this.config.containerName}$`, { stdio: 'pipe' }).toString().trim();
+            return result.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if container is running
+     */
+    async isContainerRunning() {
+        try {
+            const result = execSync(`docker ps -q -f name=^${this.config.containerName}$`, { stdio: 'pipe' }).toString().trim();
+            return result.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Stop and remove existing container
+     */
+    async cleanupExistingContainer() {
+        if (await this.containerExists()) {
+            this.log(`Found existing container '${this.config.containerName}'. Cleaning up...`);
+            try {
+                if (await this.isContainerRunning()) {
+                    this.log('Stopping container...');
+                    execSync(`docker stop ${this.config.containerName}`, { stdio: 'pipe' });
+                    this.log('Container stopped.');
+                }
+                this.log('Removing container...');
+                execSync(`docker rm ${this.config.containerName}`, { stdio: 'pipe' });
+                this.log('Container removed.');
+            }
+            catch (error) {
+                this.error(`Error during cleanup: ${error instanceof Error ? error.message : String(error)}`);
+                throw error;
+            }
+        }
+    }
+    /**
+     * Build Docker run command based on configuration
+     */
+    buildDockerCommand() {
+        const cmd = [
+            'run', '-d',
+            '--name', this.config.containerName,
+            '-p', `${this.config.port}:5984`,
+            '-e', `COUCHDB_USER=${this.config.username}`,
+            '-e', `COUCHDB_PASSWORD=${this.config.password}`,
+        ];
+        // Add volume mounts based on mode
+        switch (this.config.mode) {
+            case 'test-data':
+                if (this.config.dataVolume) {
+                    cmd.push('-v', `${this.config.dataVolume}:/opt/couchdb/data`);
+                }
+                if (this.config.configFile) {
+                    cmd.push('-v', `${this.config.configFile}:/opt/couchdb/etc/local.ini`);
+                }
+                break;
+            case 'custom':
+                if (this.config.dataVolume) {
+                    cmd.push('-v', `${this.config.dataVolume}:/opt/couchdb/data`);
+                }
+                if (this.config.configFile) {
+                    cmd.push('-v', `${this.config.configFile}:/opt/couchdb/etc/local.ini`);
+                }
+                break;
+            case 'blank':
+                // No volume mounts for blank mode - clean slate
+                break;
+        }
+        cmd.push(this.config.image);
+        return cmd;
+    }
+    /**
+     * Wait for CouchDB to be ready
+     */
+    async waitForReady() {
+        const maxAttempts = Math.floor(this.config.maxStartupWaitMs / 1000);
+        let attempts = 0;
+        return new Promise((resolve, reject) => {
+            const checkInterval = setInterval(() => {
+                attempts++;
+                try {
+                    execSync(`curl -s http://localhost:${this.config.port}/`, { stdio: 'pipe' });
+                    clearInterval(checkInterval);
+                    this.log('CouchDB is ready!');
+                    resolve();
+                }
+                catch {
+                    if (attempts >= maxAttempts) {
+                        clearInterval(checkInterval);
+                        reject(new Error('CouchDB failed to start within timeout period'));
+                    }
+                }
+            }, 1000);
+        });
+    }
+    /**
+     * Start CouchDB container
+     */
+    async start() {
+        if (this.isStarting) {
+            throw new Error('CouchDB is already starting');
+        }
+        this.isStarting = true;
+        try {
+            // Check Docker availability
+            if (!(await this.checkDockerAvailable())) {
+                throw new Error('Docker is not available or not running');
+            }
+            // Clean up any existing container
+            await this.cleanupExistingContainer();
+            // Build and execute Docker command
+            const dockerCmd = this.buildDockerCommand();
+            this.log(`Starting CouchDB container: docker ${dockerCmd.join(' ')}`);
+            execSync(`docker ${dockerCmd.join(' ')}`, { stdio: 'pipe' });
+            this.log('Container started successfully');
+            // Wait for CouchDB to be ready
+            this.log('Waiting for CouchDB to be ready...');
+            await this.waitForReady();
+            // Configure CORS for browser access
+            await this.configureCORS();
+            this.emit('ready');
+        }
+        catch (error) {
+            this.error(`Failed to start CouchDB: ${error instanceof Error ? error.message : String(error)}`);
+            this.emit('error', error);
+            throw error;
+        }
+        finally {
+            this.isStarting = false;
+        }
+    }
+    /**
+     * Stop CouchDB container
+     */
+    async stop() {
+        try {
+            if (await this.isContainerRunning()) {
+                this.log('Stopping CouchDB container...');
+                execSync(`docker stop ${this.config.containerName}`, { stdio: 'pipe' });
+                this.log('CouchDB stopped');
+                this.emit('stopped');
+            }
+            else {
+                this.log('CouchDB container is not running');
+            }
+        }
+        catch (error) {
+            this.error(`Failed to stop CouchDB: ${error instanceof Error ? error.message : String(error)}`);
+            throw error;
+        }
+    }
+    /**
+     * Remove CouchDB container and volumes
+     */
+    async remove() {
+        try {
+            await this.stop();
+            if (await this.containerExists()) {
+                this.log('Removing CouchDB container...');
+                execSync(`docker rm ${this.config.containerName}`, { stdio: 'pipe' });
+                this.log('CouchDB container removed');
+                this.emit('removed');
+            }
+        }
+        catch (error) {
+            this.error(`Failed to remove CouchDB: ${error instanceof Error ? error.message : String(error)}`);
+            throw error;
+        }
+    }
+    /**
+     * Get container status
+     */
+    async getStatus() {
+        if (!(await this.containerExists())) {
+            return 'missing';
+        }
+        if (await this.isContainerRunning()) {
+            return 'running';
+        }
+        return 'stopped';
+    }
+    /**
+     * Get connection URL for this CouchDB instance
+     */
+    getConnectionUrl() {
+        return `http://localhost:${this.config.port}`;
+    }
+    /**
+     * Get connection details for applications
+     */
+    getConnectionDetails() {
+        return {
+            protocol: 'http',
+            host: 'localhost',
+            port: this.config.port,
+            username: this.config.username,
+            password: this.config.password,
+            url: this.getConnectionUrl(),
+        };
+    }
+    /**
+     * Configure CORS settings for browser access
+     */
+    async configureCORS() {
+        try {
+            this.log('Configuring CORS for browser access...');
+            const baseUrl = `http://localhost:${this.config.port}`;
+            const auth = `${this.config.username}:${this.config.password}`;
+            // Enable CORS with comprehensive PouchDB-compatible headers
+            // Note: CouchDB requires BOTH chttpd/enable_cors AND cors section settings
+            const corsCommands = [
+                // First: Enable CORS globally in chttpd section (CRITICAL!)
+                `curl -X PUT "${baseUrl}/_node/_local/_config/chttpd/enable_cors" -d '"true"' -H "Content-Type: application/json" -u "${auth}"`,
+                // Then: Configure CORS settings in cors section
+                `curl -X PUT "${baseUrl}/_node/_local/_config/cors/enable" -d '"true"' -H "Content-Type: application/json" -u "${auth}"`,
+                `curl -X PUT "${baseUrl}/_node/_local/_config/cors/origins" -d '"*"' -H "Content-Type: application/json" -u "${auth}"`,
+                `curl -X PUT "${baseUrl}/_node/_local/_config/cors/methods" -d '"GET,POST,PUT,DELETE,OPTIONS,HEAD"' -H "Content-Type: application/json" -u "${auth}"`,
+                `curl -X PUT "${baseUrl}/_node/_local/_config/cors/headers" -d '"accept,authorization,content-type,origin,referer,x-csrf-token,cache-control,if-none-match,x-requested-with,pragma,expires,x-couch-request-id,x-couch-update-newrev"' -H "Content-Type: application/json" -u "${auth}"`,
+                `curl -X PUT "${baseUrl}/_node/_local/_config/cors/credentials" -d '"true"' -H "Content-Type: application/json" -u "${auth}"`,
+            ];
+            for (const cmd of corsCommands) {
+                try {
+                    const result = execSync(cmd, { stdio: 'pipe' }).toString();
+                    this.log(`CORS command success: ${result.trim()}`);
+                }
+                catch (error) {
+                    this.error(`CORS command failed: ${cmd} - ${error instanceof Error ? error.message : String(error)}`);
+                    throw error;
+                }
+            }
+            // Verify CORS configuration took effect
+            try {
+                this.log('Verifying CORS configuration...');
+                const verifyCmd = `curl -s "${baseUrl}/_node/_local/_config/cors" -u "${auth}"`;
+                const corsSettings = execSync(verifyCmd, { stdio: 'pipe' }).toString();
+                this.log(`CORS verification result: ${corsSettings.trim()}`);
+            }
+            catch (error) {
+                this.log(`Warning: CORS verification failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            this.log('CORS configuration completed');
+        }
+        catch (error) {
+            this.log(`Warning: CORS configuration failed: ${error instanceof Error ? error.message : String(error)}`);
+            // Don't throw - CORS failure shouldn't prevent container startup
+        }
+    }
+}
+//# sourceMappingURL=CouchDBManager.js.map

package/dist/docker/index.d.ts

@@ -0,0 +1,3 @@
+export { CouchDBManager } from './CouchDBManager.js';
+export type { CouchDBConfig, CouchDBManagerOptions } from './CouchDBManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/docker/index.d.ts.map

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

package/dist/docker/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CouchDBManager = void 0;
+var CouchDBManager_js_1 = require("./CouchDBManager.js");
+Object.defineProperty(exports, "CouchDBManager", { enumerable: true, get: function () { return CouchDBManager_js_1.CouchDBManager; } });
+//# sourceMappingURL=index.js.map

package/dist/docker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/docker/index.mjs

@@ -0,0 +1,2 @@
+export { CouchDBManager } from './CouchDBManager.mjs';
+//# sourceMappingURL=index.js.map

package/dist/index.js

@@ -28,4 +28,6 @@ __exportStar(require("./bulkImport/types.js"), exports);
 __exportStar(require("./interfaces/index.js"), exports);
 // enums
 __exportStar(require("./enums/index.js"), exports);
+// docker utilities (Node.js only - not exported in main index for browser compatibility)
+// Use explicit import: import { CouchDBManager } from '@vue-skuilder/common/docker'
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAExB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AAEtC,aAAa;AACb,cAAc,uBAAuB,CAAC;AAEtC,QAAQ;AACR,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAExB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AAEtC,aAAa;AACb,cAAc,uBAAuB,CAAC;AAEtC,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,yFAAyF;AACzF,oFAAoF"}

package/dist/index.mjs

@@ -12,4 +12,6 @@ export * from './bulkImport/types.mjs';
 export * from './interfaces/index.mjs';
 // enums
 export * from './enums/index.mjs';
+// docker utilities (Node.js only - not exported in main index for browser compatibility)
+// Use explicit import: import { CouchDBManager } from '@vue-skuilder/common/docker'
 //# sourceMappingURL=index.js.map

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.6",
+  "version": "0.1.7",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -13,6 +13,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
+    },
+    "./docker": {
+      "types": "./dist/docker/index.d.ts",
+      "import": "./dist/docker/index.mjs",
+      "require": "./dist/docker/index.js"
     }
   },
   "scripts": {

package/src/docker/CouchDBManager.ts

@@ -0,0 +1,352 @@
+import { execSync } from 'child_process';
+import { EventEmitter } from 'events';
+
+export interface CouchDBConfig {
+  mode: 'blank' | 'test-data' | 'custom';
+  port: number;
+  containerName?: string;
+  image?: string;
+  username?: string;
+  password?: string;
+  dataVolume?: string;
+  configFile?: string;
+  maxStartupWaitMs?: number;
+}
+
+export interface CouchDBManagerOptions {
+  onLog?: (message: string) => void;
+  onError?: (error: string) => void;
+}
+
+export class CouchDBManager extends EventEmitter {
+  private config: Required<CouchDBConfig>;
+  private options: CouchDBManagerOptions;
+  private isStarting = false;
+
+  constructor(config: CouchDBConfig, options: CouchDBManagerOptions = {}) {
+    super();
+    
+    // Set defaults
+    this.config = {
+      mode: config.mode,
+      port: config.port,
+      containerName: config.containerName || `skuilder-couch-${config.port}`,
+      image: config.image || 'couchdb:3.4.3',
+      username: config.username || 'admin',
+      password: config.password || 'password',
+      dataVolume: config.dataVolume || '',
+      configFile: config.configFile || '',
+      maxStartupWaitMs: config.maxStartupWaitMs || 30000,
+    };
+
+    this.options = {
+      onLog: options.onLog || (() => {}),
+      onError: options.onError || (() => {}),
+    };
+  }
+
+  private log(message: string): void {
+    this.options.onLog!(message);
+  }
+
+  private error(message: string): void {
+    this.options.onError!(message);
+  }
+
+  /**
+   * Check if Docker is available
+   */
+  async checkDockerAvailable(): Promise<boolean> {
+    try {
+      execSync('docker --version', { stdio: 'pipe' });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Check if container exists
+   */
+  private async containerExists(): Promise<boolean> {
+    try {
+      const result = execSync(
+        `docker ps -a -q -f name=^${this.config.containerName}$`,
+        { stdio: 'pipe' }
+      ).toString().trim();
+      return result.length > 0;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Check if container is running
+   */
+  private async isContainerRunning(): Promise<boolean> {
+    try {
+      const result = execSync(
+        `docker ps -q -f name=^${this.config.containerName}$`,
+        { stdio: 'pipe' }
+      ).toString().trim();
+      return result.length > 0;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Stop and remove existing container
+   */
+  private async cleanupExistingContainer(): Promise<void> {
+    if (await this.containerExists()) {
+      this.log(`Found existing container '${this.config.containerName}'. Cleaning up...`);
+      
+      try {
+        if (await this.isContainerRunning()) {
+          this.log('Stopping container...');
+          execSync(`docker stop ${this.config.containerName}`, { stdio: 'pipe' });
+          this.log('Container stopped.');
+        }
+        
+        this.log('Removing container...');
+        execSync(`docker rm ${this.config.containerName}`, { stdio: 'pipe' });
+        this.log('Container removed.');
+      } catch (error: unknown) {
+        this.error(`Error during cleanup: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+      }
+    }
+  }
+
+  /**
+   * Build Docker run command based on configuration
+   */
+  private buildDockerCommand(): string[] {
+    const cmd = [
+      'run', '-d',
+      '--name', this.config.containerName,
+      '-p', `${this.config.port}:5984`,
+      '-e', `COUCHDB_USER=${this.config.username}`,
+      '-e', `COUCHDB_PASSWORD=${this.config.password}`,
+    ];
+
+    // Add volume mounts based on mode
+    switch (this.config.mode) {
+      case 'test-data':
+        if (this.config.dataVolume) {
+          cmd.push('-v', `${this.config.dataVolume}:/opt/couchdb/data`);
+        }
+        if (this.config.configFile) {
+          cmd.push('-v', `${this.config.configFile}:/opt/couchdb/etc/local.ini`);
+        }
+        break;
+      case 'custom':
+        if (this.config.dataVolume) {
+          cmd.push('-v', `${this.config.dataVolume}:/opt/couchdb/data`);
+        }
+        if (this.config.configFile) {
+          cmd.push('-v', `${this.config.configFile}:/opt/couchdb/etc/local.ini`);
+        }
+        break;
+      case 'blank':
+        // No volume mounts for blank mode - clean slate
+        break;
+    }
+
+    cmd.push(this.config.image);
+    return cmd;
+  }
+
+  /**
+   * Wait for CouchDB to be ready
+   */
+  private async waitForReady(): Promise<void> {
+    const maxAttempts = Math.floor(this.config.maxStartupWaitMs / 1000);
+    let attempts = 0;
+
+    return new Promise((resolve, reject) => {
+      const checkInterval = setInterval(() => {
+        attempts++;
+        try {
+          execSync(`curl -s http://localhost:${this.config.port}/`, { stdio: 'pipe' });
+          clearInterval(checkInterval);
+          this.log('CouchDB is ready!');
+          resolve();
+        } catch {
+          if (attempts >= maxAttempts) {
+            clearInterval(checkInterval);
+            reject(new Error('CouchDB failed to start within timeout period'));
+          }
+        }
+      }, 1000);
+    });
+  }
+
+  /**
+   * Start CouchDB container
+   */
+  async start(): Promise<void> {
+    if (this.isStarting) {
+      throw new Error('CouchDB is already starting');
+    }
+
+    this.isStarting = true;
+
+    try {
+      // Check Docker availability
+      if (!(await this.checkDockerAvailable())) {
+        throw new Error('Docker is not available or not running');
+      }
+
+      // Clean up any existing container
+      await this.cleanupExistingContainer();
+
+      // Build and execute Docker command
+      const dockerCmd = this.buildDockerCommand();
+      this.log(`Starting CouchDB container: docker ${dockerCmd.join(' ')}`);
+      
+      execSync(`docker ${dockerCmd.join(' ')}`, { stdio: 'pipe' });
+      this.log('Container started successfully');
+
+      // Wait for CouchDB to be ready
+      this.log('Waiting for CouchDB to be ready...');
+      await this.waitForReady();
+
+      // Configure CORS for browser access
+      await this.configureCORS();
+
+      this.emit('ready');
+    } catch (error: unknown) {
+      this.error(`Failed to start CouchDB: ${error instanceof Error ? error.message : String(error)}`);
+      this.emit('error', error);
+      throw error;
+    } finally {
+      this.isStarting = false;
+    }
+  }
+
+  /**
+   * Stop CouchDB container
+   */
+  async stop(): Promise<void> {
+    try {
+      if (await this.isContainerRunning()) {
+        this.log('Stopping CouchDB container...');
+        execSync(`docker stop ${this.config.containerName}`, { stdio: 'pipe' });
+        this.log('CouchDB stopped');
+        this.emit('stopped');
+      } else {
+        this.log('CouchDB container is not running');
+      }
+    } catch (error: unknown) {
+      this.error(`Failed to stop CouchDB: ${error instanceof Error ? error.message : String(error)}`);
+      throw error;
+    }
+  }
+
+  /**
+   * Remove CouchDB container and volumes
+   */
+  async remove(): Promise<void> {
+    try {
+      await this.stop();
+      
+      if (await this.containerExists()) {
+        this.log('Removing CouchDB container...');
+        execSync(`docker rm ${this.config.containerName}`, { stdio: 'pipe' });
+        this.log('CouchDB container removed');
+        this.emit('removed');
+      }
+    } catch (error: unknown) {
+      this.error(`Failed to remove CouchDB: ${error instanceof Error ? error.message : String(error)}`);
+      throw error;
+    }
+  }
+
+  /**
+   * Get container status
+   */
+  async getStatus(): Promise<'running' | 'stopped' | 'missing'> {
+    if (!(await this.containerExists())) {
+      return 'missing';
+    }
+    
+    if (await this.isContainerRunning()) {
+      return 'running';
+    }
+    
+    return 'stopped';
+  }
+
+  /**
+   * Get connection URL for this CouchDB instance
+   */
+  getConnectionUrl(): string {
+    return `http://localhost:${this.config.port}`;
+  }
+
+  /**
+   * Get connection details for applications
+   */
+  getConnectionDetails() {
+    return {
+      protocol: 'http',
+      host: 'localhost',
+      port: this.config.port,
+      username: this.config.username,
+      password: this.config.password,
+      url: this.getConnectionUrl(),
+    };
+  }
+
+  /**
+   * Configure CORS settings for browser access
+   */
+  private async configureCORS(): Promise<void> {
+    try {
+      this.log('Configuring CORS for browser access...');
+      
+      const baseUrl = `http://localhost:${this.config.port}`;
+      const auth = `${this.config.username}:${this.config.password}`;
+      
+      // Enable CORS with comprehensive PouchDB-compatible headers
+      // Note: CouchDB requires BOTH chttpd/enable_cors AND cors section settings
+      const corsCommands = [
+        // First: Enable CORS globally in chttpd section (CRITICAL!)
+        `curl -X PUT "${baseUrl}/_node/_local/_config/chttpd/enable_cors" -d '"true"' -H "Content-Type: application/json" -u "${auth}"`,
+        // Then: Configure CORS settings in cors section
+        `curl -X PUT "${baseUrl}/_node/_local/_config/cors/enable" -d '"true"' -H "Content-Type: application/json" -u "${auth}"`,
+        `curl -X PUT "${baseUrl}/_node/_local/_config/cors/origins" -d '"*"' -H "Content-Type: application/json" -u "${auth}"`,
+        `curl -X PUT "${baseUrl}/_node/_local/_config/cors/methods" -d '"GET,POST,PUT,DELETE,OPTIONS,HEAD"' -H "Content-Type: application/json" -u "${auth}"`,
+        `curl -X PUT "${baseUrl}/_node/_local/_config/cors/headers" -d '"accept,authorization,content-type,origin,referer,x-csrf-token,cache-control,if-none-match,x-requested-with,pragma,expires,x-couch-request-id,x-couch-update-newrev"' -H "Content-Type: application/json" -u "${auth}"`,
+        `curl -X PUT "${baseUrl}/_node/_local/_config/cors/credentials" -d '"true"' -H "Content-Type: application/json" -u "${auth}"`,
+      ];
+
+      for (const cmd of corsCommands) {
+        try {
+          const result = execSync(cmd, { stdio: 'pipe' }).toString();
+          this.log(`CORS command success: ${result.trim()}`);
+        } catch (error: unknown) {
+          this.error(`CORS command failed: ${cmd} - ${error instanceof Error ? error.message : String(error)}`);
+          throw error;
+        }
+      }
+      
+      // Verify CORS configuration took effect
+      try {
+        this.log('Verifying CORS configuration...');
+        const verifyCmd = `curl -s "${baseUrl}/_node/_local/_config/cors" -u "${auth}"`;
+        const corsSettings = execSync(verifyCmd, { stdio: 'pipe' }).toString();
+        this.log(`CORS verification result: ${corsSettings.trim()}`);
+      } catch (error: unknown) {
+        this.log(`Warning: CORS verification failed: ${error instanceof Error ? error.message : String(error)}`);
+      }
+      
+      this.log('CORS configuration completed');
+    } catch (error: unknown) {
+      this.log(`Warning: CORS configuration failed: ${error instanceof Error ? error.message : String(error)}`);
+      // Don't throw - CORS failure shouldn't prevent container startup
+    }
+  }
+}

package/src/docker/index.ts

@@ -0,0 +1,2 @@
+export { CouchDBManager } from './CouchDBManager.js';
+export type { CouchDBConfig, CouchDBManagerOptions } from './CouchDBManager.js';

package/src/index.ts

@@ -15,3 +15,6 @@ export * from './interfaces/index.js';
 
 // enums
 export * from './enums/index.js';
+
+// docker utilities (Node.js only - not exported in main index for browser compatibility)
+// Use explicit import: import { CouchDBManager } from '@vue-skuilder/common/docker'