prpm 0.0.1

package/dist/commands/add.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Add command implementation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAdd = handleAdd;
+exports.createAddCommand = createAddCommand;
+const commander_1 = require("commander");
+const downloader_1 = require("../core/downloader");
+const filesystem_1 = require("../core/filesystem");
+const config_1 = require("../core/config");
+const telemetry_1 = require("../core/telemetry");
+// Extract repository info from GitHub URL for popularity tracking
+function extractRepoFromUrl(url) {
+    try {
+        // Handle raw GitHub URLs: https://raw.githubusercontent.com/user/repo/branch/path
+        const rawMatch = url.match(/raw\.githubusercontent\.com\/([^\/]+)\/([^\/]+)/);
+        if (rawMatch) {
+            return `${rawMatch[1]}/${rawMatch[2]}`;
+        }
+        // Handle regular GitHub URLs: https://github.com/user/repo
+        const githubMatch = url.match(/github\.com\/([^\/]+)\/([^\/]+)/);
+        if (githubMatch) {
+            return `${githubMatch[1]}/${githubMatch[2]}`;
+        }
+        return 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Add a prompt package from a URL
+ */
+async function handleAdd(url, type) {
+    const startTime = Date.now();
+    let success = false;
+    let error;
+    try {
+        console.log(`📥 Downloading from ${url}...`);
+        // Download the file
+        const content = await (0, downloader_1.downloadFile)(url);
+        // Extract filename and generate ID
+        const filename = (0, downloader_1.extractFilename)(url);
+        const id = (0, filesystem_1.generateId)(filename);
+        // Determine destination
+        const destDir = (0, filesystem_1.getDestinationDir)(type);
+        const destPath = `${destDir}/${filename}`;
+        // Save the file
+        console.log(`💾 Saving to ${destPath}...`);
+        await (0, filesystem_1.saveFile)(destPath, content);
+        // Create package record
+        const pkg = {
+            id,
+            type,
+            url,
+            dest: destPath
+        };
+        // Update configuration
+        await (0, config_1.addPackage)(pkg);
+        console.log(`✅ Successfully added ${id} (${type})`);
+        console.log(`   📁 Saved to: ${destPath}`);
+        success = true;
+    }
+    catch (err) {
+        error = err instanceof Error ? err.message : String(err);
+        console.error(`❌ Failed to add package: ${error}`);
+        process.exit(1);
+    }
+    finally {
+        // Track telemetry
+        await telemetry_1.telemetry.track({
+            command: 'add',
+            success,
+            error,
+            duration: Date.now() - startTime,
+            data: {
+                type,
+                url: url.substring(0, 100), // Truncate long URLs
+                filename: (0, downloader_1.extractFilename)(url),
+                // Package popularity tracking
+                packageId: (0, filesystem_1.generateId)((0, downloader_1.extractFilename)(url)),
+                packageType: type,
+                sourceRepo: extractRepoFromUrl(url),
+            },
+        });
+    }
+}
+/**
+ * Create the add command
+ */
+function createAddCommand() {
+    const command = new commander_1.Command('add');
+    command
+        .description('Add a prompt package from a URL')
+        .argument('<url>', 'Raw GitHub URL to the prompt file')
+        .option('--as <type>', 'Package type (cursor or claude)', 'cursor')
+        .action(async (url, options) => {
+        const type = options.as;
+        if (type !== 'cursor' && type !== 'claude') {
+            console.error('❌ Type must be either "cursor" or "claude"');
+            process.exit(1);
+        }
+        await handleAdd(url, type);
+    });
+    return command;
+}

package/dist/commands/collections.js

@@ -0,0 +1,409 @@
+"use strict";
+/**
+ * Collections command - Manage package collections
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleCollectionsSearch = handleCollectionsSearch;
+exports.handleCollectionsList = handleCollectionsList;
+exports.handleCollectionInfo = handleCollectionInfo;
+exports.handleCollectionInstall = handleCollectionInstall;
+exports.createCollectionsCommand = createCollectionsCommand;
+const commander_1 = require("commander");
+const registry_client_1 = require("@prpm/registry-client");
+const user_config_1 = require("../core/user-config");
+const install_1 = require("./install");
+const telemetry_1 = require("../core/telemetry");
+/**
+ * Search collections by query
+ */
+async function handleCollectionsSearch(query, options) {
+    const startTime = Date.now();
+    try {
+        const config = await (0, user_config_1.getConfig)();
+        const client = (0, registry_client_1.getRegistryClient)(config);
+        console.log(`🔍 Searching collections for "${query}"...\n`);
+        // Get all collections and filter by query
+        const result = await client.getCollections({
+            category: options.category,
+            tag: options.tag,
+            official: options.official,
+            limit: options.limit || 50,
+        });
+        // Filter collections by search query (name, description, tags)
+        const queryLower = query.toLowerCase();
+        const filtered = result.collections.filter(c => c.name.toLowerCase().includes(queryLower) ||
+            c.description.toLowerCase().includes(queryLower) ||
+            c.tags.some(tag => tag.toLowerCase().includes(queryLower)) ||
+            c.id.toLowerCase().includes(queryLower));
+        if (filtered.length === 0) {
+            console.log('No collections found matching your search.');
+            console.log('\n💡 Try:');
+            console.log('  - Broadening your search terms');
+            console.log('  - Checking spelling');
+            console.log('  - Browsing all: prpm collections list');
+            return;
+        }
+        console.log(`✨ Found ${filtered.length} collection(s):\n`);
+        // Group by official vs community
+        const official = filtered.filter(c => c.official);
+        const community = filtered.filter(c => !c.official);
+        if (official.length > 0) {
+            console.log('📦 Official Collections:\n');
+            official.forEach(c => {
+                const fullName = `@${c.scope}/${c.id}`.padEnd(35);
+                const pkgCount = `(${c.package_count} packages)`.padEnd(15);
+                console.log(`   ${c.icon || '📦'} ${fullName} ${pkgCount} ${c.name}`);
+                if (c.description) {
+                    console.log(`      ${c.description.substring(0, 70)}${c.description.length > 70 ? '...' : ''}`);
+                }
+                console.log(`      ⬇️  ${c.downloads.toLocaleString()} installs · ⭐ ${c.stars.toLocaleString()} stars`);
+                console.log('');
+            });
+        }
+        if (community.length > 0) {
+            console.log('\n🌟 Community Collections:\n');
+            community.forEach(c => {
+                const fullName = `@${c.scope}/${c.id}`.padEnd(35);
+                const pkgCount = `(${c.package_count} packages)`.padEnd(15);
+                console.log(`   ${c.icon || '📦'} ${fullName} ${pkgCount} ${c.name}`);
+                if (c.description) {
+                    console.log(`      ${c.description.substring(0, 70)}${c.description.length > 70 ? '...' : ''}`);
+                }
+                console.log(`      ⬇️  ${c.downloads.toLocaleString()} installs · ⭐ ${c.stars.toLocaleString()} stars`);
+                console.log('');
+            });
+        }
+        console.log(`\n💡 View details: prpm collection info <collection>`);
+        console.log(`💡 Install: prpm install @collection/<name>`);
+        await telemetry_1.telemetry.track({
+            command: 'collections:search',
+            success: true,
+            duration: Date.now() - startTime,
+            data: {
+                query: query.substring(0, 100),
+                count: filtered.length,
+                filters: options,
+            },
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`\n❌ Failed to search collections: ${errorMessage}`);
+        await telemetry_1.telemetry.track({
+            command: 'collections:search',
+            success: false,
+            error: errorMessage,
+            duration: Date.now() - startTime,
+        });
+        process.exit(1);
+    }
+}
+/**
+ * List available collections
+ */
+async function handleCollectionsList(options) {
+    const startTime = Date.now();
+    try {
+        const config = await (0, user_config_1.getConfig)();
+        const client = (0, registry_client_1.getRegistryClient)(config);
+        console.log('📦 Searching collections...\n');
+        const result = await client.getCollections({
+            category: options.category,
+            tag: options.tag,
+            official: options.official,
+            scope: options.scope,
+            limit: 50,
+        });
+        if (result.collections.length === 0) {
+            console.log('No collections found matching your criteria.');
+            return;
+        }
+        // Group by official vs community
+        const official = result.collections.filter(c => c.official);
+        const community = result.collections.filter(c => !c.official);
+        if (official.length > 0) {
+            console.log('📦 Official Collections:\n');
+            official.forEach(c => {
+                const fullName = `@${c.scope}/${c.id}`.padEnd(35);
+                const pkgCount = `(${c.package_count} packages)`.padEnd(15);
+                console.log(`   ${c.icon || '📦'} ${fullName} ${pkgCount} ${c.name}`);
+                if (c.description) {
+                    console.log(`      ${c.description.substring(0, 70)}${c.description.length > 70 ? '...' : ''}`);
+                }
+                console.log(`      ⬇️  ${c.downloads.toLocaleString()} installs · ⭐ ${c.stars.toLocaleString()} stars`);
+                console.log('');
+            });
+        }
+        if (community.length > 0) {
+            console.log('\n🌟 Community Collections:\n');
+            community.forEach(c => {
+                const fullName = `@${c.scope}/${c.id}`.padEnd(35);
+                const pkgCount = `(${c.package_count} packages)`.padEnd(15);
+                console.log(`   ${c.icon || '📦'} ${fullName} ${pkgCount} ${c.name}`);
+                if (c.description) {
+                    console.log(`      ${c.description.substring(0, 70)}${c.description.length > 70 ? '...' : ''}`);
+                }
+                console.log(`      ⬇️  ${c.downloads.toLocaleString()} installs · ⭐ ${c.stars.toLocaleString()} stars`);
+                console.log('');
+            });
+        }
+        console.log(`\n💡 View details: prpm collection info <collection>`);
+        console.log(`💡 Install: prpm install @collection/<name>`);
+        await telemetry_1.telemetry.track({
+            command: 'collections:list',
+            success: true,
+            duration: Date.now() - startTime,
+            data: {
+                count: result.collections.length,
+                filters: options,
+            },
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`\n❌ Failed to list collections: ${errorMessage}`);
+        await telemetry_1.telemetry.track({
+            command: 'collections:list',
+            success: false,
+            error: errorMessage,
+            duration: Date.now() - startTime,
+        });
+        process.exit(1);
+    }
+}
+/**
+ * Show collection details
+ */
+async function handleCollectionInfo(collectionSpec) {
+    const startTime = Date.now();
+    try {
+        // Parse collection spec: @scope/id or scope/id
+        const match = collectionSpec.match(/^@?([^/]+)\/([^/@]+)(?:@(.+))?$/);
+        if (!match) {
+            throw new Error('Invalid collection format. Use: @scope/id or scope/id[@version]');
+        }
+        const [, scope, id, version] = match;
+        const config = await (0, user_config_1.getConfig)();
+        const client = (0, registry_client_1.getRegistryClient)(config);
+        console.log(`📦 Loading collection: @${scope}/${id}...\n`);
+        const collection = await client.getCollection(scope, id, version);
+        // Header
+        console.log(`${collection.icon || '📦'} ${collection.name}`);
+        console.log(`${'='.repeat(collection.name.length + 2)}`);
+        console.log('');
+        console.log(collection.description);
+        console.log('');
+        // Stats
+        console.log('📊 Stats:');
+        console.log(`   Downloads: ${collection.downloads.toLocaleString()}`);
+        console.log(`   Stars: ${collection.stars.toLocaleString()}`);
+        console.log(`   Version: ${collection.version}`);
+        console.log(`   Packages: ${collection.packages.length}`);
+        console.log(`   Author: ${collection.author}${collection.verified ? ' ✓' : ''}`);
+        if (collection.category) {
+            console.log(`   Category: ${collection.category}`);
+        }
+        if (collection.tags && collection.tags.length > 0) {
+            console.log(`   Tags: ${collection.tags.join(', ')}`);
+        }
+        console.log('');
+        // Packages
+        console.log('📋 Included Packages:');
+        console.log('');
+        const requiredPkgs = collection.packages.filter(p => p.required);
+        const optionalPkgs = collection.packages.filter(p => !p.required);
+        if (requiredPkgs.length > 0) {
+            console.log('   Required:');
+            requiredPkgs.forEach((pkg, i) => {
+                console.log(`   ${i + 1}. ✓ ${pkg.packageId}@${pkg.version || 'latest'}`);
+                if (pkg.package) {
+                    console.log(`      ${pkg.package.description || pkg.package.display_name}`);
+                }
+                if (pkg.reason) {
+                    console.log(`      💡 ${pkg.reason}`);
+                }
+                console.log('');
+            });
+        }
+        if (optionalPkgs.length > 0) {
+            console.log('   Optional:');
+            optionalPkgs.forEach((pkg, i) => {
+                console.log(`   ${i + 1}. ○ ${pkg.packageId}@${pkg.version || 'latest'}`);
+                if (pkg.package) {
+                    console.log(`      ${pkg.package.description || pkg.package.display_name}`);
+                }
+                if (pkg.reason) {
+                    console.log(`      💡 ${pkg.reason}`);
+                }
+                console.log('');
+            });
+        }
+        // Installation
+        console.log('💡 Install:');
+        console.log(`   prpm install @${scope}/${id}`);
+        if (optionalPkgs.length > 0) {
+            console.log(`   prpm install @${scope}/${id} --skip-optional  # Skip optional packages`);
+        }
+        console.log('');
+        await telemetry_1.telemetry.track({
+            command: 'collections:info',
+            success: true,
+            duration: Date.now() - startTime,
+            data: {
+                scope,
+                id,
+                packageCount: collection.packages.length,
+            },
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`\n❌ Failed to get collection info: ${errorMessage}`);
+        await telemetry_1.telemetry.track({
+            command: 'collections:info',
+            success: false,
+            error: errorMessage,
+            duration: Date.now() - startTime,
+        });
+        process.exit(1);
+    }
+}
+/**
+ * Install a collection
+ */
+async function handleCollectionInstall(collectionSpec, options) {
+    const startTime = Date.now();
+    let packagesInstalled = 0;
+    let packagesFailed = 0;
+    try {
+        // Parse collection spec
+        const match = collectionSpec.match(/^@?([^/]+)\/([^/@]+)(?:@(.+))?$/);
+        if (!match) {
+            throw new Error('Invalid collection format. Use: @scope/id or scope/id[@version]');
+        }
+        const [, scope, id, version] = match;
+        const config = await (0, user_config_1.getConfig)();
+        const client = (0, registry_client_1.getRegistryClient)(config);
+        // Get collection installation plan
+        console.log(`📦 Installing collection: @${scope}/${id}...\n`);
+        const installResult = await client.installCollection({
+            scope,
+            id,
+            version,
+            format: options.format,
+            skipOptional: options.skipOptional,
+        });
+        const collection = installResult.collection;
+        const packages = installResult.packagesToInstall;
+        console.log(`📦 ${collection.name}`);
+        console.log(`   ${packages.length} packages to install\n`);
+        if (options.dryRun) {
+            console.log('🔍 Dry run - would install:\n');
+            packages.forEach((pkg, i) => {
+                const required = pkg.required ? '✓' : '○';
+                console.log(`   ${i + 1}/${packages.length} ${required} ${pkg.packageId}@${pkg.version} (${pkg.format})`);
+            });
+            console.log('');
+            return;
+        }
+        // Install packages sequentially
+        for (let i = 0; i < packages.length; i++) {
+            const pkg = packages[i];
+            const progress = `${i + 1}/${packages.length}`;
+            try {
+                console.log(`\n  ${progress} Installing ${pkg.packageId}@${pkg.version}...`);
+                await (0, install_1.handleInstall)(`${pkg.packageId}@${pkg.version}`, {
+                    as: pkg.format,
+                });
+                console.log(`  ${progress} ✓ ${pkg.packageId}`);
+                packagesInstalled++;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.error(`  ${progress} ✗ ${pkg.packageId}: ${errorMessage}`);
+                packagesFailed++;
+                if (pkg.required) {
+                    throw new Error(`Failed to install required package: ${pkg.packageId}`);
+                }
+            }
+        }
+        console.log(`\n✅ Collection installed successfully!`);
+        console.log(`   ${packagesInstalled}/${packages.length} packages installed`);
+        if (packagesFailed > 0) {
+            console.log(`   ${packagesFailed} optional packages failed`);
+        }
+        console.log('');
+        await telemetry_1.telemetry.track({
+            command: 'collections:install',
+            success: true,
+            duration: Date.now() - startTime,
+            data: {
+                scope,
+                id,
+                packageCount: packages.length,
+                installed: packagesInstalled,
+                failed: packagesFailed,
+                format: options.format,
+            },
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`\n❌ Failed to install collection: ${errorMessage}`);
+        await telemetry_1.telemetry.track({
+            command: 'collections:install',
+            success: false,
+            error: errorMessage,
+            duration: Date.now() - startTime,
+            data: {
+                installed: packagesInstalled,
+                failed: packagesFailed,
+            },
+        });
+        process.exit(1);
+    }
+}
+/**
+ * Create collections command group
+ */
+function createCollectionsCommand() {
+    const command = new commander_1.Command('collections');
+    command
+        .description('Manage package collections')
+        .alias('collection')
+        .action(async (options) => {
+        await handleCollectionsList(options);
+    });
+    // Search subcommand
+    command
+        .command('search <query>')
+        .description('Search for collections')
+        .option('--category <category>', 'Filter by category')
+        .option('--tag <tag>', 'Filter by tag')
+        .option('--official', 'Show only official collections')
+        .option('--limit <number>', 'Number of results to show', '50')
+        .action(async (query, options) => {
+        await handleCollectionsSearch(query, {
+            category: options.category,
+            tag: options.tag,
+            official: options.official,
+            limit: parseInt(options.limit, 10),
+        });
+    });
+    // List subcommand
+    command
+        .command('list')
+        .description('List available collections')
+        .option('--category <category>', 'Filter by category')
+        .option('--tag <tag>', 'Filter by tag')
+        .option('--official', 'Show only official collections')
+        .option('--scope <scope>', 'Filter by scope')
+        .action(handleCollectionsList);
+    // Info subcommand
+    command
+        .command('info <collection>')
+        .description('Show collection details')
+        .action(handleCollectionInfo);
+    // Install handled by main install command with @scope/id syntax
+    return command;
+}

package/dist/commands/deps.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * Deps command - Show dependency tree for a package
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDeps = handleDeps;
+exports.createDepsCommand = createDepsCommand;
+const commander_1 = require("commander");
+const registry_client_1 = require("@prpm/registry-client");
+const user_config_1 = require("../core/user-config");
+const telemetry_1 = require("../core/telemetry");
+/**
+ * Display dependency tree
+ */
+async function handleDeps(packageSpec) {
+    const startTime = Date.now();
+    let success = false;
+    let error;
+    try {
+        // Parse package spec
+        const [packageId, version] = packageSpec.split('@');
+        console.log(`📦 Resolving dependencies for ${packageId}${version ? `@${version}` : ''}...\n`);
+        const config = await (0, user_config_1.getConfig)();
+        const client = (0, registry_client_1.getRegistryClient)(config);
+        // Resolve dependency tree
+        const result = await client.resolveDependencies(packageId, version);
+        if (Object.keys(result.resolved).length === 1) {
+            console.log('✅ No dependencies\n');
+            success = true;
+            return;
+        }
+        // Display resolved versions
+        console.log('📋 Resolved Dependencies:\n');
+        for (const [pkgId, pkgVersion] of Object.entries(result.resolved)) {
+            if (pkgId === packageId)
+                continue; // Skip root package
+            console.log(`   ${pkgId}@${pkgVersion}`);
+        }
+        console.log(`\n📊 Total: ${Object.keys(result.resolved).length - 1} dependencies\n`);
+        // Display tree structure
+        console.log('🌳 Dependency Tree:\n');
+        printTree(result.tree, packageId, '', true);
+        success = true;
+    }
+    catch (err) {
+        error = err instanceof Error ? err.message : String(err);
+        console.error(`\n❌ Failed to resolve dependencies: ${error}`);
+        if (error.includes('Circular dependency')) {
+            console.log(`\n💡 Tip: This package has a circular dependency which is not allowed.`);
+        }
+        else if (error.includes('not found')) {
+            console.log(`\n💡 Tip: Check the package name and version are correct.`);
+        }
+        process.exit(1);
+    }
+    finally {
+        await telemetry_1.telemetry.track({
+            command: 'deps',
+            success,
+            error,
+            duration: Date.now() - startTime,
+            data: {
+                packageId: packageSpec.split('@')[0],
+            },
+        });
+    }
+}
+/**
+ * Print dependency tree recursively
+ */
+function printTree(tree, packageId, prefix = '', isLast = true) {
+    const node = tree[packageId];
+    if (!node)
+        return;
+    const deps = node.dependencies || {};
+    const depKeys = Object.keys(deps);
+    console.log(`${prefix}${isLast ? '└─' : '├─'} ${packageId}@${node.version}`);
+    depKeys.forEach((depId, index) => {
+        const isLastDep = index === depKeys.length - 1;
+        const newPrefix = prefix + (isLast ? '   ' : '│  ');
+        printTree(tree, depId, newPrefix, isLastDep);
+    });
+}
+/**
+ * Create the deps command
+ */
+function createDepsCommand() {
+    return new commander_1.Command('deps')
+        .description('Show dependency tree for a package')
+        .argument('<package>', 'Package to analyze (e.g., react-rules or react-rules@1.2.0)')
+        .action(handleDeps);
+}