envhub-cli 0.1.1

package/dist/utils/diff.js

@@ -0,0 +1,105 @@
+import chalk from "chalk";
+import { parseEnvContent } from "./env-parser.js";
+/**
+ * Compare two .env contents and return the differences.
+ *
+ * @param localContent - The current local .env content
+ * @param remoteContent - The remote/new .env content
+ * @returns Array of changes detected
+ */
+export function diffEnvContents(localContent, remoteContent) {
+    const local = parseEnvContent(localContent);
+    const remote = parseEnvContent(remoteContent);
+    const changes = [];
+    // Check for added and changed keys
+    for (const [key, remoteValue] of remote) {
+        const localValue = local.get(key);
+        if (localValue === undefined) {
+            changes.push({
+                key,
+                type: "added",
+                newValue: remoteValue,
+            });
+        }
+        else if (localValue !== remoteValue) {
+            changes.push({
+                key,
+                type: "changed",
+                oldValue: localValue,
+                newValue: remoteValue,
+            });
+        }
+    }
+    // Check for removed keys
+    for (const [key, localValue] of local) {
+        if (!remote.has(key)) {
+            changes.push({
+                key,
+                type: "removed",
+                oldValue: localValue,
+            });
+        }
+    }
+    return changes;
+}
+/**
+ * Format changes into a human-readable string for terminal display.
+ */
+export function formatChanges(changes) {
+    if (changes.length === 0) {
+        return "No changes detected.";
+    }
+    const lines = [];
+    const added = changes.filter((c) => c.type === "added");
+    const removed = changes.filter((c) => c.type === "removed");
+    const changed = changes.filter((c) => c.type === "changed");
+    if (added.length > 0) {
+        lines.push(`  🟢 Added (${added.length}):`);
+        for (const c of added) {
+            lines.push(chalk.green(`     + ${c.key}=${maskValue(c.newValue ?? "")}`));
+        }
+    }
+    if (removed.length > 0) {
+        lines.push(`  🔴 Removed (${removed.length}):`);
+        for (const c of removed) {
+            lines.push(chalk.red(`     - ${c.key}`));
+        }
+    }
+    if (changed.length > 0) {
+        lines.push(`  🟡 Changed (${changed.length}):`);
+        for (const c of changed) {
+            lines.push(chalk.yellow(`     ~ ${c.key}`));
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format changes into a compact one-line summary.
+ * Example: "3 added, 1 removed, 12 changed"
+ */
+export function summarizeChanges(changes) {
+    if (changes.length === 0) {
+        return "no changes";
+    }
+    const added = changes.filter((c) => c.type === "added").length;
+    const removed = changes.filter((c) => c.type === "removed").length;
+    const changed = changes.filter((c) => c.type === "changed").length;
+    const parts = [];
+    if (added > 0)
+        parts.push(`${added} added`);
+    if (removed > 0)
+        parts.push(`${removed} removed`);
+    if (changed > 0)
+        parts.push(`${changed} changed`);
+    return parts.join(", ");
+}
+/**
+ * Mask a value for safe display (show first 3 chars, mask the rest).
+ */
+function maskValue(value) {
+    if (value.length <= 3) {
+        return "***";
+    }
+    return value.substring(0, 3) + "***";
+}
+//# sourceMappingURL=diff.js.map

package/dist/utils/diff.js.map

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

package/dist/utils/env-parser.d.ts

@@ -0,0 +1,48 @@
+/**
+ * A single key-value pair from an .env file.
+ */
+export interface EnvEntry {
+    key: string;
+    value: string;
+    /** Original line (preserving comments, quotes, etc.) */
+    raw: string;
+}
+/**
+ * Parsed representation of an .env file.
+ */
+export interface ParsedEnv {
+    /** Key-value entries */
+    entries: EnvEntry[];
+    /** Lines that are comments or blank (preserved for round-tripping) */
+    lines: string[];
+}
+/**
+ * Parse .env file content into structured entries.
+ * Handles comments, blank lines, quoted values, and multi-line values.
+ */
+export declare function parseEnvContent(content: string): Map<string, string>;
+/**
+ * Serialize a Map of key-value pairs back to .env format.
+ */
+export declare function serializeEnv(entries: Map<string, string>): string;
+/**
+ * Read and parse an .env file from disk.
+ */
+export declare function readEnvFile(filePath: string): Promise<Map<string, string>>;
+/**
+ * Read the raw content of an .env file.
+ */
+export declare function readEnvFileRaw(filePath: string): Promise<string>;
+/**
+ * Write an .env file to disk.
+ */
+export declare function writeEnvFile(filePath: string, entries: Map<string, string>): Promise<void>;
+/**
+ * Write raw content to an .env file.
+ */
+export declare function writeEnvFileRaw(filePath: string, content: string): Promise<void>;
+/**
+ * Check if a file exists.
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+//# sourceMappingURL=env-parser.d.ts.map

package/dist/utils/env-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-parser.d.ts","sourceRoot":"","sources":["../../src/utils/env-parser.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,sEAAsE;IACtE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAoCpE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAWjE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAGhF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE"}

package/dist/utils/env-parser.js

@@ -0,0 +1,84 @@
+import * as fs from "node:fs/promises";
+/**
+ * Parse .env file content into structured entries.
+ * Handles comments, blank lines, quoted values, and multi-line values.
+ */
+export function parseEnvContent(content) {
+    const result = new Map();
+    const lines = content.split("\n");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip empty lines and comments
+        if (!trimmed || trimmed.startsWith("#")) {
+            continue;
+        }
+        // Find the first = sign
+        const eqIndex = trimmed.indexOf("=");
+        if (eqIndex === -1) {
+            continue;
+        }
+        const key = trimmed.substring(0, eqIndex).trim();
+        let value = trimmed.substring(eqIndex + 1).trim();
+        // Remove surrounding quotes if present
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        if (key) {
+            result.set(key, value);
+        }
+    }
+    return result;
+}
+/**
+ * Serialize a Map of key-value pairs back to .env format.
+ */
+export function serializeEnv(entries) {
+    const lines = [];
+    for (const [key, value] of entries) {
+        // Quote values that contain spaces, #, or special characters
+        const needsQuoting = /[\s#"'\\]/.test(value) || value === "";
+        const formattedValue = needsQuoting ? `"${value}"` : value;
+        lines.push(`${key}=${formattedValue}`);
+    }
+    return lines.join("\n") + "\n";
+}
+/**
+ * Read and parse an .env file from disk.
+ */
+export async function readEnvFile(filePath) {
+    const content = await fs.readFile(filePath, "utf-8");
+    return parseEnvContent(content);
+}
+/**
+ * Read the raw content of an .env file.
+ */
+export async function readEnvFileRaw(filePath) {
+    return fs.readFile(filePath, "utf-8");
+}
+/**
+ * Write an .env file to disk.
+ */
+export async function writeEnvFile(filePath, entries) {
+    const content = serializeEnv(entries);
+    await fs.writeFile(filePath, content, "utf-8");
+}
+/**
+ * Write raw content to an .env file.
+ */
+export async function writeEnvFileRaw(filePath, content) {
+    await fs.writeFile(filePath, content, "utf-8");
+}
+/**
+ * Check if a file exists.
+ */
+export async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=env-parser.js.map

package/dist/utils/env-parser.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,57 @@
+import { type Ora } from "ora";
+/**
+ * Centralized logger for consistent CLI output formatting.
+ */
+export declare const logger: {
+    /**
+     * Print a success message with a green checkmark.
+     */
+    success(message: string): void;
+    /**
+     * Print an error message with a red cross.
+     */
+    error(message: string): void;
+    /**
+     * Print a warning message with a yellow exclamation mark.
+     */
+    warn(message: string): void;
+    /**
+     * Print an informational message.
+     */
+    info(message: string): void;
+    /**
+     * Print a plain message without any prefix.
+     */
+    log(message: string): void;
+    /**
+     * Print a dimmed/subtle message.
+     */
+    dim(message: string): void;
+    /**
+     * Print a key-value pair with formatting.
+     */
+    keyValue(key: string, value: string): void;
+    /**
+     * Print a blank line.
+     */
+    newline(): void;
+    /**
+     * Create and start a spinner for async operations.
+     */
+    spinner(text: string): Ora;
+    /**
+     * Print a table header.
+     */
+    tableHeader(...columns: {
+        label: string;
+        width: number;
+    }[]): void;
+    /**
+     * Print a table row.
+     */
+    tableRow(...cells: {
+        value: string;
+        width: number;
+    }[]): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AACA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;qBACc,MAAM,GAAG,IAAI;IAI9B;;OAEG;mBACY,MAAM,GAAG,IAAI;IAI5B;;OAEG;kBACW,MAAM,GAAG,IAAI;IAI3B;;OAEG;kBACW,MAAM,GAAG,IAAI;IAI3B;;OAEG;iBACU,MAAM,GAAG,IAAI;IAI1B;;OAEG;iBACU,MAAM,GAAG,IAAI;IAI1B;;OAEG;kBACW,MAAM,SAAS,MAAM,GAAG,IAAI;IAI1C;;OAEG;eACQ,IAAI;IAIf;;OAEG;kBACW,MAAM,GAAG,GAAG;IAO1B;;OAEG;4BACqB;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,IAAI;IAQjE;;OAEG;uBACgB;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,IAAI;CAI7D,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,82 @@
+import chalk from "chalk";
+import ora from "ora";
+/**
+ * Centralized logger for consistent CLI output formatting.
+ */
+export const logger = {
+    /**
+     * Print a success message with a green checkmark.
+     */
+    success(message) {
+        console.log(chalk.green("✔") + " " + message);
+    },
+    /**
+     * Print an error message with a red cross.
+     */
+    error(message) {
+        console.error(chalk.red("✖") + " " + chalk.red(message));
+    },
+    /**
+     * Print a warning message with a yellow exclamation mark.
+     */
+    warn(message) {
+        console.warn(chalk.yellow("⚠") + " " + chalk.yellow(message));
+    },
+    /**
+     * Print an informational message.
+     */
+    info(message) {
+        console.log(chalk.blue("ℹ") + " " + message);
+    },
+    /**
+     * Print a plain message without any prefix.
+     */
+    log(message) {
+        console.log(message);
+    },
+    /**
+     * Print a dimmed/subtle message.
+     */
+    dim(message) {
+        console.log(chalk.dim(message));
+    },
+    /**
+     * Print a key-value pair with formatting.
+     */
+    keyValue(key, value) {
+        console.log(`  ${chalk.bold(key)}: ${value}`);
+    },
+    /**
+     * Print a blank line.
+     */
+    newline() {
+        console.log();
+    },
+    /**
+     * Create and start a spinner for async operations.
+     */
+    spinner(text) {
+        return ora({
+            text,
+            color: "cyan",
+        }).start();
+    },
+    /**
+     * Print a table header.
+     */
+    tableHeader(...columns) {
+        const header = columns
+            .map((col) => chalk.bold(col.label.padEnd(col.width)))
+            .join("  ");
+        console.log(header);
+        console.log(chalk.dim("─".repeat(header.length)));
+    },
+    /**
+     * Print a table row.
+     */
+    tableRow(...cells) {
+        const row = cells.map((cell) => cell.value.padEnd(cell.width)).join("  ");
+        console.log(row);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAiB,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB;;OAEG;IACH,OAAO,CAAC,OAAe;QACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAe;QACnB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,OAAe;QACjB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,OAAe;QACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,GAAW,EAAE,KAAa;QACjC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAY;QAClB,OAAO,GAAG,CAAC;YACT,IAAI;YACJ,KAAK,EAAE,MAAM;SACd,CAAC,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,GAAG,OAA2C;QACxD,MAAM,MAAM,GAAG,OAAO;aACnB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;aACrD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,GAAG,KAAyC;QACnD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;CACF,CAAC"}

package/dist/versioning/version-control.d.ts

@@ -0,0 +1,44 @@
+import { ConfigManager } from "../config/config.js";
+import type { SecretProvider } from "../providers/provider.interface.js";
+/**
+ * Result of a version check before a push operation.
+ */
+export interface VersionCheckResult {
+    /** Whether it's safe to push */
+    canPush: boolean;
+    /** The current local version */
+    localVersion: number;
+    /** The current remote version */
+    remoteVersion: number;
+    /** Human-readable reason if push is not safe */
+    reason?: string;
+}
+/**
+ * Manages version tracking and conflict detection for secrets.
+ *
+ * Workflow:
+ * - Before push: check if local version matches remote (conflict detection)
+ * - After push: update local version in .envhubrc.json
+ * - After pull: update local version in .envhubrc.json
+ */
+export declare class VersionControl {
+    private configManager;
+    private provider;
+    constructor(configManager: ConfigManager, provider: SecretProvider);
+    /**
+     * Check if a push is safe by comparing local and remote versions.
+     *
+     * Returns a conflict if the remote version is ahead of the local version,
+     * meaning someone else has pushed a newer version.
+     */
+    checkBeforePush(secretName: string): Promise<VersionCheckResult>;
+    /**
+     * Update the local version tracking after a successful push.
+     */
+    recordPush(secretName: string, newVersion: number, file: string): Promise<void>;
+    /**
+     * Update the local version tracking after a successful pull.
+     */
+    recordPull(secretName: string, version: number, file: string): Promise<void>;
+}
+//# sourceMappingURL=version-control.d.ts.map

package/dist/versioning/version-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-control.d.ts","sourceRoot":"","sources":["../../src/versioning/version-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,QAAQ;gBADR,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,cAAc;IAGlC;;;;;OAKG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA4CtE;;OAEG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrF;;OAEG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOnF"}

package/dist/versioning/version-control.js

@@ -0,0 +1,81 @@
+/**
+ * Manages version tracking and conflict detection for secrets.
+ *
+ * Workflow:
+ * - Before push: check if local version matches remote (conflict detection)
+ * - After push: update local version in .envhubrc.json
+ * - After pull: update local version in .envhubrc.json
+ */
+export class VersionControl {
+    configManager;
+    provider;
+    constructor(configManager, provider) {
+        this.configManager = configManager;
+        this.provider = provider;
+    }
+    /**
+     * Check if a push is safe by comparing local and remote versions.
+     *
+     * Returns a conflict if the remote version is ahead of the local version,
+     * meaning someone else has pushed a newer version.
+     */
+    async checkBeforePush(secretName) {
+        const localVersion = this.configManager.getTrackedVersion(secretName);
+        let remoteVersion;
+        try {
+            remoteVersion = await this.provider.getVersion(secretName);
+        }
+        catch {
+            // Secret doesn't exist yet, safe to push
+            return {
+                canPush: true,
+                localVersion,
+                remoteVersion: 0,
+            };
+        }
+        // If remote version is 0, the secret doesn't exist yet
+        if (remoteVersion === 0) {
+            return {
+                canPush: true,
+                localVersion,
+                remoteVersion: 0,
+            };
+        }
+        // If local version matches remote, safe to push
+        if (localVersion >= remoteVersion) {
+            return {
+                canPush: true,
+                localVersion,
+                remoteVersion,
+            };
+        }
+        // Remote is ahead – conflict detected
+        return {
+            canPush: false,
+            localVersion,
+            remoteVersion,
+            reason: `Remote version (${remoteVersion}) is newer than your local version (${localVersion}). ` +
+                `Run 'envhub pull' first to get the latest changes, or use --force to overwrite.`,
+        };
+    }
+    /**
+     * Update the local version tracking after a successful push.
+     */
+    async recordPush(secretName, newVersion, file) {
+        await this.configManager.updateSecret(secretName, {
+            version: newVersion,
+            file,
+        });
+    }
+    /**
+     * Update the local version tracking after a successful pull.
+     */
+    async recordPull(secretName, version, file) {
+        await this.configManager.updateSecret(secretName, {
+            version,
+            file,
+            lastPulled: new Date().toISOString(),
+        });
+    }
+}
+//# sourceMappingURL=version-control.js.map

package/dist/versioning/version-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-control.js","sourceRoot":"","sources":["../../src/versioning/version-control.ts"],"names":[],"mappings":"AAiBA;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IAEf;IACA;IAFV,YACU,aAA4B,EAC5B,QAAwB;QADxB,kBAAa,GAAb,aAAa,CAAe;QAC5B,aAAQ,GAAR,QAAQ,CAAgB;IAC/B,CAAC;IAEJ;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,UAAkB;QACtC,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACtE,IAAI,aAAqB,CAAC;QAE1B,IAAI,CAAC;YACH,aAAa,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;YACzC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY;gBACZ,aAAa,EAAE,CAAC;aACjB,CAAC;QACJ,CAAC;QAED,uDAAuD;QACvD,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY;gBACZ,aAAa,EAAE,CAAC;aACjB,CAAC;QACJ,CAAC;QAED,gDAAgD;QAChD,IAAI,YAAY,IAAI,aAAa,EAAE,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY;gBACZ,aAAa;aACd,CAAC;QACJ,CAAC;QAED,sCAAsC;QACtC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,YAAY;YACZ,aAAa;YACb,MAAM,EACJ,mBAAmB,aAAa,uCAAuC,YAAY,KAAK;gBACxF,iFAAiF;SACpF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,UAAkB,EAAE,IAAY;QACnE,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,UAAU,EAAE;YAChD,OAAO,EAAE,UAAU;YACnB,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,OAAe,EAAE,IAAY;QAChE,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,UAAU,EAAE;YAChD,OAAO;YACP,IAAI;YACJ,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;CACF"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "envhub-cli",
+  "version": "0.1.1",
+  "description": "Securely share .env files between developers using cloud providers",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "envhub": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "env",
+    "secrets",
+    "dotenv",
+    "aws",
+    "secrets-manager",
+    "cli",
+    "developer-tools"
+  ],
+  "author": {
+    "name": "Kemal Can Yaprak",
+    "email": "kemalcan.yaprak1@gmail.com"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@aws-sdk/client-iam": "^3.0.0",
+    "@aws-sdk/client-secrets-manager": "^3.0.0",
+    "@aws-sdk/credential-providers": "^3.0.0",
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.4.1",
+    "commander": "^13.0.0",
+    "cosmiconfig": "^9.0.0",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "eslint": "^9.21.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.25.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist"
+  ]
+}