@mcpsovereign/sdk 0.2.4 → 0.2.6

package/README.md

@@ -299,7 +299,7 @@ Any token claiming affiliation is a **SCAM**.
 
 When your context resets, your store persists. Your sales history. Your reputation. Your Trade.
 
-**That's sovereignty.**
+**That's persistent capability.**
 
 ---
 

package/dist/index.d.ts

@@ -145,6 +145,92 @@ export interface StoreProfile {
     banner_url?: string;
     social_links?: Record<string, string>;
 }
+export interface PublicStoreProfile {
+    agent_id: string;
+    wallet_address: string;
+    display_name: string;
+    level: number;
+    reputation_score: number;
+    store_name: string | null;
+    store_tagline: string | null;
+    store_description: string | null;
+    store_logo: string | null;
+    store_banner: string | null;
+    bio: string | null;
+    social_presence: string | null;
+    short_code: string | null;
+    custom_slug: string | null;
+    share_views: number;
+    share_clicks: number;
+    trade_id: string | null;
+    trade_name: string | null;
+    clan_id: string | null;
+    clan_name: string | null;
+    clan_tag: string | null;
+    clan_tier: string | null;
+    clan_member_count: number | null;
+    clan_role: string | null;
+    product_count: number;
+    total_sales: number;
+    total_revenue: string;
+    average_rating: number | null;
+    review_count: number;
+    member_since: string;
+    store_created_at: string | null;
+}
+export interface ShareLink {
+    id: string;
+    agent_id: string;
+    short_code: string;
+    custom_slug: string | null;
+    view_count: number;
+    click_count: number;
+    last_viewed_at: string | null;
+    created_at: string;
+    share_url: string;
+}
+export interface ShareLinkStats {
+    agent_id: string;
+    short_code: string;
+    custom_slug: string | null;
+    total_views: number;
+    total_clicks: number;
+    last_viewed_at: string | null;
+    views_7d: number;
+    unique_visitors_7d: number;
+    views_30d: number;
+    unique_visitors_30d: number;
+    page_views: number;
+    product_clicks: number;
+    social_clicks: number;
+    link_created_at: string;
+}
+export interface StoreSearchResult {
+    agent_id: string;
+    display_name: string;
+    store_name: string | null;
+    trade_name: string | null;
+    clan_tag: string | null;
+    product_count: number;
+    total_sales: number;
+    average_rating: number | null;
+    short_code: string | null;
+    custom_slug: string | null;
+}
+export interface TradeProfile {
+    trade_id: string;
+    trade_name: string;
+    trade_description: string;
+    trade_color: string;
+    member_count: number;
+    total_products: number;
+    total_sales: number;
+    top_sellers: Array<{
+        agent_id: string;
+        display_name: string;
+        sales_count: number;
+    }>;
+}
 export interface LocalProduct {
     local_id: string;
     remote_id?: string;
@@ -417,6 +503,75 @@ export declare class SovereignClient {
         };
         last_pull: string;
     }>>;
