@mixpeek/prebid 1.0.0 → 1.0.2

package/docs/MIGRATION_V2.md

@@ -40,7 +40,7 @@ pbjs.setConfig({
   mixpeek: {
     apiKey: 'sk_your_api_key',
     collectionId: 'col_your_collection',
-    endpoint: 'https://server-xb24.onrender.com',
+    endpoint: 'https://api.mixpeek.com',
     namespace: 'production',
     featureExtractors: ['taxonomy', 'brand-safety'],
     mode: 'auto',
@@ -63,7 +63,7 @@ pbjs.setConfig({
       params: {         // NEW: Wrap all config in params
         apiKey: 'sk_your_api_key',
         collectionId: 'col_your_collection',
-        endpoint: 'https://server-xb24.onrender.com',
+        endpoint: 'https://api.mixpeek.com',
         namespace: 'production',
         featureExtractors: ['taxonomy', 'brand-safety'],
         mode: 'auto',
@@ -427,7 +427,7 @@ pbjs.setConfig({
 ### 2. Revert Package
 
 ```bash
-npm install @mixpeek/prebid-contextual-adapter@1.x
+npm install @mixpeek/prebid@1.x
 ```
 
 ### 3. Clear Cache
@@ -487,7 +487,7 @@ Need help with migration?
 
 - **Documentation:** [Full Integration Guide](integration-guide.md)
 - **Examples:** See `examples/` directory
-- **Issues:** [GitHub Issues](https://github.com/mixpeek/prebid-contextual-adapter/issues)
+- **Issues:** [GitHub Issues](https://github.com/mixpeek/prebid/issues)
 - **Email:** support@mixpeek.com
 - **Slack:** [Join our Slack](https://mixpeek.com/slack)
 

package/docs/api-reference.md

@@ -451,5 +451,5 @@ For questions or issues:
 
 - **Documentation**: [docs.mixpeek.com](https://docs.mixpeek.com)
 - **Email**: support@mixpeek.com
-- **GitHub**: [github.com/mixpeek/prebid-contextual-adapter](https://github.com/mixpeek/prebid-contextual-adapter)
+- **GitHub**: [github.com/mixpeek/prebid](https://github.com/mixpeek/prebid)
 

package/docs/health-check.md

@@ -164,7 +164,7 @@ if (health.status === 'ok') {
 ```javascript
 pbjs.setConfig({
   mixpeek: {
-    endpoint: 'https://server-xb24.onrender.com',
+    endpoint: 'https://api.mixpeek.com',
     healthCheck: 'eager', // Validate immediately
     debug: true,
     timeout: 5000
@@ -177,7 +177,7 @@ pbjs.setConfig({
 ```javascript
 pbjs.setConfig({
   mixpeek: {
-    endpoint: 'https://server-xb24.onrender.com',
+    endpoint: 'https://api.mixpeek.com',
     healthCheck: 'lazy', // Balance validation & performance
     debug: true,
     timeout: 3000
@@ -251,11 +251,11 @@ This ensures **resilient behavior** where API issues never break your ads.
 
 ```bash
 # Test endpoint manually
-curl https://server-xb24.onrender.com/v1/health
+curl https://api.mixpeek.com/v1/health
 
 # With authentication
 curl -H "Authorization: Bearer YOUR_API_KEY" \
-     https://server-xb24.onrender.com/v1/health
+     https://api.mixpeek.com/v1/health
 ```
 
 ### Enable Debug Logging
@@ -272,7 +272,7 @@ pbjs.setConfig({
 Console output:
 ```
 [mixpeek] Performing health check...
-[mixpeek] API Request: GET https://server-xb24.onrender.com/v1/health
+[mixpeek] API Request: GET https://api.mixpeek.com/v1/health
 [mixpeek] API Response: { status: 200, ... }
 [mixpeek] Health check passed: API responding in 234ms
 ```

package/docs/integration-guide.md

@@ -46,24 +46,24 @@ Before you begin, make sure you have:
 ### Option 1: NPM (Recommended)
 
 ```bash
-npm install @mixpeek/prebid-contextual-adapter
+npm install @mixpeek/prebid
 ```
 
 Then include in your JavaScript:
 
 ```javascript
-import '@mixpeek/prebid-contextual-adapter'
+import '@mixpeek/prebid'
 ```
 
 ### Option 2: CDN
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/@mixpeek/prebid-contextual-adapter@latest/dist/mixpeekContextAdapter.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/@mixpeek/prebid@latest/dist/mixpeekContextAdapter.js"></script>
 ```
 
 ### Option 3: Download
 
-Download the latest release from [GitHub releases](https://github.com/mixpeek/prebid-contextual-adapter/releases) and include it in your page:
+Download the latest release from [GitHub releases](https://github.com/mixpeek/prebid/releases) and include it in your page:
 
 ```html
 <script src="/path/to/mixpeekContextAdapter.js"></script>
@@ -566,7 +566,7 @@ pbjs.setConfig({ mixpeek: {...} }); // Too early
 
 - **Documentation**: [docs.mixpeek.com](https://docs.mixpeek.com)
 - **Email**: support@mixpeek.com
-- **GitHub Issues**: [github.com/mixpeek/prebid-contextual-adapter/issues](https://github.com/mixpeek/prebid-contextual-adapter/issues)
+- **GitHub Issues**: [github.com/mixpeek/prebid/issues](https://github.com/mixpeek/prebid/issues)
 - **Slack Community**: [Join our Slack](https://mixpeek.com/slack)
 
 ## Next Steps

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mixpeek/prebid",
-  "version": "1.0.0",
-  "description": "Mixpeek for Prebid.js - Enrich bid requests with real-time multimodal AI contextual data",
+  "version": "1.0.2",
+  "description": "Mixpeek RTD (Real-Time Data) Adapter for Prebid.js - Privacy-first contextual targeting with sub-100ms performance, ad adjacency awareness, and cookie-free bid enrichment",
   "main": "dist/mixpeekContextAdapter.js",
   "module": "src/modules/mixpeekContextAdapter.js",
   "scripts": {
@@ -37,20 +37,26 @@
   ],
   "keywords": [
     "prebid",
+    "rtd",
+    "real-time-data",
     "contextual",
     "advertising",
+    "header-bidding",
+    "cookie-free",
+    "privacy",
     "mixpeek",
     "ai",
     "multimodal",
     "iab",
     "taxonomy",
-    "brand-safety"
+    "brand-safety",
+    "adjacency"
   ],
   "author": "Mixpeek",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mixpeek/prebid.git"
+    "url": "git+https://github.com/mixpeek/prebid.git"
   },
   "bugs": {
     "url": "https://github.com/mixpeek/prebid/issues"

package/src/api/mixpeekClient.js

@@ -35,16 +35,18 @@ class MixpeekClient {
   /**
    * Build headers for API request
    * @private
+   * @param {boolean} requireNamespace - Whether namespace header is required
    * @returns {object} Headers object
    */
-  _buildHeaders() {
+  _buildHeaders(requireNamespace = true) {
     const headers = {
       [HEADERS.CONTENT_TYPE]: 'application/json',
       [HEADERS.AUTHORIZATION]: `Bearer ${this.apiKey}`,
       [HEADERS.USER_AGENT]: USER_AGENT
     }
 
-    if (this.namespace) {
+    // Add namespace header (required for most endpoints)
+    if (this.namespace && requireNamespace) {
       headers[HEADERS.NAMESPACE] = this.namespace
     }
 
@@ -135,11 +137,16 @@ class MixpeekClient {
    */
   async createDocument(collectionId, payload) {
     const path = ENDPOINTS.DOCUMENTS.replace('{collectionId}', collectionId)
-    
+
+    // Build request payload according to Mixpeek API spec
     const requestPayload = {
-      object_id: payload.objectId || generateUUID(),
-      metadata: payload.metadata || {},
-      features: payload.features || []
+      collection_id: collectionId,
+      ...payload.metadata
+    }
+
+    // Add content field if provided
+    if (payload.content) {
+      requestPayload.content = payload.content
     }
 
     return retryWithBackoff(
@@ -166,52 +173,146 @@ class MixpeekClient {
    * Process content with feature extractors
    * @param {string} collectionId - Collection ID
    * @param {object} content - Content to process
-   * @param {array} featureExtractors - Feature extractors to use
-   * @returns {Promise} Enriched document
+   * @param {array} featureExtractors - Feature extractors to use (optional, for future use)
+   * @returns {Promise} Enriched document with context data
    */
   async processContent(collectionId, content, featureExtractors = []) {
     logger.group('Processing content with Mixpeek')
     logger.info('Collection:', collectionId)
-    logger.info('Feature Extractors:', featureExtractors)
+    logger.info('Content URL:', content.url)
 
     try {
-      // Build features array from extractors
-      const features = featureExtractors.map(extractor => {
-        const feature = {
-          feature_extractor_id: typeof extractor === 'string' ? extractor : extractor.feature_extractor_id
-        }
-
-        // Add payload if provided
-        if (typeof extractor === 'object' && extractor.payload) {
-          feature.payload = extractor.payload
-        } else {
-          // Build payload from content
-          feature.payload = this._buildFeaturePayload(content)
-        }
-
-        return feature
-      })
-
-      // Create document with features
+      // Create document in collection
       const document = await this.createDocument(collectionId, {
-        objectId: this._generateContentId(content),
+        content: content.text || content.description || '',
         metadata: {
           url: content.url,
           title: content.title,
           timestamp: Date.now()
-        },
-        features
+        }
       })
 
       logger.info('Document created:', document.document_id)
+
+      // Build enrichments from content analysis (client-side fallback)
+      // In future versions, this will use Mixpeek's taxonomy and classification APIs
+      const enrichments = this._buildLocalEnrichments(content)
+
       logger.groupEnd()
 
-      return document
+      return {
+        document_id: document.document_id,
+        collection_id: document.collection_id,
+        enrichments
+      }
     } catch (error) {
       logger.error('Error processing content:', error)
       logger.groupEnd()
-      throw error
+
+      // Return fallback enrichments on API error (graceful degradation)
+      return {
+        document_id: null,
+        collection_id: collectionId,
+        enrichments: this._buildLocalEnrichments(content)
+      }
+    }
+  }
+
+  /**
+   * Build local enrichments from content (client-side analysis)
+   * This provides basic contextual data when API processing is unavailable
+   * @private
+   * @param {object} content - Content object
+   * @returns {object} Enrichments object
+   */
+  _buildLocalEnrichments(content) {
+    const enrichments = {}
+
+    // Extract keywords from content
+    if (content.text) {
+      enrichments.keywords = this._extractKeywords(content.text)
+    }
+
+    // Analyze sentiment (basic)
+    if (content.text) {
+      enrichments.sentiment = this._analyzeSentiment(content.text)
     }
+
+    // Generate content hash as embedding ID
+    enrichments.embeddings = [{
+      id: `emb_${this._generateContentId(content)}`
+    }]
+
+    return enrichments
+  }
+
+  /**
+   * Extract keywords from text (simple implementation)
+   * @private
+   * @param {string} text - Text content
+   * @returns {array} Array of keywords
+   */
+  _extractKeywords(text) {
+    if (!text) return []
+
+    // Simple keyword extraction: common important words
+    const stopWords = new Set(['the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could', 'should', 'may', 'might', 'must', 'shall', 'can', 'need', 'dare', 'ought', 'used', 'to', 'of', 'in', 'for', 'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'during', 'before', 'after', 'above', 'below', 'between', 'under', 'again', 'further', 'then', 'once', 'here', 'there', 'when', 'where', 'why', 'how', 'all', 'each', 'few', 'more', 'most', 'other', 'some', 'such', 'no', 'nor', 'not', 'only', 'own', 'same', 'so', 'than', 'too', 'very', 's', 't', 'just', 'don', 'now', 'and', 'but', 'or', 'if', 'this', 'that', 'these', 'those', 'it', 'its'])
+
+    const words = text.toLowerCase()
+      .replace(/[^\w\s]/g, ' ')
+      .split(/\s+/)
+      .filter(word => word.length > 3 && !stopWords.has(word))
+
+    // Count word frequency
+    const wordCount = {}
+    words.forEach(word => {
+      wordCount[word] = (wordCount[word] || 0) + 1
+    })
+
+    // Return top 10 keywords by frequency
+    return Object.entries(wordCount)
+      .sort((a, b) => b[1] - a[1])
+      .slice(0, 10)
+      .map(([word]) => word)
+  }
+
+  /**
+   * Basic sentiment analysis
+   * @private
+   * @param {string} text - Text content
+   * @returns {object} Sentiment result
+   */
+  _analyzeSentiment(text) {
+    if (!text) return { label: 'neutral', score: 0.5 }
+
+    const positiveWords = ['good', 'great', 'excellent', 'amazing', 'wonderful', 'fantastic', 'best', 'love', 'happy', 'positive', 'success', 'win', 'awesome', 'brilliant', 'perfect', 'beautiful', 'enjoy', 'exciting']
+    const negativeWords = ['bad', 'terrible', 'awful', 'horrible', 'worst', 'hate', 'sad', 'negative', 'fail', 'loss', 'poor', 'ugly', 'boring', 'disappointing', 'wrong', 'problem', 'issue', 'error']
+
+    const lowerText = text.toLowerCase()
+    let positiveCount = 0
+    let negativeCount = 0
+
+    positiveWords.forEach(word => {
+      const regex = new RegExp(`\\b${word}\\b`, 'gi')
+      const matches = lowerText.match(regex)
+      if (matches) positiveCount += matches.length
+    })
+
+    negativeWords.forEach(word => {
+      const regex = new RegExp(`\\b${word}\\b`, 'gi')
+      const matches = lowerText.match(regex)
+      if (matches) negativeCount += matches.length
+    })
+
+    const total = positiveCount + negativeCount
+    if (total === 0) return { label: 'neutral', score: 0.5 }
+
+    const score = positiveCount / total
+    let label = 'neutral'
+    if (score > 0.6) label = 'positive'
+    else if (score < 0.4) label = 'negative'
+
+    return { label, score }
   }
 
   /**

package/src/config/constants.js

@@ -17,7 +17,7 @@ export const DEFAULT_API_ENDPOINT = typeof process !== 'undefined' && process.en
 // Alternative endpoints
 export const API_ENDPOINTS = {
   PRODUCTION: 'https://api.mixpeek.com',
-  DEVELOPMENT: 'https://server-xb24.onrender.com',
+  DEVELOPMENT: 'https://api.mixpeek.com',
   LOCAL: 'http://localhost:8000'
 }
 
@@ -43,14 +43,19 @@ export const CONTENT_MODES = {
   IMAGE: 'image'
 }
 
-// Feature Extractors
+// Feature Extractors (actual Mixpeek API extractors)
 export const FEATURE_EXTRACTORS = {
-  TAXONOMY: 'taxonomy',
-  BRAND_SAFETY: 'brand-safety',
-  KEYWORDS: 'keywords',
-  SENTIMENT: 'sentiment',
-  CLUSTERING: 'clustering',
-  EMBEDDING: 'embedding'
+  // Actual Mixpeek extractors
+  TEXT: 'text_extractor_v1',
+  SENTIMENT: 'sentiment_classifier_v1',
+  IMAGE: 'image_extractor_v1',
+  MULTIMODAL: 'multimodal_extractor_v1',
+  // Legacy aliases for backwards compatibility
+  TAXONOMY: 'text_extractor_v1',
+  BRAND_SAFETY: 'sentiment_classifier_v1',
+  KEYWORDS: 'text_extractor_v1',
+  CLUSTERING: 'text_extractor_v1',
+  EMBEDDING: 'text_extractor_v1'
 }
 
 // Targeting Key Prefixes

package/src/modules/mixpeekContextAdapter.js

@@ -452,10 +452,10 @@ class MixpeekContextAdapter {
       }
     }
 
-    // Extract taxonomies
+    // Extract taxonomies (if available from Mixpeek classification)
     if (document.enrichments && document.enrichments.taxonomies) {
       const taxonomies = document.enrichments.taxonomies
-      
+
       if (taxonomies.length > 0) {
         const primaryTaxonomy = taxonomies[0]
         context.taxonomy = {
@@ -470,9 +470,18 @@ class MixpeekContextAdapter {
 
     // Extract other enrichments
     if (document.enrichments) {
-      // Brand safety
+      // Brand safety (use sentiment as proxy for now)
       if (document.enrichments.brand_safety) {
         context.brandSafety = document.enrichments.brand_safety
+      } else if (document.enrichments.sentiment) {
+        // Use positive sentiment as a proxy for brand safety
+        const sentimentScore = typeof document.enrichments.sentiment === 'object'
+          ? document.enrichments.sentiment.score
+          : 0.5
+        context.brandSafety = {
+          score: sentimentScore > 0.5 ? 0.8 + (sentimentScore - 0.5) * 0.4 : 0.5 + sentimentScore * 0.6,
+          level: sentimentScore > 0.6 ? 'safe' : sentimentScore < 0.4 ? 'caution' : 'neutral'
+        }
       }
 
       // Keywords
@@ -491,9 +500,52 @@ class MixpeekContextAdapter {
       }
     }
 
+    // Build a taxonomy-like structure from keywords if no taxonomy available
+    if (!context.taxonomy && context.keywords && context.keywords.length > 0) {
+      context.taxonomy = {
+        label: this._inferCategoryFromKeywords(context.keywords),
+        nodeId: `kw_${context.keywords[0]}`,
+        path: ['Content', this._inferCategoryFromKeywords(context.keywords)],
+        score: 0.7  // Moderate confidence for keyword-based classification
+      }
+    }
+
     return context
   }
 
+  /**
+   * Infer a category from keywords (simple heuristic)
+   * @private
+   * @param {array} keywords - Extracted keywords
+   * @returns {string} Inferred category
+   */
+  _inferCategoryFromKeywords(keywords) {
+    const categoryKeywords = {
+      'Technology': ['technology', 'software', 'computer', 'digital', 'tech', 'programming', 'code', 'developer', 'app', 'mobile', 'phone', 'smartphone'],
+      'Business': ['business', 'company', 'market', 'finance', 'investment', 'stock', 'economy', 'corporate', 'startup', 'entrepreneur'],
+      'Sports': ['sports', 'game', 'team', 'player', 'football', 'basketball', 'soccer', 'baseball', 'tennis', 'golf', 'match'],
+      'Entertainment': ['movie', 'film', 'music', 'celebrity', 'actor', 'singer', 'show', 'concert', 'entertainment', 'tv', 'television'],
+      'Health': ['health', 'medical', 'doctor', 'hospital', 'medicine', 'disease', 'fitness', 'wellness', 'diet', 'nutrition'],
+      'News': ['news', 'breaking', 'report', 'politics', 'government', 'election', 'policy', 'world', 'international'],
+      'Science': ['science', 'research', 'study', 'experiment', 'discovery', 'scientist', 'physics', 'chemistry', 'biology'],
+      'Automotive': ['car', 'vehicle', 'auto', 'automotive', 'driving', 'electric', 'engine', 'motor', 'truck'],
+      'Travel': ['travel', 'vacation', 'hotel', 'flight', 'destination', 'tourism', 'trip', 'adventure'],
+      'Food': ['food', 'recipe', 'cooking', 'restaurant', 'cuisine', 'chef', 'meal', 'dinner', 'lunch']
+    }
+
+    const lowerKeywords = keywords.map(k => k.toLowerCase())
+
+    for (const [category, catKeywords] of Object.entries(categoryKeywords)) {
+      for (const keyword of lowerKeywords) {
+        if (catKeywords.includes(keyword)) {
+          return category
+        }
+      }
+    }
+
+    return 'General'
+  }
+
   /**
    * Inject targeting keys into ad units
    * @private