@portel/photon 1.0.0

package/dist/marketplace-manager.d.ts

@@ -0,0 +1,261 @@
+/**
+ * Marketplace Manager - Manage multiple MCP marketplaces
+ */
+export type MarketplaceSourceType = 'github' | 'git-ssh' | 'url' | 'local';
+export interface Marketplace {
+    name: string;
+    repo: string;
+    url: string;
+    sourceType: MarketplaceSourceType;
+    source: string;
+    enabled: boolean;
+    lastUpdated?: string;
+}
+export interface MarketplaceConfig {
+    marketplaces: Marketplace[];
+}
+/**
+ * Photon metadata from photons.json manifest
+ */
+export interface PhotonMetadata {
+    name: string;
+    version: string;
+    description: string;
+    author?: string;
+    homepage?: string;
+    repository?: string;
+    license?: string;
+    tags?: string[];
+    category?: string;
+    source: string;
+    hash?: string;
+    tools?: string[];
+}
+/**
+ * Local installation metadata for tracking Photon origins
+ */
+export interface PhotonInstallMetadata {
+    marketplace: string;
+    marketplaceRepo: string;
+    version: string;
+    originalHash: string;
+    installedAt: string;
+    lastChecked?: string;
+}
+/**
+ * Local metadata file structure
+ */
+export interface LocalMetadata {
+    photons: Record<string, PhotonInstallMetadata>;
+}
+/**
+ * Marketplace manifest (.marketplace/photons.json)
+ */
+export interface MarketplaceManifest {
+    name: string;
+    version?: string;
+    description?: string;
+    owner?: {
+        name: string;
+        email?: string;
+        url?: string;
+    };
+    photons: PhotonMetadata[];
+}
+/**
+ * Calculate SHA-256 hash of file content
+ */
+export declare function calculateFileHash(filePath: string): Promise<string>;
+/**
+ * Calculate SHA-256 hash of string content
+ */
+export declare function calculateHash(content: string): string;
+/**
+ * Read local installation metadata
+ */
+export declare function readLocalMetadata(): Promise<LocalMetadata>;
+/**
+ * Write local installation metadata
+ */
+export declare function writeLocalMetadata(metadata: LocalMetadata): Promise<void>;
+export declare class MarketplaceManager {
+    private config;
+    initialize(): Promise<void>;
+    save(): Promise<void>;
+    /**
+     * Get all marketplaces
+     */
+    getAll(): Marketplace[];
+    /**
+     * Get enabled marketplaces
+     */
+    getEnabled(): Marketplace[];
+    /**
+     * Get marketplace by name
+     */
+    get(name: string): Marketplace | undefined;
+    /**
+     * Parse marketplace source into structured info
+     * Supports:
+     * 1. GitHub shorthand: username/repo
+     * 2. GitHub HTTPS: https://github.com/username/repo[.git]
+     * 3. GitHub SSH: git@github.com:username/repo.git
+     * 4. Direct URL: https://example.com/photons.json
+     * 5. Local path: ./path/to/marketplace or /absolute/path
+     */
+    private parseMarketplaceSource;
+    /**
+     * Get next available name with numeric suffix if name already exists
+     * e.g., if 'photon-mcps' exists, returns 'photon-mcps-2'
+     * if 'photon-mcps' and 'photon-mcps-2' exist, returns 'photon-mcps-3'
+     */
+    private getUniqueName;
+    /**
+     * Check if a marketplace with the same source already exists
+     */
+    private findBySource;
+    /**
+     * Add a new marketplace
+     * Supports:
+     * - GitHub: username/repo, https://github.com/username/repo, git@github.com:username/repo.git
+     * - Direct URL: https://example.com/photons.json
+     * - Local path: ./path/to/marketplace, /absolute/path
+     *
+     * If a marketplace with the same name already exists, automatically appends a numeric suffix (-2, -3, etc.)
+     * If the exact same source already exists, returns the existing marketplace without creating a duplicate.
+     *
+     * @returns Object with marketplace info and 'added' flag (false if already existed)
+     */
+    add(source: string): Promise<{
+        marketplace: Omit<Marketplace, 'enabled' | 'lastUpdated'>;
+        added: boolean;
+    }>;
+    /**
+     * Remove a marketplace
+     */
+    remove(name: string): Promise<boolean>;
+    /**
+     * Enable/disable a marketplace
+     */
+    setEnabled(name: string, enabled: boolean): Promise<boolean>;
+    /**
+     * Get cache file path for marketplace
+     */
+    private getCacheFile;
+    /**
+     * Fetch photons.json manifest from various sources
+     */
+    fetchManifest(marketplace: Marketplace): Promise<MarketplaceManifest | null>;
+    /**
+     * Update marketplace cache (fetch and save photons.json manifest)
+     */
+    updateMarketplaceCache(name: string): Promise<boolean>;
+    /**
+     * Update all enabled marketplace caches
+     */
+    updateAllCaches(): Promise<Map<string, boolean>>;
+    /**
+     * Get cached marketplace manifest
+     */
+    getCachedManifest(marketplaceName: string): Promise<MarketplaceManifest | null>;
+    /**
+     * Get Photon metadata from cached manifest
+     */
+    getPhotonMetadata(photonName: string): Promise<{
+        metadata: PhotonMetadata;
+        marketplace: Marketplace;
+    } | null>;
+    /**
+     * Get all Photons with metadata from all enabled marketplaces
+     */
+    getAllPhotons(): Promise<Map<string, {
+        metadata: PhotonMetadata;
+        marketplace: Marketplace;
+    }>>;
+    /**
+     * Get count of available Photons per marketplace
+     */
+    getMarketplaceCounts(): Promise<Map<string, number>>;
+    /**
+     * Check if marketplace cache is stale
+     */
+    private isCacheStale;
+    /**
+     * Auto-update stale caches
+     * Returns true if any updates were performed
+     */
+    autoUpdateStaleCaches(): Promise<boolean>;
+    /**
+     * Try to fetch MCP from all enabled marketplaces
+     * Returns content, marketplace info, and metadata (version, hash)
+     */
+    fetchMCP(mcpName: string): Promise<{
+        content: string;
+        marketplace: Marketplace;
+        metadata?: PhotonMetadata;
+    } | null>;
+    /**
+     * Fetch version from all enabled marketplaces
+     */
+    fetchVersion(mcpName: string): Promise<{
+        version: string;
+        marketplace: Marketplace;
+    } | null>;
+    /**
+     * Search for Photon in all marketplaces
+     * Searches in name, description, tags, and author fields
+     */
+    search(query: string): Promise<Map<string, {
+        metadata?: PhotonMetadata;
+        marketplace: Marketplace;
+    }[]>>;
+    /**
+     * List all available MCPs from a marketplace
+     * Note: Requires marketplace to have a .marketplace/photons.json file
+     */
+    listFromMarketplace(marketplaceName: string): Promise<string[]>;
+    /**
+     * Save installation metadata for a Photon
+     */
+    savePhotonMetadata(fileName: string, marketplace: Marketplace, metadata: PhotonMetadata, contentHash: string): Promise<void>;
+    /**
+     * Get local installation metadata for a Photon
+     */
+    getPhotonInstallMetadata(fileName: string): Promise<PhotonInstallMetadata | null>;
+    /**
+     * Check if a Photon file has been modified since installation
+     */
+    isPhotonModified(filePath: string, fileName: string): Promise<boolean>;
+    /**
+     * Find all marketplaces that have a specific MCP (for conflict detection)
+     */
+    findAllSources(mcpName: string): Promise<Array<{
+        marketplace: Marketplace;
+        metadata?: PhotonMetadata;
+        content?: string;
+    }>>;
+    /**
+     * Detect all MCP conflicts across marketplaces
+     */
+    detectAllConflicts(): Promise<Map<string, Array<{
+        marketplace: Marketplace;
+        metadata?: PhotonMetadata;
+    }>>>;
+    /**
+     * Check if adding/upgrading an MCP would create a conflict
+     */
+    checkConflict(mcpName: string, targetMarketplace?: string): Promise<{
+        hasConflict: boolean;
+        sources: Array<{
+            marketplace: Marketplace;
+            metadata?: PhotonMetadata;
+        }>;
+        recommendation?: string;
+    }>;
+    /**
+     * Compare two semver versions
+     * Returns: positive if v1 > v2, negative if v1 < v2, 0 if equal
+     */
+    private compareVersions;
+}
+//# sourceMappingURL=marketplace-manager.d.ts.map

package/dist/marketplace-manager.d.ts.map

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