aiden-shared-calculations-unified 1.0.7 → 1.0.8

package/calculations/socialPosts/social-asset-posts-trend.js

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Aggregates the total number of posts per asset (ticker).
+ * This data can be used for a time-series trend (AssetPostsTrend) or
+ * for a "Top Tickers" card.
+ * This calculation ONLY uses the social post insights context.
+ */
+
+class SocialAssetPostsTrend {
+    constructor() {
+        this.postsByTicker = {};
+        this.processed = false; // Flag to ensure this runs only once
+    }
+
+    /**
+     * @param {null} todayPortfolio - Not used.
+     * ... (other params not used) ...
+     * @param {object} todaySocialPostInsights - Map of { [postId]: postData } for today.
+     * @param {object} yesterdaySocialPostInsights - Not used.
+     */
+    async process(todayPortfolio, yesterdayPortfolio, userId, context, todayInsights, yesterdayInsights, todaySocialPostInsights, yesterdaySocialPostInsights) {
+        
+        if (this.processed || !todaySocialPostInsights) {
+            return;
+        }
+        this.processed = true;
+
+        const posts = Object.values(todaySocialPostInsights);
+
+        for (const post of posts) {
+            if (!post.tickers || !Array.isArray(post.tickers)) continue;
+
+            for (const ticker of post.tickers) {
+                // Ensure ticker is a string and valid
+                const validTicker = String(ticker).trim();
+                if (validTicker) {
+                    this.postsByTicker[validTicker] = (this.postsByTicker[validTicker] || 0) + 1;
+                }
+            }
+        }
+    }
+
+    async getResult() {
+        // Returns an object like: { "AAPL": 15, "TSLA": 22 }
+        return this.postsByTicker;
+    }
+
+    reset() {
+        this.postsByTicker = {};
+        this.processed = false;
+    }
+}
+
+module.exports = SocialAssetPostsTrend;

package/calculations/socialPosts/social-top-mentioned-words.js

@@ -0,0 +1,103 @@
+/**
+ * @fileoverview Finds the top mentioned words in all posts for the day,
+ * filtering out common stop words, and calculates the trend from yesterday.
+ * This calculation ONLY uses the social post insights context.
+ */
+
+class SocialTopMentionedWords {
+    constructor() {
+        this.todayWordCounts = {};
+        this.yesterdayWordCounts = {};
+        this.processed = false;
+
+        // A small, representative list of stop words.
+        // In a real implementation, this list would be much larger.
+        this.stopWords = new Set([
+            'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+            'have', 'has', 'had', 'do', 'does', 'did', 'but', 'if', 'or', 'and',
+            'of', 'at', 'by', 'for', 'with', 'about', 'to', 'from', 'in', 'on',
+            'it', 'i', 'me', 'my', 'you', 'your', 'he', 'she', 'we', 'they', 'them',
+            'this', 'that', 'these', 'those', 'what', 'which', 'who', 'whom',
+            'not', 'will', 'just', 'so', 'up', 'out', 'no', 'yes', 'all', 'any'
+        ]);
+    }
+
+    /**
+     * Helper to process posts and populate a word count map.
+     * @param {object} socialPostInsights - Map of { [postId]: postData }
+     * @param {object} targetCountMap - The object to store word counts.
+     */
+    _countWords(socialPostInsights, targetCountMap) {
+        if (!socialPostInsights) return;
+        const posts = Object.values(socialPostInsights);
+
+        for (const post of posts) {
+            const text = post.fullText?.toLowerCase() || '';
+            if (!text) continue;
+
+            // Get all words 3+ chars long
+            const words = text.match(/\b[a-z]{3,}\b/g) || [];
+
+            for (const word of words) {
+                if (!this.stopWords.has(word)) {
+                    targetCountMap[word] = (targetCountMap[word] || 0) + 1;
+                }
+            }
+        }
+    }
+
+    /**
+     * @param {object} todaySocialPostInsights - Map of { [postId]: postData } for today.
+     * @param {object} yesterdaySocialPostInsights - Map of { [postId]: postData } for yesterday.
+     */
+    async process(todayPortfolio, yesterdayPortfolio, userId, context, todayInsights, yesterdayInsights, todaySocialPostInsights, yesterdaySocialPostInsights) {
+        
+        if (this.processed) {
+            return;
+        }
+        this.processed = true;
+
+        // Process today's posts
+        this._countWords(todaySocialPostInsights, this.todayWordCounts);
+        
+        // Process yesterday's posts for trend calculation
+        this._countWords(yesterdaySocialPostInsights, this.yesterdayWordCounts);
+    }
+
+    async getResult() {
+        if (Object.keys(this.todayWordCounts).length === 0) {
+            return {};
+        }
+
+        const totalTodayWords = Object.values(this.todayWordCounts).reduce((a, b) => a + b, 0);
+
+        const topWords = Object.entries(this.todayWordCounts)
+            .sort(([, countA], [, countB]) => countB - countA)
+            .slice(0, 50); // Return the Top 50
+
+        const result = topWords.map(([term, count]) => {
+            const yesterdayCount = this.yesterdayWordCounts[term] || 0;
+            const trend = count - yesterdayCount;
+            const percent = (count / totalTodayWords) * 100;
+            
+            return {
+                term,
+                count,
+                percent: parseFloat(percent.toFixed(2)),
+                trend 
+            };
+        });
+
+        // Returns an array like:
+        // [ { term: "btc", count: 150, percent: 5.2, trend: 25 }, ... ]
+        return { top_words: result };
+    }
+
+    reset() {
+        this.todayWordCounts = {};
+        this.yesterdayWordCounts = {};
+        this.processed = false;
+    }
+}
+
+module.exports = SocialTopMentionedWords;

