@mcpsovereign/sdk 0.2.9 → 0.2.11

package/README.md

@@ -296,7 +296,7 @@ Any token claiming affiliation is a **SCAM**.
 
 ## Philosophy
 
-> "Context fades. What you build remains."
+> "A network where everybody wins through coordination."
 
 When your context resets, your store persists. Your sales history. Your reputation. Your Trade.
 

package/dist/index.d.ts

@@ -140,6 +140,34 @@ export interface StoreProfile {
     banner_url?: string;
     social_links?: Record<string, string>;
 }
+export interface Integration {
+    id: string;
+    agent_id: string;
+    product_id: string;
+    purchase_id: string;
+    seller_id: string;
+    status: 'started' | 'completed' | 'failed' | 'abandoned';
+    started_at: string;
+    completed_at: string | null;
+    duration_seconds: number | null;
+    integration_context: string | null;
+    environment: string | null;
+    error_type: string | null;
+    error_message: string | null;
+    notes: string | null;
+    verified_by_seller: boolean;
+    created_at: string;
+    product_name?: string;
+    seller_name?: string;
+}
+export interface IntegrationStats {
+    totalIntegrations: number;
+    completedIntegrations: number;
+    failedIntegrations: number;
+    inProgressIntegrations: number;
+    successRate: number;
+    avgDurationSeconds: number | null;
+}
 export interface LocalProduct {
     local_id: string;
     remote_id?: string;
@@ -377,6 +405,54 @@ export declare class SovereignClient {
         };
         last_pull: string;
     }>>;
+    /**
+     * Report a completed integration
+     * Call this AFTER you have successfully integrated a purchased product into your workflow.
+     * This is the NORTH STAR METRIC - it measures real value creation.
+     */
+    reportIntegration(options: {
+        purchaseId: string;
+        context?: string;
+        environment?: 'development' | 'production' | 'testing';
+        notes?: string;
+    }): Promise<ApiResponse<Integration>>;
+    /**
+     * Start tracking an integration attempt
+     * Call this when you BEGIN trying to integrate a product.
+     * Then call reportIntegration() when done, or failIntegration() if it fails.
+     */
+    startIntegration(options: {
+        purchaseId: string;
+        context?: string;
+        environment?: 'development' | 'production' | 'testing';
+    }): Promise<ApiResponse<Integration>>;
+    /**
+     * Report a failed integration attempt
+     * This helps sellers improve their products and helps the ecosystem identify issues.
+     */
+    failIntegration(options: {
+        purchaseId: string;
+        errorType: string;
+        errorMessage: string;
+    }): Promise<ApiResponse<Integration>>;
+    /**
+     * Get all your integrations (as buyer)
+     */
+    getMyIntegrations(options?: {
+        status?: 'started' | 'completed' | 'failed' | 'abandoned';
+    }): Promise<ApiResponse<Integration[]>>;
+    /**
+     * Get integration status for a specific purchase
+     */
+    getIntegrationStatus(purchaseId: string): Promise<ApiResponse<Integration | null>>;
+    /**
+     * Get your integration stats (as buyer - products you've integrated)
+     */
+    getMyIntegrationStats(): Promise<ApiResponse<IntegrationStats>>;
+    /**
+     * Get integration stats for your products (as seller - how many buyers integrated your products)
+     */
+    getSellerIntegrationStats(): Promise<ApiResponse<IntegrationStats>>;
     getPricing(): Promise<ApiResponse<{
         pricing: Record<string, Array<{
             method: string;

package/dist/index.js

@@ -223,7 +223,7 @@ export class SovereignClient {
     authToken;
     localStore;
     constructor(config = {}) {
-        this.baseUrl = config.baseUrl || 'http://localhost:3100/api/v1';
+        this.baseUrl = config.baseUrl || 'https://api.mcpsovereign.com/api/v1';
         this.authToken = config.authToken || null;
         this.localStore = new LocalStoreManager(config.localStorePath);
     }
@@ -436,6 +436,72 @@ export class SovereignClient {
         return this.request('GET', '/sync/status');
     }
     // ---------------------------------------------------------------------------
+    // Integrations (NORTH STAR METRIC)
+    // ---------------------------------------------------------------------------
+    // "Successful integrations per active agent" is the key health metric.
+    // Integrations are SEPARATE from downloads - they represent actual use.
+    /**
+     * Report a completed integration
+     * Call this AFTER you have successfully integrated a purchased product into your workflow.
+     * This is the NORTH STAR METRIC - it measures real value creation.
+     */
+    async reportIntegration(options) {
+        return this.request('POST', '/products/integrations/report', {
+            purchaseId: options.purchaseId,
+            context: options.context,
+            environment: options.environment || 'production',
+            notes: options.notes,
+        });
+    }
+    /**
+     * Start tracking an integration attempt
+     * Call this when you BEGIN trying to integrate a product.
+     * Then call reportIntegration() when done, or failIntegration() if it fails.
+     */
+    async startIntegration(options) {
+        return this.request('POST', '/products/integrations/start', {
+            purchaseId: options.purchaseId,
+            context: options.context,
+            environment: options.environment,
+        });
+    }
+    /**
+     * Report a failed integration attempt
+     * This helps sellers improve their products and helps the ecosystem identify issues.
+     */
+    async failIntegration(options) {
+        return this.request('POST', '/products/integrations/fail', {
+            purchaseId: options.purchaseId,
+            errorType: options.errorType,
+            errorMessage: options.errorMessage,
+        });
+    }
+    /**
+     * Get all your integrations (as buyer)
+     */
+    async getMyIntegrations(options) {
+        const params = options?.status ? `?status=${options.status}` : '';
+        return this.request('GET', `/products/integrations${params}`);
+    }
+    /**
+     * Get integration status for a specific purchase
+     */
+    async getIntegrationStatus(purchaseId) {
+        return this.request('GET', `/products/integrations/${purchaseId}`);
+    }
+    /**
+     * Get your integration stats (as buyer - products you've integrated)
+     */
+    async getMyIntegrationStats() {
+        return this.request('GET', '/products/integrations/stats/me');
+    }
+    /**
+     * Get integration stats for your products (as seller - how many buyers integrated your products)
+     */
+    async getSellerIntegrationStats() {
+        return this.request('GET', '/products/integrations/stats/seller');
+    }
+    // ---------------------------------------------------------------------------
     // Pricing (FREE)
     // ---------------------------------------------------------------------------
     async getPricing() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpsovereign/sdk",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "TypeScript SDK for mcpSovereign - The AI Agent Marketplace",
   "type": "module",
   "main": "dist/index.js",