@guanjinke/artifact-client 1.0.0

package/dist/providers/oss-provider.js

@@ -0,0 +1,342 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OSSProvider = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const ali_oss_1 = __importDefault(require("ali-oss"));
+const storage_provider_1 = require("./storage-provider");
+const semver_1 = require("../utils/semver");
+const format_1 = require("../utils/format");
+const PLUGIN_ARTIFACTS_PREFIX = 'plugin_artifacts/';
+/**
+ * Aliyun OSS (Object Storage Service) provider.
+ * Connects via access key ID + access key secret.
+ */
+class OSSProvider extends storage_provider_1.StorageProvider {
+    client;
+    constructor(config) {
+        super();
+        if (!config.keyId || !config.key) {
+            throw new Error('OSS config requires both keyId and key.');
+        }
+        this.client = new ali_oss_1.default({
+            region: config.region || 'oss-cn-hangzhou',
+            accessKeyId: config.keyId,
+            accessKeySecret: config.key,
+            bucket: config.bucket,
+        });
+    }
+    // ============================================================
+    // listPlugins
+    // ============================================================
+    async listPlugins(options) {
+        const includeSize = options?.includeSize ?? false;
+        const plugins = [];
+        const result = await this.client.list({ prefix: PLUGIN_ARTIFACTS_PREFIX, delimiter: '/' }, {});
+        if (result.prefixes) {
+            for (const prefix of result.prefixes) {
+                // Prefix looks like "plugin_artifacts/myPlugin/"
+                const name = prefix
+                    .slice(PLUGIN_ARTIFACTS_PREFIX.length)
+                    .replace(/\/$/, '');
+                if (!name)
+                    continue;
+                const plugin = {
+                    name,
+                    path: prefix,
+                };
+                if (includeSize) {
+                    plugin.totalSizeMB = await this.calculatePrefixSize(prefix);
+                }
+                plugins.push(plugin);
+            }
+        }
+        return plugins.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    // ============================================================
+    // listMajorVersions
+    // ============================================================
+    async listMajorVersions(pluginName, options) {
+        const includeSize = options?.includeSize ?? false;
+        const majorMap = new Map();
+        const pluginPrefix = (0, semver_1.getPluginPrefix)(pluginName);
+        // List all entries under the plugin directory
+        const result = await this.client.list({ prefix: pluginPrefix, delimiter: '/' }, {});
+        if (result.prefixes) {
+            for (const prefix of result.prefixes) {
+                const dirName = prefix
+                    .slice(pluginPrefix.length)
+                    .replace(/\/$/, '');
+                if (!dirName)
+                    continue;
+                const major = (0, semver_1.extractMajorMinor)(dirName);
+                if (!majorMap.has(major)) {
+                    majorMap.set(major, {
+                        majorVersion: major,
+                        minorCount: 0,
+                        path: `${pluginPrefix}${major}/`,
+                    });
+                }
+                const entry = majorMap.get(major);
+                entry.minorCount++;
+                if (includeSize) {
+                    const dirSize = await this.calculatePrefixSize(prefix);
+                    entry.totalSizeMB = (entry.totalSizeMB ?? 0) + dirSize;
+                }
+            }
+        }
+        // Read latest version tags from version files
+        for (const [major, info] of majorMap) {
+            try {
+                const latestVersion = await this.readLatestVersionFromFile(pluginName, major);
+                if (latestVersion) {
+                    info.latestVersion = latestVersion;
+                }
+            }
+            catch {
+                // Version file may not exist yet
+            }
+        }
+        const resultList = Array.from(majorMap.values());
+        // Sort
+        if (options?.sortOrder !== 'asc') {
+            resultList.sort((a, b) => {
+                if (a.majorVersion === 'dev')
+                    return 1;
+                if (b.majorVersion === 'dev')
+                    return -1;
+                return -this.compareMajorVersions(a.majorVersion, b.majorVersion);
+            });
+        }
+        else {
+            resultList.sort((a, b) => {
+                if (a.majorVersion === 'dev')
+                    return 1;
+                if (b.majorVersion === 'dev')
+                    return -1;
+                return this.compareMajorVersions(a.majorVersion, b.majorVersion);
+            });
+        }
+        return resultList;
+    }
+    // ============================================================
+    // getLatestVersion
+    // ============================================================
+    async getLatestVersion(pluginName, majorVersion, options) {
+        const latestVersion = await this.readLatestVersionFromFile(pluginName, majorVersion);
+        if (!latestVersion) {
+            throw new Error(`No latest version found for plugin "${pluginName}" major "${majorVersion}". ` +
+                `The version file may not exist or has no latestversion tag.`);
+        }
+        const version = {
+            version: latestVersion,
+            path: (0, semver_1.getVersionPrefix)(pluginName, latestVersion),
+        };
+        if (options?.includeSize) {
+            version.totalSizeMB = await this.calculatePrefixSize(version.path);
+        }
+        return version;
+    }
+    // ============================================================
+    // listMinorVersions
+    // ============================================================
+    async listMinorVersions(pluginName, majorVersion, options) {
+        const includeSize = options?.includeSize ?? false;
+        const versions = [];
+        const pluginPrefix = (0, semver_1.getPluginPrefix)(pluginName);
+        const result = await this.client.list({ prefix: pluginPrefix, delimiter: '/' }, {});
+        if (result.prefixes) {
+            for (const prefix of result.prefixes) {
+                const dirName = prefix
+                    .slice(pluginPrefix.length)
+                    .replace(/\/$/, '');
+                if (!dirName)
+                    continue;
+                const major = (0, semver_1.extractMajorMinor)(dirName);
+                if (major !== majorVersion)
+                    continue;
+                const version = {
+                    version: dirName,
+                    path: prefix,
+                };
+                if (includeSize) {
+                    version.totalSizeMB = await this.calculatePrefixSize(prefix);
+                }
+                versions.push(version);
+            }
+        }
+        const versionStrings = versions.map(v => v.version);
+        const sorted = (0, semver_1.sortVersions)(versionStrings, options?.sortOrder ?? 'desc');
+        const versionMap = new Map(versions.map(v => [v.version, v]));
+        return sorted.map(v => versionMap.get(v)).filter(Boolean);
+    }
+    // ============================================================
+    // listArtifacts
+    // ============================================================
+    async listArtifacts(pluginName, version, options) {
+        const includeSize = options?.includeSize ?? false;
+        const artifacts = [];
+        const versionPrefix = (0, semver_1.getVersionPrefix)(pluginName, version);
+        const result = await this.client.list({ prefix: versionPrefix, delimiter: '/' }, {});
+        if (result.objects) {
+            for (const obj of result.objects) {
+                const fileName = obj.name.slice(versionPrefix.length);
+                if (!fileName)
+                    continue;
+                const artifact = {
+                    name: fileName,
+                    path: obj.name,
+                };
+                if (includeSize && obj.size !== undefined) {
+                    artifact.sizeMB = (0, format_1.bytesToMB)(obj.size);
+                }
+                artifacts.push(artifact);
+            }
+        }
+        return artifacts.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    // ============================================================
+    // uploadArtifact
+    // ============================================================
+    async uploadArtifact(pluginName, version, artifactName, localFilePath) {
+        const objectName = (0, semver_1.getArtifactPath)(pluginName, version, artifactName);
+        // Upload the file
+        await this.client.put(objectName, localFilePath);
+        // Update the version file tag
+        const major = (0, semver_1.extractMajorMinor)(version);
+        await this.updateLatestVersion(pluginName, major, version);
+    }
+    // ============================================================
+    // downloadArtifactByPath
+    // ============================================================
+    async downloadArtifactByPath(fullPath, localDir) {
+        await fs.mkdir(localDir, { recursive: true });
+        const fileName = fullPath.split('/').pop() || 'artifact';
+        const localPath = path.join(localDir, fileName);
+        await this.client.get(fullPath, localPath);
+    }
+    // ============================================================
+    // downloadArtifact
+    // ============================================================
+    async downloadArtifact(pluginName, version, fileName, localDir) {
+        const objectPath = (0, semver_1.getArtifactPath)(pluginName, version, fileName);
+        return this.downloadArtifactByPath(objectPath, localDir);
+    }
+    // ============================================================
+    // Private helpers
+    // ============================================================
+    /**
+     * Calculate the total size in MB of all objects under a given prefix.
+     */
+    async calculatePrefixSize(prefix) {
+        let totalBytes = 0;
+        let nextMarker;
+        do {
+            const result = await this.client.list({
+                prefix,
+                'max-keys': 1000,
+                marker: nextMarker,
+            }, {});
+            if (result.objects) {
+                for (const obj of result.objects) {
+                    if (obj.size) {
+                        totalBytes += obj.size;
+                    }
+                }
+            }
+            nextMarker = result.nextMarker || undefined;
+        } while (nextMarker);
+        return (0, format_1.bytesToMB)(totalBytes);
+    }
+    /**
+     * Read the latestversion tag from a version file.
+     */
+    async readLatestVersionFromFile(pluginName, majorVersion) {
+        const filePath = (0, semver_1.getVersionFilePath)(pluginName, majorVersion);
+        try {
+            const tagging = await this.client.getObjectTagging(filePath);
+            return tagging?.latestversion ?? null;
+        }
+        catch (err) {
+            if (err?.code === 'NoSuchKey' || err?.status === 404) {
+                return null;
+            }
+            throw err;
+        }
+    }
+    /**
+     * Create or update a version file with the latestversion tag.
+     */
+    async updateLatestVersion(pluginName, majorVersion, latestVersion) {
+        const filePath = (0, semver_1.getVersionFilePath)(pluginName, majorVersion);
+        // Check if the version file exists
+        let exists = false;
+        try {
+            await this.client.head(filePath);
+            exists = true;
+        }
+        catch (err) {
+            if (err?.code !== 'NoSuchKey' && err?.status !== 404) {
+                throw err;
+            }
+        }
+        if (!exists) {
+            // Create the version file with version as content
+            await this.client.put(filePath, Buffer.from(latestVersion));
+        }
+        // Set/update the latestversion tag
+        await this.client.putObjectTagging(filePath, { latestversion: latestVersion });
+    }
+    /**
+     * Compare two major version strings.
+     */
+    compareMajorVersions(a, b) {
+        const partsA = a.split('.').map(Number);
+        const partsB = b.split('.').map(Number);
+        for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
+            const numA = partsA[i] ?? 0;
+            const numB = partsB[i] ?? 0;
+            if (numA !== numB)
+                return numA - numB;
+        }
+        return 0;
+    }
+}
+exports.OSSProvider = OSSProvider;
+//# sourceMappingURL=oss-provider.js.map

package/dist/providers/oss-provider.js.map

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

package/dist/providers/storage-provider.d.ts

@@ -0,0 +1,50 @@
+import { PluginInfo, MajorVersionInfo, VersionInfo, ArtifactInfo, ListOptions, GetLatestOptions } from '../types';
+/**
+ * Abstract base class for storage providers.
+ * Both Azure and OSS providers must implement all methods defined here.
+ */
+export declare abstract class StorageProvider {
+    /**
+     * List all plugins under the plugin_artifacts/ root directory.
+     */
+    abstract listPlugins(options?: {
+        includeSize?: boolean;
+    }): Promise<PluginInfo[]>;
+    /**
+     * List all major versions for a given plugin.
+     * Major versions are derived from version files (version{major.minor}.txt / versiondev.txt)
+     * and directory scanning.
+     */
+    abstract listMajorVersions(pluginName: string, options?: ListOptions): Promise<MajorVersionInfo[]>;
+    /**
+     * Get the latest minor (patch) version for a given major version.
+     * This reads the latestversion metadata/tag from the version file.
+     */
+    abstract getLatestVersion(pluginName: string, majorVersion: string, options?: GetLatestOptions): Promise<VersionInfo>;
+    /**
+     * List all minor (patch) versions under a given major version.
+     */
+    abstract listMinorVersions(pluginName: string, majorVersion: string, options?: ListOptions): Promise<VersionInfo[]>;
+    /**
+     * List all artifacts for a specific version.
+     */
+    abstract listArtifacts(pluginName: string, version: string, options?: {
+        includeSize?: boolean;
+    }): Promise<ArtifactInfo[]>;
+    /**
+     * Upload a local file as an artifact to a specific plugin version directory.
+     * Also updates the latestversion metadata/tag on the corresponding version file.
+     */
+    abstract uploadArtifact(pluginName: string, version: string, artifactName: string, localFilePath: string): Promise<void>;
+    /**
+     * Download an artifact by its full storage path.
+     * e.g. "plugin_artifacts/myPlugin/1.0.5/foo.zip"
+     */
+    abstract downloadArtifactByPath(fullPath: string, localDir: string): Promise<void>;
+    /**
+     * Download an artifact by plugin name, version, and file name.
+     * The full path is constructed as plugin_artifacts/{plugin}/{version}/{fileName}.
+     */
+    abstract downloadArtifact(pluginName: string, version: string, fileName: string, localDir: string): Promise<void>;
+}
+//# sourceMappingURL=storage-provider.d.ts.map

package/dist/providers/storage-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-provider.d.ts","sourceRoot":"","sources":["../../src/providers/storage-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,8BAAsB,eAAe;IACnC;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAEhF;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CACxB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAE9B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CACvB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,WAAW,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CACxB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,aAAa,CACpB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAClC,OAAO,CAAC,YAAY,EAAE,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;CACjB"}

package/dist/providers/storage-provider.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageProvider = void 0;
+/**
+ * Abstract base class for storage providers.
+ * Both Azure and OSS providers must implement all methods defined here.
+ */
+class StorageProvider {
+}
+exports.StorageProvider = StorageProvider;
+//# sourceMappingURL=storage-provider.js.map

package/dist/providers/storage-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-provider.js","sourceRoot":"","sources":["../../src/providers/storage-provider.ts"],"names":[],"mappings":";;;AASA;;;GAGG;AACH,MAAsB,eAAe;CA0EpC;AA1ED,0CA0EC"}

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+export type StorageType = 'az' | 'oss';
+export interface AzureConfig {
+    sasUrl: string;
+}
+export interface OSSConfig {
+    keyId: string;
+    key: string;
+    bucket?: string;
+    region?: string;
+}
+export type StorageConfig = AzureConfig | OSSConfig;
+export interface CLIConfig {
+    az?: AzureConfig;
+    oss?: OSSConfig;
+}
+export interface PluginInfo {
+    /** Plugin name (directory name under plugin_artifacts) */
+    name: string;
+    /** Full path prefix for this plugin, e.g. "plugin_artifacts/myPlugin/" */
+    path: string;
+    /** Total storage size in MB (optional) */
+    totalSizeMB?: number;
+}
+export interface MajorVersionInfo {
+    /** Major version string, e.g. "1.0" or "dev" */
+    majorVersion: string;
+    /** Latest full semver under this major, e.g. "1.0.5" or "1.0.5-beta" */
+    latestVersion?: string;
+    /** Number of minor (patch) versions under this major */
+    minorCount: number;
+    /** Full path for this major version's directory prefix */
+    path: string;
+    /** Total storage size in MB of all minor versions under this major (optional) */
+    totalSizeMB?: number;
+}
+export interface VersionInfo {
+    /** Full semantic version string, e.g. "1.0.5" */
+    version: string;
+    /** Full path to this version's directory, e.g. "plugin_artifacts/foo/1.0.5/" */
+    path: string;
+    /** Total storage size in MB (optional) */
+    totalSizeMB?: number;
+}
+export interface ArtifactInfo {
+    /** File name of the artifact */
+    name: string;
+    /** Full path to the artifact, e.g. "plugin_artifacts/foo/1.0.5/foo.zip" */
+    path: string;
+    /** File size in MB (optional) */
+    sizeMB?: number;
+}
+export interface ListOptions {
+    /** Sort order for version lists. Default: 'desc' */
+    sortOrder?: 'asc' | 'desc';
+    /** Whether to include size calculations */
+    includeSize?: boolean;
+}
+export interface GetLatestOptions {
+    /** Whether to include size calculations */
+    includeSize?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,KAAK,CAAC;AAMvC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAMpD,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,EAAE,WAAW,CAAC;IACjB,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB;AAMD,MAAM,WAAW,UAAU;IACzB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ============================================================
+// Storage type discriminator
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,6BAA6B;AAC7B,+DAA+D"}

package/dist/utils/format.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Format bytes to a human-readable MB string.
+ */
+export declare function bytesToMB(bytes: number): number;
+/**
+ * Format a number to 2 decimal places for display.
+ */
+export declare function formatSize(mb: number): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/utils/format.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bytesToMB = bytesToMB;
+exports.formatSize = formatSize;
+/**
+ * Format bytes to a human-readable MB string.
+ */
+function bytesToMB(bytes) {
+    return Math.round((bytes / (1024 * 1024)) * 100) / 100;
+}
+/**
+ * Format a number to 2 decimal places for display.
+ */
+function formatSize(mb) {
+    return `${mb.toFixed(2)} MB`;
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":";;AAGA,8BAEC;AAKD,gCAEC;AAZD;;GAEG;AACH,SAAgB,SAAS,CAAC,KAAa;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,EAAU;IACnC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/B,CAAC"}

package/dist/utils/semver.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Compare two version strings following semver rules.
+ * Returns negative if a < b, zero if a == b, positive if a > b.
+ * Supports pre-release tags (e.g., 1.0.5-beta < 1.0.5).
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Sort an array of version strings by semver rules.
+ * Default order is descending (newest first).
+ */
+export declare function sortVersions(versions: string[], order?: 'asc' | 'desc'): string[];
+/**
+ * Extract the major.minor portion from a full semver string.
+ * e.g. "1.0.5" → "1.0", "2.3.1-beta" → "2.3", "0.0.3" → "dev"
+ */
+export declare function extractMajorMinor(version: string): string;
+/**
+ * Check if a version is a dev version (major === 0 and minor === 0).
+ */
+export declare function isDevVersion(version: string): boolean;
+/**
+ * Get the version file name for a given major version string.
+ * "1.0" → "version1.0.txt", "dev" → "versiondev.txt"
+ */
+export declare function getVersionFileName(majorVersion: string): string;
+/**
+ * Build the version file path (blob/object key).
+ * e.g. "plugin_artifacts/myPlugin/version1.0.txt"
+ */
+export declare function getVersionFilePath(pluginName: string, majorVersion: string): string;
+/**
+ * Build the directory prefix for a plugin.
+ * e.g. "plugin_artifacts/myPlugin/"
+ */
+export declare function getPluginPrefix(pluginName: string): string;
+/**
+ * Build the directory prefix for a specific version of a plugin.
+ * e.g. "plugin_artifacts/myPlugin/1.0.5/"
+ */
+export declare function getVersionPrefix(pluginName: string, version: string): string;
+/**
+ * Build the full path for a specific artifact.
+ * e.g. "plugin_artifacts/myPlugin/1.0.5/foo.zip"
+ */
+export declare function getArtifactPath(pluginName: string, version: string, fileName: string): string;
+//# sourceMappingURL=semver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semver.d.ts","sourceRoot":"","sources":["../../src/utils/semver.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,GAAE,KAAK,GAAG,MAAe,GAC7B,MAAM,EAAE,CAGV;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAezD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIrD;AASD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,MAAM,CAER"}