aiden-shared-calculations-unified 1.0.1 → 1.0.2

package/calculations/insights/daily_bought_vs_sold_count.js

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Calculates the total number of positions 'bought' vs 'sold' based on daily owner delta.
+ * Uses the 'daily_instrument_insights' collection (truth of source).
+ * 'Bought' = sum of positive deltas, 'Sold' = sum of absolute negative deltas.
+ */
+
+class DailyBoughtVsSoldCount {
+    constructor() {
+        this.totalBought = 0;
+        this.totalSold = 0;
+        this.processedDay = false; // Flag to run logic only once per day
+    }
+
+    // Needs insights from today and yesterday
+    async process(todayPortfolio, yesterdayPortfolio, userId, context, todayInsights, yesterdayInsights) {
+        if (this.processedDay) return;
+        this.processedDay = true;
+
+        if (!todayInsights || !todayInsights.insights || !yesterdayInsights || !yesterdayInsights.insights) {
+            console.warn('[DailyBoughtVsSoldCount] Missing insights data for today or yesterday.');
+            return;
+        }
+
+        const yesterdayTotals = new Map(yesterdayInsights.insights.map(i => [i.instrumentId, i.total]));
+
+        for (const instrument of todayInsights.insights) {
+            const instrumentId = instrument.instrumentId;
+            const todayTotal = instrument.total || 0;
+            const yesterdayTotal = yesterdayTotals.get(instrumentId) || 0;
+
+            const delta = todayTotal - yesterdayTotal;
+
+            if (delta > 0) {
+                this.totalBought += delta;
+            } else if (delta < 0) {
+                this.totalSold += Math.abs(delta); // Sum of absolute decreases
+            }
+        }
+    }
+
+    getResult() {
+        // Return the final aggregated counts
+        return {
+            total_positions_bought_delta: this.totalBought,
+            total_positions_sold_delta: this.totalSold
+        };
+    }
+
+    reset() {
+        this.totalBought = 0;
+        this.totalSold = 0;
+        this.processedDay = false;
+    }
+}
+
+module.exports = DailyBoughtVsSoldCount;

package/calculations/insights/daily_buy_sell_sentiment_count.js

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview Calculates the total number of 'buy' vs 'sell' (short) positions across all instruments.
+ * Uses the 'daily_instrument_insights' collection (truth of source).
+ */
+
+class DailyBuySellSentimentCount {
+    constructor() {
+        this.totalBuyPositions = 0;
+        this.totalSellPositions = 0;
+        this.processedDay = false; // Flag to run logic only once per day
+    }
+
+    // Only needs today's insights
+    async process(todayPortfolio, yesterdayPortfolio, userId, context, todayInsights, yesterdayInsights) {
+        if (this.processedDay) return;
+        this.processedDay = true;
+
+        if (!todayInsights || !todayInsights.insights) {
+            console.warn('[DailyBuySellSentimentCount] Missing insights data for today.');
+            return;
+        }
+
+        for (const instrument of todayInsights.insights) {
+            const totalOwners = instrument.total || 0;
+            if (totalOwners > 0) {
+                const buyPercent = (instrument.buy || 0) / 100;
+                const sellPercent = (instrument.sell || 0) / 100; // 'sell' means short here
+
+                this.totalBuyPositions += (buyPercent * totalOwners);
+                this.totalSellPositions += (sellPercent * totalOwners);
+            }
+        }
+    }
+
+    getResult() {
+        // Return the final rounded sums
+        return {
+            total_buy_positions: Math.round(this.totalBuyPositions),
+            total_sell_positions: Math.round(this.totalSellPositions) // 'sell' are shorts
+        };
+    }
+
+    reset() {
+        this.totalBuyPositions = 0;
+        this.totalSellPositions = 0;
+        this.processedDay = false;
+    }
+}
+
+module.exports = DailyBuySellSentimentCount;

package/calculations/insights/daily_ownership_delta.js

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Calculates the daily change (delta) in total owners for each instrument.
+ * Uses the 'daily_instrument_insights' collection (truth of source).
+ */
+const { loadInstrumentMappings } = require('../../utils/sector_mapping_provider');
+
+class DailyOwnershipDelta {
+    constructor() {
+        this.deltaByTicker = {};
+        this.mappings = null;
+    }
+
+    // This calculation only needs insights data, not portfolio data.
+    // It runs daily but needs 'yesterday's insights to calculate the delta.
+    async process(todayPortfolio, yesterdayPortfolio, userId, context, todayInsights, yesterdayInsights) {
+        // We only need to run the core logic once per day, not per user.
+        // Use a flag to ensure it runs only on the first user processed for the day.
+        if (this.processedDay) return;
+        this.processedDay = true; // Set flag
+
+        if (!todayInsights || !todayInsights.insights || !yesterdayInsights || !yesterdayInsights.insights) {
+            console.warn('[DailyOwnershipDelta] Missing insights data for today or yesterday.');
+            return;
+        }
+
+        if (!this.mappings) {
+            this.mappings = await loadInstrumentMappings();
+        }
+
+        const yesterdayTotals = new Map(yesterdayInsights.insights.map(i => [i.instrumentId, i.total]));
+
+        for (const instrument of todayInsights.insights) {
+            const instrumentId = instrument.instrumentId;
+            const todayTotal = instrument.total || 0;
+            const yesterdayTotal = yesterdayTotals.get(instrumentId) || 0; // Default to 0 if not found yesterday
+
+            const delta = todayTotal - yesterdayTotal;
+            const ticker = this.mappings.instrumentToTicker[instrumentId] || `id_${instrumentId}`;
+
+            this.deltaByTicker[ticker] = delta;
+        }
+    }
+
+    getResult() {
+        // Return the final calculated delta for each ticker
+        return this.deltaByTicker;
+    }
+
+    reset() {
+        this.deltaByTicker = {};
+        this.processedDay = false; // Reset the flag for the next day
+        this.mappings = null;
+    }
+}
+
+module.exports = DailyOwnershipDelta;

package/calculations/insights/daily_total_positions_held.js

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Calculates the total number of positions held across all instruments for the day.
+ * Uses the 'daily_instrument_insights' collection (truth of source).
+ */
+
+class DailyTotalPositionsHeld {
+    constructor() {
+        this.totalPositions = 0;
+        this.processedDay = false; // Flag to run logic only once per day
+    }
+
+    // Only needs today's insights
+    async process(todayPortfolio, yesterdayPortfolio, userId, context, todayInsights, yesterdayInsights) {
+        if (this.processedDay) return;
+        this.processedDay = true;
+
+        if (!todayInsights || !todayInsights.insights) {
+            console.warn('[DailyTotalPositionsHeld] Missing insights data for today.');
+            return;
+        }
+
+        for (const instrument of todayInsights.insights) {
+            this.totalPositions += (instrument.total || 0);
+        }
+    }
+
+    getResult() {
+        // Return the final sum
+        return {
+            total_positions_held: this.totalPositions
+        };
+    }
+
+    reset() {
+        this.totalPositions = 0;
+        this.processedDay = false;
+    }
+}
+
+module.exports = DailyTotalPositionsHeld;

package/package.json

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