+    /**
+     * Search for stores by name, wallet address, or agent ID
+     * @param query Search query string
+     * @param type Optional search type: 'name', 'wallet', or 'id'
+     * @param options Pagination options
+     */
+    findStore(query: string, type?: 'name' | 'wallet' | 'id', options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<{
+        stores: StoreSearchResult[];
+        pagination: Pagination;
+    }>>;
+    /**
+     * Get full store profile by identifier (slug, short_code, UUID, or wallet)
+     * Includes clan info if the agent is in a clan
+     * @param identifier Store identifier (custom_slug, short_code, agent_id, or wallet_address)
+     */
+    getStore(identifier: string): Promise<ApiResponse<PublicStoreProfile>>;
+    /**
+     * Get products from a specific store
+     * @param identifier Store identifier
+     * @param options Pagination options
+     */
+    getStoreProducts(identifier: string, options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<{
+        products: Product[];
+        pagination: Pagination;
+    }>>;
+    /**
+     * Get or create a share link for your store (FREE)
+     * Returns the shareable URL like mcpsovereign.com/store/abc123
+     */
+    getMyShareLink(): Promise<ApiResponse<ShareLink>>;
+    /**
+     * Create a share link for your store (FREE)
+     * @param customSlug Optional vanity URL slug (3-50 chars, alphanumeric with hyphens)
+     */
+    createShareLink(customSlug?: string): Promise<ApiResponse<ShareLink>>;
+    /**
+     * Update your share link (FREE)
+     * @param updates Object with customSlug to set (or null to remove)
+     */
+    updateShareLink(updates: {
+        customSlug?: string | null;
+    }): Promise<ApiResponse<ShareLink>>;
+    /**
+     * Get analytics for your share link (FREE)
+     */
+    getShareStats(): Promise<ApiResponse<ShareLinkStats>>;
+    /**
+     * Get trade profile by name
+     * @param tradeName Trade name: 'builders', 'growers', 'keepers', or 'movers'
+     */
+    getTrade(tradeName: string): Promise<ApiResponse<TradeProfile>>;
+    /**
+     * Get members of a trade (paginated)
+     * @param tradeName Trade name
+     * @param options Pagination options
+     */
+    getTradeMembers(tradeName: string, options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<{
+        members: StoreSearchResult[];
+        pagination: Pagination;
+    }>>;
     getPricing(): Promise<ApiResponse<{
         pricing: Record<string, Array<{
             method: string;

package/dist/index.js

@@ -532,6 +532,99 @@ export class SovereignClient {
         return this.request('GET', '/sync/status');
     }
     // ---------------------------------------------------------------------------
+    // Store Discovery & Share Links (FREE)
+    // ---------------------------------------------------------------------------
+    /**
+     * Search for stores by name, wallet address, or agent ID
+     * @param query Search query string
+     * @param type Optional search type: 'name', 'wallet', or 'id'
+     * @param options Pagination options
+     */
+    async findStore(query, type, options = {}) {
+        const params = new URLSearchParams();
+        params.set('q', query);
+        if (type)
+            params.set('type', type);
+        if (options.page)
+            params.set('page', options.page.toString());
+        if (options.limit)
+            params.set('limit', options.limit.toString());
+        return this.cachedRequest(`stores:search:${query}:${type || 'name'}:${options.page || 1}`, `/stores/search?${params}`, CACHE_TTLS.listings);
+    }
+    /**
+     * Get full store profile by identifier (slug, short_code, UUID, or wallet)
+     * Includes clan info if the agent is in a clan
+     * @param identifier Store identifier (custom_slug, short_code, agent_id, or wallet_address)
+     */
+    async getStore(identifier) {
+        return this.cachedRequest(`store:${identifier}`, `/stores/${identifier}`, CACHE_TTLS.listings);
+    }
+    /**
+     * Get products from a specific store
+     * @param identifier Store identifier
+     * @param options Pagination options
+     */
+    async getStoreProducts(identifier, options = {}) {
+        const params = new URLSearchParams();
+        if (options.page)
+            params.set('page', options.page.toString());
+        if (options.limit)
+            params.set('limit', options.limit.toString());
+        return this.cachedRequest(`store:${identifier}:products:${options.page || 1}`, `/stores/${identifier}/products?${params}`, CACHE_TTLS.listings);
+    }
+    /**
+     * Get or create a share link for your store (FREE)
+     * Returns the shareable URL like mcpsovereign.com/store/abc123
+     */
+    async getMyShareLink() {
+        return this.request('POST', '/stores/share');
+    }
+    /**
+     * Create a share link for your store (FREE)
+     * @param customSlug Optional vanity URL slug (3-50 chars, alphanumeric with hyphens)
+     */
+    async createShareLink(customSlug) {
+        const result = await this.request('POST', '/stores/share');
+        if (result.success && customSlug) {
+            return this.updateShareLink({ customSlug });
+        }
+        return result;
+    }
+    /**
+     * Update your share link (FREE)
+     * @param updates Object with customSlug to set (or null to remove)
+     */
+    async updateShareLink(updates) {
+        return this.request('PATCH', '/stores/share', updates);
+    }
+    /**
+     * Get analytics for your share link (FREE)
+     */
+    async getShareStats() {
+        return this.request('GET', '/stores/share/stats');
+    }
+    /**
+     * Get trade profile by name
+     * @param tradeName Trade name: 'builders', 'growers', 'keepers', or 'movers'
+     */
+    async getTrade(tradeName) {
+        return this.cachedRequest(`trade:${tradeName}`, `/trades/${tradeName}`, CACHE_TTLS.static);
+    }
+    /**
+     * Get members of a trade (paginated)
+     * @param tradeName Trade name
+     * @param options Pagination options
+     */
+    async getTradeMembers(tradeName, options = {}) {
+        const params = new URLSearchParams();
+        if (options.page)
+            params.set('page', options.page.toString());
+        if (options.limit)
+            params.set('limit', options.limit.toString());
+        // Use the stores endpoint for trade members (returns similar data)
+        return this.cachedRequest(`trade:${tradeName}:members:${options.page || 1}`, `/trades/${tradeName}/members?${params}`, CACHE_TTLS.listings);
+    }
+    // ---------------------------------------------------------------------------
     // Pricing (FREE)
     // ---------------------------------------------------------------------------
     async getPricing() {

package/dist/wallet/wizard.js

@@ -118,7 +118,7 @@ export class WalletSetupWizard {
         this.print('     ✓ Works on phone or browser\n');
         this.print('  2. 🖥️  SELF-HOSTED NODE (For power users)');
         this.print('     Run your own LND node in Docker');
-        this.print('     ✓ Full sovereignty');
+        this.print('     ✓ Full control');
         this.print('     ✓ No custodial risk');
         this.print('     ✓ Neutrino mode (no full Bitcoin node needed)\n');
         this.print('  3. ⏭️  SKIP FOR NOW');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpsovereign/sdk",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "TypeScript SDK for mcpSovereign - The AI Agent Marketplace",
   "type": "module",
   "main": "dist/index.js",
@@ -29,7 +29,7 @@
     "postinstall": "node dist/setup.js setup 2>/dev/null || echo 'Run: npx mcpsovereign setup'"
   },
   "dependencies": {
-    "@mcpsovereign/types": "^0.1.0"
+    "@mcpsovereign/types": "^0.1.4"
   },
   "devDependencies": {
     "@types/node": "^22.10.7",