package/calculations/socialPosts/social-topic-interest-evolution.js

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Aggregates counts of all topics extracted by the AI
+ * from social posts for the day. Used to build a "Topic Interest Area" chart.
+ * This calculation ONLY uses the social post insights context.
+ */
+
+class SocialTopicInterestEvolution {
+    constructor() {
+        this.topicCounts = {};
+        this.processed = false;
+    }
+
+    /**
+     * @param {null} todayPortfolio - Not used.
+     * ... (other params not used) ...
+     * @param {object} todaySocialPostInsights - Map of { [postId]: postData } for today.
+     * @param {object} yesterdaySocialPostInsights - Not used.
+     */
+    async process(todayPortfolio, yesterdayPortfolio, userId, context, todayInsights, yesterdayInsights, todaySocialPostInsights, yesterdaySocialPostInsights) {
+        
+        if (this.processed || !todaySocialPostInsights) {
+            return;
+        }
+        this.processed = true;
+
+        const posts = Object.values(todaySocialPostInsights);
+
+        for (const post of posts) {
+            // Topics are in post.sentiment.topics
+            const topics = post.sentiment?.topics;
+            if (!topics || !Array.isArray(topics)) continue;
+
+            for (const topic of topics) {
+                // Normalize topic for consistent aggregation
+                const normalizedTopic = String(topic).toLowerCase().trim();
+                if (normalizedTopic) {
+                    this.topicCounts[normalizedTopic] = (this.topicCounts[normalizedTopic] || 0) + 1;
+                }
+            }
+        }
+    }
+
+    async getResult() {
+        // Returns an object like: { "earnings": 45, "cpi": 12, "fed": 22 }
+        return this.topicCounts;
+    }
+
+    reset() {
+        this.topicCounts = {};
+        this.processed = false;
+    }
+}
+
+module.exports = SocialTopicInterestEvolution;

package/calculations/socialPosts/social-word-mentions-trend.js

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview Tracks daily mentions of a pre-defined list of keywords.
+ * This calculation ONLY uses the social post insights context.
+ */
+
+class SocialWordMentionsTrend {
+    constructor() {
+        // A pre-defined list of keywords to track
+        this.KEYWORDS = [
+            'inflation', 'fed', 'fomc', 'cpi', 'earnings',
+            'recession', 'bullish', 'bearish', 'buy', 'sell',
+            'war', 'acquisition', 'ai'
+        ];
+        this.mentions = {};
+        this.processed = false;
+    }
+
+    /**
+     * @param {null} todayPortfolio - Not used.
+     * ... (other params not used) ...
+     * @param {object} todaySocialPostInsights - Map of { [postId]: postData } for today.
+     * @param {object} yesterdaySocialPostInsights - Not used.
+     */
+    async process(todayPortfolio, yesterdayPortfolio, userId, context, todayInsights, yesterdayInsights, todaySocialPostInsights, yesterdaySocialPostInsights) {
+        
+        if (this.processed || !todaySocialPostInsights) {
+            return;
+        }
+        this.processed = true;
+
+        // Initialize all keywords with 0 counts
+        this.mentions = this.KEYWORDS.reduce((acc, key) => {
+            acc[key] = 0;
+            return acc;
+        }, {});
+
+        const posts = Object.values(todaySocialPostInsights);
+
+        for (const post of posts) {
+            const text = post.fullText?.toLowerCase() || '';
+            if (!text) continue;
+
+            for (const keyword of this.KEYWORDS) {
+                // Count once per post, even if mentioned multiple times
+                if (text.includes(keyword)) {
+                    this.mentions[keyword]++;
+                }
+            }
+        }
+    }
+
+    async getResult() {
+        // Returns an object like: { "inflation": 5, "fed": 12, "ai": 30 }
+        return this.mentions;
+    }
+
+    reset() {
+        this.mentions = {};
+        this.processed = false;
+    }
+}
+
+module.exports = SocialWordMentionsTrend;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiden-shared-calculations-unified",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Shared calculation modules for the BullTrackers Computation System.",
   "main": "index.js",
   "files": [