@unlimitechcloud/devlink 1.0.2

package/dist/core/lock.js

@@ -0,0 +1,198 @@
+/**
+ * Lock - File locking para serializar operaciones de escritura
+ */
+import fs from "fs/promises";
+import { constants } from "fs";
+import { getStorePath, getLockPath, DEFAULT_LOCK_TIMEOUT, DEFAULT_LOCK_RETRY_INTERVAL, DEFAULT_LOCK_STALE_TIME, } from "../constants.js";
+const DEFAULT_OPTIONS = {
+    timeout: DEFAULT_LOCK_TIMEOUT,
+    retryInterval: DEFAULT_LOCK_RETRY_INTERVAL,
+    stale: DEFAULT_LOCK_STALE_TIME,
+};
+/**
+ * Sleep helper
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Write lock info to file
+ */
+export async function writeLockInfo(lockPath, info) {
+    await fs.writeFile(lockPath, JSON.stringify(info, null, 2));
+}
+/**
+ * Read lock info from file
+ */
+export async function readLockInfo(lockPath) {
+    try {
+        const content = await fs.readFile(lockPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a process is alive
+ */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if lock is stale (process dead or too old)
+ */
+export async function isLockStale(lockPath, staleTime) {
+    try {
+        const info = await readLockInfo(lockPath);
+        if (!info)
+            return true;
+        // Check if process is still alive
+        if (!isProcessAlive(info.pid)) {
+            return true;
+        }
+        // Check if lock is too old
+        const lockAge = Date.now() - new Date(info.acquired).getTime();
+        if (lockAge > staleTime) {
+            return true;
+        }
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Try to acquire lock (non-blocking)
+ */
+async function tryAcquireLock(lockPath) {
+    try {
+        // Try to create file exclusively
+        const handle = await fs.open(lockPath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY);
+        await handle.close();
+        return true;
+    }
+    catch (error) {
+        if (error.code === "EEXIST") {
+            return false;
+        }
+        throw error;
+    }
+}
+/**
+ * Acquire exclusive lock on the store
+ */
+export async function acquireLock(options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const storePath = getStorePath();
+    const lockPath = getLockPath();
+    // Ensure store directory exists
+    await fs.mkdir(storePath, { recursive: true });
+    const startTime = Date.now();
+    let attempt = 0;
+    let shownWaiting = false;
+    while (true) {
+        // Try to acquire lock
+        const acquired = await tryAcquireLock(lockPath);
+        if (acquired) {
+            // Write lock info
+            const info = {
+                pid: process.pid,
+                acquired: new Date().toISOString(),
+                command: process.argv.slice(2).join(" "),
+            };
+            await writeLockInfo(lockPath, info);
+            return {
+                fd: 0, // Not using fd in this implementation
+                release: async () => {
+                    try {
+                        await fs.unlink(lockPath);
+                    }
+                    catch {
+                        // Ignore errors on release
+                    }
+                },
+            };
+        }
+        // Lock is held by someone else
+        const elapsed = Date.now() - startTime;
+        if (elapsed >= opts.timeout) {
+            const info = await readLockInfo(lockPath);
+            throw new Error(`Timeout waiting for store lock after ${opts.timeout}ms.\n` +
+                `Lock held by PID ${info?.pid || "unknown"} (${info?.command || "unknown"})\n` +
+                `Acquired at: ${info?.acquired || "unknown"}\n\n` +
+                `If the process is stuck, you can manually remove:\n` +
+                `  rm ${lockPath}`);
+        }
+        // Check if lock is stale
+        if (await isLockStale(lockPath, opts.stale)) {
+            console.log("⚠️  Removing stale lock file...");
+            try {
+                await fs.unlink(lockPath);
+            }
+            catch {
+                // Ignore, might have been removed by another process
+            }
+            continue;
+        }
+        // Show waiting message (only once)
+        if (!shownWaiting) {
+            const info = await readLockInfo(lockPath);
+            console.log(`⏳ Store locked by PID ${info?.pid || "unknown"}, waiting...`);
+            shownWaiting = true;
+        }
+        attempt++;
+        await sleep(opts.retryInterval);
+    }
+}
+/**
+ * Execute operation with exclusive lock
+ */
+export async function withStoreLock(operation, options) {
+    const lock = await acquireLock(options);
+    try {
+        return await operation();
+    }
+    finally {
+        await lock.release();
+    }
+}
+/**
+ * Check if store is currently locked
+ */
+export async function isStoreLocked() {
+    const lockPath = getLockPath();
+    try {
+        await fs.access(lockPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get current lock info (if locked)
+ */
+export async function getCurrentLockInfo() {
+    const lockPath = getLockPath();
+    return readLockInfo(lockPath);
+}
+/**
+ * Force remove lock (use with caution)
+ */
+export async function forceRemoveLock() {
+    const lockPath = getLockPath();
+    try {
+        await fs.unlink(lockPath);
+    }
+    catch {
+        // Ignore if doesn't exist
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/core/lock.js.map

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

package/dist/core/lock.spec.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Lock - Unit tests
+ */
+export {};
+//# sourceMappingURL=lock.spec.d.ts.map

package/dist/core/lock.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.spec.d.ts","sourceRoot":"","sources":["../../src/core/lock.spec.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/core/lock.spec.js

@@ -0,0 +1,161 @@
+/**
+ * Lock - Unit tests
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import fs from "fs/promises";
+import path from "path";
+import os from "os";
+import { acquireLock, writeLockInfo, readLockInfo, isLockStale, withStoreLock, isStoreLocked, getCurrentLockInfo, forceRemoveLock, } from "./lock.js";
+// Mock the constants module to use temp directory
+const TEST_STORE_PATH = path.join(os.tmpdir(), "devlink-test-" + Date.now());
+vi.mock("../constants.js", () => ({
+    getStorePath: () => TEST_STORE_PATH,
+    getLockPath: () => path.join(TEST_STORE_PATH, ".lock"),
+    DEFAULT_LOCK_TIMEOUT: 5000,
+    DEFAULT_LOCK_RETRY_INTERVAL: 50,
+    DEFAULT_LOCK_STALE_TIME: 2000,
+}));
+describe("Lock", () => {
+    beforeEach(async () => {
+        await fs.mkdir(TEST_STORE_PATH, { recursive: true });
+    });
+    afterEach(async () => {
+        await fs.rm(TEST_STORE_PATH, { recursive: true, force: true });
+    });
+    describe("writeLockInfo / readLockInfo", () => {
+        it("should write and read lock info", async () => {
+            const lockPath = path.join(TEST_STORE_PATH, ".lock");
+            const info = {
+                pid: 12345,
+                acquired: "2026-02-12T10:00:00Z",
+                command: "publish",
+            };
+            await writeLockInfo(lockPath, info);
+            const read = await readLockInfo(lockPath);
+            expect(read).toEqual(info);
+        });
+        it("should return null for non-existent lock file", async () => {
+            const lockPath = path.join(TEST_STORE_PATH, "nonexistent.lock");
+            const read = await readLockInfo(lockPath);
+            expect(read).toBeNull();
+        });
+    });
+    describe("isLockStale", () => {
+        it("should return true for non-existent lock", async () => {
+            const lockPath = path.join(TEST_STORE_PATH, "nonexistent.lock");
+            const stale = await isLockStale(lockPath, 10000);
+            expect(stale).toBe(true);
+        });
+        it("should return true for dead process", async () => {
+            const lockPath = path.join(TEST_STORE_PATH, ".lock");
+            const info = {
+                pid: 999999999, // Non-existent PID
+                acquired: new Date().toISOString(),
+                command: "test",
+            };
+            await writeLockInfo(lockPath, info);
+            const stale = await isLockStale(lockPath, 10000);
+            expect(stale).toBe(true);
+        });
+        it("should return false for current process", async () => {
+            const lockPath = path.join(TEST_STORE_PATH, ".lock");
+            const info = {
+                pid: process.pid,
+                acquired: new Date().toISOString(),
+                command: "test",
+            };
+            await writeLockInfo(lockPath, info);
+            const stale = await isLockStale(lockPath, 10000);
+            expect(stale).toBe(false);
+        });
+        it("should return true for old lock", async () => {
+            const lockPath = path.join(TEST_STORE_PATH, ".lock");
+            const oldDate = new Date(Date.now() - 20000).toISOString();
+            const info = {
+                pid: process.pid,
+                acquired: oldDate,
+                command: "test",
+            };
+            await writeLockInfo(lockPath, info);
+            const stale = await isLockStale(lockPath, 1000);
+            expect(stale).toBe(true);
+        });
+    });
+    describe("acquireLock", () => {
+        it("should acquire lock successfully", async () => {
+            const lock = await acquireLock();
+            expect(lock).toBeDefined();
+            expect(typeof lock.release).toBe("function");
+            // Verify lock file exists
+            const locked = await isStoreLocked();
+            expect(locked).toBe(true);
+            await lock.release();
+        });
+        it("should release lock properly", async () => {
+            const lock = await acquireLock();
+            await lock.release();
+            const locked = await isStoreLocked();
+            expect(locked).toBe(false);
+        });
+        it("should write correct lock info", async () => {
+            const lock = await acquireLock();
+            const info = await getCurrentLockInfo();
+            expect(info).toBeDefined();
+            expect(info?.pid).toBe(process.pid);
+            expect(info?.acquired).toBeDefined();
+            await lock.release();
+        });
+    });
+    describe("withStoreLock", () => {
+        it("should execute operation with lock", async () => {
+            let executed = false;
+            await withStoreLock(async () => {
+                executed = true;
+                const locked = await isStoreLocked();
+                expect(locked).toBe(true);
+            });
+            expect(executed).toBe(true);
+            // Lock should be released
+            const locked = await isStoreLocked();
+            expect(locked).toBe(false);
+        });
+        it("should release lock on error", async () => {
+            await expect(withStoreLock(async () => {
+                throw new Error("Test error");
+            })).rejects.toThrow("Test error");
+            // Lock should be released
+            const locked = await isStoreLocked();
+            expect(locked).toBe(false);
+        });
+        it("should return operation result", async () => {
+            const result = await withStoreLock(async () => {
+                return 42;
+            });
+            expect(result).toBe(42);
+        });
+    });
+    describe("isStoreLocked", () => {
+        it("should return false when not locked", async () => {
+            const locked = await isStoreLocked();
+            expect(locked).toBe(false);
+        });
+        it("should return true when locked", async () => {
+            const lock = await acquireLock();
+            const locked = await isStoreLocked();
+            expect(locked).toBe(true);
+            await lock.release();
+        });
+    });
+    describe("forceRemoveLock", () => {
+        it("should remove lock file", async () => {
+            const lock = await acquireLock();
+            await forceRemoveLock();
+            const locked = await isStoreLocked();
+            expect(locked).toBe(false);
+        });
+        it("should not throw if lock doesn't exist", async () => {
+            await expect(forceRemoveLock()).resolves.not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=lock.spec.js.map

package/dist/core/lock.spec.js.map

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

package/dist/core/registry.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Registry - Gestión del registry.json
+ */
+import type { Registry, PackageEntry, VersionEntry } from "../types.js";
+/**
+ * Create an empty registry
+ */
+export declare function createEmptyRegistry(): Registry;
+/**
+ * Read registry from disk
+ * Returns empty registry if file doesn't exist
+ */
+export declare function readRegistry(): Promise<Registry>;
+/**
+ * Write registry to disk (atomic write)
+ */
+export declare function writeRegistry(registry: Registry): Promise<void>;
+/**
+ * Ensure a namespace exists in the registry
+ */
+export declare function ensureNamespaceInRegistry(registry: Registry, namespace: string): void;
+/**
+ * Add or update a package version in the registry
+ */
+export declare function addPackageToRegistry(registry: Registry, namespace: string, packageName: string, version: string, entry: VersionEntry): void;
+/**
+ * Remove a package version from the registry
+ * Returns true if something was removed
+ */
+export declare function removePackageFromRegistry(registry: Registry, namespace: string, packageName: string, version?: string): boolean;
+/**
+ * Get a package entry from the registry
+ */
+export declare function getPackageFromRegistry(registry: Registry, namespace: string, packageName: string): PackageEntry | null;
+/**
+ * Get a specific version entry from the registry
+ */
+export declare function getVersionFromRegistry(registry: Registry, namespace: string, packageName: string, version: string): VersionEntry | null;
+/**
+ * Check if a namespace exists in the registry
+ */
+export declare function namespaceExistsInRegistry(registry: Registry, namespace: string): boolean;
+/**
+ * Get all namespaces from the registry
+ * Returns global first, then alphabetically sorted
+ */
+export declare function getNamespacesFromRegistry(registry: Registry): string[];
+/**
+ * Get all packages in a namespace
+ */
+export declare function getPackagesInNamespace(registry: Registry, namespace: string): string[];
+/**
+ * Get all versions of a package in a namespace
+ */
+export declare function getVersionsInNamespace(registry: Registry, namespace: string, packageName: string): string[];
+/**
+ * Remove a namespace from the registry
+ * Cannot remove the global namespace
+ */
+export declare function removeNamespaceFromRegistry(registry: Registry, namespace: string): boolean;
+/**
+ * Get total package count across all namespaces
+ */
+export declare function getTotalPackageCount(registry: Registry): number;
+/**
+ * Find all namespaces containing a specific package
+ */
+export declare function findPackageInAllNamespaces(registry: Registry, packageName: string): {
+    namespace: string;
+    versions: string[];
+}[];
+/**
+ * Find all packages matching a scope (e.g., @webforgeai)
+ */
+export declare function findPackagesByScope(registry: Registry, scope: string): {
+    namespace: string;
+    package: string;
+    versions: string[];
+}[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAkB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQxF;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,QAAQ,CAU9C;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC,CAsBtD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrE;AAGD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GAChB,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,YAAY,GAClB,IAAI,CAUN;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAsBT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,YAAY,GAAG,IAAI,CAKrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,YAAY,GAAG,IAAI,CAKrB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE,CAQtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CAKV;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,MAAM,EAAE,CAKV;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAWT;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAQ/D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,MAAM,GAClB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAmB7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,GACZ;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAiB9D"}